Skip to content

ConfidentialMPTMergeInbox

[Source]

Merge your confidential inbox balance into your 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.

Note

Even if the inbox is already empty (contains encrypted zero), this transaction is valid and succeeds.

Requires the ConfidentialTransfer amendment. Loading...

Example ConfidentialMPTMergeInbox JSON

{
  "TransactionType": "ConfidentialMPTMergeInbox",
  "Account": "rUUeVf9zJWfg7mxNCLhEXm9mfmeHBGb9w3",
  "MPTokenIssuanceID": "003CE807D39D78123FFBDD9401BEC038D88BD328AC353B9C",
  "Fee": "10",
  "Sequence": 3991569
}
Query example transaction

ConfidentialMPTMergeInbox Fields

In addition to the common fields, ConfidentialMPTMergeInbox transactions use the following fields:

FieldJSON TypeInternal TypeRequired?Description
MPTokenIssuanceIDStringUInt192YesThe unique identifier for the MPT issuance.

Error Cases

Besides errors that can occur for all transactions, ConfidentialMPTMergeInbox transactions can result in the following transaction result codes:

Error CodeDescription
tecLOCKEDThe MPT is locked for the account, or the issuance is globally locked.
tecNO_AUTHThe issuance requires authorization and the account's MPToken is not authorized.
tecNO_PERMISSIONThe transaction lacks the required permissions. Common causes include:
- The issuance does not have the Can Hold Confidential Balance flag enabled.
- The account's MPToken is missing the ConfidentialBalanceInbox, ConfidentialBalanceSpending, or HolderEncryptionKey field.
tecOBJECT_NOT_FOUNDThe MPTokenIssuance or the account's MPToken does not exist.
temDISABLEDThe ConfidentialTransfer amendment is not enabled.
temMALFORMEDThe Account is the issuer of the MPTokenIssuanceID.

See Also