{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/wallet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create your first wallet","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":"create-your-first-wallet","__idx":0},"children":["Create your first wallet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A wallet stores your digital assets on a specific blockchain. Each wallet has a public address for receiving funds and a private key (secured by MPC) for authorizing outgoing transactions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-wallet","__idx":1},"children":["Create a wallet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required role:"]}," Owner, Administrator, or Proposer."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click into the vault where you want to create the wallet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create wallet"]},". The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create wallet"]}," form opens with four steps: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Details"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advanced"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confirm"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Details"]}," step, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Blockchain"]}," you want the wallet to operate on."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody (Wallet) supports the following blockchains:"]},{"$$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":"Blockchain"},"children":["Blockchain"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ethereum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Multi-chain EVM address"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Arbitrum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shares address with Ethereum wallet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Avalanche"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shares address with Ethereum wallet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shares address with Ethereum wallet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BNB Chain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shares address with Ethereum wallet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Polygon"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shares address with Ethereum wallet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1Money"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sandbox only. Shares address with Ethereum wallet"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bitcoin"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non-EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Solana"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non-EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MPC keystore only"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tron"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non-EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["XRP Ledger"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non-EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires activation fee before use"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"EVM wallets work across chains"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you create an Ethereum wallet, the same address is valid on all supported EVM chains (Arbitrum, Polygon, Base, BNB Chain, and Avalanche). Ripple Custody (Wallet) detects deposits on any supported EVM chain automatically and lets you send on any chain where you hold a balance."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"XRP Ledger activation fee"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The XRP Ledger requires an activation fee of 1 XRP before the wallet can send or receive transactions. Fund the wallet with at least 1 XRP to activate it."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select keystore"]},", choose how the wallet's private key is secured. In sandbox, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HSM"]}," is preselected after you choose a blockchain, except Solana, which supports MPC only.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MPC"]}," — Private key shards are distributed across your MPC quorum devices. Required for production."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HSM"]}," — Private key is stored in a Hardware Security Module. Available in sandbox only, and not for Solana."]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Keystore cannot be changed"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The keystore method is permanent once the wallet is created. Choose carefully."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"MPC quorum required"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To select MPC, you must have a confirmed quorum. If you haven't created one yet, complete ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/get-started/console/configure-devices-and-quorums"},"children":["Configure devices and quorums"]}," first. After selecting MPC, use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quorum"]}," dropdown to choose the quorum for this wallet."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," that identifies the wallet (for example, \"ETH Outbound\" or \"XRP Treasury\"). Must be 5–50 characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}," that explains the wallet's purpose. Must be 5–100 characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},". On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," step, you can turn on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Outgoing"]}," transactions, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Raw signing"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Freeze transactions by default"]},", and add up to 10 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tags"]},". All three settings are off by default. Leave them off for now: you enable outgoing transactions after you set up a policy in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/get-started/console/unlock-outgoing-transactions"},"children":["Unlock outgoing transactions"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},". On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advanced"]}," step, optionally enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Correlation ID"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["External ID"]}," if you use external tracking systems."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},". On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confirm"]}," step, review the wallet details and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create wallet"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you selected MPC, all quorum devices receive a notification to approve the wallet creation. Every device must approve within 5 minutes."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The console confirms that the wallet was created and finishes provisioning it in the background. It then offers to create a policy rule for the wallet. You can do that now, or click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Not now"]}," and follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/get-started/console/unlock-outgoing-transactions"},"children":["Unlock outgoing transactions"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/get-started-create-wallet.229d74b1405e21078e99e5b725fe0c7a4cb2a6b61776e05994993a92443fb9a4.9fccc40d.png","alt":"The Details step of the Create wallet form, with a blockchain selected and the HSM and MPC keystore options"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fund-your-wallet","__idx":2},"children":["Fund your wallet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your wallet starts with a zero balance. Deposit funds from an external source before you attempt any outgoing transactions."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the wallet. The wallet address appears at the top of the wallet page, and in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["General"]}," under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wallet Address"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the wallet address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send funds to that address from an exchange, another wallet, or any external source."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for on-chain confirmation. The balance appears on the wallet's asset list once the transaction confirms on the blockchain."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/get-started-wallet-address.8e4aa81a624eaf8cf2be8d8999a5bfaf565d14d56792df21b39a26edfe8681b8.9fccc40d.png","alt":"The General tab of Wallet settings, showing the Wallet Address field"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Your wallet is deposit-only"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this point, your wallet can receive funds but ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["cannot send outgoing transactions"]},". Ripple Custody (Wallet) operates a zero-trust model — you must create a transaction policy, register destination addresses, and enable outgoing transactions before you can send anything. The next step walks you through this process."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-step","__idx":3},"children":["Next step"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unlock outgoing transactions by setting up policies and addresses:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/get-started/console/unlock-outgoing-transactions"},"children":["Unlock outgoing transactions"]}]}]}]},"headings":[{"value":"Create your first wallet","id":"create-your-first-wallet","depth":1},{"value":"Create a wallet","id":"create-a-wallet","depth":2},{"value":"Fund your wallet","id":"fund-your-wallet","depth":2},{"value":"Next step","id":"next-step","depth":2}],"frontmatter":{"title":"Create your first wallet","seo":{"title":"Create your first wallet"}},"lastModified":"2026-10-09T09:02:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/wallet/get-started/console/create-your-first-wallet","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}