Core Candy Machine에서 Asset을 민팅하기 위한 웹사이트 만들기

Q: Candy Machine 민팅 UI를 만들기에 가장 적합한 프레임워크는 무엇인가요?

Umi 및 지갑 어댑터와의 최상의 호환성을 위해 Next.js를 권장합니다. metaplex-nextjs-tailwind-template이 바로 사용할 수 있는 시작점을 제공합니다.

Q: 지갑이 민팅 자격이 있는지 어떻게 확인하나요?

Candy Guard 계정을 가져와서 연결된 지갑에 대해 각 활성 가드의 조건을 검증합니다 - SOL 잔액, 토큰 보유량, 민팅 한도, 시작 날짜, 허용목록 상태를 확인합니다.

Q: 하나의 트랜잭션에서 여러 NFT를 민팅할 수 있나요?

네. Umi의 트랜잭션 빌더를 사용하여 여러 mintV1 명령을 결합하되, 트랜잭션 크기 제한을 초과하지 않도록 fitsInOneTransaction()을 확인하세요.

요약

이 가이드는 Core Candy Machine을 위한 프론트엔드 민팅 UI 구축 방법을 설명하며, 온체인 데이터 조회, 지갑 자격 확인, 가드 라우트 실행, 민팅 트랜잭션 자체를 다룹니다.

Candy Machine 및 Candy Guard 계정을 가져와서 민팅 진행 상황, 가격, 가드 설정을 표시합니다
활성 가드에 대해 지갑 자격을 검증합니다 (SOL 잔액, 토큰 보유량, 민팅 한도, 시작 날짜, 허용목록)
민팅 전에 필요한 경우 가드 라우트 명령을 실행합니다 (예: Allowlist 증명)
각 활성 가드에 대한 올바른 mintArgs로 mintV1 트랜잭션을 빌드하고 전송합니다

이 가이드는 완전한 웹사이트 구현을 제공하기보다는 핵심 Candy Machine 기능과 상호작용에 중점을 둡니다. 웹사이트에 버튼을 추가하거나 지갑 어댑터와 통합하는 것과 같은 측면은 다루지 않습니다. 대신 Core Candy Machine 작업에 필요한 핵심 정보를 제공합니다.

UI 요소와 지갑 통합을 포함한 전체 웹사이트 구현을 원한다면, metaplex-nextjs-tailwind-template과 같은 템플릿으로 시작할 수 있습니다. 이 템플릿에는 Wallet Adapter와 같은 구성 요소를 위한 많은 설정 단계가 포함되어 있습니다.

일반적인 웹 개발 관행이나 특정 프레임워크 사용에 대한 지침을 찾고 있다면, Visual Studio Code와 같은 도구는 광범위한 문서와 커뮤니티 리소스를 제공합니다.

전제조건

이미 생성된 Candy Machine. 생성 방법에 대한 자세한 정보는 Core Candy Machine 생성 가이드에서 찾을 수 있습니다.
웹 개발과 선택한 프레임워크에 대한 기본적인 숙련도. Umi와의 최고 호환성을 위해 Next JS를 권장합니다.

필수 패키지

선택한 템플릿이나 구현에 관계없이, Core Candy Machine과 상호작용하기 위해 다음 패키지를 설치해야 합니다:

@metaplex-foundation/umi

@metaplex-foundation/umi-bundle-defaults

@metaplex-foundation/mpl-core

@metaplex-foundation/mpl-core-candy-machine

npm i @metaplex-foundation/umi @metaplex-foundation/umi-bundle-defaults @metaplex-foundation/mpl-core-candy-machine

온체인 Candy Machine 데이터 조회

Candy Machine 및 Candy Guard 계정은 민팅 UI가 진행 상황, 가격, 자격을 표시하는 데 필요한 모든 정보를 저장합니다. 민팅 UI는 종종 다음과 같은 데이터를 표시하려고 합니다:

이미 민팅된 Asset 수
Candy Machine의 Asset 수
민팅이 시작될 때까지의 시간
Asset의 가격
기타

사용자에게 표시되지 않지만 백그라운드 계산에 사용되는 추가 데이터를 가져오는 것도 의미가 있을 수 있습니다. 예를 들어, Redeemed Amount Guard를 사용할 때, 사용자가 더 민팅할 수 있는지 확인하기 위해 이미 교환된 수량을 가져올 것입니다.

Candy Machine 계정 데이터 조회

Candy Machine 계정은 사용 가능한 Asset과 교환된 Asset의 수, 그리고 일반적으로 Candy Guard의 주소인 mintAuthority를 저장합니다.

Candy Machine을 가져오려면, 다음과 같이 fetchCandyMachine 함수를 사용할 수 있습니다:

Solana Devnet 엔드포인트를 사용할 것입니다.

import {
  mplCandyMachine,
  fetchCandyMachine,
} from "@metaplex-foundation/mpl-core-candy-machine";
import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";

// The next two lines are only required if you did not set up umi before
// We will be using Solana Devnet as endpoint
const umi = createUmi("https://api.devnet.solana.com")
            .use(mplCandyMachine());

const candyMachineId = "Ct5CWicvmjETYXarcUVJenfz3CCh2hcrCM3CMiB8x3k9";
const candyMachine = await fetchCandyMachine(umi, publicKey(candyMachineId));
console.log(candyMachine)

이것은 다음과 같이 Candy Machine 데이터를 반환합니다:

JSON Result

UI 관점에서 여기서 가장 중요한 필드는 itemsRedeemed, itemsAvailable, mintAuthority입니다. 경우에 따라 일부 items를 웹사이트에 티저 이미지로 표시하는 것도 흥미로울 수 있습니다.

남은 Asset 수량 표시

Candy Machine 계정의 itemsRedeemed와 itemsAvailable을 사용하여 민팅 진행 상황을 표시합니다. 13 / 16 Assets minted와 같은 섹션을 표시하려면 다음과 같은 것을 사용합니다:

const mintedString = `${candyMachine.itemsRedeemed} / ${candyMachine.itemsAvailable} Assets minted`

3 available과 같이 남은 민팅 가능한 Asset을 얻으려면 다음과 같은 계산을 실행합니다:

const availableString = `${candyMachine.itemsAvailable - candyMachine.itemsRedeemed} available`;

Candy Guard 계정 데이터 조회

Candy Guard 계정은 SOL 또는 토큰 지불, 지갑 민팅 한도, 시작 날짜, 허용목록 등 민팅이 허용되기 전에 충족해야 하는 조건을 정의합니다. Candy Guard에 대한 자세한 정보는 Candy Guard 페이지에서 찾을 수 있습니다.

Candy Machine 데이터와 마찬가지로 guard 계정을 가져오는 것이 필수는 아닙니다. 그렇게 하면 Candy Guard에서 SOL 가격만 업데이트하고 웹사이트의 숫자도 자동으로 업데이트하는 등 더 많은 유연성을 허용할 수 있습니다.

여러 Candy Machine에 사용할 수 있는 더 유연한 UI를 구축하려면 Candy Guard를 가져오는 것이 민팅 함수를 동적으로 구축하고 자격을 확인할 수 있게 해줍니다.

다음 코드 조각은 candyMachine 계정이 이전에 가져와졌다고 가정합니다. candyMachine.mintAuthority 대신 Candy Guard의 publicKey를 하드코딩할 수도 있습니다.

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

const candyGuard = await safeFetchCandyGuard(umi, candyMachine.mintAuthority);

JSON Result

추가 Guard 관련 계정 조회

일부 가드는 지갑별 또는 그룹별 상태를 별도의 온체인 계정에 저장합니다. 이러한 계정을 가져오면 민팅을 시도하기 전에 자격을 확인할 수 있습니다. 예를 들어, 지갑의 민팅 자격을 확인하고 mintLimit Guard를 사용하고 있다면, mintCounter 계정을 검색해야 합니다. 이 계정은 특정 guard 하에서 특정 지갑이 이미 민팅한 NFT 수를 기록합니다.

`MintLimit` 계정

MintLimit guard가 활성화되면, 사용자 지갑에 대한 MintCounter 계정을 검색하는 것이 좋습니다. 이를 통해 사용자가 민팅 한도에 도달했는지 또는 여전히 추가 아이템을 민팅할 자격이 있는지 확인할 수 있습니다.

다음 코드 조각은 MintCounter를 가져오는 방법을 보여줍니다. 이 예제는 Candy Machine과 Candy Guard 데이터를 이미 얻었다고 가정합니다:

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

const mintCounter = await safeFetchMintCounterFromSeeds(umi, {
  id: 1, // The mintLimit id you set in your guard config
  user: umi.identity.publicKey,
  candyMachine: candyMachine.publicKey,
  candyGuard: candyMachine.mintAuthority,
});

`NftMintLimit` 계정

MintLimit guard와 마찬가지로 NftMintLimit guard의 NftMintCounter 계정을 가져와 자격을 확인하는 것이 의미가 있을 수 있습니다.

다음 코드 조각은 NftMintCounter 계정을 가져오는 방법을 보여줍니다. 이 예제는 Candy Machine과 Candy Guard 데이터를 이미 얻었다고 가정합니다:

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

const pda = findNftMintCounterPda(umi, {
  id: 1, // The nftMintLimit id you set in your guard config
  mint: asset.publicKey, // The address of the nft your user owns
  candyGuard: candyMachine.mintAuthority,
  candyMachine: candyMachine.publicKey,
});

const nftMintCounter = fetchNftMintCounter(umi, pda)

`AssetMintLimit` 계정

NftMintCounter guard와 마찬가지로 AssetMintLimit guard의 AssetMintCounter 계정을 가져와 자격을 확인하는 것이 의미가 있을 수 있습니다.

다음 코드 조각은 AssetMintCounter 계정을 가져오는 방법을 보여줍니다. 이 예제는 Candy Machine 데이터를 이미 얻었다고 가정합니다:

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

const pda = findAssetMintCounterPda(umi, {
  id: 1, // The assetMintLimit id you set in your guard config
  asset: asset.publicKey, // The address of the core nft your user owns
  candyGuard: candyMachine.mintAuthority,
  candyMachine: candyMachine.publicKey,
});

const assetMintCounter = fetchAssetMintCounter(umi, pda);

`Allocation` 계정

Allocation guard의 경우 주어진 그룹에서 추가 NFT를 민팅할 수 있는지 확인하기 위해 AllocationTracker 계정을 가져오는 것이 의미가 있을 수 있습니다.

다음 코드 조각은 AllocationTracker 계정을 가져오는 방법을 보여줍니다. 이 예제는 Candy Machine 데이터를 이미 얻었다고 가정합니다:

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

const allocationTracker = await safeFetchAllocationTrackerFromSeeds(umi, {
  id: 1, // The allocation id you set in your guard config
  candyMachine: candyMachine.publicKey,
  candyGuard: candyMachine.mintAuthority,
});

`Allowlist` 계정

Allowlist guard를 구현할 때는 미리 route 명령을 실행하는 것이 중요합니다. 이 명령은 각 지갑과 Candy Machine 조합에 대해 고유한 계정을 생성하여 지갑을 민팅 승인된 것으로 효과적으로 표시합니다.

UI 관점에서 이 계정을 쿼리하는 것이 유용합니다. 이를 통해 route 명령을 실행해야 하는지 또는 사용자가 민팅 명령으로 직접 진행할 수 있는지 결정할 수 있습니다.

다음 코드 조각은 이 계정을 가져오는 방법을 보여줍니다. Candy Machine 데이터를 이미 검색했다고 가정합니다. 그러나 원한다면 candyGuard와 candyMachine 공개 키를 대신 하드코딩할 수도 있습니다.

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

const allowlist = [
  "Tes1zkZkXhgTaMFqVgbgvMsVkRJpq4Y6g54SbDBeKVV",
  "GjwcWFQYzemBtpUoN5fMAP2FZviTtMRWCmrppGuTthJS",
  "AT8nPwujHAD14cLojTcB1qdBzA1VXnT6LVGuUd6Y73Cy"
];

const allowListProof = await safeFetchAllowListProofFromSeeds(umi, {
  candyGuard: candyMachine.mintAuthority,
  candyMachine: candyMachine.publicKey,
  merkleRoot: getMerkleRoot(allowlist),
  user: umi.identity.publicKey,
});

자격 확인을 위한 지갑 데이터 조회

지갑 계정 데이터 -- SOL 잔액, 토큰 보유량, 소유 NFT -- 는 민팅을 시도하기 전에 클라이언트 측에서 가드 조건을 검증하는 데 필요합니다. 사용하는 Guard에 따라 지갑에 있는 SOL의 양과 지갑이 소유한 Token 및 NFT를 알고 싶을 수 있습니다.

SOL 잔액을 가져오려면 내장된 getAccount umi 함수를 사용하여 지갑 계정을 가져올 수 있습니다:

const account = await umi.rpc.getAccount(umi.identity.publicKey);
const solBalance = account.lamports;

토큰이나 NFT를 요구하는 guard 중 하나를 사용하고 있다면 이것들도 가져오고 싶을 것입니다. 이를 위해 DAS API를 사용하는 것을 권장합니다. DAS는 RPC 제공자가 유지관리하는 Token의 인덱스입니다. 이를 사용하면 하나의 호출로 모든 필요한 정보를 가져올 수 있습니다. UI에서는 반환된 객체를 사용하여 연결된 지갑이 필요한 토큰이나 NFT를 소유하고 있는지 확인할 수 있습니다.

import { publicKey } from '@metaplex-foundation/umi';
import { dasApi } from '@metaplex-foundation/digital-asset-standard-api';

// When defining the umi instance somewhere before you can already
// add `.use(dasApi());` so there is no need to define umi again.
const umi = createUmi('<ENDPOINT>').use(dasApi());

const assets = await umi.rpc.getAssetsByOwner({
    umi.identity.publicKey
});

민팅 자격 확인

각 활성 가드는 민팅 명령이 온체인에서 성공하기 위해 연결된 지갑이 충족해야 하는 조건을 정의합니다. 모든 필요한 데이터를 가져온 후 연결된 지갑이 민팅을 허용받는지 여부를 확인할 수 있습니다.

그룹이 Candy Machine에 첨부되면 default guard가 생성된 모든 그룹에 전체적으로 적용된다는 점이 중요합니다. 또한 그룹이 활성화되면 default 그룹에서 민팅하는 능력이 비활성화되고 민팅을 위해 생성된 그룹을 사용해야 합니다.

따라서 정의된 그룹이 없으면 default 그룹의 모든 민팅 조건이 충족되는지 확인해야 합니다. 그룹이 정의되어 있으면 default guard와 현재 민팅 그룹 guard의 조합이 모두 검증되어야 합니다.

그룹을 활용하지 않고 startDate, SolPayment, mintLimit guard가 첨부된 Candy Machine이 주어졌을 때, 사용자가 민팅 함수를 호출하도록 허용하기 전에 다음 검증이 수행되어야 합니다. candyGuard가 이전에 가져와졌고 하나의 Core NFT Asset이 민팅되어야 한다고 가정합니다.

startDate가 과거인지 확인합니다. 여기서는 사용자 장치 시간을 사용하지 않고 대신 현재 내부 Solana 블록시간을 가져옵니다. 이것이 Candy Machine이 민팅 시 검증에 사용할 시간이기 때문입니다:

import { unwrapOption } from '@metaplex-foundation/umi';

let allowed = true;

// fetch the current slot and read the blocktime
const slot = await umi.rpc.getSlot();
let solanaTime = await umi.rpc.getBlockTime(slot);

// Check if a `default` startDate guard is attached
const startDate = unwrapOption(candyGuard.guards.startDate);
if (startDate) {
  // validate the startTime is in the future
  if (solanaTime < startDate) {
        console.info(`StartDate not reached!`);
        allowed = false;
  }
}

지갑이 민팅 비용을 지불할 충분한 SOL을 가지고 있는지 확인합니다. 여기서는 트랜잭션 수수료를 포함하지 않고 위에서 설명한 대로 SolBalance가 가져와졌다고 가정합니다.

import { unwrapOption } from '@metaplex-foundation/umi';

const solPayment = unwrapOption(candyGuard.guards.solPayment);
if (solPayment){
  if (solPayment.lamports.basisPoints > solBalance){
    console.info(`Not enough SOL!`);
    allowed = false;
  }
}

mintLimit에 아직 도달하지 않았는지 확인합니다:

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

const mintLimit = unwrapOption(candyGuard.guards.mintLimit);
if (mintLimit){
      const mintCounter = await safeFetchMintCounterFromSeeds(umi, {
      id: mintLimit.id,
      user: umi.identity.publicKey,
      candyMachine: candyMachine.publicKey,
      candyGuard: candyMachine.mintAuthority,
    });

    // mintCounter PDA exists (not the first mint)
    if (mintCounter && mintLimit.limit >= mintCounter.count
    ) {
      allowed = false;
    }
}

지갑이 민팅할 자격이 없을 때는 민팅 버튼을 비활성화하고 사용자에게 민팅할 자격이 없는 이유를 보여주는 것이 도움이 됩니다. 예: Not enough SOL! 메시지.

Guard Route

특정 가드는 민팅 명령이 성공하기 전에 route 명령을 실행해야 합니다. 이러한 명령은 데이터를 저장하거나 지갑의 민팅 자격 증명을 제공하는 계정을 생성합니다. 이러한 명령의 실행 빈도는 Guard 유형에 따라 다릅니다.

이 섹션의 대상 독자

Allocation, FreezeSolPayment, FreezeTokenPayment 또는 Allowlist guard를 사용하지 않는 경우 이 섹션을 건너뛰어도 안전합니다.

일부 Guard는 전체 Candy Machine에 대해 한 번만 route를 실행하면 됩니다. 이러한 경우 UI에 함수를 포함할 필요는 없지만 스크립트를 통해 미리 한 번 실행할 수 있습니다:

다른 Guard는 각 개별 지갑에 대해 route를 실행해야 합니다. 이러한 경우 민팅 트랜잭션 이전에 route 명령을 실행해야 합니다:

Allowlist

Guard route 구현 예시로 Allowlist guard의 경우를 고려해보겠습니다. 이는 앞서 설명한 대로 allowListProof가 가져와졌고, allowlist가 적격한 지갑 주소의 배열을 나타낸다고 가정합니다. 다음 코드는 구현에서 이 시나리오를 처리하는 방법을 보여줍니다.

import {
  getMerkleRoot,
  getMerkleProof,
  route
} from "@metaplex-foundation/mpl-core-candy-machine";
import {
  publicKey,
} from "@metaplex-foundation/umi";

// assuming you fetched the AllowListProof as described above
if (allowListProof === null) {
  route(umi, {
    guard: "allowList",
    candyMachine: candyMachine.publicKey,
    candyGuard: candyMachine.mintAuthority,
    group: "default", // Add your guard label here
    routeArgs: {
      path: "proof",
      merkleRoot: getMerkleRoot(allowlist),
      merkleProof: getMerkleProof(allowlist, publicKey(umi.identity)),
    },
  })
}

민팅 함수 구축

민팅 함수는 자격 검증, 가드 라우트 실행, 올바르게 채워진 mintArgs와 함께 mintV1 명령을 결합합니다. 첨부된 모든 guard에 대한 자격 확인을 구현하는 것이 권장됩니다. 그룹이 첨부되어 있으면 default guard가 모든 추가 그룹에 적용되면서 동시에 default 그룹을 비활성화한다는 점을 염두에 두세요.

이러한 확인이 완료되고 필요한 경우 route 명령이 실행된 후 민팅 트랜잭션을 구축할 수 있습니다. guard에 따라 mintArgs를 전달해야 할 수 있습니다. 이는 올바른 계정과 데이터를 전달하여 민팅 트랜잭션을 구축하는 데 도움이 되는 인수입니다. 예를 들어 mintLimit guard는 mintCounter 계정이 필요합니다. Umi SDK는 이러한 세부 사항을 추상화하지만 트랜잭션을 올바르게 구축하기 위해 일부 정보가 여전히 필요합니다.

startDate, SolPayment, mintLimit Guard가 첨부된 Candy Machine을 다시 가정하여 mintArgs를 구축하는 방법을 살펴보겠습니다.

import { some, unwrapOption } from '@metaplex-foundation/umi';
import {
  DefaultGuardSetMintArgs
} from "@metaplex-foundation/mpl-core-candy-machine";

let mintArgs: Partial<DefaultGuardSetMintArgs> = {};

// add solPayment mintArgs
const solPayment = unwrapOption(candyGuard.guards.solPayment)
if (solPayment) {
  mintArgs.solPayment = some({
    destination: solPayment.destination,
  });
}

// add mintLimit mintArgs
const mintLimit = unwrapOption(candyGuard.guards.mintLimit)
if (mintLimit) {
  mintArgs.mintLimit = some({ id: mintLimit.id });
}

모든 Guard가 추가 mintArgs를 전달해야 하는 것은 아닙니다. 이것이 위 코드 조각에 startDate가 없는 이유입니다. 사용하는 guard가 mintArgs를 전달해야 하는지 이해하려면 Developer Hub Guard 페이지를 확인하는 것이 권장됩니다. "Mint Settings"이 설명되어 있으면 이 guard에 대해 mintArgs를 전달해야 합니다.

이제 mintArgs가 구축되었으므로 민팅 함수 자체를 호출하는 방법을 살펴보겠습니다. 다음 코드 조각은 위에서 설명한 대로 candyMachine과 candyGuard가 가져와졌다고 가정합니다. 기술적으로 candyMachine, collection, candyGuard의 publicKey와 모든 mintArgs는 가져오기를 원하지 않는 경우 수동으로 전달할 수도 있습니다.

// Generate the NFT address
const nftMint = generateSigner(umi);

await mintV1(umi, {
  candyMachine: candyMachine.publicKey,
  collection: candyMachine.collectionMint,
  asset: nftMint,
  candyGuard: candyGuard.publicKey,
  mintArgs,
}).sendAndConfirm(umi)

console.log(`NFT ${nftMint.publicKey} minted!`)

고급 민팅 기법

기본적인 단일 민팅 흐름 외에도, Core Candy Machine은 여러 민팅을 하나의 트랜잭션으로 묶는 것과 가드 그룹을 사용한 계층별 민팅 전략을 지원합니다.

하나의 트랜잭션으로 여러 NFT 민팅

효율성을 위해 사용자가 단일 트랜잭션에서 여러 NFT를 민팅할 수 있도록 하고 싶을 수 있습니다. 이를 달성하는 방법은 다음과 같습니다:

특정 설정에 따라 Transaction Builders를 결합하여 하나의 트랜잭션에서 여러 NFT를 민팅할 수 있도록 하는 것이 도움이 될 수 있습니다.

let builder = transactionBuilder()
  .add(mintV1(...))
  .add(mintV1(...))

트랜잭션에 너무 많은 mintV1 명령을 추가하면 Transaction too large 오류가 발생합니다. builder.fitsInOneTransaction(umi) 함수를 사용하면 트랜잭션을 보내기 전에 이를 확인할 수 있어 필요한 경우 트랜잭션을 분할할 수 있습니다. 분할이 필요한 경우 signAllTransactions를 사용하는 것이 권장되므로 Wallet Adapter에서 하나의 팝업만 승인하면 됩니다.

Guard Groups

Guard groups는 단일 Candy Machine에 서로 다른 구성의 여러 가드 세트를 정의할 수 있게 합니다. 다음과 같은 시나리오에서 특히 유용할 수 있습니다:

계층화된 민팅: VIP, 조기 액세스, 공개 판매를 위한 다양한 그룹.
여러 지불 옵션: SOL 지불, SPL 토큰 지불 등을 위한 그룹.
시간 기반 민팅: 다른 시작 및 종료 날짜를 가진 그룹.
허용목록 기반 민팅: 허용목록 사용자와 공개 판매를 위한 그룹.

UI에서 guard group을 구현하려면 두 가지 주요 접근 방식이 있습니다:

여러 버튼 접근 방식: 각 그룹에 대해 별도의 버튼을 만들어 사용자가 선호하는 민팅 옵션을 선택할 수 있게 합니다.
자동 그룹 선택: 사용자의 자격과 현재 조건을 기반으로 사용자에게 최적의 그룹을 결정하는 함수를 구현합니다.

어떤 시나리오나 접근 방식을 선택하든, 특정 그룹과 작동하도록 mintV1 명령을 조정하는 방법은 다음과 같습니다. 핵심 수정 사항은 원하는 라벨을 지정하는 group 매개변수를 포함하는 것입니다.

// Generate the NFT address
const nftMint = generateSigner(umi);

await mintV1(umi, {
  candyMachine: candyMachine.publicKey,
  collection: candyMachine.collectionMint,
  asset: nftMint,
  candyGuard: candyGuard.publicKey,
  mintArgs,
  group: "group1",
}).sendAndConfirm(umi)

console.log(`NFT ${nftMint.publicKey} minted!`)

참고사항

클라이언트 측 검증은 참고용입니다. 이 가이드에서 설명하는 자격 확인은 브라우저에서 실행되며 온체인 가드 검증을 대체하지 않습니다. Candy Machine 프로그램은 민팅 트랜잭션 중에 자체적으로 가드 확인을 수행합니다; 실패하는 가드는 클라이언트 측 로직에 관계없이 트랜잭션을 되돌립니다.
컴퓨트 유닛 증가가 필요할 수 있습니다. 활성 가드의 수와 복잡성에 따라 기본 컴퓨트 유닛 한도가 충분하지 않을 수 있습니다. 컴퓨트 초과 오류로 트랜잭션이 실패할 때 setComputeUnitLimit를 사용하여 예산을 늘리세요.
Guard groups는 default 전용 민팅을 비활성화합니다. 하나 이상의 guard group이 Candy Machine에 첨부되면, default 그룹만으로는 더 이상 민팅에 사용할 수 없습니다. mintV1 호출에 group 라벨을 지정해야 하며, default 가드와 선택한 그룹의 가드 모두 적용됩니다.

다음 단계

프론트엔드에서 Candy Machine과 상호작용하는 핵심 사항을 마스터했으므로, 프로젝트를 더욱 향상시키고 배포하기 위해 다음 단계를 고려할 수 있습니다:

호스팅: 호스팅 플랫폼에 배포하여 사용자가 프론트엔드에 액세스할 수 있도록 합니다. 개발자들 사이에서 인기 있는 옵션은 다음과 같습니다:
- Vercel
- Cloudflare Pages
- Netlify
- GitHub Pages
테스팅: 다양한 장치와 브라우저에서 UI를 철저히 테스트하여 원활한 사용자 경험을 보장합니다.
최적화: 특히 민팅 이벤트 중 높은 트래픽이 예상되는 경우 성능을 위해 프론트엔드를 미세 조정합니다.
모니터링: Candy Machine UI의 상태를 추적하고 발생할 수 있는 문제를 신속하게 해결하기 위한 모니터링 도구를 설정합니다.

Core Candy Machine을 사용하여 성공적인 NFT 민팅 프로젝트를 시작하고 유지관리할 준비가 잘 될 것입니다.

FAQ

Core Candy Machine을 위해 직접 민팅 웹사이트를 만들어야 하나요?

필수는 아니지만, 커스텀 웹사이트가 최고의 사용자 경험을 제공합니다. 프론트엔드 없이 Metaplex CLI를 사용하여 민팅할 수도 있습니다.

Candy Machine 민팅 UI를 만들기에 가장 적합한 프레임워크는 무엇인가요?

Umi 및 지갑 어댑터와의 최상의 호환성을 위해 Next.js를 권장합니다. metaplex-nextjs-tailwind-template이 바로 사용할 수 있는 시작점을 제공합니다.

지갑이 민팅 자격이 있는지 어떻게 확인하나요?

Candy Guard 계정을 가져와서 연결된 지갑에 대해 각 활성 가드의 조건을 검증합니다 -- SOL 잔액, 토큰 보유량, 민팅 한도, 시작 날짜, 허용목록 상태를 확인합니다.

하나의 트랜잭션에서 여러 NFT를 민팅할 수 있나요?

네. Umi의 트랜잭션 빌더를 사용하여 여러 mintV1 명령을 결합하되, 트랜잭션 크기 제한을 초과하지 않도록 fitsInOneTransaction()을 확인하세요.

Metaplex Foundation에서 유지관리. 2026년 3월 검증. @metaplex-foundation/mpl-core-candy-machine에 적용.

요약