Menu

Add and fund an asset

An asset is money your node holds for you, such as test XRP or DSUSD. You choose it in the wallet, and your node sets up where it keeps it: your own account on the XRP Ledger, and the asset's settlement hub. Then you put test money on it, and remove it when you are done with it.

On this page
  1. Choose your assets
  2. The Assets page
  3. An asset's page
  4. What you can spend
  5. Fund it with test XRP
  6. Fund it with DSUSD
  7. What the XRP Ledger holds
  8. The hub
  9. Remove an asset
  10. When something is wrong

Choose your assets

You choose from the same checklist twice: once during setup, under Choose what your node holds, and later on the Assets page, under + Add an asset. It lists the assets your node offers and does not hold yet.

  1. Tick each asset you want.
  2. Choose Continue →. It stays grayed out while nothing is ticked.

On the testnet, your node offers two:

Asset What it is
Test XRP XRP on the XRP Ledger testnet, free from the testnet's faucet. Your node joins the testnet's XRP hub to pay and be paid in it. It is ticked to start with.
Test DSUSD DSUSD, Dassie's test dollar token, on the same account. Your node joins the testnet's DSUSD hub for it.

Some assets need another. DSUSD's ledger takes its fees and reserve in XRP, so ticking Test DSUSD ticks Test XRP too, and holds it there, with the note "Needed for DSUSD's fees."

For each asset you choose, your node adds two things: your own account on the asset's ledger, which holds your money and funds the hub, and the asset's settlement hub, built into your release, which four of the testnet's bootstrap nodes keep. Your node settles with peers only through hubs, so it finds its peers there. There is nothing more to join. The settlement schemes reference lists every ledger a node can run.

XRP and RLUSD on the XRP Ledger mainnet are not offered yet: a node refuses real money for now, and a testnet node lists only the testnet's assets. What's next

A development build offers Stub dollars too: the made-up dollars that Dassie's tests and the local dev network run on. A release build never offers them.

The Assets page

Assets in the top menu shows a card for each asset you hold: its balance, what you can spend of it where that is less, how your node's connection to its ledgers stands, and Open, which opens the asset's own page. + Add an asset opens the checklist above, with the assets you do not hold yet.

At the bottom, the Exchange rates card lists what one dollar buys in each of your currencies, and how old each rate is. Exchange-rate settings says where the rates come from.

An asset's page

Open an asset from its card on Assets, or from its row on the Dashboard. The Balance card shows your balance in large figures, and below it where the money is, with what each part sets aside:

On the card What it means
In your account What your own account on the XRP Ledger holds, and how much of it is the XRP Ledger's reserve. A token such as DSUSD has its reserve in XRP, so the card says it is counted with your XRP.
In the hub What your account in the settlement hub holds: what is there to spend, what is held for your peers, and the hub's reserves.
On its way Money moving between your account and the hub, which the other side has not booked yet. Shown only while there is some.
You can pay … now What a payment in this asset can spend right now.

Under it are Send and Receive for the asset, its Deposit section (below), what the XRP Ledger holds, the hub, and the asset's ledgers.

What you can spend

Your balance counts everything you have of the asset: the reserves too, both your XRP Ledger account's and your hub account's, the reserves of what your node holds for its peers, and what is held for them. A payment cannot spend all of that. Where it can spend less than the balance, a quiet line under the balance says how much, such as 15.55 spendable, on the Dashboard and on Assets alike.

Usually your node counts what is in your own account toward what you can spend: it moves money into the hub as a payment needs it. When it cannot, such as while you have stopped its own moves into the hub, only what is in the hub counts, and the asset's page says why next to You can pay … now. Your hubs says more about those moves.

Fund it with test XRP

A new account does not exist on the XRP Ledger until it receives enough XRP for its reserve. Until then, the wallet says "The account does not exist yet", and your node asks the testnet faucet for XRP by itself. Usually that is all it takes.

To ask for more, or to send test XRP from another wallet, open the XRP page and go to its Deposit section:

  1. Choose Get test XRP to ask the faucet, once a minute at most. The XRP shows up once the ledger validates it.
  2. Or send test XRP from another testnet wallet to your account's address, shown as text and as a QR code. It needs no destination tag: the address is your node's alone. The section also says how much the XRP Ledger holds back as the account's reserve.

Receive shows the same address and the faucet on the asset's tab. Whatever you deposit lands in your own account. Your node moves into the hub what it needs there, and what is beyond a float in the hub back to your account (Where the money stays).

Fund it with DSUSD

DSUSD lives on the same account as your test XRP, on a trust line to Dassie's DSUSD issuer that your node sets up itself. The account pays its fees and the trust line's reserve in XRP, so it needs XRP first.

  1. Choose Test DSUSD, and open its page. Its Deposit section names both what the account needs: the token, and XRP for the fees.
  2. If the account does not exist yet, choose Get test XRP for its fees. DSUSD cannot arrive before the account and its trust line exist, and the page says when the line is there.
  3. DSUSD has no faucet. Buy it with test XRP on the testnet's XRP/DSUSD pool, from any XRP Ledger wallet: a payment to your deposit address whose amount is DSUSD, paid for with XRP, swaps through the pool and arrives as DSUSD.

The section shows the issuer's address, what the trust line holds, and how much XRP the account has for fees. Send only DSUSD of that issuer, and test XRP: other tokens may be lost.

Your node watches DSUSD's price on its pool, and stops converting it while the price is off a dollar. The Deposit section shows the guard's last reading. Dollar tokens and the peg guard explains what that pause does.

What the XRP Ledger holds

Your balance is your node's books. This section of an asset's page shows the account behind them as the XRP Ledger last reported it, never added up from the books:

  • its XRP, and the reserve the ledger holds back on it;
  • each token on a trust line, with its issuer;
  • a red notice if a token's issuer froze your line or the whole token, and what that stops.

The two differ while settlements are on their way, and by what you owe peers or they owe you.

The hub

The Hub card says how your account in the asset's settlement hub stands. Hub details on the Hubs page opens Hubs, where you deposit and withdraw yourself, set the target your node keeps the hub near, and see what you and your peers hold for each other.

Remove an asset

At the bottom of an asset's page, Ledgers lists the ledgers that hold it, by their scheme's name: your own account, such as XRP Ledger Testnet, and its hub's, such as XRP in a settlement hub on the XRP Ledger Testnet. Each has a Remove link. Remove the hub first, then the account: a hub funds from your account, so the account stays while a hub needs it. Your XRP account stays too while you are in the DSUSD hub, whose escrow pays its fees in XRP.

  1. Choose Remove next to the ledger.
  2. Read the checklist. These keep a ledger in use, and must go first: hubs that fund from it, BTP tokens that use it, ended peerings still to be settled on it, payments from it still being sent, and money on its way between it and its settlement hub.
  3. Type the confirmation the page asks for, such as DELETE HUB-XRPL-TESTNET-XRP, and choose Remove ledger account.

A hub's ledger first settles up with the peers that settle on it, which takes a few minutes at most, then waits about an hour for what they may still send, and goes. The page says "Being removed" meanwhile.

The page warns of a possibility to lose funds: removing a ledger stops your node from using it, and while the ledger is gone your node does not settle on it. What your books hold on it stays, and comes back when you add the asset again. The money on the XRP Ledger stays on your account, whose keys come from your recovery phrase.

When something is wrong

  • "Connecting to the ledger: waiting, as …" names what your node waits for, such as a list of validators it has none of yet. It usually clears by itself.
  • "Something is wrong with the ledger" names the problem. Check that your node reaches the internet, and look at dassie status.
  • The faucet refuses. It gives once a minute at most, and the testnet's faucet is sometimes down. Try again later, or send test XRP from another wallet.

Why it works this way: why you hold one balance per asset, and your node manages the hub's part of it. Why the wallet shows what the XRP Ledger reports, and not what the books add up to. Ledgers, books and realms explains it in plain words.

A kopje of granite blocks against the sun, in veld grass; one dassie climbs its slab, one keeps lookout on top inside the sun, and one sleeps on the next rock; on a wide screen, a pair sits on a kopje to the left