JSON-RPC Methods Check the JSON-RPC methods supported on Majestic StarChain.
Pre-requisite Readings Endpoints Block Number can be entered as a Hex string, "earliest", "latest" or "pending".
Below is a list of the RPC methods, the parameters and an example response from the namespaces.
Web3 Methods web3_sha3 Returns Keccak-256 (not the standardized SHA3-256) of the given data.
Parameters (1) 1: input hexutil.Bytes
Result
Copy
{
"jsonrpc" : "2.0" ,
"id" : 1 ,
"result" : "0x1b84adea42d5b7d192fd8a61a85b25abe0757e9a65cab1da470258914053823f"
}
Client Examples
Copy
curl -X POST -H "Content-Type: application/json" http://localhost:8545 --data '{"jsonrpc": "2.0", "id": 42, "method": "web3_sha3", "params": [<input>]}'
Copy
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "web3_sha3", "params": [<input>]}'
Net Methods net_version Returns the current network id.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "net_version" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "8" }
net_peerCount Returns the number of peers currently connected to the client.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "net_peerCount" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : 23 }
net_listening Returns if client is actively listening for network connections.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "net_listening" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : true }
Eth Methods eth_protocolVersion Returns the current ethereum protocol version.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_protocolVersion" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x3f" }
eth_syncing The sync status object may need to be different depending on the details of Tendermint's sync protocol. However, the 'synced' result is simply a boolean, and can easily be derived from Tendermint's internal sync state.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_syncing" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : false }
eth_gasPrice Returns the current gas price in the default EVM denomination parameter.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_gasPrice" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x0" }
eth_accounts Returns array of all eth accounts.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_accounts" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : [ "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" , "0xddd64b4712f7c8f1ace3c145c950339eddaf221d" , "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" ] }
eth_blockNumber Returns the current block height.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_blockNumber" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x66" }
eth_getBalance Returns the account balance for a given account address and Block Number.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getBalance" , "params" : [ "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" , "0x0" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x36354d5575577c8000" }
eth_getStorageAt Returns the storage address for a given account address.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getStorageAt" , "params" : [ "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" , "0" , `"latest" `] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x0000000000000000000000000000000000000000000000000000000000000000" }
eth_getTransactionCount Returns the total transaction for a given account address and Block Number.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getTransactionCount" , "params" : [ "0x7bf7b17da59880d9bcca24915679668db75f9397" , "0x0" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x8" }
eth_getBlockTransactionCountByNumber Returns the total transaction count for a given block number.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getBlockTransactionCountByNumber" , "params" : [ "0x1" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "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_getBlockTransactionCountByHash Returns the total transaction count for a given block hash.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getBlockTransactionCountByHash" , "params" : [ "0x8101cc04aea3341a6d4b3ced715e3f38de1e72867d6c0db5f5247d1a42fbb085" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x3" }
eth_getCode Returns the code for a given account address and Block Number.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getCode" , "params" : [ "0x7bf7b17da59880d9bcca24915679668db75f9397" , "0x0" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0xef616c92f3cfc9e92dc270d6acff9cea213cecc7020a76ee4395af09bdceb4837a1ebdb5735e11e7d3adb6104e0c3ac55180b4ddf5e54d022cc5e8837f6a4f971b" }
eth_sign The 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
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_sign" , "params" : [ "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" , "0xdeadbeaf" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x909809c76ed2a5d38733de39207d0f411222b9b49c64a192bf649cb13f63f37b45acb4f6939facb4f1c277bc70fb00407564140c0f18600ac44388f2c1dfd1dc1b" }
eth_sendTransaction Sends 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.
Copy
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:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x33653249db68ebe5c7ae36d93c9b2abc10745c80a72f591e296f598e2d4709f6" }
eth_sendRawTransaction Creates 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
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_sendRawTransaction" , "params" : [ "0xf9ff74c86aefeb5f6019d77280bbb44fb695b4d45cfe97e6eed7acd62905f4a85034d5c68ed25a2e7a8eeb9baf1b8401e4f865d92ec48c1763bf649e354d900b1c" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x0000000000000000000000000000000000000000000000000000000000000000" }
eth_call Executes 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(opens new window) )
Copy
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:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x" }
eth_estimateGas Returns 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
Copy
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:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x1199b" }
eth_getBlockByNumber Returns information about a block by block number.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getBlockByNumber" , "params" : [ "0x1" , false ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "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_getBlockByHash Returns the block info given the hash found in the command above and a bool.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getBlockByHash" , "params" : [ "0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4" , false ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "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_getTransactionByHash Returns transaction details given the ethereum tx something.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getTransactionByHash" , "params" : [ "0xec5fa15e1368d6ac314f9f64118c5794f076f63c02e66f97ea5fe1de761a8973" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "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_getTransactionByBlockHashAndIndex Returns transaction details given the block hash and the transaction index.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getTransactionByBlockHashAndIndex" , "params" : [ "0x1b9911f57c13e5160d567ea6cf5b545413f96b95e43ec6e02787043351fb2cc4" , "0x0" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "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_getTransactionReceipt Returns the receipt of a transaction by transaction hash.
Note: Tx Code from Tendermint and the Ethereum receipt status are switched:
Tendermint Ethereum Success 0 1 Fail 1 0
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getTransactionReceipt" , "params" : [ "0xae64961cb206a9773a6e5efeb337773a6fd0a2085ce480a174135a029afea614" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "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_newFilter Create new filter using topics of some kind.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_newFilter" , "params" : [ { "topics" : [ "0x0000000000000000000000000000000000000000000000000000000012341234" ] } ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0xdc714a4a2e3c39dc0b0b84d66a3ccb00" }
eth_newBlockFilter Creates a filter in the node, to notify when a new block arrives.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_newBlockFilter" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x3503de5f0c766c68f78a03a3b05036a5" }
eth_newPendingTransactionFilter Creates a filter in the node, to notify when new pending transactions arrive.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_newPendingTransactionFilter" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x9daacfb5893d946997d3801ea18e9902" }
eth_uninstallFilter Removes the filter with the given filter id. Returns true if the filter was successfully uninstalled, otherwise false.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_uninstallFilter" , "params" : [ "0xb91b6608b61bf56288a661a1bd5eb34a" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : true }
eth_getFilterChanges Polling method for a filter, which returns an array of logs which occurred since last poll.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getFilterChanges" , "params" : [ "0x127e9eca4f7751fb4e5cb5291ad8b455" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "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_getFilterLogs Returns an array of all logs matching filter with given id.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getFilterLogs" , "params" : [ "0x127e9eca4f7751fb4e5cb5291ad8b455" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "error" : { "code" : -32000 , "message" : "filter 0x35b64c227ce30e84fc5c7bd347be380e doesn't have a LogsSubscription type: got 5" } }
eth_getLogs Returns 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(opens new window) , 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.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getLogs" , "params" : [ { "topics" : [ "0x775a94827b8fd9b519d36cd827093c664f93347070a554f65e4a6f56cd738898" , "0x0000000000000000000000000000000000000000000000000000000000000011" ] , "fromBlock" : `"latest" `} ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : [ ] }
eth_coinbase Returns the account the mining rewards will be send to.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_coinbase" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x7cB61D4117AE31a12E393a1Cfa3BaC666481D02E" }
eth_getProof Returns the account- and storage-values of the specified account including the Merkle-proof.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "eth_getProof" , "params" : [ "0x1234567890123456789012345678901234567890" , [ "0x0000000000000000000000000000000000000000000000000000000000000000" , "0x0000000000000000000000000000000000000000000000000000000000000001" ] , `"latest" `] , "id" : 1 } ' -H "Content-type:application/json" http:
{ "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 about websockets in events
eth_subscribe subscribe 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
Copy
{ "id" : 1 , "method" : "eth_subscribe" , "params" : [ "newHeads" , { "includeTransactions" : true } ] }
< { "jsonrpc" : "2.0" , "result" : "0x34da6f29e3e953af4d0c7c58658fd525" , "id" : 1 }
eth_unsubscribe Unsubscribe from an event using the subscription id
Parameters
Copy
{ "id" : 1 , "method" : "eth_unsubscribe" , "params" : [ "0x34da6f29e3e953af4d0c7c58658fd525" ] }
{ "jsonrpc" : "2.0" , "result" : true , "id" : 1 }
Personal Methods personal_importRawKey Private : 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.
Parameters (2) 1: privkey string
2: password string
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "personal_importRawKey" , "params" : [ "c5bd76cd0cd948de17a31261567d219576e992d9066fe1a6bca97496dec634e2c8e06f8949773b300b9f73fabbbc7710d5d6691e96bcf3c9145e15daf6fe07b9" , "the key is this" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
personal_listAccounts Private : Requires authentication.
Returns a list of addresses for accounts this node manages.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "personal_listAccounts" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : [ "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" , "0xddd64b4712f7c8f1ace3c145c950339eddaf221d" , "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" ] }
personal_lockAccount Private : Requires authentication.
Removes the private key with given address from memory. The account can no longer be used to send transactions.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "personal_lockAccount" , "params" : [ "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : true }
personal_newAccount Private : Requires authentication.
Generates a new private key and stores it in the key store directory. The key file is encrypted with the given passphrase. Returns the address of the new account.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "personal_newAccount" , "params" : [ "This is the passphrase" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0xf0e4086ad1c6aab5d42161d5baaae2f9ad0571c0" }
personal_unlockAccount Private : 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
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "personal_unlockAccount" , "params" : [ "0x0f54f47bf9b8e317b214ccd6a7c3e38b893cd7f0" , "secret passphrase" , 30 ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : true }
personal_sendTransaction Private : 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
Copy
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:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0xd2a31ec1b89615c8d1f4d08fe4e4182efa4a9c0d5758ace6676f485ea60e154c" }
personal_sign Private : 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
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "personal_sign" , "params" : [ "0xdeadbeaf" , "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" , "password" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0xf9ff74c86aefeb5f6019d77280bbb44fb695b4d45cfe97e6eed7acd62905f4a85034d5c68ed25a2e7a8eeb9baf1b8401e4f865d92ec48c1763bf649e354d900b1c" }
personal_ecRecover Private : Requires authentication.
ecRecover returns the address associated with the private key that was used to calculate the signature in personal_sign
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "personal_ecRecover" , "params" : [ "0xdeadbeaf" , "0xf9ff74c86aefeb5f6019d77280bbb44fb695b4d45cfe97e6eed7acd62905f4a85034d5c68ed25a2e7a8eeb9baf1b8401e4f865d92ec48c1763bf649e354d900b1c" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" }
personal_initializeWallet Private : 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
Copy
curl -X POST -H "Content-Type: application/json" http://localhost:8545 --data '{"jsonrpc": "2.0", "id": 42, "method": "personal_initializeWallet", "params": [<url>]}'
Copy
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "personal_initializeWallet", "params": [<url>]}'
Copy
personal. initializeWallet ( url) ;
personal_unpair Private : Requires authentication.
Unpair deletes a pairing between wallet and the node.
Parameters (2) Client Examples
Copy
curl -X POST -H "Content-Type: application/json" http://localhost:8545 --data '{"jsonrpc": "2.0", "id": 42, "method": "personal_unpair", "params": [<url>, <pin>]}'
Copy
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "personal_unpair", "params": [<url>, <pin>]}'
Copy
personal. unpair ( url, pin) ;
Debug Methods debug_traceTransaction The 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
Copy
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:
[ "68410" , "51470" ]
debug_traceBlockByNumber The traceBlockByNumber endpoint accepts a block number and will replay the block that is already present in the database.
Parameters
Copy
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:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : [ { "result" : [ "68410" , "51470" ] } ] }
Miner Methods miner_getHashrate Private : Requires authentication.
Get the hashrate in H/s (Hash operations per second).
Proof-of-Work specific. This endpoint always returns 0.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_setGasPrice" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : 0 }
Private : Requires authentication.
Sets the extra data a validator can include when proposing blocks. This is capped at 32 bytes.
Unsupported. This endpoint always returns an error
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_setExtra" , "params" : [ "data" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : false }
miner_setGasPrice Private : Requires authentication.
Sets the minimal gas price used to accept transactions. Any transaction below this limit is excluded from the validator block proposal process.
This method requires a node restart after being called because it changes the configuration file.
Make sure your mjtd start call is not using the flag minimum-gas-prices because this value will be used instead of the one set on the configuration file.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_setGasPrice" , "params" : [ "0x0" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : true }
miner_start Private : Requires authentication.
Start the CPU validation process with the given number of threads.
Unsupported. This endpoint always returns an error
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_start" , "params" : [ "0x1" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : false }
miner_stop Private : Requires authentication.
Stop the validation operation.
Unsupported. This endpoint always performs a no-op.
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_stop" , "params" : [ ] , "id" : 1 } ' -H "Content-Type: application/json" http:
miner_setGasLimit Private : Requires authentication.
Sets the gas limit the miner will target when mining. Note: on networks where EIP-1559(opens new window) is activated, this should be set to twice what you want the gas target (i.e. the effective gas used on average per block) to be.
Unsupported. This endpoint always returns false
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_start" , "params" : [ "0x10000" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : false }
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_start" , "params" : [ "0x1" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : false }
miner_setEtherbase Private : Requires authentication.
Sets the etherbase. It changes the wallet where the validator rewards will be deposited.
Parameters
Copy
curl -X POST --data '{ "jsonrpc" : "2.0" , "method" : "miner_setEtherbase" , "params" : [ "0x3b7252d007059ffc82d16d022da3cbf9992d2f70" ] , "id" : 1 } ' -H "Content-Type: application/json" http:
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : true }
TxPool Methods txpool_content Returns 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.
Parame (0) Client Examples
Copy
curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_content","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545
Copy
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "txpool_content", "params": []}'
Result
Copy
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : { "pending" : { } , "queued" : { } }
txpool_inspect Returns 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
Copy
curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_inspect","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545
Copy
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "txpool_inspect", "params": []}'
Result
Copy
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : { "pending" : { } , "queued" : { } }
txpool_status Returns 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
Copy
curl -X POST --data '{"jsonrpc":"2.0","method":"txpool_status","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545
Copy
wscat -c ws://localhost:8546 -x '{"jsonrpc": "2.0", "id": 1, "method": "txpool_status", "params": []}'
Result
Copy
{ "jsonrpc" : "2.0" , "id" : 1 , "result" : { "pending" : "0x0" , "queued" : "0x0" } }
