debug namespace

debug_deleteChainSlice

Deletes a slice of a chain from the tree on all branches (Nethermind specific).

Parameters

1. startNumber: string (hex integer)

2. force: boolean

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_deleteChainSlice",
      "params": [startNumber, force]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: integer

debug_executionWitness

Reprocesses the existing block with the parameters specified and returns the generated execution witness.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• codes: array of string (hex data)
• headers: array of string (hex data)
• keys: array of string (hex data)
• state: array of string (hex data)

debug_getBadBlocks

Return list of invalid blocks.

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• block: object
  • author: string (address)
  • baseFeePerGas: string (hex integer)
  • blobGasUsed: string (hex integer)
  • blockAccessListHash: string (hash)
  • difficulty: string (hex integer)
  • excessBlobGas: string (hex integer)
  • extraData: string (hex data)
  • gasLimit: string (hex integer)
  • gasUsed: string (hex integer)
  • hash: string (hash)
  • logsBloom: string (hex data)
  • miner: string (address)
  • mixHash: string (hash)
  • nonce: string (8-byte hex data)
  • number: string (hex integer)
  • parentBeaconBlockRoot: string (hash)
  • parentHash: string (hash)
  • receiptsRoot: string (hash)
  • requestsHash: string (hash)
  • sha3Uncles: string (hash)
  • signature: string (hex data)
  • size: string (hex integer)
  • slotNumber: string (hex integer)
  • stateRoot: string (hash)
  • step: integer
  • timestamp: string (hex integer)
  • totalDifficulty: string (hex integer)
  • transactions: array of object
  • transactionsRoot: string (hash)
  • uncles: array of string (hash)
  • withdrawals: array of object
    • address: string (address)
    • amount: string (hex integer)
    • index: string (hex integer)
    • validatorIndex: string (hex integer)
  • withdrawalsRoot: string (hash)
• generatedBlockAccessList: object
  • accountChanges: array of object
    • address: string (address)
    • balanceChanges: array of object
      • index: integer
      • value: string (hex integer)
    • codeChanges: array of object
      • code: string (hex data)
      • codeHash: string (hash)
      • index: integer
    • nonceChanges: array of object
      • index: integer
      • value: string (hex integer)
    • storageChanges: array of object
      • changes: array of object
        • index: integer
        • value: string (hex integer)
      • key: string (hex integer)
    • storageReads: array of string (hex integer)
  • itemCount: integer
• hash: string (hash)
• rlp: string (hex data)

debug_getChainLevel

Retrieves a representation of tree branches on a given chain level (Nethermind specific).

Parameters

1. number: string (hex integer)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• blockInfos: array of object
  • blockHash: string (hash)
  • isFinalized: boolean
  • totalDifficulty: string (hex integer)
  • wasProcessed: boolean
• hasBlockOnMainChain: boolean

debug_getConfigValue

Retrieves the Nethermind configuration value, e.g. JsonRpc.Enabled

Parameters

1. category: string

2. name: string

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_getConfigValue",
      "params": [category, name]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

result may be null in a successful response.

debug_getRawBlock

Get Raw Block format.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: string (hex data)

debug_getRawBlockAccessList

Get raw block access list format.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• memory: string (hex data)

debug_getRawHeader

Get Raw Header format.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: string (hex data)

debug_getRawReceipts

Get Raw Receipt format.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

debug_getRawTransaction

Get Raw Transaction format.

Parameters

1. transactionHash: string (hash)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: string (hex data)

result may be null in a successful response.

debug_getSyncStage

Retrieves Nethermind Sync Stage, With extra Metadata

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• currentStage: string

debug_insertReceipts

Insert receipts for the block after verifying receipts root correctness.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

2. receiptForRpc: array of object

• blobGasPrice: string (hex integer)
• blobGasUsed: string (hex integer)
• blockHash: string (hash)
• blockNumber: string (hex integer)
• contractAddress: string (address)
• cumulativeGasUsed: string (hex integer)
• effectiveGasPrice: string (hex integer)
• from: string (address)
• gasUsed: string (hex integer)
• logs: array of object
  • address: string (address)
  • blockHash: string (hash)
  • blockNumber: string (hex integer)
  • blockTimestamp: string (hex integer)
  • data: string (hex data)
  • logIndex: string (hex integer)
  • removed: boolean
  • topics: array of string (hash)
  • transactionHash: string (hash)
  • transactionIndex: string (hex integer)
• logsBloom: string (hex data)
• root: string (hash)
• status: string (hex integer)
• to: string (address)
• transactionHash: string (hash)
• transactionIndex: string (hex integer)
• type: string (transaction type)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_insertReceipts",
      "params": [blockParameter, receiptForRpc]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: boolean

debug_intermediateRoots

Replays a block and returns the world-state root after each transaction in execution order. EIP-4788/EIP-2935 system calls and withdrawals do not produce an entry. Failed transactions still produce a root (geth partial-result semantics). The block must be canonical or in the bad-block store.

Parameters

1. blockHash: string (hash)

2. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_intermediateRoots",
      "params": [blockHash, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of string (hash)

debug_migrateReceipts

Sets the block number up to which receipts will be migrated to (Nethermind specific).

Parameters

1. from: string (hex integer)

2. to: string (hex integer)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_migrateReceipts",
      "params": [from, to]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: boolean

debug_resetHead

Moves the head to the given block and drops state kept for other branches; returns false when the block is unknown or cannot be made the head (Nethermind specific).

Parameters

1. blockHash: string (hash)

Request

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

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: boolean

debug_simulateV1

Retrieves geth like traces of the simulated blocks

Parameters

1. payload: object

   • blockStateCalls: array of object
     • blockOverrides: object
       • baseFeePerGas: string (hex integer)
       • blobBaseFee: string (hex integer)
       • feeRecipient: string (address)
       • gasLimit: string (hex integer)
       • number: string (hex integer)
       • prevRandao: string (hash)
       • time: string (hex integer)
     • calls: array of object
       • blockHash: string (hash)
       • blockNumber: string (hex integer)
       • blockTimestamp: string (hex integer)
       • gas: string (hex integer)
       • hash: string (hash)
       • transactionIndex: string (hex integer)
       • type: string (transaction type)
     • stateOverrides: map of object
       • balance: string (hex integer)
       • code: string (hex data)
       • hasStateChanges: boolean
       • movePrecompileToAddress: string (address)
       • nonce: string (hex integer)
       • state: map of string (hash)
       • stateDiff: map of string (hash)
   • returnFullTransactionObjects: boolean
   • returnFullTransactions: boolean
   • traceTransfers: boolean
   • validation: boolean

2. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

3. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_simulateV1",
      "params": [payload, blockParameter, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• author: string (address)
• baseFeePerGas: string (hex integer)
• blobGasUsed: string (hex integer)
• blockAccessListHash: string (hash)
• calls: array of object
  • customTracerResult: object
    • value: object
  • entries: array of object
    • depth: integer
    • error: string
    • gas: integer
    • gasCost: integer
    • memory: array of string (32-byte hex data)
    • op: string
    • pc: integer
    • refund: integer
    • returnData: string
    • stack: array of string (hex integer)
    • storage: map of string (32-byte hex data)
  • failed: boolean
  • gas: string (hex integer)
  • returnValue: string (hex data)
  • txHash: string (hash)
• difficulty: string (hex integer)
• excessBlobGas: string (hex integer)
• extraData: string (hex data)
• gasLimit: string (hex integer)
• gasUsed: string (hex integer)
• hash: string (hash)
• logsBloom: string (hex data)
• miner: string (address)
• mixHash: string (hash)
• nonce: string (8-byte hex data)
• number: string (hex integer)
• parentBeaconBlockRoot: string (hash)
• parentHash: string (hash)
• receiptsRoot: string (hash)
• requestsHash: string (hash)
• sha3Uncles: string (hash)
• signature: string (hex data)
• size: string (hex integer)
• slotNumber: string (hex integer)
• stateRoot: string (hash)
• step: integer
• timestamp: string (hex integer)
• totalDifficulty: string (hex integer)
• traces: array of object
  • customTracerResult: object
    • value: object
  • entries: array of object
    • depth: integer
    • error: string
    • gas: integer
    • gasCost: integer
    • memory: array of string (32-byte hex data)
    • op: string
    • pc: integer
    • refund: integer
    • returnData: string
    • stack: array of string (hex integer)
    • storage: map of string (32-byte hex data)
  • failed: boolean
  • gas: string (hex integer)
  • returnValue: string (hex data)
  • txHash: string (hash)
• transactions: array of object
• transactionsRoot: string (hash)
• uncles: array of string (hash)
• withdrawals: array of object
  • address: string (address)
  • amount: string (hex integer)
  • index: string (hex integer)
  • validatorIndex: string (hex integer)
• withdrawalsRoot: string (hash)

debug_standardTraceBadBlockToFile

This method is similar to the debug_standardTraceBlockToFile method, but can be used to obtain information about a block that has been rejected as invalid.

Parameters

1. blockHash: string (hash)

2. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_standardTraceBadBlockToFile",
      "params": [blockHash, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of string

debug_standardTraceBlockToFile

Writes to a file the full stack trace of all invoked opcodes of the transaction specified (or all transactions if not specified) that was included in the block specified. The parent of the block must be present or it will fail.

Parameters

1. blockHash: string (hash)

2. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_standardTraceBlockToFile",
      "params": [blockHash, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of string

debug_traceBlock

Returns the full stack trace of all invoked opcodes of all transactions that were included in the block specified. The parent of the block must be present or it will fail.

Parameters

1. blockRlp: string (hex data)

2. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceBlock",
      "params": [blockRlp, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceBlockByHash

Similar to debug_traceBlock, this method accepts a block hash and replays the block that is already present in the database.

Parameters

1. blockHash: string (hash)

2. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceBlockByHash",
      "params": [blockHash, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceBlockByNumber

Similar to debug_traceBlock, this method accepts a block number as well as "latest" or "finalized" and replays the block that is already present in the database.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

2. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceBlockByNumber",
      "params": [blockParameter, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceCall

This method lets you run an eth_call within the context of the given block execution using the final state of parent block as the base. The block can be specified either by hash or by number. It takes the same input object as a eth_call. It returns the same output as debug_traceTransaction.

Parameters

1. call: object

   • blockHash: string (hash)
   • blockNumber: string (hex integer)
   • blockTimestamp: string (hex integer)
   • gas: string (hex integer)
   • hash: string (hash)
   • transactionIndex: string (hex integer)
   • type: string (transaction type)

2. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

3. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceCall",
      "params": [call, blockParameter, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceCallMany

Executes a list of bundles of transactions without creating transactions on the blockchain and returns their traces

Parameters

1. bundles: array of object

• blockOverride: object
  • baseFeePerGas: string (hex integer)
  • blobBaseFee: string (hex integer)
  • feeRecipient: string (address)
  • gasLimit: string (hex integer)
  • number: string (hex integer)
  • prevRandao: string (hash)
  • time: string (hex integer)
• stateOverrides: map of object
  • balance: string (hex integer)
  • code: string (hex data)
  • hasStateChanges: boolean
  • movePrecompileToAddress: string (address)
  • nonce: string (hex integer)
  • state: map of string (hash)
  • stateDiff: map of string (hash)
• transactions: array of object
  • blockHash: string (hash)
  • blockNumber: string (hex integer)
  • blockTimestamp: string (hex integer)
  • gas: string (hex integer)
  • hash: string (hash)
  • transactionIndex: string (hex integer)
  • type: string (transaction type)

2. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

3. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceCallMany",
      "params": [bundles, blockParameter, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: array of array of object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceTransaction

This method will attempt to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it will finally attempt to execute the transaction that corresponds to the given hash.

Parameters

1. transactionHash: string (hash)

2. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceTransaction",
      "params": [transactionHash, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceTransactionByBlockAndIndex

Returns the full stack trace of the transaction at the given index of the block specified by number, tag or hash. The block that the parameter resolves to is the one traced, so a hash that is not on the canonical chain traces that block rather than the canonical one at the same height.

Parameters

1. blockParameter: string (block number or hash or either of earliest, finalized, latest, pending, or safe)

2. txIndex: integer

3. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceTransactionByBlockAndIndex",
      "params": [blockParameter, txIndex, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceTransactionByBlockhashAndIndex

Returns the full stack trace of the transaction at the given index of the block with the specified hash. The block need not be on the canonical chain.

Parameters

1. blockHash: string (hash)

2. txIndex: integer

3. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceTransactionByBlockhashAndIndex",
      "params": [blockHash, txIndex, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceTransactionInBlockByHash

Parameters

1. blockRlp: string (hex data)

2. transactionHash: string (hash)

3. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceTransactionInBlockByHash",
      "params": [blockRlp, transactionHash, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)

debug_traceTransactionInBlockByIndex

Parameters

1. blockRlp: string (hex data)

2. txIndex: integer

3. options: object

   • blockOverrides: object
     • baseFeePerGas: string (hex integer)
     • blobBaseFee: string (hex integer)
     • feeRecipient: string (address)
     • gasLimit: string (hex integer)
     • number: string (hex integer)
     • prevRandao: string (hash)
     • time: string (hex integer)
   • disableMemory: boolean
   • disableStack: boolean
   • disableStorage: boolean
   • enableMemory: boolean
   • enableReturnData: boolean
   • stateOverrides: map of object
     • balance: string (hex integer)
     • code: string (hex data)
     • hasStateChanges: boolean
     • movePrecompileToAddress: string (address)
     • nonce: string (hex integer)
     • state: map of string (hash)
     • stateDiff: map of string (hash)
   • streamMode: boolean
   • timeout: string (duration)
   • tracer: string
   • tracerConfig: object
   • txHash: string (hash)

Request

curl localhost:8545 \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
      "jsonrpc": "2.0",
      "id": 0,
      "method": "debug_traceTransactionInBlockByIndex",
      "params": [blockRlp, txIndex, options]
    }'

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": result
}

result: object

• customTracerResult: object
  • value: object
• entries: array of object
  • depth: integer
  • error: string
  • gas: integer
  • gasCost: integer
  • memory: array of string (32-byte hex data)
  • op: string
  • pc: integer
  • refund: integer
  • returnData: string
  • stack: array of string (hex integer)
  • storage: map of string (32-byte hex data)
• failed: boolean
• gas: string (hex integer)
• returnValue: string (hex data)
• txHash: string (hash)