Replay transactions from a block

POST

https://eth-archive.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

The trace_replayBlockTransactions method replays all transactions in a block and returns the requested traces for each transaction.

This method is useful for analyzing all transactions in a specific block and understanding their execution paths and state changes.

Body

application/json

The trace_replayBlockTransactions method replays all transactions in a block and returns the requested traces for each transaction.

This method is useful for analyzing all transactions in a specific block and understanding their execution paths and state changes.

Request payload for Replay transactions from a block.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_replayBlockTransactionsrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string | Array<string>>required

Array containing block identifier and trace types

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Block number in hexadecimal format

string

Block tag specifying which block to replay

stringlatestearliestpendingsafefinalized

Array<string>tracevmTracestateDiff

Response

200OK

Successful block transactions replay response

400Bad Request

Invalid request parameters

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal server error

Replay transactions from a block

curl -X POST 'https://eth-archive.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_replayBlockTransactions",
    "id": 13,
    "params": [
      "0xC5D9F",
      [
        "trace",
        "stateDiff"
      ]
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://eth-archive.nownodes.io/");
const result = await provider.send("trace_replayBlockTransactions", [
  "0xC5D9F",
  [
    "trace",
    "stateDiff"
  ]
]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://eth-archive.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "trace_replayBlockTransactions",
  "params": [
    "0xC5D9F",
    [
      "trace",
      "stateDiff"
    ]
  ],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://eth-archive.nownodes.io/"))
response = w3.provider.make_request("trace_replayBlockTransactions", [
  "0xC5D9F",
  [
    "trace",
    "stateDiff"
  ]
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://eth-archive.nownodes.io/"),
});

const result = await client.request({
  method: "trace_replayBlockTransactions",
  params: [
  "0xC5D9F",
  [
    "trace",
    "stateDiff"
  ]
],
});

console.log(result);

const endpoint = "https://eth-archive.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "trace_replayBlockTransactions", params: [
  "0xC5D9F",
  [
    "trace",
    "stateDiff"
  ]
], id: 1 });
console.log(result);

const response = await fetch('https://eth-archive.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_replayBlockTransactions",
      "id": 13,
      "params": [
        "0xC5D9F",
        [
          "trace",
          "stateDiff"
        ]
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_replayBlockTransactions",
  "id": 13,
  "params": [
    "0xC5D9F",
    [
      "trace",
      "stateDiff"
    ]
  ]
}

response = requests.post('https://eth-archive.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://eth-archive.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "trace_replayBlockTransactions",
    "id": 13,
    "params": [
      "0xC5D9F",
      [
        "trace",
        "stateDiff"
      ]
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_replayBlockTransactions",
  "id": 13,
  "params": [
    "0xC5D9F",
    [
      "trace",
      "stateDiff"
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
            "callType": "call",
            "gas": "0xe41ae0",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x6d023",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "callType": "delegatecall",
            "gas": "0xe06d9f",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x6b2b5",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": [
            0
          ]
        },
        {
          "type": "call",
          "action": {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "callType": "call",
            "gas": "0xdcd3ee",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x69a32",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": [
            0,
            0
          ]
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd"
    },
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
            "callType": "call",
            "gas": "0x87c49",
            "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
            "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "value": "0xf43fc2c04ee0000"
          },
          "result": {
            "gasUsed": "0x74f85",
            "output": "0x"
          },
          "subtraces": 8,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "callType": "call",
            "gas": "0x82fdb",
            "input": "0xd0e30db0",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "value": "0xf43fc2c04ee0000"
          },
          "result": {
            "gasUsed": "0x5da6",
            "output": "0x"
          },
          "subtraces": 0,
          "traceAddress": [
            0
          ]
        },
        {
          "type": "call",
          "action": {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "callType": "call",
            "gas": "0x7badb",
            "input": "0x128acb080000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000928ca80cfc20000000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fc...truncated",
            "to": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x164ef",
            "output": "0xfffffffffffffffffffffffffffffffffffffffffffff8fb7479446341b246530000000000000000000000000000000000000000000000000928ca80cfc20000"
          },
          "subtraces": 4,
          "traceAddress": [
            1
          ]
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1"
    },
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
            "callType": "call",
            "gas": "0x3bd858",
            "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
            "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "value": "0x428c069b"
          },
          "result": {
            "gasUsed": "0xc2191",
            "output": "0x"
          },
          "subtraces": 4,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "callType": "staticcall",
            "gas": "0x3adcd2",
            "input": "0x70a082310000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x9e6",
            "output": "0x0000000000000000000000000000000000000000000000001caee39d8b565d45"
          },
          "subtraces": 0,
          "traceAddress": [
            0
          ]
        },
        {
          "type": "call",
          "action": {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "callType": "call",
            "gas": "0x3abaa4",
            "input": "0xf497df754a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83000000000000000000000000c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e00000000000000000000000094a8b4ee5cd64c79d0ee816f467ea73009f51aa0000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8235a04e00000000000000000000000000000008006a44737d0000000000...truncated",
            "to": "0x111111125421ca6dc452d289314280a0f8842a65",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0xbd1b3",
            "output": "0x00000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8bd0ecbd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb1"
          },
          "subtraces": 5,
          "traceAddress": [
            1
          ]
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 13,
  "error": {
    "code": -32602,
    "message": "Invalid block number",
    "data": "Block 0x12345 not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 13,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Tracing not supported on this node"
  }
}

Documentation

How to migrate to NOWNodes

Replay transactions from a block

Authorizations

Body

Response