JSON-RPC API Reference - Monad Developer Documentation

eth_blockNumber

Returns the number of most recent block. Open in RPC Playground Parameters This method takes no parameters. Returns

result

string

The current block number, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}

eth_call

Executes a new message call immediately without creating a transaction on the block chain. Open in RPC Playground Parameters

transaction

object

required

Transaction call object.

Show properties

from

string

gas

string

maxFeePerGas

string

maxPriorityFeePerGas

string

value

string

input

string

data

string

nonce

string

chainId

string

accessList

string

authorizationList

string

block

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

Returns

result

string

The return data of the executed contract call, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    },
    "latest"
  ],
  "id": 1
}

eth_chainId

Returns the chain ID of the current network. Open in RPC Playground Parameters This method takes no parameters. Returns

result

string

The chain ID, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}

eth_createAccessList

Returns an access list containing all addresses and storage slots accessed during a simulated transaction. Open in RPC Playground Parameters

transaction

object

required

Transaction call object.

Show properties

from

string

gas

string

maxFeePerGas

string

maxPriorityFeePerGas

string

value

string

input

string

data

string

nonce

string

chainId

string

accessList

string

authorizationList

string

block

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

Returns

result

object

The access list and estimated gas used.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_createAccessList",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    },
    "latest"
  ],
  "id": 1
}

eth_estimateGas

Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. Open in RPC Playground Parameters

object

required

Transaction call object.

Show properties

from

string

gas

string

maxFeePerGas

string

maxPriorityFeePerGas

string

value

string

input

string

data

string

nonce

string

chainId

string

accessList

string

authorizationList

string

block

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

Returns

result

string

The estimated gas needed, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "to": "0x...",
      "data": "0x..."
    },
    "latest"
  ],
  "id": 1
}

eth_feeHistory

Transaction fee history Returns transaction base fee per gas and effective priority fee per gas for the requested/supported block range. Open in RPC Playground Parameters

block_count

string

required

Number of blocks in the requested range (hex-encoded integer).

newest_block

string

required

Highest block number (hex) or tag: latest, safe, finalized, pending.

reward_percentiles

array

required

Array of percentile values (floats between 0 and 100) to sample effective priority fees. Can be null.

Returns

result

object

Fee history for the requested block range.

Show properties

gasUsedRatio

array

oldestBlock

string

Example

{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x1",
    "latest",
    [
      25,
      75
    ]
  ],
  "id": 1
}

eth_gasPrice

Returns the current price per gas in wei. Open in RPC Playground Parameters This method takes no parameters. Returns

result

string

The current gas price in wei, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_gasPrice",
  "params": [],
  "id": 1
}

eth_getBalance

Returns the balance of the account of given address. Open in RPC Playground Parameters

account

string

required

20-byte account address (hex-encoded).

block_number

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

Returns

result

string

The account balance in wei, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

eth_getBlockByHash

Returns information about a block by hash. Open in RPC Playground Parameters

block_hash

string

required

32-byte block hash (hex-encoded).

return_full_txns

boolean

required

If true, returns full transaction objects; if false, returns only transaction hashes.

Returns

result

object

The block object, or null if not found.

Show 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

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    false
  ],
  "id": 1
}

eth_getBlockByNumber

Returns information about a block by number. Open in RPC Playground Parameters

block_number

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

return_full_txns

boolean

required

If true, returns full transaction objects; if false, returns only transaction hashes.

Returns

result

object

The block object, or null if not found.

Show 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

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "latest",
    false
  ],
  "id": 1
}

eth_getBlockReceipts

Returns the receipts of a block by number or hash. Open in RPC Playground Parameters

block

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

Returns

result

array

Array of transaction receipt objects for the block.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockReceipts",
  "params": [
    "latest"
  ],
  "id": 1
}

eth_getBlockTransactionCountByHash

Returns the number of transactions in a block from a block matching the given block hash. Open in RPC Playground Parameters

block_hash

string

required

32-byte block hash (hex-encoded).

Returns

result

string

The number of transactions in the block, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}

eth_getBlockTransactionCountByNumber

Returns the number of transactions in a block matching the given block number. Open in RPC Playground Parameters

block_tag

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

Returns

result

string

The number of transactions in the block, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "latest"
  ],
  "id": 1
}

eth_getCode

Returns code at a given address. Open in RPC Playground Parameters

account

string

required

20-byte account address (hex-encoded).

block

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

Returns

result

string

The bytecode at the given address.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

eth_getLogs

Returns an array of all logs matching filter with given id. Open in RPC Playground Parameters

filters

object

required

Log filter object.

Show properties

fromBlock

string

toBlock

string

address

string

topics

array

Returns

result

array

Array of log objects matching the filter.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x0",
      "toBlock": "0x1",
      "address": "0xac4b3dacb91461209ae9d41ec517c2b9cb1b7daf",
      "topics": []
    }
  ],
  "id": 1
}

eth_getStorageAt

Returns the value from a storage position at a given address. Open in RPC Playground Parameters

account

string

required

20-byte account address (hex-encoded).

position

string

required

Storage position (hex-encoded 256-bit integer).

block

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

Returns

result

string

The value at the given storage position, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "0x0",
    "latest"
  ],
  "id": 1
}

eth_getTransactionByBlockHashAndIndex

Returns information about a transaction by block hash and transaction index position. Open in RPC Playground Parameters

block_hash

string

required

32-byte block hash (hex-encoded).

index

string

required

Transaction index position (hex-encoded integer).

Returns

result

object

The transaction object, or null if not found.

Show properties

type

string

chainId

string

nonce

string

gas

string

maxFeePerGas

string

maxPriorityFeePerGas

string

value

string

accessList

array

input

string

yParity

string

hash

string

blockHash

string

blockNumber

string

transactionIndex

string

from

string

gasPrice

string

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockHashAndIndex",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    "0x1"
  ],
  "id": 1
}

eth_getTransactionByBlockNumberAndIndex

Returns information about a transaction by block number and transaction index position. Open in RPC Playground Parameters

block_tag

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

index

string

required

Transaction index position (hex-encoded integer).

Returns

result

object

The transaction object, or null if not found.

Show properties

type

string

chainId

string

nonce

string

gas

string

maxFeePerGas

string

maxPriorityFeePerGas

string

value

string

accessList

array

input

string

yParity

string

hash

string

blockHash

string

blockNumber

string

transactionIndex

string

from

string

gasPrice

string

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockNumberAndIndex",
  "params": [
    "latest",
    "0x1"
  ],
  "id": 1
}

eth_getTransactionByHash

Returns the information about a transaction requested by transaction hash. Open in RPC Playground Parameters

tx_hash

string

required

32-byte transaction hash (hex-encoded).

Returns

result

object

The transaction object, or null if not found.

Show properties

type

string

chainId

string

nonce

string

gas

string

maxFeePerGas

string

maxPriorityFeePerGas

string

value

string

accessList

array

input

string

yParity

string

hash

string

blockHash

string

blockNumber

string

transactionIndex

string

from

string

gasPrice

string

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}

eth_getTransactionCount

Returns the number of transactions sent from an address. Open in RPC Playground Parameters

account

string

required

20-byte account address (hex-encoded).

block

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

Returns

result

string

The number of transactions sent from this address, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

eth_getTransactionReceipt

Returns the receipt of a transaction by transaction hash. Open in RPC Playground Parameters

tx_hash

string

required

32-byte transaction hash (hex-encoded).

Returns

result

object

The transaction receipt object, or null if not found.

Show 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

contractAddress

string

Example

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}

eth_maxPriorityFeePerGas

Returns the current maxPriorityFeePerGas per gas in wei. Open in RPC Playground Parameters This method takes no parameters. Returns

result

string

The current max priority fee per gas in wei, hex-encoded.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_maxPriorityFeePerGas",
  "params": [],
  "id": 1
}

eth_sendRawTransaction

Submits a raw transaction. For EIP-4844 transactions, the raw form must be the network form. This means it includes the blobs, KZG commitments, and KZG proofs. Open in RPC Playground Parameters

hex_tx

string

required

Signed transaction data (hex-encoded).

Returns

result

string

The 32-byte transaction hash.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0x..."
  ],
  "id": 1
}

eth_syncing

Returns an object with data about the sync status or false. Open in RPC Playground Parameters This method takes no parameters. Returns

result

boolean

false if not syncing, or an object with sync status data.

Example

{
  "jsonrpc": "2.0",
  "method": "eth_syncing",
  "params": [],
  "id": 1
}

debug_getRawBlock

Returns an RLP-encoded block. Open in RPC Playground Parameters

block

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

Returns

result

string

The RLP-encoded block data.

Example

{
  "jsonrpc": "2.0",
  "method": "debug_getRawBlock",
  "params": [
    "latest"
  ],
  "id": 1
}

debug_getRawHeader

Returns an RLP-encoded header. Open in RPC Playground Parameters

block

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

Returns

result

string

The RLP-encoded header data.

Example

{
  "jsonrpc": "2.0",
  "method": "debug_getRawHeader",
  "params": [
    "latest"
  ],
  "id": 1
}

debug_getRawReceipts

Returns an array of EIP-2718 binary-encoded receipts. Open in RPC Playground Parameters

block

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

Returns

result

array

Array of EIP-2718 binary-encoded receipts.

Example

{
  "jsonrpc": "2.0",
  "method": "debug_getRawReceipts",
  "params": [
    "latest"
  ],
  "id": 1
}

debug_getRawTransaction

Returns an array of EIP-2718 binary-encoded transactions. Open in RPC Playground Parameters

tx_hash

string

required

32-byte transaction hash (hex-encoded).

Returns

result

string

The EIP-2718 binary-encoded transaction.

Example

{
  "jsonrpc": "2.0",
  "method": "debug_getRawTransaction",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}

debug_traceBlockByHash

Returns the tracing result by executing all transactions in the block specified by the block hash with a tracer. Open in RPC Playground Parameters

block_hash

string

required

32-byte block hash (hex-encoded).

tracer

object

required

Tracer configuration object.

Show properties

tracer

string

Tracer type: callTracer or prestateTracer.

tracerConfig

object

Show properties

onlyTopCall

boolean

onlyTopCall for callTracer, ignored for prestateTracer

diffMode

boolean

diff mode for prestateTracer, ignored for callTracer

withLog

boolean

log for callTracer, ignored for prestateTracer

Returns

result

object

Array of trace result objects, one per transaction.

Show properties

txHash

string

result

object

Example

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

debug_traceBlockByNumber

Returns the tracing result by executing all transactions in the block specified by the block number with a tracer. Open in RPC Playground Parameters

block_number

string

required

Block number (hex) or tag: latest, safe, finalized, pending.

tracer

object

required

Tracer configuration object.

Show properties

tracer

string

Tracer type: callTracer or prestateTracer.

tracerConfig

object

Show properties

onlyTopCall

boolean

onlyTopCall for callTracer, ignored for prestateTracer

diffMode

boolean

diff mode for prestateTracer, ignored for callTracer

withLog

boolean

log for callTracer, ignored for prestateTracer

Returns

result

object

Array of trace result objects, one per transaction.

Show properties

txHash

string

result

object

Example

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "params": [
    "latest",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

debug_traceCall

Returns the tracing result result by executing an eth call. Open in RPC Playground Parameters

transaction

object

required

Transaction call object.

Show properties

from

string

gas

string

maxFeePerGas

string

maxPriorityFeePerGas

string

value

string

input

string

data

string

nonce

string

chainId

string

accessList

string

authorizationList

string

block

string

required

Block tag (latest, safe, finalized, pending) or 32-byte block hash.

tracer

object

required

Tracer configuration object.

Show properties

tracer

string

Tracer type: callTracer or prestateTracer.

tracerConfig

object

Show properties

onlyTopCall

boolean

onlyTopCall for callTracer, ignored for prestateTracer

diffMode

boolean

diff mode for prestateTracer, ignored for callTracer

withLog

boolean

log for callTracer, ignored for prestateTracer

Returns

result

object

The trace result. Structure depends on the tracer used.

Example

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

debug_traceTransaction

Returns all traces of a given transaction. Open in RPC Playground Parameters

tx_hash

string

required

32-byte transaction hash (hex-encoded).

tracer

object

required

Tracer configuration object.

Show properties

tracer

string

Tracer type: callTracer or prestateTracer.

tracerConfig

object

Show properties

onlyTopCall

boolean

onlyTopCall for callTracer, ignored for prestateTracer

diffMode

boolean

diff mode for prestateTracer, ignored for callTracer

withLog

boolean

log for callTracer, ignored for prestateTracer

Returns

result

object

The trace result object.

Show properties

type

string

from

string

value

string

gas

string

gasUsed

string

input

string

output

string

error

string

revertReason

string

logs

array

Example

{
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

admin_ethCallStatistics

Returns statistics about eth_call capacity including inactive executors and queued requests Open in RPC Playground Parameters This method takes no parameters. Returns

result

object

Object with eth_call capacity statistics.

Show properties

inactiveExecutors

string

queuedRequests

string

oldestRequestAgeMs

string

averageRequestAgeMs

string

totalRequests

string

totalErrors

string

queueRejections

string

Example

{
  "jsonrpc": "2.0",
  "method": "admin_ethCallStatistics",
  "params": [],
  "id": 1
}

net_version

Returns the current network ID. Open in RPC Playground Parameters This method takes no parameters. Returns

result

string

The current network/chain ID as a string.

Example

{
  "jsonrpc": "2.0",
  "method": "net_version",
  "params": [],
  "id": 1
}

txpool_statusByAddress

Returns the status of pending transactions from the given address. Open in RPC Playground Parameters

address

string

required

20-byte account address (hex-encoded).

Returns

result

object

Map of nonce to transaction status.

Example

{
  "jsonrpc": "2.0",
  "method": "txpool_statusByAddress",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
  ],
  "id": 1
}

txpool_statusByHash

Returns the status of a pending transaction by hash. Open in RPC Playground Parameters

hash

string

required

32-byte transaction hash (hex-encoded).

Returns

result

object

Transaction status object.

Show properties

status

string

reason

string

Example

{
  "jsonrpc": "2.0",
  "method": "txpool_statusByHash",
  "params": [
    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"
  ],
  "id": 1
}

web3_clientVersion

Returns the Monad client version. Open in RPC Playground Parameters This method takes no parameters. Returns

result

string

The Monad client version string.

Example

{
  "jsonrpc": "2.0",
  "method": "web3_clientVersion",
  "params": [],
  "id": 1
}

JSON-RPC

Execution Events

​eth_blockNumber

​eth_call

​eth_chainId

​eth_createAccessList

​eth_estimateGas

​eth_feeHistory

​eth_gasPrice

​eth_getBalance

​eth_getBlockByHash

​eth_getBlockByNumber

​eth_getBlockReceipts

​eth_getBlockTransactionCountByHash

​eth_getBlockTransactionCountByNumber

​eth_getCode

​eth_getLogs

​eth_getStorageAt

​eth_getTransactionByBlockHashAndIndex

​eth_getTransactionByBlockNumberAndIndex

​eth_getTransactionByHash

​eth_getTransactionCount

​eth_getTransactionReceipt

​eth_maxPriorityFeePerGas

​eth_sendRawTransaction

​eth_syncing

​debug_getRawBlock

​debug_getRawHeader

​debug_getRawReceipts

​debug_getRawTransaction

​debug_traceBlockByHash

​debug_traceBlockByNumber

​debug_traceCall

​debug_traceTransaction

​admin_ethCallStatistics

​net_version

​txpool_statusByAddress

​txpool_statusByHash

​web3_clientVersion

eth_blockNumber

eth_call

eth_chainId

eth_createAccessList

eth_estimateGas

eth_feeHistory

eth_gasPrice

eth_getBalance

eth_getBlockByHash

eth_getBlockByNumber

eth_getBlockReceipts

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByNumber

eth_getCode

eth_getLogs

eth_getStorageAt

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionByHash

eth_getTransactionCount

eth_getTransactionReceipt

eth_maxPriorityFeePerGas

eth_sendRawTransaction

eth_syncing

debug_getRawBlock

debug_getRawHeader

debug_getRawReceipts

debug_getRawTransaction

debug_traceBlockByHash

debug_traceBlockByNumber

debug_traceCall

debug_traceTransaction

admin_ethCallStatistics

net_version

txpool_statusByAddress

txpool_statusByHash

web3_clientVersion