Nockchain evidence

Runtime evidence boundary

NockApp Runtime Atlas

A receipt-safe map for NockApp poke, peek, state, persistence, gRPC, and Nockup fixture evidence. Current claims stay anchored to nockchain/nockchain while Zorp lineage explains vocabulary and historical runtime context.

Runtime Boundaries
5
Probe Templates
4
Commit
33ba97b1e206
Forbidden Fields
7

Source Authority

canonical

canonical-runtime-authority

Current NockApp runtime evidence must cite Nockchain commit/build and current Nockchain crates before using lineage material.

crates/nockapp, crates/nockapp-grpc, crates/nockapp-grpc-proto, crates/nockvm/rust/nockvm, crates/nockup, crates/kernels

Zorp lineage

zorp-lineage-context

Zorp lineage explains NockApp, Sword, persistence, and authoring vocabulary, but does not override current nockchain/nockchain behavior.

zorp-corp/nockapp, zorp-corp/sword, zorp-corp/jock-lang

state

state-artifact-provenance

Use state-jam/checkpoint metadata to explain bootstrap or state context without storing raw state artifacts.

https://drive.google.com/drive/folders/1aEYZwmg4isTuYXWFn9gKPl92-pYndwUw

Runtime Boundaries

poke-effects

Poke effects

State-changing NockApp input boundary where a poke can emit effects and mutate durable state.

Use this boundary for fakenet and Nockup receipts that need to explain which poke path, effect tag, and before/after state roots were observed.

receiptFields

pokePath, effectTag, stateRootBefore, stateRootAfter, kernel, nockchainCommit

riskPosture

A poke is not just a command transcript; bind it to kernel, commit/build, endpoint mode, state root, and effect evidence before publishing.

peek-reads

Peek reads

Read-only NockApp observation boundary for state inspection without claiming a transition occurred.

Use this boundary for balance, route-table, state, or app peeks where the receipt must separate observation from mutation.

receiptFields

peekPath, stateRootAtPeek, grpcEndpoint, kernel, nockchainBuild

riskPosture

Peek output must be tied to endpoint, block/tip context, state root, and Nockchain build before it becomes evidence.

pma-durability

PMA durability

Persistent-memory and state-artifact boundary for local durability, replay context, checkpointing, and state-jam provenance.

Use this boundary when a NockApp test depends on existing state, a state export, a checkpoint, or a Zorp state-jam source.

receiptFields

stateJamFingerprint, pmaBoundary, eventLogBoundary, stateRootBefore, stateRootAfter

riskPosture

Record PMA and state-jam metadata only. Do not store or redistribute raw PMA slabs, event logs, checkpoints, or state jams.

grpc-private-endpoint

gRPC private endpoint

Local/private NockApp interaction surface used by probes, wallets, fakenets, and future direct runtime tests.

Use this boundary to distinguish private local gRPC evidence from public API or explorer-derived evidence.

receiptFields

grpcEndpoint, endpointMode, nockchainCommit, nockchainBuild, networkId

riskPosture

Never imply an unauthenticated private endpoint is safe for public exposure; record endpoint mode and local network context.

nockup-fixture

Nockup fixture

Scaffold/build/run boundary for turning NockApp source, Hoon kernels, and Jam artifacts into reproducible fixtures.

Use this boundary to connect Nockup validation receipts, fixture provenance, and future Jock/NockApp authoring templates.

receiptFields

nockupTemplate, jamHash, sourceRepo, sourceRepoPushedAt, kernel

riskPosture

A successful scaffold run is fixture evidence, not protocol authority. Keep it tied to source hash, template, build command, and Nockchain commit.

Receipt Contract

required

nockchainCommit, nockchainBuild, networkId, kernel, nockAppSource, nockAppCrate, pokePath, peekPath, effectTag, stateRootBefore, stateRootAfter, jamHash, stateJamFingerprint, endpointMode

optional

stateRootAtPeek, grpcEndpoint, nockupTemplate, sourceRepo, sourceRepoPushedAt, lineageSource, lineageInterpretation, eventLogBoundary, pmaBoundary

forbidden

rawPmaSlab, rawEventLog, rawCheckpoint, rawStateJam, walletPrivateKey, walletSeedPhrase, apiToken

rule

Use nockchain/nockchain crates and Tier 0 docs for current runtime and protocol claims.

rule

Treat Zorp NockApp and Sword repositories as lineage/context, not current protocol authority.

rule

Treat the Zorp Drive folder as metadata-only state-jam provenance, not VESL evidence.

rule

Do not compare two NockApp receipts unless commit/build, kernel, endpoint mode, and state-artifact context match.

rule

Separate read-only peeks from state-changing pokes in public evidence and user-connected fakenet tests.

Probe Templates

poke-roundtrip

Poke roundtrip

Submit a state-changing poke, capture effects, and compare before/after state roots without storing raw state.

requiredEvidence

pokePath, effectTag, stateRootBefore, stateRootAfter, kernel

peek-state-read

Peek state read

Read NockApp or chain state through a peek path and bind the observation to endpoint, build, and state root.

requiredEvidence

peekPath, stateRootAtPeek, grpcEndpoint, nockchainBuild

nockup-build-run

Nockup build/run

Record scaffold, build, run, and Jam artifact metadata for an app fixture without publishing source-private output.

requiredEvidence

nockupTemplate, jamHash, sourceRepo, nockchainCommit

state-export-snapshot

State export snapshot

Publish metadata for state export, checkpoint, or state-jam context while leaving raw state artifacts out of git and receipts.

requiredEvidence

stateJamFingerprint, pmaBoundary, eventLogBoundary, nockchainBuild

Safety Boundary

NockApp evidence should preserve source, build, endpoint, kernel, and state identity while keeping raw runtime state and secrets private.

neverStore

rawPmaSlab

neverStore

walletSeedPhrase

neverStore

rawEventLog

neverStore

rawCheckpoint

neverStore

rawStateJam

neverStore

walletPrivateKey

neverStore

apiToken

Next Uses

next

Attach the NockApp runtime boundary to fakenet, Nockup, VESL, and user-connected fakenet receipts.

next

Add direct poke/peek probe receipts once the local fakenet adapter can call the runtime boundary consistently.

next

Use Zorp lineage to improve fixture language without promoting archived repos to protocol authority.

next

Add state export metadata fields to Launch Evidence without committing raw PMA, event logs, or state jams.

Evidence Links

upstream

https://nocksperimental.com/api/nockchain/upstream

sourceTrace

https://nocksperimental.com/api/nockchain/nockapp-source

rustAtlas

https://nocksperimental.com/api/nockchain/rust-atlas

stateJams

https://nocksperimental.com/api/nockchain/state-jams

nockupReceipts

https://nocksperimental.com/api/nockchain/nockup/receipts