ZetaChain - gRPC Gateway docs

v1.0.0

Base URL

https://zetachain.nownodes.io

Documentation for the API of ZetaChain.

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / API Referense

Ethermint

Account queries an Ethereum account.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

addressstringrequiredpath

address is the ethereum hex address to query the account for.

Response

200OK

A successful response.

default

An unexpected error response.

Account queries an Ethereum account.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/account/{address}')
request = Net::HTTP::Get.new(uri)

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

{
  "balance": "string",
  "code_hash": "string",
  "nonce": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

Balance queries the balance of a the EVM denomination for a single EthAccount.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

addressstringrequiredpath

address is the ethereum hex address to query the balance for.

Response

200OK

A successful response.

default

An unexpected error response.

Balance queries the balance of a the EVM denomination for a single EthAccount.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/balances/{address}')
request = Net::HTTP::Get.new(uri)

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

{
  "balance": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

BaseFee queries the base fee of the parent block of the current block, it's similar to feemarket module's method, but also checks london hardfork status.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/base_fee

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

BaseFee queries the base fee of the parent block of the current block, it's similar to feemarket module's method, but also checks london hardfork status.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/base_fee'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/base_fee', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/base_fee')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/base_fee')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/base_fee', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/base_fee";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/base_fee', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/base_fee')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/base_fee')
request = Net::HTTP::Get.new(uri)

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

{
  "base_fee": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

Code queries the balance of all coins for a single account.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

addressstringrequiredpath

address is the ethereum hex address to query the code for.

Response

200OK

A successful response.

default

An unexpected error response.

Code queries the balance of all coins for a single account.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/codes/{address}')
request = Net::HTTP::Get.new(uri)

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

{
  "code": "dGVzdA=="
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

CosmosAccount queries an Ethereum account's Cosmos Address.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

addressstringrequiredpath

address is the ethereum hex address to query the account for.

Response

200OK

A successful response.

default

An unexpected error response.

CosmosAccount queries an Ethereum account's Cosmos Address.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/cosmos_account/{address}')
request = Net::HTTP::Get.new(uri)

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

{
  "cosmos_address": "string",
  "sequence": "string",
  "account_number": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

EstimateGas implements the `eth_estimateGas` rpc api

GET

https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

argsstring<byte>query

args uses the same json format as the json rpc api.

gas_capstring<uint64>query

gas_cap defines the default gas cap to be used.

proposer_addressstring<byte>query

proposer_address of the requested block in hex format.

chain_idstring<int64>query

chain_id is the eip155 chain id parsed from the requested block header.

Response

200OK

A successful response.

default

An unexpected error response.

EstimateGas implements the `eth_estimateGas` rpc api

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/estimate_gas')
request = Net::HTTP::Get.new(uri)

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

{
  "gas": "string",
  "ret": "dGVzdA==",
  "vm_error": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

EthCall implements the `eth_call` rpc api

GET

https://zetachain.nownodes.io/ethermint/evm/v1/eth_call

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

argsstring<byte>query

args uses the same json format as the json rpc api.

gas_capstring<uint64>query

gas_cap defines the default gas cap to be used.

proposer_addressstring<byte>query

proposer_address of the requested block in hex format.

chain_idstring<int64>query

chain_id is the eip155 chain id parsed from the requested block header.

Response

200OK

A successful response.

default

An unexpected error response.

EthCall implements the `eth_call` rpc api

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/eth_call'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/eth_call', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/eth_call')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/eth_call')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/eth_call', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/eth_call";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/eth_call', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/eth_call')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/eth_call')
request = Net::HTTP::Get.new(uri)

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

{
  "hash": "string",
  "logs": [
    {
      "address": "string",
      "topics": [
        "string"
      ],
      "data": "dGVzdA==",
      "block_number": "string",
      "tx_hash": "string",
      "tx_index": "string",
      "block_hash": "string",
      "index": "string",
      "removed": true
    }
  ],
  "ret": "dGVzdA==",
  "vm_error": "string",
  "gas_used": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

Params queries the parameters of x/evm module.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Params queries the parameters of x/evm module.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/params'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/params', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/params')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/params')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/params', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/params";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/params', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/params')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/params')
request = Net::HTTP::Get.new(uri)

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

{
  "params": {
    "evm_denom": "string",
    "enable_create": true,
    "enable_call": true,
    "extra_eips": [
      "string"
    ],
    "chain_config": {
      "homestead_block": "string",
      "dao_fork_block": "string",
      "dao_fork_support": true,
      "eip150_block": "string",
      "eip150_hash": "string",
      "eip155_block": "string",
      "eip158_block": "string",
      "byzantium_block": "string",
      "constantinople_block": "string",
      "petersburg_block": "string",
      "istanbul_block": "string",
      "muir_glacier_block": "string",
      "berlin_block": "string",
      "london_block": "string",
      "arrow_glacier_block": "string",
      "gray_glacier_block": "string",
      "merge_netsplit_block": "string",
      "shanghai_block": "string",
      "cancun_block": "string"
    },
    "allow_unprotected_txs": true
  }
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

Storage queries the balance of all coins for a single account.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

addressstringrequiredpath

address is the ethereum hex address to query the storage state for.

keystringrequiredpath

key defines the key of the storage state

Response

200OK

A successful response.

default

An unexpected error response.

Storage queries the balance of all coins for a single account.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/storage/{address}/{key}')
request = Net::HTTP::Get.new(uri)

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

{
  "value": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

TraceBlock implements the `debug_traceBlockByNumber` and `debug_traceBlockByHash` rpc api

GET

https://zetachain.nownodes.io/ethermint/evm/v1/trace_block

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

trace_config.tracerstringquery

tracer is a custom javascript tracer.

trace_config.timeoutstringquery

timeout overrides the default timeout of 5 seconds for JavaScript-based tracing calls.

trace_config.reexecstring<uint64>query

reexec defines the number of blocks the tracer is willing to go back.

trace_config.disable_stackbooleanquery

disable_stack switches stack capture.

trace_config.disable_storagebooleanquery

disable_storage switches storage capture.

trace_config.debugbooleanquery

debug can be used to print output during capture end.

trace_config.limitinteger<int32>query

limit defines the maximum length of output, but zero means unlimited.

trace_config.overrides.homestead_blockstringquery

homestead_block switch (nil no fork, 0 = already homestead).

trace_config.overrides.dao_fork_blockstringquery

dao_fork_block corresponds to TheDAO hard-fork switch block (nil no fork).

trace_config.overrides.dao_fork_supportbooleanquery

dao_fork_support defines whether the nodes supports or opposes the DAO hard-fork.

trace_config.overrides.eip150_blockstringquery

eip150_block: EIP150 implements the Gas price changes (https://github.com/ethereum/EIPs/issues/150) EIP150 HF block (nil no fork).

trace_config.overrides.eip150_hashstringquery

eip150_hash: EIP150 HF hash (needed for header only clients as only gas pricing changed).

trace_config.overrides.eip155_blockstringquery

eip155_block: EIP155Block HF block.

trace_config.overrides.eip158_blockstringquery

eip158_block: EIP158 HF block.

trace_config.overrides.byzantium_blockstringquery

byzantium_block: Byzantium switch block (nil no fork, 0 = already on byzantium).

trace_config.overrides.constantinople_blockstringquery

constantinople_block: Constantinople switch block (nil no fork, 0 = already activated).

trace_config.overrides.petersburg_blockstringquery

petersburg_block: Petersburg switch block (nil same as Constantinople).

trace_config.overrides.istanbul_blockstringquery

istanbul_block: Istanbul switch block (nil no fork, 0 = already on istanbul).

trace_config.overrides.muir_glacier_blockstringquery

muir_glacier_block: Eip-2384 (bomb delay) switch block (nil no fork, 0 = already activated).

trace_config.overrides.berlin_blockstringquery

berlin_block: Berlin switch block (nil = no fork, 0 = already on berlin).

trace_config.overrides.london_blockstringquery

london_block: London switch block (nil = no fork, 0 = already on london).

trace_config.overrides.arrow_glacier_blockstringquery

arrow_glacier_block: Eip-4345 (bomb delay) switch block (nil = no fork, 0 = already activated).

trace_config.overrides.gray_glacier_blockstringquery

gray_glacier_block: EIP-5133 (bomb delay) switch block (nil = no fork, 0 = already activated).

trace_config.overrides.merge_netsplit_blockstringquery

merge_netsplit_block: Virtual fork after The Merge to use as a network splitter.

trace_config.overrides.shanghai_blockstringquery

shanghai_block switch block (nil = no fork, 0 = already on shanghai).

trace_config.overrides.cancun_blockstringquery

cancun_block switch block (nil = no fork, 0 = already on cancun).

trace_config.enable_memorybooleanquery

enable_memory switches memory capture.

trace_config.enable_return_databooleanquery

enable_return_data switches the capture of return data.

trace_config.tracer_json_configstringquery

tracer_json_config configures the tracer using a JSON string.

block_numberstring<int64>query

block_number of the traced block.

block_hashstringquery

block_hash (hex) of the traced block.

block_timestring<date-time>query

block_time of the traced block.

proposer_addressstring<byte>query

proposer_address is the address of the requested block.

chain_idstring<int64>query

chain_id is the eip155 chain id parsed from the requested block header.

Response

200OK

A successful response.

default

An unexpected error response.

TraceBlock implements the `debug_traceBlockByNumber` and `debug_traceBlockByHash` rpc api

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/trace_block'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/trace_block', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/trace_block')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/trace_block')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/trace_block', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/trace_block";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/trace_block', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/trace_block')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/trace_block')
request = Net::HTTP::Get.new(uri)

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

{
  "data": "dGVzdA=="
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

TraceTx implements the `debug_traceTransaction` rpc api

GET

https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

msg.data.type_urlstringquery

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted). In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

If no scheme is provided, https is assumed.
An HTTP GET on the URL must yield a [google.protobuf.Type][]

value in binary format, or produce an error.
Applications are allowed to cache lookup results based on the

URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.

msg.data.valuestring<byte>query

Must be a valid serialized protocol buffer of the above specified type.

msg.sizenumber<double>query

size is the encoded storage size of the transaction (DEPRECATED).

msg.hashstringquery

hash of the transaction in hex format.

msg.fromstringquery

from is the ethereum signer address in hex format. This address value is checked against the address derived from the signature (V, R, S) using the secp256k1 elliptic curve.

trace_config.tracerstringquery

tracer is a custom javascript tracer.

trace_config.timeoutstringquery

timeout overrides the default timeout of 5 seconds for JavaScript-based tracing calls.

trace_config.reexecstring<uint64>query

reexec defines the number of blocks the tracer is willing to go back.

trace_config.disable_stackbooleanquery

disable_stack switches stack capture.

trace_config.disable_storagebooleanquery

disable_storage switches storage capture.

trace_config.debugbooleanquery

debug can be used to print output during capture end.

trace_config.limitinteger<int32>query

limit defines the maximum length of output, but zero means unlimited.

trace_config.overrides.homestead_blockstringquery

homestead_block switch (nil no fork, 0 = already homestead).

trace_config.overrides.dao_fork_blockstringquery

dao_fork_block corresponds to TheDAO hard-fork switch block (nil no fork).

trace_config.overrides.dao_fork_supportbooleanquery

dao_fork_support defines whether the nodes supports or opposes the DAO hard-fork.

trace_config.overrides.eip150_blockstringquery

eip150_block: EIP150 implements the Gas price changes (https://github.com/ethereum/EIPs/issues/150) EIP150 HF block (nil no fork).

trace_config.overrides.eip150_hashstringquery

eip150_hash: EIP150 HF hash (needed for header only clients as only gas pricing changed).

trace_config.overrides.eip155_blockstringquery

eip155_block: EIP155Block HF block.

trace_config.overrides.eip158_blockstringquery

eip158_block: EIP158 HF block.

trace_config.overrides.byzantium_blockstringquery

byzantium_block: Byzantium switch block (nil no fork, 0 = already on byzantium).

trace_config.overrides.constantinople_blockstringquery

constantinople_block: Constantinople switch block (nil no fork, 0 = already activated).

trace_config.overrides.petersburg_blockstringquery

petersburg_block: Petersburg switch block (nil same as Constantinople).

trace_config.overrides.istanbul_blockstringquery

istanbul_block: Istanbul switch block (nil no fork, 0 = already on istanbul).

trace_config.overrides.muir_glacier_blockstringquery

muir_glacier_block: Eip-2384 (bomb delay) switch block (nil no fork, 0 = already activated).

trace_config.overrides.berlin_blockstringquery

berlin_block: Berlin switch block (nil = no fork, 0 = already on berlin).

trace_config.overrides.london_blockstringquery

london_block: London switch block (nil = no fork, 0 = already on london).

trace_config.overrides.arrow_glacier_blockstringquery

arrow_glacier_block: Eip-4345 (bomb delay) switch block (nil = no fork, 0 = already activated).

trace_config.overrides.gray_glacier_blockstringquery

gray_glacier_block: EIP-5133 (bomb delay) switch block (nil = no fork, 0 = already activated).

trace_config.overrides.merge_netsplit_blockstringquery

merge_netsplit_block: Virtual fork after The Merge to use as a network splitter.

trace_config.overrides.shanghai_blockstringquery

shanghai_block switch block (nil = no fork, 0 = already on shanghai).

trace_config.overrides.cancun_blockstringquery

cancun_block switch block (nil = no fork, 0 = already on cancun).

trace_config.enable_memorybooleanquery

enable_memory switches memory capture.

trace_config.enable_return_databooleanquery

enable_return_data switches the capture of return data.

trace_config.tracer_json_configstringquery

tracer_json_config configures the tracer using a JSON string.

block_numberstring<int64>query

block_number of requested transaction.

block_hashstringquery

block_hash of requested transaction.

block_timestring<date-time>query

block_time of requested transaction.

proposer_addressstring<byte>query

proposer_address is the proposer of the requested block.

chain_idstring<int64>query

chain_id is the the eip155 chain id parsed from the requested block header.

Response

200OK

A successful response.

default

An unexpected error response.

TraceTx implements the `debug_traceTransaction` rpc api

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/trace_tx')
request = Net::HTTP::Get.new(uri)

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

{
  "data": "dGVzdA=="
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

ValidatorAccount queries an Ethereum account's from a validator consensus Address.

GET

https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

cons_addressstringrequiredpath

cons_address is the validator cons address to query the account for.

Response

200OK

A successful response.

default

An unexpected error response.

ValidatorAccount queries an Ethereum account's from a validator consensus Address.

curl -X GET 'https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}'

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}')
request = Net::HTTP::Get.new(uri)

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

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}')
data = response.json()

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://zetachain.nownodes.io/ethermint/evm/v1/validator_account/{cons_address}')
request = Net::HTTP::Get.new(uri)

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

{
  "account_address": "string",
  "sequence": "string",
  "account_number": "string"
}

{
  "error": "string",
  "code": 0,
  "message": "string",
  "details": [
    {
      "type_url": "string",
      "value": "dGVzdA=="
    }
  ]
}

Documentation

How to migrate to NOWNodes

Authentication

MAINNET / API Referense

Ethermint

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Authorizations

Response

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Authorizations

Response

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Authorizations

Parameters

Response

Authorizations

Parameters

Response