Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

ethclient

package

Go to main page

Versions in this module

v1

v1.0.4

Sep 26, 2025

Changes in this version

+ func RevertErrorData(err error) ([]byte, bool)

type Client

+ func DialOptions(ctx context.Context, rawurl string, opts ...rpc.ClientOption) (*Client, error)

+ func (ec *Client) BalanceAtHash(ctx context.Context, account common.Address, blockHash common.Hash) (*big.Int, error)

+ func (ec *Client) BestBidGasFee(ctx context.Context, parentHash common.Hash) (*big.Int, error)

+ func (ec *Client) BlobBaseFee(ctx context.Context) (*big.Int, error)

+ func (ec *Client) BlobSidecarByTxHash(ctx context.Context, hash common.Hash) (*types.BlobSidecar, error)

+ func (ec *Client) BlobSidecars(ctx context.Context, blockNrOrHash rpc.BlockNumberOrHash) ([]*types.BlobSidecar, error)

+ func (ec *Client) BlockReceipts(ctx context.Context, blockNrOrHash rpc.BlockNumberOrHash) ([]*types.Receipt, error)

+ func (ec *Client) CallContractAtHash(ctx context.Context, msg ethereum.CallMsg, blockHash common.Hash) ([]byte, error)

+ func (ec *Client) Client() *rpc.Client

+ func (ec *Client) CodeAtHash(ctx context.Context, account common.Address, blockHash common.Hash) ([]byte, error)

+ func (ec *Client) EstimateGasAtBlock(ctx context.Context, msg ethereum.CallMsg, blockNumber *big.Int) (uint64, error)

+ func (ec *Client) EstimateGasAtBlockHash(ctx context.Context, msg ethereum.CallMsg, blockHash common.Hash) (uint64, error)

+ func (ec *Client) FeeHistory(ctx context.Context, blockCount uint64, lastBlock *big.Int, ...) (*ethereum.FeeHistory, error)

+ func (ec *Client) FinalizedBlock(ctx context.Context, verifiedValidatorNum int64, fullTx bool) (*types.Block, error)

+ func (ec *Client) FinalizedHeader(ctx context.Context, verifiedValidatorNum int64) (*types.Header, error)

+ func (ec *Client) GetRootByDiffHash(ctx context.Context, blockNr *big.Int, blockHash common.Hash, ...) (*core.VerifyResult, error)

+ func (ec *Client) HasBuilder(ctx context.Context, address common.Address) (bool, error)

+ func (ec *Client) LockBalanceAtHash(ctx context.Context, account common.Address, blockHash common.Hash) (*big.Int, error)

+ func (ec *Client) MevParams(ctx context.Context) (*types.MevParams, error)

+ func (ec *Client) MevRunning(ctx context.Context) (bool, error)

+ func (ec *Client) NonceAtHash(ctx context.Context, account common.Address, blockHash common.Hash) (uint64, error)

+ func (ec *Client) PeerCount(ctx context.Context) (uint64, error)

+ func (ec *Client) SendBid(ctx context.Context, args types.BidArgs) (common.Hash, error)

+ func (ec *Client) SendTransactionConditional(ctx context.Context, tx *types.Transaction, opts types.TransactionOpts) error

+ func (ec *Client) StorageAtHash(ctx context.Context, account common.Address, key common.Hash, ...) ([]byte, error)

+ func (ec *Client) SubscribeNewFinalizedHeader(ctx context.Context, ch chan<- *types.Header) (ethereum.Subscription, error)

+ func (ec *Client) SubscribeNewVotes(ctx context.Context, ch chan<- *types.VoteEnvelope) (ethereum.Subscription, error)

+ func (ec *Client) SuggestGasTipCap(ctx context.Context) (*big.Int, error)

v1.0.3

Aug 5, 2025

v1.0.2

Apr 9, 2025

Changes in this version

+ type Client struct

+ func Dial(rawurl string) (*Client, error)

+ func DialContext(ctx context.Context, rawurl string) (*Client, error)

+ func NewClient(c *rpc.Client) *Client

+ func (ec *Client) BalanceAt(ctx context.Context, account common.Address, blockNumber *big.Int) (*big.Int, error)

+ func (ec *Client) BlockByHash(ctx context.Context, hash common.Hash) (*types.Block, error)

+ func (ec *Client) BlockByNumber(ctx context.Context, number *big.Int) (*types.Block, error)

+ func (ec *Client) BlockNumber(ctx context.Context) (uint64, error)

+ func (ec *Client) CallContract(ctx context.Context, msg ethereum.CallMsg, blockNumber *big.Int) ([]byte, error)

+ func (ec *Client) ChainID(ctx context.Context) (*big.Int, error)

+ func (ec *Client) Close()

+ func (ec *Client) CodeAt(ctx context.Context, account common.Address, blockNumber *big.Int) ([]byte, error)

+ func (ec *Client) EstimateGas(ctx context.Context, msg ethereum.CallMsg) (uint64, error)

+ func (ec *Client) FilterLogs(ctx context.Context, q ethereum.FilterQuery) ([]types.Log, error)

+ func (ec *Client) HeaderByHash(ctx context.Context, hash common.Hash) (*types.Header, error)

+ func (ec *Client) HeaderByNumber(ctx context.Context, number *big.Int) (*types.Header, error)

+ func (ec *Client) LockBalanceAt(ctx context.Context, account common.Address, blockNumber *big.Int) (*big.Int, error)

+ func (ec *Client) NetworkID(ctx context.Context) (*big.Int, error)

+ func (ec *Client) NonceAt(ctx context.Context, account common.Address, blockNumber *big.Int) (uint64, error)

+ func (ec *Client) PendingBalanceAt(ctx context.Context, account common.Address) (*big.Int, error)

+ func (ec *Client) PendingCallContract(ctx context.Context, msg ethereum.CallMsg) ([]byte, error)

+ func (ec *Client) PendingCodeAt(ctx context.Context, account common.Address) ([]byte, error)

+ func (ec *Client) PendingNonceAt(ctx context.Context, account common.Address) (uint64, error)

+ func (ec *Client) PendingStorageAt(ctx context.Context, account common.Address, key common.Hash) ([]byte, error)

+ func (ec *Client) PendingTransactionCount(ctx context.Context) (uint, error)

+ func (ec *Client) PosEtherbase(ctx context.Context, msg ethereum.CallMsg) ([]common.Address, error)

+ func (ec *Client) SendTransaction(ctx context.Context, tx *types.Transaction) error

+ func (ec *Client) StorageAt(ctx context.Context, account common.Address, key common.Hash, ...) ([]byte, error)

+ func (ec *Client) SubscribeFilterLogs(ctx context.Context, q ethereum.FilterQuery, ch chan<- types.Log) (ethereum.Subscription, error)

+ func (ec *Client) SubscribeNewHead(ctx context.Context, ch chan<- *types.Header) (ethereum.Subscription, error)

+ func (ec *Client) SuggestGasPrice(ctx context.Context) (*big.Int, error)

+ func (ec *Client) SyncProgress(ctx context.Context) (*ethereum.SyncProgress, error)

+ func (ec *Client) TransactionByHash(ctx context.Context, hash common.Hash) (tx *types.Transaction, isPending bool, err error)

+ func (ec *Client) TransactionCount(ctx context.Context, blockHash common.Hash) (uint, error)

+ func (ec *Client) TransactionDataAndReceipt(ctx context.Context, txHash common.Hash) (*types.OriginalDataAndReceipt, error)

+ func (ec *Client) TransactionInBlock(ctx context.Context, blockHash common.Hash, index uint) (*types.Transaction, error)

+ func (ec *Client) TransactionReceipt(ctx context.Context, txHash common.Hash) (*types.Receipt, error)

+ func (ec *Client) TransactionRecipientsInBlock(ctx context.Context, number *big.Int) ([]*types.Receipt, error)

+ func (ec *Client) TransactionSender(ctx context.Context, tx *types.Transaction, block common.Hash, index uint) (common.Address, error)

+ func (ec *Client) TransactionsInBlock(ctx context.Context, number *big.Int) ([]*types.Transaction, error)