민팅하기

지금까지 Candy Machine을 생성하고 유지 관리하는 방법을 배웠습니다. 가드와 가드 그룹을 사용하여 복잡한 민팅 워크플로우를 구성하고 설정하는 방법을 살펴봤습니다. 이제 퍼즐의 마지막 조각인 민팅에 대해 이야기할 시간입니다!

기본 민팅

Candy Guards 페이지에서 언급했듯이, Candy Machine에서 NFT를 민팅하는 데 책임지는 두 개의 프로그램이 있습니다: NFT 민팅을 담당하는 Candy Machine Core 프로그램과 그 위에 구성 가능한 접근 제어 레이어를 추가하여 커스텀 가드를 제공하기 위해 포크될 수 있는 Candy Guard 프로그램입니다.

따라서 Candy Machine에서 민팅하는 두 가지 방법이 있습니다:

• Candy Guard 프로그램에서 민팅한 다음 Candy Machine Core 프로그램에 민팅을 위임하는 방법. 대부분의 경우 훨씬 복잡한 민팅 워크플로우를 허용하므로 이 방법을 사용하고 싶을 것입니다. 계정에 구성된 가드를 기반으로 민팅 지시에 추가 잔여 계정과 지시 데이터를 전달해야 할 수 있습니다. 다행히 SDK에서는 몇 가지 추가 매개변수가 필요하고 나머지는 계산해주므로 이를 쉽게 만듭니다.

• Core Candy Machine Core 프로그램에서 직접 민팅하는 방법. 이 경우 구성된 민팅 권한만 민팅할 수 있으므로 트랜잭션에 서명해야 합니다.

모든 것이 잘 진행되면 Core Candy Machine에 구성된 매개변수에 따라 NFT가 생성됩니다. 예를 들어, 주어진 Core Candy Machine이 Is Sequential이 false로 설정된 Config Line Settings를 사용한다면 다음 아이템을 무작위로 얻게 됩니다.

Candy Guard 프로그램 버전 1.0부터 민팅 지시는 기존 payer 서명자와 다를 수 있는 추가 minter 서명자를 수락합니다. 이를 통해 NFT를 민팅하는 지갑이 더 이상 SOL 수수료(저장 수수료 및 SOL 민팅 지불 등)를 지불할 필요가 없는 민팅 워크플로우를 생성할 수 있습니다. payer 서명자가 이러한 수수료를 추상화하기 때문입니다. minter 서명자는 여전히 토큰 기반 수수료를 지불해야 하고 구성된 가드를 검증하는 데 사용된다는 점에 유의하세요.

import { mintV1 } from "@metaplex-foundation/mpl-core-candy-machine";
import { setComputeUnitLimit } from "@metaplex-foundation/mpl-toolbox";
import { generateSigner } from "@metaplex-foundation/umi";

const candyMachineId = publicKey("11111111111111111111111111111111");
const coreCollection = publicKey("22222222222222222222222222222222");
const asset = generateSigner(umi);

await mintV1(umi, {
  candyMachine: candyMachineId,
  asset,
  collection: coreCollection,
}).sendAndConfirm(umi);

import { mintFromCandyMachineV2 } from '@metaplex-foundation/mpl-core-candy-machine'
import { setComputeUnitLimit } from '@metaplex-foundation/mpl-toolbox'
import { transactionBuilder, generateSigner } from '@metaplex-foundation/umi'

const candyMachineId = publicKey('11111111111111111111111111111111')
const coreCollection = publicKey('22222222222222222222222222222222')
const asset = generateSigner(umi)

await mintAssetFromCandyMachine(umi, {
  candyMachine: candyMachineId,
  mintAuthority: umi.identity,
  assetOwner: umi.identity.publicKey,
  asset,
  collection: coreCollection,
}).sendAndConfirm(umi);

가드와 함께 민팅하기

많은 가드를 사용하는 Core Candy Machine에서 민팅할 때 추가 가드별 정보를 제공해야 할 수 있습니다.

민팅 지시를 수동으로 구축한다면 그 정보는 지시 데이터와 잔여 계정의 혼합으로 제공될 것입니다. 그러나 SDK를 사용하면 민팅 시 추가 정보가 필요한 각 가드가 민팅 설정이라고 부르는 설정 집합을 정의합니다. 이러한 민팅 설정은 프로그램이 필요로 하는 것으로 파싱됩니다.

민팅 설정이 필요한 가드의 좋은 예는 NFT Payment 가드로, 다른 것들 중에서 민팅 비용을 지불하는 데 사용해야 하는 NFT의 민팅 주소가 필요합니다.

사용 가능한 각 가드는 자체 문서 페이지를 가지고 있으며 해당 가드가 민팅 시 민팅 설정을 제공해야 하는지 여부를 알려줍니다.

민팅 설정이 필요하지 않은 가드만 사용한다면 위의 "기본 민팅" 섹션에서 설명한 것과 동일한 방식으로 민팅할 수 있습니다. 그렇지 않으면 모든 가드의 민팅 설정을 포함하는 추가 객체 속성을 제공해야 합니다. SDK를 사용하여 실제로 어떻게 보이는지 살펴보겠습니다.

생성한 코어 캔디머신의 캔디 가드 수에 따라 트랜잭션이 성공하도록 컴퓨터 단위 수를 늘려야 할 수도 있습니다. SDK도 이에 도움이 될 수 있습니다.

import {
  some,
  generateSigner,
  transactionBuilder,
} from '@metaplex-foundation/umi'
import { create, mintV1 } from '@metaplex-foundation/mpl-core-candy-machine'
import { setComputeUnitLimit } from '@metaplex-foundation/mpl-toolbox'

// 가드가 있는 Core Candy Machine을 생성합니다.
const thirdPartySigner = generateSigner()
await create(umi, {
  // ...
  guards: {
    thirdPartySigner: some({ signer: thirdPartySigner.publicKey }),
    mintLimit: some({ id: 1, limit: 3 }),
  },
}).sendAndConfirm(umi)

// Core Candy Machine에서 민팅합니다.
const nftMint = generateSigner(umi)
await transactionBuilder()
  .add(setComputeUnitLimit(umi, { units: 300_000 }))
  .add(
    mintV1(umi, {
      candyMachine: candyMachineId,
      asset,
      collection: coreCollection,
      mintArgs: {
        thirdPartySigner: some({ signer: thirdPartySigner }),
        mintLimit: some({ id: 1 }),
      },
    })
  )
  .sendAndConfirm(umi)

가드 그룹과 함께 민팅하기

가드 그룹을 사용하는 Core Candy Machine에서 민팅할 때 라벨을 제공하여 민팅할 그룹을 명시적으로 선택해야 합니다.

또한 이전 섹션에서 설명한 대로 민팅 설정이 필요할 수도 있습니다. 그러나 민팅 설정은 선택된 그룹의 "해결된 가드"에 적용됩니다.

예를 들어, 다음 가드를 가진 Core Candy Machine을 상상해보세요:

• 기본 가드:
  • Bot Tax
  • Third Party Signer
  • Start Date
• 그룹 1
  • 라벨: "nft"
  • 가드:
    • NFT Payment
    • Start Date
• 그룹 2
  • 라벨: "public"
  • 가드:
    • Sol Payment

"nft"라는 라벨의 그룹 1의 해결된 가드는:

• Bot Tax: 기본 가드에서.
• Third Party Signer: 기본 가드에서.
• NFT Payment: 그룹 1에서.
• Start Date: 기본 가드를 재정의하므로 그룹 1에서.

따라서 제공된 민팅 설정은 이러한 해결된 가드와 관련되어야 합니다. 위 예에서 Third Party Signer 가드와 NFT Payment 가드에 대해 민팅 설정을 제공해야 합니다.

// 가드가 있는 Core Candy Machine을 생성합니다.
const thirdPartySigner = generateSigner()
await create(umi, {
  // ...
  guards: {
    botTax: some({ lamports: sol(0.001), lastInstruction: true }),
    thirdPartySigner: some({ signer: thirdPartySigner.publicKey }),
    startDate: some({ date: dateTime('2022-10-18T17:00:00Z') }),
  },
  groups: [
    {
      label: 'nft',
      guards: {
        nftPayment: some({ requiredCollection, destination: nftTreasury }),
        startDate: some({ date: dateTime('2022-10-18T16:00:00Z') }),
      },
    },
    {
      label: 'public',
      guards: {
        solPayment: some({ lamports: sol(1), destination: solTreasury }),
      },
    },
  ],
}).sendAndConfirm(umi)

// Core Candy Machine에서 민팅합니다.

const candyMachineId = publicKey('11111111111111111111111111111111')
const coreCollection = publicKey('22222222222222222222222222222222')
const asset = generateSigner(umi)

await transactionBuilder()
  .add(setComputeUnitLimit(umi, { units: 300_000 }))
  .add(
    mintV1(umi, {
      candyMachine: candyMachineId,
      asset,
      collection: coreCollection,
      group: some('nft'),
      mintArgs: {
        thirdPartySigner: some({ signer: thirdPartySigner }),
        nftPayment: some({
          mint: nftFromRequiredCollection.publicKey,
          destination: nftTreasury,
          tokenStandard: TokenStandard.NonFungible,
        }),
      },
    })
  )
  .sendAndConfirm(umi)

사전 검증과 함께 민팅하기

일부 가드는 Core Candy Machine에서 민팅하기 전에 추가 검증 단계가 필요할 수 있다는 점에 유의해야 합니다. 이 사전 검증 단계는 보통 블록체인에 계정을 생성하거나 해당 검증의 증명 역할을 하는 토큰으로 지갑에 보상을 줍니다.

route 지시 사용하기

가드가 사전 검증 단계를 요구할 수 있는 한 가지 방법은 "route" 지시를 통해 자체 특별 지시를 사용하는 것입니다.

좋은 예는 Allow List 가드입니다. 이 가드를 사용할 때 route 지시를 호출하고 유효한 Merkle Proof를 제공하여 지갑이 미리 정의된 지갑 목록에 속하는지 확인해야 합니다. 이 route 지시가 성공하면 해당 지갑에 대한 Allow List PDA를 생성하고 민팅 지시가 이를 읽어 Allow List 가드를 검증할 수 있습니다. Allow List 가드에 대한 자세한 내용은 전용 페이지에서 확인할 수 있습니다.

외부 서비스 사용하기

가드가 사전 검증 단계를 수행할 수 있는 또 다른 방법은 외부 솔루션에 의존하는 것입니다.

예를 들어, Gatekeeper 가드를 사용할 때 구성된 Gatekeeper Network에 따라 Captcha 완성과 같은 도전을 수행하여 Gateway Token을 요청해야 합니다. 그러면 Gatekeeper 가드가 그러한 Gateway Token의 존재를 확인하여 민팅을 검증하거나 거부합니다. Gatekeeper 가드에 대한 자세한 내용은 전용 페이지에서 확인할 수 있습니다.

봇 세금과 함께 민팅하기

Core Candy Machine에 포함하고 싶을 가드 중 하나는 실패한 민팅에 구성 가능한 SOL 금액을 청구하여 봇으로부터 Core Candy Machine을 보호하는 Bot Tax 가드일 것입니다. 이 금액은 일반적으로 실제 사용자의 진짜 실수에 영향을 주지 않으면서 봇을 해치기 위해 적게 설정됩니다. 모든 봇 세금은 Core Candy Machine 계정으로 전송되므로 민팅이 끝나면 Core Candy Machine 계정을 삭제하여 이 자금에 액세스할 수 있습니다.

이 가드는 약간 특별하며 다른 모든 가드의 민팅 동작에 영향을 줍니다. Bot Tax가 활성화되고 다른 가드가 민팅 검증에 실패하면 트랜잭션이 성공한 것처럼 가장합니다. 이는 프로그램에서 오류가 반환되지 않지만 NFT도 민팅되지 않는다는 의미입니다. 이는 봇에서 Core Candy Machine 계정으로 자금이 전송되려면 트랜잭션이 성공해야 하기 때문입니다. Bot Tax 가드에 대한 자세한 내용은 전용 페이지에서 확인할 수 있습니다.

결론

축하합니다! 이제 Core Candy Machine이 A부터 Z까지 어떻게 작동하는지 알게 되었습니다!

다음은 관심을 가질 만한 추가 읽기 자료입니다:

• 사용 가능한 모든 가드: 사용 가능한 모든 가드를 살펴보고 필요한 것들을 선별하세요.