Workspace Coverage
trackedWorkspaceMemberCount
36
missingWorkspaceMembers
none
nonWorkspaceTrackedCrates
crates/chaff
Nockchain evidence
Rust workspace
Nockchain Rust Atlas
A crate-level operating map for learning Nockchain as a Rust system: consensus/runtime crates, NockApp boundaries, wallet/API surfaces, scaffolding, bridge/proof work, and the checks Nocksperimental should run before trusting evidence from each layer.
Workspace
Rust / resolver 2
Crates
37
Members
36
Groups
6
Workspace Drift Check
Compares pinned Nockchain Cargo.toml workspace members, resolver, manifest hash, and workspace member hash against upstream master before Rust crate assumptions become receipt authority.
command
npm run check:nockchain-cargo-workspace-drift -- --json
manifestSha256
a31885eb2d77adfb4d8583a52a62b8f05289087af1c4b10af616b6376b0773f0
workspaceMemberHash
sha256:6b00f9e3d10a5fbd361e79f6ad4235e193574bb42563696d350adedabbc48c0c
manifestBytes
9781
compareFields
resolver, members, manifestSha256, workspaceMemberHash
testCommand
npm run test:nockchain-cargo-workspace-drift-check
source
https://raw.githubusercontent.com/nockchain/nockchain/master/Cargo.toml
source
https://github.com/nockchain/nockchain/blob/master/Cargo.toml
Validation Gates
check
cargo check -p nockchain
check
cargo check -p nockapp
check
cargo check -p nockchain-wallet
additional
cargo test -p <crate> --release
additional
cargo fmt --check
additional
cargo clippy --all-targets -- -Dclippy::unwrap_used -Aclippy::missing_safety_doc
Rust Evidence Watch
watch
#127 bridge: add end-to-end withdrawal execution
watch
PMA dynamic growth and state-jam decode hardening
watch
#125 fix(nockup): harden templates and run UX
watch
#126 nockchain-bench
watch
#116 wallet blobs and memo support
watch
#119 public NockApp::export_state
watch
#124 AI PoW Puzzle for AI Compute Network
watch
libp2p/sync behavior while behind tip
Workspace Groups
chain-runtime
Chain runtime
Consensus, block handling, libp2p networking, math, and end-to-end chain validation.
Use these crates to interpret fakenet receipts, peer/tip diagnostics, mining output, and protocol-sensitive test failures.
nockchain, nockchain-types, nockchain-libp2p-io, nockchain-math, nockchain-testkit, nockchain-e2e
operator-tools
Operator tools
Wallet, API, explorer, peek, transaction, and operational command surfaces.
Use these crates for wallet evidence, public/private endpoint posture, balance checks, and operator-facing diagnostics.
nockchain-wallet, wallet-tx-builder, raw-tx-checker, nockchain-api, nockchain-peek, nockchain-explorer-tui
nockapp-runtime
NockApp runtime
NockApp kernel runtime, gRPC bridge, NockVM execution, poke/peek effects, and persistence boundaries.
Use these crates to ground NockApp lab reports, poke/peek receipts, state replay, and live export_state watch items.
nockapp, nockapp-grpc, nockapp-grpc-proto, nockvm/rust/ibig, nockvm/rust/murmur3, nockvm/rust/nockvm, nockvm/rust/nockvm_macros
hoon-and-scaffolding
Hoon and scaffolding
Hoon compiler, kernels, and nockup application scaffolding.
Use these crates for nockup build/run receipts and compiler-backed fixture generation.
hoon, hoonc, nockup, kernels, kernels-open-bridge, kernels-open-dumb, kernels-open-miner, kernels-open-nockchain-peek, kernels-open-wallet
bridge-and-proof
Bridge and proof
Bridge operator and proof-adjacent crates for settlement, ZK, and latency-sensitive work.
Use these crates to connect VESL evidence, bridge settlement probes, and future proof/compute benchmarks.
bridge-dev, bridge, nockchain-bridge-sequencer, zkvm-jetpack, equix-latency
serialization-support
Serialization support
Noun serialization, habit/chaff support, and data-shape glue used across runtime boundaries.
Use these crates to reason about evidence payloads, noun encoding, and receipt-safe serialization assumptions.
noun-serde, noun-serde-derive, habit, chaff
High-Signal Crates
chain-runtime
nockchain
Primary chain node and mining runtime.
Anchor fakenet receipts, mining checks, block commitment diagnostics, and protocol-sensitive test interpretation.
primaryCheck
cargo check -p nockchain
riskPosture
Fast-moving consensus/runtime crate; record commit, release, protocol track, peer count, and tip status.
chain-runtime
nockchain-libp2p-io
libp2p networking and peer IO.
Interpret peer, route-table, gossip suppression, and behind-tip diagnostics for fakenet receipts.
primaryCheck
cargo check -p nockchain-libp2p-io
riskPosture
Peer behavior changes affect no-peers and wrong-commitment triage.
nockapp-runtime
nockapp
NockApp runtime interface for Kernel, poke, peek, effects, logging, and persistence.
Ground lab runner semantics, NockApp receipts, poke/peek checks, and export_state monitoring.
primaryCheck
cargo check -p nockapp
riskPosture
Runtime changes can alter evidence meaning; use scoped README plus Tier 0 docs.
operator-tools
nockchain-wallet
Wallet CLI and wallet evidence surface.
Drive wallet balance, address, note, blob, and memo receipt checks.
primaryCheck
cargo check -p nockchain-wallet
riskPosture
Wallet CLI behavior is operator-facing; cite crate README and record endpoint mode.
operator-tools
nockchain-api
Public API crate for Nockchain interactions.
Model API-backed evidence while keeping public exposure warnings visible.
primaryCheck
cargo check -p nockchain-api
riskPosture
alpha/test-grade; do not expose publicly without access control, observability, and rate-limit posture.
operator-tools
wallet-tx-builder
Wallet transaction planning, fee, note, lock-resolution, determinism, and withdrawal-building support.
Ground wallet and bridge withdrawal receipts in the exact transaction builder surface used upstream.
primaryCheck
cargo check -p wallet-tx-builder
riskPosture
Transaction-builder changes can alter fees, word counts, lock resolution, memo/blob behavior, and withdrawal evidence.
bridge-and-proof
nockchain-bridge-sequencer
Bridge sequencer service for authorization, submission, and confirmation surfaces.
Attach sequencer configuration and commit provenance to bridge withdrawal and settlement receipts.
primaryCheck
cargo check -p nockchain-bridge-sequencer
riskPosture
Sequencer behavior is high-signal for bridge evidence; record config, endpoint, proposal hash, and journal context.
bridge-and-proof
bridge-dev
Bridge development scenarios and tests.
Use as a source of bridge fixture scenarios before promoting settlement checks into public evidence.
primaryCheck
cargo check -p bridge-dev
riskPosture
Development scenarios are implementation fixtures; do not treat them as finalized protocol behavior.
hoon-and-scaffolding
nockup
NockApp project scaffold and run UX.
Create nockup build/run receipts for app scaffold validation.
primaryCheck
cargo check -p nockup
riskPosture
Active UX hardening watch item; keep templates and run commands tied to upstream PR/release context.
Authority Chain
1START_HERE.md
2PROTOCOL.md
3ARCHITECTURE.md
4WORKFLOWS.md
5DECISIONS/README.md
Next Nocksperimental Uses
next
Attach crate-level provenance to fakenet and VESL receipts.
next
Use bridge-dev scenarios as implementation fixtures for bridge withdrawal tests before promoting settlement checks into public receipts.
next
Add nockup build/run receipts for app scaffold validation.
next
Use NockApp export_state when upstream stabilizes it for live-app snapshots.
next
Treat wallet blob/memo support as a future receipt-field expansion.