资产铸造限制守卫

Asset Mint Limit 守卫将铸造限制为指定 Core Asset collection 的持有者，并限制每个资产可以从 Core Candy Machine 铸造的次数。

概述

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

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

守卫设置

Mint Limit 守卫包含以下设置：

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

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

铸造设置

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

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

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

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

Route 指令

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

AssetMintLimit 账户

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

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

const pda = findAssetMintCounterPda(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 = fetchAssetMintCounter(umi, pda)

注意事项

• 铸造限制计数器按资产地址追踪，而不是按钱包。持有多个符合条件的资产的钱包可以用每个资产铸造到限制上限。
• 每个唯一的 id 值会创建一个单独的计数器，允许不同的守卫组在同一 Candy Machine 上强制执行独立的限制。
• AssetMintCounter PDA 从 id、Asset 公钥、Candy Guard 地址和 Candy Machine 地址派生。
• 此守卫不会销毁或转移用作证明的资产——它只验证所有权并递增计数器。