Networks and tokens

OpenWallet supports the XRP Ledger: its own currency, XRP, and every token issued on it. Who issued a token matters more than its name.

Networks

NetworkNetwork IDWhat it is forServers the wallet uses
Mainnet0Real XRP and tokens. The default.s1.ripple.com, then s2.ripple.com
Testnet1Practice. XRP has no value; a faucet gives it away.s.altnet.rippletest.net
Devnet2Newer ledger features, for developers.s.devnet.rippletest.net

The network badge at the top of the wallet always says which one you are on. Before it signs, the wallet asks the server which network it is and refuses if the answer is not the one you chose. Your main-network address and your test address are different.

XRP and reserves

  • An XRP Ledger account exists once it holds at least 1 XRP, the base reserve. That 1 XRP stays locked while the account exists.
  • Each token an account holds locks another 0.2 XRP.
  • The wallet shows your balance as Available and Locked for account reserve, so you know what you can send.
  • The ledger sets these amounts, not OpenWallet, and its validators can change them by vote.

Tokens

To hold a token, your account first says it trusts that issuer for that currency: a trust line. Adding a token in OpenWallet creates one (with the "no rippling" setting, so your balance is not used to route other people's payments) and locks 0.2 XRP. You can remove a token once its balance is 0, which releases the 0.2 XRP.

Anyone can issue a token with any name. A token called RLUSD from an account that is not Ripple's is not RLUSD. Only the issuer address says who stands behind a token.

Verified issuers

OpenWallet ships a short list of issuers checked against each issuer's own published addresses. They show a verified badge. Any other token shows its issuer address and, if the issuer publishes one, its domain marked unverified.

TokenNetworkIssuerIssuer address
RLUSD (Ripple USD)MainnetRipplerMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
RLUSD (Ripple USD)TestnetRipplerQhWct2fv4Vc4KRjRgMrxa8xPN9Zx9iLKV
USDC (USD Coin)MainnetCirclerGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE
USDC (USD Coin)TestnetCirclerHuGNhqTG32mfmAvWA8hUyWRLV3tCSwKQt

A token whose name looks like one of these (RLUSD, RIUSD, RLU5D) from a different issuer gets a warning, and you must tick "I know this is a different token" before you can add it.

What an issuer can do

When you add a token, the wallet reads the issuer's account and tells you, in plain words:

  • Issuer can freeze this token: it can stop your balance from moving.
  • Issuer can claw back: it can take the token back from your account. Ripple can do both with RLUSD.
  • Transfer fee: the issuer keeps a share of every transfer between holders, for example 0.2%. RLUSD has none.
Adding RLUSD: the verified issuer, and the facts that Ripple can freeze and claw back RLUSD.
What the wallet shows before you add RLUSD.

Prices and practice swaps

  • The total balance in dollars is approximate, priced from the ledger's own markets (AMM pools). Tokens without a price on the ledger are not counted.
  • On Testnet you can swap test XRP for test RLUSD, to try tokens without real money. The quote allows up to 2% for the price moving; if it would cost more, nothing happens.