NFT 铸造限制守卫

NFT Mint Limit 守卫将铸造限制为指定 NFT collection 的持有者，并使用链上计数器 PDA 限制每个 NFT 可以铸造的资产数量。

概述

NFT Mint Limit 守卫将铸造限制为指定 NFT collection 的持有者，并限制为提供的 Token Metadata NFT 可以执行的铸造数量。它可以被视为 NFT Gate 和 Mint Limit 守卫的组合，基于 NFT 地址而不是钱包。

限制是按 NFT Collection、每个 candy machine 和每个标识符设置的——在设置中提供——以允许在同一个 Core Candy Machine 中进行多个 NFT 铸造限制。

守卫设置

Mint Limit 守卫包含以下设置：

• ID：此守卫的唯一标识符。不同的标识符将使用不同的计数器来跟踪通过提供给定 NFT 铸造了多少物品。这在使用守卫组时特别有用，因为我们可能希望每个组都有不同的铸造限制。
• Limit：该标识符每个 NFT 允许的最大铸造数量。
• Required Collection：必需 NFT Collection 的铸造地址。我们铸造时提供作为证明的 NFT 必须属于此 collection。

create(umi, {
  // ...
  guards: {
    nftMintLimit: some({
      id: 1,
      limit: 5,
      requiredCollection: requiredCollectionNft.publicKey,
    }),
  },
});

铸造设置

NFT Mint Limit 守卫包含以下铸造设置：

• ID：此守卫的唯一标识符。
• Mint：用于证明付款人拥有来自必需 collection 的 NFT 的 NFT 铸造地址。

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

mintV1(umi, {
  // ...
  mintArgs: {
    nftMintLimit: some({ id: 1, mint: nftToVerify.publicKey }),
  },
});

Route 指令

NFT Mint Limit 守卫不支持 route 指令。

NftMintLimit 账户

当使用 NftMintLimit 守卫时，会为每个 NFT、CandyMachine 和 id 组合创建一个 NftMintCounter 账户。出于验证目的，可以这样获取它：

import {
  findNftMintCounterPda,
  fetchNftMintCounter
 } from "@metaplex-foundation/mpl-core-candy-machine";

const pda = findNftMintCounterPda(umi, {
  id: 1, // 您在守卫配置中设置的 nftMintLimit id
  mint: asset.publicKey, // 您用户拥有的 nft 地址
  candyMachine: candyMachine.publicKey,
  // 或者使用您的 CM 地址 candyMachine: publicKey("Address")
  candyGuard: candyMachine.mintAuthority
  // 或者使用您的 candyGuard 地址 candyGuard: publicKey("Address")
});

const nftMintCounter = fetchNftMintCounter(umi, pda)

注意事项

• 铸造计数器按 NFT 地址、按 Candy Machine 和按守卫 ID 跟踪——而非按钱包。来自同一 collection 的不同 NFT 各自拥有独立的计数器。
• 使用不同的守卫 ID 可以在同一 Candy Machine 中设置多个独立的铸造限制（例如，每个守卫组不同的限制）。
• NftMintCounter PDA 从 [candyGuard, candyMachine, id, mint] 派生，可以获取以检查 NFT 已使用了多少次铸造。
• 此守卫使用 Token Metadata NFT（非 Core Assets）进行 collection 验证。