# EVM API Reference

### Web3 JSON-RPC protocol[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#web3-json-rpc-protocol) <a href="#web3-json-rpc-protocol" id="web3-json-rpc-protocol"></a>

#### eth\_protocolVersion[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_protocolversion) <a href="#eth_protocolversion" id="eth_protocolversion"></a>

Returns the current findora protocol version.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters)

none

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns)

`String` - The current ethereum protocol version

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example)

Request

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_protocolVersion","params":[],"id":1,"jsonrpc":"2.0"}'
```

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "54"
}
```

#### eth\_chainId[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_chainid) <a href="#eth_chainid" id="eth_chainid"></a>

Returns the current findora chain ID

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-1)

none

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-1)

`String` - The current findora chain ID

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-1)

Request

```bash
curl localhost:8545
-X POST
-H "Content-Type: application/json"
--data '{"method":"eth_chainId","params":[],"id":1,"jsonrpc":"2.0"}'
```

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x869" # 2153
}
```

#### eth\_accounts[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_accounts) <a href="#eth_accounts" id="eth_accounts"></a>

Returns a list of addresses owned by client.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-2)

none

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-2)

`Array` - 20 Bytes - addresses owned by the client.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-2)

Request

```bash
curl localhost:8545 \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
```

Response

```bash
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}
```

#### eth\_getBalance[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getbalance) <a href="#eth_getbalance" id="eth_getbalance"></a>

Returns a list of addresses owned by client.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-3)

1. `Address` - 20 Bytes - address to check for balance.
2. `Quantity or Tag` - (optional) Integer block number, or the string 'latest', 'earliest' or 'pending'.

```json
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-3)

`Quantity` - integer of the current balance in wei.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-3)

Request

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBalance","params":["0x8D97689C9818892B700e27F316cc3E41e17fBeb9", "latest"],"id":1,"jsonrpc":"2.0"}'
```

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58"
}
```

#### eth\_sendTransaction[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_sendtransaction) <a href="#eth_sendtransaction" id="eth_sendtransaction"></a>

***

Creates new message call transaction or a contract creation, if the data field contains code.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-4)

1. `Object` - The transaction object
   * `from`: `Address` - 20 Bytes - The address the transaction is send from.
   * `to`: `Address` - (optional) 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 gas price used for each paid gas.
   * `value`: `Quantity` - (optional) Integer of the value sent with this transaction.
   * `data`: `Data` - (optional) 4 byte hash of the method signature followed by 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.
   * `condition`: `Object` - (optional) Conditional submission of the transaction. Can be either an integer block number { block: 1 } or UTC timestamp (in seconds) { time: 1491290692 } or null.

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

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-4)

`Hash` - 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**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-4)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_sendTransaction","params":[{"from":"0xb60e8dd61c5d32be8058bb8eb970870f07233155","to":"0xd46e8dd67c5d32be8058bb8eb970870f07244567","gas":"0x76c0","gasPrice":"0x9184e72a000","value":"0x9184e72a","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"}],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
```

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_call[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_call) <a href="#eth_call" id="eth_call"></a>

***

Creates new message call transaction or a contract creation, if the data field contains code.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-5)

1. `Object` - The transaction call object
   * `from`: `Address` - 20 Bytes - The address the transaction is send from.
   * `to`: `Address` - (optional) 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 gas price used for each paid gas.
   * `value`: `Quantity` - (optional) Integer of the value sent with this transaction.
   * `data`: `Data` - (optional) 4 byte hash of the method signature followed by encoded parameters. For details see Ethereum Contract ABI.
2. `Quantity` or `Tag` - (optional) Integer block number, or the string 'latest', 'earliest' or 'pending'.

{% code overflow="wrap" %}

```json
params: [{
  "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
  "value": "0x186a0" // 100000
}]
```

{% endcode %}

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-5)

`Data` - the return value of executed contract.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-5)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_call","params":[{"from":"0x407d73d8a49eeb85d32cf465507dd71d507100c1","to":"0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b","value":"0x186a0"}],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x"
}
```

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_coinbase[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_coinbase) <a href="#eth_coinbase" id="eth_coinbase"></a>

***

Returns the client coinbase address.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-6)

none

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-6)

`Data` - 20 bytes - the current coinbase address.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-6)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":1}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_gasPrice[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_gasprice) <a href="#eth_gasprice" id="eth_gasprice"></a>

***

Returns the current price per gas in wei.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-7)

none

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-7)

`Quantity` - integer of the current gas price in wei.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-7)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_gasPrice","params":[],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x9184e72a000" // 10000000000000
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_blockNumber[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_blocknumber) <a href="#eth_blocknumber" id="eth_blocknumber"></a>

Returns the number of the most recent block.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-8)

none

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-8)

`Quantity` - integer of the current block number the client is on.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-8)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_blockNumber","params":[],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```bash
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getStorageAt[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getstorageat) <a href="#eth_getstorageat" id="eth_getstorageat"></a>

***

Returns the value from a storage position at a given address.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-9)

1. `Address` - 20 Bytes - address of the storage.
2. `Quantity` - integer of the position in the storage.
3. `Quantity` or `Tag` - (optional) integer block number, or the string 'latest', 'earliest' or 'pending'.

{% code overflow="wrap" %}

```json
params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "0x0", // 0
  "0x2" // 2
]
```

{% endcode %}

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-9)

`Data` - the value at this storage position.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-9)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getStorageAt","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","0x0","0x2"],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x0000000000000000000000000000000000000000000000000000000000000003"
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getBlockByHash[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getblockbyhash) <a href="#eth_getblockbyhash" id="eth_getblockbyhash"></a>

***

Returns information about a block by hash.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-10)

1. `Data` - 32 Bytes - Hash of a block
2. `Boolean` - If true it returns the full transaction objects, if false only the hashes of the transactions.

```json
params: [
   '0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae',
   false
]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-10)

`Object` - A block object, or `null` when no block was found:

* `number`: `QUANTITY` - the block number. null when its pending block.
* `hash`: `DATA`, 32 Bytes - hash of the block. null when its pending block.
* `parentHash`: `DATA`, 32 Bytes - hash of the parent block.
* `nonce`: `DATA`, 8 Bytes - hash of the generated proof-of-work. null when its pending block.
* `sha3Uncles`: `DATA`, 32 Bytes - SHA3 of the uncles data in the block.
* `logsBloom`: `DATA`, 256 Bytes - the bloom filter for the logs of the block. null when its pending block.
* `transactionsRoot`: `DATA`, 32 Bytes - the root of the transaction trie of the block.
* `stateRoot`: `DATA`, 32 Bytes - the root of the final state trie of the block.
* `receiptsRoot`: `DATA`, 32 Bytes - the root of the receipts trie of the block.
* `miner`: `DATA`, 20 Bytes - the address of the beneficiary to whom the mining rewards were given.
* `difficulty`: `QUANTITY` - integer of the difficulty for this block.
* `totalDifficulty`: `QUANTITY` - integer of the total difficulty of the chain until this block.
* `extraData`: `DATA` - the “extra data” field of this block.
* `size`: `QUANTITY` - integer the size of this block in bytes.
* `gasLimit`: `QUANTITY` - the maximum gas allowed in this block.
* `gasUsed`: `QUANTITY` - the total used gas by all transactions in this block.
* `timestamp`: `QUANTITY` - the unix timestamp for when the block was collated.
* `transactions`: `Array` - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.
* `uncles`: `Array` - Array of uncle hashes.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-10)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "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": [
    ]
  }
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getBlockByNumber[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getblockbynumber) <a href="#eth_getblockbynumber" id="eth_getblockbynumber"></a>

***

Returns information about a block by hash.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-11)

1. `Quantity` or `Tag` - integer of a block number, or the string 'earliest', 'latest' or 'pending'.
2. `Boolean` - If true it returns the full transaction objects, if false only the hashes of the transactions.

```json
params: [
  "0x1b4", // 436
  true
]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-11)

`Object` - A block object, or `null` when no block was found:

* `number`: `QUANTITY` - the block number. null when its pending block.
* `hash`: `DATA`, 32 Bytes - hash of the block. null when its pending block.
* `parentHash`: `DATA`, 32 Bytes - hash of the parent block.
* `author`: `Address` - 20 Bytes - alias of 'author'
* `miner`: `DATA`, 20 Bytes - the address of the beneficiary to whom the mining rewards were given.
* `gasLimit`: `QUANTITY` - the maximum gas allowed in this block.
* `gasUsed`: `QUANTITY` - the total used gas by all transactions in this block.
* `timestamp`: `QUANTITY` - the unix timestamp for when the block was collated.
* `transactions`: `Array` - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-11)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockByNumber","params":["0x1b4",true],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "number": "0x1b4", // 436
    "hash": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
    "parentHash": "0x9646252be9520f6e71339a8df9c55e4d7619deeb018d2a3f2d21fc165dde5eb5",
    "sealFields": [
      "0xe04d296d2460cfb8472af2c5fd05b5a214109c25688d3704aed5484f9a7792f2",
      "0x0000000000000042"
    ],
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
    "miner": "0x4e65fda2159562a496f9f3522f89122a3088497a",
    "difficulty": "0x27f07", // 163591
    "totalDifficulty": "0x27f07", // 163591
    "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "size": "0x27f07", // 163591
    "gasLimit": "0x9f759", // 653145
    "minGasPrice": "0x9f759", // 653145
    "gasUsed": "0x9f759", // 653145
    "timestamp": "0x54e34e8e", // 1424182926
    "transactions": [{ ... }, { ... }, ...],
    "uncles": [
      "0x1606e5...",
      "0xd5145a9..."
    ]
  }
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getTransactionCount[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_gettransactioncount) <a href="#eth_gettransactioncount" id="eth_gettransactioncount"></a>

***

Returns the number of transactions sent from an address.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-12)

1. `Address` - 20 Bytes - address
2. `Quantity` or `Tag` - (optional) integer block number, or the string 'latest', 'earliest' or 'pending'.

```json
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-12)

`Quantity` - integer of the number of transactions send from this address.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-12)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1"],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}
```

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getBlockTransactionCountByHash[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getblocktransactioncountbyhash) <a href="#eth_getblocktransactioncountbyhash" id="eth_getblocktransactioncountbyhash"></a>

***

Returns the number of transactions in a block from a block matching the given block hash.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-13)

1. `Hash` - 32 Bytes - hash of a block

```json
params: ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-13)

`Quantity` - integer of the number of transactions in this block.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-13)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockTransactionCountByHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xb" // 11
}
```

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getBlockTransactionCountByNumber[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getblocktransactioncountbynumber) <a href="#eth_getblocktransactioncountbynumber" id="eth_getblocktransactioncountbynumber"></a>

***

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

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-14)

1. `Quantity` or `Tag` - (optional) integer block number, or the string 'latest', 'earliest' or 'pending'.

```json
params: [   '0xe8', // 232]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-14)

`Quantity` - integer of the number of transactions in this block.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-14)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0xe8"],"id":1}'
```

{% endcode %}

Response

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xa" // 10
}
```

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getCode[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getcode) <a href="#eth_getcode" id="eth_getcode"></a>

***

Returns code at a given address

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-15)

1. `Address` - 20 bytes - address
2. `Quantity` or `Tag` - (optional) integer block number, or the string 'latest', 'earliest' or 'pending'.

```json
params: [
   '0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b',
   '0x2'  // 2
]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-15)

`Data` - the code from the given address.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-15)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x2"],"id":1}
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f25b600060078202905091905056"
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_sendRawTransaction[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_sendrawtransaction) <a href="#eth_sendrawtransaction" id="eth_sendrawtransaction"></a>

***

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

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-16)

1. `Data` - The signed transaction data.

```
params: ["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-16)

`Hash` - 32 bytes - the transaction hash, or the zero hash if the transaction is not yet available.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-16)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_sendRawTransaction","params":["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_estimateGas[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_estimategas) <a href="#eth_estimategas" id="eth_estimategas"></a>

***

Makes a call or transaction, which won't be added to the blockchain and returns the used gas, which can be used for estimating the used gas.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-17)

1. `Object` - Same as eth\_call parameters, except that all properties are optional.
   * `from`: `Address` - (optional) 20 Bytes - The address the transaction is send from.
   * `to`: `Address` - (optional when creating new contract) 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 gas price used for each paid gas.
   * `value`: `Quantity` - (optional) Integer of the value sent with this transaction.
   * `data`: `Data` - (optional) 4 byte hash of the method signature followed by encoded parameters. For details see Ethereum Contract ABI.
2. `Quantity` or `Tag` - (optional) Integer block number, or the string 'latest', 'earliest' or 'pending', see the default block parameter.

{% code overflow="wrap" %}

```json
params: ["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"]
```

{% endcode %}

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-17)

`Quantity` - The amount of gas used.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-17)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_estimateGas","params":[{ ... }],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getTransactionByHash[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_gettransactionbyhash) <a href="#eth_gettransactionbyhash" id="eth_gettransactionbyhash"></a>

***

Returns the information about a transaction requested by transaction hash.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-18)

1. `Hash` - 32 Bytes - hash of a transaction.

{% code overflow="wrap" %}

```json
params: ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"]
```

{% endcode %}

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-18)

1. `Object` - A transaction object, or null when no transaction was found:
   * `hash`: Hash - 32 Bytes - hash of the transaction.
   * `nonce`: `Quantity` - the number of transactions made by the sender prior to this one.
   * `blockHash`: `Hash` - 32 Bytes - hash of the block where this transaction was in. null when its pending.
   * `blockNumber`: `Quantity` or Tag - block number where this transaction was in. null when its pending.
   * `transactionIndex`: `Quantity` - integer of the transactions index position in the block. null when its pending.
   * `from`: `Address` - 20 Bytes - address of the sender.
   * `to`: `Address` - 20 Bytes - address of the receiver. null when its a contract creation transaction.
   * `value`: `Quantity` - value transferred in Wei.
   * `gasPrice`: `Quantity` - gas price provided by the sender in Wei.
   * `gas`: `Quantity` - gas provided by the sender.
   * `input`: `Data` - the data send along with the transaction.
   * `v`: `Quantity` - the standardised V field of the signature.
   * `standardV`: `Quantity` - the standardised V field of the signature (0 or 1).
   * `r`: `Quantity` - the R field of the signature.
   * `raw`: `Data` - raw transaction data
   * `publicKey`: `Hash` - public key of the signer.
   * `chainId`: `Quantity` - the chain id of the transaction, if any.
   * `creates`: `Hash` - creates contract hash
   * `condition`: `Object` - (optional) conditional submission, Block number in block or timestamp in time or null.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-18)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionByHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "hash": "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
    "nonce": "0x0", // 0
    "blockHash": "0xbeab0aa2411b7ab17f30a99d3cb9c6ef2fc5426d6ad6fd9e2a26a6aed1d1055b",
    "blockNumber": "0x15df", // 5599
    "transactionIndex": "0x1", // 1
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0x853f43d8a49eeb85d32cf465507dd71d507100c1",
    "value": "0x7f110", // 520464
    "gas": "0x7f110", // 520464
    "gasPrice": "0x09184e72a000",
    "input": "0x603880600c6000396000f300603880600c6000396000f3603880600c6000396000f360"
  }
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getTransactionByBlockHashAndIndex[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_gettransactionbyblockhashandindex) <a href="#eth_gettransactionbyblockhashandindex" id="eth_gettransactionbyblockhashandindex"></a>

***

Returns information about a transaction by block hash and transaction index position.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-19)

1. `Data` - 32 bytes - hash of a block
2. `Quantity` - integer of the transaction index position

```json
params: [
   '0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331',
   '0x0' // 0
]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-19)

See [eth\_getTransactionByHash](#eth_gettransactionbyhash)

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-19)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b", "0x0"],"id":1}'
```

{% endcode %}

Response See [eth\_getTransactionByHash](#eth_gettransactionbyhash)

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getTransactionByBlockNumberAndIndex[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_gettransactionbyblocknumberandindex) <a href="#eth_gettransactionbyblocknumberandindex" id="eth_gettransactionbyblocknumberandindex"></a>

***

Returns information about a transaction by block number and transaction index position.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-20)

1. `Quantity` or `Tag` - a block number, or the string "earliest", "latest" or "pending".
2. `Quantity` - integer of the transaction index position

{% code overflow="wrap" %}

```json
params: [
   '0x29c', // 668
   '0x0' // 0
]
```

{% endcode %}

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-20)

See [eth\_getTransactionByHash](#eth_gettransactionbyhash)

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-20)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'
```

{% endcode %}

Response See [eth\_getTransactionByHash](#eth_gettransactionbyhash)

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getTransactionReceipt[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_gettransactionreceipt) <a href="#eth_gettransactionreceipt" id="eth_gettransactionreceipt"></a>

***

Returns the receipt of a transaction by transaction hash.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-21)

1. `Hash` - hash of a transaction.

```
params: ["0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"]
```

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-21)

1. `Object` - A transaction receipt object, or `null` when no receipt was found:
   * `blockHash`: `Hash` - 32 Bytes - hash of the block where this transaction was in.
   * `blockNumber`: `Quantity` or Tag - block number where this transaction was in.
   * `contractAddress`: `Address` - 20 Bytes - The contract address created, if the transaction was a contract creation, otherwise null.
   * `cumulativeGasUsed`: `Quantity` - The total amount of gas used when this transaction was executed in the block.
   * `from`: `Address` - 20 Bytes - The address of the sender.
   * `to`: `Address` - 20 Bytes - The address of the receiver. null when it’s a contract creation transaction.
   * `gasUsed`: `Quantity` - The amount of gas used by this specific transaction alone.
   * `logs`: `Array` - Array of log objects, which this transaction generated.
   * `logsBloom`: `Hash` - 256 Bytes - A bloom filter of logs/events generated by contracts during transaction execution. Used to efficiently rule out transactions without expected logs.
   * `root`: `Hash` - 32 Bytes - Merkle root of the state trie after the transaction has been executed (optional after Byzantium hard fork EIP609)
   * `status`: `Quantity` - 0x0 indicates transaction failure , 0x1 indicates transaction success. Set for blocks mined after Byzantium hard fork EIP609, null before.
   * `transactionHash`: `Hash` - 32 Bytes - hash of the transaction.
   * `transactionIndex`: `Quantity` - Integer of the transactions index position in the block.

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-21)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getTransactionReceipt","params":["0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374"],"id":1,"jsonrpc":"2.0"}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "blockHash": "0x67c0303244ae4beeec329e0c66198e8db8938a94d15a366c7514626528abfc8c",
    "blockNumber": "0x6914b0",
    "contractAddress": "0x471a8bf3fd0dfbe20658a97155388cec674190bf", // or null, if none was created
    "from": "0xc931d93e97ab07fe42d923478ba2465f2",
    "to": null, // value is null because this example transaction is a contract creation
    "cumulativeGasUsed": "0x158e33",
    "gasUsed": "0xba2e6",
    "logs": [], // logs as returned by eth_getFilterLogs, etc.
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "root": null,
    "status": "0x1",
    "transactionHash": "0x444172bef57ad978655171a8af2cfd89baa02a97fcb773067aef7794d6913374",
    "transactionIndex": "0x4"
  }
}
```

{% endcode %}

[back to top](https://docs.findora.org/developers/evm-references/evm-api-reference)

#### eth\_getLogs[​](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#eth_getlogs) <a href="#eth_getlogs" id="eth_getlogs"></a>

***

Returns an array of all logs matching a given filter object.

**Parameters**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#parameters-22)

1. `Object` - The filter options:
   * `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`: `DATA`, 32 Bytes - (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.

{% code overflow="wrap" %}

```json
params: [{
  "topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]
}]
```

{% endcode %}

**Returns**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#returns-22)

`Array` - Array of log objects, or an empty array if nothing has changed since last poll.

* For filters created with `eth_newBlockFilter` the return are block hashes (`DATA`, 32 Bytes), e.g. \["0x3454645634534..."].
* For filters created with `eth_newPendingTransactionFilter` the return are transaction hashes (`DATA`, 32 Bytes), e.g. \["0x6345343454645..."].
* For filters created with `eth_newFilter` logs are objects with following params:
  * `removed`: `TAG` - true when the log was removed, due to a chain reorganization. false if its a valid log.
  * `logIndex`: `QUANTITY` - integer of the log index position in the block. null when its pending log.
  * `transactionIndex`: `QUANTITY` - integer of the transactions index position log was created from. null when its pending log.
  * `transactionHash`: `DATA`, 32 Bytes - hash of the transactions this log was created from. null when its pending log.
  * `blockHash`: `DATA`, 32 Bytes - hash of the block where this log was in. null when its pending. null when its pending log.
  * `blockNumber`: `QUANTITY` - the block number where this log was in. null when its pending. null when its pending log.
  * `address`: `DATA`, 20 Bytes - address from which this log originated.
  * `data`: `DATA` - contains one or more 32 Bytes non-indexed arguments of the log.
  * `topics`: `Array` of `DATA` - Array of 0 to 4 32 Bytes DATA of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier.)

**Example**[**​**](https://wiki.findora.org/docs/developers/evm_smart_chain/web3#example-22)

Request

{% code overflow="wrap" %}

```bash
curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":1}'
```

{% endcode %}

Response

{% code overflow="wrap" %}

```json
{
  "id":1,
  "jsonrpc":"2.0",
  "result": [{
    "logIndex": "0x1", // 1
    "blockNumber":"0x1b4", // 436
    "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
    "transactionHash":  "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
    "transactionIndex": "0x0", // 0
    "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
    "data":"0x0000000000000000000000000000000000000000000000000000000000000000",
    "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]
    },{
      ...
    }]
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.findora.org/developers/evm-references/evm-api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.