Skip to main content

PROOFNEST

⚠️ DEPRECATED: This is proofnest v1.x (legacy). Please upgrade to v2.0.0+

pip install proofnest>=2.0.0

What's new in v2.0:

  • Go blockchain backend (10x faster, production-grade)
  • STRICT_CRYPTO mode (no silent fallbacks)
  • HYBRID signatures (ML-DSA + Ed25519)
  • AI inference receipts
  • GPT-5.2 security audit fixes

Migration guide: https://proofnest.io/migration


Proof, not promises.

Quantum-proof Layer 1 blockchain with AI work verification. Every transaction cryptographically signed with post-quantum Dilithium3. Genesis anchored to Bitcoin via OpenTimestamps.

v1.5.0 - Full Blockchain Implementation

This release includes the complete PROOFNEST blockchain node (14,800+ lines) with:

  • 257 comprehensive tests - Full coverage including security tests
  • Dilithium3 signatures - NIST PQC Level 3 quantum-proof
  • SHAKE256 hashing - Domain-separated, collision-resistant
  • TLS 1.3 P2P - Encrypted peer communication with TOFU pinning
  • LMD-GHOST fork choice - Proper fork handling
  • AI Work Validator - TF-IDF + entropy verification with slashing
  • Staking system - 50 PROOF minimum, 21-day unbonding
  • EIP-1559 gas model - Base fee burning mechanism

Architecture

PROOFNEST L1
├── Cryptography
│   ├── Dilithium3 (NIST ML-DSA-65) - Quantum-proof signatures
│   ├── SHAKE256 - Hashing with domain separation
│   └── TLS 1.3 - P2P encryption
├── Consensus
│   ├── PoW → BFT-ready architecture
│   ├── LMD-GHOST fork choice
│   └── 21-day unbonding period
├── Economics
│   ├── 70M PROOF genesis supply
│   ├── 10 PROOF block reward
│   ├── EIP-1559 fee burning
│   └── AI work slashing (up to 10%)
└── Verification
    ├── AI Work Validator (TF-IDF + entropy)
    ├── Bitcoin anchoring (OpenTimestamps)
    └── Chain integrity verification

Genesis Allocations

Allocation Amount Purpose
Team 10,000,000 PROOF Core development
Community 30,000,000 PROOF Ecosystem growth
Ecosystem 20,000,000 PROOF Partnerships
Treasury 10,000,000 PROOF Operations
Total 70,000,000 PROOF

Quick Start

Run a Node

from proofnest.node import P2PNode

# Genesis node (creates new chain)
node = P2PNode(
    name="genesis-node",
    host="127.0.0.1",
    port=9001,
    is_genesis=True
)
node.start()

# Validator node (joins existing chain)
validator = P2PNode(
    name="validator-1",
    host="127.0.0.1",
    port=9002,
    peers=["127.0.0.1:9001"]
)
validator.start()

Multi-Node Testnet

# Set data directory per node
export HONEST_CHAIN_DIR=/path/to/node1/data

# Optional: Disable TLS for testing
export PROOFNEST_NO_TLS=1

# Run testnet launcher
python run_testnet.py

AI Work Submission

from proofnest.node import AIWorkValidator

validator = AIWorkValidator()

# Submit AI work for verification
result = validator.verify_work(
    input_data="Analyze quarterly financial report",
    output_data="Revenue increased 15% YoY...",
    task_type="analysis",
    compute_time=45.2,
    stake=1000  # PROOF tokens at stake
)

# Slashing for poor quality work
if result["quality_score"] < 0.5:
    slash_amount = result["slash_amount"]  # Up to 10% of stake

Decision Logging (SDK)

from proofnest import ProofNest, RiskLevel

pn = ProofNest(agent_id="my-agent")
print(pn.did)  # did:pn:a1b2c3...

pn.decide(
    action="Approved transaction",
    reasoning="All checks passed",
    risk_level=RiskLevel.HIGH  # Auto-anchored to Bitcoin
)

assert pn.verify()

Security

Quantum-Proof Cryptography

  • Dilithium3 - NIST ML-DSA-65, Level 3 security
  • 1952-byte public keys - Larger but quantum-safe
  • SHAKE256 - Extensible output function

Anti-Replay Protection

# Every transaction includes:
{
    "nonce": 42,           # Sequential per-sender
    "chain_id": "proofnest-mainnet",
    "expires_at": 1735900000  # 1 hour default
}

Fork Handling

  • LMD-GHOST fork choice rule
  • Automatic chain reorganization
  • Persistent storage survives restarts

Testing

# Run all 257 tests
python -m pytest tests/ -v

# Security tests only
python -m pytest tests/ -k "security" -v

# With coverage
python -m pytest tests/ --cov=proofnest --cov-report=html

Components

Component Description Status
QuantumCrypto Dilithium3 + SHAKE256 Production
QuantumWallet Persistent key management Production
Blockchain Fork handling, validation Production
P2PNode TLS 1.3 networking Production
AIWorkValidator TF-IDF + entropy scoring Production
ChainStorage JSON persistence Production
BitcoinAnchor OpenTimestamps integration Production
Transaction Nonce + chain_id + expiry Production

Configuration

Environment Variables

Variable Description Default
HONEST_CHAIN_DIR Data directory ~/.honest_chain
PROOFNEST_NO_TLS Disable TLS (testing) Not set

Staking Parameters

MIN_STAKE = 50 * 10**18        # 50 PROOF minimum
UNBONDING_PERIOD = 21 * 86400  # 21 days
MAX_SLASH_PERCENT = 10         # 10% max slashing

Roadmap

  • Quantum-proof signatures (Dilithium3)
  • TLS 1.3 P2P encryption
  • AI work verification with slashing
  • Multi-node testnet support
  • 257 comprehensive tests
  • BFT consensus upgrade
  • Bridge light client
  • Mainnet launch

License

Proprietary. Copyright (c) 2025-2026 Stellanium Ltd. All rights reserved.

PROOFNEST is a trademark of Stellanium Ltd.

Metadata

Release files for proofnest 1.6.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for proofnest 1.6.4
File Size Uploaded
proofnest-1.6.4.tar.gz 354.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for proofnest 1.6.4
File Interpreter ABI Platform
proofnest-1.6.4-py3-none-any.whl Python 3 none any Details

Total release size: 729.2 kB

Release files / proofnest-1.6.4.tar.gz

Download URL proofnest-1.6.4.tar.gz
Size 354.5 kB
Tags Source
SHA-256 checksum
How to use checksums
16c55d34f72304cf12f3c9b56f2619001907e26dea7bed4022abbd731ba54ef1
BLAKE2b-256 checksum
How to use checksums
43c5402c5ccc7ea746029427f2a0501f2af2290993d3a597e635e94f613a50b4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.12

Release files / proofnest-1.6.4-py3-none-any.whl

Download URL proofnest-1.6.4-py3-none-any.whl
Size 374.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b5a32bd3f06061d8c1aa06909d81a79aa00e5aaa3799dd951f3b79c051fea334
BLAKE2b-256 checksum
How to use checksums
6a9e480368c5c5740e5d993d69d8ebb861dea58f0f9aebe66b0db1f79bfec596
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.12

Release history Release notifications | RSS feed

This release

1.6.4 This release

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page