Core Commands

Burn Asset

The mplx core asset burn command allows you to permanently destroy MPL Core Assets and reclaim rent fees. You can burn a single asset or multiple assets at once using a JSON list file.

Basic Usage

Burn Single Asset

mplx core asset burn <assetId>

Burn Asset from Collection

mplx core asset burn <assetId> --collection <collectionId>

Burn Multiple Assets

mplx core asset burn --list ./assets-to-burn.json

Arguments

ArgumentDescription
ASSETThe mint address of the asset to burn

Options

OptionDescription
--collection <value>Collection ID to burn the asset from
--list <value>File path to a JSON list of assets to burn (e.g., ["asset1", "asset2"])

Global Flags

FlagDescription
-c, --config <value>Path to config file. Default is ~/.config/mplx/config.json
-k, --keypair <value>Path to keypair file or ledger (e.g., usb://ledger?key=0)
-p, --payer <value>Path to payer keypair file or ledger
-r, --rpc <value>RPC URL for the cluster
--commitment <option>Commitment level: processed, confirmed, or finalized
--jsonFormat output as JSON
--log-level <option>Logging level: debug, warn, error, info, or trace (default: info)

Examples

Burn a Single Asset

mplx core asset burn 5avjMVza8SuMhgTfzEGNWJskDELMCQk9juAAc8zeQoNa

Burn an Asset from a Collection

mplx core asset burn 5avjMVza8SuMhgTfzEGNWJskDELMCQk9juAAc8zeQoNa --collection HaKyubAWuTS9AZkpUHtFkTKAHs1KKAJ3onZPmaP9zBpe

Burn Multiple Assets from a List

Create a JSON file assets-to-burn.json:

[
"5avjMVza8SuMhgTfzEGNWJskDELMCQk9juAAc8zeQoNa",
"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
]

Then run:

mplx core asset burn --list ./assets-to-burn.json

Notes

  • Warning: Burning is permanent and cannot be reversed
  • You must be the owner of the asset to burn it
  • When you burn an asset, most of the rent SOL is returned to the owner
  • A small amount (~0.00089784 SOL) remains to prevent account reuse
  • Use the --collection flag when burning assets that belong to a collection