Ethers.js（JavaScriptライブラリ）

Ethers.jsとは？

Ethers.jsは、アプリケーション、ウォレット、スクリプト、開発者向けツールをEthereumやその他のEVMベースのブロックチェーンネットワークに接続するための、オープンソースのJavaScriptおよびTypeScriptライブラリです。

ブロックチェーンデータの読み取り、トランザクションの送信、アカウント管理、メッセージへの署名、スマートコントラクトとのやり取り、イベントログのデコード、Ethereumデータ形式の処理に使える再利用可能な関数を開発者に提供します。

JSON-RPCリクエストを手作業で作成したり、スマートコントラクトの呼び出しを毎回エンコードしたりする代わりに、開発者は技術的な処理の多くを担うethers.jsのオブジェクトやメソッドを利用できます。

公式のethers.jsドキュメントでは、Ethereumブロックチェーンとそのエコシステムを操作するための、包括的かつコンパクトなツールとして紹介されています。

Ethers.jsは、分散型アプリケーションのフロントエンド、サーバーサイドのブロックチェーンサービス、暗号資産ウォレット、自動監視システム、テストスクリプト、決済ツール、スマートコントラクトのデプロイ作業などで広く利用されています。

このライブラリ自体がブロックチェーンを運用したり、Ethereumのコンセンサスを提供したりするわけではありません。

アプリケーションとEthereumノード、ウォレット、または互換性のあるRPCサービスの間をつなぐソフトウェア層として機能します。

Ethers.jsはTypeScriptで記述されており、アプリケーションの実行前に一部のエラーを検出するのに役立つ型宣言が組み込まれています。

このプロジェクトはMIT Licenseのもとで公開され、一般公開されているethers.jsのソースコードリポジトリを通じて保守されています。

Ethers.jsの最新バージョンは？

2026年7月16日時点で、ドキュメントに記載されている最新リリースはethers v6.17.0です。

公式リポジトリでは、バージョン6.17.0のリリース日が2026年6月18日と記載されています。

最新バージョンは、公式のethersパッケージ一覧でも確認できます。

パッケージのリリースにはバグ修正、ネットワーク更新、セキュリティ改善、新たなプロトコル対応が含まれる場合があるため、開発者はインストール前に最新バージョンを確認してください。

通常、プロジェクトではパッケージロックファイルを使って依存関係のバージョンを固定し、開発環境、テスト環境、本番環境で同じリリースを使用します。

テストせずに、詳細が分からない将来のバージョンを自動インストールすると、互換性を損なう動作や予期しない依存関係の変更が発生する可能性があります。

Ethers.jsでできること

Ethers.jsは、Ethereum型のブロックチェーンシステムとやり取りするためのツール群を提供します。

JSON-RPC、WebSocket、またはブラウザーウォレットのインターフェースを通じて、アプリケーションをEthereumノードに接続できます。

アカウント残高、ブロック、トランザクション、手数料データ、スマートコントラクトのコード、イベントログ、ネットワーク情報を取得できます。

ウォレットの作成と管理、ニーモニックフレーズからのアカウント生成、秘密鍵の暗号化、メッセージやトランザクションへの署名も可能です。

スマートコントラクトのABIを使って関数呼び出しをエンコードし、返された値をデコードできます。

署名者を通じて状態を変更するトランザクションを送信し、ブロック承認を受けるまで待機することもできます。

ガスの見積もり、暗号資産単位の変換、ハッシュ計算、署名アドレスの復元、Ethereumアドレスの検証にも対応しています。

これらの機能により、開発者は低レベルのブロックチェーン通信を一から構築するのではなく、アプリケーションのロジックに注力できます。

Ethers.jsのインストール方法

Ethers.jsは通常、パッケージ名「ethers」のnpmパッケージとしてインストールします。

公式のインストール手順では、Node.jsプロジェクト向けに「npm install ethers」というコマンドが案内されています。

インストール後、ethersの名前空間全体、または特定のクラスや関数をインポートできます。

バージョン6は最新のJavaScriptモジュール形式に対応し、多くの関数をメインパッケージから直接インポートできます。

必要なコードだけをアプリケーションに含められるため、選択的なインポートはバンドルツールの利用にも役立ちます。

ブラウザーアプリケーションではECMAScriptモジュール版も利用できます。ただし、本番環境のアプリケーションでは、出所不明のコードを読み込むのではなく、管理された依存関係とビルド手順に従ってください。

よく似た名前のパッケージには人気の暗号資産ライブラリを装った悪意あるものもあるため、名前だけを見てインストールしてはいけません。

インストール前にパッケージ名、公開者情報、リポジトリ、バージョン、整合性データ、依存関係のロックファイルを確認してください。

Ethers.jsのブロックチェーン接続方法

Ethers.jsはプロバイダーを通じてブロックチェーンのインフラと通信します。

プロバイダーとは、アプリケーションがブロックチェーン情報を取得したり、トランザクションをシミュレーションしたりするための読み取り専用接続です。

プロバイダーはEthereumノードまたは互換性のある別のRPCエンドポイントにリクエストを送信します。

一般的なリクエストには、ETH残高の確認、ブロックの取得、コントラクト状態の読み取り、ガスの見積もり、手数料情報の取得、イベントログの検索などがあります。

通常、プロバイダーに秘密鍵は含まれておらず、ユーザーのアカウントから独自にトランザクションを承認することはできません。

公式のethers.jsのプロバイダードキュメントでは、プロバイダークラスと利用可能なブロックチェーン操作が説明されています。

本番環境で信頼性の高いアプリケーションを構築するには、適切な処理能力、可用性、アーカイブアクセス、セキュリティ対策、レート制限を備えたRPC接続が必要です。

公開または共有エンドポイントはテストに便利な場合がありますが、需要が高いと遅延したり利用できなくなったりすることがあります。

Ethers.jsにおけるプロバイダーとは？

プロバイダーは、Ethereum互換ネットワークへの接続を表す抽象化レイヤーです。

基盤となるノード接続や通信方式が異なっても、開発者は一貫したJavaScriptインターフェースを利用できます。

JSON-RPCプロバイダーは、標準的なJSON-RPCリクエストを通じてノードと通信します。

WebSocketプロバイダーは、持続的な接続を確立できます。新しいブロック、保留中のアクティビティ、イベント通知の受信に便利です。

ブラウザープロバイダーは、一般的なブラウザープロバイダー標準に準拠した、ウォレットがブラウザーに注入するインターフェースをラップします。

フォールバックプロバイダーは複数のデータソースを組み合わせ、設定に応じて応答を比較または優先できます。

プロバイダーは公開データを取得できますが、アカウント操作を承認する署名者とは異なります。

BrowserProviderとは？

BrowserProviderは、Webアプリケーションをブラウザーに注入されたEthereumプロバイダーに接続する際に一般的に使われる、ethers.js v6のクラスです。

注入されたプロバイダーは通常、ユーザーがアカウントアクセスやトランザクションを承認できるウォレット環境から提供されます。

アプリケーションは注入されたインターフェースからBrowserProviderを作成し、承認済みアカウントの署名者を要求できます。

ウォレットに接続しても、アプリケーションがウォレットの秘密鍵に自動的にアクセスできるわけではありません。

通常、ウォレットは署名用認証情報を保護された独自の環境内に保持し、要求された署名やトランザクションごとにユーザーへ承認を求めます。

アプリケーションはアカウントアクセスを求める理由を明確に説明し、ユーザーが操作を理解する前に署名を要求しないようにしてください。

Ethers.jsにおける署名者とは？

署名者は、メッセージやトランザクションを承認できるEthereumアカウントを表す抽象化レイヤーです。

署名者の基盤には、秘密鍵、ニーモニックから生成したウォレット、ハードウェア署名デバイス、ブラウザーウォレット、スマートアカウント、その他の署名システムを利用できます。

公式のSignerインターフェースのドキュメントでは、署名者はブロックチェーンアカウントを表し、秘密鍵をアプリケーションから直接利用できない場合の高度な署名方式にも対応できると説明されています。

署名者は通常、自身のアドレスを返し、メッセージに署名し、トランザクションのガスを見積もり、トランザクションの各フィールドを設定し、承認済みトランザクションを送信できます。

利用できる操作は署名者の実装によって異なります。

プロバイダーに接続した署名者は、トランザクションの準備や送信時にネットワークデータを利用できます。

接続されていない署名者はデータにローカルで署名できる場合がありますが、そのトランザクションをブロードキャストできないことがあります。

Ethers.jsにおけるプロバイダーと署名者の違い

プロバイダーはブロックチェーンデータを読み取り、署名者はアカウントに関連する操作を承認します。

プロバイダーは秘密鍵を保持せずに、残高の確認やコントラクト関数のシミュレーションを行えます。

署名者はトークン送金を承認したり、コントラクトをデプロイしたり、状態を変更する別のトランザクションを送信したりできます。

Ethers.jsのオブジェクトの多くは、プロバイダーまたは署名者のどちらに接続されているかによって動作が異なります。

プロバイダーだけに接続されたコントラクトでは、通常、読み取り専用の操作を実行できます。

同じコントラクトを署名者に接続すると、署名者に必要な権限と資金がある場合、状態を変更するトランザクションを準備して送信できます。

プロバイダーと署名者を分けることで、開発者は公開データへのアクセスと機密性の高いアカウント管理の混同を防ぎやすくなります。

Ethers.jsにおけるウォレットとは？

ethers.jsのWalletクラスは、秘密鍵を基盤とする署名者です。

Ethereumアドレスの生成、メッセージへの署名、トランザクションへの署名、プロバイダーに接続した状態でのトランザクション送信ができます。

ウォレットは秘密鍵から作成できるほか、ランダムに生成したり、対応するニーモニックフレーズから復元したり、暗号化されたJSONキーストアから復号したりできます。

公式のethers.jsのウォレットドキュメントでは、ウォレットの作成、階層的決定性ウォレット、暗号化JSONファイル、ニーモニックフレーズ、署名関数について説明されています。

サーバーサイドのウォレットは管理された自動化に役立つ場合がありますが、制限のない秘密鍵をアプリケーションのソースコードに置くことは、重大なセキュリティリスクになります。

秘密鍵をソースコードリポジトリに登録したり、公開ブラウザーバンドルに埋め込んだり、ログに出力したり、通常のメッセージで共有したりしてはいけません。

本番環境の署名システムでは、管理対象の暗号資産の量に応じて、アクセス制御、暗号化されたシークレット、権限の制限、安全なバックアップ、トランザクション監視を導入してください。

Ethers.jsはユーザー資金を保管する？

Ethers.jsはカストディサービスではなく、ユーザーの暗号資産を保管しません。

署名オブジェクトやブロックチェーンアカウントを作成したり、操作したりするソフトウェアライブラリです。

資金は、そのアドレスに関連付けられた秘密鍵、スマートコントラクト、または外部ウォレットシステムによって管理されます。

開発者がethers.jsで新しいウォレットを作成した場合、リカバリーデータを安全に保護する責任は開発者またはユーザーが負います。

秘密鍵やニーモニックフレーズを紛失すると、関連する暗号資産に永久にアクセスできなくなる可能性があります。

鍵が漏えいすると、第三者が資産を送金できる可能性があります。

Ethers.jsとスマートコントラクトの連携

Ethers.jsでは、デプロイ済みスマートコントラクトをContractクラスで表します。

Contractインスタンスは、対象アドレス、ABI、任意のプロバイダーまたは署名者を指定して作成します。

ABIは、コントラクトの外部関数、イベント、エラー、データ型を定義します。

Ethers.jsはこの情報を使って、呼び出し可能なJavaScriptメソッドを生成し、ブロックチェーンからの応答をデコードします。

公式のContract APIドキュメントでは、通常はプロバイダーまたは署名者である接続先のrunnerによって、コントラクトが実行できる操作が決まると説明されています。

読み取り専用のコントラクト呼び出しでは、トークン残高、所有者アドレス、プロトコル設定、その他の公開値を取得できます。

状態を変更する呼び出しでは、トークンの送金、利用承認、担保の預け入れ、投票、報酬の請求、その他コントラクトで定義された操作を実行できます。

Ethers.jsを通じてコントラクトのメソッドを呼び出しても、そのコントラクトの安全性が証明されるわけではありません。

開発者は、コントラクトアドレス、ABI、権限、ネットワーク、想定される動作、セキュリティ上の前提を引き続き確認する必要があります。

ABIとは？

ABIはApplication Binary Interfaceの略です。

外部ソフトウェアがスマートコントラクトの呼び出し可能なインターフェースと通信する方法を定義します。

ABIには、関数名、入力型、出力型、イベント構造、カスタムエラー、変更可能性のルールが記述されています。

Ethers.jsはABIを使い、読みやすいJavaScriptの値をエンコードされたトランザクションデータに変換します。

また、返されたバイト列やイベントログをデコードし、アプリケーションが理解できる値に変換します。

公式のethers.js ABIドキュメントでは、インターフェース、フラグメント、エンコード、デコード、イベント、エラー、人が読みやすいABI形式について説明されています。

ABIが正しくないと、アプリケーションが誤った関数呼び出しをエンコードしたり、返されたデータを誤ってデコードしたりする可能性があります。

ABIは、検証済みのビルド成果物または信頼できるプロジェクトの情報源から取得してください。

Interfaceクラスとは？

Interfaceクラスは、Ethers.jsがエンコードやデコードに使える形式でABIを表します。

関数データのエンコード、関数結果のデコード、イベントトピックの計算、トランザクション入力の解析、カスタムコントラクトエラーの解釈ができます。

完全なContractオブジェクトを作成せず、低レベルの制御が必要な場合に便利です。

Interfaceは、監視ツールがトランザクションで呼び出された関数を識別する際にも役立ちます。

正しいイベント定義が分かっていれば、ログのデコードにも利用できます。

無関係なコントラクトが同じ関数シグネチャやイベントシグネチャを使うこともあるため、デコードした情報は必ず正しいコントラクトに関連付けてください。

スマートコントラクトデータの読み取り

読み取り専用のスマートコントラクト呼び出しは、トランザクションを作成せずに現在のブロックチェーン状態を参照します。

この呼び出しは接続先ノードでローカルに実行され、ブロックチェーンに追加されないため、通常はガス代がかかりません。

Ethers.jsを使って、トークン残高、利用承認、コントラクト所有者、プロトコルパラメーター、保存された記録などを読み取れます。

結果は、プロバイダーが参照したブロック時点の状態を表します。

RPCエンドポイントの同期ブロック高が異なる場合、短時間ながら異なる結果が返ることがあります。

過去の状態を読み取るには、対象の古い状態を保持しているアーカイブノードが必要な場合があります。

コントラクトが処理をrevertする、ABIが誤っている、アドレスに想定したコードが存在しない、またはプロバイダーが必要なデータを持たない場合にも、読み取り呼び出しが失敗することがあります。

スマートコントラクトのトランザクション送信

状態を変更するコントラクトメソッドは、アカウントによる承認が必要なため、署名者を必要とします。

Ethers.jsはメソッドと引数をトランザクションデータにエンコードし、署名者にトランザクションの承認を求めます。

トランザクションには、ネイティブ暗号資産の送金額、ガス上限、手数料設定、nonce、チェーンIDを含める場合もあります。

承認後、接続されたプロバイダーを通じてトランザクションがブロードキャストされます。

最初に返されるのは通常、トランザクションハッシュと送信内容を含むトランザクションレスポンスです。

その後、トランザクションレシートと指定した数のブロック承認を待つことができます。

実行前にブロックチェーンの状態が変わる可能性があるため、送信したトランザクションが成功するとは限りません。

トランザクションレスポンスとレシート

トランザクションレスポンスは、プロバイダーを通じて送信または検出されたトランザクションの情報を表します。

ハッシュ、送信元、送信先、nonce、データ、値、ガス情報、ネットワーク関連のフィールドなどが含まれる場合があります。

トランザクションがブロックに取り込まれると、トランザクションレシートを取得できます。

レシートには実行ステータス、使用ガス量、ブロック情報、コントラクト作成結果、出力されたイベントログが記録されます。

アプリケーションは、トランザクションを成功として扱う前にレシートのステータスを確認してください。

トランザクションハッシュが存在しても、それだけで要求したコントラクト操作が正常に完了したとは証明できません。

プロバイダーのwaitForTransactionメソッドは、ブロックへの取り込みと指定した数の承認を待機できます。

Ethers.jsでのガス見積もり

Ethers.jsはプロバイダーに問い合わせ、トランザクションで消費されると予想されるガス量を見積もれます。

ノードは、現在のブロックチェーン状態に対して提案されたトランザクションをシミュレーションします。

シミュレーションでトランザクションがrevertすると予測された場合、見積もりに失敗することがあります。

公式のプロバイダードキュメントでは、ブロックチェーンの状態は変化し続けるため、ガス見積もりはベストエフォートの計算であると説明されています。

見積もり時に成功したトランザクションでも、残高、利用承認、価格、コントラクトのストレージ、その他の条件が変わると後で失敗する可能性があります。

必要に応じて適切な余裕を加えることはできますが、非常に高いガス上限を設定しても、無効なコントラクトロジックは修正できません。

通常、ユーザーが支払うのはガス上限全体ではなく実際に消費されたガス分です。

ETHとトークンの単位を扱う

Ethereumとトークンの値は、最小単位の整数として保存されます。

ETHは内部的にweiで表すのが一般的で、1 ETHは10の18乗weiに相当します。

Ethers.jsにはparseEther、formatEther、parseUnits、formatUnitsなどのユーティリティがあります。

これらの関数は、読みやすい小数文字列をブロックチェーンで使う整数値に変換し、整数値を読みやすいテキストに戻す際に役立ちます。

公式のethers.jsの単位変換ドキュメントでは、小数値を安全に変換する方法が説明されています。

丸め誤差によってトランザクション値が不正確になる可能性があるため、正確なトークン残高の計算に通常のJavaScript浮動小数点演算を使わないでください。

トークンの実際のdecimals値は、シンボルから推測せず、正しいコントラクトで確認してください。

Ethers.js v6のBigInt

Ethers.js v6では、多くの大きな整数値にJavaScriptのBigIntを使用します。

Ethereumの金額、ガス値、nonce、コントラクトの整数値は、JavaScriptの通常の数値が正確に扱える範囲を超える場合があります。

公式のv5からv6への移行ガイドでは、多くの操作で従来のBigNumberクラスがネイティブES2020 BigInt型に置き換えられたと説明されています。

BigInt値は整数演算に使われ、通常のJavaScript Number値と直接混在させることはできません。

また、トークンの小数量を最小単位の整数に変換しない限り、端数を表現できません。

古いコードを移行する開発者は、算術演算、比較、シリアライズ、ユーザーインターフェースでの表示、データベースへの保存を確認してください。

アドレス関連のユーティリティ

Ethers.jsには、Ethereumアドレスの検証、正規化、比較、作成に使える関数があります。

チェックサムアドレスは大文字と小文字を混在させ、一部の入力ミスを検出しやすくします。

getAddressユーティリティは、有効なアドレスを正規化し、一部の無効なチェックサム形式を拒否できます。

アドレスが技術的に有効でも、意図したユーザーやコントラクトに属するとは限りません。

アプリケーションでは信頼できる情報源とアドレスを照合し、重要な承認時に短縮表示だけを見せないようにしてください。

攻撃者は、先頭と末尾の文字が似ている別のアドレスを作成できます。

名前解決

Ethers.jsは、接続先のプロバイダーを通じて、対応するEthereumネーミングレコードをアドレスに解決できます。

アドレスに対応するプライマリ名が設定されている場合、逆引きもできます。

読みやすい名前は利便性を高めますが、高額送金の前には解決されたアドレスを表示するか、ユーザーが確認できるようにしてください。

名前レコードは時間とともに変更される場合があり、別のネットワークでは異なる名前解決結果となる可能性があります。

予期しない宛先に送金しないよう、解決できない名前や無効なレコードを適切に処理してください。

Ethers.jsでメッセージに署名する

Ethers.jsでは、読みやすいメッセージに署名し、有効な署名に関連付けられたアドレスを復元できます。

メッセージ署名は、アカウント認証、管理権限の証明、投票、権限付与、オフチェーンでの承認などに利用できます。

公式のethers.js署名ガイドでは、可能な場合、ユーザーが承認内容を理解できるよう読みやすい内容にすることが推奨されています。

署名だけで必ず資金が移動するわけではありませんが、後続のブロックチェーン操作を承認する署名もあります。

該当する場合は、ドメイン、目的、nonce、有効期限、チェーン情報を含めてください。

ガス代が表示されないという理由だけで、内容が分からないメッセージに署名してはいけません。

EIP-712の型付きデータ

EIP-712は、読み取りにくいバイト列ではなく型付きフィールドをウォレットに表示できる、構造化署名形式を定めています。

Ethers.jsは、対応する型付きデータのエンコード、署名、ハッシュ化、検証ができます。

型付きデータは、トークン利用許可、マーケットプレイス注文、ガバナンス操作、アカウント承認、その他のオフチェーン承認に利用できます。

ドメインデータに名前、バージョン、チェーンID、検証コントラクトを含めると、リプレイリスクの軽減に役立ちます。

ドメインや型の構築を誤ると保護が弱まる可能性があるため、開発者は正しく設定してください。

構造化データに署名する前に、要求された利用者、金額、有効期限、コントラクト、ネットワークを確認してください。

イベントログとコントラクトリスナー

Ethers.jsは、過去のスマートコントラクトのイベントログを検索し、新しいイベントを監視できます。

コントラクトイベントはABIで定義され、正常な実行中に出力されるとトランザクションレシートに記録されます。

アドレスやトークン識別子など、選択したイベントパラメーターでフィルターを作成できます。

ライブリスナーは、送金、入金、取引、投票、その他のコントラクト操作が起きた際にインターフェースを更新できます。

WebSocketが切断されると通知を受け取れない場合があるため、アプリケーションはライブ接続だけに依存しないでください。

信頼性の高いインデクサーでは、ブロック範囲ごとにイベントを再照合し、ブロックハッシュを保存し、重複処理を避け、ブロックチェーンの再編成に対応する必要があります。

どのコントラクトでも見慣れたイベントシグネチャを作成できるため、イベントが出力されたことだけでは、そのコントラクトが信頼できるとは証明できません。

ハッシュと暗号関連のユーティリティ

Ethers.jsには、データのハッシュ化、関数セレクターの計算、署名の処理、アドレスの導出、Ethereumのエンコード形式の処理に使えるユーティリティが含まれています。

一般的な操作には、Keccak-256ハッシュ、メッセージハッシュ、packed encoding、RLPエンコード、署名の復元などがあります。

公式のethers.jsハッシュ関連ドキュメントでは、メッセージ、型付きデータ、名前、識別子、承認データ用のヘルパーが説明されています。

暗号関連APIは、関連するEthereum標準に従って使用し、安易に組み合わせないでください。

誤った形式のハッシュに署名すると、互換性のない署名やセキュリティ上の弱点につながる可能性があります。

同じデータが別のコンテキストで再利用される可能性がある場合、開発者はドメイン分離を導入してください。

Ethers.jsでのコントラクトのデプロイ

Ethers.jsには、スマートコントラクトのデプロイに使うContractFactoryがあります。

ファクトリーは、コントラクトのバイトコード、ABI、署名者から作成します。

デプロイトランザクションには、コンストラクター引数と任意のネイティブ暗号資産の送金額を含められます。

送信後、デプロイトランザクションがブロックに取り込まれるまで待ってから、予測されたアドレスにコントラクトが存在すると判断してください。

デプロイ先アドレスとともに、チェーンID、コンパイラー設定、ソースコードのバージョン、コンストラクター引数、デプロイトランザクションハッシュを保存してください。

デプロイが成功しても、コントラクトが安全であること、正しく初期化されたこと、意図した管理者が制御していることは証明されません。

価値のある資産を管理する本番コントラクトは、テストと適切なセキュリティレビューを実施してください。

ブラウザーアプリケーションでのEthers.js

ブラウザー上の分散型アプリケーションでは、Ethers.jsを使ってユーザーインターフェースをウォレットやブロックチェーンプロバイダーに接続できます。

残高表示、ネットワーク切り替えの要求、コントラクトの読み取り、トランザクションの見積もり、承認済み操作へのウォレット署名要求が可能です。

秘密鍵はフロントエンドコードにコピーせず、ウォレット内に保持してください。

ブラウザーに配信されるコードは、一般にユーザーや攻撃者が検査できます。

秘密のAPIキーや特権的な署名認証情報を、公開アプリケーションバンドルに埋め込んではいけません。

インターフェースではトランザクションの詳細を明確に示し、ウォレットによる拒否、ネットワークの不一致、RPC障害、保留中のトランザクション、revert、アカウント変更に対応してください。

サーバーサイドアプリケーションでのEthers.js

サーバーサイドサービスは、Ethers.jsを使ってブロックチェーンデータを監視し、管理されたトランザクションを送信し、レポートを作成し、署名を検証し、バックエンドの暗号資産関連処理を実行できます。

サーバーアプリケーションはRPCノードに直接接続することも、管理されたエンドポイントを使うこともできます。

トランザクションに署名するバックエンドでは、署名認証情報を開発者、ログ、バックアップ、ビルドシステム、不正なプロセスから保護する必要があります。

高額資産を扱うシステムでは、分離された署名インフラ、トランザクションポリシー、出金上限、承認ワークフロー、緊急時の制御を検討してください。

同一アカウントから複数のプロセスがトランザクションを送信する場合、サーバーはnonceを慎重に管理してください。

nonceの重複使用や競合によって、トランザクションが置き換えられたり保留中になったりする可能性があります。

Ethers.jsとEVM互換ネットワーク

Ethers.jsは、Ethereum形式のJSON-RPCインターフェースを公開する多くのEVM互換ネットワークに接続できます。

選択したネットワークに応じて、正しいRPCエンドポイント、チェーンID、ネイティブのガス資産情報、コントラクトアドレスをアプリケーションに設定する必要があります。

同じウォレットアドレスでも、チェーンによって残高やトランザクション履歴は異なります。

あるネットワークの特定アドレスにデプロイされたコントラクトが、別のネットワークには存在しない場合や、異なるコードを持つ場合があります。

EVM互換性があっても、ガスの動作、トランザクション形式、ファイナリティ、RPC拡張機能、スマートコントラクトの実行詳細が同一とは限りません。

ネットワークごとに個別のテストが必要です。

Ethers.js v5からv6への主な変更点

Ethers.js v6では、バージョン5からアーキテクチャとAPIが大きく変更されました。

移行ガイドでは、最新のES6機能の利用拡大が主な変更点の一つとして挙げられています。

多くの整数操作で、従来のBigNumberクラスがネイティブBigIntに置き換えられました。

ContractオブジェクトはJavaScriptのProxyの動作を利用して、メソッドを動的に解決します。

以前は階層化された名前空間を介してアクセスしていた多くのクラスやユーティリティが、メインパッケージのエクスポートに移動しました。

一般的なブラウザー注入型プロバイダーをラップする際、従来のWeb3ProviderクラスはBrowserProviderに置き換えられました。

トランザクション、署名、コントラクト、プロバイダー、ユーティリティのAPIにも、名称や構造の変更が加えられています。

既存のv5コードは、パッケージのバージョンを変更するだけでアップグレードしてはいけません。

公式のethers.js v6移行ガイドに従い、アプリケーション全体を再テストしてください。

Ethers.js v5は引き続きサポートされる？

ethers.jsのセキュリティポリシーによると、保守作業の大部分は最新のメジャーリリースに重点を置いています。

また、バージョン5にはセキュリティアップデートが提供される一方、それ以前のメジャーブランチはサポート対象外とされています。

バージョン5のアプリケーションを保守している開発者は、利用可能な最新のv5セキュリティリリースをインストールし、v6への移行計画を検討してください。

重大なセキュリティパッチが提供されている場合でも、レガシーブランチを長期間使用すると互換性や保守面のリスクが生じる可能性があります。

最新のサポート情報は、公式のethers.jsセキュリティポリシーで公開されています。

Ethers.jsを使用する際のセキュリティリスク

Ethers.jsはブロックチェーンシステムとの連携に役立ちますが、安全でないアプリケーションロジックを安全に変えることはできません。

ライブラリを正しく使っていても、悪意あるスマートコントラクトを呼び出したり、有害なトランザクションに署名したりする可能性があります。

チェーンID、コントラクトアドレス、ABI、小数桁数、ガスの前提、署名ドメインが誤っていると、資金の損失につながる可能性があります。

侵害されたRPCエンドポイントは、誤った情報や不完全な情報を返したり、トランザクションを遅らせたり、関連するブロックチェーン上のアクティビティを隠したりする可能性があります。

侵害された依存関係やビルドプロセスによって、コードがユーザーに届く前にアプリケーションの動作が変更されることがあります。

秘密鍵が漏えいすると、攻撃者はユーザーインターフェース上のすべての保護を回避できる可能性があります。

セキュリティを確保するには、安全な鍵管理、信頼できる依存関係、コントラクト検証、入力検証、トランザクションシミュレーション、監視、独立したテストが必要です。

秘密鍵の安全性

秘密鍵をブラウザーのソースコードに置いたり、リポジトリに登録したりしてはいけません。

公開設定ファイル、サポートチケット、スクリーンショット、アプリケーションログにも直接含めないでください。

環境変数は誤った公開を減らすのに役立ちますが、それだけで完全なセキュリティシステムにはなりません。

プロセス環境、デプロイプラットフォーム、サーバーメモリ、ビルド設定にアクセスできる人が、鍵を取得できる可能性は残ります。

本番システムでは、署名権限を一般的なアプリケーションアクセスから分離してください。

侵害が疑われる場合は鍵をローテーションする必要があります。ただし、鍵のローテーションには、新しいブロックチェーンアドレスへの管理権限の移転、または承認済みコントラクトロールの更新が必要です。

依存関係とサプライチェーンの安全性

開発者は、正規のパッケージソースからのみethers.jsをインストールしてください。

スペルミスのあるパッケージに、秘密鍵を盗んだりトランザクションの宛先を変更したりする悪意あるコードが含まれている可能性があります。

パッケージロックファイルと整合性チェックは、自動インストールでレビュー済みの依存関係バージョンを使用するのに役立ちます。

公式リポジトリやパッケージ情報に掲載されるセキュリティ更新のお知らせを確認してください。

本番アプリケーションでは、依存関係のアップグレードをデプロイ前にテストしてください。

依存関係が増えるほど攻撃対象領域も広がるため、使っていないパッケージやスクリプトは削除してください。

RPCプロバイダーのリスク

RPCプロバイダーは、Ethers.jsアプリケーションが利用するブロックチェーン情報を提供します。

プロバイダーが利用できない場合、アプリケーションは残高を読み込んだりトランザクションを送信したりできない可能性があります。

プロバイダーの応答が遅いと、古い情報がアプリケーションに表示されることがあります。

悪意あるエンドポイントは、チェーンの状態、ガス見積もり、トランザクションステータスを偽って伝えようとする可能性があります。

重要な財務判断を扱うアプリケーションでは、複数の独立ノードからの応答を比較するか、自社でノードインフラを運用できます。

署名を要求する前に、プロバイダーが返すチェーンIDを確認してください。

適切な場合は、暗号化された通信と管理された認証情報を使用してください。

トランザクションのシミュレーションとエラー処理

Ethers.jsでは、トランザクション送信前に呼び出しをシミュレーションし、ガスを見積もれます。

シミュレーションで多くのrevertを予測できますが、将来の成功を保証するものではありません。

シミュレーションから実際の実行までの間に、ブロックチェーンの状態が変化する可能性があります。

可能な場合はコントラクトエラーをデコードし、ユーザーに分かりやすく説明してください。

ウォレットによる拒否、RPC障害、資金不足、ガス見積もりの失敗、トランザクションの置き換え、実行時のrevert、承認タイムアウトを区別してください。

一般的なエラーメッセージだけでは、ユーザーが不要なトランザクションを再送したり、元の問題を理解せずに別の操作へ署名したりする可能性があります。

Ethers.jsの利点

Ethers.jsは、Ethereum開発でよく使われる多くの作業を網羅するコンパクトなインターフェースを提供します。

プロバイダーと署名者を分けることで、セキュリティ上の境界を明確にできます。

Contractクラスを使うと、スマートコントラクト操作に必要なABIの手動エンコードを減らせます。

TypeScriptの型宣言が組み込まれており、エディターでの補完を改善し、誤ったパラメーターの使用を一部検出できます。

ウォレット、署名、アドレス、単位、ハッシュ、トランザクション、イベント用のユーティリティが1つのパッケージに含まれています。

オープンソースであり、充実したドキュメントとテストに支えられています。

EVMを中心に設計されているため、多くの互換ブロックチェーン環境で利用できます。

Ethers.jsの制限

Ethers.jsはEthereumノードを実行しないため、ブロックチェーンインフラへのアクセスが引き続き必要です。

スマートコントラクトを監査したり、アドレスの信頼性を保証したりするものではありません。

アプリケーション内に不注意に保存された秘密鍵を自動的に保護することもできません。

承認済みのブロックチェーントランザクションを取り消すことはできません。

ガス見積もり、シミュレーション結果、RPC応答の正確性が維持されることも保証できません。

Ethereumのアカウント、トランザクション、ガス、署名、ABI、イベントログ、スマートコントラクトの権限を理解する必要はなくなりません。

また、ユーザーインターフェースのセキュリティ、データベース、バックエンドアクセス、デプロイ、監視、規制要件も別途管理する必要があります。

Ethers.jsを使ったトランザクションの流れの例

ユーザーが対応トークンを送金できる分散型アプリケーションを例に考えてみましょう。

まず、アプリケーションは選択したネットワークに接続するプロバイダーを作成します。

チェーンIDを確認し、ウォレットインターフェースを通じて承認済みアカウントへのアクセスを要求します。

検証済みのトークンアドレスとABIを使って署名者とContractインスタンスを作成します。

トークンの小数桁数とユーザー残高を読み取ります。

parseUnitsを使い、読みやすい送金額をトークンの最小整数単位に変換します。

コントラクトメソッドにガスを見積もらせ、トランザクションを準備します。

ウォレットは、ユーザーの承認用に受取人、コントラクト、ネットワーク、金額、手数料情報を表示します。

ユーザーが署名すると、署名者はプロバイダーを通じてトランザクションをブロードキャストします。

アプリケーションはトランザクションレスポンスを受け取り、トランザクションハッシュを表示します。

レシートを待ち、実行が成功したか確認します。

その後、トークン残高を更新し、承認済みトランザクションを記録します。

この流れから、ethers.jsでプロバイダー、署名者、コントラクト、ABI、単位変換、ガス見積もり、レシートがどのように連携するかが分かります。

Ethers.jsでよくある間違い

よくある間違いの一つは、秘密鍵をフロントエンドのJavaScriptに埋め込むことです。

未検証のコントラクトアドレスやABIを使うことも問題です。

通常のNumber値とBigInt値を混在させるのも、よくある間違いです。

トランザクションの送信後、成功したレシートを受け取る前に確定済みとして扱うことも避けてください。

ガス見積もりが成功すれば、実際の実行も成功すると考えるのは誤りです。

トークン数量の計算に浮動小数点演算を使わないでください。

ウォレットの接続や型付きデータへの署名時にチェーンIDを無視するのも問題です。

トランザクションの置き換え、ドロップ、ブロックチェーンの再編成への対応を怠らないでください。

互換性を損なうAPI変更を確認せずにethers.js v5からv6へアップグレードするのも間違いです。

見慣れた名前だからという理由だけで、パッケージ、RPCエンドポイント、スマートコントラクトを信頼してはいけません。

FAQ

ethers.jsは何に使われますか？

Ethers.jsは、ブロックチェーンデータの読み取り、ウォレット管理、メッセージ署名、トランザクション送信、Ethereumスマートコントラクトとの連携を行うJavaScriptおよびTypeScriptアプリケーションの構築に使われます。

ethers.jsは暗号資産ですか？

いいえ。ethers.jsはソフトウェアライブラリであり、公式の暗号資産や投資トークンはありません。

ethers.jsはウォレットですか？

Ethers.jsにはウォレットクラスや署名ツールが含まれていますが、ライブラリ自体はカストディ型ウォレットサービスではありません。

ethers.jsの最新バージョンは？

2026年7月16日時点で、ドキュメントに記載されている最新リリースは、2026年6月18日に公開されたethers v6.17.0です。

ethers.jsはEthereumに接続できますか？

はい。Ethereumノードまたは互換性のあるRPCエンドポイントと通信するプロバイダーを通じて接続できます。

ethers.jsは他のEVMチェーンでも使えますか？

はい。Ethereum形式のJSON-RPCインターフェースを提供する多くのEVM互換ネットワークで利用できます。

プロバイダーと署名者の違いは何ですか？

プロバイダーは公開ブロックチェーンデータを読み取り、署名者はアカウントのメッセージや状態変更トランザクションを承認します。

ethers.jsのContractオブジェクトとは？

Contractオブジェクトは、コントラクトアドレス、ABI、プロバイダーまたは署名者を組み合わせ、デプロイ済みスマートコントラクトを呼び出すJavaScriptメソッドを提供します。

ethers.jsにABIは必要ですか？

名前付きスマートコントラクト関数、イベント、エラーを簡単にエンコードおよびデコードするには、通常ABIが必要です。

ethers.jsは秘密鍵を保存しますか？

ライブラリはアプリケーションのメモリ内に署名認証情報を含むウォレットオブジェクトを作成できますが、鍵の保存と保護は開発者の責任です。

ブラウザーアプリケーションに秘密鍵を置いても安全ですか？

いいえ。ブラウザーコード内の秘密鍵は、ユーザー、攻撃者、拡張機能、侵害されたスクリプトなどに閲覧・窃取される可能性があります。

読み取り専用のコントラクト呼び出しにガス代はかかりますか？

プロバイダーを通じた読み取り専用の呼び出しは、通常ノード上でシミュレーションされるため、オンチェーンの手数料は発生しません。

ethers.jsがBigIntを使うのはなぜですか？

BigIntは、通常のJavaScript数値の精度損失を避けながら、暗号資産残高、ガス値、nonce、スマートコントラクトデータに必要な大きく正確な整数を扱えます。

ethers.jsでガスを見積もれますか？

はい。ノードにガス見積もりを要求できますが、現在の状態に基づく見積もりであり、将来のトランザクションの成功は保証されません。

ethers.jsでトランザクションを取り消せますか？

いいえ。Ethers.jsはトランザクションを送信できますが、確定したブロックチェーン上の状態変更を取り消すことはできません。

ethers.jsでスマートコントラクトのイベントを監視できますか？

はい。適切なプロバイダーを通じて過去のログを検索し、新しいコントラクトイベントを購読できます。

ethers.js v5からv6で何が変わりましたか？

バージョン6では、ネイティブBigInt、最新のJavaScript機能、インポート方法、プロバイダークラスの更新、Proxyベースのコントラクトメソッド、複数のAPI変更が導入されました。

ethers.jsはオープンソースですか？

はい。ethers.jsはMIT Licenseのもとで一般公開されています。

ethers.jsに公式トークンはありますか？

いいえ。公式プロジェクトによると、ethersにトークンはありません。

ethers.jsのセキュリティ問題はどこに報告すればよいですか？

修正前の脆弱性を公に開示せず、公式のethers.jsセキュリティポリシーに記載されている非公開の脆弱性報告手順に従ってください。

まとめ

Ethers.jsは、暗号資産開発者がEthereumやEVM互換ブロックチェーンネットワークと構造的に連携するためのJavaScriptおよびTypeScriptライブラリです。

ブロックチェーンデータを読み取るプロバイダー、アカウント操作を承認する署名者、署名認証情報を管理するウォレット、スマートコントラクトと連携するContractオブジェクトを提供します。

ABIのエンコード、イベントのデコード、メッセージ署名、型付きデータ、アドレス、ハッシュ、ガス見積もり、トランザクションレシート、暗号資産単位の変換に使えるユーティリティも含まれています。

現在のメジャーリリースはethers.js v6で、BigIntやProxyベースのコントラクトメソッドなど、最新のJavaScript機能を使用しています。

2026年7月16日時点で、ドキュメントに記載されている最新バージョンはethers v6.17.0です。

Ethers.jsはブロックチェーン開発を簡素化できますが、秘密鍵の漏えい、悪意あるコントラクト、誤ったアドレス、信頼性の低いRPCエンドポイント、依存関係の侵害、取り消せないトランザクションのリスクをなくすものではありません。

開発者はパッケージの入手元を検証し、依存関係のバージョンを固定し、署名認証情報を保護し、チェーンIDを確認し、コントラクトアドレスを検証し、正しいABIを使い、すべてのトランザクション処理をテストしてください。

アプリケーションは、シミュレーションの失敗、ウォレットによる拒否、RPC停止、保留中のトランザクション、置き換え、revert、承認、チェーンの再編成にも対応する必要があります。

慎重なセキュリティ対策とともに使用すれば、ethers.jsはウォレット、暗号資産決済システム、分散型アプリケーション、分析ツール、監視サービス、スマートコントラクト自動化を構築するための強力な基盤になります。

Ethers.jsを理解することで、このライブラリをウォレットサービス、ブロックチェーンネットワーク、暗号資産と混同せずに、JavaScriptアプリケーションをブロックチェーンシステムへ接続できます。