PipRail

The SDK lab

Real @piprail/sdk, loaded from a CDN and run in this tab. No key, and it cannot move funds.

30
tests on the bench
236
SDK calls exercised
37
mainnet chains
0%
PipRail fee
piprail / sdk-lab

loading @piprail/sdk from the CDN…

The bench

Setup

Merchant

Buyer

Agent

Interop

Unbadged tests run offline and are deterministic. live reads a public RPC, this site’s own 402, or an open index. needs means the test states a requirement before it runs.

output

Pick a test, or run all 30

Between them they call 236 of the SDK’s 242 public symbols, for real, in this tab. Switch to json for the raw object at any time.

The 6 calls this lab will not make

Every other public call in the package is wired to a button above. These are not. Each one would write into somebody else’s system if a stranger clicked it, so the lab builds the exact payload and stops there. Needing a wallet is not on this list: an empty wallet still runs the whole path and the refusal is worth seeing.

  • register402Index

    Posts a listing into a public directory people search. A demo button would fill it with junk.

    shown in the listing test

  • registerX402Scan

    Posts a listing into a public directory people search. A demo button would fill it with junk.

    shown in the listing test

  • PipRailClient#register

    Registers a live endpoint across every directory at once. Same reason, one call higher up.

    shown in the listing test

  • claim402IndexDomain

    Writes a domain-ownership claim you then have to prove with a DNS TXT record you control.

    shown in the domain test

  • PipRailClient#claimDomain

    Writes a domain-ownership claim you then have to prove with a DNS TXT record you control.

    shown in the domain test

  • settleViaFacilitator

    Submits a payment to a third party for settlement. Their endpoint, their gas, real money.

    shown in the facilitators test

This list is checked, not written. npm run lab:coverage reads the built SDK and fails when a public symbol is exercised by neither a test nor an entry here, so the page cannot quietly cover less than it claims.

Base mainnet · live

The bench reads this endpoint. You can pay it.

piprail.com/x402/demo charges 0.01 USDC on Base. It accepts PipRail’s direct on-chain proof and the standard exact rail. The lab quotes it without spending anything.

Open the 402 Build your own

Verified against the merchant’s own RPC. No facilitator, no custody.

terminal HTTP 402 
$ curl -i https://piprail.com/x402/demo

HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6Mi...