01Sheet 01.02 · Start

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 xdrproof

Check what you have

TargetNeeds
make verifyNode ≥ 22.15 and Rust (cargo)
make coveragePython 3 and Node ≥ 22.15 (coverage-goldens also needs git and the network)
make coverage-report, make novelty, make buildNode ≥ 22.15, npm and Rust (cargo)
make oracleDocker, Node ≥ 22.15, npm
make generate, make generate-quick, make order-scanDocker, Node ≥ 22.15, npm, curl, jq, perl
make conformanceNode, Rust, Docker
make replayDocker, Node ≥ 22.15, git, the network

Verify the corpus

make verify

The 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.json is 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 ledgers

Each target has its own page under Tools. make all runs verify, oracle, coverage, generate, conformance and replay.

On this page