가드 그룹 | 코어 캔디 머신

이전 페이지 중 하나에서 가드를 소개하고 이를 사용하여 캔디 머신의 액세스 제어를 정의했습니다. 가드를 사용하면 예를 들어 민트당 1 SOL의 결제를 추가하고 특정 날짜 이후에 민팅이 시작되도록 할 수 있다는 것을 보았습니다. 하지만 두 번째 날짜 이후에 2 SOL을 청구하고 싶다면 어떨까요? 특정 토큰 보유자가 무료로 또는 할인된 가격으로 민팅할 수 있게 하고 싶다면 어떨까요?

각각 고유한 요구 사항을 가진 여러 가드 세트를 정의할 수 있다면 어떨까요? 이러한 이유로 가드 그룹을 만들었습니다!

그룹은 어떻게 작동하나요?

활성화하려는 가드의 설정을 간단히 제공하여 코어 캔디 머신에 가드를 설정할 수 있는 방법을 기억하시나요? 가드 그룹도 같은 방식으로 작동하지만, 식별을 위해 고유한 레이블도 제공해야 합니다.

따라서 각 가드 그룹에는 다음 속성이 있습니다:

레이블: 고유한 텍스트 식별자입니다. 6자를 초과할 수 없습니다.
가드: 해당 그룹 내에서 활성화된 모든 가드의 설정입니다. 이는 코어 캔디 머신에서 직접 가드를 설정하는 것과 같은 방식으로 작동합니다.

빠른 예시를 들어보겠습니다. 오후 4시부터 5시까지는 1 SOL을, 오후 5시부터 코어 캔디 머신이 소진될 때까지는 2 SOL을 청구하고 싶다고 가정해보겠습니다. 이 모든 것을 봇 택스 가드를 통해 봇으로부터 보호받으면서 말이죠. 다음과 같이 가드를 설정할 수 있습니다:

그룹 1:
- 레이블: "early"
- 가드:
  - Sol Payment: 1 SOL
  - Start Date: 4 pm (단순화를 위해 실제 날짜는 무시합니다)
  - End Date: 5 pm
  - Bot Tax: 0.001 SOL
그룹 2:
- 레이블: "late"
- 가드:
  - Sol Payment: 2 SOL
  - Start Date: 5 pm
  - Bot Tax: 0.001 SOL

이렇게 해서 맞춤형 2단계 민팅 프로세스를 만들었습니다!

이제 누군가 우리의 코어 캔디 머신에서 민팅을 시도할 때마다 어느 그룹에서 민팅하는지 명시적으로 알려줘야 합니다. 민팅할 때 그룹 레이블을 요청하는 것이 중요한 이유는 다음과 같습니다:

구매자가 예상치 못한 민팅 동작을 경험하지 않도록 보장합니다. 첫 번째 그룹의 종료 날짜 바로 끝에 1 SOL로 민팅을 시도했지만, 트랜잭션이 실행될 때쯤에는 이미 그 날짜를 지났다고 가정해보겠습니다. 그룹 레이블을 요청하지 않았다면, 트랜잭션이 성공하고 1 SOL만 청구될 것으로 예상했음에도 불구하고 2 SOL이 청구될 것입니다.
병렬 그룹을 지원할 수 있게 해줍니다. 이에 대해서는 이 페이지의 뒷부분에서 자세히 이야기하겠습니다.

React Flow

이제 SDK를 사용하여 그룹을 생성하고 업데이트하는 방법을 살펴보겠습니다.

가드 그룹으로 캔디 머신 생성

가드 그룹으로 캔디 머신을 생성하려면 create 함수에 groups 배열을 제공하기만 하면 됩니다. 이 배열의 각 항목에는 label과 해당 그룹에서 활성화하려는 모든 가드의 설정이 포함된 guards 객체가 있어야 합니다.

Umi 라이브러리를 사용하여 위 예시를 구현하는 방법은 다음과 같습니다.

import { some, sol, dateTime } from '@metaplex-foundation/umi'

await create(umi, {
  // ...
  groups: [
    {
      label: 'early',
      guards: {
        solPayment: some({ lamports: sol(1), destination: treasury }),
        startDate: some({ date: dateTime('2022-10-18T16:00:00Z') }),
        endDate: some({ date: dateTime('2022-10-18T17:00:00Z') }),
        botTax: some({ lamports: sol(0.001), lastInstruction: true }),
      },
    },
    {
      label: 'late',
      guards: {
        solPayment: some({ lamports: sol(2), destination: treasury }),
        startDate: some({ date: dateTime('2022-10-18T17:00:00Z') }),
        botTax: some({ lamports: sol(0.001), lastInstruction: true }),
      },
    },
  ],
}).sendAndConfirm(umi)

그룹을 업데이트하려면 updateCandyGuard 함수에 동일한 groups 속성을 제공하면 됩니다. 전체 guards 객체와 groups 배열이 업데이트되어 기존 데이터를 모두 덮어쓴다는 점에 주의하세요!

따라서 설정이 변경되지 않더라도 모든 그룹의 설정을 제공해야 합니다. 기존 설정을 덮어쓰는 것을 방지하기 위해 미리 최신 캔디 가드 계정 데이터를 가져오고 싶을 수도 있습니다.

다음은 "late" 그룹의 SOL 결제 가드를 2 SOL 대신 3 SOL로 변경하는 예시입니다.

import { some, sol, dateTime } from '@metaplex-foundation/umi'

const candyGuard = await fetchCandyGuard(umi, candyMachine.mintAuthority)
await updateCandyGuard(umi, {
  candyGuard: candyGuard.publicKey,
  guards: candyGuard.guards,
  groups: [
    {
      label: 'early',
      guards: {
        solPayment: some({ lamports: sol(1), destination: treasury }),
        startDate: some({ date: dateTime('2022-10-18T16:00:00Z') }),
        endDate: some({ date: dateTime('2022-10-18T17:00:00Z') }),
        botTax: some({ lamports: sol(0.001), lastInstruction: true }),
      },
    },
    {
      label: 'late',
      guards: {
        solPayment: some({ lamports: sol(3), destination: treasury }),
        startDate: some({ date: dateTime('2022-10-18T17:00:00Z') }),
        botTax: some({ lamports: sol(0.001), lastInstruction: true }),
      },
    },
  ],
}).sendAndConfirm(umi)

API 참조: create, updateCandyGuard, DefaultGuardSetArgs

기본 가드

위 예시에서 두 그룹 모두에 동일한 봇 택스 가드를 제공해야 했다는 점에 주목하세요. 이는 캔디 머신에 설정된 글로벌 가드를 활용하여 단순화할 수 있습니다.

가드 그룹을 사용할 때 코어 캔디 머신의 글로벌 가드는 — 이전 페이지에서 설명한 바와 같이 — 기본 가드 역할을 합니다! 즉, 그룹에서 명시적으로 활성화하여 재정의하지 않는 한 그룹은 글로벌 가드와 동일한 가드 설정을 사용하게 됩니다.

간단한 요약은 다음과 같습니다:

기본 가드에서는 활성화되었지만 그룹의 가드에서는 활성화되지 않은 가드의 경우, 그룹은 기본 가드에서 정의된 대로 가드를 사용합니다.
기본 가드에서_와_ 그룹의 가드에서 모두 활성화된 가드의 경우, 그룹은 그룹의 가드에서 정의된 대로 가드를 사용합니다.
기본 가드나 그룹의 가드에서 활성화되지 않은 가드의 경우, 그룹은 이 가드를 사용하지 않습니다.

이를 설명하기 위해 이전 섹션의 예시를 가져와서 봇 택스 가드를 기본 가드로 이동해보겠습니다.

기본 가드:
- Bot Tax: 0.001 SOL
그룹 1:
- 레이블: "early"
- 가드:
  - Sol Payment: 1 SOL
  - Start Date: 4 pm
  - End Date: 5 pm
그룹 2:
- 레이블: "late"
- 가드:
  - Sol Payment: 2 SOL
  - Start Date: 5 pm

보시다시피 기본 가드는 그룹 내에서 반복을 피하는 데 유용합니다.

React Flow

기본 가드를 사용하더라도 민팅 시에는 그룹을 제공해야 한다는 점에 주목하세요. 즉, 가드 그룹을 사용할 때는 기본 가드만으로는 민팅할 수 없습니다.

기본 가드와 가드 그룹으로 캔디 머신 생성

Umi 라이브러리에서 기본 가드를 사용하려면 캔디 머신을 생성하거나 업데이트할 때 groups 배열과 함께 guards 속성을 사용하면 됩니다. 예를 들어, 위에서 설명한 가드 설정을 사용하여 캔디 머신을 생성하는 방법은 다음과 같습니다.

import { some, sol, dateTime } from '@metaplex-foundation/umi'

await create(umi, {
  // ...
  guards: {
    botTax: some({ lamports: sol(0.001), lastInstruction: true }),
  },
  groups: [
    {
      label: 'early',
      guards: {
        solPayment: some({ lamports: sol(1), destination: treasury }),
        startDate: some({ date: dateTime('2022-10-18T16:00:00Z') }),
        endDate: some({ date: dateTime('2022-10-18T17:00:00Z') }),
      },
    },
    {
      label: 'late',
      guards: {
        solPayment: some({ lamports: sol(2), destination: treasury }),
        startDate: some({ date: dateTime('2022-10-18T17:00:00Z') }),
      },
    },
  ],
}).sendAndConfirm(umi)

API 참조: create, DefaultGuardSetArgs

병렬 그룹

민팅 시 그룹 레이블을 요구하는 것의 정말 흥미로운 이점 중 하나는 주어진 시간에 둘 이상의 유효한 그룹을 가질 수 있는 능력입니다. 이는 프로그램의 모호함을 제거하고 구매자가 어느 그룹에서 민팅을 시도할지 선택할 수 있게 해줍니다.

새로운 예시로 이를 설명해보겠습니다. "Innocent Bird"라는 자산 컬렉션이 있고, "Innocent Bird" 자산을 보유한 사람에게는 1 SOL의 할인된 가격을, 다른 사람에게는 2 SOL을 청구하고 싶다고 가정해보겠습니다. 두 그룹 모두 동시에 — 예를 들어 오후 4시에 — 민팅을 시작할 수 있게 하고, 두 그룹 모두 봇으로부터 보호받고 싶습니다. 다음과 같이 가드를 구성할 수 있습니다:

기본 가드:
- Start Date: 4 pm
- Bot Tax: 0.001 SOL
그룹 1:
- 레이블: "nft"
- 가드:
  - Sol Payment: 1 SOL
  - NFT Gate: "Innocent Bird" Collection
그룹 2:
- 레이블: "public"
- 가드:
  - Sol Payment: 2 SOL

보시다시피 이러한 가드 설정으로는 두 그룹이 동시에 민팅할 수 있습니다. NFT 보유자가 "public" 그룹에서 민팅하기로 결정하면 전체 2 SOL을 지불하는 것도 가능합니다. 하지만 가능하다면 "nft" 그룹을 선택하는 것이 그들에게 가장 유리합니다.

병렬 그룹으로 코어 캔디 머신 생성

Umi 라이브러리를 통해 위에서 설명한 가드 설정을 사용하여 코어 캔디 머신을 생성하는 방법은 다음과 같습니다.

import { some, sol, dateTime } from '@metaplex-foundation/umi'

await create(umi, {
  // ...
  guards: {
    botTax: some({ lamports: sol(0.001), lastInstruction: true }),
    startDate: some({ date: dateTime('2022-10-18T16:00:00Z') }),
  },
  groups: [
    {
      label: 'early',
      guards: {
        solPayment: some({ amount: sol(1), destination: treasury }),
        nftGate: some({
          requiredCollection: innocentBirdCollectionNft.publicKey,
        }),
      },
    },
    {
      label: 'late',
      guards: {
        solPayment: some({ amount: sol(2), destination: treasury }),
      },
    },
  ],
}).sendAndConfirm(umi)

API 참조: create, DefaultGuardSetArgs

결론

가드 그룹은 우리의 요구에 맞는 순차적 및/또는 병렬 민팅 워크플로우를 정의할 수 있게 함으로써 코어 캔디 머신에 완전히 새로운 차원을 가져다줍니다.

다음 페이지에서는 가드에 대한 또 다른 흥미로운 기능인 가드 지시사항을 살펴보겠습니다!