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

Web3.jsを使用すると、開発者は、データを読み取るツールを提供し、トランザクションを送信し、HTTP、IPC、またはWebSocket接続を介してイベントをリッスンすることにより、Ethereum Smart Contractsと対話できます。

2025/07/23 15:21

web3.jsとは何ですか？また、なぜスマートコントラクトインタラクションに使用されるのですか？

Web3.jsは、開発者がHTTP、IPC、またはWebSocketを使用してローカルまたはリモートのイーサリアムノードと対話できるようにするライブラリのコレクションです。 Ethereumブロックチェーンと通信する便利な方法を提供し、開発者がトランザクションを送信し、ブロックチェーンからデータを読み取り、展開されたスマートコントラクトと対話できるようにします。

スマート契約は、コードに直接書かれた条件との自己執行契約です。 Ethereum Virtual Machine（EVM）で実行され、外部アカウントまたはその他の契約を介してアクセスできます。スマートコントラクトでアクションを実行するには、呼び出し関数やエーテルの送信など、 Web3.jsは堅牢で柔軟なAPIを提供します。これにより、Ethereumネットワークとのバックエンド相互作用を必要とする開発者が分散型アプリケーション（DAPP）を構築するための優先ツールになります。

web3.js統合の環境を設定します

スマートコントラクトと対話する前に、開発環境を適切にセットアップすることが不可欠です。最初のステップは、プロジェクトにWeb3.jsをインストールすることです。これは、NPMを使用して実行できます。

 npm install web3

インストールしたら、JavaScriptファイルにWeb3オブジェクトをインポートおよび初期化できます。 Web3オブジェクトは、ローカルノードまたはInfuraやAlchemyなどのリモートノードにすることができます。

 const Web3 = require('web3');
 const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');

特定のスマート契約と対話するには、契約アドレスとABI（アプリケーションバイナリインターフェイス）が必要です。 ABIは、契約の機能、イベント、およびパラメーターを説明するJSONファイルです。スマートコントラクトとアプリケーションの間のインターフェイスとして機能します。

スマートコントラクトへの接続

環境を設定した後、次のステップは、ABIとアドレスを使用してスマートコントラクトに接続することです。これは、web3.jsで契約インスタンスを作成することによって行われます。

 const contractAddress = '0x...'; // Replace with your contract address
 const abi = [...]; // Replace with your contract's ABI const contract = new web3.eth.contract（abi、contractAddress）;

契約インスタンスが作成されたら、そのメソッドを呼び出すか、トランザクションを送信できます。相互作用には、操作の読み取り（ブロックチェーン状態を変更しない）と書き込み操作（そうする）の2つのタイプがあります。読み取り操作は通常無料で、 call()メソッドを使用して実行できますが、書き込み操作にはトランザクションが必要であり、ガスを消費します。

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

ブロックチェーン状態を変更せずにスマートコントラクトからデータを取得するには、 call()メソッドを使用できます。これは、値を返すgetBalance()やgetName()などの関数に役立ちます。

 contract.methods.name().call()
 .then(console.log)
 .catch(console.error);

この例では、契約のname()関数が呼び出され、結果がコンソールに印刷されます。これは読み取り操作であるため、ブロックチェーンへのトランザクションは送信されず、ガス料金は発生しません。この関数は、これが正しく機能するためには、 viewとしてマークされているか、堅実さでpureばならないことに注意することが重要です。

関数にパラメーターが必要な場合、それらはcall()メソッドに直接渡すことができます。例えば：

 contract.methods.balanceOf('0x...').call()
 .then(console.log)
 .catch(console.error);

これにより、ERC-20トークン契約から特定のイーサリアムアドレスのバランスが取得されます。

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

トークンの転送や契約データの更新など、ブロックチェーンの状態を変更するには、トランザクションを送信する必要があります。これには、送信者の秘密鍵と取引に署名し、ガス料金を支払うことが含まれます。

 const account = '0x...'; // Replace with your Ethereum account address
 const privateKey = '0x...'; // Replace with your private key web3.eth.accounts.wallet.add（privatekey）;





Contract.Methods.Transfer（ '0xRecipientAddress'、 '100'）
 .send（{from：account、gas：200000}）
 .on（ 'transactionhash'、hash => console.log（hash））
 .on（ 'receate'、reception => console.log（receate）））
 .on（ 'error'、error => console.error（error））;

この例では、ERC-20トークン契約のtransfer()関数が呼び出されます。 .send()メソッドは、トランザクションの実行に使用されます。送信者の住所とガス制限が必要です。 transactionHash 、 receipt 、 errorなどのイベントを使用して、トランザクションのステータスを監視できます。

トランザクションを送信する前に、秘密鍵を安全に処理することが重要です。生産コードでハードコードしないでください。また、メタマスクやハードウェアウォレットなどのウォレットサービスを使用して、セキュリティを向上させることを検討してください。

イベントの処理と契約ログのリスニング

スマートコントラクトは、特定のアクションが発生したときにイベントを発する可能性があります。これらのイベントはブロックチェーンのログに保存され、 web3.jsを使用して監視できます。これは、ユーザーアクション、契約の更新、またはシステムアラートの追跡に役立ちます。

 contract.events.Transfer({
 fromBlock: 0,
 toBlock: 'latest'
 })
 .on('data', event => console.log(event))
 .on('error', error => console.error(error));

上記のコードは、契約によって放出されるすべてのTransferイベントについて耳を傾けます。 fromBlockおよびtoBlockパラメーターは、イベントを検索するブロックの範囲を定義します。この機能により、開発者は鎖でのアクティビティに反応するリアルタイムアプリケーションを構築できます。

フィルターを使用して、特定の基準に基づいてイベントを絞り込むこともできます。たとえば、特定のアドレスへの転送をフィルタリングします。

 contract.events.Transfer({
 filter: { to: '0xRecipientAddress' },
 fromBlock: 0,
 toBlock: 'latest'
 })
 .on('data', event => console.log(event));

---

よくある質問

Q：web3.jsのcall（）とsend（）の違いは何ですか？

A： call()メソッドは、状態を変更せずにブロックチェーンからデータを読み取るために使用され、ガスは必要ありません。 send()メソッドは、ブロックチェーン状態を変更し、ガス料金を必要とするトランザクションを実行するために使用されます。

Q：プライベートキーなしでスマートコントラクトと対話できますか？

A：はい、秘密鍵なしでcall()を使用して読み取り操作を実行できます。ただし、 send()を使用して操作を書き込むには、ガスの支払いに十分なエーテルを備えた有効なイーサリアムアカウントが必要です。

Q：展開されたスマートコントラクトのABIを取得するにはどうすればよいですか？

A：Solidityコードをコンパイルすると、ABIが生成されます。契約が既に展開されている場合、契約のソースコードが検証されている場合、EtherscanのようなブロックエクスプローラーからABIを取得できます。

Q：トランザクションが立ち往生している場合はどうすればよいですか？

A：Etherscanなどのツールを使用して、またはreceiptなどのイベントを聴くことで、トランザクションステータスを確認できます。トランザクションが長すぎて保留中の場合は、ガス価格を上げて再送信する必要がある場合があります。