{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["source-link","admonition","amendment-disclaimer","tx-example","code-page-name"]},"redocly_category":"Documentation","type":"markdown"},"seo":{"title":"ConfidentialMPTMergeInbox","siteUrl":"https://xrpl.org/","llmstxt":{"hide":false,"title":"XRPL Developer Portal & Documentation","description":"Explore XRP Ledger documentation, blogs, and other blockchain developer resources needed to start building and integrating with the ledger.","details":{"content":"XRP Ledger concepts, use cases, tutorials, references, and other blockchain developer resources. Also, stay up to date with release announcements and more through the XRPL Blog."},"sections":[{"title":"Introduction","description":"A high-level introduction to the XRP Ledger.","includeFiles":["docs/introduction/**/*.*","about/faq.md"],"excludeFiles":["docs/introduction/index.md"]},{"title":"Use Cases","description":"Real-world applications and business scenarios for the XRP Ledger.","includeFiles":["docs/use-cases/**/*.*"],"excludeFiles":["docs/use-cases/index.md","docs/use-cases/defi/index.md"]},{"title":"Agentic Transactions","description":"XRPL AI Starter Kit to help autonomous agents discover, set up, and execute agentic transactions on the XRP Ledger.","includeFiles":["docs/agents/**/*.*"],"excludeFiles":[]},{"title":"Concepts","description":"Core concepts including accounts, tokens, transactions, consensus, and more.","includeFiles":["docs/concepts/**/*.*"],"excludeFiles":["docs/concepts/index.md","docs/concepts/decentralized-storage/index.md","docs/concepts/payment-types/index.md"]},{"title":"Tutorials","description":"Step-by-step guides for building on the XRP Ledger in JavaScript, Python, Go, and more.","includeFiles":["docs/tutorials/**/*.*"],"excludeFiles":[]},{"title":"References","description":"Protocol specification, transaction types, ledger entries, and API methods.","includeFiles":["docs/references/**/*.*"],"excludeFiles":["docs/references/xrp-api.md","docs/references/data-api.md","docs/references/protocol/index.md","docs/references/protocol/ledger-data/ledger-entry-types/index.md","docs/references/protocol/transactions/index.md","docs/references/protocol/transactions/types/index.md","docs/references/http-websocket-apis/api-conventions/index.md","docs/references/http-websocket-apis/public-api-methods/*/index.md","docs/references/http-websocket-apis/admin-api-methods/*/index.md"]},{"title":"Infrastructure","description":"Install, configure, and troubleshoot xrpld and Clio servers.","includeFiles":["docs/infrastructure/**/*.*"],"excludeFiles":["docs/infrastructure/index.md","docs/infrastructure/*/index.md","docs/infrastructure/installation/build-run-xrpld-in-reporting-mode.md","docs/infrastructure/configuration/data-retention/index.md","docs/infrastructure/configuration/server-modes/index.md"]},{"title":"Blog (2023+)","description":"Recent XRPL Blog posts (showing 2023 and newer).","includeFiles":["blog/2023/**/*.*","blog/2024/**/*.*","blog/2025/**/*.*","blog/2026/**/*.*"],"excludeFiles":[]},{"title":"Resources","description":"Developer resources and contribution guidelines.","includeFiles":["resources/**/*.*"],"excludeFiles":["resources/index.md"]}],"excludeFiles":[]},"description":"Merge your inbox balance into the spending balance for confidential transfers."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"confidentialmptmergeinbox","__idx":0},"children":["ConfidentialMPTMergeInbox"]},{"$$mdtype":"Tag","name":"SourceLink","attributes":{"path":"src/libxrpl/tx/transactors/token/ConfidentialMPTMergeInbox.cpp","xrpld_release":"release/3.3.x"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merge your confidential ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["inbox"]}," balance into your ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["spending"]}," balance. This moves all funds from the inbox balance into the spending balance and resets the inbox to encrypted zero, ensuring that proofs reference only stable spending balances."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Even if the inbox is already empty (contains encrypted zero), this transaction is valid and succeeds."]}]},{"$$mdtype":"Tag","name":"AmendmentDisclaimer","attributes":{"name":"ConfidentialTransfer","compact":false,"statusOnly":false,"mode":""},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-confidentialmptmergeinbox-json","__idx":1},"children":["Example ","ConfidentialMPTMergeInbox"," JSON"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"TransactionType\": \"ConfidentialMPTMergeInbox\",\n  \"Account\": \"rUUeVf9zJWfg7mxNCLhEXm9mfmeHBGb9w3\",\n  \"MPTokenIssuanceID\": \"003CE807D39D78123FFBDD9401BEC038D88BD328AC353B9C\",\n  \"Fee\": \"10\",\n  \"Sequence\": 3991569\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"TxExample","attributes":{"txid":"BDD9869C13D8BB3B3A0216100B92AE97634BA1B5505A2C6B4327EBF6EA9DCF6F","server":"devnet"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"confidentialmptmergeinbox-fields","__idx":2},"children":["ConfidentialMPTMergeInbox"," Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/transactions/common-fields"},"children":["common fields"]},", ",{"$$mdtype":"Tag","name":"CodePageName","attributes":{"name":"ConfidentialMPTMergeInbox"},"children":[]}," transactions use the following fields:"]},{"$$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":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"JSON Type"},"children":["JSON Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Internal Type"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/binary-format"},"children":["Internal Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required?"},"children":["Required?"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTokenIssuanceID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["UInt192"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The unique identifier for the MPT issuance."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-cases","__idx":3},"children":["Error Cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Besides errors that can occur for all transactions, ",{"$$mdtype":"Tag","name":"CodePageName","attributes":{"name":"ConfidentialMPTMergeInbox"},"children":[]}," transactions can result in the following ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/transactions/transaction-results"},"children":["transaction result codes"]},":"]},{"$$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":{"align":"left","data-label":"Error Code"},"children":["Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tecLOCKED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The MPT is locked for the account, or the issuance is globally locked."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tecNO_AUTH"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The issuance requires authorization and the account's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPToken"]}," is not authorized."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tecNO_PERMISSION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The transaction lacks the required permissions. Common causes include:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"- The issuance does not have the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can Hold Confidential Balance"]}," flag enabled.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"- The account's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPToken"]}," is missing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ConfidentialBalanceInbox"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ConfidentialBalanceSpending"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HolderEncryptionKey"]}," field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tecOBJECT_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTokenIssuance"]}," or the account's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPToken"]}," does not exist."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["temDISABLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ConfidentialTransfer"]}," amendment is not enabled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["temMALFORMED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}," is the issuer of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTokenIssuanceID"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"see-also","__idx":4},"children":["See Also"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/ledger-data/ledger-entry-types/mptoken"},"children":["MPToken entry"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/ledger-data/ledger-entry-types/mptokenissuance"},"children":["MPTokenIssuance entry"]}]}]}]},"headings":[{"value":"ConfidentialMPTMergeInbox","id":"confidentialmptmergeinbox","depth":1},{"value":"Example ConfidentialMPTMergeInbox JSON","id":"example-confidentialmptmergeinbox-json","depth":2},{"value":"ConfidentialMPTMergeInbox Fields","id":"confidentialmptmergeinbox-fields","depth":2},{"value":"Error Cases","id":"error-cases","depth":2},{"value":"See Also","id":"see-also","depth":2}],"frontmatter":{"seo":{"description":"Merge your inbox balance into the spending balance for confidential transfers.","title":"ConfidentialMPTMergeInbox"},"labels":["Multi-Purpose Tokens, MPTs","Tokens","Confidential Transfers"],"requiredAmendment":"ConfidentialTransfer"},"editPage":{"to":"https://github.com/XRPLF/xrpl-dev-portal/tree/master/docs/references/protocol/transactions/types/confidentialmptmergeinbox.md"},"lastModified":"2026-07-31T15:04:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/references/protocol/transactions/types/confidentialmptmergeinbox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}