Getting Started
Burn an NFT
Permanently destroy an NFT and reclaim rent fees.
Burn an NFT
In the following section you can find a full code example and the parameters that you might need to change. You can learn more about burning NFTs in the Core documentation.
1import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
2import { burn } from '@metaplex-foundation/mpl-core'
3import { mplCore } from '@metaplex-foundation/mpl-core'
4import { publicKey } from '@metaplex-foundation/umi'
5
6const umi = createUmi('https://api.devnet.solana.com').use(mplCore())
7const assetAddress = publicKey('AssetAddressHere...')
8
9// Permanently destroy/burn an NFT asset
10const result = await burn(umi, {
11 asset: assetAddress,
12}).sendAndConfirm(umi)
13
14console.log('Asset burned successfully')
1
Parameters
Customize these parameters for your burn:
| Parameter | Description |
|---|---|
assetAddress | The public key of the NFT to burn |
How It Works
The burn process involves three steps:
- Fetch the NFT - Get the NFT data using
fetchAsset - Execute burn - Destroy the NFT permanently
- Reclaim rent - Most SOL is returned to you (except ~0.00089784 SOL)
Warning: Burning is permanent and cannot be reversed. Make sure you want to destroy the NFT before proceeding.
Rent Reclamation
When you burn an NFT:
- Most of the rent SOL is returned to the NFT owner
- A small amount (~0.00089784 SOL) remains to prevent the account from being reopened
- You must be the NFT owner to burn it
