할당 가드

개요

할당 가드는 각 가드 그룹이 민팅할 수 있는 자산 수에 제한을 지정할 수 있습니다.

제한은 설정에 제공된 식별자별로 설정되어 동일한 코어 캔디 머신 내에서 여러 할당을 허용합니다.

가드 설정

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

• ID: 이 가드의 고유 식별자입니다. 서로 다른 식별자는 주어진 지갑이 민팅한 아이템 수를 추적하기 위해 서로 다른 카운터를 사용합니다. 이는 가드 그룹을 사용할 때 특히 유용하며, 각각에 다른 민트 제한을 적용하고 싶을 때 사용됩니다.
• Limit: 가드 그룹에서 허용되는 최대 민팅 수입니다.

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

민트 설정

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

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

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

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

라우트 지시사항

할당 가드 라우트 지시사항은 다음 기능을 지원합니다.

할당 추적기 초기화

할당 가드를 사용할 때 민팅이 시작되기 전에 할당 추적기 계정을 초기화해야 합니다. 이는 가드 설정의 id 속성에서 파생된 PDA 계정을 생성합니다.

할당 추적기 PDA 계정은 가드 그룹 내의 민팅 수를 추적하고 제한에 도달하면 해당 그룹 내의 모든 민팅을 차단합니다.

이 할당 추적기 계정을 초기화할 때 가드의 라우트 지시사항에 다음 인수를 제공해야 합니다:

• ID: 가드 설정의 할당 id입니다.
• Candy Guard Authority: 서명자로서 코어 캔디 가드 계정의 권한입니다.

route(umi, {
  // ...
  guard: 'allocation',
  routeArgs: {
    id: 1,
    candyGuardAuthority: umi.identity,
  },
})

route(umi, {
  // ...
  guard: 'allocation',
  routeArgs: {
    id: 1,
    candyGuardAuthority: umi.identity,
  },
  group: some('GROUPA'),
})

할당 계정

Allocation 가드를 사용할 때 라우트 지시사항이 실행된 후 allocationTracker 계정이 생성됩니다. 검증 목적으로 다음과 같이 가져올 수 있습니다:

import {
  safeFetchAllocationTrackerFromSeeds,
} from "@metaplex-foundation/mpl-core-candy-machine";

const allocationTracker = await safeFetchAllocationTrackerFromSeeds(umi, {
  id: 1, // 가드 설정에서 설정한 할당 id
  candyMachine: candyMachine.publicKey,
  // 또는 candyMachine: publicKey("Address") CM 주소와 함께
  candyGuard: candyMachine.mintAuthority,
  // 또는 candyGuard: publicKey("Address") candyGuard 주소와 함께
});