可用守卫

NFT 门控守卫

Last updated March 10, 2026

NFT Gate 守卫通过验证所有权来将铸造限制为指定 NFT collection 的持有者,且不会销毁或转移 NFT。

概述

NFT Gate 守卫将铸造限制为指定 NFT collection 的持有者。

守卫设置

NFT Gate 守卫包含以下设置:

  • Required Collection:必需 NFT Collection 的铸造地址。我们铸造时提供作为证明的 NFT 必须属于此 collection。

使用 NFT Gate 守卫设置 Candy Machine

create(umi, {
// ...
guards: {
nftGate: some({
requiredCollection: requiredCollectionNft.publicKey,
}),
},
});

API 参考:createNftGate

铸造设置

NFT Gate 守卫包含以下铸造设置:

  • Mint:用于证明付款人拥有来自必需 collection 的 NFT 的 NFT 铸造地址。
  • Token Account(可选):您可以选择显式提供将 NFT 与其所有者链接的代币账户。默认情况下,将使用付款人的关联代币账户。

注意,如果您计划在没有我们 SDK 帮助的情况下构建指令,您需要将这些铸造设置和更多内容作为指令参数和剩余账户的组合提供。详情请参阅 Candy Guard 的程序文档

使用 NFT Gate 守卫设置 Candy Machine

使用 Umi 库铸造时,只需通过 mint 属性提供用作所有权证明的 NFT 铸造地址,如下所示。

mintV1(umi, {
// ...
mintArgs: {
nftGate: some({ mint: nftToBurn.publicKey }),
},
});

API 参考:mintV1NftGateMintArgs

Route 指令

NFT Gate 守卫不支持 route 指令。

注意事项

  • 用作所有权证明的 NFT 不会被销毁或转移——付款人在铸造后仍保留该 NFT。
  • NFT Burn 守卫不同,此守卫仅检查所有权,不会消耗 NFT。
  • 除非与 NFT Mint Limit 守卫结合使用,否则来自必需 collection 的单个 NFT 可用于多次铸造。
  • 此守卫使用 Token Metadata NFT(非 Core Assets)进行 collection 验证。
Previous
NFT Burn