Replay a transaction

POST

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

The trace_replayTransaction method replays a transaction and returns the execution traces.

This method is useful for debugging and analyzing specific transactions that have already been mined.

Body

application/json

The trace_replayTransaction method replays a transaction and returns the execution traces.

This method is useful for debugging and analyzing specific transactions that have already been mined.

Request payload for Replay a transaction.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_replayTransactionrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | Array<string>>required

Array containing transaction hash and trace types

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Hash of the transaction to replay

string

Array<string>tracevmTracestateDiff

Response

200OK

Successful transaction 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 a transaction

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://eth-archive.nownodes.io/");
const result = await provider.send("trace_replayTransaction", [
  "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
  [
    "trace",
    "stateDiff",
    "vmTrace"
  ]
]);
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_replayTransaction",
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
    [
      "trace",
      "stateDiff",
      "vmTrace"
    ]
  ],
  "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_replayTransaction", [
  "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
  [
    "trace",
    "stateDiff",
    "vmTrace"
  ]
])
print(response)

import { createPublicClient, http } from "viem";

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

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

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_replayTransaction", params: [
  "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
  [
    "trace",
    "stateDiff",
    "vmTrace"
  ]
], 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_replayTransaction",
      "id": 1,
      "params": [
        "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
        [
          "trace",
          "stateDiff",
          "vmTrace"
        ]
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_replayTransaction",
  "id": 1,
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
    [
      "trace",
      "stateDiff",
      "vmTrace"
    ]
  ]
}

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_replayTransaction",
    "id": 1,
    "params": [
      "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
      [
        "trace",
        "stateDiff",
        "vmTrace"
      ]
    ]
  }'

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_replayTransaction",
  "id": 1,
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
    [
      "trace",
      "stateDiff",
      "vmTrace"
    ]
  ]
}

{
  "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
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid transaction hash",
    "data": "Transaction not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

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

Documentation

How to migrate to NOWNodes

Replay a transaction

Authorizations

Body

Response