はじめに
- Geth と呼ばれる Ethreum クライアントは、JSON RPC API を提供することができます。
- JSON RPC API を使用することで、Geth を実行せずに、外部のサーバ（ノード）を使用して、Ether の残高を取得したり、トランザクションを投げたりすることができます。
- ただし、JSON RPC API を提供しているサーバが返す値を読む形になるので、そのサーバを信用する必要があります。
- 通常は、自らが所有するサーバの JSON RPC API を使用することが望ましいと思いますが、この記事では Infura というサービスが提供する JSON RPC API を使用します。
- Infura のサーバ上で動いている Geth に、API 経由でアクセスするといった形になります。
Infura に登録して API Key 取得
- Infura を使用するために、API Key を取得する必要があります。
- https://infura.io/ でメールアドレスを登録すると、次のようなフォーマットで API Key つきの URL がメールで送られてきます。
- https://mainnet.infura.io/xxxxxxxxxx
curl で JSON RPC API にアクセス
- 今回は Ethereum アドレスの残高を知りたいので、Geth の JSON RPC API
eth_getBalanceを使用します。 - API ドキュメント
API に渡すパラメータ
-
DATA: 残高を取得したい Ethereum アドレス -
QUANTITY|TAG: ブロックの番号または、"latest"つまり最新のブロックを指定
"params" : [
"0xF02c1c8e6114b1Dbe8937a39260b5b0a374432bB",
"latest"
]
リクエストのサンプル
- 実際に使用する際は、次の箇所を変更してください
-
YOUR_API_KEYの部分を、自分の API Key に変更してください。 - アドレス
0xF02c1c8e6114b1Dbe8937a39260b5b0a374432bBを、残高を調べたいアドレスに変更してください。
curl -i -X POST \
-H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0xF02c1c8e6114b1Dbe8937a39260b5b0a374432bB","latest"],"id":1}' \
"https://mainnet.infura.io/YOUR_API_KEY"
レスポンスのサンプル
HTTP/2 200
date: Mon, 30 Apr 2018 18:21:08 GMT
content-type: application/json
content-length: 55
server: nginx/1.10.3 (Ubuntu)
vary: Origin
{"jsonrpc":"2.0","id":1,"result":"0x2453625cffc4f000"}
- この
resultの値が Ethereum アドレスの残高になります。 - この値は16進数なので、次のようなコマンド等で10進数に直すと wei の値になります。
echo $((16#2453625cffc4f000))
# => 2617543960000000000
- 1 Ether = 1000000000000000000 Wei なので、今回は
2617543960000000000を1000000000000000000で割った値2.61754396が残高になります。
参考
- http://blog.playground.io/entry/2018/05/01/035823
- https://scrapbox.io/playground/Infura_%E3%81%AE_JSON_RPC_API_%E3%81%A7_Ethereum_%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9%E3%81%AE%E6%AE%8B%E9%AB%98%E3%82%92%E5%8F%96%E5%BE%97
- https://github.com/ethereum/wiki/wiki/JSON-RPC#eth_getbalance
- https://infura.io/docs/gettingStarted/makeRequests
sushiether
- Ethereum 関連の情報は https://scrapbox.io/sushiether/ に集約することにしました。
- この記事の内容に変更・更新がある場合は、Infura の JSON RPC API で Ethereum アドレスの残高を取得 - sushiether を更新します。