Web3を使用してトランザクションを送信する

トランザクション

web3.js

Alchemy

初級

Elan Halpern

2020年11月4日

18 分の読書

この初心者向けガイドでは、Web3を使用してイーサリアムトランザクションを送信する方法を説明します。イーサリアムのブロックチェーンでは、作成、署名、およびブロードキャストという主に3つのステップを通じてトランザクションを送信します。これら3つのステップを説明することで、皆さんの疑問が氷解することを願っています！このチュートリアルでは、Alchemy (opens in a new tab)を使用して、イーサリアムチェーンにトランザクションを送信します。こちら (opens in a new tab)で無料のAlchemyアカウントを作成できます。

**注意：**このガイドは、アプリの_バックエンド_でトランザクションに署名するためのものです。フロントエンドでトランザクションの署名を統合したい場合は、Web3とブラウザプロバイダの連携 (opens in a new tab)をご確認ください。

基本

ブロックチェーンの開発を始めたばかりの皆さんは、トランザクションの送信（ごくシンプルな操作であるはずです）についてリサーチをした結果、ありとあらゆるガイドに遭遇し、それぞれが違うことを述べているために、圧倒され、混乱してしまったかもしれません。今のあなたがそうだとしても、心配は要りません。誰しもその経験があるのです！それではまず、いくつかの基本的な事項を確認しておきましょう：

1. Alchemyはあなたの秘密鍵を保存しません

言い換えれば、Alchemyはあなたの代理として署名やトランザクションの送信を実行できません。これは、セキュリティ保護のための仕様です。 Alchemyがあなたの秘密鍵を入力するように要求することはありませんので、ホスティングされたノード（あるいは、あらゆる他人）に対して、あなたの秘密鍵を教えないでください。
AlchemyのコアAPIを使ってブロックチェーンから読み込むことは可能ですが、ブロックチェーンに書き込むためには、Alchemyを通じてトランザクションを送信する前に、何か別のものを使ってトランザクションに署名する必要があります（これは、その他すべてのノードサービスの場合も同様です）。

2. 「署名者」とは何か

署名者とは、あなたの秘密鍵を用いて、あなたのためにトランザクションに署名するユーザーです。このチュートリアルでは、トランザクションの署名にAlchemy web3 (opens in a new tab)を使用しますが、他のweb3ライブラリも使用できます。
フロントエンドにおける署名者の良い例はMetaMask (opens in a new tab)です。これはあなたの代理としてトランザクションに署名し、送信します。

3. 私のトランザクションに署名が必要なのはなぜですか？

イーサリアムのネットワーク上でトランザクションを送信したいユーザーは、トランザクションの送信元が本人であることを証明するために、常に（秘密鍵を用いて）トランザクションに署名する必要があります。
この秘密鍵は、あなたのイーサリアムアカウントに対する完全な管理権限を与え、あなた（あるいはアクセス権限を持つすべてのユーザー）に対して、あなたの代理としてトランザクションを実行することを許可するものですから、厳重に保護することが非常に重要です。

4. 秘密鍵を保護するには、どうすればよいですか？

秘密鍵の保護や、トランザクションの送信のために秘密鍵を使用するには、多くの方法があります。このチュートリアルでは、.envファイルを使用します。この他にも、秘密鍵を保存するために別のプロバイダーを利用したり、キーストア・ファイルを活用するなど、様々なオプションがあります。

5. `eth_sendTransaction`と`eth_sendRawTransaction`の違いは何ですか？

eth_sendTransactionとeth_sendRawTransactionはどちらも、トランザクションをイーサリアムのネットワークにブロードキャストし、将来のブロックに追加するためのイーサリアムAPIの関数です。ただし、トランザクションの署名については、以下のような違いがあります：

eth_sendTransaction (opens in a new tab)は、_未署名_のトランザクションを送信するために使用します。これは、送信先のノードがあなたの秘密鍵を管理し、チェーンにブロードキャストする前にトランザクションに署名する必要があることを意味します。 Alchemyはユーザーの秘密鍵を保持しないため、このメソッドはサポートしていません。
eth_sendRawTransaction (opens in a new tab)は、すでに署名されたトランザクションをブロードキャストするために使用されます。これは、最初にsignTransaction(tx, private_key) (opens in a new tab)を使用し、その結果をeth_sendRawTransactionに渡す必要があることを意味します。

web3を使用する場合、eth_sendRawTransactionにはweb3.eth.sendSignedTransaction (opens in a new tab)関数を呼び出すことでアクセスします。

このチュートリアルでは、これを使用します。

6. Web3ライブラリとは？

Web3.jsは、イーサリアム開発で非常に一般的に使用される、標準的なJSON-RPC呼び出しのラッパーライブラリです。
さまざまな言語に対応した数多くのweb3ライブラリが提供されています。このチュートリアルでは、JavaScriptで書かれたAlchemy Web3 (opens in a new tab)を使用します。 ethers.js (opens in a new tab)のような他の選択肢についてはこちら (opens in a new tab)を確認できます。

さて、これらの疑問が解消できたところで、さっそくチュートリアルを始めましょう。 Alchemyのdiscord (opens in a new tab)でいつでも気軽に質問してください！

7. 安全でガス最適化されたプライベートなトランザクションを送信する方法は？

AlchemyにはTransact APIスイートがあります (opens in a new tab)。これにより、強化されたトランザクションの送信、トランザクションが発生する前のシミュレーション、プライベートなトランザクションの送信、ガス最適化されたトランザクションの送信が可能です。
また、Notify API (opens in a new tab)を使用して、トランザクションがメンプールから取得されチェーンに追加されたときにアラートを受け取ることもできます。

**注意：**このガイドには、Alchemyアカウント、イーサリアムアドレスまたはMetaMaskウォレット、NodeJs、およびnpmのインストールが必要です。インストールが完了していない場合は、以下の手順で行ってください：

無料のAlchemyアカウントを作成 (opens in a new tab)
MetaMaskアカウントを作成する (opens in a new tab)（またはイーサリアムアドレスを取得する）
こちらの手順に従ってNodeJsとNPMをインストールしてください (opens in a new tab)

トランザクションを送信する手順

1. SepoliaテストネットでAlchemyアプリを作成する

Alchemyダッシュボード (opens in a new tab)に移動し、新規アプリを作成します。ネットワークにはSepolia（または他のテストネット）を選択してください。

2. SepoliaフォーセットからETHをリクエストする

Alchemy Sepoliaフォーセット (opens in a new tab)の指示に従って、ETHを受け取ってください。リクエストには、他のネットワークのアドレスではなく、必ずSepoliaのイーサリアムアドレス（MetaMaskから）を含めてください。指示を実行した後、ウォレットにETHが届いていることを再確認してください。

3. 新規プロジェクトディレクトリを作成し、`cd`で移動する

コマンドライン（Macの場合はターミナル）で新規のプロジェクトディレクトリを作成し、このディレクトリに移動します：

1mkdir sendtx-example
2cd sendtx-example

4. Alchemy Web3（または任意のweb3ライブラリ）をインストールする

プロジェクトディレクトリで以下のコマンドを実行し、Alchemy Web3 (opens in a new tab)をインストールしてください：

注：ethers.jsライブラリを使用したい場合は、こちらの指示に従ってください (opens in a new tab)。

1npm install @alch/alchemy-web3

5. dotenvをインストールする

APIキーと秘密鍵を安全に保存するために、.envファイルを使用します。

1npm install dotenv --save

6. `.env`ファイルを作成する

プロジェクトディレクトリに.envファイルを作成し、以下を追加してください（“your-api-url”と“your-private-key”を置き換えます）

AlchemyのAPI URLを見つけるには、ダッシュボードで作成したアプリの詳細ページに移動します。右上隅の「View Key」をクリックし、HTTP URLを選択します。
MetaMaskを使用して秘密鍵を見つけるには、このガイド (opens in a new tab)をご覧ください。

1API_URL = "your-api-url"
2PRIVATE_KEY = "your-private-key"

.envはコミットしないでください！ .envは決して他人と共有したり、公開したりしないように注意してください。共有することで、あなたのアカウント情報が漏洩する可能性があります。バージョンを管理する場合は、.envをgitignoreファイルに追加してください。

7. `sendTx.js`ファイルを作成する

機密データが.envファイルで保護されたので、さっそくコード作成を始めましょう。送信トランザクションの例として、ETHをSepoliaフォーセットに送り返します。

トランザクションの設定と送信を行うsendTx.jsファイルを作成し、その中に以下のコードを追加してください。

1async function main() {
2    require('dotenv').config();
3    const { API_URL, PRIVATE_KEY } = process.env;
4    const { createAlchemyWeb3 } = require("@alch/alchemy-web3");
5    const web3 = createAlchemyWeb3(API_URL);
6    const myAddress = '0x610Ae88399fc1687FA7530Aac28eC2539c7d6d63' //TODO: このアドレスをあなた自身の公開アドレスに置き換えてください
7
8    const nonce = await web3.eth.getTransactionCount(myAddress, 'latest'); // nonceは0からカウントを始めます
9
10    const transaction = {
11     'to': '0x31B98D14007bDEe637298086988A0bBd31184523', // ETHを返却するフォーセットのアドレス
12     'value': 1000000000000000000, // 1 ETH
13     'gas': 30000,
14     'nonce': nonce,
15     // メッセージの送信やスマートコントラクトを実行するためのオプションのデータフィールド
16    };
17
18    const signedTx = await web3.eth.accounts.signTransaction(transaction, PRIVATE_KEY);
19
20    web3.eth.sendSignedTransaction(signedTx.rawTransaction, function(error, hash) {
21    if (!error) {
22      console.log("🎉 トランザクションのハッシュは次の通りです: ", hash, "\n AlchemyのMempoolでトランザクションのステータスを確認してください！");
23    } else {
24      console.log("❗トランザクションの送信中に問題が発生しました:", error)
25    }
26   });
27}
28
29main();
すべて表示

6行目のアドレスは、あなたの公開アドレスに置き換えてください。

さて、このコードを実行する前に、ここでいくつかのコンポーネントについて説明しましょう。

nonce: ノンス仕様は、あなたのアドレスから送信されたトランザクション数を追跡するために使用されます。これはセキュリティ目的、およびリプレイ攻撃 (opens in a new tab)を防ぐために必要です。アドレスから送信されたトランザクション数を取得するには、getTransactionCount (opens in a new tab)を使用します。
transaction: トランザクションオブジェクトには指定する必要があるいくつかの側面があります
- to: ETHの送信先アドレスです。この場合、最初にリクエストしたSepoliaフォーセット (opens in a new tab)にETHを送り返します。
- value: Wei（10^18 Wei = 1 ETH）で指定した送金額です。
- gas: トランザクションに含まれる適切なガス量を決定する方法はたくさんあります。 Alchemyには、ガス価格が特定のしきい値内に下がったときに通知するガス価格ウェブフック (opens in a new tab)さえあります。メインネット上のトランザクションの場合、ETH Gas Station (opens in a new tab)などのガス推定ツールをチェックして、含めるべき適切なガス量を決定することをお勧めします。イーサリアムの操作に必要なガスの最小量は21000なので、トランザクションが確実に実行されるように、ここでは30000としておきます。
- nonce: 上記のノンスの定義を参照してください。ノンスは、0から開始されます。
- [任意] data: 送金やスマートコントラクトの呼び出しにおいて追加情報を送信するために使用します。残高転送の場合は必要ありません。以下の注記を確認してください。
signedTx: トランザクションオブジェクトへの署名には、PRIVATE_KEYを伴うsignTransactionメソッドを使用します。
sendSignedTransaction: トランザクションの署名を取得したら、sendSignedTransactionを使って、次のブロックに含まれるように送信できるようになります。

dataに関するメモ イーサリアムで送信できるトランザクションは主に2種類あります。

残高転送：あるアドレスから別のアドレスにETHを送信します。 dataフィールドは必要ありませんが、トランザクションと一緒に追加の情報を送信したい場合はこのフィールドにHEX形式で入力してください。
- 例えば、不変のタイムスタンプを与えるために、IPFS文書のハッシュをイーサリアムチェーンに記録したい場合を考えてみましょう。その場合、dataフィールドはdata: web3.utils.toHex(‘IPFS hash‘)のようになります。これにより、誰でもチェーンをクエリして、このドキュメントがいつ追加されたかを確認できるようになります。
スマートコントラクトのトランザクション：チェーン上でスマートコントラクトコードを実行します。この場合、dataフィールドは、パラメータと共に実行したいスマート関数を含む必要があります。
- 実践的な例については、このHello Worldチュートリアル (opens in a new tab)のステップ8をご覧ください。

8. `node sendTx.js`を使用してコードを実行する

ターミナルまたはコマンドラインに戻り、以下を実行します。

1node sendTx.js

9. メンプールでトランザクションを確認する

Alchemyダッシュボードのメンプールページ (opens in a new tab)を開き、作成したアプリでフィルタリングしてトランザクションを見つけます。ここでは、トランザクション処理が保留中の状態からマイニングされた状態（成功した場合）あるいはドロップした状態（失敗した場合）に遷移するのを確認できます。「All」の設定を変更せず、「マイニング済み」、「保留中」、および「ドロップ」のトランザクションをすべて捕捉できるようにしておきます。また、アドレス0x31b98d14007bdee637298086988a0bbd31184523に送信されたトランザクションを確認する方法でもあなたのトランザクションを検索できます。

あなたのトランザクションを見つけたら、当該のtxハッシュを選択してトランザクションの詳細を確認します。以下のようなビューが表示されるはずです：

赤い丸印で囲まれたアイコンをクリックすると、Etherscan上でトランザクションを確認できます！

やりましたね！ Alchemyを使用して、最初のイーサリアムトランザクションの送信に成功しました🎉

このガイドに関するフィードバックやご提案は、AlchemyのDiscord (opens in a new tab)でElanにメッセージをお送りください！

初出: https://docs.alchemyapi.io/tutorials/sending-transactions-using-web3-and-alchemy (opens in a new tab)

最終更新： 2025年12月18日

+16