Permanently retire an MPT from the XRP Ledger.
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.
- You are the issuer of the MPT
- The total supply is zero (all tokens have been burned)
- No holders have remaining token balances
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"
}
}| Field | Type | Required | Description |
|---|---|---|---|
tokenIdentifier.issuanceId | string | Yes | The 192-bit MPT issuance ID to destroy. |
tokenIdentifier.type | string | Yes | Must be MPTokenIssuanceId. |
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.
Before destroying an MPT, ensure all tokens are burned:
- Check supply — Query the MPT issuance to verify total supply.
- Clawback remaining tokens — Use clawback to recover tokens from holders.
- Burn tokens — Ensure any tokens returned to issuer are burned.
- Destroy issuance — Submit the destroy transaction.
- Multi-purpose tokens — Overview of MPT operations.
- Burn tokens — Reduce token supply.
- Clawback — Recover tokens from holders.
- MPTokenIssuanceDestroy — XRPL transaction reference.