사용 가능한 가드

Sol Payment Guard

Last updated March 10, 2026

Sol Payment 가드는 Core Candy Machine에서 민팅 시 결제자에게 구성 가능한 SOL 수량을 청구하고 지정된 대상 지갑으로 결제를 전송합니다.

개요

Sol Payment 가드는 민팅 시 결제자에게 SOL 수량을 청구할 수 있게 해줍니다. SOL 수량과 목적지 주소를 모두 구성할 수 있습니다.

가드 설정

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

  • Lamports: 결제자에게 청구할 SOL(또는 lamports) 수량입니다.
  • Destination: 이 가드와 관련된 모든 결제를 받을 지갑의 주소입니다.

Sol Payment 가드를 사용한 Candy Machine 설정

이 예시에서는 현재 identity를 목적지 지갑으로 사용하고 있습니다.

create(umi, {
// ...
guards: {
solPayment: some({
lamports: sol(1.5),
destination: umi.identity.publicKey,
}),
},
});

API References: create, SolPayment

민트 설정

Sol Payment 가드에는 다음 민트 설정이 포함됩니다:

  • Destination: 이 가드와 관련된 모든 결제를 받을 지갑의 주소입니다.

참고로, SDK의 도움 없이 명령어를 구성할 계획이라면 이러한 민트 설정과 더 많은 것들을 명령어 인수와 나머지 계정의 조합으로 제공해야 합니다. 자세한 내용은 Core Candy Guard의 프로그램 문서를 참조하세요.

Sol Payment Guard로 민팅하기

다음과 같이 mintArgs 인수를 사용하여 Sol Payment 가드의 민트 설정을 전달할 수 있습니다.

mintV1(umi, {
// ...
mintArgs: {
solPayment: some({ destination: treasury }),
},
});

API References: mintV1, SolPaymentMintArgs

Route Instruction

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

Notes

  • Sol Payment 가드는 가드 설정과 민트 설정 모두에서 destination 지갑 주소를 제공해야 합니다.
  • 결제 금액은 lamports로 지정됩니다. SOL을 lamports로 변환하려면 sol() 헬퍼를 사용하세요(예: sol(1.5)는 1,500,000,000 lamports).
  • 결제자는 민트 결제와 Solana 트랜잭션 수수료를 모두 충당할 수 있는 충분한 SOL 잔액을 보유해야 합니다.