사용 가능한 가드
Token Gate Guard
Last updated March 10, 2026
Token Gate 가드는 구성된 SPL 토큰의 최소 수량을 보유한 지갑으로 민팅을 제한하며, 해당 토큰을 소각하거나 전송하지 않습니다.
개요
Token Gate guard는 구성된 민트 계정의 토큰 보유자로 민팅을 제한합니다. 지불자가 필요한 양의 토큰을 보유하지 않은 경우 민팅에 실패합니다.
Guard 설정
Token Gate guard는 다음 설정을 포함합니다:
- Amount: 필요한 토큰 수량.
- Mint: 게이팅하려는 SPL Token을 정의하는 민트 계정의 주소.
Token Gate guard를 사용하여 Candy Machine 설정하기
민팅 설정
Token Gate guard는 다음 민팅 설정을 포함합니다:
- Mint: 게이팅하려는 SPL Token을 정의하는 민트 계정의 주소.
SDK의 도움 없이 직접 명령어를 구성할 계획이라면, 이러한 민팅 설정과 추가 설정을 명령어 인수 및 나머지 계정의 조합으로 제공해야 합니다. 자세한 내용은 Core Candy Guard의 프로그램 문서를 참조하세요.
Token Gate Guard로 민팅하기
다음과 같이 mintArgs 인수를 사용하여 Token Gate guard의 민팅 설정을 전달할 수 있습니다.
mintV1(umi, {
// ...
mintArgs: {
tokenGate: some({ mint: tokenMint.publicKey }),
},
});
API References: mintV1, TokenGateMintArgs
Route Instruction
Token Gate guard는 route instruction을 지원하지 않습니다.
Notes
- Token Gate 가드는 결제자가 필요한 토큰 잔액을 보유하고 있는지만 확인합니다 -- 토큰을 소각하거나 전송하지 않습니다. 토큰을 소비하는 가드는 Token Burn 또는 Token Payment를 참조하세요.
- 이 가드는 기존 SPL Token 프로그램을 사용합니다. Token-2022 민트는 지원하지 않습니다.
- 토큰 잔액 확인은 민팅 시점에 발생합니다. 가드 평가와 트랜잭션 실행 사이에 결제자의 잔액이 필요한 Amount 미만으로 떨어지면 민트가 실패합니다.
