> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monad.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# JSON-RPC API 参考

> Monad JSON-RPC 接口参考

## eth\_blockNumber

返回最新区块的编号。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_blockNumber)

**参数**

该方法不接受任何参数。

**返回值**

**result** `string`

当前区块号,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4b7"
}
```

## eth\_call

立即执行一次新的消息调用,不会在区块链上创建交易。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_call)

**参数**

**transaction** `object` *required*

交易调用对象。

**properties**

**from** `string`

**to** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**value** `string`

**input** `string`

**data** `string`

**nonce** `string`

**chainId** `string`

**accessList** `string`

**authorizationList** `string`

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `string`

已执行合约调用的返回数据,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    },
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_chainId

返回当前网络的链 ID。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_chainId)

**参数**

该方法不接受任何参数。

**返回值**

**result** `string`

链 ID,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4b7"
}
```

## eth\_createAccessList

返回模拟交易得到的访问列表和使用的 gas。

执行失败和回滚在结果对象的可选
`error` 字段中报告,以便调用者仍可使用生成的访问列表。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_createAccessList)

**参数**

**transaction** `object` *required*

交易调用对象。

**properties**

**from** `string`

**to** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**value** `string`

**input** `string`

**data** `string`

**nonce** `string`

**chainId** `string`

**accessList** `string`

**authorizationList** `string`

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `object`

访问列表和估算使用的 gas。

**properties**

**accessList** `array`

**gasUsed** `string`

**error** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_createAccessList",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    },
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_estimateGas

生成并返回完成该交易所需的 gas 估算值。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_estimateGas)

**参数**

**tx** `object` *required*

交易调用对象。

**properties**

**from** `string`

**to** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**value** `string`

**input** `string`

**data** `string`

**nonce** `string`

**chainId** `string`

**accessList** `string`

**authorizationList** `string`

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `string`

估算所需的 gas,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    },
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4b7"
}
```

## eth\_feeHistory

交易手续费历史
返回所请求/支持的区块范围内每 gas 的基础手续费和有效优先费。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_feeHistory)

**参数**

**block\_count** `string` *required*

所请求范围内的区块数量(十六进制编码整数)。

**newest\_block** `string` *required*

最高区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**reward\_percentiles** `array` *required*

用于对有效优先费采样的百分位数值数组(0 到 100 之间的浮点数)。可以为 `null`。

**返回值**

**result** `object`

请求的区块范围的手续费历史。

**properties**

**gasUsedRatio** `array`

**oldestBlock** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x1",
    "latest",
    [
      25,
      75
    ]
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "gasUsedRatio": [],
    "oldestBlock": "0x0"
  }
}
```

## eth\_fillTransaction

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_fillTransaction)

**参数**

**tx** `object` *required*

交易调用对象。

**properties**

**from** `string`

**to** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**value** `string`

**input** `string`

**data** `string`

**nonce** `string`

**chainId** `string`

**accessList** `string`

**authorizationList** `string`

**返回值**

**result** `object`

**properties**

**raw** `string`

**tx** `object`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_fillTransaction",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    }
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "raw": "0x",
    "tx": {
      "from": null,
      "to": null,
      "gas": null,
      "maxFeePerGas": null,
      "maxPriorityFeePerGas": null,
      "value": null,
      "input": null,
      "data": null,
      "nonce": null,
      "chainId": null,
      "accessList": null,
      "authorizationList": null
    }
  }
}
```

## eth\_gasPrice

返回当前每 gas 的价格(单位:wei)。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_gasPrice)

**参数**

该方法不接受任何参数。

**返回值**

**result** `string`

当前 gas 价格(单位:wei),十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_gasPrice",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4b7"
}
```

## eth\_getBalance

返回给定地址账户的余额。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getBalance)

**参数**

**account** `string` *required*

20 字节账户地址(十六进制编码)。

**block\_number** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `string`

账户余额(单位:wei),十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_getBlockByHash

按哈希返回区块信息。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getBlockByHash)

**参数**

**block\_hash** `string` *required*

32 字节区块哈希(十六进制编码)。

**return\_full\_txns** `boolean` *required*

如果为 `true`,返回完整交易对象;如果为 `false`,只返回交易哈希。

**返回值**

**result** `object`

区块对象,如未找到则返回 `null`。

**properties**

**hash** `string`

**parentHash** `string`

**sha3Uncles** `string`

**miner** `string`

**stateRoot** `string`

**transactionsRoot** `string`

**receiptsRoot** `string`

**logsBloom** `string`

**difficulty** `string`

**number** `string`

**gasLimit** `string`

**gasUsed** `string`

**timestamp** `string`

**extraData** `string`

**mixHash** `string`

**nonce** `string`

**uncles** `array`

**transactions** `array`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    false
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0x0000000000000000000000000000000000000000",
    "stateRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "logsBloom": "0x00000000...",
    "difficulty": "0x0",
    "number": "0x0",
    "gasLimit": "0x0",
    "gasUsed": "0x0",
    "timestamp": "0x0",
    "extraData": "0x",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "nonce": "0x0000000000000000",
    "uncles": [],
    "transactions": []
  }
}
```

## eth\_getBlockByNumber

按编号返回区块信息。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getBlockByNumber)

**参数**

**block\_number** `string` *required*

区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**return\_full\_txns** `boolean` *required*

如果为 `true`,返回完整交易对象;如果为 `false`,只返回交易哈希。

**返回值**

**result** `object`

区块对象,如未找到则返回 `null`。

**properties**

**hash** `string`

**parentHash** `string`

**sha3Uncles** `string`

**miner** `string`

**stateRoot** `string`

**transactionsRoot** `string`

**receiptsRoot** `string`

**logsBloom** `string`

**difficulty** `string`

**number** `string`

**gasLimit** `string`

**gasUsed** `string`

**timestamp** `string`

**extraData** `string`

**mixHash** `string`

**nonce** `string`

**uncles** `array`

**transactions** `array`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "latest",
    false
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0x0000000000000000000000000000000000000000",
    "stateRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "logsBloom": "0x00000000...",
    "difficulty": "0x0",
    "number": "0x0",
    "gasLimit": "0x0",
    "gasUsed": "0x0",
    "timestamp": "0x0",
    "extraData": "0x",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "nonce": "0x0000000000000000",
    "uncles": [],
    "transactions": []
  }
}
```

## eth\_getBlockReceipts

按编号或哈希返回区块的回执列表。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getBlockReceipts)

**参数**

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `array`

区块中交易回执对象的数组。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getBlockReceipts",
  "params": [
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x..."
  ]
}
```

## eth\_getBlockTransactionCountByHash

返回与给定区块哈希匹配的区块中的交易数量。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getBlockTransactionCountByHash)

**参数**

**block\_hash** `string` *required*

32 字节区块哈希(十六进制编码)。

**返回值**

**result** `string`

区块中的交易数,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_getBlockTransactionCountByNumber

返回与给定区块编号匹配的区块中的交易数量。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getBlockTransactionCountByNumber)

**参数**

**block\_tag** `string` *required*

区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**返回值**

**result** `string`

区块中的交易数,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_getCode

返回给定地址处的代码。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getCode)

**参数**

**account** `string` *required*

20 字节账户地址(十六进制编码)。

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `string`

给定地址处的字节码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_getLogs

返回与给定 ID 的过滤器匹配的所有日志数组。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getLogs)

**参数**

**filters** `object` *required*

日志过滤器对象。

**properties**

**fromBlock** `string`

**toBlock** `string`

**address** `string`

**topics** `array`

**返回值**

**result** `array`

匹配过滤器的日志对象数组。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x0",
      "toBlock": "0x1",
      "address": "0xac4b3dacb91461209ae9d41ec517c2b9cb1b7daf",
      "topics": []
    }
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x..."
  ]
}
```

## eth\_getStorageAt

返回给定地址某个存储位置的值。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getStorageAt)

**参数**

**account** `string` *required*

20 字节账户地址(十六进制编码)。

**position** `string` *required*

存储位置(十六进制编码 256 位整数)。

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `string`

给定存储位置的值,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "0x0",
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_getTransactionByBlockHashAndIndex

按区块哈希和交易索引位置返回交易信息。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getTransactionByBlockHashAndIndex)

**参数**

**block\_hash** `string` *required*

32 字节区块哈希(十六进制编码)。

**index** `string` *required*

交易索引位置(十六进制编码整数)。

**返回值**

**result** `object`

交易对象,如未找到则返回 `null`。

**properties**

**type** `string`

**chainId** `string`

**nonce** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**to** `string`

**value** `string`

**accessList** `array`

**input** `string`

**r** `string`

**s** `string`

**yParity** `string`

**v** `string`

**hash** `string`

**blockHash** `string`

**blockNumber** `string`

**transactionIndex** `string`

**from** `string`

**gasPrice** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockHashAndIndex",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    "0x1"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "type": "0x2",
    "chainId": "0x1",
    "nonce": "0x16d",
    "gas": "0x46a02",
    "maxFeePerGas": "0x7fc1a20a8",
    "maxPriorityFeePerGas": "0x59682f00",
    "to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
    "value": "0x4a6ed55bbcc180",
    "accessList": [],
    "input": "0x5ae401dc...",
    "r": "0x7f2153019a74025d83a73effdd91503ceecefac7e35dd933adc1901c875539aa",
    "s": "0x334ab2f714796d13c825fddf12aad01438db3a8152b2fe3ef7827707c25ecab3",
    "yParity": "0x0",
    "v": "0x0",
    "hash": "0x0e07d8b53ed3d91314c80e53cf25bcde02084939395845cbb625b029d568135c",
    "blockHash": "0x883f974b17ca7b28cb970798d1c80f4d4bb427473dc6d39b2a7fe24edc02902d",
    "blockNumber": "0xe26e6d",
    "transactionIndex": "0xad",
    "from": "0x3cf412d970474804623bb4e3a42de13f9bca5436",
    "gasPrice": "0x50101df3a"
  }
}
```

## eth\_getTransactionByBlockNumberAndIndex

按区块编号和交易索引位置返回交易信息。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getTransactionByBlockNumberAndIndex)

**参数**

**block\_tag** `string` *required*

区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**index** `string` *required*

交易索引位置(十六进制编码整数)。

**返回值**

**result** `object`

交易对象,如未找到则返回 `null`。

**properties**

**type** `string`

**chainId** `string`

**nonce** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**to** `string`

**value** `string`

**accessList** `array`

**input** `string`

**r** `string`

**s** `string`

**yParity** `string`

**v** `string`

**hash** `string`

**blockHash** `string`

**blockNumber** `string`

**transactionIndex** `string`

**from** `string`

**gasPrice** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockNumberAndIndex",
  "params": [
    "latest",
    "0x1"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "type": "0x2",
    "chainId": "0x1",
    "nonce": "0x16d",
    "gas": "0x46a02",
    "maxFeePerGas": "0x7fc1a20a8",
    "maxPriorityFeePerGas": "0x59682f00",
    "to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
    "value": "0x4a6ed55bbcc180",
    "accessList": [],
    "input": "0x5ae401dc...",
    "r": "0x7f2153019a74025d83a73effdd91503ceecefac7e35dd933adc1901c875539aa",
    "s": "0x334ab2f714796d13c825fddf12aad01438db3a8152b2fe3ef7827707c25ecab3",
    "yParity": "0x0",
    "v": "0x0",
    "hash": "0x0e07d8b53ed3d91314c80e53cf25bcde02084939395845cbb625b029d568135c",
    "blockHash": "0x883f974b17ca7b28cb970798d1c80f4d4bb427473dc6d39b2a7fe24edc02902d",
    "blockNumber": "0xe26e6d",
    "transactionIndex": "0xad",
    "from": "0x3cf412d970474804623bb4e3a42de13f9bca5436",
    "gasPrice": "0x50101df3a"
  }
}
```

## eth\_getTransactionByHash

按交易哈希返回请求的交易信息。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getTransactionByHash)

**参数**

**tx\_hash** `string` *required*

32 字节交易哈希(十六进制编码)。

**返回值**

**result** `object`

交易对象,如未找到则返回 `null`。

**properties**

**type** `string`

**chainId** `string`

**nonce** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**to** `string`

**value** `string`

**accessList** `array`

**input** `string`

**r** `string`

**s** `string`

**yParity** `string`

**v** `string`

**hash** `string`

**blockHash** `string`

**blockNumber** `string`

**transactionIndex** `string`

**from** `string`

**gasPrice** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "type": "0x2",
    "chainId": "0x1",
    "nonce": "0x16d",
    "gas": "0x46a02",
    "maxFeePerGas": "0x7fc1a20a8",
    "maxPriorityFeePerGas": "0x59682f00",
    "to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
    "value": "0x4a6ed55bbcc180",
    "accessList": [],
    "input": "0x5ae401dc...",
    "r": "0x7f2153019a74025d83a73effdd91503ceecefac7e35dd933adc1901c875539aa",
    "s": "0x334ab2f714796d13c825fddf12aad01438db3a8152b2fe3ef7827707c25ecab3",
    "yParity": "0x0",
    "v": "0x0",
    "hash": "0x0e07d8b53ed3d91314c80e53cf25bcde02084939395845cbb625b029d568135c",
    "blockHash": "0x883f974b17ca7b28cb970798d1c80f4d4bb427473dc6d39b2a7fe24edc02902d",
    "blockNumber": "0xe26e6d",
    "transactionIndex": "0xad",
    "from": "0x3cf412d970474804623bb4e3a42de13f9bca5436",
    "gasPrice": "0x50101df3a"
  }
}
```

## eth\_getTransactionCount

返回从某地址发送的交易数量。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getTransactionCount)

**参数**

**account** `string` *required*

20 字节账户地址(十六进制编码)。

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**返回值**

**result** `string`

从该地址发送的交易数,十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_getTransactionReceipt

按交易哈希返回交易回执。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_getTransactionReceipt)

**参数**

**tx\_hash** `string` *required*

32 字节交易哈希(十六进制编码)。

**返回值**

**result** `object`

交易回执对象,如未找到则返回 `null`。

**properties**

**type** `string`

**status** `string`

**cumulativeGasUsed** `string`

**logs** `array`

**logsBloom** `string`

**transactionHash** `string`

**transactionIndex** `string`

**blockHash** `string`

**blockNumber** `string`

**gasUsed** `string`

**effectiveGasPrice** `string`

**from** `string`

**to** `string`

**contractAddress** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "type": "0x2",
    "status": "0x1",
    "cumulativeGasUsed": "0xa42aec",
    "logs": [
      {
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "topics": [
          "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
        ],
        "data": "0x00000000000000000000000000000000000000000052b7d2dcc80cd2e4000000",
        "blockHash": "0x4acbdefb861ef4adedb135ca52865f6743451bfbfa35db78076f881a40401a5e",
        "blockNumber": "0x129f4b9",
        "transactionHash": "0x21f6554c28453a01e7276c1db2fc1695bb512b170818bfa98fa8136433100616",
        "transactionIndex": "0x7f",
        "logIndex": "0x118",
        "removed": false
      }
    ],
    "logsBloom": "0x00000000...",
    "transactionHash": "0x21f6554c28453a01e7276c1db2fc1695bb512b170818bfa98fa8136433100616",
    "transactionIndex": "0x7f",
    "blockHash": "0x4acbdefb861ef4adedb135ca52865f6743451bfbfa35db78076f881a40401a5e",
    "blockNumber": "0x129f4b9",
    "gasUsed": "0xbde1",
    "effectiveGasPrice": "0xfb0f6e8c9",
    "from": "0x9a53bfba35269414f3b2d20b52ca01b15932c7b2",
    "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "contractAddress": null
  }
}
```

## eth\_maxPriorityFeePerGas

返回当前每 gas 的 maxPriorityFeePerGas(单位:wei)。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_maxPriorityFeePerGas)

**参数**

该方法不接受任何参数。

**返回值**

**result** `string`

当前每 gas 的最大优先费(单位:wei),十六进制编码。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_maxPriorityFeePerGas",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4b7"
}
```

## eth\_sendRawTransaction

提交原始交易。对于 EIP-4844 交易,原始形式必须为网络形式。
这意味着它包含 blobs、KZG 承诺和 KZG 证明。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_sendRawTransaction)

**参数**

**hex\_tx** `string` *required*

已签名的交易数据(十六进制编码)。

**返回值**

**result** `string`

32 字节交易哈希。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0x..."
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## eth\_sendRawTransactionSync

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_sendRawTransactionSync)

**参数**

**hex\_tx** `string` *required*

已签名的交易数据(十六进制编码)。

**timeout\_ms** `integer` *required*

**返回值**

**result** `object`

**properties**

**type** `string`

**status** `string`

**cumulativeGasUsed** `string`

**logs** `array`

**logsBloom** `string`

**transactionHash** `string`

**transactionIndex** `string`

**blockHash** `string`

**blockNumber** `string`

**gasUsed** `string`

**effectiveGasPrice** `string`

**from** `string`

**to** `string`

**contractAddress** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransactionSync",
  "params": [
    "0x...",
    "0x..."
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "type": "0x2",
    "status": "0x1",
    "cumulativeGasUsed": "0xa42aec",
    "logs": [
      {
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "topics": [
          "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
        ],
        "data": "0x00000000000000000000000000000000000000000052b7d2dcc80cd2e4000000",
        "blockHash": "0x4acbdefb861ef4adedb135ca52865f6743451bfbfa35db78076f881a40401a5e",
        "blockNumber": "0x129f4b9",
        "transactionHash": "0x21f6554c28453a01e7276c1db2fc1695bb512b170818bfa98fa8136433100616",
        "transactionIndex": "0x7f",
        "logIndex": "0x118",
        "removed": false
      }
    ],
    "logsBloom": "0x00000000...",
    "transactionHash": "0x21f6554c28453a01e7276c1db2fc1695bb512b170818bfa98fa8136433100616",
    "transactionIndex": "0x7f",
    "blockHash": "0x4acbdefb861ef4adedb135ca52865f6743451bfbfa35db78076f881a40401a5e",
    "blockNumber": "0x129f4b9",
    "gasUsed": "0xbde1",
    "effectiveGasPrice": "0xfb0f6e8c9",
    "from": "0x9a53bfba35269414f3b2d20b52ca01b15932c7b2",
    "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "contractAddress": null
  }
}
```

## eth\_syncing

返回一个包含同步状态数据的对象,或者返回 false。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=eth_syncing)

**参数**

该方法不接受任何参数。

**返回值**

**result** `boolean`

如果未在同步则为 `false`,否则返回包含同步状态数据的对象。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "eth_syncing",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false
}
```

## debug\_getRawBlock

返回 RLP 编码的区块。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_getRawBlock)

**参数**

**block** `string` *required*

区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**返回值**

**result** `string`

RLP 编码的区块数据。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_getRawBlock",
  "params": [
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## debug\_getRawHeader

返回 RLP 编码的区块头。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_getRawHeader)

**参数**

**block** `string` *required*

区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**返回值**

**result** `string`

RLP 编码的区块头数据。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_getRawHeader",
  "params": [
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## debug\_getRawReceipts

返回 EIP-2718 二进制编码回执的数组。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_getRawReceipts)

**参数**

**block** `string` *required*

区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**返回值**

**result** `array`

EIP-2718 二进制编码的回执数组。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_getRawReceipts",
  "params": [
    "latest"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x..."
  ]
}
```

## debug\_getRawTransaction

返回 EIP-2718 二进制编码交易的数组。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_getRawTransaction)

**参数**

**tx\_hash** `string` *required*

32 字节交易哈希(十六进制编码)。

**返回值**

**result** `string`

EIP-2718 二进制编码的交易。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_getRawTransaction",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## debug\_traceBlockByHash

通过 tracer 执行由区块哈希指定的区块中的所有交易并返回跟踪结果。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_traceBlockByHash)

**参数**

**block\_hash** `string` *required*

32 字节区块哈希(十六进制编码)。

**tracer** `object` *required*

Tracer 配置对象。

**properties**

**tracer** `string`

Tracer 类型:`callTracer` 或 `prestateTracer`。

**tracerConfig** `object`

**properties**

**onlyTopCall** `boolean`

callTracer 的 onlyTopCall 选项,对 prestateTracer 忽略

**diffMode** `boolean`

prestateTracer 的 diff 模式,对 callTracer 忽略

**withLog** `boolean`

callTracer 的日志选项,对 prestateTracer 忽略

**返回值**

**result** `object`

跟踪结果对象数组,每笔交易一个。

**properties**

**txHash** `string`

**result** `object`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## debug\_traceBlockByNumber

通过 tracer 执行由区块编号指定的区块中的所有交易并返回跟踪结果。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_traceBlockByNumber)

**参数**

**block\_number** `string` *required*

区块号(十六进制)或标签:`latest`、`safe`、`finalized`、`pending`。

**tracer** `object` *required*

Tracer 配置对象。

**properties**

**tracer** `string`

Tracer 类型:`callTracer` 或 `prestateTracer`。

**tracerConfig** `object`

**properties**

**onlyTopCall** `boolean`

callTracer 的 onlyTopCall 选项,对 prestateTracer 忽略

**diffMode** `boolean`

prestateTracer 的 diff 模式,对 callTracer 忽略

**withLog** `boolean`

callTracer 的日志选项,对 prestateTracer 忽略

**返回值**

**result** `object`

跟踪结果对象数组,每笔交易一个。

**properties**

**txHash** `string`

**result** `object`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "params": [
    "latest",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## debug\_traceCall

通过执行一次 eth call 返回跟踪结果。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_traceCall)

**参数**

**transaction** `object` *required*

交易调用对象。

**properties**

**from** `string`

**to** `string`

**gas** `string`

**maxFeePerGas** `string`

**maxPriorityFeePerGas** `string`

**value** `string`

**input** `string`

**data** `string`

**nonce** `string`

**chainId** `string`

**accessList** `string`

**authorizationList** `string`

**block** `string` *required*

区块标签(`latest`、`safe`、`finalized`、`pending`)或 32 字节区块哈希。

**tracer** `object` *required*

Tracer 配置对象。

**properties**

**tracer** `string`

Tracer 类型:`callTracer` 或 `prestateTracer`。

**tracerConfig** `object`

**properties**

**onlyTopCall** `boolean`

callTracer 的 onlyTopCall 选项,对 prestateTracer 忽略

**diffMode** `boolean`

prestateTracer 的 diff 模式,对 callTracer 忽略

**withLog** `boolean`

callTracer 的日志选项,对 prestateTracer 忽略

**返回值**

**result** `object`

跟踪结果。结构取决于所用的 tracer。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_traceCall",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    },
    "latest",
    {
      "tracer": "callTracer",
      "tracerConfig": {
        "onlyTopCall": false
      }
    }
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## debug\_traceTransaction

返回给定交易的所有跟踪信息。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=debug_traceTransaction)

**参数**

**tx\_hash** `string` *required*

32 字节交易哈希(十六进制编码)。

**tracer** `object` *required*

Tracer 配置对象。

**properties**

**tracer** `string`

Tracer 类型:`callTracer` 或 `prestateTracer`。

**tracerConfig** `object`

**properties**

**onlyTopCall** `boolean`

callTracer 的 onlyTopCall 选项,对 prestateTracer 忽略

**diffMode** `boolean`

prestateTracer 的 diff 模式,对 callTracer 忽略

**withLog** `boolean`

callTracer 的日志选项,对 prestateTracer 忽略

**返回值**

**result** `object`

跟踪结果对象。

**properties**

**type** `string`

**from** `string`

**to** `string`

**value** `string`

**gas** `string`

**gasUsed** `string`

**input** `string`

**output** `string`

**error** `string`

**revertReason** `string`

**logs** `array`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## admin\_ethCallStatistics

返回关于 eth\_call 容量的统计信息,包括未激活的执行器和排队请求

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=admin_ethCallStatistics)

**参数**

该方法不接受任何参数。

**返回值**

**result** `object`

包含 eth\_call 容量统计的对象。

**properties**

**inactiveExecutors** `string`

**queuedRequests** `string`

**oldestRequestAgeMs** `string`

**averageRequestAgeMs** `string`

**totalRequests** `string`

**totalErrors** `string`

**queueRejections** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "admin_ethCallStatistics",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## net\_version

返回当前网络 ID。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=net_version)

**参数**

该方法不接受任何参数。

**返回值**

**result** `string`

当前网络/链 ID,字符串形式。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "net_version",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## txpool\_statusByAddress

返回来自给定地址的挂起交易的状态。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=txpool_statusByAddress)

**参数**

**address** `string` *required*

20 字节账户地址(十六进制编码)。

**返回值**

**result** `object`

nonce 到交易状态的映射。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "txpool_statusByAddress",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## txpool\_statusByHash

按哈希返回挂起交易的状态。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=txpool_statusByHash)

**参数**

**hash** `string` *required*

32 字节交易哈希(十六进制编码)。

**返回值**

**result** `object`

交易状态对象。

**properties**

**status** `string`

**reason** `string`

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "txpool_statusByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```

## web3\_clientVersion

返回 Monad 客户端版本。

[在 RPC Playground 中打开](https://docs.monad.xyz/zh/reference/json-rpc/playground.md?method=web3_clientVersion)

**参数**

该方法不接受任何参数。

**返回值**

**result** `string`

Monad 客户端版本字符串。

**示例**

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "method": "web3_clientVersion",
  "params": [],
  "id": 1
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.