{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/wallet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Configure wallets and vaults","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":"configure-wallets-and-vaults","__idx":0},"children":["Configure wallets and vaults"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vaults are organizational containers that group related wallets together. As an owner or administrator, you create vaults and wallets, configure wallet-level settings, and control which operations each wallet permits. This guide covers vault and wallet setup from the admin perspective."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-vault","__idx":1},"children":["Create a vault"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vaults"]}," in the console sidebar."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create vault"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["name"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["description"]}," for the vault."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Vault organization strategies"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use vaults to separate wallets by:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business unit"]}," — one vault per department or team"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risk profile"]}," — separate hot wallets (frequent transactions) from cold storage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Asset class"]}," — group wallets by blockchain or asset type"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environment"]}," — separate operational wallets from test wallets in sandbox"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-wallet","__idx":2},"children":["Create a wallet"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the vault where you want the wallet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create wallet"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["wallet name"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MPC quorum"]}," to use for signing (or HSM in sandbox)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["blockchain"]}," the wallet supports."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Palisade places the wallet in a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CREATED"]}," state and moves it to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PROVISIONED"]}," after generating the wallet address. For MPC wallets, quorum members must approve the key generation before the wallet becomes provisioned."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"New wallets are deposit-only"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Palisade operates a zero-trust security model. Every new wallet blocks outgoing transactions by default. You must complete three steps before a wallet can send: create a transaction policy, register destination addresses, and enable outgoing transactions. See the sections below."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-wallet-settings","__idx":3},"children":["Configure wallet settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open a wallet and select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," gear icon to access wallet-level configuration. The settings page has the following tabs:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"general","__idx":4},"children":["General"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["View wallet metadata including wallet ID, wallet address, public key, vault information, correlation ID, and external ID. All values are copyable."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"details","__idx":5},"children":["Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["View key management information for the wallet, including the MPC quorum assignment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transactions","__idx":6},"children":["Transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Control outgoing transaction behavior for the wallet:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"enable-outgoing-transactions","__idx":7},"children":["Enable outgoing transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Three conditions must be met before a wallet can send:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least one ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transaction policy"]}," exists for the asset you want to send."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least one ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["address book entry"]}," exists for the destination (not required for internal wallet-to-wallet transfers)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Outgoing transactions"]}," are explicitly enabled on the wallet."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enable outgoing transactions:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the wallet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable transactions"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can disable outgoing transactions at any time from the wallet's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/getting-started/unlock-outgoing-transactions"},"children":["Unlock outgoing transactions"]}," for the full walkthrough."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"enable-raw-signing","__idx":8},"children":["Enable raw signing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Raw signing allows the wallet to sign arbitrary data payloads, not just standard transfer transactions. Enable this only if your integration requires it."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the wallet and select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," gear icon, then go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Toggle the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Raw signing"]}," switch to enabled."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Use with caution"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Raw signing permits signing any data payload. Enable it only on wallets that need it, and pair it with strict transaction policies and approval groups."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"enable-automatic-transaction-freeze","__idx":9},"children":["Enable automatic transaction freeze"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Automatic freeze places all incoming deposits into a frozen state until you manually review and unfreeze them. Use this for compliance-sensitive wallets that require manual review of every deposit."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the wallet and select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," gear icon, then go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Toggle ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Freeze transactions by default"]}," to enabled."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/admin-guide/configure-transaction-freeze"},"children":["Configure transaction freeze controls"]}," for full details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sweeping","__idx":10},"children":["Sweeping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enable or disable asset sweeping on the wallet. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/admin-guide/configure-asset-sweeping"},"children":["Configure asset sweeping"]}," for setup instructions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tags","__idx":11},"children":["Tags"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add tags to wallets for organizational purposes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":12},"children":["Best practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use descriptive names"]}," — include the purpose, blockchain, and environment in wallet names (for example, \"Treasury - ETH - Production\")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start with deposit-only"]}," — leave outgoing transactions disabled until you have configured policies, addresses, and approval groups."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Separate operational wallets from cold storage"]}," — use different vaults with different quorums and approval requirements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Minimize raw signing"]}," — only enable raw signing on wallets that specifically need it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable automatic freeze on compliance-sensitive wallets"]}," — use default freeze for wallets that handle funds subject to AML or sanctions screening."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-guides","__idx":13},"children":["Related guides"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/getting-started/create-your-first-vault"},"children":["Create your first vault"]}," — Step-by-step vault creation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/getting-started/create-your-first-wallet"},"children":["Create your first wallet"]}," — Step-by-step wallet creation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/user-interface/wallets/manage-wallets"},"children":["Manage wallets"]}," — Reference documentation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/getting-started/unlock-outgoing-transactions"},"children":["Unlock outgoing transactions"]}," — Full guide to enabling sends"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallet/user-interface/blockchains-and-tokens"},"children":["Blockchains and tokens"]}," — Feature availability by chain"]}]}]},"headings":[{"value":"Configure wallets and vaults","id":"configure-wallets-and-vaults","depth":1},{"value":"Create a vault","id":"create-a-vault","depth":2},{"value":"Create a wallet","id":"create-a-wallet","depth":2},{"value":"Configure wallet settings","id":"configure-wallet-settings","depth":2},{"value":"General","id":"general","depth":3},{"value":"Details","id":"details","depth":3},{"value":"Transactions","id":"transactions","depth":3},{"value":"Enable outgoing transactions","id":"enable-outgoing-transactions","depth":4},{"value":"Enable raw signing","id":"enable-raw-signing","depth":4},{"value":"Enable automatic transaction freeze","id":"enable-automatic-transaction-freeze","depth":4},{"value":"Sweeping","id":"sweeping","depth":3},{"value":"Tags","id":"tags","depth":3},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Related guides","id":"related-guides","depth":2}],"frontmatter":{"title":"Configure wallets and vaults","seo":{"title":"Configure wallets and vaults"}},"lastModified":"2026-05-26T12:21:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/wallet/admin-guide/configure-wallets-and-vaults","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}