lesson-2_Polygon上にコントラクトをデプロイしてみよう

🦉 Polygon に スマートコントラクトをデプロイする

このレッスンでは、プロジェクトをPolygonネットワークにコントラクトをデプロイする方法を紹介します。

手順はほかのイーサリアムのサイドチェーン(例：Plasma)とほぼ同じです。

まず、packages/contractディレクトリに向かい、下記を修正していきましょう。

1 . .envファイルを下記のように修正してください。

API_URL = ""
PRIVATE_KEY = "あなたの秘密鍵は、以前に貼り付けたものを保持してください。"
ETHERSCAN_API = ""
POLYGON_URL = ""

今回の実装では、API_URL（Alchemy API）は必要ないので、空文字列""を設定してください。

• ただし削除しないでください、設定ファイルが壊れてしまいます。

ETHERSCAN_APIとPOLYGON_URLは現段階では、空文字列""にしておきます。

2 . hardhat.config.jsを開き、コードを下記のように更新しましょう。

require("@nomicfoundation/hardhat-toolbox");
require("@nomiclabs/hardhat-etherscan");
require("dotenv").config();

const { API_URL, PRIVATE_KEY, ETHERSCAN_API, POLYGON_URL } = process.env;

module.exports = {
  solidity: "0.8.17",
  networks: {
    amoy: {
      url: POLYGON_URL,
      accounts: [PRIVATE_KEY],
    },
  },
  etherscan: {
    apiKey: ETHERSCAN_API,
  },
};

3 . 最後に、ターミナルで以下のコマンドを実行します。

yarn contract run:script

ターミナル上で、上記がエラーなく実行されれば、Polygonネットワークにコントラクトをデプロイする準備は完了です。

🧙‍♂️ テストを作成・実行する

ここまでの作業でコントラクトには基本機能として以下の機能が追加されました。

• NFTをmintする機能
• nftをコントラクト所有者にためにキープする機能
• コントラクトにETHを送金できる機能

これらの基本機能をテストスクリプトとして記述していきましょう。 ではpackages/contract/testにtest.jsという名前でファイルを作成して、以下のように記述しましょう。

const hre = require("hardhat");
const { expect } = require("chai");

describe("Generative-NFT", () => {
  it("mint is successed", async () => {
    // あなたのコレクションの Base Token URI（JSON の CID）に差し替えてください
    const baseTokenURI =
      "ipfs.io/ipfs/QmZbWNKJPAjxXuNFSEaksCJVd1M6DaKQViJBYPK2BdpDEP/";

    // オーナー/デプロイヤーのウォレットアドレスを取得する
    const [owner] = await hre.ethers.getSigners();

    // デプロイしたいコントラクトを取得
    const contractFactory = await hre.ethers.getContractFactory(
      "NFTCollectible"
    );

    // 正しいコンストラクタ引数（baseTokenURI）でコントラクトをデプロイします。
    const contract = await contractFactory.deploy(baseTokenURI);

    // このトランザクションがマイナーに承認（mine）されるのを待つ
    await contract.deployed();

    // NFTを 10 点、コントラクト所有者のためにキープできているかチェック
    let txn = await contract.reserveNFTs();
    await txn.wait();
    let tokens = await contract.tokensOfOwner(owner.address);
    expect(tokens.length).to.equal(10);

    // 0.03 ETH を送信して3つ NFT を mint できるかチェック
    txn = await contract.mintNFTs(3, {
      value: hre.ethers.utils.parseEther("0.03"),
    });
    await txn.wait();
    tokens = await contract.tokensOfOwner(owner.address);
    expect(tokens.length).to.equal(13);
  });
});

では下のコマンドを実行することでコントラクトのテストをしていきましょう！

yarn test

下のような結果がでいれば成功です！

Compiled 17 Solidity files successfully


  Generative-NFT
    ✔ mint is successed (1552ms)


  1 passing (2s)

✨  Done in 5.30s.

🕵️‍♂️ NFT 価格の再設定

私たちは、NFTの基本価格を0.01 ETHに設定しました。

uint public constant PRICE = 0.01 ether;

ここでは、ユーザーはNFTをMintするたびにガス代 + 0.01 ETHを支払います。

ですが、Polygonサイドチェーンで使用されるのはETHではなく、MATICという独自のERC20トークンです。

✍️: ERC20 トークンについて ERC20 は、イーサリアムのブロックチェーンを利用したトークンに適用される仕様です。

イーサリアムネットワーク上では、誰でもオリジナルの仮想通貨（トークン）を作ることができます。

ただし、トークンの仕様（プログラミング言語など）が異なる場合、そのトークンのために独自のウォレットの開発が必要になります。

ERC20 に準拠しているトークンは、MetaMask のような既存のウォレットで管理することができます。

現在（2022年2月）、ETHとMATICを日本円に換算すると以下のようになります。

1 ETH    ≒  340,000円
1 MATIC  ≒  200 円

したがって、ETHで表記したNFT 1つあたりの価格（0.01 ETH）をMATICに換算すると、17 MATICとなります。

この変更を反映させるために、NFTCollectible.solの価格表記を下記のように更新しましょう。

// NFTCollectible.sol
uint public constant PRICE = 17 ether;

ここで、PRICEを17 MATICと表記しないのには、理由があります。

Solidity では、etherというキーワードは10¹⁸に過ぎません。

• Solidityにとって、17 etherは下記と同じです。

  // 17 * 10¹⁸
  1700000000000000;

実際にSolidityではWeiという単位で支払い金額を指定しています。

イーサリアムメインネットでは、1 ETHは10¹⁸ Weiです。

Polygonでは、10¹⁸ Weiが1 MATICです。

✍️: WeiとGwei イーサリアムのガス代（コスト）は、下記で決まります。

コスト = ガス価格（ Gas Price ） x 消費したガスの量（ Gas limit & Usage by Txn ）

Gweiはガス価格の単位、Weiはイーサリアムの最小単位となります。

異なるネットワークにコントラクトを移行する場合は、常に価格の修正を正しく行うようにしましょう。

このレッスンでは、Polygon Amoy-Testnetを使用するので、NFTの価格を0.01 MATICにします。

そこで、NFTの価格を元通りにリセットすることにします。

下記のように、NFTCollectible.solの価格をもう一度書き換えてください。

uint public constant PRICE = 0.01 ether;

⚠️: 注意

Polygon ネットワークにデプロイする場合、0.01 etherは0.01 MATICです。0.01 ETHではありません。

🦊 MetaMask と Hardhat に Polygon Network を追加する

MetaMaskウォレットにMatic MainnetとPolygon Amoy-Testnetを追加してみましょう。

1 . Matic Mainnet を MetaMask に接続する

Matic MainnetをMetaMaskに追加するには、次の手順に従ってください。

まず、Polygonscan に向かい、ページの一番下までスクロールして、Add Polygon Networkボタンをクリックします。

下記のようなポップアップが立ち上がったら、Switch Networkをクリックしましょう。

Matic MainnetがあなたのMetaMaskにセットアップされました。

2 . Polygon Amoy-Testnet を MetaMask に接続する

Polygon Amoy-TestnetをMetaMaskに追加するには、次の手順に従ってください。

まず、amoy.polygonscan.com に向かい、ページの一番下までスクロールして、Add Amoy Networkボタンをクリックします。

Matic Mainnetを設定した時と同じ要領でPolygon TestnetをあなたのMetaMaskに設定してください。

Hardhatを使用する場合、AlchemyのカスタムRPC URLが必要です。

alchemy.com に再度ログインして、Create Appを選択し、下記のように設定してください。

次に、下図のように、新しく作成したPolygon NFTアプリケーションのVIEW DETAILSをクリックしましょう。

次に、アプリケーションのVIEW KEYをクリックし、HTTP URLをコピーしてください。

それでは、packages/contract/.envファイルを開き、コピーしたHTTP URLを下記のAlchemy Polygon URLの部分に貼り付けていきます。

POLYGON_URL = "Alchemy Polygon URL";

🚰 偽 MATIC を入手する

MetaMaskとHardhatの両方でPolygonネットワークの設定が完了したら、偽のMATICを取得していきましょう。

こちら にアクセスして、下記のように偽MATICをリクエストしてください。

Sepoliaとは異なり、これらのトークンの取得にそれほど問題はないはずです。

1回のリクエストで0.5 MATIC（偽）が手に入るので、2回リクエストして、1 MATIC入手しましょう。

⚠️: Polygon のメインネットワークにコントラクトをデプロイする際の注意事項

Polygon のメインネットワークにコントラクトをデプロイする準備ができたら、本物の MATIC を入手する必要があります。

これには 2 つの方法があります。

1. イーサリアムのメインネットで MATIC を購入し、Polygon のネットワークにブリッジする。

2. 仮想通貨の取引所（ WazirX や Coinbase など）で MATIC を購入し、それを直接 MetaMask に転送する。

Polygon のようなサイドチェーンの場合、2の方が簡単で安く済みます。

🇮🇳 Polygon テストネットにコントラクトをデプロイする

準備完了です!

packages/contract/scriptsに向かい、deploy.jsを下記のように更新してください。

async function main() {
  // あなたのコレクションの Base Token URI（JSON の CID）に差し替えてください
  // 注: 十分な NFT を確保するために、下記のサンプル Token URI を使用しても問題ありません。
  const baseTokenURI = "ipfs://QmZbWNKJPAjxXuNFSEaksCJVd1M6DaKQViJBYPK2BdpDEP/";

  // オーナー/デプロイヤーのウォレットアドレスを取得する
  const [owner] = await hre.ethers.getSigners();

  // デプロイしたいコントラクトを取得
  const contractFactory = await hre.ethers.getContractFactory("NFTCollectible");

  // 正しいコンストラクタ引数（baseTokenURI）でコントラクトをデプロイします。
  const contract = await contractFactory.deploy(baseTokenURI);

  // このトランザクションがマイナーに承認（mine）されるのを待つ
  await contract.deployed();

  // コントラクトアドレスをターミナルに出力
  console.log("Contract deployed to:", contract.address);

  // 所有者の全トークンIDを取得
  let tokens = await contract.tokensOfOwner(owner.address);
  console.log("Owner has tokens: ", tokens);
}

main()
  .then(() => process.exit(0))
  .catch((error) => {
    console.error(error);
    process.exit(1);
  });

まずは、packages/contract/package.jsonのscript部分を以下のように編集してください。

  "scripts": {
    "run:script": "npx hardhat run scripts/run.js",
    "deploy:sepolia": "npx hardhat run scripts/deploy.js --network sepolia",
    "deploy:amoy": "npx hardhat run scripts/deploy.js --network amoy",
    "test": "npx hardhat test"
  },

ターミナル上で下記を実行してみましょう。

yarn contract deploy:amoy

下記のような結果がターミナルに出力されていることを確認してください。

Contract deployed to: 0xF899DeB963208560a7c667FA78376ecaFF684b8E
Owner has tokens:  []

次に、amoy.polygonscan.com に向かい、コントラクトアドレス(Contract deployed toに続く0x..)を検索して、コントラクトがデプロイされたことを確認しましょう。

📝 Polygonscan を使ってコントラクトを verify（検証）する

最後に、Polygonscanで コントラクトの Verification（検証） を行い、ユーザーがPolygonscanから直接あなたのNFTをMintできるようにしましょう。

まず、Polygonscan に向かい、アカウントを作成しましょう。

次に、APIの作成に進みます。下図のように、API-Keysのタブを選択し、+ Addボタンを押してください。

ポップアップが開くので、APIに任意の名前をつけて、保存しましょう。

APIを作成したら、そのAPIのEditボタンをクリックしてください。

下記の画面に遷移するので、Polygon-API-Keyをコピーしましょう。

最後にもう一度packages/contract/.envファイルを開き、下記にコピーしたPolygon-API-Keyの値を貼り付けます。

ETHERSCAN_API = "Polygonscan-API-key";

PolygonscanはEtherscanを搭載しているため、ETHERSCAN_APIという変数名は前回のレッスンで使用したものを残しています。

下記のDEPLOYED_CONTRACT_ADDRESSと"BASE_TOKEN_URI"をあなたのものに更新したら、ターミナルで実行していきましょう。

npx hardhat clean

npx hardhat verify --network amoy DEPLOYED_CONTRACT_ADDRESS "BASE_TOKEN_URI"

• DEPLOYED_CONTRACT_ADDRESSはあなたのコントラクトアドレスです。

• "BASE_TOKEN_URI"は、deploy.jsに記載されているものと同一である必要があります。

私のコマンドは下記のようになります。

npx hardhat verify --network amoy 0xF899DeB963208560a7c667FA78376ecaFF684b8E "ipfs://QmSvw119ALMN9SkP89Xj37jvqJik8jZrSjU5c1vgBhkhz8/"

下記のような結果がターミナルに出力されていることを確認してください。

Compiling 15 files with 0.8.17
Solidity compilation finished successfully
Compiling 1 file with 0.8.17
Successfully submitted source code for contract
contracts/NFTCollectible.sol:NFTCollectible at 0xF899DeB963208560a7c667FA78376ecaFF684b8E
for verification on the block explorer. Waiting for verification result...

Successfully verified contract NFTCollectible on Etherscan.
https://amoy.polygonscan.com/address/0xF899DeB963208560a7c667FA78376ecaFF684b8E#code

出力されたhttps://amoy.polygonscan.com/address/0x...のリンクをブラウザで開いてコントラクトの中身がオンラインで読み込めるか検証してみましょう。

無事コントラクトの中身がPolygonscanに表示されていたでしょうか？

コントラクトがverifyされると、誰でもPolygonscan上で関数を呼び出して、あなたのNFTをMintできます。

🙋‍♂️ 質問する

ここまでの作業で何かわからないことがある場合は、Discordの#polygonで質問をしてください。

ヘルプをするときのフローが円滑になるので、エラーレポートには下記の3点を記載してください ✨

1. 質問が関連しているセクション番号とレッスン番号
2. 何をしようとしていたか
3. エラー文をコピー&ペースト
4. エラー画面のスクリーンショット

---

おめでとうございます!　セクション3は終了です!

ぜひ、あなたのPolygonscanリンクを#polygonに投稿してください 😊

コミュニティであなたの成功を祝いましょう 🎉

次のレッスンでは、フロントエンドを構築していきます。