クライアント
SequenceEthereumにおける Client
は、IEthClient
インターフェースによって定義されています。
クライアントの作成には Chain
が必要です。これにより、Builderで設定したAPIキーを使って、RPCリクエスト用の高可用性・高応答性のNode Gatewayサービスを利用できます。独自のRPC URLを使いたい場合は、URL文字列をパラメータとして SequenceEthClient
を作成することも可能です。
クライアントは以下のスニペットで作成できます。
メソッド一覧
Ethereumノードへの接続ポイントとして、クライアントで実行できるさまざまなメソッドがあります。これらは IEthClient
インターフェースに記載されており、SequenceEthClient
で実装されています。
注意:BalanceAt(場合によっては)を除き、ほとんどのユーザーはこれらのメソッドを利用する必要はありませんが、完全性のためにドキュメントに記載しています。
BalanceAt
指定したウォレットの、指定したブロック番号(16進数文字列)時点でのガス通貨残高を取得します。
注意:blockNumberには特別な値が2つあります。“earliest”はチェーンの最初のブロック時点の残高、“latest”は最新ブロック時点の残高(デフォルト)を取得します。それ以外の場合は、16進数形式のblockNumber文字列を指定してください。
BlockByNumber
指定したブロック番号の Block
を取得します。
注意:上記と同様に、blockNumberは16進数形式または特別な値 “earliest”、“latest” を指定してください。
BlockByHash
指定したブロックハッシュ(文字列)で Block
を取得します。
BlockNumber
最新のブロック番号を16進数形式で取得します。
BlockRange
指定したblockNumberの範囲に含まれるブロックの List<Block>
を取得します。
注意:上記と同様に、blockNumberは16進数形式または特別な値 “earliest”、“latest” を指定してください。
ChainID
クライアントが接続しているチェーンのチェーンIDを16進数形式で取得します。
CodeAt
指定したアドレスのスマートコントラクトのバイトコードを、指定したblockNumber(16進数形式)時点で取得します。
注意:上記と同様に、blockNumberは16進数形式または特別な値 “earliest”、“latest” を指定してください。
EstimateGas
TransactionCall
をもとに、そのトランザクションに必要なガス量を見積もります。
FeeHistory
最新ブロック(blockNumber)からblockCount分遡ったガス手数料の FeeHistoryResult
を取得します。
注意:上記と同様に、blockNumberは16進数形式または特別な値 “earliest”、“latest” を指定してください。
NetworkId
クライアントが接続しているチェーンのチェーンIDを整数形式(文字列)で取得します。
NonceAt
指定した Address
の推奨nonceを、指定したblockNumber(デフォルトは”latest”)で取得します。
注意:上記と同様に、blockNumberは16進数形式または特別な値 “earliest”、“latest” を指定してください。
SendRawTransaction
署名済みトランザクション文字列をネットワークに送信し、トランザクションハッシュを返します。
SuggestGasPrice
推奨ガス価格を取得します。
SuggestGasTipCap
ガスの最大推奨優先手数料を取得します。
TransactionByHash
トランザクションハッシュで Transaction
を取得します。
TransactionCount
指定したブロックハッシュのブロック内トランザクション数を取得します。
WaitForTransactionReceipt
トランザクションハッシュを指定して、TransactionReceipt
を待機・取得します。