이 가이드에서는 mpl-core Rust SDK crate를 사용하여 Solana 프로그램에서 Anchor 프레임워크를 통해 CPI로 Core NFT Collection을 생성하는 방법을 보여줍니다.

Core란?

Core는 단일 계정 설계를 사용하여 대안 솔루션과 비교하여 민팅 비용을 줄이고 Solana 네트워크 부하를 개선합니다. 또한 개발자가 에셋의 동작과 기능을 수정할 수 있는 유연한 플러그인 시스템을 갖추고 있습니다.

시작하기 전에 Collection에 대해 알아봅시다:

Collection이란?

Collection은 같은 시리즈나 그룹에 속하는 Asset의 그룹입니다. Asset을 그룹화하려면 먼저 컬렉션 이름과 컬렉션 이미지와 같은 해당 컬렉션과 관련된 메타데이터를 저장하는 것을 목적으로 하는 Collection Asset을 생성해야 합니다. Collection Asset은 컬렉션의 표지 역할을 하며 컬렉션 전체 플러그인도 저장할 수 있습니다.

전제 조건

선호하는 코드 에디터 (Rust Analyzer 플러그인이 포함된 Visual Studio Code 권장)
Anchor 0.30.1 이상.

초기 설정

이 가이드에서는 필요한 모든 매크로를 lib.rs 파일에서 찾을 수 있는 모노 파일 접근 방식을 활용하여 Anchor를 사용합니다:

declare_id: 프로그램의 온체인 주소를 지정합니다.
#[program]: 프로그램의 명령어 로직을 포함하는 모듈을 지정합니다.
#[derive(Accounts)]: 명령어에 필요한 계정 목록을 나타내기 위해 구조체에 적용됩니다.
#[account]: 프로그램 특정 사용자 정의 계정 유형을 생성하기 위해 구조체에 적용됩니다. 참고: 필요에 맞게 함수를 수정하고 이동해야 할 수 있습니다.

프로그램 초기화

avm (Anchor Version Manager)을 사용하여 새 프로젝트를 초기화합니다(선택 사항). 초기화하려면 터미널에서 다음 명령을 실행하세요

anchor init create-core-collection-example

필수 Crate

이 가이드에서는 anchor 기능이 활성화된 mpl_core crate를 사용합니다. 설치하려면 먼저 create-core-collection-example 디렉토리로 이동하세요:

cd create-core-collection-example

그런 다음 다음 명령을 실행하세요:

cargo add mpl-core --features anchor

프로그램

임포트와 템플릿

여기서는 이 가이드에 필요한 모든 임포트를 정의하고 lib.rs 파일에 Account 구조체와 명령어의 템플릿을 생성합니다.

use anchor_lang::prelude::*;
use mpl_core::{
    ID as MPL_CORE_ID,
    instructions::CreateCollectionV2CpiBuilder,
};
declare_id!("C9PLf3qMCVqtUCJtEBy8NCcseNp3KTZwFJxAtDdN1bto");
#[derive(AnchorDeserialize, AnchorSerialize)]
pub struct CreateCollectionArgs {
}
#[program]
pub mod create_core_collection_example {
    use super::*;
    pub fn create_core_collection(ctx: Context<CreateCollection>, args: CreateCollectionArgs) -> Result<()> {
        Ok(())
    }
}
#[derive(Accounts)]
pub struct CreateCollection<'info> {
}

Args 구조체 생성

함수를 체계적으로 유지하고 너무 많은 매개변수로 인한 혼란을 피하기 위해 모든 입력을 구조화된 형식으로 전달하는 것이 표준 관행입니다. 이는 인수 구조체(CreateCollectionArgs)를 정의하고 AnchorDeserialize와 AnchorSerialize를 derive하여 구현됩니다. 이를 통해 구조체가 NBOR을 사용하여 바이너리 형식으로 직렬화되고 Anchor에서 읽을 수 있게 됩니다.

#[derive(AnchorDeserialize, AnchorSerialize)]
pub struct CreateCollectionArgs {
    name: String,
    uri: String,
}

이 CreateCollectionArgs 구조체에서 name과 uri 필드는 Core Collection을 생성하는 데 사용되는 CreateCollectionV2CpiBuilder 명령어의 인수로 사용될 입력으로 제공됩니다. 참고: 이것은 Anchor에 초점을 맞춘 가이드이므로 Uri를 생성하는 방법은 여기에 포함하지 않습니다. 방법을 모르는 경우 이 예제를 참조하세요

Account 구조체 생성

Account 구조체는 명령어가 기대하는 계정을 정의하고 이러한 계정이 충족해야 하는 제약 조건을 지정하는 곳입니다. 이는 타입과 제약 조건이라는 두 가지 주요 구성 요소를 사용하여 수행됩니다. 계정 타입 각 타입은 프로그램 내에서 특정 목적을 제공합니다:

Signer: 계정이 트랜잭션에 서명했는지 확인합니다.
Option: 제공되거나 제공되지 않을 수 있는 선택적 계정을 허용합니다.
Program: 계정이 특정 프로그램인지 확인합니다. 제약 조건 계정 타입이 기본적인 검증을 처리하지만 프로그램에 필요한 모든 보안 검사에 충분하지 않습니다. 여기서 제약 조건이 등장합니다. 제약 조건은 추가적인 검증 로직을 추가합니다. 예를 들어, #[account(mut)] 제약 조건은 collection과 payer 계정이 가변으로 설정되어 명령어 중에 이러한 계정 내의 데이터를 수정할 수 있음을 보장합니다.

#[derive(Accounts)]
pub struct CreateCollection<'info> {
    #[account(mut)]
    pub collection: Signer<'info>,
    /// CHECK: this account will be checked by the mpl_core program
    pub update_authority: Option<UncheckedAccount<'info>>,
    #[account(mut)]
    pub payer: Signer<'info>,
    pub system_program: Program<'info, System>,
    #[account(address = MPL_CORE_ID)]
    /// CHECK: this account is checked by the address constraint
    pub mpl_core_program: UncheckedAccount<'info>,
}

CreateCollection 구조체의 일부 계정은 optional로 표시됩니다. 이는 CreateCollectionV2CpiBuilder의 정의에서 특정 계정을 생략할 수 있기 때문입니다.

/// ### Accounts:
///
///   0. `[writable, signer]` collection
///   1. `[optional]` update_authority
///   2. `[writable, signer]` payer
///   3. `[]` system_program

예제를 최대한 유연하게 만들기 위해 프로그램 명령어의 모든 optional 계정은 create_core_collection 명령어의 계정 구조체에서도 optional로 처리됩니다.

명령어 생성

create_core_collection 함수는 이전에 정의한 CreateCollection 계정 구조체와 CreateCollectionArgs 인수 구조체의 입력을 활용하여 CreateCollectionV2CpiBuilder 프로그램 명령어와 상호작용합니다.

pub fn create_core_collection(ctx: Context<CreateCollection>, args: CreateCollectionArgs) -> Result<()> {
  let update_authority = match &ctx.accounts.update_authority {
      Some(update_authority) => Some(update_authority.to_account_info()),
      None => None,
  };

  CreateCollectionV2CpiBuilder::new(&ctx.accounts.mpl_core_program.to_account_info())
      .collection(&ctx.accounts.collection.to_account_info())
      .payer(&ctx.accounts.payer.to_account_info())
      .update_authority(update_authority.as_ref())
      .system_program(&ctx.accounts.system_program.to_account_info())
      .name(args.name)
      .uri(args.uri)
      .invoke()?;
  Ok(())
}

이 함수에서 CreateCollection 구조체에 정의된 계정은 ctx.accounts를 사용하여 액세스됩니다. 이러한 계정을 CreateCollectionV2CpiBuilder 프로그램 명령어에 전달하기 전에 .to_account_info() 메서드를 사용하여 원시 데이터 형식으로 변환해야 합니다. 이 변환은 빌더가 Solana 런타임과 올바르게 상호작용하기 위해 이 형식의 계정을 필요로 하기 때문에 필요합니다. CreateAsset 구조체의 일부 계정은 optional이므로 해당 값이 Some(account) 또는 None일 수 있습니다. 이러한 선택적 계정을 빌더에 전달하기 전에 처리하기 위해 계정이 존재하는지(Some) 없는지(None) 확인할 수 있는 match 문을 사용합니다. 이 검사를 기반으로 계정이 존재하면 Some(account.to_account_info())로, 없으면 None으로 바인딩합니다:

let update_authority = match &ctx.accounts.update_authority {
    Some(update_authority) => Some(update_authority.to_account_info()),
    None => None,
};

필요한 모든 계정을 준비한 후 CreateCollectionV2CpiBuilder에 전달하고 .invoke()를 사용하여 명령어를 실행하거나, signer seed가 필요한 경우 .invoke_signed()를 사용합니다. Metaplex CPI Builder 작동 방식에 대한 자세한 내용은 이 문서를 참조하세요

추가 작업

계속하기 전에, FreezeDelegate 플러그인이나 AppData 외부 플러그인과 같은 플러그인이나 외부 플러그인이 이미 포함된 에셋을 생성하려면 어떻게 해야 할까요? 방법은 다음과 같습니다. 먼저 필요한 모든 추가 임포트를 추가합니다:

use mpl_core::types::{
    Plugin, FreezeDelegate, PluginAuthority,
    ExternalPluginAdapterInitInfo, AppDataInitInfo,
    ExternalPluginAdapterSchema
};

그런 다음 플러그인과 외부 플러그인 어댑터를 보관할 벡터를 생성하여 올바른 임포트를 사용하여 플러그인을 쉽게 추가할 수 있습니다:

let mut plugins: Vec<PluginAuthorityPair> = vec![];
plugins.push(
  PluginAuthorityPair {
      plugin: Plugin::FreezeDelegate(FreezeDelegate {frozen: true}),
      authority: Some(PluginAuthority::UpdateAuthority)
  }
);
let mut external_plugin_adapters: Vec<ExternalPluginAdapterInitInfo> = vec![];

external_plugin_adapters.push(
  ExternalPluginAdapterInitInfo::AppData(
    AppDataInitInfo {
      init_plugin_authority: Some(PluginAuthority::UpdateAuthority),
      data_authority: PluginAuthority::Address{ address: data_authority },
      schema: Some(ExternalPluginAdapterSchema::Binary),
    }
  )
);

마지막으로 이러한 플러그인을 CreateCollectionV2CpiBuilder 프로그램 명령어에 통합합니다:

CreateCollectionV2CpiBuilder::new(&ctx.accounts.mpl_core_program.to_account_info())
  .collection(&ctx.accounts.collection.to_account_info())
  .payer(&ctx.accounts.payer.to_account_info())
  .update_authority(update_authority.as_ref())
  .system_program(&ctx.accounts.system_program.to_account_info())
  .name(args.name)
  .uri(args.uri)
  .plugins(plugins)
  .external_plugin_adapters(external_plugin_adapters)
  .invoke()?;

참고: 어떤 필드와 플러그인을 사용해야 할지 모르겠다면 문서를 참조하세요!

클라이언트

이제 Core Collection 생성 가이드의 "테스트" 부분에 도달했습니다. 하지만 우리가 구축한 프로그램을 테스트하기 전에 워크스페이스를 컴파일해야 합니다. 다음 명령을 사용하여 모든 것을 빌드하여 배포 및 테스트 준비를 합니다:

anchor build

빌드 후 스크립트로 접근할 수 있도록 프로그램을 배포해야 합니다. anchor.toml 파일에서 프로그램을 배포할 클러스터를 설정하고 다음 명령을 사용합니다:

anchor deploy

마지막으로 프로그램을 테스트할 준비가 되었지만, 그 전에 tests 폴더의 create_core_collection_example.ts에서 작업해야 합니다.

임포트와 템플릿

다음은 테스트에 필요한 모든 임포트와 일반 템플릿입니다.

import * as anchor from "@coral-xyz/anchor";
import { Program } from "@coral-xyz/anchor";
import { CreateCoreCollectionExample } from "../target/types/create_core_collection_example";
import { Keypair, SystemProgram } from "@solana/web3.js";
import { MPL_CORE_PROGRAM_ID } from "@metaplex-foundation/mpl-core";
describe("create-core-asset-example", () => {
  anchor.setProvider(anchor.AnchorProvider.env());
  const wallet = anchor.Wallet.local();
  const program = anchor.workspace.CreateCoreCollectionExample as Program<CreateCoreCollectionExample>;
  let collection = Keypair.generate();
  it("Create Collection", async () => {
  });
});

테스트 함수 생성

테스트 함수에서 createCollectionArgs 구조체를 정의한 다음 필요한 모든 계정을 createCoreCollection 함수에 전달합니다.

it("Create Collection", async () => {
  let createCollectionArgs = {
    name: 'My Collection',
    uri: 'https://example.com/my-collection.json',
  };
  const createCollectionTx = await program.methods.createCoreCollection(createCollectionArgs)
    .accountsPartial({
      collection: collection.publicKey,
      payer: wallet.publicKey,
      updateAuthority: null,
      systemProgram: SystemProgram.programId,
      mplCoreProgram: MPL_CORE_PROGRAM_ID
    })
    .signers([collection, wallet.payer])
    .rpc();
  console.log(createCollectionTx);
});

먼저 방금 생성한 createCollectionArgs 구조체를 입력으로 전달하여 createCoreCollection 메서드를 호출합니다:

await program.methods.createCoreCollection(createCollectionArgs)

다음으로 함수에 필요한 모든 계정을 지정합니다. 이러한 계정 중 일부는 optional이므로 계정이 필요하지 않은 곳에서는 간단히 null을 전달할 수 있습니다:

.accountsPartial({
  collection: collection.publicKey,
  payer: wallet.publicKey,
  updateAuthority: null,
  systemProgram: SystemProgram.programId,
  mplCoreProgram: MPL_CORE_PROGRAM_ID
})

마지막으로 서명자를 제공하고 .rpc() 메서드를 사용하여 트랜잭션을 보냅니다:

.signers([collection, wallet.payer])
.rpc();