Skip to content

Use this page for account operations in the Ripple Custody UI. For API procedures, see Manage accounts with the API. For the account model, see Accounts.

Account actions

ActionUI procedure
Create an accountCreate an account in the UI
View account detailsView account details
Update account detailsUpdate account details
Add ledgers to an accountAdd ledgers to an account
Check account balancesCheck account balances

Create an account in the UI

Before you create an account, confirm the vault that will protect the account keys and the key derivation strategies supported by that vault. For more information, see View vault details.

  1. Navigate to Accounts.
  2. Select Create an account.
  3. Enter the account name and description.
  4. Select the vault.
  5. In Advanced settings, select the key derivation strategy. By default, this is limited to hard key derivation. To enable soft or random key derivation, contact your Ripple liaison.
  6. In Custom properties, specify optional metadata for the account.
  7. Associate the account with one or all available ledgers:
    • For a single-ledger account, select Single ledger and select the ledger.
    • For a multi-ledger account, select Multi ledgers. Ripple Custody associates all compatible ledgers with the account.
  8. Select Submit for Approval and sign the operation with the app.

The account is created after the intent is approved and executed.

View account details

  1. Navigate to Accounts.
  2. To view general details, click Account details at the top right.
  3. To view accounting transaction details, click the relevant tab, then click the transaction item.

The account view includes account ID, vault, key strategy, associated ledgers, ledger status, and account balances.

Update account details

Use this procedure to update mutable account details such as name or custom properties.

  1. Navigate to Accounts.
  2. Open the account detail view.
  3. Click Edit account.
  4. Update the account name or custom properties.
  5. Click Submit for approval and sign the operation with the app.

The account details are updated after the intent is approved and executed.

Add ledgers to an account

  1. Navigate to Accounts.
  2. Open the account detail view.
  3. Click Add ledgers.
  4. Select the ledgers you want to add.
  5. Click Submit for approval and sign the operation with the app.

The new ledgers are associated with the account after the intent is approved and executed.

Check account balances

Before you send assets, check the amount available to send. Balances depend on transaction state and ledger-specific behavior.

Account balances include:

AmountDescription
Total amountTotal balance reported by the blockchain.
Reserved amountBalance allocated but not available for spending, including amounts and fees for transactions that are initiated but not yet executed.
Quarantined amountIncoming transfers that are not yet released from quarantine. For more information, see Release quarantined assets.
Available amountBalance available for new transactions.
  1. Navigate to Accounts.
  2. In the account overview, review the highest available balance.
  3. Click the account to view the balance breakdown.

You can only force account balance updates with the API. For more information, see Force an account balance update.

Accounts

Manage accounts with the API