Summary

Burning a compressed NFT permanently removes it from the Bubblegum Tree using the burnV2 instruction. This page covers burning by owner, leaf delegate, and permanent burn delegate.

• Burn a cNFT using the burnV2 instruction
• Authorize burns via the leaf owner, leaf delegate, or permanent burn delegate
• Pass the coreCollection parameter when the cNFT belongs to a collection

burnV2 명령어는 압축된 NFT를 소각하여 Bubblegum 트리에서 영구적으로 제거하는 데 사용할 수 있습니다. 이 작업을 승인하려면 현재 소유자나 위임 권한(있는 경우) 중 하나가 트랜잭션에 서명해야 합니다. 명령어는 다음 매개변수를 받아들입니다:

• 리프 소유자, 리프 위임자, 또는 영구 소각 위임자: 압축된 NFT의 현재 소유자, 위임 권한(있는 경우), 또는 컬렉션의 영구 소각 위임자. 자산이 컬렉션의 일부인 경우 coreCollection 매개변수를 전달해야 합니다. 이 중 하나가 트랜잭션에 서명해야 합니다.

이 명령어는 Bubblegum 트리의 리프를 교체하므로 소각하기 전에 압축된 NFT의 무결성을 확인하기 위해 추가 매개변수를 제공해야 합니다. 이러한 매개변수는 리프를 변경하는 모든 명령어에 공통이므로 다음 FAQ에 문서화되어 있습니다. 다행히 Metaplex DAS API를 사용하여 이러한 매개변수를 자동으로 가져오는 도우미 메서드를 사용할 수 있습니다.

import { getAssetWithProof, burnV2 } from '@metaplex-foundation/mpl-bubblegum';

const assetWithProof = await getAssetWithProof(umi, assetId, {truncateCanopy: true});
await burnV2(umi, {
  ...assetWithProof,
  leafOwner: currentLeafOwner,
}).sendAndConfirm(umi)

Notes

• Burning is irreversible — the cNFT is permanently removed from the merkle tree.
• If the cNFT belongs to a collection, you must pass the coreCollection parameter.
• The permanent burn delegate can burn any cNFT in the collection without the owner's signature, if the PermanentBurnDelegate plugin is enabled on the collection.

FAQ

Glossary