@rail402.dev/conformance
v0.1.1
Published
Wire-level conformance harness: installs this facilitator into the upstream x402 e2e suite and runs it.
Readme
@rail402.dev/conformance
Run the upstream x402 e2e suite against a Rail402 (x402-stellar) facilitator. It is wire-level acceptance with stock SDK clients, not a self-authored check.
What you need
Node.js 20+, git, and three funded testnet accounts (a payer and a seller, both with a USDC
trustline). The payer holds testnet USDC from the Circle faucet.
Install
npm install --save-dev @rail402.dev/conformanceUsage
# 1. Install the proxy into a pinned clone of the upstream suite.
pnpm --filter @rail402.dev/conformance install-proxy
# 2. Point it at a facilitator and funded testnet accounts.
export X402_STELLAR_FACILITATOR_URL=https://facilitator.rail402.dev
export CLIENT_STELLAR_PRIVATE_KEY=S... # funded testnet payer (USDC trustline)
export SERVER_STELLAR_ADDRESS=G... # seller (USDC trustline)
# 3. Run the suite.
pnpm --filter @rail402.dev/conformance runDual run
Run the suite twice, at the pinned spec SHA and at latest main, to separate a regression from spec
drift:
pnpm --filter @rail402.dev/conformance dual| pinned | latest | verdict | meaning |
| ------ | ------ | ------------ | ------------------------------ |
| pass | pass | green | conformant and current |
| fail | any | regression | fails CI |
| pass | fail | drift | spec moved; informational |
| n/a | n/a | blocked | no funded testnet accounts set |
Results are written to docs/status/conformance-dual.json.
Part of Rail402. Apache-2.0.
