Skip to content

Destroy an MPT issuance

Permanently retire an MPT from the XRP Ledger.

How destruction works

The MPTokenIssuanceDestroy transaction permanently removes an MPT issuance from the ledger. Once destroyed, the MPT cannot be recreated, and its issuance ID is retired.

You can only destroy an MPT when the total supply is zero. All tokens must be burned before destruction.

Prerequisites

  • You are the issuer of the MPT
  • The total supply is zero (all tokens have been burned)
  • No holders have remaining token balances

Destroy an MPT issuance

To destroy an MPT, submit an MPTokenIssuanceDestroy transaction:

{
  "payload": {
    "id": "{{intent_id}}",
    "accountId": "{{issuer_account_id}}",
    "parameters": {
      "type": "XRPL",
      "feeStrategy": {
        "priority": "Medium",
        "type": "Priority"
      },
      "operation": {
        "type": "MPTokenIssuanceDestroy",
        "tokenIdentifier": {
          "issuanceId": "000004C463C52827307480341125DA0577AFFC21D4B2D083",
          "type": "MPTokenIssuanceId"
        }
      }
    },
    "customProperties": {},
    "type": "v0_CreateTransactionOrder"
  }
}

Parameters

FieldTypeRequiredDescription
tokenIdentifier.issuanceIdstringYesThe 192-bit MPT issuance ID to destroy.
tokenIdentifier.typestringYesMust be MPTokenIssuanceId.

Response

A successful request returns the transaction order with status Pending. After confirmation:

  • The MPT issuance is permanently removed from the ledger.
  • The issuer's owner reserve is freed.
  • The issuance ID can never be reused.

Preparation workflow

Before destroying an MPT, ensure all tokens are burned:

  1. Check supply — Query the MPT issuance to verify total supply.
  2. Clawback remaining tokens — Use clawback to recover tokens from holders.
  3. Burn tokens — Ensure any tokens returned to issuer are burned.
  4. Destroy issuance — Submit the destroy transaction.

No

Yes

Check supply

Supply = 0?

Clawback tokens

Destroy issuance

No

Yes

Check supply

Supply = 0?

Clawback tokens

Destroy issuance