Ethers.jsを使用してスマートコントラクトと対話する方法は？

Ethers.jsは、Ethereum Smart Contractsと対話するために使用されるJavaScriptライブラリであり、開発者がノードに接続し、データを読み取り、トランザクションを安全かつ効率的に送信できるようにします。

2025/07/29 09:01

スマートコントラクトとは何ですか、そしてなぜethers.jsを使用するのですか？

スマート契約とは、コードに直接書かれた契約の条件との自己執行契約です。これらの契約は、Ethereumブロックチェーンで実行され、開発者が仲介者なしで動作する分散型アプリケーション（DAPP）を作成できるようにします。これらの契約とプログラムでやり取りするために、開発者はしばしばEthers.jsを使用します。これは、Ethereumブロックチェーンと対話するための包括的なツールセットを提供する軽量JavaScriptライブラリです。

Ethers.JSは、Ethereumノードへの接続、トランザクションの署名、スマート契約関数の呼び出しなどのタスクを簡素化します。読み取りおよび書き込み操作の両方をサポートしているため、イーサリアムベースのアプリケーションに取り組む開発者にとって好ましい選択肢となります。

開発環境のセットアップ

Ethers.jsを使用してスマートコントラクトと対話する前に、開発環境が適切に構成されていることを確認してください。必要です：

• Node.jsはシステムにインストールされています
• NPMや糸のようなパッケージマネージャー
• ローカルまたはリモートのイーサリアムノード（例えば、インフラまたは錬金術）
• ターゲットスマートコントラクトのABI （アプリケーションバイナリインターフェイス）
• 契約アドレス

新しいプロジェクトを初期化してEthers.jsをインストールすることから始めます。

 mkdir my-ethers-project
 cd my-ethers-project
 npm init -y
 npm install ethers

インストールしたら、JavaScriptコードの書き込みを開始してEthereum Networkに接続し、契約と対話できます。

Ethereumプロバイダーへの接続

スマートコントラクトと対話するには、最初にイーサリアムノードに接続する必要があります。 Ethers.jsは、 JSONRPCProvider 、 Infuraprovider 、 Alchemyproviderなど、いくつかのプロバイダーオプションを提供します。

Infuraを使用して接続する方法は次のとおりです。

 const { ethers } = require('ethers'); const infuraurl = 'https://mainnet.infura.io/v3/your_infura_project_id';
 const provider = new Ethers.jsonrpcprovider（infuraurl）;

YOUR_INFURA_PROJECT_ID実際のInfuraプロジェクトIDに置き換えます。このプロバイダーを使用すると、ブロックチェーンデータをクエリしてトランザクションを送信できます。

ローカルノードを使用している場合は、次のように接続できます。

 const provider = new ethers.JsonRpcProvider('http://localhost:8545');

この接続は、契約状態を読み取り、トランザクションをネットワークに送信するために不可欠です。

スマートコントラクトインターフェイスのロード

スマートコントラクトと対話するには、利用可能な機能とイベントを定義するABIが必要です。 ABIは通常、JSONアレイとして提供されます。スクリプトにロードして、 Ethers.contractで使用できます。

ABIを含むMyContract.jsonという名前のJSONファイルがあると仮定します。

 const contractABI = require('./MyContract.json');
 const contractAddress = '0x...'; // Replace with your contract address const contract = new Ethers.Contract（ContractAddress、ContractAbi、Provider）;

これにより、関数を呼び出して契約によって放出されるイベントを聞くことができる契約インスタンスが作成されます。

トランザクションを送信する予定（つまり、状態を変更する機能を呼び出す）を計画している場合は、署名者を契約インスタンスに添付する必要があります。

スマートコントラクトにトランザクションを送信します

トークンのメントや変数の更新など、スマートコントラクトで書き込み操作を実行するには、署名者を使用する必要があります。署名者は、トランザクションに署名して送信できるイーサリアムアカウントを表します。

秘密鍵を使用して署名者を作成する方法は次のとおりです。

 const privateKey = '0x...';
 const wallet = new ethers.Wallet(privateKey, provider);
 const contractWithSigner = contract.connect(wallet);

これで、ブロックチェーン状態を変更する契約関数を呼び出すことができます。たとえば、契約にmint()と呼ばれる関数がある場合：

 async function mintToken() {
 const tx = await contractWithSigner.mint(1);
 await tx.wait();
 console.log('Transaction mined:', tx.hash);
 }

これにより、ネットワークにトランザクションが送信され、確認が確認されます。 Ethers.jsは、トランザクションの署名と提出を自動的に処理します。

スマートコントラクトからデータを読む

スマートコントラクトからデータを読むことはトランザクションを必要とせず、したがって無料です。契約インスタンスを使用して、ビューまたは純粋な関数を直接呼び出すことができます。

たとえば、契約にbalanceOf(address)と呼ばれる関数がある場合：

 async function getBalance(address) {
 const balance = await contract.balanceOf(address);
 console.log( Balance of ${address}: , balance.toString());
 }

これにより、特定のイーサリアムアドレスのトークンバランスが取得されます。返された値は通常、バイナーンバーであり、ディスプレイの目的で文字列または番号に変換できます。

また、複数の値を一度に取得したり、構造化されたデータを返す複雑な関数を呼び出すこともできます。 Ethers.jsは、関数のABI定義に基づいて、戻り値が正しくデコードされることを保証します。

よくある質問

Q：Ethereum以外のブロックチェーンでEthers.jsを使用できますか？

はい、 Ethers.JSは、 Binance Smart Chain 、 Polygon 、 ArbitrumなどのEVM互換ブロックチェーンをサポートしています。プロバイダーURLを変更し、契約ABIとアドレスがターゲットチェーンに正しいことを確認する必要があります。

Q：Ethers.jsとの契約イベントを処理するにはどうすればよいですか？

on()またはonce()メソッドを使用して、スマートコントラクトイベントを聴くことができます。たとえば、 Transferイベントを聞くには：

 contract.on('Transfer', (from, to, amount, event) => {
 console.log( Transfer from ${from} to ${to} of ${amount} );
 });

Q：スマートコントラクトのABIを公開するのは安全ですか？

はい、 ABIは機密データではなく、外部相互作用に必要です。ただし、プライベートキーと署名者は、クライアント側のコードやパブリックリポジトリに公開されないでください。

Q：Ethers.jsを介して送信された失敗したトランザクションをデバッグするにはどうすればよいですか？

トランザクションの領収書を検査し、 EtherScanやRemix IDEなどのツールを使用して、トランザクションをシミュレートしてデバッグできます。さらに、 Ethers.jsを使用すると、 call()メソッドを使用して、トランザクションをネットワークに送信せずにシミュレートできます。