Metaplex

AnchorでCore Collectionを作成する方法

Last updated January 31, 2026

このガイドでは、mpl-core Rust SDKクレートを使用して、SolanaプログラムのAnchorフレームワークでCPIを介してCore NFT Collectionを作成する方法を説明します。

Coreとは？

Coreは単一アカウント設計を使用し、代替品と比較してミントコストを削減し、Solanaネットワークの負荷を改善します。また、開発者がアセットの動作と機能を変更できる柔軟なプラグインシステムも備えています。

始める前に、Collectionsについて話しましょう：

Collectionsとは？

Collectionsは、同じシリーズやグループに属するAssetsのグループです。Assetsをグループ化するには、まずコレクション名やコレクション画像などのコレクションに関連するメタデータを保存することを目的としたCollection Assetを作成する必要があります。Collection Assetはコレクションの表紙として機能し、コレクション全体のプラグインも保存できます。

前提条件

  • 任意のコードエディタ（Rust Analyzer Pluginを使用したVisual Studio Codeを推奨）
  • Anchor 0.30.1以上

初期セットアップ

このガイドではAnchorを使用し、必要なすべてのマクロがlib.rsファイルにあるモノファイルアプローチを採用しています：

  • declare_id: プログラムのオンチェーンアドレスを指定
  • #[program]: プログラムの命令ロジックを含むモジュールを指定
  • #[derive(Accounts)]: 命令に必要なアカウントのリストを示す構造体に適用
  • #[account]: プログラム固有のカスタムアカウントタイプを作成するために構造体に適用 注意: 必要に応じて関数を変更および移動する必要がある場合があります。

プログラムの初期化

avm（Anchor Version Manager）を使用して新しいプロジェクトを初期化します（オプション）。初期化するには、ターミナルで以下のコマンドを実行します

anchor init create-core-collection-example

必要なクレート

このガイドでは、anchor機能を有効にしたmpl_coreクレートを使用します。インストールするには、まず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を派生させることで実現されます。これにより、構造体はNBORを使用してバイナリ形式にシリアライズでき、Anchorで読み取り可能になります。

#[derive(AnchorDeserialize, AnchorSerialize)]

pub struct CreateCollectionArgs {

    name: String,

    uri: String,

}

このCreateCollectionArgs構造体では、nameとuriフィールドが入力として提供され、Core Collectionを作成するために使用されるCreateCollectionV2CpiBuilder命令の引数として機能します。 注意: これはAnchorに焦点を当てたガイドであるため、Uriの作成方法はここには含まれていません。方法がわからない場合は、この例を参照してください

Account構造体の作成

Account構造体は、命令が期待するアカウントを定義し、これらのアカウントが満たす必要のある制約を指定する場所です。これは、タイプと制約という2つの主要な構成要素を使用して行われます。 アカウントタイプ 各タイプはプログラム内で特定の目的を果たします：

  • 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のいずれかになる可能性があります。これらのオプションアカウントをビルダーに渡す前に処理するために、match文を使用します。これにより、アカウントが存在する（Some）か存在しない（None）かを確認でき、このチェックに基づいて、存在する場合は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()を使用して命令を実行するか、署名者シードを使用する必要がある場合は.invoke_signed()を使用します。 Metaplex CPIビルダーの動作の詳細については、このドキュメントを参照してください

追加アクション

次に進む前に、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);

});

createCoreCollectionメソッドを呼び出し、作成したcreateCollectionArgs構造体を入力として渡すことから始めます：

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();
Next
概要