Account Methods
eth_accounts
Returns a list of addresses owned by the client.eth_requestAccounts
Requests that the user provide an Ethereum address to be identified by. This method is used to initiate a connection between your application and the user’s wallet.Chain Information
eth_chainId
Returns the chain ID of the current network.eth_blockNumber
Returns the number of the most recent block.eth_coinbase
Returns the client coinbase address.Balance and Transaction Data
eth_getBalance
Returns the balance of the account of given address.eth_getTransactionCount
Returns the number of transactions sent from an address.eth_getTransactionByHash
Returns information about a transaction by transaction hash.eth_getTransactionReceipt
Returns the receipt of a transaction by transaction hash.Block Information
eth_getBlockByNumber
Returns information about a block by block number.eth_getBlockByHash
Returns information about a block by block hash.eth_getBlockTransactionCountByNumber
Returns the number of transactions in a block by block number.eth_getBlockTransactionCountByHash
Returns the number of transactions in a block by block hash.Transaction Methods
eth_sendTransaction
Creates new message call transaction or a contract creation for signed transactions.eth_sendRawTransaction
Creates new message call transaction or a contract creation for signed transactions.Gas and Fee Methods
eth_estimateGas
Generates and returns an estimate of how much gas is necessary to allow the transaction to complete.eth_gasPrice
Returns the current price per gas in wei.eth_feeHistory
Returns base fee per gas and transaction effective priority fee per gas history for the requested/supported block range.Contract and Storage Methods
eth_getCode
Returns code at a given address.eth_getStorageAt
Returns the value from a storage position at a given address.eth_getLogs
Returns an array of all logs matching a given filter object.eth_getProof
Returns the account and storage values of the specified account including the Merkle-proof.Signing Methods
personal_sign
Signs a message with the private key of the given account.eth_signTypedData_v4
Signs typed data according to EIP-712.Network Methods
wallet_addEthereumChain
Adds an Ethereum chain to the wallet.wallet_switchEthereumChain
Switches the wallet to the specified Ethereum chain.wallet_watchAsset
Requests that the user track the token in their wallet.Advanced Methods
eth_getTransactionByBlockHashAndIndex
Returns information about a transaction by block hash and transaction index position.eth_getTransactionByBlockNumberAndIndex
Returns information about a transaction by block number and transaction index position.eth_getUncleCountByBlockHash
Returns the number of uncles in a block by block hash.eth_getUncleCountByBlockNumber
Returns the number of uncles in a block by block number.web3_clientVersion
Returns the current client version.Error Handling
All RPC methods can throw errors. Common error codes include:-32700: Parse error-32600: Invalid request-32601: Method not found-32602: Invalid params-32603: Internal error-32000: Server error
Best Practices
- Always handle errors: RPC calls can fail for various reasons
- Use appropriate block parameters:
latest,earliest,pending, or specific block numbers - Validate addresses: Ensure addresses are properly formatted
- Cache responses: Some data doesn’t change frequently
- Use batch requests: When supported, batch multiple calls for efficiency
Compatibility
Base Account maintains full compatibility with:- Web3.js
- Ethers.js
- Wagmi
- Viem
- Other standard web3 libraries