03Sheet 03.01 · Tools

Tools

Every check is a make target: verify, oracle, coverage, novelty, generate, order scan, conformance and replay. Each one re-runs a claim and prints its result.

TargetWhat it provesNeedsTime
make verifyStrkey vectors hold. Every entry matches the schema, sizes and hashes match, and every variant round-trips byte for byte through native rs-stellar-xdr 30.0.0. The focus transaction is present, every fact holds, the WASM reader renders the same JSON wherever it can decode, and the manifest is current. Every mined ledger is verifiedNode ≥ 22.15, Rustseconds
make oracleEach fact's values are also read by stellar-core's own decoder and by the schema walkerDocker, Node ≥ 22.15, npmseconds
make coverage499 union arms are reachable from LedgerCloseMeta at v30.0; the entries reach 350, the mined ledgers 289Python 3, Node ≥ 22.15seconds
make coverage-reportEvery one of the 499 arms is reached by an entry's own transaction or ledger shape (350) or classified with the stellar-core source line that decides it (149). Writes COVERAGE.mdNode ≥ 22.15, Rustseconds
make noveltyNo entry is redundant: leave-one-out over 975 atoms (arms, enum members, hazards, sightings, placements)Node ≥ 22.15, Rustseconds
make coverage-goldensstellar-core's own 866 golden ledger files reach 254 of the 499Python 3, git, networkabout 1 min
make generate20 fresh standalone cores, in pairs, across both lanes, both passphrases, P30 and P28 and three flag profiles. Every pair agrees, and every shipped generated variant is reproducedDocker, Node, npm, curl, jq, perlabout 10 min
make generate-quickThe two mainnet base P30 pairs onlythe sameabout 3 min
make order-scan20 fresh runs per lane: which ledgers vary in change order; content never doesDockerabout 15 min
make conformancejs-stellar-sdk #1766, #1785 and #1789 fail on pre-fix builds and pass on fixed ones; #1766's twin does the same on go-stellar-sdkNode, Rust, Dockerabout 5 min cold
make replayReal wallet-backend builds halt, truncate or drop on corpus ledgers before their fixes, and handle them afterDocker, Node ≥ 22.15, git, networkabout 10 min cold

make all runs verify, oracle, coverage, generate, conformance and replay.

make build is not a check: it compiles catalog/ into entries/ from the runs of make generate and mined/, in minutes. See Catalog.

The readers behind them

ReaderWhat it isUsed by
Native readerA small Rust program on stellar-xdr 30.0.0 (depth limit 1500) that decodes, renders SEP-0051 JSON and re-encodesverify
WASM reader@stellar/stellar-xdr-json 30.0.0, a second opinionverify
stellar-coreCore's own C++ dump-xdr, in Docker with no network, on the pinned imageoracle
Schema walkerwalker.mjs: XDRProof's own JavaScript reader, driven only by the XDR definitions; it shares no code with any SDKoracle
Coverage walkerxdrcov.py: a Python walker over the same v30.0 definitions that records every union arm and enum member it meetscoverage
Segment walkerthe schema walker again, attributing every arm it meets to the transaction envelope or result meta it sits in, or to the ledger itselfcoverage-report, novelty

On this page