【実装してみた】API（GET）を使用してIOSTブロックチェーンからデータを取得する

こんにちは、IOSTに人生託したマンです。

私は210万枚のIOSTをもち、パートナーノード「Takuman」を運営している、IOST大好き人間でございます。

IOSTのエコシステムが発展すべく、SNSや当ブログで情報発信をしているわけですが、最近、こんなことを思うようになりました。

そんなわけで、IOSTが公開している開発者向けのドキュメントや、ネットに落ちている情報を読み込み、なんとかAPI（GETのみ）を使うことができるようになったので、自分の頭の整理の意味も込めて、この記事でまとめてみました。

ただ単に使用できるAPI（GET）をまとめるだけだと面白くないので、ボタンを押すとIOSTブロックチェーンへAPI（GET）リクエストを送信し、データを取得できる機能（JavascriptのFetchを使用）も実装してみました。

何か開発しようと思っている方は参考にしてみてください。

API（GETのみ）の一覧

IOSTサーバーノードの情報を取得する（/getNodeInfo）

https://api.iost.io/getNodeInfo

IOSTブロックチェーンの情報を取得（/getChainInfo）

https://api.iost.io/getChainInfo

GAS情報を取得（/getGasRatio）

https://api.iost.io/getGasRatio

RAM情報を取得（/getRAMRatio）

https://api.iost.io/getRAMInfo

トランザクション情報の取得（/getTxByHash{ハッシュ}）

https://api.iost.io/getTxByHash/<transaction Hash>

ハッシュ値の検索が面倒くさい人は「F1BPcqBJuzZD2oujmxzxSYLmJoQdJj66G5fTEANWDAcS」を使ってね。

トランザクションレシート情報の取得（/getTxReceiptByTxHash/{ハッシュ}）

https://api.iost.io/getTxReceiptByTxHash/<transaction Hash>

ハッシュ値の検索が面倒くさい人は「F1BPcqBJuzZD2oujmxzxSYLmJoQdJj66G5fTEANWDAcS」を使ってね。

ブロックハッシュを使用したブロック情報の取得（/getBlockByHash/{ハッシュ}/{true or false}）

https://api.iost.io/getBlockByHash/<block Hash>/true

https://api.iost.io/getBlockByHash/<block Hash>/false

ハッシュ値の検索が面倒くさい人は「BUC7NNpStwx4Y9xttaAFGx6YCQXhdEXBQMGbbYBcKqxs」を使ってね。

ブロック番号を使用したブロック情報の取得（/getBlockByNumber/{番号}/{true or false}）

https://api.iost.io/getBlockByNumber/<block number>/true

https://api.iost.io/getBlockByNumber/<block number>/false

ブロック番号の検索が面倒くさい人は「305933560」を使ってね。

アカウント情報の取得（/getAccount/{アカウント名}/{true or false}）

https://api.iost.io/getAccount/<account name>/true

https://api.iost.io/getAccount/<account name>/false

ご自身のIOSTアカウント名を入れてみましょう！ちなみに、私のIOSTアカウント名は「takuman」です。

IOSTの保有枚数や、投票状況が丸見えだあ

指定したトークンのアカウント残高の取得（/getTokenBalance/{アカウント名}/{トークン名}/{true or false}）

https://api.iost.io/getTokenBalance/<account name>/<token name>/true

https://api.iost.io/getTokenBalance/<account name>/<token name>/false

ノード情報の取得（/getProducerVoteInfo/{ノード登録済みのIOSTアカウント名}/{true or false}）

https://api.iost.io/getProducerVoteInfo/<account name>/true

https://api.iost.io/getProducerVoteInfo/<account name>/false

ノードが受け取ることができる投票報酬情報の取得（/getCandidateBonus/{ノード登録済みのIOSTアカウント名}/{true or false}）

https://api.iost.io/getCandidateBonus/<account name>/true

https://api.iost.io/getCandidateBonus/<account name>/false

投票者が受け取ることができる投票報酬情報の取得（/getVoterBonus/{IOSTアカウント名}/{true or false}）

https://api.iost.io/getVoterBonus/<account name>/true

https://api.iost.io/getVoterBonus/<account name>/false

コントラクト情報の取得（/getContract/{コントラクトID}/{true or false}）

https://api.iost.io/getContract/<contract ID>/true

https://api.iost.io/getContract/<contract ID>/false

トークン情報の取得（/getTokenInfo/{シンボル}/{true or false}）

https://api.iost.io/getTokenInfo/<token symbol>/true

https://api.iost.io/getTokenInfo/<token symbol>/false

最後に（感想）

IOSTブロックチェーンからデータを取得するAPI（GET）の一覧と、その挙動についてまとめてみました。

実はというと、コントラクト関連のデータ取得APIがあと3つ（「/getContractStorage」「/getContractStorageFields」「/getBatchContractStorage」）があるんですが、呼び出し方が少し複雑なのと、あんまり使い所が思いつかなかったので、この記事ではまとめていません（諦めた）。

一応、IOSTブロックチェーンにトランザクションを送信するAPI（POST）として「/sendTx」もありますが、こいつを直接呼び出すのは推奨されてないっぽいです。

トランザクションを送信したい場合は、CLIツールだとか、Javascript JDKを使いなさいと、いうことです。

この記事で紹介したAPIやJavascript JDKを使用すれば、ブラウザ上で動作するノード投票システムも作れそうですね。

時間がある時にやってみます。

2024年1月16日

【一覧】IOSTに対応しているウォレット

2024年2月1日

【実装してみた】API（GET）を使用してIOSTブロックチェーンからデータを取得する

2024年11月3日

【IOSTの将来性を探る】「A trust」のIOSTメインネットへの移行が意味すること

2024年1月12日

【IOSTの始め方】Step1：Coincheck（コインチェック）でIOSTを購入しよう！

2024年1月20日

Proof of Believability（PoB）とは – 仮想通貨IOSTのコンセンサスアルゴリズムについて解説

2024年1月23日

IOSTのパートナーノードになろう！申請方法について解説