Metaplex

사용 가능한 가드

NFT Burn Guard

Last updated March 10, 2026

NFT Burn 가드는 사전 정의된 NFT 컬렉션 보유자로 민팅을 제한하고 민트 트랜잭션의 비용으로 보유자의 NFT를 영구적으로 소각합니다.

개요

NFT Burn 가드는 사전 정의된 NFT 컬렉션 보유자로 민팅을 제한하고 보유자의 NFT를 소각합니다. 따라서 민팅 시 결제자가 소각할 NFT의 민트 주소를 제공해야 합니다.

React Flow

가드 설정

NFT Burn 가드에는 다음 설정이 포함됩니다:

  • Required Collection: 필수 NFT 컬렉션의 민트 주소입니다. 민팅에 사용하는 NFT는 이 컬렉션의 일부여야 합니다.

NFT Burn 가드를 사용한 Candy Machine 설정

create(umi, {

  // ...

  guards: {

    nftBurn: some({ requiredCollection: requiredCollectionNft.publicKey }),

  },

});

API References: create, NftBurn

민트 설정

NFT Burn 가드에는 다음 민트 설정이 포함됩니다:

  • Required Collection: 필수 NFT 컬렉션의 민트 주소입니다.
  • Mint: 소각할 NFT의 민트 주소입니다. 이는 필수 컬렉션의 일부여야 하며 민터에게 속해야 합니다.
  • Token Standard: 소각할 NFT의 토큰 표준입니다.
  • Token Account (선택 사항): 선택적으로 NFT와 소유자를 명시적으로 연결하는 토큰 계정을 제공할 수 있습니다. 기본적으로 결제자의 연결된 토큰 계정이 사용됩니다.

참고로, SDK의 도움 없이 명령어를 구성할 계획이라면 이러한 민트 설정과 더 많은 것들을 명령어 인수와 나머지 계정의 조합으로 제공해야 합니다. 자세한 내용은 Candy Guard의 프로그램 문서를 참조하세요.

NFT Burn Guard로 민팅하기

다음과 같이 mintArgs 인수를 사용하여 NFT Burn 가드의 민트 설정을 전달할 수 있습니다.

import { TokenStandard } from "@metaplex-foundation/mpl-token-metadata";



mintV1(umi, {

  // ...

  mintArgs: {

    nftBurn: some({

      requiredCollection: requiredCollectionNft.publicKey,

      mint: nftToBurn.publicKey,

      tokenStandard: TokenStandard.NonFungible,

    }),

  },

});

API References: mintV1, NftBurnMintArgs

Route Instruction

NFT Burn 가드는 route instruction을 지원하지 않습니다.

Notes

  • 소각을 위해 제공되는 NFT는 지정된 필수 컬렉션에 속해야 하며 민터가 소유해야 합니다.
  • 소각은 되돌릴 수 없습니다 -- 민트 트랜잭션 중에 NFT가 소각되면 복구할 수 없습니다.
  • 이 가드는 Token Metadata NFT(Core Asset이 아님)를 사용합니다. tokenStandard 필드는 소각되는 NFT의 실제 표준과 일치해야 합니다(예: NonFungible 또는 ProgrammableNonFungible).
Next
NFT Gate