Skip to main content

Ledger Verification Guide

How to verify quantum-anchored records in the SoftQCOS Ledger.

Overview​

The SoftQCOS Ledger stores tamper-proof records anchored with real quantum entropy. Verification proves that:

  1. A record has not been modified since creation
  2. The quantum entropy signature is authentic
  3. The record was created at the claimed timestamp

Verification Methods​

from softqcos.ledger import LedgerClient

client = LedgerClient(api_key="your-api-key")

result = client.verify(record_id="rec_abc123")

print(result.is_valid)           # True
print(result.quantum_fidelity)   # 0.97
print(result.anchored_at)        # datetime(2026, 3, 23, ...)
print(result.merkle_proof)       # Cryptographic proof chain

2. CLI Verification​

softqcos ledger verify --record-id rec_abc123

Output:

✅ Record verified
  Record ID:        rec_abc123
  Anchored:         2026-03-23T11:32:04Z
  Quantum Fidelity: 0.97
  Merkle Root:      a3f8c2d1...
  Status:           VALID

3. REST API Verification​

curl https://api.softquantus.com/v1/ledger/records/rec_abc123/verify \
  -H "Authorization: Bearer $API_KEY"

Response:

{
  "record_id": "rec_abc123",
  "is_valid": true,
  "quantum_fidelity": 0.97,
  "anchored_at": "2026-03-23T11:32:04Z",
  "merkle_proof": {
    "root": "a3f8c2d1...",
    "path": ["b2e1f3...", "c4d5a6..."]
  }
}

Understanding Quantum Fidelity​

The quantum fidelity score (0.0–1.0) indicates the quality of the quantum entropy used during anchoring:

ScoreMeaning
0.95–1.0Excellent — high-quality quantum entropy
0.85–0.94Good — acceptable for most use cases
0.70–0.84Fair — consider re-anchoring for critical records
< 0.70Poor — quantum hardware was under stress; re-anchor recommended

Batch Verification​

Verify multiple records efficiently:

record_ids = ["rec_abc123", "rec_def456", "rec_ghi789"]

results = client.verify_batch(record_ids)

for r in results:
    status = "✅" if r.is_valid else "❌"
    print(f"{status} {r.record_id}: fidelity={r.quantum_fidelity:.2f}")

Offline Verification​

Records include an embedded cryptographic proof that allows offline verification without calling the API:

# Load the proof bundle exported from the ledger
from softqcos.ledger import verify_offline

with open("record_bundle.json") as f:
    bundle = json.load(f)

result = verify_offline(bundle)
print(result.is_valid)  # True, verified without network