03Sheet 03.09 · Tools

Replay

make replay: real wallet-backend builds ingest corpus ledgers through a mock stellar-rpc. Each verdict is read from the database, never from logs.

make replay          # make replay-729 and make replay-731

Needs Docker, Node ≥ 22.15, git and the network (to clone and build wallet-backend), and port 18545. Cold, replay-729 takes about 8 minutes and replay-731 about 2.

How a replay runs

Prepare the ledgers

From replay/ledgers-<n>/. For #729, four real testnet ledgers (4437356–4437359), vendored as lake objects; 4437357 is the corpus's mined signer variant and the others are its neighbours. For #731, the SAC trustline entry's protocol-28 variant.

Build wallet-backend at each commit

The tool clones stellar/wallet-backend and builds each commit under test in a Go container.

Serve the ledgers

A mock stellar-rpc (replay/mock-rpc.mjs) answers getHealth, getNetwork, getLatestLedger, getVersionInfo and getLedgers from those files. A fresh TimescaleDB database is migrated for each build.

Ingest, then read the state

Each build ingests in live mode with a timeout. The verdict comes from the database: the ingest cursor, the stored signer's length and the trustline rows. The process exit code is printed but not used.

Verdicts

ScenarioHaltedHandledOtherwise
729cursor stopped before 4437357the longest stored signer at 4437357 is 41 bytesmishandled
731cursor stopped before ledger 5at least one TRUSTLINE/ADD row at ledger 5dropped
Commitwallet-backend changeExpected
79ea2acdupgrade to protocol 28 (#715)mishandled: the signer stored as 33 bytes
6e5a5910reduce muxed addresses to their base account (#693)halted
2c873353handle CAP-40 signed-payload signers (#729)handled: 41 bytes
764a4f5b(#740)dropped
c152783crecord SAC-created trustline state changes (#734)handled

The halted build's own log says why: the P… address "has a 40-byte key payload; the account_id column stores only 32-byte account/contract keys".

Not committed

The run logs go to replay/.work/logs/, which is gitignored. The expected verdicts are fixed in replay/run.sh.

On this page