Gatekeeper Guard

개요

Gatekeeper 가드는 민팅 지갑이 지정된 Gatekeeper Network에서 유효한 Gateway Token을 가지고 있는지 확인합니다.

대부분의 경우, 이 토큰은 Captcha 챌린지를 완료한 후 획득되지만 어떤 Gatekeeper Network든 사용할 수 있습니다.

Core Candy Machine 측면에서는 설정할 것이 많지 않지만, 선택한 Gatekeeper Network에 따라 민팅 지갑에 필요한 Gateway Token을 부여하기 위해 사전 검증 확인을 수행하도록 요청해야 할 수 있습니다.

다음은 Gatekeep Network 설정 시 도움이 될 수 있는 추가 권장 자료입니다.

• The CIVIC Documentation
• Gateway JS Library
• Gateway React Components

가드 설정

Gatekeeper 가드에는 다음 설정이 포함됩니다:

• Gatekeeper Network: 민팅 지갑의 유효성을 확인하는 데 사용될 Gatekeeper Network의 공개 키입니다. 예를 들어, 민팅 지갑이 captcha를 통과했는지 확인하는 "Civic Captcha Pass" Network를 사용할 수 있으며, 다음 주소를 사용합니다: ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6.
• Expire On Use: NFT가 민팅된 후 민팅 지갑의 Gateway Token을 만료된 것으로 표시할지 여부입니다.
  • true로 설정하면, 다른 NFT를 민팅하기 위해 Gatekeeper Network를 다시 거쳐야 합니다.
  • false로 설정하면, Gateway Token이 자연스럽게 만료될 때까지 다른 NFT를 민팅할 수 있습니다.

create(umi, {
  // ...
  guards: {
    gatekeeper: some({
      network: publicKey("ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6"),
      expireOnUse: true,
    }),
  },
});

민팅 설정

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의 프로그램 문서를 참조하세요.

mintV1(umi, {
  // ...
  mintArgs: {
    gatekeeper: some({
      network: publicKey("ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6"),
      expireOnUse: true,
    }),
  },
});

Route Instruction

Gatekeeper 가드는 route instruction을 지원하지 않습니다.