PROOFNEST
⚠️ DEPRECATED: This is proofnest v1.x (legacy). Please upgrade to v2.0.0+
pip install proofnest>=2.0.0What'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)
| File | Size | Uploaded | |
|---|---|---|---|
| proofnest-1.6.4.tar.gz | 354.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|