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.
| Target | What it proves | Needs | Time |
|---|---|---|---|
make verify | Strkey 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 verified | Node ≥ 22.15, Rust | seconds |
make oracle | Each fact's values are also read by stellar-core's own decoder and by the schema walker | Docker, Node ≥ 22.15, npm | seconds |
make coverage | 499 union arms are reachable from LedgerCloseMeta at v30.0; the entries reach 350, the mined ledgers 289 | Python 3, Node ≥ 22.15 | seconds |
make coverage-report | Every 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.md | Node ≥ 22.15, Rust | seconds |
make novelty | No entry is redundant: leave-one-out over 975 atoms (arms, enum members, hazards, sightings, placements) | Node ≥ 22.15, Rust | seconds |
make coverage-goldens | stellar-core's own 866 golden ledger files reach 254 of the 499 | Python 3, git, network | about 1 min |
make generate | 20 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 reproduced | Docker, Node, npm, curl, jq, perl | about 10 min |
make generate-quick | The two mainnet base P30 pairs only | the same | about 3 min |
make order-scan | 20 fresh runs per lane: which ledgers vary in change order; content never does | Docker | about 15 min |
make conformance | js-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-sdk | Node, Rust, Docker | about 5 min cold |
make replay | Real wallet-backend builds halt, truncate or drop on corpus ledgers before their fixes, and handle them after | Docker, Node ≥ 22.15, git, network | about 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
| Reader | What it is | Used by |
|---|---|---|
| Native reader | A small Rust program on stellar-xdr 30.0.0 (depth limit 1500) that decodes, renders SEP-0051 JSON and re-encodes | verify |
| WASM reader | @stellar/stellar-xdr-json 30.0.0, a second opinion | verify |
| stellar-core | Core's own C++ dump-xdr, in Docker with no network, on the pinned image | oracle |
| Schema walker | walker.mjs: XDRProof's own JavaScript reader, driven only by the XDR definitions; it shares no code with any SDK | oracle |
| Coverage walker | xdrcov.py: a Python walker over the same v30.0 definitions that records every union arm and enum member it meets | coverage |
| Segment walker | the schema walker again, attributing every arm it meets to the transaction envelope or result meta it sits in, or to the ledger itself | coverage-report, novelty |