SequenceEthereumにおける Client は、IEthClient インターフェースによって定義されています。
クライアントの作成には Chain が必要です。これにより、Builderで設定したAPIキーを使って、RPCリクエスト用の高可用性・高応答性のNode Gatewayサービスを利用できます。独自のRPC URLを使いたい場合は、URL文字列をパラメータとして SequenceEthClient を作成することも可能です。
クライアントは以下のスニペットで作成できます。
IEthClient client = new SequenceEthClient(Chain.Polygon);
メソッド一覧
Ethereumノードへの接続ポイントとして、クライアントで実行できるさまざまなメソッドがあります。これらは IEthClient インターフェースに記載されており、SequenceEthClient で実装されています。
注意：BalanceAt（場合によっては）を除き、ほとんどのユーザーはこれらのメソッドを利用する必要はありませんが、完全性のためにドキュメントに記載しています。
BalanceAt
指定したウォレットの、指定したブロック番号（16進数文字列）時点でのガス通貨残高を取得します。
BigIntegar balance = await client.BalanceAt(wallet.GetAddress()); // By default, if no blockNumber string is provided, check the latest block
BigIntegar balance = await client.BalanceAt(wallet.GetAddress(), blockNumber);
仕組みの詳細に本当に興味がある場合を除き、この時点で次のドキュメントページへ進むことを強く推奨します
BlockByNumber
指定したブロック番号の Block を取得します。
Block block = await client.BlockByNumber(blockNumber);
BlockByHash
指定したブロックハッシュ（文字列）で Block を取得します。
Block block = await client.BlockByHash(blockHash);
BlockNumber
最新のブロック番号を16進数形式で取得します。
string blockNumber = await client.BlockNumber();
BlockRange
指定したblockNumberの範囲に含まれるブロックの List<Block> を取得します。
List<Block> blockRange = await client.BlockRange(startingBlockNumber, endingBlockNumber);
ChainID
クライアントが接続しているチェーンのチェーンIDを16進数形式で取得します。
string chainId = await client.ChainID();
CodeAt
指定したアドレスのスマートコントラクトのバイトコードを、指定したblockNumber（16進数形式）時点で取得します。
string code = await client.CodeAt(contractAddress, blockNumber);
EstimateGas
TransactionCall をもとに、そのトランザクションに必要なガス量を見積もります。
BigIntegar gas = await client.EstimateGas(transactionCall);
FeeHistory
最新ブロック（blockNumber）からblockCount分遡ったガス手数料の FeeHistoryResult を取得します。
FeeHistoryResult feeHistory = await client.FeeHistory(blockCount, newestBlock, new int[] { });
NetworkId
クライアントが接続しているチェーンのチェーンIDを整数形式（文字列）で取得します。
string networkId = await client.NetworkId();
NonceAt
指定した Address の推奨nonceを、指定したblockNumber（デフォルトは”latest”）で取得します。
BigInteger nonce = await client.NonceAt(wallet.GetAddress()); // Nonce at latest
BigIntegar nonce = await client.NonceAt(wallet.GetAddress(), blockNumber);
SendRawTransaction
署名済みトランザクション文字列をネットワークに送信し、トランザクションハッシュを返します。
string transactionHash = await client.SendRawTransaction(signedTransactionString);
SuggestGasPrice
推奨ガス価格を取得します。
BigIntegar gasPrice = await client.SuggestGasPrice();
SuggestGasTipCap
ガスの最大推奨優先手数料を取得します。
BigIntegar gasTipCap = await client.SuggestGasTipCap();
TransactionByHash
トランザクションハッシュで Transaction を取得します。
Transaction transaction = await client.TransactionByHash(transactionHash);
TransactionCount
指定したブロックハッシュのブロック内トランザクション数を取得します。
BigIntegar transactionCount = await client.TransactionCount(blockHash);
WaitForTransactionReceipt
トランザクションハッシュを指定して、TransactionReceipt を待機・取得します。
TransactionReceipt receipt = await client.WaitForTransactionReceipt(transactionHash);
