{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/accounts-and-assets/accounts/overview","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/accounts-and-assets/accounts/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/accounts-and-assets/accounts/overview","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/accounts-and-assets/accounts/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/accounts-and-assets/accounts/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/accounts-and-assets/accounts/overview","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/accounts-and-assets/accounts/overview","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Accounts","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"accounts","__idx":0},"children":["Accounts"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Executive summary"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accounts are blockchain wallets that store assets, track transfers, and enable transactions across multiple ledgers."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Multi-ledger accounts work with all supported blockchains using a single account ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Single-ledger accounts are optimized for specific chains when needed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accounts belong to domains and derive their blockchain addresses from a vault's master seed."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Why this matters"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For architects and operators"]},": Plan your account hierarchy during domain design and ensure your account-naming conventions support operational clarity at scale."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Prerequisites"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before reading this page, you should understand:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/overview/security/cryptographic-trust-model"},"children":["Key management"]}," - How ","Ripple Custody"," protects cryptographic keys"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/account-key-derivation-and-ledger-compatibility"},"children":["Key derivation"]}," - How accounts derive their blockchain addresses"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Blockchain transactions are managed in ","Ripple Custody"," using ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["accounts"]},", which work in the same way as any wallet interacting with a blockchain."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody"," accounts:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store coins and other tokens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Track transfers of coins and tokens to and from the blockchain and other accounts."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"organizational-structure","__idx":1},"children":["Organizational structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody"," organizes accounts within a hierarchical structure. Understanding this structure is essential for designing your custody operations."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n subgraph Tenant[\"Tenant\"]\n subgraph V1[\"Vault 1 (Hot)\"]\n MS1[Master Seed]\n end\n subgraph V2[\"Vault 2 (Cold)\"]\n MS2[Master Seed]\n end\n\n subgraph D1[\"Domain: Trading\"]\n A1[\"Account: BTC Trading\"]\n A2[\"Account: ETH Trading\"]\n end\n\n subgraph D2[\"Domain: Treasury\"]\n A3[\"Account: Reserve\"]\n A4[\"Account: Hot Wallet\"]\n end\n\n subgraph D3[\"Domain: Client Omnibus\"]\n OA[\"Omnibus Account (on-chain)\"]\n VA1[\"Virtual: Client A\"]\n VA2[\"Virtual: Client B\"]\n VA3[\"Virtual: Client C\"]\n end\n end\n\n V1 -->|\"Signs for\"| D1\n V1 -->|\"Signs for\"| D3\n V2 -->|\"Signs for\"| D2\n","diagramHtml":"

Tenant

Signs for

Signs for

Signs for

Domain: Client Omnibus

Omnibus Account (on-chain)

Virtual: Client A

Virtual: Client B

Virtual: Client C

Vault 1 (Hot)

Master Seed

Domain: Trading

Account: BTC Trading

Account: ETH Trading

Vault 2 (Cold)

Master Seed

Domain: Treasury

Account: Reserve

Account: Hot Wallet

","diagramHtmlDark":"

Tenant

Signs for

Signs for

Signs for

Domain: Client Omnibus

Omnibus Account (on-chain)

Virtual: Client A

Virtual: Client B

Virtual: Client C

Vault 1 (Hot)

Master Seed

Domain: Trading

Account: BTC Trading

Account: ETH Trading

Vault 2 (Cold)

Master Seed

Domain: Treasury

Account: Reserve

Account: Hot Wallet

"},"children":["flowchart TD\n subgraph Tenant[\"Tenant\"]\n subgraph V1[\"Vault 1 (Hot)\"]\n MS1[Master Seed]\n end\n subgraph V2[\"Vault 2 (Cold)\"]\n MS2[Master Seed]\n end\n\n subgraph D1[\"Domain: Trading\"]\n A1[\"Account: BTC Trading\"]\n A2[\"Account: ETH Trading\"]\n end\n\n subgraph D2[\"Domain: Treasury\"]\n A3[\"Account: Reserve\"]\n A4[\"Account: Hot Wallet\"]\n end\n\n subgraph D3[\"Domain: Client Omnibus\"]\n OA[\"Omnibus Account (on-chain)\"]\n VA1[\"Virtual: Client A\"]\n VA2[\"Virtual: Client B\"]\n VA3[\"Virtual: Client C\"]\n end\n end\n\n V1 -->|\"Signs for\"| D1\n V1 -->|\"Signs for\"| D3\n V2 -->|\"Signs for\"| D2\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For pooled custody patterns where one on-chain account represents many off-chain participant balances, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/omnibus/overview"},"children":["Omnibus"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hierarchy-levels","__idx":2},"children":["Hierarchy levels"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Level"},"children":["Level"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tenant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your organization's ","Ripple Custody"," instance. All resources belong to a single tenant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vault"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A logical entity that holds assets. Accounts derive blockchain addresses from the vault's master seed using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/account-key-derivation-and-ledger-compatibility"},"children":["key derivation"]}," process."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-domains-matter","__idx":3},"children":["Why domains matter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Domains provide several benefits:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organizational clarity"]},": Group accounts by purpose, business unit, or client"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vault assignment"]},": All accounts in a domain use the same vault for signing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Policy scope"]},": Governance policies can be applied at the domain level"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reporting"]},": Generate reports and audit trails per domain"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more on the concept of domains, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/domains"},"children":["Domains"]},". For information on creating domains, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/domains/manage-domains#create-a-domain-with-the-api"},"children":["Manage domains"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-types","__idx":4},"children":["Account types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are several types of accounts available in ","Ripple Custody",":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Account Type"},"children":["Account Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use Case"},"children":["Use Case"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Multi-ledger accounts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The standard account type that can perform transactions on all compatible ledgers or a selection of ledgers of your choice"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["General custody operations across multiple blockchains"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Single-ledger accounts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accounts that perform transactions only on a single ledger"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dedicated accounts for specific blockchain operations"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, any accounts you create in ","Ripple Custody"," can interact with all compatible blockchain ledgers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-lifecycle","__idx":5},"children":["Account lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accounts in ","Ripple Custody"," progress through distinct lock states as operators create, use, lock, and unlock them:"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"stateDiagram-v2\n [*] --> Unlocked: Create account unlocked\n [*] --> Locked: Create account locked\n Unlocked --> Unlocked: Transactions\n Unlocked --> Locked: Lock account\n Locked --> Unlocked: Unlock account\n","diagramHtml":"

Create account unlocked

Create account locked

Transactions

Lock account

Unlock account

Unlocked

Locked

","diagramHtmlDark":"

Create account unlocked

Create account locked

Transactions

Lock account

Unlock account

Unlocked

Locked

"},"children":["stateDiagram-v2\n [*] --> Unlocked: Create account unlocked\n [*] --> Locked: Create account locked\n Unlocked --> Unlocked: Transactions\n Unlocked --> Locked: Lock account\n Locked --> Unlocked: Unlock account\n"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"State"},"children":["State"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Allowed Operations"},"children":["Allowed Operations"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unlocked"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account is operational. It can be created in this state or moved here with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UnlockAccount"]}," intent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send and receive transactions, view balances, modify settings"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Locked"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account is disabled for outbound activity. Funds remain on chain, and the account can be moved here with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_LockAccount"]}," intent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receive funds, view balances, unlock account"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ledger-compatibility","__idx":6},"children":["Ledger compatibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody"," determines the ledgers that are compatible with the account based on the following factors:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The key derivation strategy you choose."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The key derivation capabilities of your key management system (KMS)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/account-key-derivation-and-ledger-compatibility"},"children":["Key derivation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-management","__idx":7},"children":["Account management"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For information on creating and managing accounts, see:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/manage-accounts-ui"},"children":["Manage accounts in the UI"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/manage-accounts-api"},"children":["Manage accounts with the API"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/ledger-specific-settings"},"children":["Ledger-specific account setup"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":8},"children":["Next steps"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Topic"},"children":["Topic"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/transactions/overview"},"children":["Transactions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Learn how to send and receive assets"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/ledger-specific-settings"},"children":["Ledger-specific account setup"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Prepare Hedera, Stellar, Tezos, and XRPL accounts for ledger-specific behavior"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/accounts/account-key-derivation-and-ledger-compatibility"},"children":["Key derivation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Understand how accounts derive blockchain addresses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/governance/domains"},"children":["Domains"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Learn how accounts are organized within domains"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/reference/supported-ledgers"},"children":["Supported ledgers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See which blockchains are supported"]}]}]}]}]}]},"headings":[{"value":"Accounts","id":"accounts","depth":1},{"value":"Organizational structure","id":"organizational-structure","depth":2},{"value":"Hierarchy levels","id":"hierarchy-levels","depth":3},{"value":"Why domains matter","id":"why-domains-matter","depth":3},{"value":"Account types","id":"account-types","depth":2},{"value":"Account lifecycle","id":"account-lifecycle","depth":2},{"value":"Ledger compatibility","id":"ledger-compatibility","depth":2},{"value":"Account management","id":"account-management","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Accounts"}},"lastModified":"2026-07-27T10:10:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.38/accounts-and-assets/accounts/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}