【完全保存版】SolanaでMetaplexを使ったゲームプログラムを作ってみよう！
この記事は、こちらのプログラムの解説を行っています。
ドラクエで敵を倒すようなゲームです。
なお、実行時に、この部分をご自身のアドレスにする必要がありますので、ご注意ください。
１ ミントアカウント作成に必要なアカウント
まずはミントアカウントを作成する「createMint」に必要なアカウントを見てみましょう。
１ 管理者アカウント
まず、管理者アカウントが必要です。
「Signer」となっているので署名者です。
まだ、addressの制約が入っています。
事前に設定している、「ADMIN_PUBKEY」と一致しているかのチェックが行われます。
２ 報酬用のミントアドレス
次は、報酬用のミントアドレスです。
seeds = [b"reward"]が設定されているので、PDAです。
ちなみに、「mint::decimals」「mint::authority」が設定されています。
こちらで桁数や権限者のチェック、もしくは作成する場合の情報として使っています。
３ ミントアカウントのメタデータ
そして、ミントアカウントのメタデータも設定しています。
「address=」でアドレスの指定を行っています。
では、どのアドレスを指定しているのか、「find_metadata_account」関数を見てみましょう。
中身は、こちらの「Pubkey」に実装されている、「find_program_address」という関数でした。
シードとプログラムIDを指定して、PDAを見つけてくれます。
ここはとても大事なところだと思いますが。
Metaplexのメタデータアカウントに使われるシードが確認できます。
このようになっています。
ちなみに、具体的なIDはこちらから確認ができます。
そして、最後にプログラムIDを設定していますね。
２ ミントアカウントの作成
では、具体的に「create_mint」関数を見てみましょう。
１ シード等の取得
まずは、PDAに必要なシード、バンプ、署名者を取得しています。
２ データの設定
次に、dataは「DataV2」の型が必要です。
こちらは後に出てくる、「create_metadata_accounts_v3」がデータとして、「DataV2」の型を求めているためです。
こちらを使用しています。
３ CpiContextの作成
次に、CpiContextを作成しています。
今回は呼び出しもとが「報酬用ミントアカウント」であり、PDAなので「new_with_signer」を使用しています。
また、アカウントとしては「createMetadataAccountsV3」を使用しています。
これによって、CpiContextの型を「CreateMetadataAccountsV3」にしています。
その名の通り、メタデータアカウントを作りたいのですね。
ちなみに、こちらもご参照ください。
４ メタデータアカウントの作成
これで、準備ができたので、「create_metadata_accounts_v3」でメタデータを作成します。
なお、ここで指定する「cpi_context」が「CreateMetadataAccountsV3」の型である必要があります。
dataは「DataV2」の型である必要があります。
ドキュメントはこちらです。
３ プレイヤーの初期化
では他の関数も見てみましょう。
こちらの「init_player」でプレイヤーの体力を全快にしています。
ちなみに、「player_data」というアカウントは「player」という文字列と「playerの公開鍵」の２つのシードを取るPDAです。
そして、「health」という値を持っています。
４ 敵の撃退
次に敵を撃退する関数を見てみましょう。
０ 概要
この関数の概要は、まず体力チェックを行い、０になっていないかを確認します。
その上で、体力を10減らし、報酬用トークンを配布します。
１ 体力のチェック
まずは体力をチェックし、０であれば、エラーを返しています。
２ 体力の削減
次に、「checked_sub()」を使って、体力を10減らしています。
きっと戦ったからですね。
ちなみに、「checked_sub」はアンダーフローを監視してくれます。
もしアンダーフローになった場合は、Noneを返します。
３ トークンのミント準備① シード等の取得
後に、PDAによるCPIを実行したいので、シードなどの必要なものを取得しています。
今回は報酬用ミントアカウント用のシードなどを取得しています。
４ トークンのミント準備② CpiContextの作成
下のようにして、CpiContextを作成しています。
PDAによる実行なので、「new_with_signer」を使います。
このCpiContextはミント用なので、アカウントは「MintTo」という型を使用しています。
ドキュメントはこちらです。
５ ミント量の設定
では、ミント量も設定しましょう。
「１トークン」なのですが、最小単位（10の9乗など）をかけてあげる必要があります。
下のようにして、「u64」の型の１に10の桁数乗をかけています。
「checked_mul」でオーバーフロー、もしくはアンダーフローのチェックを行っています。
「pow」では◯乗の部分を設定しています。
例の2の５乗が32になっているのがわかりやすいですね。
６ ミントの実行
最後に、「mint_to」でミントを実行しています。
こちらのドキュメントのように、「MintTo」の型のCpiContextとamountを設定しています。
５ 回復
次に、回復を行う関数を見てみましょう。
０ 概要
この関数の流れとしては、２つです。
まず、体力を全回復させます。
その上で、トークンをバーンさせます。
このトークンはドラクエで言うところの「世界樹のしずく」みたいなものでしょうか。（最もキャラクターは1人ですが。）
１ 回復
プレイヤーの体力をマックスにしています。
２ トークンのバーン準備 CpiContextの作成
下のようにして、「Burn」 の型の「CpiContext」を作成しています。
先ほどの、「new_with_signer」でないのは、実行するのがPDAではなく、署名者だからです。
自分が持っているトークンをバーンします。
３ バーン量の設定
これは、敵の撃退の時と同じですね。
「checked_mul」でオーバーフローとアンダーフローをチェックしています。
「pow」では10の◯乗を設定しています。
４ バーンの実行
最後に、CpiContextとamountを使って、バーンをしています。
こちらが、バーンですが、「mint_to」と基本同じですね。
説明は以上となります。
よかったらやってみてください。
いいなと思ったら応援しよう！
