캔디 가드

요약

캔디 가드는 Core Candy Machine에 부착되어 Solana에서의 민팅 프로세스를 제한하고 커스터마이즈하는 모듈형, 조합 가능한 액세스 제어 컴포넌트입니다.

• 각 가드는 결제, 스케줄링, 지갑 게이팅 등 단일 책임을 처리합니다.
• 가드는 Candy Machine의 민트 권한이 되는 별도의 온체인 Core Candy Guard 계정에 정의됩니다.
• 기본 Candy Guard 프로그램에는 SOL/토큰 결제, 허용 목록, 시간 윈도우, 봇 보호 등을 포함하는 25개 이상의 내장 가드가 포함되어 있습니다.
• 커스텀 가드는 자신만의 Candy Guard 프로그램을 포크하고 배포하여 만들 수 있습니다.

캔디 가드란 무엇인가?

캔디 가드는 Core Candy Machine의 민팅 프로세스 중에 단일 액세스 제어 규칙을 적용하는 모듈형 온체인 컴포넌트입니다. 각 가드는 독립적으로 활성화되며 다른 가드와 결합하여 필요한 민팅 경험을 정확하게 구성할 수 있습니다.

선택할 수 있는 가드 세트가 광범위하며, 각 가드는 필요에 따라 활성화하고 구성할 수 있습니다.

이 문서의 뒷부분에서 사용 가능한 모든 가드에 대해 다루겠지만, 먼저 몇 가지 예시를 통해 이를 설명해보겠습니다.

• 시작 날짜 가드가 활성화되면 사전 구성된 날짜 이전에는 민팅이 금지됩니다. 특정 날짜 이후의 민팅을 금지하는 종료 날짜 가드도 있습니다.
• SOL 결제 가드가 활성화되면 민팅 지갑은 구성된 대상 지갑에 구성된 금액을 지불해야 합니다. 특정 컬렉션의 토큰이나 NFT로 지불하는 유사한 가드도 존재합니다.
• 토큰 게이트와 NFT 게이트 가드는 각각 특정 토큰 보유자와 NFT 보유자에게만 민팅을 제한합니다.
• 허용 목록 가드는 지갑이 미리 정의된 지갑 목록에 포함된 경우에만 민팅을 허용합니다. 민팅을 위한 게스트 목록과 같다고 할 수 있습니다.

보시다시피 각 가드는 하나의 책임만 맡고 있어 구성 가능합니다. 즉, 필요한 가드를 선택하여 완벽한 캔디 머신을 만들 수 있습니다.

코어 캔디 가드 계정

코어 캔디 가드 계정은 주어진 Core Candy Machine에 대해 활성화된 모든 가드와 그 구성을 저장하는 온체인 계정입니다. 각 코어 캔디 머신 계정은 일반적으로 자체 코어 캔디 가드 계정과 연결되어 보호 계층을 추가합니다.

이는 코어 캔디 가드 계정을 생성하고 이를 코어 캔디 머신 계정의 민트 권한으로 설정함으로써 작동합니다. 이렇게 하면 더 이상 메인 코어 캔디 머신 프로그램에서 직접 민팅할 수 없습니다. 대신 코어 캔디 가드 프로그램을 통해 민팅해야 하며, 모든 가드가 성공적으로 해결되면 코어 캔디 머신 코어 프로그램에 민팅 프로세스를 완료하도록 위임합니다.

코어 캔디 머신과 코어 캔디 가드 계정이 함께 작동하므로, 우리의 SDK는 이들을 하나의 엔티티로 처리합니다. SDK로 코어 캔디 머신을 생성하면 연결된 코어 캔디 가드 계정도 기본적으로 함께 생성됩니다. 코어 캔디 머신을 업데이트할 때도 마찬가지로, 동시에 가드를 업데이트할 수 있습니다. 이 페이지에서 구체적인 예시를 보겠습니다.

가드가 별도의 프로그램을 사용하는 이유

가드는 전용 Candy Guard 프로그램에 존재하며 Core Candy Machine Core 프로그램과는 분리되어 있어 액세스 제어 로직이 민트 로직과 완전히 분리됩니다. 가드가 메인 코어 캔디 머신 프로그램에 존재하지 않는 이유는 액세스 제어 로직을 NFT 민팅이라는 코어 캔디 머신의 주요 책임과 분리하기 위함입니다.

이를 통해 가드는 모듈형일 뿐만 아니라 확장 가능합니다. 누구나 자신만의 코어 캔디 가드 프로그램을 생성하고 배포하여 커스텀 가드를 만들 수 있으며, 나머지 모든 것은 코어 캔디 머신 코어 프로그램에 의존할 수 있습니다.

우리의 SDK는 또한 자신만의 코어 캔디 가드 프로그램과 커스텀 가드를 등록할 수 있는 방법을 제공하므로, 친숙한 API를 활용하고 다른 사람들과 가드를 쉽게 공유할 수 있습니다.

사용 가능한 가드

기본 Core Candy Guard 프로그램에는 결제, 스케줄링, 게이팅, 봇 보호를 포함하는 25개 이상의 내장 가드가 포함되어 있습니다. 다음 목록에서 각 가드에 대한 간단한 설명을 제공하며, 보다 자세한 내용을 위한 전용 페이지 링크를 포함합니다.

• Address Gate: 민팅을 단일 주소로 제한합니다.
• Allocation: 각 가드 그룹이 민팅할 수 있는 NFT 수에 제한을 지정할 수 있습니다.
• Allow List: 지갑 주소 목록을 사용하여 누가 민팅할 수 있는지 결정합니다.
• Asset Burn Multi: 지정된 컬렉션의 보유자로 민팅을 제한하며, 하나 이상의 코어 자산을 소각해야 합니다.
• Asset Burn: 지정된 컬렉션의 보유자로 민팅을 제한하며, 단일 코어 자산을 소각해야 합니다.
• Asset Gate: 지정된 컬렉션의 보유자로 민팅을 제한합니다.
• Asset Mint Limit: 지정된 컬렉션의 보유자로 민팅을 제한하고, 제공된 코어 자산에 대해 실행할 수 있는 민팅 수를 제한합니다.
• Asset Payment Multi: 민팅 가격을 지정된 컬렉션의 여러 코어 자산으로 설정합니다.
• Asset Payment: 민팅 가격을 지정된 컬렉션의 코어 자산으로 설정합니다.
• Bot Tax: 유효하지 않은 트랜잭션에 부과할 구성 가능한 세금입니다.
• Edition: 민팅된 코어 자산에 에디션 플러그인을 추가합니다. 자세한 내용은 프린트 에디션 가이드를 참조하세요.
• End Date: 민팅 종료 날짜를 결정합니다.
• Freeze Sol Payment: 동결 기간과 함께 SOL로 민팅 가격을 설정합니다.
• Freeze Token Payment: 동결 기간과 함께 토큰 금액으로 민팅 가격을 설정합니다.
• Gatekeeper: 게이트키퍼 네트워크(예: 캡차 통합)를 통해 민팅을 제한합니다.
• Mint Limit: 지갑당 민팅 수에 제한을 지정합니다.
• Nft Burn: 지정된 컬렉션의 보유자로 민팅을 제한하며, NFT를 소각해야 합니다.
• Nft Gate: 지정된 컬렉션의 보유자로 민팅을 제한합니다.
• Nft Payment: 민팅 가격을 지정된 컬렉션의 NFT로 설정합니다.
• Program Gate: 민팅 트랜잭션에 포함될 수 있는 프로그램을 제한합니다.
• Redeemed Amount: 총 민팅된 수량에 따라 민팅 종료를 결정합니다.
• Sol Fixed fee: 고정 가격으로 SOL로 민팅 가격을 설정합니다. Sol Payment 가드와 유사합니다.
• Sol Payment: SOL로 민팅 가격을 설정합니다.
• Start Date: 민팅 시작 날짜를 결정합니다.
• Third Party Signer: 트랜잭션에 추가 서명자가 필요합니다.
• Token Burn: 지정된 토큰의 보유자로 민팅을 제한하며, 토큰을 소각해야 합니다.
• Token Gate: 지정된 토큰의 보유자로 민팅을 제한합니다.
• Token Payment: 토큰 금액으로 민팅 가격을 설정합니다.
• Token22 Payment: 토큰22(토큰 확장) 금액으로 민팅 가격을 설정합니다.
• Vanity Mint: 새로운 민트 주소가 특정 패턴과 일치할 것을 기대하여 민팅을 제한합니다.

참고사항

• 가드는 완전히 조합 가능합니다. 내장 가드의 어떤 조합이든 단일 Core Candy Machine에 활성화하여 필요한 민팅 경험을 정확하게 만들 수 있습니다.
• 커스텀 가드를 만들려면 자신만의 Candy Guard 프로그램을 포크하고 배포해야 합니다. Core Candy Machine Core 프로그램 자체는 변경할 필요가 없습니다.
• Core Candy Machine의 가드를 업데이트하면 전체 가드 구성이 덮어쓰여집니다. 수정하는 가드뿐만 아니라 활성화하려는 모든 가드를 항상 다시 지정하세요.
• Allow List와 같은 일부 가드는 전제 조건을 검증하기 위해 민팅 전에 라우트 지시사항을 호출해야 합니다.
• 가드 그룹을 사용하여 가드를 여러 개의 명명된 세트로 구성할 수 있으며, 이를 통해 서로 다른 민팅 단계나 지갑 등급에 서로 다른 규칙을 적용할 수 있습니다.

FAQ

커스텀 캔디 가드를 만들 수 있나요?

네. 가드는 별도의 Candy Guard 프로그램에 존재하므로 누구나 자신만의 Candy Guard 프로그램을 포크하고 배포하여 커스텀 가드 로직을 만들 수 있으며, 민팅은 Core Candy Machine Core 프로그램에 의존합니다. Metaplex SDK를 사용하면 커스텀 Candy Guard 프로그램을 등록하여 표준 API를 사용할 수도 있습니다.

하나의 Core Candy Machine에서 얼마나 많은 가드를 동시에 사용할 수 있나요?

사용 가능한 가드의 어떤 조합이든 동시에 활성화할 수 있습니다. 가드는 조합 가능하므로 필요한 것만 활성화하면 됩니다. 더 복잡한 시나리오에서는 가드 그룹을 사용하여 단일 머신에 여러 가드 세트를 정의할 수도 있습니다.

모든 가드에 민트 설정이나 라우트 지시사항이 필요한가요?

아니요. 특정 가드만 추가 온체인 계정(민트 설정)이나 전용 라우트 지시사항이 필요합니다. 대부분의 가드는 자체적으로 완결됩니다. 민트 설정이나 라우트 지시사항이 적용되는지 확인하려면 개별 가드 페이지를 확인하세요.

민터가 가드 검사에 실패하면 어떻게 되나요?

트랜잭션이 거부됩니다. Bot Tax 가드가 활성화되어 있으면 실패한 지갑에 구성 가능한 SOL 패널티가 부과되며, 이는 봇의 잘못된 민트 시도 스팸을 방지합니다.

Core Candy Machine의 가드를 업데이트하면 기존 가드 설정이 모두 교체되나요?

네. 가드 업데이트는 전체 가드 구성을 덮어씁니다. 변경하는 가드뿐만 아니라 활성화하려는 모든 가드를 다시 지정해야 합니다.

Candy Guard와 가드 그룹의 차이점은 무엇인가요?

Candy Guard는 하나의 기본 가드 세트를 보유하는 온체인 계정입니다. 가드 그룹을 사용하면 동일한 Candy Guard 계정 내에서 여러 개의 명명된 가드 세트를 정의하여 서로 다른 지갑이나 단계가 서로 다른 규칙을 따를 수 있습니다.

용어집