可用守卫

代币门控守卫

Last updated March 10, 2026

Token Gate 守卫将铸造限制为持有配置的 SPL 代币最低数量的钱包,不会销毁或转移这些代币。

概述

代币门控 守卫将铸造限制为配置的铸币账户的代币持有者。如果付款人没有所需数量的代币,铸造将失败。

守卫设置

代币门控守卫包含以下设置:

  • 数量:所需的代币数量。
  • 铸币:定义我们用于门控的 SPL 代币的铸币账户地址。

使用代币门控守卫设置 Candy Machine

create(umi, {
// ...
guards: {
tokenGate: some({
amount: 300,
mint: tokenMint.publicKey,
}),
},
});

API 参考:create, TokenGate

铸造设置

代币门控守卫包含以下铸造设置:

  • 铸币:定义我们用于门控的 SPL 代币的铸币账户地址。

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

使用代币门控守卫铸造

您可以使用 mintArgs 参数传递代币门控守卫的铸造设置,如下所示。

mintV1(umi, {
// ...
mintArgs: {
tokenGate: some({ mint: tokenMint.publicKey }),
},
});

API 参考:mintV1, TokenGateMintArgs

路由指令

代币门控守卫不支持路由指令。

注意事项

  • Token Gate 守卫仅 检查 付款人是否持有所需的代币余额——它不会销毁或转移任何代币。如需消耗代币的守卫,请参阅 Token BurnToken Payment
  • 此守卫使用原始 SPL Token 程序,不支持 Token-2022 铸币。
  • 代币余额检查在铸造时进行。如果付款人的余额在守卫评估和交易执行之间低于所需 数量,铸造将失败。