Mint Limit Guard

개요

Mint Limit 가드는 각 지갑이 민팅할 수 있는 Asset 수에 제한을 지정할 수 있습니다.

제한은 지갑별, 캔디 머신별, 그리고 설정에서 제공된 식별자별로 설정되어 동일한 Core Candy Machine 내에서 여러 개의 민트 제한을 허용합니다.

가드 설정

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

• ID: 이 가드의 고유 식별자입니다. 서로 다른 식별자는 해당 지갑이 얼마나 많은 아이템을 민팅했는지 추적하기 위해 서로 다른 카운터를 사용합니다. 이는 각 가드 그룹이 서로 다른 민팅 제한을 가지길 원할 때 특히 유용합니다.
• Limit: 해당 식별자에 대한 지갑당 허용되는 최대 민팅 수량입니다.

create(umi, {
  // ...
  guards: {
    mintLimit: some({ id: 1, limit: 5 }),
  },
});

민팅 설정

Mint Limit 가드에는 다음 민팅 설정이 포함됩니다:

• ID: 이 가드의 고유 식별자입니다.

참고로, SDK의 도움 없이 직접 지시문을 구성할 계획이라면, 이러한 민팅 설정과 추가 항목들을 지시문 인수와 나머지 계정의 조합으로 제공해야 합니다. 자세한 내용은 Core Candy Guard의 프로그램 문서를 참조하세요.

mintV1(umi, {
  // ...
  mintArgs: {
    mintLimit: some({ id: 1 }),
  },
});

Route Instruction

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

MintLimit Accounts

MintLimit 가드가 사용되면 각 지갑, CandyMachine, id 조합에 대해 MintCounter 계정이 생성됩니다. 검증 목적으로 다음과 같이 가져올 수 있습니다:

import { safeFetchMintCounterFromSeeds } from "@metaplex-foundation/mpl-core-candy-machine";
import { umi } from "@metaplex-foundation/mpl-core-candy-machine";

const mintCounter = await safeFetchMintCounterFromSeeds(umi, {
  id: 1, // 가드 설정에서 설정한 mintLimit id
  user: umi.identity.publicKey,
  candyMachine: candyMachine.publicKey,
  // 또는 candyMachine: publicKey("Address") CM 주소 사용
  candyGuard: candyMachine.mintAuthority,
  // 또는 candyGuard: publicKey("Address") candyGuard 주소 사용
});

// 이미 민팅된 수량
console.log(mintCounter.count)