Implementation Status : While Cosmos EVM responds to all standard Ethereum RPC methods for compatibility, many are stub implementations that return empty or null responses. This page indicates the actual implementation status of each method.Legend :
Y - FunctionalStub - Returns success but with null/empty/zero values for compatibilityN - Not Implemented - Returns error or not available This documentation lists all Ethereum JSON-RPC methods and their implementation status in Cosmos EVM. For the official Ethereum JSON-RPC specification, see the Ethereum Execution APIs repository. Namespace Configuration : By default, only the eth, net, and web3 namespaces are enabled. To enable additional namespaces like personal, txpool, debug, or miner, you must configure them in your node’s JSON-RPC API settings. Methods marked as “Requires config” are implemented but need their namespace to be explicitly enabled.
Non-Implemented Namespaces The following namespaces are not implemented in Cosmos EVM but may be present in the interactive explorer for testing against other networks:
debug - Debugging and Tracing (Not Implemented)
The debug namespace provides debugging and tracing tools for development. These methods are not implemented in Cosmos EVM. For debugging needs, use standard logging and monitoring tools.
admin - Node Administration (Not Applicable)
The admin namespace handles node administration and peer management. Cosmos nodes use different administration mechanisms through the Cosmos SDK CLI and configuration files.
miner - Mining Operations (Not Applicable)
The miner namespace controls Proof of Work mining operations. Cosmos EVM uses Tendermint Byzantine Fault Tolerant consensus instead of mining.
engine - Post-Merge Engine API (Not Applicable)
The engine namespace implements Ethereum’s post-merge Engine API for communication with the consensus layer. Cosmos EVM uses Tendermint consensus instead of the beacon chain.
clique - Proof of Authority (Not Applicable)
The clique namespace implements Proof of Authority consensus for private networks. Cosmos EVM uses Tendermint consensus.
les - Light Client Protocol (Not Supported)
The les namespace implements the Light Ethereum Subprotocol. Cosmos has a different light client architecture through IBC.
Endpoints Method Namespace Status Public Notes web3_clientVersionWeb3 Y Y web3_sha3Web3 Y Y net_versionNet Y Y net_peerCountNet Stub Y Returns “0x0” net_listeningNet Stub Y Returns true eth_protocolVersionEth Y Y eth_syncingEth Stub Y Returns false eth_gasPriceEth Stub Y Returns “0x0” eth_accountsEth Y Y eth_blockNumberEth Y Y eth_getBalanceEth Y Y eth_getStorageAtEth Y Y eth_getTransactionCountEth Y Y eth_getBlockTransactionCountByNumberEth Stub Y Returns “0x0” eth_getBlockTransactionCountByHashEth Stub Y Returns “0x0” eth_getCodeEth Stub Y Returns “0x” eth_signEth Y N eth_sendTransactionEth N N Not implemented eth_sendRawTransactionEth Y Y eth_callEth Stub Y Returns “0x” eth_estimateGasEth Y Y eth_getBlockByNumberEth Y Y eth_getBlockByHashEth Y Y eth_getTransactionByHashEth Stub Y Returns null eth_getTransactionByBlockHashAndIndexEth Stub Y Returns null eth_getTransactionReceiptEth Stub Y Returns null eth_newFilterEth Y Y eth_newBlockFilterEth Y Y eth_newPendingTransactionFilterEth Y Y eth_uninstallFilterEth Stub Y Returns true eth_getFilterChangesEth Stub Y Returns empty array eth_getFilterLogsEth Stub Y Returns empty array eth_getLogsEth Stub Y Returns [] eth_getTransactionByBlockNumberAndIndexEth Stub Y Returns null eth_getWorkEth N Y Not implemented eth_submitWorkEth N Y Not implemented eth_submitHashrateEth N Y Not implemented eth_getCompilersEth N N Not implemented eth_compileLLLEth N N Not implemented eth_compileSolidityEth N N Not implemented eth_compileSerpentEth N N Not implemented eth_signTransactionEth N N Not implemented eth_miningEth N Y Not implemented eth_coinbaseEth N Y Not implemented eth_hashrateEth N Y Not implemented eth_getUncleCountByBlockHashEth Stub Y Always “0x0” eth_getUncleCountByBlockNumberEth Stub Y Always “0x0” eth_getUncleByBlockHashAndIndexEth Stub Y Always null eth_getUncleByBlockNumberAndIndexEth Stub Y Always null eth_getProofEth N Y Requires valid height eth_feeHistoryEth Y Y EIP-1559 eth_maxPriorityFeePerGasEth Stub Y Returns “0x0” eth_chainIdEth Y Y eth_getBlockReceiptsEth Stub Y Returns empty array eth_resendEth N Y Requires nonce param eth_createAccessListEth N Y Not implemented eth_blobBaseFeeEth N Y Not implemented eth_fillTransactionEth N Y Not implemented eth_signTypedDataEth N N Requires domain param eth_signTypedData_v3Eth N N Not implemented eth_signTypedData_v4Eth N N Not implemented eth_pendingTransactionsEth N Y Not implemented eth_getPendingTransactionsEth N Y Not implemented eth_getRawTransactionByHashEth N Y Not implemented eth_getRawTransactionByBlockNumberAndIndexEth N Y Not implemented eth_getRawTransactionByBlockHashAndIndexEth N Y Not implemented eth_subscribeWebsocket Y Y WebSocket only eth_unsubscribeWebsocket Y Y WebSocket only personal_importRawKeyPersonal N N Requires valid hex key personal_listAccountsPersonal Y N Requires config personal_lockAccountPersonal Stub N Always false personal_newAccountPersonal Y N Requires config personal_unlockAccountPersonal Stub N Always false personal_sendTransactionPersonal N N Not implemented personal_signPersonal Y N Requires config personal_ecRecoverPersonal N N Requires 65-byte sig personal_initializeWalletPersonal N N Not implemented personal_unpairPersonal N N Not implemented personal_listWalletsPersonal Stub N Returns null personal_signTransactionPersonal N N Not implemented personal_signAndSendTransactionPersonal N N Not implemented personal_openWalletPersonal N N Not implemented personal_deriveAccountPersonal N N Not implemented db_putStringDB N N Deprecated db_getStringDB N N Deprecated db_putHexDB N N Deprecated db_getHexDB N N Deprecated shh_postSSH N N Deprecated shh_versionSSH N N Deprecated shh_newIdentitySSH N N Deprecated shh_hasIdentitySSH N N Deprecated shh_newGroupSSH N N Deprecated shh_addToGroupSSH N N Deprecated shh_newFilterSSH N N Deprecated shh_uninstallFilterSSH N N Deprecated shh_getFilterChangesSSH N N Deprecated shh_getMessagesSSH N N Deprecated admin_addPeerAdmin N N Returns undefined admin_removePeerAdmin N N Returns undefined admin_datadirAdmin N N Returns undefined admin_nodeInfoAdmin N N Returns undefined admin_peersAdmin N N Returns undefined admin_startHTTPAdmin N N Returns undefined admin_startWSAdmin N N Returns undefined admin_stopHTTPAdmin N N Returns undefined admin_stopWSAdmin N N Returns undefined admin_addTrustedPeerAdmin N N Returns undefined admin_removeTrustedPeerAdmin N N Returns undefined admin_startRPCAdmin N N Returns undefined admin_stopRPCAdmin N N Returns undefined admin_exportChainAdmin N N Returns undefined admin_importChainAdmin N N Returns undefined admin_sleepBlocksAdmin N N Returns undefined admin_clearPeerBanListAdmin N N Returns undefined admin_listPeerBanListAdmin N N Returns undefined clique_getSnapshotClique N N Returns undefined clique_getSnapshotAtHashClique N N Returns undefined clique_getSignersClique N N Returns undefined clique_getSignersAtHashClique N N Returns undefined clique_proposeClique N N Returns undefined clique_discardClique N N Returns undefined clique_statusClique N N Returns undefined clique_getSignerClique N N Returns undefined debug_backtraceAtDebug N N Returns undefined debug_blockProfileDebug N N Profiling disabled debug_cpuProfileDebug N N Profiling disabled debug_dumpBlockDebug N N Returns undefined debug_gcStatsDebug N N Profiling disabled debug_getBlockRlpDebug N N Requires uint64 param debug_goTraceDebug N N Profiling disabled debug_freeOSMemoryDebug N N Profiling disabled debug_memStatsDebug N N Profiling disabled debug_mutexProfileDebug N N Profiling disabled debug_seedHashDebug N N Not implemented debug_setHeadDebug N N Not implemented debug_setBlockProfileRateDebug N N Profiling disabled debug_setGCPercentDebug N N Profiling disabled debug_setMutexProfileFractionDebug N N Profiling disabled debug_stacksDebug N N Profiling disabled debug_startCPUProfileDebug N N Profiling disabled debug_startGoTraceDebug N N Profiling disabled debug_stopCPUProfileDebug N N Profiling disabled debug_stopGoTraceDebug N N Profiling disabled debug_traceBlockDebug N N Returns undefined debug_traceBlockByNumberDebug Stub N Returns empty array debug_traceBlockByHashDebug Stub N Returns empty array debug_traceBlockFromFileDebug N N Returns undefined debug_standardTraceBlockToFileDebug N N Returns undefined debug_standardTraceBadBlockToFileDebug N N Returns undefined debug_traceTransactionDebug N N Returns undefined debug_traceCallDebug N N Returns undefined debug_traceChainDebug N N Returns undefined debug_traceBadBlockDebug N N Returns undefined debug_verbosityDebug N N Not implemented debug_vmoduleDebug N N Not implemented debug_writeBlockProfileDebug N N Profiling disabled debug_writeMemProfileDebug N N Profiling disabled debug_writeMutexProfileDebug N N Profiling disabled debug_getRawBlockDebug N N Not implemented debug_getRawHeaderDebug N N Not implemented debug_getRawReceiptsDebug N N Not implemented debug_getRawTransactionDebug N N Not implemented debug_printBlockDebug N N Requires uint64 param debug_getHeaderRlpDebug N N Requires uint64 param debug_intermediateRootsDebug N N Profiling disabled debug_getBadBlocksDebug Y N debug_storageRangeAtDebug Y N debug_getModifiedAccountsByNumberDebug Y N debug_getModifiedAccountsByHashDebug Y N les_serverInfoLes N N Returns undefined les_clientInfoLes N N Returns undefined les_priorityClientInfoLes N N Returns undefined les_addBalanceLes N N Returns undefined les_setClientParamsLes N N Returns undefined les_setDefaultParamsLes N N Returns undefined les_latestCheckpointLes N N Returns undefined les_getCheckpointLes N N Returns undefined les_getCheckpointContractAddressLes N N Returns undefined txpool_contentTxPool Y Y Requires v0.4.x mempool txpool_contentFromTxPool Y Y Requires v0.4.x mempool txpool_inspectTxPool Y Y Requires v0.4.x mempool txpool_statusTxPool Y Y Requires v0.4.x mempool trace_callManyTrace N N Not implemented eth_signTypedDataEth W N EIP-712 partial eth_fillTransactionEth Y Y eth_getTransactionLogsEth Y Y Cosmos-specific miner_startMiner N N Returns undefined miner_stopMiner N N Returns undefined miner_setEtherbaseMiner N N Returns undefined miner_setGasPriceMiner N N Returns undefined miner_setGasLimitMiner N N Returns undefined miner_setExtraMiner N N Returns undefined miner_setRecommitIntervalMiner N N Returns undefined miner_getHashrateMiner N N Returns undefined engine_newPayloadV1Engine N N Returns undefined engine_newPayloadV2Engine N N Returns undefined engine_newPayloadV3Engine N N Returns undefined engine_forkchoiceUpdatedV1Engine N N Returns undefined engine_forkchoiceUpdatedV2Engine N N Returns undefined engine_forkchoiceUpdatedV3Engine N N Returns undefined engine_getPayloadV1Engine N N Returns undefined engine_getPayloadV2Engine N N Returns undefined engine_getPayloadV3Engine N N Returns undefined engine_exchangeCapabilitiesEngine N N Returns undefined engine_exchangeTransitionConfigurationV1Engine N N Returns undefined engine_getPayloadBodiesByHashV1Engine N N Returns undefined engine_getPayloadBodiesByRangeV1Engine N N Returns undefined engine_getBlobsV1Engine N N Returns undefined trace_callTrace N N Not implemented trace_rawTransactionTrace N N Not implemented trace_replayBlockTransactionsTrace N N Not implemented trace_replayTransactionTrace N N Not implemented trace_blockTrace N N Not implemented trace_filterTrace N N Not implemented trace_getTrace N N Not implemented trace_transactionTrace N N Not implemented
Block Number can be entered as a Hex string, "earliest", "latest" or "pending".
EIP-1559 Support : Cosmos EVM supports EIP-1559 transaction types with eth_maxPriorityFeePerGas, though eth_feeHistory is not yet implemented.Consensus Differences : Due to using Tendermint BFT consensus instead of Proof of Work/Stake:
Uncle-related methods always return 0 or null
Block reorganizations are not possible
Engine API (engine_*) is not applicable - Tendermint handles consensus
Methods Not Implemented :
eth_createAccessList (EIP-2930) - Access list transactionseth_feeHistory - Fee history for EIP-1559eth_getFilterChanges / eth_getFilterLogs - Filter management issueseth_fillTransaction - Transaction filling utilityeth_resend - Transaction resending utilitypersonal_sendTransaction / personal_ecRecover - Personal namespace methodspersonal_lockAccount - Always returns false (not supported)debug_getRaw* methods - Raw data access methodsdebug_printBlock - Block printing utilitytrace_* methods - Advanced tracing featuresengine_* methods - Post-merge Engine API (uses Tendermint instead)admin_* methods - Node administrationles_* methods - Light Ethereum Subprotocolclique_* methods - Proof of Authority consensus Partial Implementations :
eth_getProof - Requires block height > 2eth_signTypedData (EIP-712) - Partial implementationeth_subscribe - Works for newHeads, logs, and newPendingTransactions but not syncingpersonal_unlockAccount - Always returns falsedebug_traceTransaction - Has issues with block height For more details on how Cosmos EVM differs from standard Ethereum implementations, see Differences from Standard EVMs . Examples Below is a list of the RPC methods, the parameters and an example response from the namespaces.
Web3 Methods web3_clientVersionGet the web3 client version.
Parameters (0) Result { "jsonrpc" : "2.0" , "id" : 1 , "result" : "Cosmos/0.1.3+/linux/go1.18" } Client Examples Shell HTTP
curl -X POST -H "Content-Type: application/json" http://localhost:8545 --data '{"jsonrpc": "2.0", "id": 42, "method": "web3_clientVersion", "params": []}' Websocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "web3_clientVersion", "params": []}' Javascript Console
web3_sha3Returns Keccak-256 (not the standardized SHA3-256) of the given data.
Parameters (1) 1: input hexutil.Bytes
Result { "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x1b84adea42d5b7d192fd8a61a85b25abe0757e9a65cab1da470258914053823f" } Client Examples Shell HTTP
curl -X POST -H "Content-Type: application/json" http://localhost:8545 --data '{"jsonrpc": "2.0", "id": 42, "method": "web3_sha3", "params": [<input>]}' Websocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "web3_sha3", "params": [<input>]}' Javascript Console
Net Methods net_versionReturns the current network id.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "8" } net_peerCountReturns the number of peers currently connected to the client.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :23} net_listeningReturns if client is actively listening for network connections.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :true} Eth Methods eth_protocolVersionReturns the current ethereum protocol version.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x3f" } eth_syncingThe sync status object may need to be different depending on the details of cometbft’s sync protocol. However, the ‘synced’ result is simply a boolean, and can easily be derived from cometbft’s internal sync state.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :false} eth_gasPriceReturns the current gas price in the default EVM denomination parameter.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x0" } eth_accountsReturns array of all eth accounts.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : [ "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" , "0xddd64b4712f7c8f1ace3c145c950339eddaf221d" , "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" ]} eth_blockNumberReturns the current block height.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x66" } eth_getBalanceReturns the account balance for a given account address and Block Number.
Parameters
Account Address
Block Number or Block Hash (EIP-1898 )
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0", "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x36354d5575577c8000" } eth_getStorageAtReturns the storage address for a given account address.
Parameters
Account Address
Integer of the position in the storage
Block Number or Block Hash (EIP-1898 )
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getStorageAt","params":["0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0", "0", "latest"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x0000000000000000000000000000000000000000000000000000000000000000" } eth_getTransactionCountReturns the total transaction for a given account address and Block Number.
Parameters
Account Address
Block Number or Block Hash (EIP-1898 )
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x7bf7b17da59880d9bcca24915679668db75f9397", "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x8" } eth_getBlockTransactionCountByNumberReturns the total transaction count for a given block number.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x1"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result {"jsonrpc":"2.0","id":1,"result":{"difficulty":null,"extraData":"0x0","gasLimit":"0xffffffff","gasUsed":"0x0","hash":"0x8101cc04aea3341a6d4b3ced715e3f38de1e72867d6c0db5f5247d1a42fbb085","logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","miner":"0x0000000000000000000000000000000000000000","nonce":null,"number":"0x17d","parentHash":"0x70445488069d2584fea7d18c829e179322e2b2185b25430850deced481ca2e77","sha3Uncles":null,"size":"0x1df","stateRoot":"0x269bb17fe7adb8dd5f15f57b717979f82078d6b7a675c1ba1b0da2d27e415fcc","timestamp":"0x5f5ba97c","totalDifficulty":null,"transactions":[],"transactionsRoot":"0x","uncles":[]}} eth_getBlockTransactionCountByHashReturns the total transaction count for a given block hash.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0x8101cc04aea3341a6d4b3ced715e3f38de1e72867d6c0db5f5247d1a42fbb085"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x3" } eth_getCodeReturns the code for a given account address and Block Number.
Parameters
Account Address
Block Number or Block Hash (EIP-1898 )
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0x7bf7b17da59880d9bcca24915679668db75f9397", "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0xef616c92f3cfc9e92dc270d6acff9cea213cecc7020a76ee4395af09bdceb4837a1ebdb5735e11e7d3adb6104e0c3ac55180b4ddf5e54d022cc5e8837f6a4f971b" } eth_signThe sign method calculates an Ethereum specific signature with: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).
By adding a prefix to the message makes the calculated signature recognizable as an Ethereum specific signature. This prevents misuse where a malicious DApp can sign arbitrary data (e.g. transaction) and use the signature to impersonate the victim.
The address to sign with must be unlocked.
Parameters
Account Address
Message to sign
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x3b7252d007059ffc82d16d022da3cbf9992d2f70", "0xdeadbeaf"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x909809c76ed2a5d38733de39207d0f411222b9b49c64a192bf649cb13f63f37b45acb4f6939facb4f1c277bc70fb00407564140c0f18600ac44388f2c1dfd1dc1b" } eth_signTypedDataSigns typed structured data according to EIP-712 . This method provides a more secure way to sign structured data compared to eth_sign.
Implementation Note : This method requires a properly formatted domain parameter in the typed data structure. Without the domain, it will return an error: “domain is undefined”.
Parameters
Account Address (20 bytes)
Typed data object containing:
domain: EIP-712 domain separatortypes: Type definitionsprimaryType: Primary type namemessage: Message to sign
// Request - Note: proper domain structure is required curl -X POST --data '{"jsonrpc":"2.0","method":"eth_signTypedData","params":["0x3b7252d007059ffc82d16d022da3cbf9992d2f70", {"domain":{"name":"Example","version":"1","chainId":1,"verifyingContract":"0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC"},"types":{"EIP712Domain":[{"name":"name","type":"string"},{"name":"version","type":"string"},{"name":"chainId","type":"uint256"},{"name":"verifyingContract","type":"address"}],"Person":[{"name":"name","type":"string"},{"name":"wallet","type":"address"}]},"primaryType":"Person","message":{"name":"Bob","wallet":"0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB"}}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x..." } // Returns signature eth_sendTransactionSends transaction from given account to a given account.
Parameters
Object containing:
from: DATA, 20 Bytes - The address the transaction is send from.
to: DATA, 20 Bytes - (optional when creating new contract) The address the transaction is directed to.
gas: QUANTITY - (optional, default: 90000) Integer of the gas provided for the transaction execution. It will return unused gas.
gasPrice: QUANTITY - (optional, default: To-Be-Determined) Integer of the gasPrice used for each paid gas
value: QUANTITY - value sent with this transaction
data: DATA - The compiled code of a contract OR the hash of the invoked method signature and encoded parameters. For details see Ethereum Contract ABI.
nonce: QUANTITY - (optional) Integer of a nonce. This allows to overwrite your own pending transactions that use the same nonce.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{"from":"0x3b7252d007059ffc82d16d022da3cbf9992d2f70", "to":"0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0", "value":"0x16345785d8a0000", "gasLimit":"0x5208", "gasPrice":"0x55ae82600"}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x33653249db68ebe5c7ae36d93c9b2abc10745c80a72f591e296f598e2d4709f6" } eth_sendRawTransactionCreates new message call transaction or a contract creation for signed transactions. You can get signed transaction data using the personal_sign
Parameters
The signed transaction data
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xf9ff74c86aefeb5f6019d77280bbb44fb695b4d45cfe97e6eed7acd62905f4a85034d5c68ed25a2e7a8eeb9baf1b8401e4f865d92ec48c1763bf649e354d900b1c"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x0000000000000000000000000000000000000000000000000000000000000000" } eth_callExecutes a new message call immediately without creating a transaction on the block chain.
Parameters
Object containing:
from: DATA, 20 Bytes - (optional) The address the transaction is sent from.
to: DATA, 20 Bytes - The address the transaction is directed to.
gas: QUANTITY - gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
gasPrice: QUANTITY - gasPrice used for each paid gas
value: QUANTITY - value sent with this transaction
data: DATA - (optional) Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI in the Solidity documentation
Block number or Block Hash (EIP-1898 )
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{"from":"0x3b7252d007059ffc82d16d022da3cbf9992d2f70", "to":"0xddd64b4712f7c8f1ace3c145c950339eddaf221d", "gas":"0x5208", "gasPrice":"0x55ae82600", "value":"0x16345785d8a0000", "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"}, "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x" } eth_estimateGasReturns an estimate value of the gas required to send the transaction.
Parameters
Object containing:
from: DATA, 20 Bytes - The address the transaction is send from.
to: DATA, 20 Bytes - (optional when creating new contract) The address the transaction is directed to.
value: QUANTITY - value sent with this transaction
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{"from":"0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0", "to":"0x3b7252d007059ffc82d16d022da3cbf9992d2f70", "value":"0x16345785d8a00000"}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x1199b" } eth_getBlockByNumberReturns information about a block by block number.
Parameters
Block Number
If true it returns the full transaction objects, if false only the hashes of the transactions.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1", false],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : { " difficulty ":null," extraData ":" 0x0 "," gasLimit ":" 0xffffffff "," gasUsed ":null," hash ":" 0xabac6416f737a0eb54f47495b60246d405d138a6a64946458cf6cbeae0d48465 "," logsBloom ":" 0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 "," miner ":" 0x0000000000000000000000000000000000000000 "," nonce ":null," number ":" 0x1 "," parentHash ":" 0x "," sha3Uncles ":null," size ":" 0x9b "," stateRoot ":" 0x "," timestamp ":" 0x5f5bd3e5 "," totalDifficulty ":null," transactions ":[]," transactionsRoot ":" 0x "," uncles ":[]}} eth_getBlockByHashReturns the block info given the hash found in the command above and a bool.
Parameters
Hash of a block.
If true it returns the full transaction objects, if false only the hashes of the transactions.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4", false],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result {"jsonrpc":"2.0","id":1,"result":{"difficulty":null,"extraData":"0x0","gasLimit":"0xffffffff","gasUsed":null,"hash":"0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4","logsBloom":"0x00000000100000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000040000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000002000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000","miner":"0x0000000000000000000000000000000000000000","nonce":null,"number":"0xc","parentHash":"0x404e58f31a9ede1b614b98701d6b0fbf1450f186842dbcf6426dd16811a5ca0d","sha3Uncles":null,"size":"0x307","stateRoot":"0x599ccdb111fc62c6398dc39be957df8e97bf8ab72ce6c06ff10641a92b754627","timestamp":"0x5f5fdbbd","totalDifficulty":null,"transactions":["0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615"],"transactionsRoot":"0x4764dba431128836fa919b83d314ba9cc000e75f38e1c31a60484409acea777b","uncles":[]}} eth_getTransactionByHashReturns transaction details given the ethereum tx something.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0xec5fa15e1368d6ac314f9f64118c5794f076f63c02e66f97ea5fe1de761a8973"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : { " blockHash ":" 0x7a7398cc11d9c4c8e6f53e0c73824297aceafdab62db9e4b867a0da694384864 "," blockNumber ":" 0x188 "," from ":" 0x3b7252d007059ffc82d16d022da3cbf9992d2f70 "," gas ":" 0x147ee "," gasPrice ":" 0x3b9aca00 "," hash ":" 0xec5fa15e1368d6ac314f9f64118c5794f076f63c02e66f97ea5fe1de761a8973 "," input ":" 0x6dba746c "," nonce ":" 0x18 "," to ":" 0xa655256f589060437e5ffe2246dec385d040f148 "," transactionIndex ":" 0x0 "," value ":" 0x0 "," v ":" 0xa96 "," r ":" 0x6db399d694a452fb4106419140a6e5dbbe6817743a0f6f695a651e6576e59a5e "," s ":" 0x25dd6ab1f936d0280d2fed0caeb0ebe5b9a46de6d8cb08ad8fd2c88deb55fc31 "}} eth_getTransactionByBlockHashAndIndexReturns transaction details given the block hash and the transaction index.
Parameters
Hash of a block.
Transaction index position.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4", "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : { " blockHash ":" 0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4 "," blockNumber ":" 0xc "," from ":" 0xddd64b4712f7c8f1ace3c145c950339eddaf221d "," gas ":" 0x4c4b40 "," gasPrice ":" 0x3b9aca00 "," hash ":" 0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615 "," input ":" 0x4f2be91f "," nonce ":" 0x0 "," to ":" 0x439c697e0742a0ddb124a376efd62a72a94ac35a "," transactionIndex ":" 0x0 "," value ":" 0x0 "," v ":" 0xa96 "," r ":" 0xced57d973e58b0f634f776d57daf41d3d3387ceb347a3a72ca0746e5ec2b709e "," s ":" 0x384e89e209a5eb147a2bac3a4e399507400ac7b29cd155531f9d6203a89db3f2 "}} eth_getTransactionReceiptReturns the receipt of a transaction by transaction hash.
Note: Tx Code from CometBFT and the Ethereum receipt status are switched:
CometBFT Ethereum Success 0 1 Fail 1 0
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea614"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result {"jsonrpc":"2.0","id":1,"result":{"blockHash":"0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4","blockNumber":"0xc","contractAddress":"0x0000000000000000000000000000000000000000","cumulativeGasUsed":null,"from":"0xddd64b4712f7c8f1ace3c145c950339eddaf221d","gasUsed":"0x5289","logs":[{"address":"0x439c697e0742a0ddb124a376efd62a72a94ac35a","topics":["0x64a55044d1f2eddebe1b90e8e2853e8e96931cefadbfa0b2ceb34bee36061941"],"data":"0x0000000000000000000000000000000000000000000000000000000000000002","blockNumber":"0xc","transactionHash":"0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615","transactionIndex":"0x0","blockHash":"0x0000000000000000000000000000000000000000000000000000000000000000","logIndex":"0x0","removed":false},{"address":"0x439c697e0742a0ddb124a376efd62a72a94ac35a","topics":["0x938d2ee5be9cfb0f7270ee2eff90507e94b37625d9d2b3a61c97d30a4560b829"],"data":"0x0000000000000000000000000000000000000000000000000000000000000002","blockNumber":"0xc","transactionHash":"0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615","transactionIndex":"0x0","blockHash":"0x0000000000000000000000000000000000000000000000000000000000000000","logIndex":"0x1","removed":false}],"logsBloom":"0x00000000100000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000040000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000002000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":"0x439c697e0742a0ddb124a376efd62a72a94ac35a","transactionHash":"0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615","transactionIndex":"0x0"}} eth_newFilterCreate new filter using topics of some kind.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x0000000000000000000000000000000000000000000000000000000012341234"]}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0xdc714a4a2e3c39dc0b0b84d66a3ccb00" } eth_newBlockFilterCreates a filter in the node, to notify when a new block arrives.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x3503de5f0c766c68f78a03a3b05036a5" } eth_newPendingTransactionFilterCreates a filter in the node, to notify when new pending transactions arrive.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x9daacfb5893d946997d3801ea18e9902" } eth_uninstallFilterRemoves the filter with the given filter id. Returns true if the filter was successfully uninstalled, otherwise false.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb91b6608b61bf56288a661a1bd5eb34a"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :true} eth_getFilterChangesPolling method for a filter, which returns an array of logs which occurred since last poll.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x127e9eca4f7751fb4e5cb5291ad8b455"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result {"jsonrpc":"2.0","id":1,"result":["0xc6f08d183a81e149896fc5317c872f9092068e88e956ca1864e9bd4c81c09b44","0x3ca6dfb5be15549d721d1b3d10c1bec50ed6217c9ac7b61df361fac9692a27e5","0x776fffac134171acb1ebf2e59856625501ad5ccc5c4c8fe0359e0d4dff8919f2","0x84123103704dbd738c089276ab2b04b5936330b24f6e78453c4ba8bf4848aaf9","0xffddbe5bd8e8aa41e44002daa9ea89ade9e6980a0d83f51d104cf16498827eca","0x53430e49963e8ae32605d8f22dec2e757a691e6436d593854ca4d9383eeab86a","0x975948058c9351a91fbec332ca00dda39d1a919f5f16b996a4c7e30c38ba423b","0x619e37e32024c8efef7f7220e6caff4ee1d682ea78b2ac91e0a6b30850dc0677","0x31a5d985a40d08303ac68000ce008df512bcd1a911c497415c97f0624b4a271a","0x91dcf1fce4503a8dbb3e6fb61073f25cd31d69c766ecba639fefde4436e59d07","0x606d9e0143cfdb410a6812c590a8135b5c6b5c59eec26d760d5cd930aa47257d","0xd3c00b859b29b20ba654415eef648ef58251389c73a138580db87675b0d5465f","0x954391f0eb50888be90489898016ebb54f750f612f3adec2a00854955d5e52d8","0x698905f06aff921a9e9fcef39b8b0d107747c3e6204d2ea79cf4c12debf8d253","0x9fcafec5721938a06eb8e2951ede4b6ef8fae54a8c8f85f3166ec9782a0032b5","0xaec6d3364e47a5716ba69e4705f3c705d017f81298859589591183bfea87be7a","0x91bf2ee13319b6eaca96ed89c126437b66c4df1b13560c6a9bb18556ee3b7e1f","0x4f426dc1fc0ea8149052033065b237892d2d34927b2d558ab50c5a7fb98d6e79","0xdd809fb07e5aab638fef5311371b4e2b27c9c9a6183fde0cdd2b7724f6d2a89b","0x7e12fc92ab953e233a304959a2a8474d96195e71efd9388fdceb1326a577811a","0x30618ef6b490c3cc9979c47163459db37c1a1e0aa5793c56accd417f9d89973b","0x614609f06ee24bae7408e45895b1a25e6b19a8159aeea7a95c9d1339d9ba286f","0x115ddc6d533620040791d241f01f1c5ae3d9d1a8f64b15af5e9793e4d9096e22","0xb7458c9323beeca2cd54f32a6af5671f3cd5a7a251aed9d82bdd6ebe5f56305b","0x573dd48a5ba7bf4cc3d49597cd7419f75ecc9897258f1ebadebd670446d0d358","0xcb6670918439f9698413b53f3b5336d82ca4be152fdefaacf45e052fff6262fc","0xf3fe2a8945abafd269ab97bfdc80b3dbff2202ffdce59a227f952874b966b230","0x989980707007533cc0840a079f77f261a2e818abae1a1ffd3af02f3fff1d35fd","0x886b6ae365fec996be8a9a2c31cf4cda97ff8352908be2c83f17abd66ef1591e","0xfd90df68706ef95a62b317de93d6899a9bd6c80416e42d007f5c30fcdedfce24","0x7af8491fbb0373886d9032bb74e0ef52ed9e100f260b79bd15f46126b38cbede","0x91d1e2cd55533cf7dd5de86c9aa73295e811b1279be193d429bbd6ba83810e16","0x6b65b3128c2104005a04923288fe2aa33a2477a4962bef70532f94cab582f2a7"]} eth_getFilterLogsReturns an array of all logs matching filter with given id.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x127e9eca4f7751fb4e5cb5291ad8b455"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "error" : { " code ":-32000," message ":" filter 0x35b64c227ce30e84fc5c7bd347be380e doesn't have a LogsSubscription type: got 5"}} eth_getLogsReturns an array of all logs matching a given filter object.
Parameters
Object containing:
fromBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
toBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
address: DATA|Array, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
topics: Array of DATA, - (optional) Array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with “or” options.
blockhash: (optional, future) With the addition of EIP-234 , blockHash will be a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash. Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in in the filter criteria, then neither fromBlock nor toBlock are allowed.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x775a94827b8fd9b519d36cd827093c664f93347070a554f65e4a6f56cd738898","0x0000000000000000000000000000000000000000000000000000000000000011"], "fromBlock":"latest"}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : []} eth_coinbaseReturns the account the mining rewards will be send to.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x7cB61D4117AE31a12E393a1Cfa3BaC666481D02E" } eth_miningReturns whether the client is actively mining new blocks.
Always returns false as Cosmos EVM uses Tendermint consensus instead of mining.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :false} eth_hashrateReturns the number of hashes per second that the node is mining with.
Always returns 0x0 as Cosmos EVM uses Tendermint consensus instead of mining.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x0" } eth_chainIdReturns the chain ID used for signing replay-protected transactions.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x40000" } eth_getUncleCountByBlockHashReturns the number of uncles in a block matching the given block hash.
Always returns 0x0 as Cosmos EVM does not have uncles due to using Tendermint consensus.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x0" } eth_getUncleCountByBlockNumberReturns the number of uncles in a block matching the given block number.
Always returns 0x0 as Cosmos EVM does not have uncles due to using Tendermint consensus.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["latest"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x0" } eth_getUncleByBlockHashAndIndexReturns information about an uncle by block hash and uncle index position.
Always returns null as Cosmos EVM does not have uncles due to using Tendermint consensus.
Parameters
Block hash
Uncle index position
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4", "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} eth_getUncleByBlockNumberAndIndexReturns information about an uncle by block number and uncle index position.
Always returns null as Cosmos EVM does not have uncles due to using Tendermint consensus.
Parameters
Block number
Uncle index position
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x1", "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} eth_getTransactionByBlockNumberAndIndexReturns information about a transaction by block number and transaction index position.
Parameters
Block number
Transaction index position
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x1", "0x0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : { " blockHash ":" 0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4 "," blockNumber ":" 0x1 "," from ":" 0xddd64b4712f7c8f1ace3c145c950339eddaf221d "," gas ":" 0x4c4b40 "," gasPrice ":" 0x3b9aca00 "," hash ":" 0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615 "," input ":" 0x4f2be91f "," nonce ":" 0x0 "," to ":" 0x439c697e0742a0ddb124a376efd62a72a94ac35a "," transactionIndex ":" 0x0 "," value ":" 0x0 "," v ":" 0xa96 "," r ":" 0xced57d973e58b0f634f776d57daf41d3d3387ceb347a3a72ca0746e5ec2b709e "," s ":" 0x384e89e209a5eb147a2bac3a4e399507400ac7b29cd155531f9d6203a89db3f2 "}} eth_maxPriorityFeePerGasReturns the current maxPriorityFeePerGas per gas in wei.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_maxPriorityFeePerGas","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x0" } eth_getBlockReceiptsReturns all transaction receipts for a given block.
Parameters
Block number or block hash
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockReceipts","params":["latest"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result {"jsonrpc":"2.0","id":1,"result":[{"blockHash":"0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4","blockNumber":"0xc","contractAddress":"0x0000000000000000000000000000000000000000","cumulativeGasUsed":null,"from":"0xddd64b4712f7c8f1ace3c145c950339eddaf221d","gasUsed":"0x5289","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":"0x439c697e0742a0ddb124a376efd62a72a94ac35a","transactionHash":"0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615","transactionIndex":"0x0"}]} eth_getTransactionLogsReturns the logs for a specific transaction.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionLogs","params":["0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : [{ " address ":" 0x439c697e0742a0ddb124a376efd62a72a94ac35a "," topics ":[" 0x64a55044d1f2eddebe1b90e8e2853e8e96931cefadbfa0b2ceb34bee36061941 "]," data ":" 0x0000000000000000000000000000000000000000000000000000000000000002 "," blockNumber ":" 0xc "," transactionHash ":" 0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea615 "," transactionIndex ":" 0x0 "," blockHash ":" 0x0000000000000000000000000000000000000000000000000000000000000000 "," logIndex ":" 0x0 "," removed ":false}]} eth_fillTransactionFills the defaults (nonce, gas, gasPrice or 1559 fields) on a given unsigned transaction, and returns it to the caller for further processing (signing + broadcast).
Parameters
Transaction object with optional fields
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"eth_fillTransaction","params":[{"from":"0x0123456789012345678901234567890123456789","to":"0x0123456789012345678901234567890123456789","value":"0x1"}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : { " raw ":" 0x... "," tx ":{" nonce ":" 0x0 "," gasPrice ":" 0x3b9aca00 "," gas ":" 0x5208 "," to ":" 0x0123456789012345678901234567890123456789 "," value ":" 0x1 "," input ":" 0x "," v ":" 0x0 "," r ":" 0x0 "," s ":" 0x0 "," hash ":" 0x... "}}} eth_resendResends a transaction with updated gas parameters. Removes the given transaction from the pool and reinserts it with the new gas price and limit.
Implementation Note : This method requires a transaction nonce parameter in the transaction object. Without the nonce, it will return an error: “missing transaction nonce in transaction spec”.
Parameters
Original transaction object (must include nonce)
New gas price (hex)
New gas limit (hex)
// Request - Note the required 'nonce' field in the transaction object curl -X POST --data '{"jsonrpc":"2.0","method":"eth_resend","params":[{"from":"0x0123456789012345678901234567890123456789","to":"0x0123456789012345678901234567890123456789","value":"0x1","gas":"0x5208","gasPrice":"0x3b9aca00","nonce":"0x0"},"0x3b9aca01","0x5209"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x..." } // Returns transaction hash eth_getProofReturns the account- and storage-values of the specified account including the Merkle-proof.
Implementation Note : This method requires a valid block height. Using “latest” or block heights less than 1 will return an error: “cannot query with height < 0; please provide a valid height”. You must specify an actual block number.
Parameters
Address of account or contract
Array of storage positions (32-byte storage slot)
Block Number (must be a specific number, not “latest”)
// Request - Note: using a specific block number instead of "latest" curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getProof","params":["0x1234567890123456789012345678901234567890",["0x0000000000000000000000000000000000000000000000000000000000000000","0x0000000000000000000000000000000000000000000000000000000000000001"],"0x1"],"id":1}' -H "Content-type:application/json" http://localhost:8545 // Result {"jsonrpc": "2.0", "id": 1, "result": {"address": "0x1234567890123456789012345678901234567890", "accountProof": ["0xf90211a090dcaf88c40c7bbc95a912cbdde67c175767b31173df9ee4b0d733bfdd511c43a0babe369f6b12092f49181ae04ca173fb68d1a5456f18d20fa32cba73954052bda0473ecf8a7e36a829e75039a3b055e51b8332cbf03324ab4af2066bbd6fbf0021a0bbda34753d7aa6c38e603f360244e8f59611921d9e1f128372fec0d586d4f9e0a04e44caecff45c9891f74f6a2156735886eedf6f1a733628ebc802ec79d844648a0a5f3f2f7542148c973977c8a1e154c4300fec92f755f7846f1b734d3ab1d90e7a0e823850f50bf72baae9d1733a36a444ab65d0a6faaba404f0583ce0ca4dad92da0f7a00cbe7d4b30b11faea3ae61b7f1f2b315b61d9f6bd68bfe587ad0eeceb721a07117ef9fc932f1a88e908eaead8565c19b5645dc9e5b1b6e841c5edbdfd71681a069eb2de283f32c11f859d7bcf93da23990d3e662935ed4d6b39ce3673ec84472a0203d26456312bbc4da5cd293b75b840fc5045e493d6f904d180823ec22bfed8ea09287b5c21f2254af4e64fca76acc5cd87399c7f1ede818db4326c98ce2dc2208a06fc2d754e304c48ce6a517753c62b1a9c1d5925b89707486d7fc08919e0a94eca07b1c54f15e299bd58bdfef9741538c7828b5d7d11a489f9c20d052b3471df475a051f9dd3739a927c89e357580a4c97b40234aa01ed3d5e0390dc982a7975880a0a089d613f26159af43616fd9455bb461f4869bfede26f2130835ed067a8b967bfb80", "0xf90211a0395d87a95873cd98c21cf1df9421af03f7247880a2554e20738eec2c7507a494a0bcf6546339a1e7e14eb8fb572a968d217d2a0d1f3bc4257b22ef5333e9e4433ca012ae12498af8b2752c99efce07f3feef8ec910493be749acd63822c3558e6671a0dbf51303afdc36fc0c2d68a9bb05dab4f4917e7531e4a37ab0a153472d1b86e2a0ae90b50f067d9a2244e3d975233c0a0558c39ee152969f6678790abf773a9621a01d65cd682cc1be7c5e38d8da5c942e0a73eeaef10f387340a40a106699d494c3a06163b53d956c55544390c13634ea9aa75309f4fd866f312586942daf0f60fb37a058a52c1e858b1382a8893eb9c1f111f266eb9e21e6137aff0dddea243a567000a037b4b100761e02de63ea5f1fcfcf43e81a372dafb4419d126342136d329b7a7ba032472415864b08f808ba4374092003c8d7c40a9f7f9fe9cc8291f62538e1cc14a074e238ff5ec96b810364515551344100138916594d6af966170ff326a092fab0a0d31ac4eef14a79845200a496662e92186ca8b55e29ed0f9f59dbc6b521b116fea090607784fe738458b63c1942bba7c0321ae77e18df4961b2bc66727ea996464ea078f757653c1b63f72aff3dcc3f2a2e4c8cb4a9d36d1117c742833c84e20de994a0f78407de07f4b4cb4f899dfb95eedeb4049aeb5fc1635d65cf2f2f4dfd25d1d7a0862037513ba9d45354dd3e36264aceb2b862ac79d2050f14c95657e43a51b85c80", "0xf90171a04ad705ea7bf04339fa36b124fa221379bd5a38ffe9a6112cb2d94be3a437b879a08e45b5f72e8149c01efcb71429841d6a8879d4bbe27335604a5bff8dfdf85dcea00313d9b2f7c03733d6549ea3b810e5262ed844ea12f70993d87d3e0f04e3979ea0b59e3cdd6750fa8b15164612a5cb6567cdfb386d4e0137fccee5f35ab55d0efda0fe6db56e42f2057a071c980a778d9a0b61038f269dd74a0e90155b3f40f14364a08538587f2378a0849f9608942cf481da4120c360f8391bbcc225d811823c6432a026eac94e755534e16f9552e73025d6d9c30d1d7682a4cb5bd7741ddabfd48c50a041557da9a74ca68da793e743e81e2029b2835e1cc16e9e25bd0c1e89d4ccad6980a041dda0a40a21ade3a20fcd1a4abb2a42b74e9a32b02424ff8db4ea708a5e0fb9a09aaf8326a51f613607a8685f57458329b41e938bb761131a5747e066b81a0a16808080a022e6cef138e16d2272ef58434ddf49260dc1de1f8ad6dfca3da5d2a92aaaadc58080", "0xf851808080a009833150c367df138f1538689984b8a84fc55692d3d41fe4d1e5720ff5483a6980808080808080808080a0a319c1c415b271afc0adcb664e67738d103ac168e0bc0b7bd2da7966165cb9518080"], "balance": "0x0", "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470", "nonce": "0x0", "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "storageProof": [{"key": "0x0000000000000000000000000000000000000000000000000000000000000000", "value": "0x0", "proof": []}, {"key": "0x0000000000000000000000000000000000000000000000000000000000000001", "value": "0x0", "proof": []}]}} WebSocket Methods Read more about using websockets .
eth_subscribesubscribe using JSON-RPC notifications. This allows clients to wait for events instead of polling for them. It works by subscribing to particular events. The node will return a subscription id. For each event that matches the subscription a notification with relevant data is send together with the subscription id.
Parameters
Subscription Name
Optional Arguments
// Request { "id" : 1, "method": "eth_subscribe", "params": [ "newHeads" , {"includeTransactions": true }]} // Result < { "jsonrpc" : "2.0" , "result" : "0x34da6f29e3e953af4d0c7c58658fd525" , "id" :1} eth_unsubscribeUnsubscribe from an event using the subscription id
Parameters // Request { "id" : 1, "method": "eth_unsubscribe", "params": [ "0x34da6f29e3e953af4d0c7c58658fd525" ]} // Result { "jsonrpc" : "2.0" , "result" :true, "id" :1} Personal Methods personal_importRawKeyPrivate : Requires authentication.
Imports the given unencrypted private key (hex encoded string) into the key store, encrypting it with the passphrase. Returns the address of the new account.
Implementation Note : The private key must be a valid 64-character hex string (32 bytes) without the “0x” prefix. Invalid hex characters will return an error: “invalid hex character ‘x’ in private key”.
Parameters (2) 1: privkey string
Required: [Y] Yes
Format: 64 hex characters (32 bytes) without “0x” prefix
2: password string// Request - Note: private key without "0x" prefix curl -X POST --data '{"jsonrpc":"2.0","method":"personal_importRawKey","params":["c5bd76cd0cd948de17a31261567d219576e992d9066fe1a6bca97496dec634e2", "the key is this"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x..." } // Returns the address personal_listAccountsPrivate : Requires authentication.
Returns a list of addresses for accounts this node manages.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"personal_listAccounts","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : [ "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" , "0xddd64b4712f7c8f1ace3c145c950339eddaf221d" , "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" ]} personal_lockAccountPrivate : Requires authentication.
Removes the private key with given address from memory. The account can no longer be used to send transactions.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"personal_lockAccount","params":["0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :true} personal_newAccountPrivate : Requires authentication.
Generates a new private key and stores it in the key store directory. The key file is encrypted with the given passphrase. It returns the address of the new account.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"personal_newAccount","params":["This is the passphrase"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0xf0e4086ad1c6aab5d42161d5baaae2f9ad0571c0" } personal_unlockAccountPrivate : Requires authentication.
Decrypts the key with the given address from the key store.
Both passphrase and unlock duration are optional when using the JavaScript console. The unencrypted key will be held in memory until the unlock duration expires. If the unlock duration defaults to 300 seconds. An explicit duration of zero seconds unlocks the key until geth exits.
The account can be used with eth_signeth_sendTransaction
Parameters
Account Address
Passphrase
Duration
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"personal_unlockAccount","params":["0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0", "secret passphrase", 30],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :true} personal_sendTransactionPrivate : Requires authentication.
Validate the given passphrase and submit transaction.
The transaction is the same argument as for eth_sendTransactionfrom address. If the passphrase can be used to decrypt the private key belonging to tx.from the transaction is verified, signed and send onto the network.
The account is not unlocked globally in the node and cannot be used in other RPC calls.
Parameters
Object containing:
from: DATA, 20 Bytes - The address the transaction is send from.
to: DATA, 20 Bytes - (optional when creating new contract) The address the transaction is directed to.
value: QUANTITY - value sent with this transaction
Passphrase
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"personal_sendTransaction","params":[{"from":"0x3b7252d007059ffc82d16d022da3cbf9992d2f70","to":"0xddd64b4712f7c8f1ace3c145c950339eddaf221d", "value":"0x16345785d8a0000"}, "passphrase"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0xd2a31ec1b89615c8d1f4d08fe4e4182efa4a9c0d5758ace6676f485ea60e154c" } personal_signPrivate : Requires authentication.
The sign method calculates an Ethereum specific signature with: sign(keccack256("\x19Ethereum Signed Message:\n" + len(message) + message))),
Parameters
Message
Account Address
Password
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"personal_sign","params":["0xdeadbeaf", "0x3b7252d007059ffc82d16d022da3cbf9992d2f70", "password"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0xf9ff74c86aefeb5f6019d77280bbb44fb695b4d45cfe97e6eed7acd62905f4a85034d5c68ed25a2e7a8eeb9baf1b8401e4f865d92ec48c1763bf649e354d900b1c" } personal_ecRecoverPrivate : Requires authentication.
ecRecover returns the address associated with the private key that was used to calculate the signature in personal_signImplementation Note : The signature must be exactly 65 bytes (130 hex characters). Signatures of other lengths will return an error: “signature must be 65 bytes long”.
Parameters
Message (hex encoded)
Signature returned from personal_sign
// Request - Note: signature must be exactly 130 hex characters (65 bytes ) curl -X POST --data '{"jsonrpc":"2.0","method":"personal_ecRecover","params":["0xdeadbeaf", "0xf9ff74c86aefeb5f6019d77280bbb44fb695b4d45cfe97e6eed7acd62905f4a85034d5c68ed25a2e7a8eeb9baf1b8401e4f865d92ec48c1763bf649e354d900b1c"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" } personal_initializeWalletPrivate : Requires authentication.
Initializes a new wallet at the provided URL, by generating and returning a new private key.
Parameters (1) Parameters must be given by position.
1: url string
Client Examples Shell HTTP
curl -X POST -H "Content-Type: application/json" http://localhost:8545 --data '{"jsonrpc": "2.0", "id": 42, "method": "personal_initializeWallet", "params": [<url>]}' Websocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "personal_initializeWallet", "params": [<url>]}' Javascript Console
personal . initializeWallet ( url ); personal_unpairPrivate : Requires authentication.
Unpair deletes a pairing between wallet and the node.
Parameters (2) Client Examples Shell HTTP
curl -X POST -H "Content-Type: application/json" http://localhost:8545 --data '{"jsonrpc": "2.0", "id": 42, "method": "personal_unpair", "params": [<url>, <pin>]}' WebSocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "personal_unpair", "params": [<url>, <pin>]}' Javascript Console
personal . unpair ( url , pin ); personal_listWalletsPrivate : Requires authentication.
Returns a list of wallets this node manages.
Currently returns null as wallet-level management is not supported.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"personal_listWallets","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} Debug Methods debug_traceTransactionThe traceTransaction debugging method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_traceTransaction","params":["0xddecdb13226339681372b44e01df0fbc0f446fca6f834b2de5ecb1e569022ec8", {"tracer": "{data: [], fault: function(log) {}, step: function(log) { if(log.op.toString() == \"CALL\") this.data.push(log.stack.peek(0)); }, result: function() { return this.data; }}"}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 //Result [ "68410" , "51470" ] debug_traceBlockByNumberThe traceBlockByNumber endpoint accepts a block number and will replay the block that is already present in the database.
Stub Implementation : This method is implemented but currently returns an empty array for all requests. The tracing functionality is not fully operational in Cosmos EVM.
Parameters
Block number (hex string)
Trace Config (optional)
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_traceBlockByNumber","params":["0xe", {"tracer": "{data: [], fault: function(log) {}, step: function(log) { if(log.op.toString() == \"CALL\") this.data.push(log.stack.peek(0)); }, result: function() { return this.data; }}"}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result - Currently returns empty array { "jsonrpc" : "2.0" , "id" :1, "result" : []} debug_traceBlockByHashSimilar to debug_traceBlockByNumber, this method accepts a block hash and will replay the block that is already present in the database.
Stub Implementation : This method is implemented but currently returns an empty array for all requests. The tracing functionality is not fully operational in Cosmos EVM.
Parameters
Block hash (32-byte hash)
Trace Config (optional)
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_traceBlockByHash","params":["0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4", {}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result - Currently returns empty array { "jsonrpc" : "2.0" , "id" :1, "result" : []} debug_freeOSMemoryForces the Go runtime to perform a garbage collection and return unused memory to the OS.
Private : Requires authentication.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_freeOSMemory","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_setGCPercentSets the garbage collection target percentage. A negative value disables garbage collection.
Private : Requires authentication.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_setGCPercent","params":[100],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :100} debug_memStatsReturns detailed runtime memory statistics.
Private : Requires authentication.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_memStats","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : { " Alloc ":83328680," TotalAlloc ":451796592," Sys ":166452520," Lookups ":0," Mallocs ":4071615," Frees ":3772501," HeapAlloc ":83328680," HeapSys ":153452544," HeapIdle ":51568640," HeapInuse ":101883904," HeapReleased ":44720128," HeapObjects ":299114," StackInuse ":1736704," StackSys ":1736704," MSpanInuse ":1119520," MSpanSys ":1958400," MCacheInuse ":16912," MCacheSys ":31408," BuckHashSys ":1583603," GCSys ":5251008," OtherSys ":2438853," NextGC ":142217095," LastGC ":1754180652189080000," PauseTotalNs ":1266251," NumGC ":18," NumForcedGC ":1," GCCPUFraction ":0.0002128524091018015," EnableGC ":true," DebugGC ":false}} debug_setBlockProfileRateSets the rate of goroutine block profile data collection. A non-zero value enables block profiling.
Private : Requires authentication.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_setBlockProfileRate","params":[1],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_writeBlockProfileWrites a goroutine blocking profile to the specified file.
Private : Requires authentication.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_writeBlockProfile","params":["block.prof"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_writeMemProfileWrites an allocation profile to the specified file.
Private : Requires authentication.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_writeMemProfile","params":["mem.prof"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_writeMutexProfileWrites a mutex contention profile to the specified file.
Private : Requires authentication.
Parameters // Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_writeMutexProfile","params":["mutex.prof"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_blockProfileTurns on block profiling for the given duration and writes the profile data to disk.
Private : Requires authentication.
Parameters
File path (string) - Output file for the profile
Duration in seconds (number)
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_blockProfile","params":["block.prof", 30],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_cpuProfileTurns on CPU profiling for the given duration and writes the profile data to disk.
Private : Requires authentication.
Parameters
File path (string) - Output file for the profile
Duration in seconds (number)
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_cpuProfile","params":["cpu.prof", 30],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_gcStatsReturns garbage collection statistics.
Private : Requires authentication.
Cosmos-specific : This method is unique to Cosmos EVM.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_gcStats","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : { " NumGC ":10," PauseTotal ":1000000," Pause ":[100000,200000]," PauseEnd ":[1234567890,1234567891]," ... ":" ... "}} debug_goTraceTurns on Go runtime tracing for the given duration and writes the trace data to disk.
Private : Requires authentication.
Parameters
File path (string) - Output file for the trace
Duration in seconds (number)
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_goTrace","params":["trace.out", 5],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_stacksReturns a printed representation of the stacks of all goroutines.
Private : Requires authentication.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_stacks","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "goroutine 1 [running]:\n..." } debug_startCPUProfileStarts indefinite CPU profiling, writing to the given file.
Private : Requires authentication.
Parameters
File path (string) - Output file for the profile
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_startCPUProfile","params":["cpu.prof"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_stopCPUProfileStops an ongoing CPU profile.
Private : Requires authentication.
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_stopCPUProfile","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_mutexProfileTurns on mutex profiling for the given duration and writes the profile data to disk.
Private : Requires authentication.
Parameters
File path (string) - Output file for the profile
Duration in seconds (number)
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_mutexProfile","params":["mutex.prof", 10],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :null} debug_setMutexProfileFractionSets the rate of mutex profiling.
Private : Requires authentication.
Cosmos-specific : This method is unique to Cosmos EVM.
Parameters
Rate (number) - 0 to disable, 1 for full profiling
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_setMutexProfileFraction","params":[1],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" :0} Returns the RLP encoding of the header of the block.
Private : Requires authentication.
Parameter Type : This method requires the block number as a uint64 (number type), not a hex string. Passing a string will return an error: “invalid argument 0: json: cannot unmarshal string into Go value of type uint64”.
Parameters
Block number (uint64 number, not hex string)
// Request - Note: block number as integer, not hex string curl -X POST --data '{"jsonrpc":"2.0","method":"debug_getHeaderRlp","params":[100],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0xf90..." } debug_getBlockRlpReturns the RLP encoding of the block.
Private : Requires authentication.
Parameter Type : This method requires the block number as a uint64 (number type), not a hex string. Passing a string will return an error: “invalid argument 0: json: cannot unmarshal string into Go value of type uint64”.
Parameters
Block number (uint64 number, not hex string)
// Request - Note: block number as integer, not hex string curl -X POST --data '{"jsonrpc":"2.0","method":"debug_getBlockRlp","params":[100],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "0xf90..." } debug_printBlockReturns a formatted string of the block.
Private : Requires authentication.
Parameter Type : This method requires the block number as a uint64 (number type), not a hex string. Passing a string will return an error: “invalid argument 0: json: cannot unmarshal string into Go value of type uint64”.
Parameters
Block number (uint64 number, not hex string)
// Request - Note: block number as integer, not hex string curl -X POST --data '{"jsonrpc":"2.0","method":"debug_printBlock","params":[100],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : "Block #100\nParent: 0x...\nStateRoot: 0x...\n..." } Returns the intermediate state roots for a transaction.
Private : Requires authentication.
Parameters
Transaction hash (hash)
Trace config (object, optional)
// Request curl -X POST --data '{"jsonrpc":"2.0","method":"debug_intermediateRoots","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b", {}],"id":1}' -H "Content-Type: application/json" http://localhost:8545 // Result { "jsonrpc" : "2.0" , "id" :1, "result" : [ "0x..." , "0x..." ]} TxPool Methods txpool_contentReturns a list of the exact details of all the transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only.
Parameters (0) Client Examples Shell HTTP
curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_content","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 Websocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "txpool_content", "params": []}' Javascript Console
Result { "jsonrpc" : "2.0" , "id" : 1 , "result" :{ "pending" :{}, "queued" :{}}} txpool_contentFromReturns transactions from a specific address that are currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only.
Parameters (1)
address - The address to filter transactions from (20 bytes)
Client Examples Shell HTTP
curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_contentFrom","params":["0x1234567890abcdef1234567890abcdef12345678"],"id":1}' -H "Content-Type: application/json" http://localhost:8545 Websocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "txpool_contentFrom", "params": ["0x1234567890abcdef1234567890abcdef12345678"]}' Javascript Console
txpool . contentFrom ( "0x1234567890abcdef1234567890abcdef12345678" ); Result { "jsonrpc" : "2.0" , "id" : 1 , "result" :{ "pending" :{}, "queued" :{}}} txpool_inspectReturns a list on text format to summarize all the transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only. This is a method specifically tailored to developers to quickly see the transactions in the pool and find any potential issues.
Parameters (0) Client Examples Shell HTTP
curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_inspect","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 Websocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "txpool_inspect", "params": []}' Javascript Console
Result { "jsonrpc" : "2.0" , "id" : 1 , "result" :{ "pending" :{}, "queued" :{}}} txpool_statusReturns the number of transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only.
Parameters (0) Client Examples Shell HTTP
curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_status","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545 Websocket
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "txpool_status", "params": []}' Javascript Console
Result { "jsonrpc" : "2.0" , "id" : 1 , "result" :{ "pending" : "0x0" , "queued" : "0x0" }} 
