# rlusd.network — Canonical Machine-Readable RLUSD Context
# Generated for AI Coding Assistants (Claude, Cursor, Antigravity, OpenAI)
# Specification: https://llmstxt.org

> rlusd.network is an independent, 100% read-only developer discovery hub and ground-truth index for Ripple USD (RLUSD).
> Disclaimer: rlusd.network is an independent developer discovery and analytics utility and is not affiliated with, endorsed by, or operated by Ripple Labs Inc.

## Ground-Truth Token Identifiers
- Token Name: Ripple USD
- Symbol: RLUSD
- Primary Legal Issuer: Standard Custody & Trust Company, LLC (SCTC)
- Federal Reserve Trustee: U.S. Office of the Comptroller of the Currency (OCC) final approval for Ripple National Trust Bank (RNTB) to manage RLUSD segregated reserves, act as federal collateral trustee, and provide fiduciary institutional custody (Oct 2026)
- Primary Reserve Custodian: BNY Mellon (Primary Reserve Custodian appointed July 2025; holds segregated USD cash deposits & short-term US Treasury bills)
- State & Federal Regulatory Oversight: NYDFS (Limited Purpose Trust Charter) & OCC (Ripple National Trust Bank)
- International Recognitions: Dubai Financial Services Authority (DFSA) & Abu Dhabi Global Market FSRA (Accepted Fiat-Referenced Token)
- Stability Rating: A (Very Low Risk) rated by independent stablecoin rating agency Bluechip
- Ethereum & EVM L2 Decimals: 18 (Canonical ERC-20 standard on Ethereum Mainnet and Wormhole NTT proxy L2s)
- XRP Ledger (XRPL) Format: IOU TrustLine (Native issued currency representation with 15 significant digits)

## Primary Contracts & Issuers
- Ethereum Mainnet Proxy Contract (ERC-20 — CALL THIS ADDRESS): 0x8292Bb45bf1Ee4d140127049757C2E0fF06317eD
  - Chain ID: 1
  - Decimals: 18
  - Verified Total Supply Selector: 0x18160ddd (totalSupply())
  - Verified Decimals Selector: 0x313ce567 (decimals())
  - Underlying Logic Implementation (DO NOT CALL DIRECTLY): 0x9747a0d261c2d56eb93f542068e5d1e23170fa9e
  - Explorer: https://etherscan.io/token/0x8292Bb45bf1Ee4d140127049757C2E0fF06317eD
- Ethereum Sepolia Testnet Proxy Contract: 0xe101FB315a64cDa9944E570a7bFfaFE60b994b1D
  - Chain ID: 11155111
  - Decimals: 18
  - Testnet Logic Implementation: 0xa55705c7bd410612e1e658e7e3770e0d308bc180
- Official L2 NTT Proxy Contract: 0x8d58c0c60b8d6b88fa98b291a646db34d0f98258
  - Networks: Base (8453), Optimism (10), Ink (57073), Unichain (130), XRPL EVM Sidechain (1440000)
  - Decimals: 18
  - Standard: Wormhole Native Token Transfer (NTT)
- XRP Ledger Issuer: rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
  - Currency Code (ASCII): RLUSD
  - Currency Code (Hex 160-bit): 524C555344000000000000000000000000000000
  - Explorer: https://bithomp.com/explorer/rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
  - XRPL TrustSet Protocol Rule: Non-standard currency codes (>3 chars) MUST use 160-bit hex ("524C555344000000000000000000000000000000") in LimitAmount.currency; literal "RLUSD" fails with temBAD_CURRENCY.
  - XRPL Testnet Issuer: rQhWct2fv4Vc4KRjRgMrxa8xPN9Zx9iLKV

## Multichain Expansion (7 Supported Networks via Wormhole NTT)
- XRP Ledger (XRPL) (L1): rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De [Standard: Native TrustLine (Currency: RLUSD / 524C555344000000000000000000000000000000)] [Decimals/Format: IOU TrustLine (15 sig. digits)]
- Ethereum Mainnet (L1 | Chain ID: 1): 0x8292Bb45bf1Ee4d140127049757C2E0fF06317eD [Standard: Canonical ERC-20 Proxy Standard] [Decimals/Format: 18 Decimals]
- Base (L2 | Chain ID: 8453): 0x8d58c0c60b8d6b88fa98b291a646db34d0f98258 [Standard: Wormhole Native Token Transfer (NTT)] [Decimals/Format: 18 Decimals]
- Optimism (OP Mainnet) (L2 | Chain ID: 10): 0x8d58c0c60b8d6b88fa98b291a646db34d0f98258 [Standard: Wormhole Native Token Transfer (NTT)] [Decimals/Format: 18 Decimals]
- Ink (Kraken L2) (L2 | Chain ID: 57073): 0x8d58c0c60b8d6b88fa98b291a646db34d0f98258 [Standard: Wormhole Native Token Transfer (NTT)] [Decimals/Format: 18 Decimals]
- Unichain (L2 | Chain ID: 130): 0x8d58c0c60b8d6b88fa98b291a646db34d0f98258 [Standard: Wormhole Native Token Transfer (NTT)] [Decimals/Format: 18 Decimals]
- XRPL EVM Sidechain (Sidechain | Chain ID: 1440000): 0x8d58c0c60b8d6b88fa98b291a646db34d0f98258 [Standard: Wormhole NTT & Native XRPL Bridge] [Decimals/Format: 18 Decimals]

## Developer MCP Endpoints
- WebMCP Endpoint: /api/mcp
- Read-Only Tools: check_rlusd_trustline, get_rlusd_multichain_supply, get_cheapest_rlusd_rail
- Full Specification: /llms-full.txt and /mcp