JSON-RPC

To interact with the Hash Ahead blockchain, such as reading blockchain data or sending transaction information to the network, a software application must connect to a Hash Ahead node.

For this purpose, each Hash Ahead client implements a JSON-RPC specification, so there is a unified set of methods available for applications to rely on, regardless of the specific node or client implementation.

JSON-RPCJSON-RPC is a stateless, lightweight remote procedure call (RPC) protocol. It defines some data structures and their processing rules. It is transport-independent as these concepts can be used in the same process, via interfaces, hypertext transfer protocol, or many different messaging environments. It uses JSON (RFC 4627) as the data format.

Although you can choose to interact directly with Hash Ahead clients through the JSON Application Programming Interface (API), there are often easier options for decentralized application developers. Many existing JavaScript and backend API libraries offer wrappers over the JSON-RPC API. With these libraries, developers can conveniently write a single line function to initialize (backend) JSON RPC requests and use them to interact with Hash Ahead.

JSON-RPC application interface methods

web3_clientVersion

Returns the current client version.

return value

String - current client version

示例：

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// Result
{
  "id":67,
  "jsonrpc":"2.0",
  "result": "Mist/v0.9.3/darwin/go1.4.1"
}e

web3_sha3

Returns the Keccak-256 (not standardized SHA3-256) hash of the given data.

return value

DATA - The SHA3 result of a given string.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// Result
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}

net_version

Returns the current network id.

return value

String - current network id.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// Result
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "3"
}

net_listening

Returns true if the client is actively listening for network connections.

return value

Boolean - It returns true if the client is actively listening for network connections, otherwise it returns false.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// Result
{
  "id":67,
  "jsonrpc":"2.0",
  "result":true
}

net_peerCount

Returns the number of peers currently connected to the client.

return value

QUANTITY - This is an integer representing the number of connected peers to the client.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// Result
{
  "id":74,
  "jsonrpc": "2.0",
  "result": "0x2" // 2
}

eth_protocolVersion

Returns the current Hash Ahead protocol version.

return value

String - The current Hash Ahead protocol version.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// Result
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "54"
}

eth_syncing

Returns an object containing data about the sync state or false.

return value

Object|Boolean，object with synchronized state data，or FALSE（when out of sync）：

• startingBlock：QUANTITY - import start block（It will only be reset when the sync reaches the head of the chain）

• currentBlock：QUANTITY - current block, same as eth_blockNumber

• highestBlock：QUANTITY - Estimated Highest Block

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": {
    startingBlock: '0x384',
    currentBlock: '0x386',
    highestBlock: '0x454'
  }
}
// Or when not syncing
{
  "id":1,
  "jsonrpc": "2.0",
  "result": false
}

eth_coinbase

Returns the client coinbase address.

return value

DATA，20 bytes - current coinbase address.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// Result
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_coinbase

Returns the client coinbase address.

return value

DATA，20 bytes - current coinbase address.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// Result
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_mining

Returns true if the client is actively mining new blocks.

return value

Boolean - Returns true if the client is mining, false otherwise.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
//
{
  "id":71,
  "jsonrpc": "2.0",
  "result": true
}

eth_hashrate

Returns the number of hashes per second used by the node for mining.

return value

QUANTITY - hashes per second.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// Result
{
  "id":71,
  "jsonrpc": "2.0",
  "result": "0x38a"
}

eth_gasPrice

Returns the current price per unit of gas in wei.

return value

QUANTITY - The integer representing the current fuel price in wei.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// Result
{
  "id":73,
  "jsonrpc": "2.0",
  "result": "0x1dfd14000" // 8049999872 Wei
}

eth_accounts

Returns a list of addresses owned by the client.

return value

Array of DATA，20 bytes - Address owned by the client.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

eth_getBalance

Return the account balance of the given address.

return value

QUANTITY - An integer representing the current balance in wei.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58" // 158972490234375000
}

eth_blockNumber

Return the number of recent blocks.

return value

QUANTITY - An integer showing the block number of the current area where the client terminal is located.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// Result
{
  "id":83,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}

eth_getStorageAt

Return the value from storage at the given address.

return value

DATA - The value of this storage location.

Example:

To retrieve the value of a storage location, the correct position needs to be calculated based on the storage being retrieved. Consider the following contract deployed at address 0x295a70b2de5e3953354a6a8344e616ed314d7251 with the address 0x391694e7e0b0cce554cb130d723a9d27458f9298.

contract Storage {
    uint pos0;
    mapping(address => uint) pos1;
    function Storage() {
        pos0 = 1234;
        pos1[msg.sender] = 5678;
    }
}

Retrieving the value of 'pos0' is straightforward:

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}

eth_getTransactionCount

Returns the number of transactions sent from a specified address.

return value

QUANTITY - The integer representing the number of transactions sent from the given address.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getBlockTransactionCountByHash

Return the number of transactions in the block matching the given block hash.

return value

QUANTITY - An integer representing the number of transactions in this block.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xb" // 11
}

eth_getBlockTransactionCountByNumber

Returns the number of transactions in the block matching the given block number.

return value

QUANTITY - An integer representing the number of transactions in this block.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0xe8"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa" // 10
}

eth_getUncleCountByBlockHash

Returns the number of uncles in the block from blocks matching the given block hash.

return value

QUANTITY - Integer representing the number of uncle blocks in this block.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getUncleCountByBlockNumber

Returns the number of uncles in the block matching the given block number.

return value

QUANTITY - An integer representing the number of uncle blocks in this block.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getCode

Return the code located at the given address.

return value

DATA - Code from the given address.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x2"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f25b600060078202905091905056"
}

eth_sign

The Sign method calculates the Hash Ahead-specific signature: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).

By adding a prefix to the message, the calculated signature can be identified as a Hash Ahead-specific signature. This prevents malicious decentralized applications from signing arbitrary data (such as transactions) and abusing signatures to impersonate victims.

Note: the address to be signed must be unlocked.

return value

DATA：sign

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_signTransaction

Signs a transaction and returns the signed transaction data, which can then be submitted to the network using ’eth_sendRawTransaction‘.

parameter

1. Object - Trading partners

• from：DATA，20 bytes - the address to send the transaction from.

• to：DATA，20 bytes - (optional when creating a new contract) the address to direct the transaction to.

• gas：QUANTITY -(Optional, default: 90000) Integer representing the gas provided for transaction execution. It will return unused fuel.

• gasPrice：QUANTITY -Optional, default value: to be determined. An integer representing the gas price in Wei to be used for each unit of gas paid.

• value：QUANTITY -(Optionally) An integer representing the value (in Wei) sent with this transaction.

• data：DATA - This is the hash of the compiled code of a contract or the method signature and encoded parameters of a method call.

• nonce：QUANTITY -(Optional）An integer representing the random number. This allows overwriting a pending transaction that uses the same random number.

return value

DATA，Signed transaction object.

Example:

// Request
curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
// Result
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_sendTransaction

If the data field contains code, creates a new message call transaction or a contract creation.

parameter

1. Object - The transaction object

   • from: DATA, 20 Bytes - The address the transaction is sent 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 - (optional) Integer of the value sent with this transaction.

   • data: DATA - The compiled code of a contract OR the hash of the invoked method signature and encoded parameters.

   • nonce: QUANTITY - (optional) Integer of a nonce. This allows to overwrite your own pending transactions that use the same nonce.

params: [
  {
    from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
    to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    gas: "0x76c0", // 30400
    gasPrice: "0x9184e72a000", // 10000000000000
    value: "0x9184e72a", // 2441406250
    data: "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
  },
]

Returns

DATA, 32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available.

Use eth_getTransactionReceipt to get the contract address, after the transaction was mined, when you created a contract.

Example:

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_sendRawTransaction

Creates new message call transaction or a contract creation for signed transactions.

Returns

DATA, 32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available.

Use eth_getTransactionReceipt to get the contract address, after the transaction was mined, when you created a contract.

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

Executes a new message call immediately without creating a transaction on the block chain.

Parameters

1. Object - The transaction call object

• 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 - (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.

• gasPrice: QUANTITY - (optional) Integer of the gasPrice used for each paid gas

• value: QUANTITY - (optional) Integer of the value sent with this transaction

• data: DATA - (optional) Hash of the method signature and encoded parameters.

1. QUANTITY|TAG - integer block number, or the string "latest", "earliest" or "pending"

Returns

DATA - the return value of executed contract.

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x"
}

eth_estimateGas

Generates and returns an estimate of the amount of gas required to allow the transaction to complete. Transactions are not added to the blockchain. Note that estimates may far exceed the actual amount of gas used by a transaction for various reasons, including Ethereum Virtual Machine mechanics and node performance.

return value

QUANTITY - 使用的燃料数量。

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// Result
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}

eth_getBlockByHash

Returns information about a block based on a hash.

return value

Object - block object，or null（when no block is found）：

• number：QUANTITY - block number. null when it is a pending block.

• hash：DATA，32 bytes - hash of the block. It is null when it is a pending block.

• parentHash：DATA，32 bytes - Hash of the parent block.

• nonce：DATA，8 bytes - Hash of generated proof of work. It is null when it is a pending block.

• sha3Uncles：DATA，32 bytes - SHA3 of the uncle data in the block.

• logsBloom：DATA，256 bytes - Bloom filter for the block log. It is null when it is a pending block.

• transactionsRoot：DATA，32 bytes - The root of the block's transaction prefix tree.

• stateRoot：DATA，32 bytes - The root of the block's final state prefix tree.

• receiptsRoot：DATA，32 bytes - Root of block receipt prefix tree.

• miner：DATA，20 bytes - the address of the beneficiary who received the mining reward.

• difficulty：QUANTITY - An integer representing the difficulty of this block.

• totalDifficulty：QUANTITY - An integer representing the total difficulty of the chain up to this block.

• extraData：DATA - "Additional Data" field for this block.

• size：QUANTITY - An integer representing the size of this chunk, in bytes.

• gasLimit：QUANTITY - The maximum allowable fuel value for this block.

• gasUsed：QUANTITY - The total amount of fuel used by all transactions in this block.

• timestamp：QUANTITY - The unix timestamp when the block was collated.

• transactions：Array - An array of transaction objects, or a 32 byte transaction hash, depending on the last given parameter.

• uncles：Array - Tertiary block hash array.

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
// Result
{
{
"jsonrpc": "2.0",
"id": 1,
"result": {
    "difficulty": "0x4ea3f27bc",
    "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
    "gasLimit": "0x1388",
    "gasUsed": "0x0",
    "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
    "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
    "nonce": "0x689056015818adbe",
    "number": "0x1b4",
    "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x220",
    "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
    "timestamp": "0x55ba467c",
    "totalDifficulty": "0x78ed983323d",
    "transactions": [
    ],
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "uncles": [
    ]
}
}

eth_getBlockByNumber

Retrieve information about a block based on its block number.

See return values： eth_getBlockByHash

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'

eth_getTransactionByHash

Returns information about the requested transaction based on the transaction hash.

return values

Object - The transaction object, or null if no transaction was found:

• blockHash：DATA，32 bytes - The hash of the block this transaction is in. It is null when it is a pending block.

• blockNumber：QUANTITY - The block number that this transaction is in. It will be null when it is in the pending state.

• from：DATA，20 bytes - sender's address.

• gas：QUANTITY - The gas provided by the sender.

• gasPrice：QUANTITY - The gas price offered by the sender, in Wei.

• hash：DATA，32 bytes - Hash of the transaction.

• input：DATA - The data sent with the transaction.

• nonce：QUANTITY - The number of transactions the sender made prior to this transaction.

• to：DATA，20 bytes - the address of the recipient. Or null when it is a contract creation transaction.

• transactionIndex：QUANTITY - Integer representing the index position of the transaction in the block. It is null when it is a pending block.

• value：QUANTITY - The value of the transfer, in Wei.

• v：QUANTITY - ECDSA Recovery ID

• r：QUANTITY - ECDSA signature r

• s：QUANTITY - ECDSA signature s

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
// Result
{
  "jsonrpc":"2.0",
  "id":1,
  "result":{
    "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
    "blockNumber":"0x5daf3b", // 6139707
    "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",
    "gas":"0xc350", // 50000
    "gasPrice":"0x4a817c800", // 20000000000
    "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
    "input":"0x68656c6c6f21",
    "nonce":"0x15", // 21
    "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",
    "transactionIndex":"0x41", // 65
    "value":"0xf3dbb76162000", // 4290000000000000
    "v":"0x25", // 37
    "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",
    "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"
  }
}

eth_getTransactionByBlockHashAndIndex

Returns information about a transaction based on the block hash and transaction index position.

See return values： eth_getTransactionByHash

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b", "0x0"],"id":1}'

eth_getTransactionByBlockNumberAndIndex

Returns information about a transaction based on the block number and transaction index position.

See return values eth_getTransactionByHash

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'

eth_getTransactionReceipt

Returns a receipt for a transaction based on the transaction hash.

Note: Receipts are not available for pending transactions.

Return Value Object - The transaction receipt object, or null if no receipt was found:

• transactionHash：DATA，32 bytes - Hash of the transaction.

• transactionIndex：QUANTITY - Integer representing the index position of the transaction in the block.

• blockHash：DATA，32 bytes - The hash of the block this transaction is in.

• blockNumber：QUANTITY - The block number this transaction is in.

• from：DATA，20 bytes - sender's address.

• to：DATA，20 bytes - the address of the recipient. Or null when it is a contract creation transaction.

• cumulativeGasUsed：QUANTITY - The total amount of gas used when executing this transaction in the block.

• gasUsed：QUANTITY - The amount of gas used by this particular transaction only.

• contractAddress：DATA，20 bytes - If the transaction is a contract creation, the created contract address, otherwise null.

• logs：Array - An array of log objects generated by this transaction.

• logsBloom：DATA，256 characters - Bloom filter used by light clients to quickly retrieve related logs. It also returns one of the following:

• root：DATA 32 byte post-transaction stateroot (pre-Byzantine)

• status：QUANTITY - 1（success）或 0（fail）

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}'
// Result
{
"id":1,
"jsonrpc":"2.0",
"result": {
     transactionHash: '0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238',
     transactionIndex:  '0x1', // 1
     blockNumber: '0xb', // 11
     blockHash: '0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b',
     cumulativeGasUsed: '0x33bc', // 13244
     gasUsed: '0x4dc', // 1244
     contractAddress: '0xb60e8dd61c5d32be8058bb8eb970870f07233155', // or null, if none was created
     logs: [{
         // logs as returned by getFilterLogs, etc.
     }, ...],
     logsBloom: "0x00...0", // 256 byte bloom filter
     status: '0x1'
  }
}

eth_getUncleByBlockHashAndIndex

Returns information about the block's uncle based on the hash and uncle index position.

See return values： eth_getBlockByHash

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b", "0x0"],"id":1}'

eth_getUncleByBlockNumberAndIndex

Returns information about a region's uncles based on number and uncle search position.

See return values： eth_getBlockByHash

Note: Uncles do not contain individual transactions.

Example

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'