Accounts are blockchain wallets that store assets, track transfers, and enable transactions across multiple ledgers.
- Multi-ledger accounts work with all supported blockchains using a single account ID.
- Single-ledger accounts are optimized for specific chains when needed.
- Accounts belong to domains and derive their blockchain addresses from a vault's master seed.
Your account structure directly impacts operational efficiency and cost. Multi-ledger accounts simplify management when you need to receive multiple asset types at one logical "wallet." Choosing the right account types affects reconciliation complexity, gas costs, and client experience.
For architects and operators: Plan your account hierarchy during domain design and ensure your account-naming conventions support operational clarity at scale.
Before reading this page, you should understand:
- Key management - How Ripple Custody protects cryptographic keys
- Key derivation - How accounts derive their blockchain addresses
Blockchain transactions are managed in Ripple Custody using accounts, which work in the same way as any wallet interacting with a blockchain.
Ripple Custody accounts:
- Store coins and other tokens.
- Track transfers of coins and tokens to and from the blockchain and other accounts.
Ripple Custody organizes accounts within a hierarchical structure. Understanding this structure is essential for designing your custody operations.
| Level | Description |
|---|---|
| Tenant | Your organization's Ripple Custody instance. All resources belong to a single tenant. |
| Vault | A signing component connected to a key management system (HSM or MPC). Each vault has its own master seed. You can have multiple vaults (e.g., hot and cold). |
| Domain | An organizational unit that groups accounts. Domains enable logical separation (e.g., by business unit, client, or purpose). Each domain can be assigned to a specific vault. |
| Account | A logical entity that holds assets. Accounts derive blockchain addresses from the vault's master seed using the key derivation process. |
Domains provide several benefits:
- Organizational clarity: Group accounts by purpose, business unit, or client
- Vault assignment: All accounts in a domain use the same vault for signing
- Policy scope: Governance policies can be applied at the domain level
- Reporting: Generate reports and audit trails per domain
For more on the concept of domains, see Domains. For information on creating domains, see Create domains (UI) or Create domains (API).
There are several types of accounts available in Ripple Custody:
| Account Type | Description | Use Case |
|---|---|---|
| Multi-ledger accounts | The standard account type that can perform transactions on all compatible ledgers or a selection of ledgers of your choice | General custody operations across multiple blockchains |
| Single-ledger accounts | Accounts that perform transactions only on a single ledger | Dedicated accounts for specific blockchain operations |
By default, any accounts you create in Ripple Custody can interact with all compatible blockchain ledgers.
Accounts in Ripple Custody progress through distinct states from creation to potential closure:
| State | Description | Allowed Operations |
|---|---|---|
| Created | Account exists but has never transacted. Blockchain addresses are derived but may not be funded. | Receive funds, view balances, modify settings |
| Active | Account is operational and can send and receive transactions. | All operations including send, receive, stake |
| Suspended | Account is temporarily disabled. Funds remain but outbound transactions are blocked. | Receive funds, view balances (no sends) |
| Closed | Account is permanently closed. Should have zero balance before closure. | View historical data only |
Before closing an account, ensure all funds have been transferred out. Closing an account with a non-zero balance may result in loss of funds.
Ripple Custody determines the ledgers that are compatible with the account based on the following factors:
- The key derivation strategy you choose.
- The key derivation capabilities of your key management system (KMS).
For more information, see Key derivation.
For information on creating and managing accounts, see:
| Topic | Description |
|---|---|
| Transactions | Learn how to send and receive assets |
| Key derivation | Understand how accounts derive blockchain addresses |
| Domains | Learn how accounts are organized within domains |
| Supported ledgers | See which blockchains are supported |