How nucleoledger/nucleo works
Núcleo is a local cryptographic transparency log, exposed primarily through a per-invocation CLI. The main workflow seals application records into a signed, chained ledger, then issues portable receipts that recipients can verify offline; operators can also reconcile live records, synchronize checkpoints with witnesses, and manage encrypted storage and erasure. The graph includes the Go runtime and the documented TypeScript, PHP, and web verification surfaces. Some command implementations and subsystems were not excerpted, so their documented capabilities are shown without speculative internal call edges.
Main entry points: main.go Núcleo CLI · receipt.ts TypeScript verifier · seal.go Seal records · store.go SQLite store
Components 30
CLI operations
- Núcleo CLI
cmd/nucleo/main.go - Seal records
cmd/nucleo/seal.go - Issue receipts
cmd/nucleo/verify_receipt.go - Reconcile
cmd/nucleo/reconcile.go - Sync checkpoint
cmd/nucleo/sync.go - Erase content
cmd/nucleo/erase.go
Sealing and storage
- Signed ledger
internal/ledger/block.go - SQLite store
internal/store/store.go - Store integrity
internal/store/integrity.go - Encrypted vault
internal/vault/vault.go
Proof and attestation
- Receipt format
internal/receipt/receipt.go - Receipt verifier
internal/proof/proof.go - Signed checkpoints
internal/checkpoint/checkpoint.go - Witness service
internal/witness/server.go - Witness sync
internal/logsync/logsync.go
Operations and policy
- Reconciliation engine
internal/reconcile/reconcile.go - Verification policy
internal/policy/policy.go
Independent verifiers
- TypeScript verifier
sdk/ts/src/receipt.ts - TS crypto and formats
sdk/ts/src/crypto.ts - TS Merkle proofs
sdk/ts/src/merkle.ts - TS checkpoints
sdk/ts/src/checkpoint.ts - TS policy
sdk/ts/src/policy.ts - TS byte utilities
sdk/ts/src/bytes.ts - PHP verifier
sdk/php/src/Verifier.php - PHP policy
sdk/php/src/Policy.php - PHP byte utilities
sdk/php/src/Bytes.php - PHP UTF-8
sdk/php/src/Utf8.php - Browser verifier
web/verify/nucleo-verify.js
Other components
- Operator / app
- Receipt recipient
Connections 33
- Operator / app → Núcleo CLI: runs commands
README.md - Núcleo CLI → Seal records: dispatches seal
README.md - Núcleo CLI → Issue receipts: dispatches receipt
README.md - Núcleo CLI → Reconcile: dispatches reconcile
README.md - Núcleo CLI → Sync checkpoint: dispatches sync
README.md - Núcleo CLI → Erase content: dispatches erase
README.md - Seal records → Signed ledger: seals blocks
README.md - Seal records → SQLite store: persists ledger
README.md - Seal records → Encrypted vault: encrypts payloads
README.md - SQLite store → Store integrity: checks on open
internal/store/integrity.go - Issue receipts → Receipt format: issues receipt
README.md - Receipt format → Receipt verifier: uses proof format
internal/receipt/receipt.go - Receipt verifier → Signed checkpoints: verifies checkpoint
internal/proof/proof.go - Receipt recipient → TypeScript verifier: verifies offline
README.md - Receipt recipient → PHP verifier: verifies offline
README.md - Receipt recipient → Browser verifier: verifies offline
README.md - Sync checkpoint → Witness sync: requests attestation
README.md - Witness sync → Witness service: sends checkpoint
internal/logsync/logsync.go - Witness service → Signed checkpoints: cosigns checkpoint
internal/witness/server.go - Reconcile → Reconciliation engine: compares records
README.md - Reconciliation engine → SQLite store: reads sealed data
internal/reconcile/reconcile.go - Erase content → SQLite store: erases stored content
README.md - Erase content → Signed ledger: seals erasure event
README.md - TypeScript verifier → TS checkpoints: parses checkpoint
sdk/ts/src/receipt.ts - TypeScript verifier → TS policy: validates policy
sdk/ts/src/receipt.ts - TypeScript verifier → TS crypto and formats: checks signatures
sdk/ts/src/receipt.ts - TypeScript verifier → TS Merkle proofs: checks inclusion
sdk/ts/src/receipt.ts - TypeScript verifier → TS byte utilities: uses byte helpers
sdk/ts/src/receipt.ts - TS policy → TS byte utilities: uses byte helpers
sdk/ts/src/policy.ts - TS checkpoints → TS byte utilities: uses byte helpers
sdk/ts/src/checkpoint.ts - TS Merkle proofs → TS byte utilities: uses byte helpers
sdk/ts/src/merkle.ts - PHP policy → PHP byte utilities: uses byte helpers
sdk/php/src/Policy.php - PHP policy → PHP UTF-8: uses UTF-8 helpers
sdk/php/src/Policy.php