XRPL tradelines
An XRPL tradeline is a credit facility recorded as an issuer-authorized trust line on the XRP Ledger, with the limit, drawn amount, and repayment history readable by anyone. It is not a consumer credit tradeline and is not reported to any credit bureau.
Built only from what is enabled on mainnet
XRPL mainnet state on 2026-09-04 (rippled 3.3.0, validated ledger 106,758,857, decoded from the Amendments ledger entry):
| Amendment | Mainnet | Role in a tradeline |
|---|---|---|
| Credentials (XLS-70) | enabled | verification credential on the client account |
| TokenEscrow | enabled | collateral escrow of issued tokens |
| Clawback | enabled | issuer recovery on default |
| PermissionedDomains, PermissionedDEX | enabled | available; not required |
| MPTokensV1 | enabled | alternative credit asset; not used in this version |
| SingleAssetVault (XLS-65) | not enabled | pooled lender capital; unavailable |
| LendingProtocol (XLS-66) | not enabled | protocol loans; unavailable |
| Hooks | not enabled | on-ledger accrual; unavailable |
The API re-reads this table live at GET /v1/xrpl/amendments. The issuance tooling refuses to create vaults or protocol loans on any network where XLS-65 and XLS-66 are not enabled.
Lifecycle
| Step | Ledger transaction | Signer |
|---|---|---|
| Verification | CredentialCreate (issuer to subject), then CredentialAccept by the client | credential issuer, then client |
| Facility request | TrustSet to the facility issuer with LimitAmount equal to the requested limit | client |
| Facility approval | TrustSet with the authorize flag on an issuer that has RequireAuth set | issuer |
| Draw | Payment of the credit currency, issuer to client, memo type flashrouter/draw | issuer |
| Repayment | Payment client to issuer, memo type flashrouter/repay | client |
| Accrual | off-ledger simple interest (ACT/365) posted as a Payment with memo type flashrouter/accrual carrying the inputs | issuer |
| Collateral | EscrowCreate client to issuer with FinishAfter at maturity | client |
| Default recovery | Clawback | issuer |
Before authorization, a draw fails at the ledger. On testnet on 2026-09-04 the ledger rejected such a draw with tecPATH_DRY.
What the ledger shows
- Who the issuer is, and that it authorized the line (
peer_authorizedfrom the holder's side). - The limit and the current drawn balance.
- Every draw and repayment, with timestamps and memos.
- Any escrowed collateral and its terms.
- That clawback is enabled on the issuer.
Reading a facility
GET /v1/xrpl/tradeline/{account}?network=mainnet returns the account's trust lines with side (holder or issuer), currency and decoded currency name, limit, drawn amount, authorization state, freeze state, plus escrows, credentials, account flags, and the validated ledger index at read time. The facility viewer on the site wraps this endpoint and links every object to the explorer. Any XRPL explorer shows the same objects without the API.
Testnet evidence
Twelve transactions on XRPL testnet on 2026-09-04, from issuer rhqGoX6Fai9V3AfoWEjDRtoJyW1sk4b2GK to client rpno8F79Pd9Zd9goD9S7zryU1bDebgroAx, cover the full lifecycle: account setup, credential issue and accept, trust-line request, the rejected pre-authorization draw, authorization, a 25,000 draw, a 5,000 repayment, a 10 XRP collateral escrow, and an accrual posting. Hashes are in the repository at xrpl/evidence/ and resolve on https://testnet.xrpl.org.
Mainnet gate
Mainnet issuance waits on an operator decision about which account is the issuer and where its key lives. Every write command in the operator tooling refuses mainnet unless an environment flag is set and a confirm phrase is typed; demonstration and faucet commands never run on mainnet under any setting.
Boundaries
The desk does not report anything to a credit bureau, describe the facility as consumer credit, hold the client's XRP or tokens, or state a rate, fee, or limit on any public surface.