JSON-RPC API

ソフトウェア・アプリケーションがイーサリアム・ブロックチェーンとやり取りするためには（ブロックチェーンのデータを読み取るにせよ、ネットワークにトランザクションを送信するにせよ）、イーサリアムのノードに接続する必要があります。

この目的のために、すべてのイーサリアム・クライアントはJSON-RPC仕様 (opens in a new tab)を実装しています。これにより、特定のノードやクライアントの実装に関係なく、アプリケーションが依存できる統一されたメソッドのセットが提供されます。

JSON-RPC (opens in a new tab)は、ステートレスで軽量なリモート・プロシージャ・コール（RPC）プロトコルです。いくつかのデータ構造と、その処理に関するルールを定義しています。トランスポートに依存しない性質を持ち、その概念は同一プロセス内、ソケット経由、HTTP経由、または様々なメッセージ・パッシング環境で使用できます。データ形式としてJSON（RFC 4627）を使用します。

クライアントの実装

イーサリアムのクライアントは、JSON-RPC仕様を実装する際に、それぞれ異なるプログラミング言語を使用する場合があります。特定のプログラミング言語に関連する詳細については、個々のクライアントのドキュメントを参照してください。最新のAPIサポート情報については、各クライアントのドキュメントを確認することをお勧めします。

便利なライブラリ

JSON-RPC APIを介してイーサリアム・クライアントと直接やり取りすることもできますが、分散型アプリケーション (dapp) の開発者には、より簡単なオプションが用意されていることがよくあります。JSON-RPC APIのラッパーを提供する、多くのJavaScriptおよびバックエンドAPIライブラリが存在します。これらのライブラリを使用すると、開発者は好みのプログラミング言語で直感的な1行のメソッドを記述し、イーサリアムとやり取りするJSON-RPCリクエストを（内部的に）初期化できます。

コンセンサス・クライアントAPI

このページでは主に、イーサリアムの実行クライアントで使用されるJSON-RPC APIについて説明します。しかし、コンセンサス・クライアントにもRPC APIがあり、ユーザーはノードに関する情報を照会したり、ビーコン・ブロック、ビーコン状態、その他のコンセンサス関連情報をノードから直接リクエストしたりすることができます。このAPIについては、Beacon APIのウェブページ (opens in a new tab)で文書化されています。

ノード内のクライアント間通信には内部APIも使用されます。つまり、コンセンサス・クライアントと実行クライアントがデータをスワップできるようにします。これは「Engine API」と呼ばれ、その仕様はGitHub (opens in a new tab)で公開されています。

実行クライアントの仕様

GitHubでJSON-RPC APIの完全な仕様を読む (opens in a new tab)。このAPIは実行APIのウェブページ (opens in a new tab)に文書化されており、利用可能なすべてのメソッドを試すことができるインスペクターが含まれています。

規則

16進数値のエンコーディング

JSONを介して渡される主要なデータ型には、フォーマットされていないバイト配列と数量の2つがあります。どちらも16進数エンコーディングで渡されますが、フォーマットの要件が異なります。

数量

数量（整数、数値）をエンコードする場合: 16進数としてエンコードし、プレフィックスとして「0x」を付け、最もコンパクトな表現にします（わずかな例外として、ゼロは「0x0」として表現する必要があります）。

以下にいくつか例を示します。

0x41 (10進数で65)
0x400 (10進数で1024)
誤り: 0x (常に少なくとも1桁の数字が必要です。ゼロは「0x0」です)
誤り: 0x0400 (先頭にゼロを付けることはできません)
誤り: ff (プレフィックスとして0xを付ける必要があります)

フォーマットされていないデータ

フォーマットされていないデータ（バイト配列、アカウントのアドレス、ハッシュ、バイトコード配列）をエンコードする場合: 16進数としてエンコードし、プレフィックスとして「0x」を付け、1バイトにつき2桁の16進数を使用します。

以下にいくつか例を示します。

0x41 (サイズ1、「A」)
0x004200 (サイズ3、「0B0」)
0x (サイズ0、「」)
誤り: 0xf0f0f (偶数桁である必要があります)
誤り: 004200 (プレフィックスとして0xを付ける必要があります)

ブロックパラメータ

以下のメソッドにはブロックパラメータがあります。

eth_getBalance
eth_getCode
eth_getTransactionCount
eth_getStorageAt
eth_call

イーサリアムの状態を照会するリクエストが行われる際、提供されたブロックパラメータによってブロックの高さが決定されます。

ブロックパラメータには以下のオプションが可能です。

HEX String - 整数のブロック番号
String "earliest" - 最古のブロック／ジェネシス・ブロック
String "latest" - 提案された最新のブロック
String "safe" - 最新の安全なヘッドブロック
String "finalized" - 最新のファイナライズ済みブロック
String "pending" - 保留中の状態／トランザクション

例

このページでは、コマンドラインツールであるcurl (opens in a new tab)を使用して、個々のJSON_RPC APIエンドポイントを使用する方法の例を提供します。これらの個々のエンドポイントの例は、以下のCurlの例セクションに記載されています。さらにページの下部では、Gethノード、JSON_RPC API、およびcurlを使用してスマート・コントラクトをコンパイルおよびデプロイするためのエンドツーエンドの例も提供しています。

Curlの例

イーサリアム・ノードに対してcurl (opens in a new tab)リクエストを行うことによるJSON_RPC APIの使用例を以下に示します。各例には、特定のエンドポイントの説明、そのパラメーター、戻り値の型、およびその使用方法の実際の例が含まれています。

curlリクエストは、コンテンツタイプに関連するエラーメッセージを返す場合があります。これは、--dataオプションがコンテンツタイプをapplication/x-www-form-urlencodedに設定するためです。ノードがこれについてエラーを出す場合は、呼び出しの先頭に-H "Content-Type: application/json"を配置して、ヘッダーを手動で設定してください。また、これらの例には、curlに渡す最後の引数として指定する必要があるURL/IPとポートの組み合わせ（例：127.0.0.1:8545）は含まれていません。これらの追加データを含む完全なcurlリクエストは、次の形式になります。

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545

ゴシップ、状態、履歴

一部のコアなJSON-RPCメソッドはイーサリアム・ネットワークからのデータを必要とし、主に3つのカテゴリ（ゴシップ、状態、履歴）に分類されます。これらのセクションのリンクを使用して各メソッドにジャンプするか、目次を使用してメソッドの全リストを確認してください。

ゴシップ・メソッド

これらのメソッドはチェーンの先頭を追跡します。これにより、トランザクションがネットワーク上を伝播してブロックに組み込まれる仕組みや、クライアントが新しいブロックを検出する仕組みが提供されます。

eth_blockNumber
eth_sendRawTransaction

状態メソッド

保存されているすべてのデータの現在の状態を報告するメソッドです。「状態」は1つの大きな共有RAMのようなものであり、アカウント残高、コントラクトのデータ、ガスの見積もりなどが含まれます。

eth_getBalance
eth_getStorageAt
eth_getTransactionCount
eth_getCode
eth_call
eth_estimateGas

履歴メソッド

ジェネシス・ブロックまで遡って、すべてのブロックの履歴レコードを取得します。これは1つの大きな追記専用ファイルのようなものであり、すべてのブロックヘッダー、ブロック本体、アンクルブロック、およびトランザクション・レシートが含まれます。

eth_getBlockTransactionCountByHash
eth_getBlockTransactionCountByNumber
eth_getUncleCountByBlockHash
eth_getUncleCountByBlockNumber
eth_getBlockByHash
eth_getBlockByNumber
eth_getTransactionByHash
eth_getTransactionByBlockHashAndIndex
eth_getTransactionByBlockNumberAndIndex
eth_getTransactionReceipt
eth_getUncleByBlockHashAndIndex
eth_getUncleByBlockNumberAndIndex

JSON-RPC API プレイグラウンド

プレイグラウンドツール (opens in a new tab)を使用して、APIメソッドを見つけて試すことができます。また、さまざまなノードプロバイダーがサポートしているメソッドやネットワークも確認できます。

JSON-RPC API メソッド

web3_clientVersion

現在のクライアントのバージョンを返します。

パラメータ

なし

戻り値

String - 現在のクライアントのバージョン

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// 結果
{
  "id":67,
  "jsonrpc":"2.0",
  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
}

web3_sha3

指定されたデータのケチャック・256（標準化された SHA3-256 ではなく）を返します。

パラメータ

DATA - SHA3 ハッシュに変換するデータ

params: ["0x68656c6c6f20776f726c64"]

戻り値

DATA - 指定された文字列の SHA3 の結果。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// 結果
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}

net_version

現在のネットワークIDを返します。

パラメータ

なし

戻り値

String - 現在のネットワークID。

現在のネットワークIDの完全なリストは、chainlist.org (opens in a new tab)で確認できます。一般的なものは以下の通りです。

1: イーサリアム・メインネット
11155111: Sepoliaテストネット
560048 : Hoodiテストネット

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// 結果
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "3"
}

net_listening

クライアントがネットワーク接続をアクティブにリッスンしている場合、true を返します。

パラメータ

なし

戻り値

Boolean - リッスンしている場合は true、それ以外の場合は false。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// 結果
{
  "id":67,
  "jsonrpc":"2.0",
  "result":true
}

net_peerCount

現在クライアントに接続されているピアの数を返します。

パラメータ

なし

戻り値

QUANTITY - 接続されているピアの数の整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// 結果
{
  "id":74,
  "jsonrpc": "2.0",
  "result": "0x2" // 2
}

eth_protocolVersion

現在のイーサリアム・プロトコルのバージョンを返します。このメソッドはGethでは利用できない (opens in a new tab)ことに注意してください。

パラメータ

なし

戻り値

String - 現在のイーサリアム・プロトコルのバージョン

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// 結果
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "54"
}

eth_syncing

同期ステータスに関するデータを含むオブジェクト、または false を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

なし

戻り値

正確な戻り値のデータはクライアントの実装によって異なります。ノードが同期していない場合、すべてのクライアントは False を返します。また、すべてのクライアントは以下のフィールドを返します。

Object|Boolean、同期ステータスデータを含むオブジェクト、または同期していない場合は FALSE:

startingBlock: QUANTITY - インポートが開始されたブロック（同期が先頭に達した後にのみリセットされます）
currentBlock: QUANTITY - 現在のブロック（eth_blockNumber と同じ）
highestBlock: QUANTITY - 推定される最も高いブロック

ただし、個々のクライアントは追加のデータを提供する場合もあります。たとえば、Geth は以下を返します。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "currentBlock": "0x3cf522",
    "healedBytecodeBytes": "0x0",
    "healedBytecodes": "0x0",
    "healedTrienodes": "0x0",
    "healingBytecode": "0x0",
    "healingTrienodes": "0x0",
    "highestBlock": "0x3e0e41",
    "startingBlock": "0x3cbed5",
    "syncedAccountBytes": "0x0",
    "syncedAccounts": "0x0",
    "syncedBytecodeBytes": "0x0",
    "syncedBytecodes": "0x0",
    "syncedStorage": "0x0",
    "syncedStorageBytes": "0x0"
  }
}

一方、ベスは以下を返します。

{
  "jsonrpc": "2.0",
  "id": 51,
  "result": {
    "startingBlock": "0x0",
    "currentBlock": "0x1518",
    "highestBlock": "0x9567a3",
    "pulledStates": "0x203ca",
    "knownStates": "0x200636"
  }
}

詳細については、特定のクライアントのドキュメントを参照してください。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": {
    startingBlock: '0x384',
    currentBlock: '0x386',
    highestBlock: '0x454'
  }
}
// または同期していない場合
{
  "id":1,
  "jsonrpc": "2.0",
  "result": false
}

eth_coinbase

クライアントのコインベース・アドレスを返します。

プレイグラウンドでエンドポイントを試す

注: このメソッドは v1.14.0 で非推奨となり、現在はサポートされていません。このメソッドを使用しようとすると、「Method not supported」エラーが発生します。

パラメータ

なし

戻り値

DATA、20バイト - 現在のコインベース・アドレス。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// 結果
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_chainId

リプレイ保護されたトランザクションの署名に使用されるチェーンIDを返します。

プレイグラウンドでエンドポイントを試す

パラメータ

なし

戻り値

chainId、現在のチェーンIDの整数を表す16進数値の文字列。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
// 結果
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "0x1"
}

eth_mining

クライアントが新しいブロックをアクティブにマイニングしている場合、true を返します。これはプルーフ・オブ・ワーク (PoW) ネットワークでのみ true を返す可能性があり、マージ以降、一部のクライアントでは利用できない場合があります。

プレイグラウンドでエンドポイントを試す

パラメータ

なし

戻り値

Boolean - クライアントがマイニングしている場合は true を返し、そうでない場合は false を返します。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
//
{
  "id":71,
  "jsonrpc": "2.0",
  "result": true
}

eth_hashrate

ノードがマイニングに使用している1秒あたりのハッシュ数を返します。これはプルーフ・オブ・ワーク (PoW) ネットワークに対してのみ true を返すことができ、マージ以降、一部のクライアントでは利用できない場合があります。

プレイグラウンドでエンドポイントを試す

パラメータ

なし

戻り値

QUANTITY - 1秒あたりのハッシュ数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// 結果
{
  "id":71,
  "jsonrpc": "2.0",
  "result": "0x38a"
}

eth_gasPrice

現在のガスあたりの価格の推定値をWei単位で返します。例えば、ベス・クライアントはデフォルトで過去100ブロックを調べ、ガス単価の中央値を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

なし

戻り値

QUANTITY - 現在のガス価格（Wei単位）の整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// 結果
{
  "id":73,
  "jsonrpc": "2.0",
  "result": "0x1dfd14000" // 8049999872 Wei
}

eth_accounts

クライアントが所有するアドレスのリストを返します。

プレイグラウンドでエンドポイントを試す

パラメータ

なし

戻り値

Array of DATA、20バイト - クライアントが所有するアドレス。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

eth_blockNumber

最新のブロック番号を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

なし

戻り値

QUANTITY - クライアントの現在のブロック番号を示す整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// 結果
{
  "id":83,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}

eth_getBalance

指定されたアドレスのアカウントの残高を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、20バイト - 残高を確認するアドレス。
QUANTITY|TAG - 整数値のブロック番号、または文字列 "latest"、"earliest"、"pending"、"safe"、"finalized"。ブロックパラメータを参照してください。

params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]

戻り値

QUANTITY - 現在の残高の整数値（単位：Wei）。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58" // 158972490234375000
}

eth_getStorageAt

指定されたアドレスのストレージ位置から値を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、20バイト - ストレージのアドレス。
QUANTITY - ストレージ内の位置を示す整数。
QUANTITY|TAG - 整数値のブロック番号、または文字列 "latest"、"earliest"、"pending"、"safe"、"finalized"。ブロックパラメータを参照してください。

戻り値

DATA - このストレージ位置にある値。

例正しい位置の計算は、取得するストレージによって異なります。アドレス 0x391694e7e0b0cce554cb130d723a9d27458f9298 によって 0x295a70b2de5e3953354a6a8344e616ed314d7251 にデプロイされた以下のコントラクトを考えてみましょう。

contract Storage {
    uint pos0;
    mapping(address => uint) pos1;
    constructor() {
        pos0 = 1234;
        pos1[msg.sender] = 5678;
    }
}

pos0 の値の取得は簡単です。

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}

マップの要素の取得はより複雑です。マップ内の要素の位置は次のように計算されます。

keccak(LeftPad32(key, 0), LeftPad32(map position, 0))

つまり、pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] のストレージを取得するには、次のように位置を計算する必要があります。

keccak(
  decodeHex(
    "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
      "0000000000000000000000000000000000000000000000000000000000000001"
  )
)

Web3ライブラリに付属しているGethコンソールを使用して、この計算を行うことができます。

> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"
undefined
> web3.sha3(key, {"encoding": "hex"})
"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"

これでストレージを取得できます。

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}

eth_getTransactionCount

あるアドレスから_送信された_トランザクションの数を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、20バイト - アドレス。
QUANTITY|TAG - 整数のブロック番号、または文字列 "latest"、"earliest"、"pending"、"safe"、"finalized"。ブロックパラメータを参照してください。

params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "latest", // 最新ブロックの状態
]

戻り値

QUANTITY - このアドレスから送信されたトランザクションの数の整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getBlockTransactionCountByHash

指定されたブロック・ハッシュに一致するブロック内のトランザクション数を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、32バイト - ブロックのハッシュ

params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]

戻り値

QUANTITY - このブロック内のトランザクション数の整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getBlockTransactionCountByNumber

指定されたブロック番号に一致するブロック内のトランザクション数を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

QUANTITY|TAG - ブロック番号の整数、またはブロックパラメータにある文字列 "earliest"、"latest"、"pending"、"safe"、"finalized" のいずれか。

params: [
  "0x13738ca", // 20396234
]

戻り値

QUANTITY - このブロック内のトランザクション数の整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getUncleCountByBlockHash

指定されたブロックハッシュに一致するブロック内のアンクルの数を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA, 32バイト - ブロックのハッシュ

params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]

戻り値

QUANTITY - このブロック内のアンクルの数の整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getUncleCountByBlockNumber

指定されたブロック番号に一致するブロック内のアンクルの数を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

QUANTITY|TAG - ブロック番号の整数、または文字列 "latest"、"earliest"、"pending"、"safe"、"finalized"。ブロックパラメータを参照してください。

params: [
  "0xe8", // 232
]

戻り値

QUANTITY - このブロック内のアンクルの数の整数。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0" // 0
}

eth_getCode

指定されたアドレスのコードを返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、20バイト - アドレス
QUANTITY|TAG - 整数値のブロック番号、または文字列 "latest"、"earliest"、"pending"、"safe"、"finalized"。ブロックパラメータを参照してください。

params: [
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "0x5daf3b", // 6139707
]

戻り値

DATA - 指定されたアドレスのコード。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
}

eth_sign

signメソッドは、sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)))を使用してイーサリアム固有の署名を計算します。

メッセージにプレフィックスを追加することで、計算された署名がイーサリアム固有の署名として認識されるようになります。これにより、悪意のある分散型アプリケーション (dapp) が任意のデータ（トランザクションなど）に署名し、その署名を使用して被害者になりすますといった悪用を防ぐことができます。

注: 署名に使用するアドレスはロック解除されている必要があります。

パラメーター

DATA、20バイト - アドレス
DATA、Nバイト - 署名するメッセージ

戻り値

DATA: 署名

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_signTransaction

eth_sendRawTransaction を使用して後でネットワークに送信できるトランザクションに署名します。

パラメーター

Object - トランザクション・オブジェクト

type:
from: DATA、20バイト - トランザクションの送信元アドレス。
to: DATA、20バイト - （新しいコントラクトを作成する場合はオプション）トランザクションの宛先アドレス。
gas: QUANTITY - （オプション、デフォルト: 90000）トランザクション実行のために提供されるガスの整数値。未使用のガスは返還されます。
gasPrice: QUANTITY - （オプション、デフォルト: 未定）支払われる各ガスに使用されるガス価格（Wei単位）の整数値。
value: QUANTITY - （オプション）このトランザクションで送信される値（Wei単位）の整数値。
data: DATA - コントラクトのコンパイルされたコード、または呼び出されたメソッドの署名とエンコードされたパラメーターのハッシュ。
nonce: QUANTITY - （オプション）ナンスの整数値。これにより、同じナンスを使用する自身の保留中のトランザクションを上書きできます。

戻り値

DATA、指定されたアカウントによって署名された、RLPエンコードされたトランザクション・オブジェクト。

例

// リクエスト
curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
// 結果
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_sendTransaction

data フィールドにコードが含まれている場合、新しいメッセージ・コール・トランザクションまたはコントラクト作成を行い、from で指定されたアカウントを使用して署名します。

パラメータ

Object - トランザクション・オブジェクト

from: DATA、20バイト - トランザクションの送信元アドレス。
to: DATA、20バイト - （新しいコントラクトを作成する場合はオプション）トランザクションの宛先アドレス。
gas: QUANTITY - （オプション、デフォルト: 90000）トランザクション実行のために提供されるガスの整数値。未使用のガスは返還されます。
gasPrice: QUANTITY - （オプション、デフォルト: 未定）支払われる各ガスに使用される gasPrice の整数値。
value: QUANTITY - （オプション）このトランザクションで送信される値の整数値。
input: DATA - コントラクトのコンパイル済みコード、または呼び出されたメソッド署名のハッシュとエンコードされたパラメータ。
nonce: QUANTITY - （オプション）ナンスの整数値。これにより、同じナンスを使用する自身の保留中トランザクションを上書きできます。

params: [
  {
    from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
    to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    gas: "0x76c0", // 30400
    gasPrice: "0x9184e72a000", // 10000000000000
    value: "0x9184e72a", // 2441406250
    input:
      "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
  },
]

戻り値

DATA、32バイト - トランザクション・ハッシュ。トランザクションがまだ利用できない場合はゼロハッシュ。

コントラクトを作成した場合、トランザクションがブロックに提案された後にコントラクトのアドレスを取得するには、eth_getTransactionReceipt を使用します。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_sendRawTransaction

署名済みトランザクションに対して、新しいメッセージ・コール・トランザクションまたはコントラクト作成を作成します。

パラメータ

DATA、署名済みトランザクション・データ。

params: [
  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
]

戻り値

DATA、32バイト - トランザクション・ハッシュ。トランザクションがまだ利用できない場合はゼロハッシュ。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

ブロックチェーン上にトランザクションを作成することなく、新しいメッセージ・コールを即座に実行します。ERC-20コントラクトの balanceOf など、読み取り専用のスマート・コントラクト関数の実行によく使用されます。

プレイグラウンドでエンドポイントを試す

パラメータ

Object - トランザクション・コール・オブジェクト

from: DATA、20バイト - (オプション) トランザクションの送信元アドレス。
to: DATA、20バイト - トランザクションの宛先アドレス。
gas: QUANTITY - (オプション) トランザクション実行のために提供されるガスの整数値。eth_callはガスを消費しませんが、一部の実行ではこのパラメータが必要になる場合があります。
gasPrice: QUANTITY - (オプション) 支払われる各ガスに使用されるgasPriceの整数値。
value: QUANTITY - (オプション) このトランザクションで送信される値の整数値。
input: DATA - (オプション) メソッド署名とエンコードされたパラメータのハッシュ。詳細については、Solidityドキュメントのイーサリアム・コントラクトABI (opens in a new tab)を参照してください。

QUANTITY|TAG - 整数値のブロック番号、または文字列 "latest"、"earliest"、"pending"、"safe"、"finalized"。ブロック・パラメータを参照してください。

戻り値

DATA - 実行されたコントラクトの戻り値。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x"
}

eth_estimateGas

トランザクションを完了させるために必要なガスの見積もりを生成して返します。トランザクションはブロックチェーンには追加されません。EVMのメカニズムやノードのパフォーマンスなど、さまざまな理由により、見積もり額がトランザクションで実際に使用されるガス量よりも大幅に多くなる可能性があることに注意してください。

プレイグラウンドでエンドポイントを試す

パラメーター

すべてのプロパティがオプションであることを除き、eth_callのパラメーターを参照してください。ガス・リミットが指定されていない場合、gethは保留中のブロックのブロック・ガス・リミットを上限として使用します。その結果、ガス量が保留中のブロックのガス・リミットよりも高い場合、返された見積もりではコールやトランザクションを実行するのに十分ではない可能性があります。

戻り値

QUANTITY - 使用されたガス量。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}

eth_getBlockByHash

ハッシュからブロックに関する情報を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、32バイト - ブロックのハッシュ。
Boolean - true の場合は完全なトランザクション・オブジェクトを返し、false の場合はトランザクションのハッシュのみを返します。

params: [
  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
  false,
]

戻り値

Object - ブロック・オブジェクト。ブロックが見つからない場合は null を返します。

number: QUANTITY - ブロック番号。保留中のブロックの場合は null。
hash: DATA、32バイト - ブロックのハッシュ。保留中のブロックの場合は null。
parentHash: DATA、32バイト - 親ブロックのハッシュ。
nonce: DATA、8バイト - 生成されたプルーフ・オブ・ワークのハッシュ。保留中のブロックの場合は null、プルーフ・オブ・ステークのブロック（マージ以降）の場合は 0x0。
sha3Uncles: DATA、32バイト - ブロック内のアンクル・データのSHA3。
logsBloom: DATA、256バイト - ブロックのログのブルーム・フィルタ。保留中のブロックの場合は null。
transactionsRoot: DATA、32バイト - ブロックのトランザクション・トライのルート。
stateRoot: DATA、32バイト - ブロックの最終ステート・トライのルート。
receiptsRoot: DATA、32バイト - ブロックのレシート・トライのルート。
miner: DATA、20バイト - ブロック報酬が与えられた受益者のアドレス。
difficulty: QUANTITY - このブロックの難易度の整数値。
totalDifficulty: QUANTITY - このブロックまでのチェーンの合計難易度の整数値。
extraData: DATA - このブロックの「エキストラ・データ」フィールド。
size: QUANTITY - このブロックのバイト単位のサイズの整数値。
gasLimit: QUANTITY - このブロックで許可されている最大ガス。
gasUsed: QUANTITY - このブロック内のすべてのトランザクションによって使用された合計ガス。
timestamp: QUANTITY - ブロックが生成されたときのUNIXタイムスタンプ。
transactions: Array - 最後に指定されたパラメータに応じて、トランザクション・オブジェクトの配列、または32バイトのトランザクション・ハッシュの配列。
uncles: Array - アンクル・ハッシュの配列。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
// 結果
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "difficulty": "0x4ea3f27bc",
    "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
    "gasLimit": "0x1388",
    "gasUsed": "0x0",
    "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
    "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
    "nonce": "0x689056015818adbe",
    "number": "0x1b4",
    "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x220",
    "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
    "timestamp": "0x55ba467c",
    "totalDifficulty": "0x78ed983323d",
    "transactions": [
    ],
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "uncles": [
    ]
  }
}

eth_getBlockByNumber

ブロック番号からブロックに関する情報を返します。

プレイグラウンドでエンドポイントを試す

パラメーター

QUANTITY|TAG - ブロック番号の整数、またはブロック・パラメーターにある文字列 "earliest"、"latest"、"pending"、"safe"、"finalized" のいずれか。
Boolean - true の場合は完全なトランザクション・オブジェクトを返し、false の場合はトランザクションのハッシュのみを返します。

params: [
  "0x1b4", // 436
  true,
]

戻り値 eth_getBlockByHash を参照してください。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'

結果については eth_getBlockByHash を参照してください。

eth_getTransactionByHash

トランザクション・ハッシュによってリクエストされたトランザクションに関する情報を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、32バイト - トランザクションのハッシュ

params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

戻り値

Object - トランザクション・オブジェクト。トランザクションが見つからなかった場合は null を返します。

blockHash: DATA、32バイト - このトランザクションが含まれているブロックのハッシュ。保留中の場合は null。
blockNumber: QUANTITY - このトランザクションが含まれているブロック番号。保留中の場合は null。
from: DATA、20バイト - 送信者のアドレス。
gas: QUANTITY - 送信者が提供したガス。
gasPrice: QUANTITY - 送信者が提供したガス価格（Wei単位）。
hash: DATA、32バイト - トランザクションのハッシュ。
input: DATA - トランザクションと一緒に送信されたデータ。
nonce: QUANTITY - このトランザクションより前に送信者が行ったトランザクションの数。
to: DATA、20バイト - 受信者のアドレス。コントラクト作成トランザクションの場合は null。
transactionIndex: QUANTITY - ブロック内のトランザクションのインデックス位置を示す整数。保留中の場合は null。
value: QUANTITY - 転送された値（Wei単位）。
v: QUANTITY - ECDSAリカバリID
r: QUANTITY - ECDSA署名 r
s: QUANTITY - ECDSA署名 s

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
// 結果
{
  "jsonrpc":"2.0",
  "id":1,
  "result":{
    "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
    "blockNumber":"0x5daf3b", // 6139707
    "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",
    "gas":"0xc350", // 50000
    "gasPrice":"0x4a817c800", // 20000000000
    "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
    "input":"0x68656c6c6f21",
    "nonce":"0x15", // 21
    "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",
    "transactionIndex":"0x41", // 65
    "value":"0xf3dbb76162000", // 4290000000000000
    "v":"0x25", // 37
    "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",
    "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"
  }
}

eth_getTransactionByBlockHashAndIndex

ブロックのハッシュとトランザクションのインデックス位置から、トランザクションに関する情報を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、32バイト - ブロックのハッシュ。
QUANTITY - トランザクションのインデックス位置の整数。

params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

戻り値 eth_getTransactionByHash を参照してください

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

結果については、eth_getTransactionByHash を参照してください

eth_getTransactionByBlockNumberAndIndex

ブロック番号とトランザクションのインデックス位置に基づいて、トランザクションに関する情報を返します。

プレイグラウンドでエンドポイントを試す

パラメーター

QUANTITY|TAG - ブロック番号、またはブロック・パラメーターで説明されている文字列 "earliest"、"latest"、"pending"、"safe"、"finalized" のいずれか。
QUANTITY - トランザクションのインデックス位置。

params: [
  "0x9c47cf", // 10241999
  "0x24", // 36
]

戻り値 eth_getTransactionByHashを参照してください。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'

結果についてはeth_getTransactionByHashを参照してください。

eth_getTransactionReceipt

トランザクション・ハッシュからトランザクションのレシートを返します。

注: 保留中のトランザクションのレシートは利用できません。

パラメータ

DATA、32バイト - トランザクションのハッシュ

params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]

戻り値 Object - トランザクション・レシート・オブジェクト。レシートが見つからない場合は null を返します。

transactionHash : DATA、32バイト - トランザクションのハッシュ。
transactionIndex: QUANTITY - ブロック内のトランザクションのインデックス位置を示す整数。
blockHash: DATA、32バイト - このトランザクションが含まれていたブロックのハッシュ。
blockNumber: QUANTITY - このトランザクションが含まれていたブロック番号。
from: DATA、20バイト - 送信者のアドレス。
to: DATA、20バイト - 受信者のアドレス。コントラクト作成トランザクションの場合は null。
cumulativeGasUsed : QUANTITY - このトランザクションがブロック内で実行されたときに使用されたガスの総量。
effectiveGasPrice : QUANTITY - ガス1単位あたりに支払われた基本料金とチップの合計。
gasUsed : QUANTITY - この特定のトランザクション単独で使用されたガスの量。
contractAddress : DATA、20バイト - トランザクションがコントラクト作成であった場合は作成されたコントラクトのアドレス、それ以外の場合は null。
logs: Array - このトランザクションが生成したログ・オブジェクトの配列。
logsBloom: DATA、256バイト - ライト・クライアントが関連するログをすばやく取得するためのブルーム・フィルター。
type: QUANTITY - トランザクション・タイプを示す整数。レガシー・トランザクションの場合は 0x0、アクセス・リスト・タイプの場合は 0x1、動的料金の場合は 0x2。

また、以下の_いずれか_を返します。

root : DATA 32バイトのトランザクション後の状態ルート（ビザンチウム以前）
status: QUANTITY 1（成功）または 0`（失敗）のいずれか

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'
// 結果
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash":
      "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",
    "blockNumber": "0xeff35f",
    "contractAddress": null, // 作成された場合はアドレスの文字列
    "cumulativeGasUsed": "0xa12515",
    "effectiveGasPrice": "0x5a9c688d4",
    "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",
    "gasUsed": "0xb4c8",
    "logs": [{
      // getFilterLogsなどによって返されるログ
    }],
    "logsBloom": "0x00...0", // 256バイトのブルームフィルター
    "status": "0x1",
    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "transactionHash":
      "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",
    "transactionIndex": "0x66",
    "type": "0x2"
  }
}

eth_getUncleByBlockHashAndIndex

ハッシュとアンクルのインデックス位置を指定して、ブロックのアンクルに関する情報を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

DATA、32バイト - ブロックのハッシュ。
QUANTITY - アンクルのインデックス位置。

params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

戻り値 eth_getBlockByHash を参照してください

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

結果については eth_getBlockByHash を参照してください

注: アンクルには個別のトランザクションは含まれません。

eth_getUncleByBlockNumberAndIndex

ブロック番号とアンクルのインデックス位置を指定して、ブロックのアンクルに関する情報を返します。

プレイグラウンドでエンドポイントを試す

パラメータ

QUANTITY|TAG - ブロック番号、またはブロック・パラメータで説明されている文字列 "earliest"、"latest"、"pending"、"safe"、"finalized" のいずれか。
QUANTITY - アンクルのインデックス位置。

params: [
  "0x29c", // 668
  "0x0", // 0
]

戻り値 eth_getBlockByHash を参照してください

注: アンクルには個別のトランザクションは含まれません。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'

結果については eth_getBlockByHash を参照してください

eth_newFilter

フィルターオプションに基づいてフィルターオブジェクトを作成し、状態が変更されたとき（ログ）に通知します。状態が変更されたかどうかを確認するには、eth_getFilterChangesを呼び出します。

トピックフィルターの指定に関する注意: トピックは順序に依存します。トピック[A, B]を持つログを含むトランザクションは、以下のトピックフィルターに一致します。

[] 「任意」
[A] 「最初の位置にA（およびそれ以降は任意）」
[null, B] 「最初の位置は任意、かつ2番目の位置にB（およびそれ以降は任意）」
[A, B] 「最初の位置にA、かつ2番目の位置にB（およびそれ以降は任意）」
[[A, B], [A, B]] 「最初の位置に（AまたはB）、かつ2番目の位置に（AまたはB）（およびそれ以降は任意）」
パラメーター

Object - フィルターオプション:

fromBlock: QUANTITY|TAG - （オプション、デフォルト: "latest"）整数のブロック番号。または、最後に提案されたブロックの場合は"latest"、最新の安全なブロックの場合は"safe"、最新のファイナライズ済みブロックの場合は"finalized"、まだブロックに含まれていないトランザクションの場合は"pending"、"earliest"。
toBlock: QUANTITY|TAG - （オプション、デフォルト: "latest"）整数のブロック番号。または、最後に提案されたブロックの場合は"latest"、最新の安全なブロックの場合は"safe"、最新のファイナライズ済みブロックの場合は"finalized"、まだブロックに含まれていないトランザクションの場合は"pending"、"earliest"。
address: DATA|Array、20バイト - （オプション）ログの発生元となるコントラクトのアドレス、またはアドレスのリスト。
topics: Array of DATA - （オプション）32バイトのDATAトピックの配列。トピックは順序に依存します。各トピックは、「または（or）」オプションを持つDATAの配列にすることもできます。

params: [
  {
    fromBlock: "0x1",
    toBlock: "0x2",
    address: "0x8888f1f195afa192cfee860698584c030f4c9db1",
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      null,
      [
        "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
        "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc",
      ],
    ],
  },
]

戻り値 QUANTITY - フィルターID。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_newBlockFilter

新しいブロックが到着したときに通知するフィルターをノード内に作成します。状態が変更されたかどうかを確認するには、eth_getFilterChanges を呼び出します。

パラメーター なし

戻り値 QUANTITY - フィルターID。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
// 結果
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_newPendingTransactionFilter

新しい保留中のトランザクションが到着したときに通知するために、ノードにフィルターを作成します。状態が変更されたかどうかを確認するには、eth_getFilterChangesを呼び出します。

パラメーター なし

戻り値 QUANTITY - フィルターID。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
// 結果
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_uninstallFilter

指定されたIDのフィルターをアンインストールします。監視が不要になった場合は、常に呼び出す必要があります。さらに、フィルターは一定期間 eth_getFilterChanges でリクエストされないとタイムアウトします。

パラメーター

QUANTITY - フィルターID。

params: [
  "0xb", // 11
]

戻り値 Boolean - フィルターが正常にアンインストールされた場合は true、それ以外の場合は false。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
// 結果
{
  "id":1,
  "jsonrpc": "2.0",
  "result": true
}

eth_getFilterChanges

フィルターのポーリングメソッドです。前回のポーリング以降に発生したログの配列を返します。

パラメーター

QUANTITY - フィルターID。

params: [
  "0x16", // 22
]

戻り値 Array - ログオブジェクトの配列。前回のポーリング以降に変更がない場合は空の配列になります。

eth_newBlockFilter で作成されたフィルターの場合、戻り値はブロックのハッシュ (DATA、32バイト) になります。例: ["0x3454645634534..."]。
eth_newPendingTransactionFilter で作成されたフィルターの場合、戻り値はトランザクション・ハッシュ (DATA、32バイト) になります。例: ["0x6345343454645..."]。
eth_newFilter で作成されたフィルターの場合、ログは以下のパラメーターを持つオブジェクトになります。
- removed: TAG - チェーンのリオーグによりログが削除された場合は true。有効なログの場合は false。
- logIndex: QUANTITY - ブロック内におけるログのインデックス位置を示す整数。保留中のログの場合は null。
- transactionIndex: QUANTITY - ログの作成元となったトランザクションのインデックス位置を示す整数。保留中のログの場合は null。
- transactionHash: DATA、32バイト - このログの作成元となったトランザクションのハッシュ。保留中のログの場合は null。
- blockHash: DATA、32バイト - このログが含まれていたブロックのハッシュ。保留中の場合は null。保留中のログの場合は null。
- blockNumber: QUANTITY - このログが含まれていたブロック番号。保留中の場合は null。保留中のログの場合は null。
- address: DATA、20バイト - このログの発生元のアドレス。
- data: DATA - 可変長のインデックス化されていないログデータ。（Solidity の場合: 0個以上の32バイトのインデックス化されていないログ引数。）
- topics: Array of DATA - 0〜4個の32バイト DATA のインデックス化されたログ引数の配列。（Solidity の場合: イベントを anonymous 指定子で宣言した場合を除き、最初のトピックはイベントの署名の_ハッシュ_（例: Deposit(address,bytes32,uint256)）になります。）
例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'
// 結果
{
  "id":1,
  "jsonrpc":"2.0",
  "result": [{
    "logIndex": "0x1", // 1
    "blockNumber":"0x1b4", // 436
    "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
    "transactionHash":  "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
    "transactionIndex": "0x0", // 0
    "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
    "data":"0x0000000000000000000000000000000000000000000000000000000000000000",
    "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]
    },{
      ...
    }]
}

eth_getFilterLogs

指定されたIDのフィルターに一致するすべてのログの配列を返します。

パラメーター

QUANTITY - フィルターID。

params: [
  "0x16", // 22
]

戻り値 eth_getFilterChangesを参照してください。

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'

結果についてはeth_getFilterChangesを参照してください。

eth_getLogs

指定されたフィルターオブジェクトに一致するすべてのログの配列を返します。

パラメーター

Object - フィルターオプション:

fromBlock: QUANTITY|TAG - (オプション、デフォルト: "latest") 整数値のブロック番号。または、最後に提案されたブロックの場合は "latest"、最新の安全なブロックの場合は "safe"、最新のファイナライズ済みブロックの場合は "finalized"、まだブロックに含まれていないトランザクションの場合は "pending" または "earliest"。
toBlock: QUANTITY|TAG - (オプション、デフォルト: "latest") 整数値のブロック番号。または、最後に提案されたブロックの場合は "latest"、最新の安全なブロックの場合は "safe"、最新のファイナライズ済みブロックの場合は "finalized"、まだブロックに含まれていないトランザクションの場合は "pending" または "earliest"。
address: DATA|Array、20バイト - (オプション) ログの発生元となるコントラクトアドレス、またはアドレスのリスト。
topics: Array of DATA - (オプション) 32バイトの DATA トピックの配列。トピックは順序に依存します。各トピックは、「or」オプションを持つDATAの配列にすることもできます。
blockHash: DATA、32バイト - (オプション、将来) EIP-234の追加により、blockHash は返されるログを32バイトのハッシュ blockHash を持つ単一のブロックに制限する新しいフィルターオプションになります。blockHash の使用は、fromBlock = toBlock = ハッシュ blockHash を持つブロック番号、と同等です。フィルター条件に blockHash が存在する場合、fromBlock と toBlock のどちらも許可されません。

params: [
  {
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    ],
  },
]

戻り値 eth_getFilterChanges を参照してください

例

// リクエスト
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'

結果については eth_getFilterChanges を参照してください

使用例

JSON_RPCを使用したコントラクトのデプロイ

このセクションでは、RPCインターフェースのみを使用してコントラクトをデプロイする方法を実演します。このような複雑さを抽象化した、コントラクトをデプロイする別の方法もあります。例えば、RPCインターフェースの上に構築されたWeb3.js (opens in a new tab)やWeb3.py (opens in a new tab)などのライブラリを使用する方法です。これらの抽象化は一般的に理解しやすく、エラーが発生しにくいですが、内部の仕組みを理解することは依然として役立ちます。

以下は、JSON-RPCインターフェースを使用してイーサリアムのノードにデプロイされる、Multiply7と呼ばれるシンプルなスマート・コントラクトです。このチュートリアルでは、読者がすでにGethノードを実行していることを前提としています。ノードとクライアントに関する詳細情報はこちらで確認できます。Geth以外のクライアントでHTTP JSON-RPCを開始する方法については、個々のクライアントのドキュメントを参照してください。ほとんどのクライアントは、デフォルトでlocalhost:8545でサービスを提供します。

contract Multiply7 {
    event Print(uint);
    function multiply(uint input) returns (uint) {
        Print(input * 7);
        return input * 7;
    }
}

最初に行うべきことは、HTTP RPCインターフェースが有効になっていることを確認することです。つまり、起動時にGethに--httpフラグを指定します。この例では、プライベートな開発チェーン上のGethノードを使用します。このアプローチを使用すると、実際のネットワーク上のイーサは必要ありません。

geth --http --dev console 2>>geth.log

これにより、http://localhost:8545でHTTP RPCインターフェースが開始されます。

curl (opens in a new tab)を使用してコインベースのアドレス（アカウントの配列から最初のアドレスを取得）と残高を取得することで、インターフェースが実行されていることを確認できます。これらの例のデータは、ローカルのノードでは異なることに注意してください。これらのコマンドを試す場合は、2番目のcurlリクエストのリクエストパラメータを、最初のリクエストから返された結果に置き換えてください。

curl --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[], "id":1}' -H "Content-Type: application/json" localhost:8545
{"id":1,"jsonrpc":"2.0","result":["0x9b1d35635cc34752ca54713bb99d38614f63c955"]}

curl --data '{"jsonrpc":"2.0","method":"eth_getBalance", "params": ["0x9b1d35635cc34752ca54713bb99d38614f63c955", "latest"], "id":2}' -H "Content-Type: application/json" localhost:8545
{"id":2,"jsonrpc":"2.0","result":"0x1639e49bba16280000"}

数値は16進数でエンコードされているため、残高はWei単位の16進数文字列として返されます。残高をイーサ単位の数値として取得したい場合は、GethコンソールからWeb3を使用できます。

web3.fromWei("0x1639e49bba16280000", "ether")
// "410"

プライベートな開発チェーンにいくらかのイーサが用意できたので、コントラクトをデプロイできます。最初のステップは、Multiply7コントラクトをEVMに送信できるバイトコードにコンパイルすることです。Solidityコンパイラであるsolcをインストールするには、Solidityのドキュメント (opens in a new tab)に従ってください。（この例で使用されているコンパイラのバージョン (opens in a new tab)に合わせるために、古いsolcリリースを使用することをお勧めします。）

次のステップは、Multiply7コントラクトをEVMに送信できるバイトコードにコンパイルすることです。

echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin

======= <stdin>:Multiply7 =======
Binary:
6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029

コンパイルされたコードが用意できたので、デプロイにどれくらいのガスがかかるかを判断する必要があります。RPCインターフェースには、見積もりを提供するeth_estimateGasメソッドがあります。

curl --data '{"jsonrpc":"2.0","method": "eth_estimateGas", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 5}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":5,"result":"0x1c31e"}

そして最後に、コントラクトをデプロイします。

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "gas": "0x1c31e", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 6}' -H "Content-Type: application/json" localhost:8545
{"id":6,"jsonrpc":"2.0","result":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"}

トランザクションはノードによって受け入れられ、トランザクション・ハッシュが返されます。このハッシュを使用して、トランザクションを追跡できます。次のステップは、コントラクトがデプロイされたアドレスを特定することです。実行された各トランザクションはレシートを作成します。このレシートには、トランザクションがどのブロックに含まれたか、EVMによってどれくらいのガスが使用されたかなど、トランザクションに関するさまざまな情報が含まれています。トランザクションがコントラクトを作成する場合、コントラクトのアドレスも含まれます。eth_getTransactionReceipt RPCメソッドを使用してレシートを取得できます。

curl --data '{"jsonrpc":"2.0","method": "eth_getTransactionReceipt", "params": ["0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"], "id": 7}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":7,"result":{"blockHash":"0x77b1a4f6872b9066312de3744f60020cbd8102af68b1f6512a05b7619d527a4f","blockNumber":"0x1","contractAddress":"0x4d03d617d700cf81935d7f797f4e2ae719648262","cumulativeGasUsed":"0x1c31e","from":"0x9b1d35635cc34752ca54713bb99d38614f63c955","gasUsed":"0x1c31e","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf","transactionIndex":"0x0"}}

コントラクトは0x4d03d617d700cf81935d7f797f4e2ae719648262に作成されました。レシートの代わりにnullの結果が返された場合、トランザクションがまだブロックに含まれていないことを意味します。しばらく待ってから、コンセンサス・クライアントが実行されているか確認し、再試行してください。

スマート・コントラクトとの対話

この例では、eth_sendTransactionを使用してコントラクトのmultiplyメソッドにトランザクションを送信します。

eth_sendTransactionにはいくつかの引数、具体的にはfrom、to、およびdataが必要です。Fromはアカウントのパブリックアドレスであり、toはコントラクトのアドレスです。data引数には、どのメソッドをどの引数で呼び出すかを定義するペイロードが含まれています。ここでABI（アプリケーション・バイナリ・インターフェース） (opens in a new tab)の出番となります。ABIは、EVM用のデータを定義およびエンコードする方法を定義するJSONファイルです。

ペイロードのバイトは、コントラクト内のどのメソッドが呼び出されるかを定義します。これは、関数名とその引数の型に対するKeccakハッシュの最初の4バイトを16進数でエンコードしたものです。multiply関数は、uint256のエイリアスであるuintを受け入れます。これにより、次のようになります。

web3.sha3("multiply(uint256)").substring(0, 10)
// "0xc6888fa1"

次のステップは、引数をエンコードすることです。uint256は1つだけで、例えば値6とします。ABIには、uint256型をエンコードする方法を指定するセクションがあります。

int<M>: enc(X)はXのビッグ・エンディアンの2の補数エンコーディングであり、長さが32バイトの倍数になるように、負のXの場合は上位（左）側に0xffが埋め込まれ、正のXの場合はゼロバイトが埋め込まれます。

これは0000000000000000000000000000000000000000000000000000000000000006にエンコードされます。

関数セレクタとエンコードされた引数を組み合わせると、データは0xc6888fa10000000000000000000000000000000000000000000000000000000000000006になります。

これをノードに送信できるようになりました。

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0xeb85a5557e5bdc18ee1934a89d8bb402398ee26a", "to": "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d", "data": "0xc6888fa10000000000000000000000000000000000000000000000000000000000000006"}], "id": 8}' -H "Content-Type: application/json" localhost:8545
{"id":8,"jsonrpc":"2.0","result":"0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74"}

トランザクションが送信されたため、トランザクション・ハッシュが返されました。レシートを取得すると次のようになります。

{
   blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
   blockNumber: 268,
   contractAddress: null,
   cumulativeGasUsed: 22631,
   gasUsed: 22631,
   logs: [{
      address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d",
      blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
      blockNumber: 268,
      data: "0x000000000000000000000000000000000000000000000000000000000000002a",
      logIndex: 0,
      topics: ["0x24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"],
      transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
      transactionIndex: 0
  }],
  transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
  transactionIndex: 0
}

レシートにはログが含まれています。このログは、トランザクションの実行時にEVMによって生成され、レシートに含まれました。multiply関数は、入力の7倍の値でPrintイベントが発生したことを示しています。Printイベントの引数はuint256であったため、ABIのルールに従ってデコードでき、期待される10進数の42が得られます。データとは別に、トピックを使用してどのイベントがログを作成したかを判断できることは注目に値します。

web3.sha3("Print(uint256)")
// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"

これは、JSON-RPCの直接的な使用法を示す、最も一般的なタスクのいくつかについての簡単な紹介にすぎません。

JSON-RPC API

クライアントの実装

便利なライブラリ

コンセンサス・クライアントAPI

実行クライアントの仕様

規則

16進数値のエンコーディング

数量

フォーマットされていないデータ

ブロックパラメータ

例

Curlの例

ゴシップ、状態、履歴

ゴシップ・メソッド

状態メソッド

履歴メソッド

JSON-RPC API プレイグラウンド

JSON-RPC API メソッド

web3_clientVersion

web3_sha3

net_version

net_listening

net_peerCount

eth_protocolVersion

eth_syncing

eth_coinbase

eth_chainId

eth_mining

eth_hashrate

eth_gasPrice

eth_accounts

eth_blockNumber

eth_getBalance

eth_getStorageAt

eth_getTransactionCount

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByNumber

eth_getUncleCountByBlockHash

eth_getUncleCountByBlockNumber

eth_getCode

eth_sign

eth_signTransaction

eth_sendTransaction

eth_sendRawTransaction

eth_call

eth_estimateGas

eth_getBlockByHash

eth_getBlockByNumber

eth_getTransactionByHash

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionReceipt

eth_getUncleByBlockHashAndIndex

eth_getUncleByBlockNumberAndIndex

eth_newFilter

eth_newBlockFilter

eth_newPendingTransactionFilter

eth_uninstallFilter

eth_getFilterChanges

eth_getFilterLogs

eth_getLogs

使用例

JSON_RPCを使用したコントラクトのデプロイ

スマート・コントラクトとの対話

関連トピック