【保存版】ImmutableXでNFTを作成してみませんか？（ImmutableX超入門）
０ー１ はじめに
こんにちは、CryptoGamesの高橋です。
クリスペの会社です。
皆さん、ゼロ知識証明を用いたImmutableXにはご興味がありますか？
私はとても興味があります。
もしより深く知ってみたい場合は、ぜひこちらもご参照ください。
ImmutableXでのNFTの作成方法については、実は公式で詳細に書かれておりました。
「START BUILDING」から
「docs here」に行って
こちらの「Onboarding」からが具体的な説明になってきます。
英語ではありますが、とてもわかりやすく書かれておりますので、ぜひ読んでみてください。
０ー２ ImmutableXキーを設定しよう
イメージをつかむためにも、先にサイトを見るのも良いかもしれません。
ちなみに、流れとしましては、次のようになります
① ウォレット接続をする
② ①で接続したウォレットでサインインする
③ ImmutableXキーを設定する
０ー２ー１ ウォレット接続する
「connect wallet」でウォレット接続を行います。
０ー２ー２ 接続ウォレットでサインインする
下のように「sign in」でサインインします。
ちなみに、こちらに書かれているように、サインのリクエストは私たちがアクションを初期化したときにだけ行われるようです。
つまり、何も変更などを行っていないときにサインのリクエストが行われた場合は、何かおかしいことはないか考える必要があると思います。
０ー２ー３ ImmutableXキーを設定する
この設定で、ImmutableXキーとウォレットがリンクするようです。
利用規約に同意が出来る場合は、チェックを入れて、「Set up」を行いましょう。
これで設定が完了しました。
また、「重要」として、サインリクエストはアクションの初期化を行ったときにのみ行われると書かれています。
セキュリティ上、安易に「サイン」を行わないよう、ご注意ください。
では、次の章から具体的な作成に移っていきます。
１ VScodeをインストールしましょう。
もちろん、VScodeでなくても大丈夫です。
エディタ（コードを便利に操作するもの）を利用したことがなければ、VScodeをインストールしてみてください。
２ テスト用のコントラクトを作ろう
２ー１ 普通のコントラクトとは何が違うの？
まずはImmutableX用のコントラクトを作る必要があります。
実は「mintFor()」という特別な関数が必要になります。
でも大丈夫です。公式でサンプルが既に用意されています。
今回は、「Ropsten」というテストネットで作っていきます。
２ー２ 公式のサンプルをクローンする
こちらのコントラクトをgit cloneしてください。
（２ー２ー６までは、普段コードを触っていない方向けの詳細です。エンジニアの方などは飛ばしてください。）
２ー２ー１ 作業用のフォルダを作る
任意の場所に作業用のフォルダを作ってください。
２ー２ー２ VScodeで作業用のフォルダを指定する
VScodeを開き、下のように行って、作業用のフォルダを指定してください。
２ー２ー３ ターミナルを開く
下のようにして、ターミナル（コマンドプロンプト）を開いてください。
２ー２ー４ githubでレジストリをコピーする
上のサイトに行き、下のようにコピーを行います。
２ー２ー５ git clone する
下のように、「git clone 」の後に上でコピーしたものを貼り付け、「Enter」を押します。
２ー２ー６ 確認しましょう
下のように、フォルダができれば成功です。
２ー３ EtherscanのAPIキーを取得する。
次のステップでEtherscanのAPIキーが必要になりますので、ここで取得しましょう。
２ー３ー１ Etherscanに登録する
まずはEtherscanを登録しましょう。
今回は、こちらのフリープランで進めていきます。
２ー３ー２ APIキーを取得する
ここの「+ Add」を選択して
プロジェクトの名前をつけたら、
こんな感じで取得できました。
こちらは外に漏れたら、勝手に使われてしまいますので、厳重に保管してください。
２ー４ 環境変数を設定する
実際に行く前に、下を必ずお読みください。
注意
「.env」の扱いには十分注意してください。
特に、あまりプログラミングに慣れていない方などは、例えばテスト用のアカウントの秘密鍵で実施するなど、十分に注意してください。
（私は以下、テスト用のアカウントで実施しています。）
２ー４−１ .envファイルを作る
「imx-contracts」 の中にある「.env.example」をコピーして「.env」という名前のファイルを作成します。
２ー４ー２ 環境変数を設定する
自分が作りたいコントラクト名など、下の５つを環境変数として、入れていきます。
①コントラクトの所有者アドレス
⇨ CONTRACT_OWNER_ADDRESS
②コントラクトの名前
⇨ CONTRACT_NAME
③コントラクトのシンボル名
⇨ CONTRACT_SYMBOL
④EtherscanのAPIキー（上で取得）
⇨ ETHERSCAN_API_KEY
⑤秘密鍵（厳重に扱ってください！）
⇨ DEPLOYER_ROPSTEN_PRIVATE_KEY (MAINNETも)
２ー５ テスト用のEthe（Ropsten）を取得する
上のサイトなどから、テスト用のEtherが取得できます。
取得してみてください。
２ー６ コントラクトをデプロイしよう
２ー６ー１ yarn add を行う
次のコマンドで、依存関係（必要となるもの一式）をインストールしてください。
yarn add @imtbl/imx-contracts
２ー６ー２ コントラクトをデプロイする
下のように、「imx-contracts」フォルダに行ってから
cd imx-contracts 下のように、デプロイを行います。
yarn hardhat run deploy/asset.ts --network ropstenすると、次のようにコントラクトがデプロイされました。
（この時点でエラーが出た場合は、「.envファイル」の書き方を見直してみましょう。）
そして、コントラクトをデプロイするから５分待ってと表示されます。
２ー６ー３ エラーが出ますが、心配しないで
待っていると、こんな風にエラーが出てきます。
でも読んでみると、「すでに検証されているから」と出ました。
よく考えると、このImmutableXのコントラクトは既にたくさんの方が同じように作成しているはずです。
そのため、もう検証済みだよというエラーが出たようです。
２ー６ー４ Etherscanで見てみよう
念の為、Etherscanで見てみましょう。
「Ropsten」になりますのでご注意ください。
このようにデプロイされたコントラクトを検索すると。
このように検証済みのコントラクトができたことがわかりました。
３ コントラクトを登録する
では、コントラクトができましたので、これをImmutableXに登録していきましょう。
３ー１ 事前準備を行う。
３ー１ー１ git cloneを行う
第２章とは別の場所に次のレポジトリをgit cloneしてみましょう。（私は一つ上の階層にしました。）
やり方の詳細につきましては、２ー２をご参考ください。
git clone git@github.com:immutable/imx-examples.git
３ー１ー２ 「.env」ファイルを作り、環境変数を入れる
注意
「.env」の扱いには十分注意してください。
特に、あまりプログラミングに慣れていない方などは、例えばテスト用のアカウントの秘密鍵で実施するなど、十分に注意してください。
（私は以下、テスト用のアカウントで実施しています。）
やり方は２ー４と同様です。
「.env.example」をコピーして、「.env」ファイルを作り、今回はPrivate Key（秘密鍵）とコントラクトアドレスを入れます。
３ー１ー３ npm installを行う。
「imx-examples」フォルダに移動して、次のコマンドを実行します。
npm install 
３ー２ ユーザー登録を行おう
では、次に、こちらのコマンドでユーザー登録を行います。
npm run onboarding:user-registration
私は既に作成済みのため、「User already exists」と出ますが、このように、アカウントができました。
３ー３ プロジェクトを作成する
次はプロジェクトを作成します。
まずは、「2-create-project.ts」の下の箇所にプロジェクト名などを入れていきます。
できましたら、次のコマンドを実行します。
npm run onboarding:create-project
プロジェクトができ、プロジェクトIDも振られました。
３ー４ コレクションを追加する
では次に、できたプロジェクトにコレクションを追加していきます。
一つのプロジェクトにコレクションは複数作成することができます。
３ー４ー１ プロジェクトIDを設定する
まずは「.env」ファイルに先ほどできたプロジェクトIDを設定しましょう。
３ー４ー２ コレクションの情報を設定する
こちらにコレクションの情報を入れていきます。
「metadata_api_url」はとても大事な情報ですが、ImmutableXに特有のものではないので詳細は割愛します。
ざっくりと、このようにダブルクォーテーション（"）で区切られて値が格納されています。（JSON形式）
URLの末尾の数値が変わると中の情報も変わります。
今回はテストとして、OpenSeaのメタデータを用います。
https://opensea-creatures-api.herokuapp.com/api/creature
他にも入れて、上のようになりました。
設定が完了しましたので、次のコマンドを実行します。
npm run onboarding:create-collection
これでコレクションが追加されました。
３ー５ メタデータのスキーマ（構成）を追加する
今回こちらは省略しますが、ユーザーが検索する際に非常に役に立ちます。
下の場所に追加していくことになります。
なお、この部分につきましては、記事を別に作ろうと思います。
今回は、特に内容は変えずに、次のコマンドを実行します。
npm run onboarding:add-metadata-schema
これでメタデータのスキーマも追加できました。
４ ミントを行おう
４ー１ ミント情報を設定する
まずはミントの情報を入力しましょう。
「.env」ファイルに次のように入力していきましょう。
４ー２ ミントを実行しよう
設定ができましたら、次のコマンドを実行しましょう。
npm run bulk-mint -- -n 20 -w <YOUR_WALLET_ADDRESS>
これで指定したウォレットに指定した番号分、ミントができました。
５ ImmutableXのテストネットを見てみよう
ImmutableXのテストネットを見てみましょう。
「Inventory」を見てみると、このようにNFTが出来ていました！
６ マーケットプレイスに展示しよう
では、値段をつけて、マーケットプレイスに展示しましょう。
売りたいものを選んで、「List for sale」
どの通貨でいくらで売るかを記載して、「Confirm」
同様の手順でいくつか実施を行い、マーケットプレイスを確認すると、このように、展示されていました。
いかがでしたでしょうか。
今回の記事はあくまでも入門編になります。
公式のドキュメントは英語ですが、とても大事なことがたくさん書かれていますので、よかったらそちらも見てみてください。
では、今回は以上です。
最後までお読みいただきありがとうございました。
サポートをしていただけたらすごく嬉しいです😄 いただけたサポートを励みに、これからもコツコツ頑張っていきます😊