Quickstart
Clone the repository and run make verify: strkey vectors, every entry against its schema, hashes, a byte-for-byte round trip and every fact, and every mined ledger, in seconds.
Get the code
git clone https://github.com/XDRProof/xdrproof
cd xdrproofCheck what you have
| Target | Needs |
|---|---|
make verify | Node ≥ 22.15 and Rust (cargo) |
make coverage | Python 3 and Node ≥ 22.15 (coverage-goldens also needs git and the network) |
make coverage-report, make novelty, make build | Node ≥ 22.15, npm and Rust (cargo) |
make oracle | Docker, Node ≥ 22.15, npm |
make generate, make generate-quick, make order-scan | Docker, Node ≥ 22.15, npm, curl, jq, perl |
make conformance | Node, Rust, Docker |
make replay | Docker, Node ≥ 22.15, git, the network |
Verify the corpus
make verifyThe first run installs the tool dependencies (npm ci) and builds the native reader (cargo build --release), about a minute. Then it checks:
- every SEP-0023 strkey test vector;
- every entry against the schema, and its hazards against the registry;
- size and sha256;
- a decode and re-encode through native rs-stellar-xdr 30.0.0 that must reproduce identical bytes;
- that the focus transaction is in the ledger;
- every expected fact;
- that the WASM build
@stellar/stellar-xdr-json, wherever it can decode, renders the same JSON; - that
manifest.jsonis current; - every mined ledger and its findings.
Go further
make oracle # facts confirmed by stellar-core's own decoder and the schema walker
make coverage # how many XDR union arms the entries and mined ledgers reach
make coverage-report # every arm reached by an entry, or classified with a core source line
make novelty # no entry is redundant
make generate # rebuild every generated variant from scratch, twice
make order-scan # which ledgers vary in change order
make conformance # upstream SDK bugs: fail before the fix, pass after
make replay # real wallet-backend builds fed corpus ledgersEach target has its own page under Tools. make all runs verify, oracle, coverage, generate, conformance and replay.
What XDRProof is
A shared corpus of rare but valid Stellar ledger data, the facts a correct reader must find in it, and tools that replay it into indexers and test SDKs on the same shapes.
How it works
Recipes drive a bare stellar-core to emit rare shapes; the bytes become entries with facts; independent readers check them, real indexers ingest them, and SDK builds run test vectors for the same shapes.