f532da6ca0
Signed-off-by: yuhangcangqian <cuibuwei@qq.com>
893 lines
32 KiB
Go
893 lines
32 KiB
Go
// Copyright 2016 The go-ethereum Authors
|
|
// This file is part of the go-ethereum library.
|
|
//
|
|
// The go-ethereum library is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Lesser General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// The go-ethereum library is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public License
|
|
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
// Package ethclient provides a client for the Ethereum RPC API.
|
|
package ethclient
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"errors"
|
|
"fmt"
|
|
"math/big"
|
|
|
|
"github.com/ethereum/go-ethereum"
|
|
"github.com/ethereum/go-ethereum/common"
|
|
"github.com/ethereum/go-ethereum/common/hexutil"
|
|
"github.com/ethereum/go-ethereum/core"
|
|
"github.com/ethereum/go-ethereum/core/types"
|
|
"github.com/ethereum/go-ethereum/internal/ethapi"
|
|
"github.com/ethereum/go-ethereum/rpc"
|
|
)
|
|
|
|
// Client defines typed wrappers for the Ethereum RPC API.
|
|
type Client struct {
|
|
c *rpc.Client
|
|
}
|
|
|
|
// Dial connects a client to the given URL.
|
|
func Dial(rawurl string) (*Client, error) {
|
|
return DialContext(context.Background(), rawurl)
|
|
}
|
|
|
|
// DialContext connects a client to the given URL with context.
|
|
func DialContext(ctx context.Context, rawurl string) (*Client, error) {
|
|
c, err := rpc.DialContext(ctx, rawurl)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return NewClient(c), nil
|
|
}
|
|
|
|
// DialOptions creates a new RPC client for the given URL. You can supply any of the
|
|
// pre-defined client options to configure the underlying transport.
|
|
func DialOptions(ctx context.Context, rawurl string, opts ...rpc.ClientOption) (*Client, error) {
|
|
c, err := rpc.DialOptions(ctx, rawurl, opts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return NewClient(c), nil
|
|
}
|
|
|
|
// NewClient creates a client that uses the given RPC client.
|
|
func NewClient(c *rpc.Client) *Client {
|
|
return &Client{c}
|
|
}
|
|
|
|
// Close closes the underlying RPC connection.
|
|
func (ec *Client) Close() {
|
|
ec.c.Close()
|
|
}
|
|
|
|
// Client gets the underlying RPC client.
|
|
func (ec *Client) Client() *rpc.Client {
|
|
return ec.c
|
|
}
|
|
|
|
// Blockchain Access
|
|
|
|
// ChainID retrieves the current chain ID for transaction replay protection.
|
|
func (ec *Client) ChainID(ctx context.Context) (*big.Int, error) {
|
|
var result hexutil.Big
|
|
err := ec.c.CallContext(ctx, &result, "eth_chainId")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return (*big.Int)(&result), err
|
|
}
|
|
|
|
// BlockByHash returns the given full block.
|
|
//
|
|
// Note that loading full blocks requires two requests. Use HeaderByHash
|
|
// if you don't need all transactions or uncle headers.
|
|
func (ec *Client) BlockByHash(ctx context.Context, hash common.Hash) (*types.Block, error) {
|
|
return ec.getBlock(ctx, "eth_getBlockByHash", hash, true)
|
|
}
|
|
|
|
// BlockByNumber returns a block from the current canonical chain. If number is nil, the
|
|
// latest known block is returned.
|
|
//
|
|
// Note that loading full blocks requires two requests. Use HeaderByNumber
|
|
// if you don't need all transactions or uncle headers.
|
|
func (ec *Client) BlockByNumber(ctx context.Context, number *big.Int) (*types.Block, error) {
|
|
return ec.getBlock(ctx, "eth_getBlockByNumber", toBlockNumArg(number), true)
|
|
}
|
|
|
|
// BlockNumber returns the most recent block number
|
|
func (ec *Client) BlockNumber(ctx context.Context) (uint64, error) {
|
|
var result hexutil.Uint64
|
|
err := ec.c.CallContext(ctx, &result, "eth_blockNumber")
|
|
return uint64(result), err
|
|
}
|
|
|
|
// PeerCount returns the number of p2p peers as reported by the net_peerCount method.
|
|
func (ec *Client) PeerCount(ctx context.Context) (uint64, error) {
|
|
var result hexutil.Uint64
|
|
err := ec.c.CallContext(ctx, &result, "net_peerCount")
|
|
return uint64(result), err
|
|
}
|
|
|
|
// BlockReceipts returns the receipts of a given block number or hash.
|
|
func (ec *Client) BlockReceipts(ctx context.Context, blockNrOrHash rpc.BlockNumberOrHash) ([]*types.Receipt, error) {
|
|
var r []*types.Receipt
|
|
err := ec.c.CallContext(ctx, &r, "eth_getBlockReceipts", blockNrOrHash.String())
|
|
if err == nil && r == nil {
|
|
return nil, ethereum.NotFound
|
|
}
|
|
return r, err
|
|
}
|
|
|
|
// BlobSidecars return the Sidecars of a given block number or hash.
|
|
func (ec *Client) BlobSidecars(ctx context.Context, blockNrOrHash rpc.BlockNumberOrHash) ([]*types.BlobTxSidecar, error) {
|
|
var r []*types.BlobTxSidecar
|
|
err := ec.c.CallContext(ctx, &r, "eth_getBlobSidecars", blockNrOrHash.String())
|
|
if err == nil && r == nil {
|
|
return nil, ethereum.NotFound
|
|
}
|
|
return r, err
|
|
}
|
|
|
|
// BlobSidecarByTxHash return a sidecar of a given blob transaction
|
|
func (ec *Client) BlobSidecarByTxHash(ctx context.Context, hash common.Hash) (*types.BlobTxSidecar, error) {
|
|
var r *types.BlobTxSidecar
|
|
err := ec.c.CallContext(ctx, &r, "eth_getBlobSidecarByTxHash", hash)
|
|
if err == nil && r == nil {
|
|
return nil, ethereum.NotFound
|
|
}
|
|
return r, err
|
|
}
|
|
|
|
type rpcBlock struct {
|
|
Hash common.Hash `json:"hash"`
|
|
Transactions []rpcTransaction `json:"transactions"`
|
|
UncleHashes []common.Hash `json:"uncles"`
|
|
Withdrawals []*types.Withdrawal `json:"withdrawals,omitempty"`
|
|
}
|
|
|
|
func (ec *Client) getBlock(ctx context.Context, method string, args ...interface{}) (*types.Block, error) {
|
|
var raw json.RawMessage
|
|
err := ec.c.CallContext(ctx, &raw, method, args...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
// Decode header and transactions.
|
|
var head *types.Header
|
|
if err := json.Unmarshal(raw, &head); err != nil {
|
|
return nil, err
|
|
}
|
|
// When the block is not found, the API returns JSON null.
|
|
if head == nil {
|
|
return nil, ethereum.NotFound
|
|
}
|
|
|
|
var body rpcBlock
|
|
if err := json.Unmarshal(raw, &body); err != nil {
|
|
return nil, err
|
|
}
|
|
// Quick-verify transaction and uncle lists. This mostly helps with debugging the server.
|
|
if head.UncleHash == types.EmptyUncleHash && len(body.UncleHashes) > 0 {
|
|
return nil, errors.New("server returned non-empty uncle list but block header indicates no uncles")
|
|
}
|
|
if head.UncleHash != types.EmptyUncleHash && len(body.UncleHashes) == 0 {
|
|
return nil, errors.New("server returned empty uncle list but block header indicates uncles")
|
|
}
|
|
if head.TxHash == types.EmptyTxsHash && len(body.Transactions) > 0 {
|
|
return nil, errors.New("server returned non-empty transaction list but block header indicates no transactions")
|
|
}
|
|
if head.TxHash != types.EmptyTxsHash && len(body.Transactions) == 0 {
|
|
return nil, errors.New("server returned empty transaction list but block header indicates transactions")
|
|
}
|
|
// Load uncles because they are not included in the block response.
|
|
var uncles []*types.Header
|
|
if len(body.UncleHashes) > 0 {
|
|
uncles = make([]*types.Header, len(body.UncleHashes))
|
|
reqs := make([]rpc.BatchElem, len(body.UncleHashes))
|
|
for i := range reqs {
|
|
reqs[i] = rpc.BatchElem{
|
|
Method: "eth_getUncleByBlockHashAndIndex",
|
|
Args: []interface{}{body.Hash, hexutil.EncodeUint64(uint64(i))},
|
|
Result: &uncles[i],
|
|
}
|
|
}
|
|
if err := ec.c.BatchCallContext(ctx, reqs); err != nil {
|
|
return nil, err
|
|
}
|
|
for i := range reqs {
|
|
if reqs[i].Error != nil {
|
|
return nil, reqs[i].Error
|
|
}
|
|
if uncles[i] == nil {
|
|
return nil, fmt.Errorf("got null header for uncle %d of block %x", i, body.Hash[:])
|
|
}
|
|
}
|
|
}
|
|
// Fill the sender cache of transactions in the block.
|
|
txs := make([]*types.Transaction, len(body.Transactions))
|
|
for i, tx := range body.Transactions {
|
|
if tx.From != nil {
|
|
setSenderFromServer(tx.tx, *tx.From, body.Hash)
|
|
}
|
|
txs[i] = tx.tx
|
|
}
|
|
return types.NewBlockWithHeader(head).WithBody(txs, uncles).WithWithdrawals(body.Withdrawals), nil
|
|
}
|
|
|
|
// HeaderByHash returns the block header with the given hash.
|
|
func (ec *Client) HeaderByHash(ctx context.Context, hash common.Hash) (*types.Header, error) {
|
|
var head *types.Header
|
|
err := ec.c.CallContext(ctx, &head, "eth_getBlockByHash", hash, false)
|
|
if err == nil && head == nil {
|
|
err = ethereum.NotFound
|
|
}
|
|
return head, err
|
|
}
|
|
|
|
// HeaderByNumber returns a block header from the current canonical chain. If number is
|
|
// nil, the latest known header is returned.
|
|
func (ec *Client) HeaderByNumber(ctx context.Context, number *big.Int) (*types.Header, error) {
|
|
var head *types.Header
|
|
err := ec.c.CallContext(ctx, &head, "eth_getBlockByNumber", toBlockNumArg(number), false)
|
|
if err == nil && head == nil {
|
|
err = ethereum.NotFound
|
|
}
|
|
return head, err
|
|
}
|
|
|
|
// GetFinalizedHeader returns the requested finalized block header.
|
|
// - probabilisticFinalized should be in range [2,21],
|
|
// then the block header with number `max(fastFinalized, latest-probabilisticFinalized)` is returned
|
|
func (ec *Client) FinalizedHeader(ctx context.Context, probabilisticFinalized int64) (*types.Header, error) {
|
|
var head *types.Header
|
|
err := ec.c.CallContext(ctx, &head, "eth_getFinalizedHeader", probabilisticFinalized)
|
|
if err == nil && head == nil {
|
|
err = ethereum.NotFound
|
|
}
|
|
return head, err
|
|
}
|
|
|
|
// GetFinalizedBlock returns the requested finalized block.
|
|
// - probabilisticFinalized should be in range [2,21],
|
|
// then the block with number `max(fastFinalized, latest-probabilisticFinalized)` is returned
|
|
// - When fullTx is true all transactions in the block are returned, otherwise
|
|
// only the transaction hash is returned.
|
|
func (ec *Client) FinalizedBlock(ctx context.Context, probabilisticFinalized int64, fullTx bool) (*types.Block, error) {
|
|
return ec.getBlock(ctx, "eth_getFinalizedBlock", probabilisticFinalized, true)
|
|
}
|
|
|
|
func (ec *Client) GetRootByDiffHash(ctx context.Context, blockNr *big.Int, blockHash common.Hash, diffHash common.Hash) (*core.VerifyResult, error) {
|
|
var result core.VerifyResult
|
|
err := ec.c.CallContext(ctx, &result, "eth_getRootByDiffHash", toBlockNumArg(blockNr), blockHash, diffHash)
|
|
return &result, err
|
|
}
|
|
|
|
type rpcTransaction struct {
|
|
tx *types.Transaction
|
|
txExtraInfo
|
|
}
|
|
|
|
type txExtraInfo struct {
|
|
BlockNumber *string `json:"blockNumber,omitempty"`
|
|
BlockHash *common.Hash `json:"blockHash,omitempty"`
|
|
From *common.Address `json:"from,omitempty"`
|
|
}
|
|
|
|
func (tx *rpcTransaction) UnmarshalJSON(msg []byte) error {
|
|
if err := json.Unmarshal(msg, &tx.tx); err != nil {
|
|
return err
|
|
}
|
|
return json.Unmarshal(msg, &tx.txExtraInfo)
|
|
}
|
|
|
|
// TransactionByHash returns the transaction with the given hash.
|
|
func (ec *Client) TransactionByHash(ctx context.Context, hash common.Hash) (tx *types.Transaction, isPending bool, err error) {
|
|
var json *rpcTransaction
|
|
err = ec.c.CallContext(ctx, &json, "eth_getTransactionByHash", hash)
|
|
if err != nil {
|
|
return nil, false, err
|
|
} else if json == nil {
|
|
return nil, false, ethereum.NotFound
|
|
} else if _, r, _ := json.tx.RawSignatureValues(); r == nil {
|
|
return nil, false, errors.New("server returned transaction without signature")
|
|
}
|
|
if json.From != nil && json.BlockHash != nil {
|
|
setSenderFromServer(json.tx, *json.From, *json.BlockHash)
|
|
}
|
|
return json.tx, json.BlockNumber == nil, nil
|
|
}
|
|
|
|
// TransactionSender returns the sender address of the given transaction. The transaction
|
|
// must be known to the remote node and included in the blockchain at the given block and
|
|
// index. The sender is the one derived by the protocol at the time of inclusion.
|
|
//
|
|
// There is a fast-path for transactions retrieved by TransactionByHash and
|
|
// TransactionInBlock. Getting their sender address can be done without an RPC interaction.
|
|
func (ec *Client) TransactionSender(ctx context.Context, tx *types.Transaction, block common.Hash, index uint) (common.Address, error) {
|
|
// Try to load the address from the cache.
|
|
sender, err := types.Sender(&senderFromServer{blockhash: block}, tx)
|
|
if err == nil {
|
|
return sender, nil
|
|
}
|
|
|
|
// It was not found in cache, ask the server.
|
|
var meta struct {
|
|
Hash common.Hash
|
|
From common.Address
|
|
}
|
|
if err = ec.c.CallContext(ctx, &meta, "eth_getTransactionByBlockHashAndIndex", block, hexutil.Uint64(index)); err != nil {
|
|
return common.Address{}, err
|
|
}
|
|
if meta.Hash == (common.Hash{}) || meta.Hash != tx.Hash() {
|
|
return common.Address{}, errors.New("wrong inclusion block/index")
|
|
}
|
|
return meta.From, nil
|
|
}
|
|
|
|
// TransactionCount returns the total number of transactions in the given block.
|
|
func (ec *Client) TransactionCount(ctx context.Context, blockHash common.Hash) (uint, error) {
|
|
var num hexutil.Uint
|
|
err := ec.c.CallContext(ctx, &num, "eth_getBlockTransactionCountByHash", blockHash)
|
|
return uint(num), err
|
|
}
|
|
|
|
// TransactionInBlock returns a single transaction at index in the given block.
|
|
func (ec *Client) TransactionInBlock(ctx context.Context, blockHash common.Hash, index uint) (*types.Transaction, error) {
|
|
var json *rpcTransaction
|
|
err := ec.c.CallContext(ctx, &json, "eth_getTransactionByBlockHashAndIndex", blockHash, hexutil.Uint64(index))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if json == nil {
|
|
return nil, ethereum.NotFound
|
|
} else if _, r, _ := json.tx.RawSignatureValues(); r == nil {
|
|
return nil, errors.New("server returned transaction without signature")
|
|
}
|
|
if json.From != nil && json.BlockHash != nil {
|
|
setSenderFromServer(json.tx, *json.From, *json.BlockHash)
|
|
}
|
|
return json.tx, err
|
|
}
|
|
|
|
// TransactionsInBlock returns a single transaction at index in the given block.
|
|
func (ec *Client) TransactionsInBlock(ctx context.Context, number *big.Int) ([]*types.Transaction, error) {
|
|
var rpcTxs []*rpcTransaction
|
|
err := ec.c.CallContext(ctx, &rpcTxs, "eth_getTransactionsByBlockNumber", toBlockNumArg(number))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
fmt.Println(len(rpcTxs))
|
|
txs := make([]*types.Transaction, 0, len(rpcTxs))
|
|
for _, tx := range rpcTxs {
|
|
txs = append(txs, tx.tx)
|
|
}
|
|
return txs, err
|
|
}
|
|
|
|
// TransactionRecipientsInBlock returns a single transaction at index in the given block.
|
|
func (ec *Client) TransactionRecipientsInBlock(ctx context.Context, number *big.Int) ([]*types.Receipt, error) {
|
|
var rs []*types.Receipt
|
|
err := ec.c.CallContext(ctx, &rs, "eth_getTransactionReceiptsByBlockNumber", toBlockNumArg(number))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return rs, err
|
|
}
|
|
|
|
// TransactionDataAndReceipt returns the original data and receipt of a transaction by transaction hash.
|
|
// Note that the receipt is not available for pending transactions.
|
|
func (ec *Client) TransactionDataAndReceipt(ctx context.Context, txHash common.Hash) (*types.OriginalDataAndReceipt, error) {
|
|
var r *types.OriginalDataAndReceipt
|
|
err := ec.c.CallContext(ctx, &r, "eth_getTransactionDataAndReceipt", txHash)
|
|
if err == nil {
|
|
if r == nil {
|
|
return nil, ethereum.NotFound
|
|
}
|
|
}
|
|
return r, err
|
|
}
|
|
|
|
// TransactionReceipt returns the receipt of a transaction by transaction hash.
|
|
// Note that the receipt is not available for pending transactions.
|
|
func (ec *Client) TransactionReceipt(ctx context.Context, txHash common.Hash) (*types.Receipt, error) {
|
|
var r *types.Receipt
|
|
err := ec.c.CallContext(ctx, &r, "eth_getTransactionReceipt", txHash)
|
|
if err == nil && r == nil {
|
|
return nil, ethereum.NotFound
|
|
}
|
|
return r, err
|
|
}
|
|
|
|
// SyncProgress retrieves the current progress of the sync algorithm. If there's
|
|
// no sync currently running, it returns nil.
|
|
func (ec *Client) SyncProgress(ctx context.Context) (*ethereum.SyncProgress, error) {
|
|
var raw json.RawMessage
|
|
if err := ec.c.CallContext(ctx, &raw, "eth_syncing"); err != nil {
|
|
return nil, err
|
|
}
|
|
// Handle the possible response types
|
|
var syncing bool
|
|
if err := json.Unmarshal(raw, &syncing); err == nil {
|
|
return nil, nil // Not syncing (always false)
|
|
}
|
|
var p *rpcProgress
|
|
if err := json.Unmarshal(raw, &p); err != nil {
|
|
return nil, err
|
|
}
|
|
return p.toSyncProgress(), nil
|
|
}
|
|
|
|
// SubscribeNewHead subscribes to notifications about the current blockchain head
|
|
// on the given channel.
|
|
func (ec *Client) SubscribeNewHead(ctx context.Context, ch chan<- *types.Header) (ethereum.Subscription, error) {
|
|
sub, err := ec.c.EthSubscribe(ctx, ch, "newHeads")
|
|
if err != nil {
|
|
// Defensively prefer returning nil interface explicitly on error-path, instead
|
|
// of letting default golang behavior wrap it with non-nil interface that stores
|
|
// nil concrete type value.
|
|
return nil, err
|
|
}
|
|
return sub, nil
|
|
}
|
|
|
|
// SubscribeNewFinalizedHeader subscribes to notifications about the current blockchain finalized header
|
|
// on the given channel.
|
|
func (ec *Client) SubscribeNewFinalizedHeader(ctx context.Context, ch chan<- *types.Header) (ethereum.Subscription, error) {
|
|
return ec.c.EthSubscribe(ctx, ch, "newFinalizedHeaders")
|
|
}
|
|
|
|
// SubscribeNewVotes subscribes to notifications about the new votes into vote pool
|
|
func (ec *Client) SubscribeNewVotes(ctx context.Context, ch chan<- *types.VoteEnvelope) (ethereum.Subscription, error) {
|
|
return ec.c.EthSubscribe(ctx, ch, "newVotes")
|
|
}
|
|
|
|
// State Access
|
|
|
|
// NetworkID returns the network ID for this client.
|
|
func (ec *Client) NetworkID(ctx context.Context) (*big.Int, error) {
|
|
version := new(big.Int)
|
|
var ver string
|
|
if err := ec.c.CallContext(ctx, &ver, "net_version"); err != nil {
|
|
return nil, err
|
|
}
|
|
if _, ok := version.SetString(ver, 10); !ok {
|
|
return nil, fmt.Errorf("invalid net_version result %q", ver)
|
|
}
|
|
return version, nil
|
|
}
|
|
|
|
// BalanceAt returns the wei balance of the given account.
|
|
// The block number can be nil, in which case the balance is taken from the latest known block.
|
|
func (ec *Client) BalanceAt(ctx context.Context, account common.Address, blockNumber *big.Int) (*big.Int, error) {
|
|
var result hexutil.Big
|
|
err := ec.c.CallContext(ctx, &result, "eth_getBalance", account, toBlockNumArg(blockNumber))
|
|
return (*big.Int)(&result), err
|
|
}
|
|
|
|
// BalanceAtHash returns the wei balance of the given account.
|
|
func (ec *Client) BalanceAtHash(ctx context.Context, account common.Address, blockHash common.Hash) (*big.Int, error) {
|
|
var result hexutil.Big
|
|
err := ec.c.CallContext(ctx, &result, "eth_getBalance", account, rpc.BlockNumberOrHashWithHash(blockHash, false))
|
|
return (*big.Int)(&result), err
|
|
}
|
|
|
|
// StorageAt returns the value of key in the contract storage of the given account.
|
|
// The block number can be nil, in which case the value is taken from the latest known block.
|
|
func (ec *Client) StorageAt(ctx context.Context, account common.Address, key common.Hash, blockNumber *big.Int) ([]byte, error) {
|
|
var result hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &result, "eth_getStorageAt", account, key, toBlockNumArg(blockNumber))
|
|
return result, err
|
|
}
|
|
|
|
// StorageAtHash returns the value of key in the contract storage of the given account.
|
|
func (ec *Client) StorageAtHash(ctx context.Context, account common.Address, key common.Hash, blockHash common.Hash) ([]byte, error) {
|
|
var result hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &result, "eth_getStorageAt", account, key, rpc.BlockNumberOrHashWithHash(blockHash, false))
|
|
return result, err
|
|
}
|
|
|
|
// CodeAt returns the contract code of the given account.
|
|
// The block number can be nil, in which case the code is taken from the latest known block.
|
|
func (ec *Client) CodeAt(ctx context.Context, account common.Address, blockNumber *big.Int) ([]byte, error) {
|
|
var result hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &result, "eth_getCode", account, toBlockNumArg(blockNumber))
|
|
return result, err
|
|
}
|
|
|
|
// CodeAtHash returns the contract code of the given account.
|
|
func (ec *Client) CodeAtHash(ctx context.Context, account common.Address, blockHash common.Hash) ([]byte, error) {
|
|
var result hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &result, "eth_getCode", account, rpc.BlockNumberOrHashWithHash(blockHash, false))
|
|
return result, err
|
|
}
|
|
|
|
// NonceAt returns the account nonce of the given account.
|
|
// The block number can be nil, in which case the nonce is taken from the latest known block.
|
|
func (ec *Client) NonceAt(ctx context.Context, account common.Address, blockNumber *big.Int) (uint64, error) {
|
|
var result hexutil.Uint64
|
|
err := ec.c.CallContext(ctx, &result, "eth_getTransactionCount", account, toBlockNumArg(blockNumber))
|
|
return uint64(result), err
|
|
}
|
|
|
|
// NonceAtHash returns the account nonce of the given account.
|
|
func (ec *Client) NonceAtHash(ctx context.Context, account common.Address, blockHash common.Hash) (uint64, error) {
|
|
var result hexutil.Uint64
|
|
err := ec.c.CallContext(ctx, &result, "eth_getTransactionCount", account, rpc.BlockNumberOrHashWithHash(blockHash, false))
|
|
return uint64(result), err
|
|
}
|
|
|
|
// Filters
|
|
|
|
// FilterLogs executes a filter query.
|
|
func (ec *Client) FilterLogs(ctx context.Context, q ethereum.FilterQuery) ([]types.Log, error) {
|
|
var result []types.Log
|
|
arg, err := toFilterArg(q)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
err = ec.c.CallContext(ctx, &result, "eth_getLogs", arg)
|
|
return result, err
|
|
}
|
|
|
|
// SubscribeFilterLogs subscribes to the results of a streaming filter query.
|
|
func (ec *Client) SubscribeFilterLogs(ctx context.Context, q ethereum.FilterQuery, ch chan<- types.Log) (ethereum.Subscription, error) {
|
|
arg, err := toFilterArg(q)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
sub, err := ec.c.EthSubscribe(ctx, ch, "logs", arg)
|
|
if err != nil {
|
|
// Defensively prefer returning nil interface explicitly on error-path, instead
|
|
// of letting default golang behavior wrap it with non-nil interface that stores
|
|
// nil concrete type value.
|
|
return nil, err
|
|
}
|
|
return sub, nil
|
|
}
|
|
|
|
func toFilterArg(q ethereum.FilterQuery) (interface{}, error) {
|
|
arg := map[string]interface{}{
|
|
"address": q.Addresses,
|
|
"topics": q.Topics,
|
|
}
|
|
if q.BlockHash != nil {
|
|
arg["blockHash"] = *q.BlockHash
|
|
if q.FromBlock != nil || q.ToBlock != nil {
|
|
return nil, errors.New("cannot specify both BlockHash and FromBlock/ToBlock")
|
|
}
|
|
} else {
|
|
if q.FromBlock == nil {
|
|
arg["fromBlock"] = "0x0"
|
|
} else {
|
|
arg["fromBlock"] = toBlockNumArg(q.FromBlock)
|
|
}
|
|
arg["toBlock"] = toBlockNumArg(q.ToBlock)
|
|
}
|
|
return arg, nil
|
|
}
|
|
|
|
// Pending State
|
|
|
|
// PendingBalanceAt returns the wei balance of the given account in the pending state.
|
|
func (ec *Client) PendingBalanceAt(ctx context.Context, account common.Address) (*big.Int, error) {
|
|
var result hexutil.Big
|
|
err := ec.c.CallContext(ctx, &result, "eth_getBalance", account, "pending")
|
|
return (*big.Int)(&result), err
|
|
}
|
|
|
|
// PendingStorageAt returns the value of key in the contract storage of the given account in the pending state.
|
|
func (ec *Client) PendingStorageAt(ctx context.Context, account common.Address, key common.Hash) ([]byte, error) {
|
|
var result hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &result, "eth_getStorageAt", account, key, "pending")
|
|
return result, err
|
|
}
|
|
|
|
// PendingCodeAt returns the contract code of the given account in the pending state.
|
|
func (ec *Client) PendingCodeAt(ctx context.Context, account common.Address) ([]byte, error) {
|
|
var result hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &result, "eth_getCode", account, "pending")
|
|
return result, err
|
|
}
|
|
|
|
// PendingNonceAt returns the account nonce of the given account in the pending state.
|
|
// This is the nonce that should be used for the next transaction.
|
|
func (ec *Client) PendingNonceAt(ctx context.Context, account common.Address) (uint64, error) {
|
|
var result hexutil.Uint64
|
|
err := ec.c.CallContext(ctx, &result, "eth_getTransactionCount", account, "pending")
|
|
return uint64(result), err
|
|
}
|
|
|
|
// PendingTransactionCount returns the total number of transactions in the pending state.
|
|
func (ec *Client) PendingTransactionCount(ctx context.Context) (uint, error) {
|
|
var num hexutil.Uint
|
|
err := ec.c.CallContext(ctx, &num, "eth_getBlockTransactionCountByNumber", "pending")
|
|
return uint(num), err
|
|
}
|
|
|
|
// Contract Calling
|
|
|
|
// CallContract executes a message call transaction, which is directly executed in the VM
|
|
// of the node, but never mined into the blockchain.
|
|
//
|
|
// blockNumber selects the block height at which the call runs. It can be nil, in which
|
|
// case the code is taken from the latest known block. Note that state from very old
|
|
// blocks might not be available.
|
|
func (ec *Client) CallContract(ctx context.Context, msg ethereum.CallMsg, blockNumber *big.Int) ([]byte, error) {
|
|
var hex hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &hex, "eth_call", toCallArg(msg), toBlockNumArg(blockNumber))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return hex, nil
|
|
}
|
|
|
|
// CallContractAtHash is almost the same as CallContract except that it selects
|
|
// the block by block hash instead of block height.
|
|
func (ec *Client) CallContractAtHash(ctx context.Context, msg ethereum.CallMsg, blockHash common.Hash) ([]byte, error) {
|
|
var hex hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &hex, "eth_call", toCallArg(msg), rpc.BlockNumberOrHashWithHash(blockHash, false))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return hex, nil
|
|
}
|
|
|
|
// PendingCallContract executes a message call transaction using the EVM.
|
|
// The state seen by the contract call is the pending state.
|
|
func (ec *Client) PendingCallContract(ctx context.Context, msg ethereum.CallMsg) ([]byte, error) {
|
|
var hex hexutil.Bytes
|
|
err := ec.c.CallContext(ctx, &hex, "eth_call", toCallArg(msg), "pending")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return hex, nil
|
|
}
|
|
|
|
// SuggestGasPrice retrieves the currently suggested gas price to allow a timely
|
|
// execution of a transaction.
|
|
func (ec *Client) SuggestGasPrice(ctx context.Context) (*big.Int, error) {
|
|
var hex hexutil.Big
|
|
if err := ec.c.CallContext(ctx, &hex, "eth_gasPrice"); err != nil {
|
|
return nil, err
|
|
}
|
|
return (*big.Int)(&hex), nil
|
|
}
|
|
|
|
// SuggestGasTipCap retrieves the currently suggested gas tip cap after 1559 to
|
|
// allow a timely execution of a transaction.
|
|
func (ec *Client) SuggestGasTipCap(ctx context.Context) (*big.Int, error) {
|
|
var hex hexutil.Big
|
|
if err := ec.c.CallContext(ctx, &hex, "eth_maxPriorityFeePerGas"); err != nil {
|
|
return nil, err
|
|
}
|
|
return (*big.Int)(&hex), nil
|
|
}
|
|
|
|
type feeHistoryResultMarshaling struct {
|
|
OldestBlock *hexutil.Big `json:"oldestBlock"`
|
|
Reward [][]*hexutil.Big `json:"reward,omitempty"`
|
|
BaseFee []*hexutil.Big `json:"baseFeePerGas,omitempty"`
|
|
GasUsedRatio []float64 `json:"gasUsedRatio"`
|
|
}
|
|
|
|
// FeeHistory retrieves the fee market history.
|
|
func (ec *Client) FeeHistory(ctx context.Context, blockCount uint64, lastBlock *big.Int, rewardPercentiles []float64) (*ethereum.FeeHistory, error) {
|
|
var res feeHistoryResultMarshaling
|
|
if err := ec.c.CallContext(ctx, &res, "eth_feeHistory", hexutil.Uint(blockCount), toBlockNumArg(lastBlock), rewardPercentiles); err != nil {
|
|
return nil, err
|
|
}
|
|
reward := make([][]*big.Int, len(res.Reward))
|
|
for i, r := range res.Reward {
|
|
reward[i] = make([]*big.Int, len(r))
|
|
for j, r := range r {
|
|
reward[i][j] = (*big.Int)(r)
|
|
}
|
|
}
|
|
baseFee := make([]*big.Int, len(res.BaseFee))
|
|
for i, b := range res.BaseFee {
|
|
// need this change, otherwise testStatusFunctions will fail, need more research
|
|
baseFee[i] = big.NewInt(b.ToInt().Int64())
|
|
}
|
|
return ðereum.FeeHistory{
|
|
OldestBlock: (*big.Int)(res.OldestBlock),
|
|
Reward: reward,
|
|
BaseFee: baseFee,
|
|
GasUsedRatio: res.GasUsedRatio,
|
|
}, nil
|
|
}
|
|
|
|
// EstimateGas tries to estimate the gas needed to execute a specific transaction based on
|
|
// the current pending state of the backend blockchain. There is no guarantee that this is
|
|
// the true gas limit requirement as other transactions may be added or removed by miners,
|
|
// but it should provide a basis for setting a reasonable default.
|
|
func (ec *Client) EstimateGas(ctx context.Context, msg ethereum.CallMsg) (uint64, error) {
|
|
var hex hexutil.Uint64
|
|
err := ec.c.CallContext(ctx, &hex, "eth_estimateGas", toCallArg(msg))
|
|
if err != nil {
|
|
return 0, err
|
|
}
|
|
return uint64(hex), nil
|
|
}
|
|
|
|
// SendTransaction injects a signed transaction into the pending pool for execution.
|
|
//
|
|
// If the transaction was a contract creation use the TransactionReceipt method to get the
|
|
// contract address after the transaction has been mined.
|
|
func (ec *Client) SendTransaction(ctx context.Context, tx *types.Transaction) error {
|
|
data, err := tx.MarshalBinary()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return ec.c.CallContext(ctx, nil, "eth_sendRawTransaction", hexutil.Encode(data))
|
|
}
|
|
|
|
// SendTransactionConditional injects a signed transaction into the pending pool for execution.
|
|
//
|
|
// If the transaction was a contract creation use the TransactionReceipt method to get the
|
|
// contract address after the transaction has been mined.
|
|
func (ec *Client) SendTransactionConditional(ctx context.Context, tx *types.Transaction, opts ethapi.TransactionOpts) error {
|
|
data, err := tx.MarshalBinary()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return ec.c.CallContext(ctx, nil, "eth_sendRawTransactionConditional", hexutil.Encode(data), opts)
|
|
}
|
|
|
|
// MevRunning returns whether MEV is running
|
|
func (ec *Client) MevRunning(ctx context.Context) (bool, error) {
|
|
var result bool
|
|
err := ec.c.CallContext(ctx, &result, "mev_running")
|
|
return result, err
|
|
}
|
|
|
|
// HasBuilder returns whether the builder is registered
|
|
func (ec *Client) HasBuilder(ctx context.Context, address common.Address) (bool, error) {
|
|
var result bool
|
|
err := ec.c.CallContext(ctx, &result, "mev_hasBuilder", address)
|
|
return result, err
|
|
}
|
|
|
|
// SendBid sends a bid
|
|
func (ec *Client) SendBid(ctx context.Context, args types.BidArgs) (common.Hash, error) {
|
|
var hash common.Hash
|
|
err := ec.c.CallContext(ctx, &hash, "mev_sendBid", args)
|
|
if err != nil {
|
|
return common.Hash{}, err
|
|
}
|
|
return hash, nil
|
|
}
|
|
|
|
// BestBidGasFee returns the gas fee of the best bid for the given parent hash.
|
|
func (ec *Client) BestBidGasFee(ctx context.Context, parentHash common.Hash) (*big.Int, error) {
|
|
var fee *big.Int
|
|
err := ec.c.CallContext(ctx, &fee, "mev_bestBidGasFee", parentHash)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return fee, nil
|
|
}
|
|
|
|
// MevParams returns the static params of mev
|
|
func (ec *Client) MevParams(ctx context.Context) (*types.MevParams, error) {
|
|
var params types.MevParams
|
|
err := ec.c.CallContext(ctx, ¶ms, "mev_params")
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return ¶ms, err
|
|
}
|
|
|
|
func toBlockNumArg(number *big.Int) string {
|
|
if number == nil {
|
|
return "latest"
|
|
}
|
|
if number.Sign() >= 0 {
|
|
return hexutil.EncodeBig(number)
|
|
}
|
|
// It's negative.
|
|
if number.IsInt64() {
|
|
return rpc.BlockNumber(number.Int64()).String()
|
|
}
|
|
// It's negative and large, which is invalid.
|
|
return fmt.Sprintf("<invalid %d>", number)
|
|
}
|
|
|
|
func toCallArg(msg ethereum.CallMsg) interface{} {
|
|
arg := map[string]interface{}{
|
|
"from": msg.From,
|
|
"to": msg.To,
|
|
}
|
|
if len(msg.Data) > 0 {
|
|
arg["input"] = hexutil.Bytes(msg.Data)
|
|
}
|
|
if msg.Value != nil {
|
|
arg["value"] = (*hexutil.Big)(msg.Value)
|
|
}
|
|
if msg.Gas != 0 {
|
|
arg["gas"] = hexutil.Uint64(msg.Gas)
|
|
}
|
|
if msg.GasPrice != nil {
|
|
arg["gasPrice"] = (*hexutil.Big)(msg.GasPrice)
|
|
}
|
|
if msg.GasFeeCap != nil {
|
|
arg["maxFeePerGas"] = (*hexutil.Big)(msg.GasFeeCap)
|
|
}
|
|
if msg.GasTipCap != nil {
|
|
arg["maxPriorityFeePerGas"] = (*hexutil.Big)(msg.GasTipCap)
|
|
}
|
|
if msg.AccessList != nil {
|
|
arg["accessList"] = msg.AccessList
|
|
}
|
|
if msg.BlobGasFeeCap != nil {
|
|
arg["maxFeePerBlobGas"] = (*hexutil.Big)(msg.BlobGasFeeCap)
|
|
}
|
|
if msg.BlobHashes != nil {
|
|
arg["blobVersionedHashes"] = msg.BlobHashes
|
|
}
|
|
return arg
|
|
}
|
|
|
|
// rpcProgress is a copy of SyncProgress with hex-encoded fields.
|
|
type rpcProgress struct {
|
|
StartingBlock hexutil.Uint64
|
|
CurrentBlock hexutil.Uint64
|
|
HighestBlock hexutil.Uint64
|
|
|
|
PulledStates hexutil.Uint64
|
|
KnownStates hexutil.Uint64
|
|
|
|
SyncedAccounts hexutil.Uint64
|
|
SyncedAccountBytes hexutil.Uint64
|
|
SyncedBytecodes hexutil.Uint64
|
|
SyncedBytecodeBytes hexutil.Uint64
|
|
SyncedStorage hexutil.Uint64
|
|
SyncedStorageBytes hexutil.Uint64
|
|
HealedTrienodes hexutil.Uint64
|
|
HealedTrienodeBytes hexutil.Uint64
|
|
HealedBytecodes hexutil.Uint64
|
|
HealedBytecodeBytes hexutil.Uint64
|
|
HealingTrienodes hexutil.Uint64
|
|
HealingBytecode hexutil.Uint64
|
|
TxIndexFinishedBlocks hexutil.Uint64
|
|
TxIndexRemainingBlocks hexutil.Uint64
|
|
}
|
|
|
|
func (p *rpcProgress) toSyncProgress() *ethereum.SyncProgress {
|
|
if p == nil {
|
|
return nil
|
|
}
|
|
return ðereum.SyncProgress{
|
|
StartingBlock: uint64(p.StartingBlock),
|
|
CurrentBlock: uint64(p.CurrentBlock),
|
|
HighestBlock: uint64(p.HighestBlock),
|
|
PulledStates: uint64(p.PulledStates),
|
|
KnownStates: uint64(p.KnownStates),
|
|
SyncedAccounts: uint64(p.SyncedAccounts),
|
|
SyncedAccountBytes: uint64(p.SyncedAccountBytes),
|
|
SyncedBytecodes: uint64(p.SyncedBytecodes),
|
|
SyncedBytecodeBytes: uint64(p.SyncedBytecodeBytes),
|
|
SyncedStorage: uint64(p.SyncedStorage),
|
|
SyncedStorageBytes: uint64(p.SyncedStorageBytes),
|
|
HealedTrienodes: uint64(p.HealedTrienodes),
|
|
HealedTrienodeBytes: uint64(p.HealedTrienodeBytes),
|
|
HealedBytecodes: uint64(p.HealedBytecodes),
|
|
HealedBytecodeBytes: uint64(p.HealedBytecodeBytes),
|
|
HealingTrienodes: uint64(p.HealingTrienodes),
|
|
HealingBytecode: uint64(p.HealingBytecode),
|
|
TxIndexFinishedBlocks: uint64(p.TxIndexFinishedBlocks),
|
|
TxIndexRemainingBlocks: uint64(p.TxIndexRemainingBlocks),
|
|
}
|
|
}
|