スマートコントラクトと連携する
著者: Alchemy Team
このスマートコントラクトとの連携に関するチュートリアルを始める前に、パート1「Hello World Smart Contract」(スマートコントラクトの作成とデプロイ)を完了しておく必要があります。パート3では、コントラクトをEtherscanに登録する方法を説明します。これにより、誰でもそのコントラクトとの連携方法を理解できるようになります!
パート2:スマートコントラクトと連携する
ropstenネットワークへのスマートコントラクトのデプロイに成功したので、web3のスキルを試して、実際にこのコントラクトと連携してみましょう!
ステップ1:interact.jsファイルを作成する
これが連携用のスクリプトを書くファイルです。パート1で既にインストールしたEthers.jsライブラリを使用します。
hardhatチュートリアル用のscripts/フォルダ内、またはTruffleチュートリアル用のホームディレクトリ内に、interacts.jsという名前の新しいファイルを作成し、以下のコードを追加してください。
ステップ2:.envファイルを更新する
新しい環境変数を使用するため、.envファイルにそれらを定義し、dotenvモジュールがこれらの変数を読み込むようにする必要があります。
AlchemyのAPI\_KEYと、スマートコントラクトがデプロイされたCONTRACT\_ADDRESSの定義を追加する必要があります。
.envファイルは以下のようになります:
ステップ3:コントラクトABIを取得する
コントラクトABI(Application Binary Interface)は、スマートコントラクトと連携するためのインターフェースです。Contract ABIについては、eth_getLogsの詳細解説で詳しく説明しています。Hardhat(およびTruffle)はABIを自動生成し、HelloWorld.jsonファイルに保存します。
これを使用するには、contract-interact.jsファイルに以下のコードを追加して内容をパースする必要があります:
ABIを確認したい場合は、コンソールに出力できます:
interact.jsを実行してABIがコンソールに出力されるのを確認するには、ターミナルで以下を実行します:
Hardhat:
Truffle:
ステップ4:コントラクトのインスタンスを作成する
コントラクトと連携するには、コード内でそのインスタンスを作成する必要があります。Ethers.jsでこれを行うには、以下の3つの概念を扱います:
- Provider - ブロックチェーンへの読み取り・書き込みアクセスを提供するノードプロバイダーです。
- Signer - トランザクションに署名する能力を持つEthereumアカウントを表します。
- Contract - オンチェーンにデプロイされた特定のコントラクトを表すEthers.jsオブジェクトです。
前のステップで取得したコントラクトABIを使用して、コントラクトのインスタンスを作成します:
Providers、Signers、Contractsについての詳細は、AlchemyのEthers.js解説記事をご覧ください。
ステップ5:initメッセージを読み取る
theinitMessage = "Hello world!"を使ってコントラクトをデプロイした時のことを覚えていますか?今度は、スマートコントラクトに保存されたそのメッセージを読み取り、コンソールに出力してみましょう。
JavaScriptでは、ネットワークと連携するために非同期関数を使用します。
以下のコードを使用して、スマートコントラクト内のmessage関数を呼び出し、initメッセージを読み取ります:
ターミナルでnpx hardhat run scripts/interact.jsを使ってファイルを実行すると、以下のような応答が表示されるはずです:
おめでとうございます!Ethereumブロックチェーンからスマートコントラクトのデータを読み取ることに成功しました!
ステップ6:メッセージを更新する
メッセージを読み取るだけでなく、update関数を使ってスマートコントラクトに保存されたメッセージを更新することもできます!なかなか面白いですよね。
これを行うには、インスタンス化したContractオブジェクトのupdate関数を直接呼び出します:
返されたトランザクションオブジェクトに対して.wait\(\)を呼び出している点に注目してください。これにより、スクリプトは処理を進める前に、トランザクションがブロックチェーン上でマイニングされるのを待ちます。この行を省略すると、スクリプトがコントラクト内の更新されたmessageの値を認識できない場合があります。
ステップ7:新しいメッセージを読み取る
ステップ5を繰り返すことで、更新されたmessageの値を読み取ることができるはずです。新しい値を出力するために必要な変更を、少し時間をかけて自分で考えてみてください!
ヒントが必要な場合は、この時点でのinteract.jsファイルは以下のようになっているはずです:
あとはスクリプトを実行するだけで、古いメッセージ、更新中のステータス、そして新しいメッセージがターミナルに出力されるのが確認できるはずです!
npx hardhat run scripts/interact.js --network ropsten
このスクリプトを実行している間、Updating the message... のステップで新しいメッセージが設定されるまでに少し時間がかかることに気づくかもしれません。これはマイニングプロセスによるものです。トランザクションがマイニングされている間にその状況を追跡する方法に興味がある場合は、Alchemyのmempoolにアクセスして、トランザクションのステータス(保留中、マイニング済み、またはネットワークによってドロップされたか)を確認してください。トランザクションがドロップされた場合は、Ropsten Etherscanでトランザクションハッシュを検索するのも役立ちます。
これで完了です!Ethereumスマートコントラクトのデプロイと連携の両方を行いました。誰でもそのコントラクトとの連携方法がわかるように、コントラクトをEtherscanに公開したい場合は、パート3「スマートコントラクトをetherscanに登録する」をご覧ください!🎉
このチュートリアルを完了したら、感想やフィードバックをTwitterで@Alchemyまでお知らせください!
Alchemy Newsletter
リリース情報をいち早く受け取る
ニュースレターに登録する
Alchemyの最新のプロダクト情報とリソースをお届けします
メールアドレスを入力すると、当社のマーケティング情報およびプロダクト最新情報の受信に同意したことになります。Alchemyが受け取った情報をプライバシー通知に従って取り扱うことに同意するものとします。購読はいつでも解除できます。
関連記事

Claude Codeをオンチェーンリサーチエージェントに変える
Alchemy CLIでClaude Codeをオンチェーンリサーチエージェントに変える。適切な質問をすることで、トークンローンチ、デプロイヤーウォレット、管理者キーを追跡できる。

Cortexルーター:あらゆるリクエストに対して最速の健全なノードを選ぶ仕組み
リクエストを近くのリージョンに届けることは最低限の条件にすぎない。次にどのノードが応答するかを選ぶ処理、そここそCortexの仕事だ。

AIエージェント向けブロックチェーンインフラのベスト比較(2026年)
2026年のAIエージェント向けブロックチェーンインフラを比較:エージェントフレームワーク、エージェント対応のRPCおよびデータプロバイダー、それらを繋ぐ標準規格について解説します。