利用可能なガード
Gatekeeper Guard
概要
Gatekeeperガードは、ミントウォレットが指定されたGatekeeper Networkから有効なGateway Tokenを持っているかどうかをチェックします。
ほとんどの場合、このトークンはCaptchaチャレンジを完了した後に取得されますが、任意のGatekeeper Networkを使用できます。
Candy Machine側では設定することはあまりありませんが、選択されたGatekeeper Networkによっては、必要なGateway Tokenを付与するために事前検証チェックを実行するようミントウォレットに求める必要がある場合があります。
Gatekeep Networkを設定する際に役立つ追加の推奨資料をいくつか示します。
ガード設定
Gatekeeperガードには以下の設定が含まれます:
- Gatekeeper Network: ミントウォレットの有効性をチェックするために使用されるGatekeeper Networkの公開鍵。例えば、「Civic Captcha Pass」Network(ミントウォレットがcaptchaを通過したことを保証する)を使用する場合は、以下のアドレスを使用します:
ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6。 - Expire On Use: NFTがミントされた後にミントウォレットのGateway Tokenを期限切れとしてマークするかどうか。
trueに設定されている場合、別のNFTをミントするためには再びGatekeeper Networkを通過する必要があります。falseに設定されている場合、Gateway Tokenが自然に期限切れになるまで別のNFTをミントできます。
Gatekeeperガードを使用してCandy Machineを設定する
create(umi, {
// ...
guards: {
gatekeeper: some({
network: publicKey("ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6"),
expireOnUse: true,
}),
},
});
APIリファレンス: create, Gatekeeper
ミント設定
Gatekeeperガードには以下のミント設定が含まれます:
- Gatekeeper Network: ミントウォレットの有効性をチェックするために使用されるGatekeeper Networkの公開鍵。
- Expire On Use: NFTがミントされた後にミントウォレットのGateway Tokenを期限切れとしてマークするかどうか。
- Token Account (オプション): 小さな注意点として、この設定を提供する必要があることは非常に稀ですが、必要な場合はここにあります。これは支払者とGatekeeper Networkから派生したGateway Token PDAを指し、支払者のミント資格を検証するために使用されます。このPDAアドレスはSDKによって推定できるため、提供する必要はありません。ただし、一部のGatekeeper Networkは同じウォレットに複数のGateway Tokenを発行する場合があります。PDAアドレスを区別するために、デフォルトで
[0, 0, 0, 0, 0, 0, 0, 0]となるSeeds配列を使用します。
注意:SDK の助けなしで命令を構築する予定の場合、これらのミント設定およびそれ以外を命令引数と残りのアカウントの組み合わせとして提供する必要があります。詳細については、Candy GuardのプログラムドキュメントAtionを参照してください。
Gatekeeperガードでミントする
次のようにmintArgs引数を使用してGatekeeperガードのミント設定を渡すことができます。
mintV2(umi, {
// ...
mintArgs: {
gatekeeper: some({
network: publicKey("ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6"),
expireOnUse: true,
}),
},
});
ルート命令
Gatekeeperガードはルート命令をサポートしません。
