GitHub

Docs

Rails and chains

The register of rail identifiers, and of the chains and tokens that `rail: "blockchain"` names.

LIVE — PIP-0007. Capabilities on 2026-10-04.genesis take these identifiers.

What a rail is

A settlement scheme a payer can direct a payment to, in order to credit an identifiable beneficiary. It has its own rules, beneficiary formats and transaction identifiers.

Not a railExampleWhere it belongs
Interbank infrastructureTIPS, CHIPS, SPI (under Pix)The rail's profile. Never in accepts
Alias or proxy servicePayID, PayNow, PromptPay, DuitNowA beneficiary format, or an identifier type
Request-to-pay serviceCoDi, UPI Collect, Pix CobrançaThe rail's profile, mapped to PATH REQUEST
Wallet or brandWeroThe rail's profile
Account providerA bank, an e-money issuer, a mobile money operatorbook within the provider, or the interoperable rail between providers

Identifiers

Lower case, hyphenated, the scheme's short name. A two-letter country suffix only when the name collides or is generic: ach-us, rtp-us, fps-uk, fps-hk, rtgs-in, fast-sg. Never a member or network slug.

Rails

idNameZoneCategoryCurrenciesStatus
blockchainDistributed ledgerGlobaldlttokensdefined
bookMember ledger—bookthe member'sdefined
swiftSWIFT credit transferGlobalcross_borderanyreserved
sepa-ctSEPA Credit TransferSEPAbatchEURreserved
sepa-instSEPA Instant Credit TransferSEPAinstantEURreserved
t2T2Euro areartgsEURreserved
ach-usACHUSbatchUSDreserved
fedwireFedwire Funds ServiceUSrtgsUSDreserved
fednowFedNowUSinstantUSDreserved
rtp-usRTPUSinstantUSDreserved
fps-ukFaster PaymentsGBinstantGBPreserved
chapsCHAPSGBrtgsGBPreserved
bacsBacs Direct CreditGBbatchGBPreserved
pixPixBRinstantBRLreserved
speiSPEIMXinstantMXNreserved
upiUPIINinstantINRreserved
impsIMPSINinstantINRreserved
neftNEFTINbatchINRreserved
rtgs-inRTGSINrtgsINRreserved
nppNew Payments PlatformAUinstantAUDreserved
fast-sgFASTSGinstantSGDreserved
fps-hkFaster Payment SystemHKinstantHKD, CNYreserved
zenginZengin SystemJPinstantJPYreserved
interacInterac e-TransferCAinstantCADreserved
lynxLynxCArtgsCADreserved

Category says when the beneficiary is credited: instant within seconds, batch after a processing cycle, rtgs individually in central bank money, cross_border through correspondents, dlt on a ledger, book within one member.

Status. defined rails are specified by PIP-0007. reserved fixes the spelling: the rail may appear in accepts, and its beneficiary formats and reference types arrive with its profile, which makes it profiled. Rails are added by PIP when a member uses them.

blockchain

The ledger is named by chain, from the register below. Assets are token.

book

A transfer within the ledger of the member that signed the object. Both parties hold an account with that member, which the signature identifies. Assets are fiat.

Chains

slugCAIP-2EVM chain idNativeDecimals
ethereumeip155:11ETH18
baseeip155:84538453ETH18
arbitrumeip155:4216142161ETH18
optimismeip155:1010ETH18
polygoneip155:137137POL18
bnbeip155:5656BNB18
avalancheeip155:4311443114AVAX18
solanasolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp—SOL9
bitcoinbip122:000000000019d6689c085ae165831e93—BTC8
tron——TRX6
celoeip155:4222042220CELO18
arceip155:50425042USDC18
tempoeip155:42174217——
stellarstellar:pubnet—XLM7
suisui:mainnet—SUI9

evm.chain_id exists for EVM chains only. CAIP-2 is the general identifier; a chain with no registered CAIP-2 value is named by slug. Test networks are not listed and are not valid in production.

On arc, USDC is the native gas asset with 18 decimals; its ERC-20 interface, which capabilities name, uses 6. tempo has no native token: fees are paid in stablecoins, and tokens follow the tip20 standard. The listed Tempo token is PATHUSD (pathUSD).

Tokens

Chainasset_codestandardcontractDecimals
ethereumUSDCerc200xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb486
ethereumUSDTerc200xdac17f958d2ee523a2206206994597c13d831ec76
baseUSDCerc200x833589fcd6edb6e08f4c7c32d4f71b54bda029136
solanaUSDCsplEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6
tronUSDTtrc20TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t6
celoUSDCerc200xceba9300f2b948710d2653dd7b07f33a8b32118c6
arcUSDCerc200x36000000000000000000000000000000000000006
tempoPATHUSDtip200x20c00000000000000000000000000000000000006
stellarUSDCstellar-assetGA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN7
suiUSDCsui-coin0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC6

On stellar, contract is the issuing account. On sui, it is the full coin type.

A token not listed here is valid when its capability carries standard, contract and decimals.


On this page