Thorest API

v2.4.1

Base URL

https://vet.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

General

Accounts

Retrieve account details

GET

https://vet.nownodes.io/accounts/{address}

Retrieve information about an account or a contract identified by its address.

To access historical details, you can specify a revision as a query parameter.

Parameters

addressstring<hex>requiredpath

The address of the account/ contract

revisionstringquery

Specify either best, a block number or block ID. If omitted, the best block is assumed.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Retrieve account details

curl -X GET 'https://vet.nownodes.io/accounts/{address}'

const response = await fetch('https://vet.nownodes.io/accounts/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/accounts/{address}')
data = response.json()

{
  "balance": "0x47ff1f90327aa0f8e",
  "energy": "0xcf624158d591398",
  "hasCode": false
}

Invalid address

Inspect clauses

POST

https://vet.nownodes.io/accounts/*

This endpoint can be used for various purposes:

Read contract state.
Simulate the execution of a transaction. This can be useful to determine if your transaction may revert before submitting it.
Inspect the outputs of a transaction before executing it.
Estimate the gas consumption of a transaction. Note: The caller field should be provided for higher accuracy.

The fields gasPrice, gasPayer, provedWork, blockRef and expiration are for exposing themselves in EVM. Transaction meta features won't be reflected in the result, for example, no error is returned if the transaction is technically expired. For more information, please refer to the vechain documentation.

To access historical details, you can specify a revision as a query parameter.

Body

application/json

provedWorkstring | null

The transaction's proved work (for extension contract).

gasPayerstring | null

The address of the gas payer (for extension contract).

expirationinteger<uint32> | null

The transaction expiration (for extension contract).

blockRefstring | null

The block reference (for extension contract).

clausesArray<Clause> | null

An array of clauses to be executed.

Show child attributes

tostring | null

The recipient of the clause. Null indicates contract deployment.

valuestring

The hexadecimal representation of the amount (wei) of VET to be transferred.

datastring

The input data for the clause (in bytes).

gasinteger<uint64> | null

The maximum allowed gas for the execution of the batch call.

gasPricestring | null

The absolute gas price for the batch call.

callerstring | null

The caller's address (msg.sender) for the batch call.

Parameters

revisionstringquery

Specify either best, a block number or block ID. If omitted, the best block is assumed.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Inspect clauses

curl -X POST 'https://vet.nownodes.io/accounts/*' \
  -H 'Content-Type: application/json' \
  -d '{
    "gas": 50000,
    "gasPrice": "1000000000000000",
    "caller": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
    "provedWork": "1000",
    "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
    "expiration": 1000,
    "blockRef": "0x00000000851caf3c",
    "clauses": [
      {
        "to": "0x0000000000000000000000000000456E65726779",
        "value": "0x0",
        "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000000000000000000000000000000000000000013f306a2409fc0000"
      },
      {
        "to": "0xf077b491b355E64048cE21E3A6Fc4751eEeA77fa",
        "value": "0x6124fee993bc00000",
        "data": "0x"
      },
      {
        "to": null,
        "value": "0x0",
        "data": "0x6080604052348015600f57600080fd5b50609f8061001e6000396000f300608060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680631820cabb146044575b600080fd5b348015604f57600080fd5b506056606c565b6040518082815260200191505060405180910390f35b62015180815600a165627a7a723058200ac7475da248e2fc26c057319e296e90c24d5f8b9bf956fb3b77545642cad3b10029"
      }
    ]
  }'

const response = await fetch('https://vet.nownodes.io/accounts/*', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "gas": 50000,
      "gasPrice": "1000000000000000",
      "caller": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
      "provedWork": "1000",
      "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
      "expiration": 1000,
      "blockRef": "0x00000000851caf3c",
      "clauses": [
        {
          "to": "0x0000000000000000000000000000456E65726779",
          "value": "0x0",
          "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000000000000000000000000000000000000000013f306a2409fc0000"
        },
        {
          "to": "0xf077b491b355E64048cE21E3A6Fc4751eEeA77fa",
          "value": "0x6124fee993bc00000",
          "data": "0x"
        },
        {
          "to": null,
          "value": "0x0",
          "data": "0x6080604052348015600f57600080fd5b50609f8061001e6000396000f300608060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680631820cabb146044575b600080fd5b348015604f57600080fd5b506056606c565b6040518082815260200191505060405180910390f35b62015180815600a165627a7a723058200ac7475da248e2fc26c057319e296e90c24d5f8b9bf956fb3b77545642cad3b10029"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "gas": 50000,
  "gasPrice": "1000000000000000",
  "caller": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
  "provedWork": "1000",
  "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
  "expiration": 1000,
  "blockRef": "0x00000000851caf3c",
  "clauses": [
    {
      "to": "0x0000000000000000000000000000456E65726779",
      "value": "0x0",
      "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000000000000000000000000000000000000000013f306a2409fc0000"
    },
    {
      "to": "0xf077b491b355E64048cE21E3A6Fc4751eEeA77fa",
      "value": "0x6124fee993bc00000",
      "data": "0x"
    },
    {
      "to": None,
      "value": "0x0",
      "data": "0x6080604052348015600f57600080fd5b50609f8061001e6000396000f300608060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680631820cabb146044575b600080fd5b348015604f57600080fd5b506056606c565b6040518082815260200191505060405180910390f35b62015180815600a165627a7a723058200ac7475da248e2fc26c057319e296e90c24d5f8b9bf956fb3b77545642cad3b10029"
    }
  ]
}

response = requests.post('https://vet.nownodes.io/accounts/*', json=payload)
data = response.json()

Request Body

{
  "gas": 50000,
  "gasPrice": "1000000000000000",
  "caller": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
  "provedWork": "1000",
  "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
  "expiration": 1000,
  "blockRef": "0x00000000851caf3c",
  "clauses": [
    {
      "to": "0x0000000000000000000000000000456E65726779",
      "value": "0x0",
      "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000000000000000000000000000000000000000013f306a2409fc0000"
    },
    {
      "to": "0xf077b491b355E64048cE21E3A6Fc4751eEeA77fa",
      "value": "0x6124fee993bc00000",
      "data": "0x"
    },
    {
      "to": null,
      "value": "0x0",
      "data": "0x6080604052348015600f57600080fd5b50609f8061001e6000396000f300608060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680631820cabb146044575b600080fd5b348015604f57600080fd5b506056606c565b6040518082815260200191505060405180910390f35b62015180815600a165627a7a723058200ac7475da248e2fc26c057319e296e90c24d5f8b9bf956fb3b77545642cad3b10029"
    }
  ]
}

[
  {
    "data": "0x0000000000000000000000000000000000000000000000000000000000000001",
    "events": [
      {
        "address": "0x0000000000000000000000000000456e65726779",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x000000000000000000000000435933c8064b4ae76be665428e0307ef2ccfbd68",
          "0x0000000000000000000000000f872421dc479f3c11edd89512731814d0598db5"
        ],
        "data": "0x0000000000000000000000000000000000000000000000013f306a2409fc0000"
      }
    ],
    "transfers": [],
    "gasUsed": 13326,
    "reverted": false,
    "vmError": ""
  },
  {
    "data": "0x",
    "events": [],
    "transfers": [
      {
        "sender": "0x435933c8064b4ae76be665428e0307ef2ccfbd68",
        "recipient": "0xf077b491b355e64048ce21e3a6fc4751eeea77fa",
        "amount": "0x6124fee993bc00000"
      }
    ],
    "gasUsed": 0,
    "reverted": false,
    "vmError": ""
  },
  {
    "data": "0x608060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680631820cabb146044575b600080fd5b348015604f57600080fd5b506056606c565b6040518082815260200191505060405180910390f35b62015180815600a165627a7a723058200ac7475da248e2fc26c057319e296e90c24d5f8b9bf956fb3b77545642cad3b10029",
    "events": [
      {
        "address": "0xecadd5492c1fa085e40e2c17e79f1a03f38f86ca",
        "topics": [
          "0xb35bf4274d4295009f1ec66ed3f579db287889444366c03d3a695539372e8951"
        ],
        "data": "0x000000000000000000000000435933c8064b4ae76be665428e0307ef2ccfbd68"
      }
    ],
    "transfers": [],
    "gasUsed": 31881,
    "reverted": false,
    "vmError": ""
  }
]

Invalid address

Retrieve a contract's bytecode

GET

https://vet.nownodes.io/accounts/{address}/code

If the provided address is not a contract, empty bytecode is returned.

Parameters

addressstring<hex>requiredpath

The address of the account/ contract

revisionstringquery

Specify either best, a block number or block ID. If omitted, the best block is assumed.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Retrieve a contract's bytecode

curl -X GET 'https://vet.nownodes.io/accounts/{address}/code'

const response = await fetch('https://vet.nownodes.io/accounts/{address}/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/accounts/{address}/code')
data = response.json()

{
  "code": "0x6060604052600080fd00a165627a7a72305820c23d3ae2dc86ad130561a2829d87c7cb8435365492bd1548eb7e7fc0f3632be90029"
}

Invalid address

GET

https://vet.nownodes.io/accounts/{address}/storage/{key}

This endpoint allows you to retrieve the value stored at a specific storage position ({key}) of a Vechain smart contract associated with the provided address ({address}). The response will contain information about the stored value for the given key.

To access historical details, you can specify a revision as a query parameter.

Parameters

addressstring<hex>requiredpath

The address of the account/ contract

keystringrequiredpath

The unique identifier (key) representing the specific position in the account storage. This key is used to access and retrieve data stored at a particular storage position.

revisionstringquery

Specify either best, a block number or block ID. If omitted, the best block is assumed.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

GET /accounts/{address}/storage/{key}

curl -X GET 'https://vet.nownodes.io/accounts/{address}/storage/{key}'

const response = await fetch('https://vet.nownodes.io/accounts/{address}/storage/{key}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/accounts/{address}/storage/{key}')
data = response.json()

{
  "value": "0x0000000000000000000000000000000000000000000000000000000000000001"
}

Invalid address

GET

https://vet.nownodes.io/accounts/{address}/storage/raw/{key}

This endpoint retrieves the storage for the given storage position in RAW RLP encoded format. This API is not served as the general purpose API, the storage value needs to be decoded by the caller to serve any further purpose..

Parameters

addressstring<hex>requiredpath

The address of the account/ contract

keystringrequiredpath

The unique identifier (key) representing the specific position in the account storage. This key is used to access and retrieve data stored at a particular storage position.

revisionstringquery

Specify either best, a block number or block ID. If omitted, the best block is assumed.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

GET /accounts/{address}/storage/raw/{key}

curl -X GET 'https://vet.nownodes.io/accounts/{address}/storage/raw/{key}'

const response = await fetch('https://vet.nownodes.io/accounts/{address}/storage/raw/{key}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/accounts/{address}/storage/raw/{key}')
data = response.json()

{
  "value": "0x01"
}

Invalid address

Transactions

Retrieve a transaction by ID

GET

https://vet.nownodes.io/transactions/{id}

This endpoint allows you to retrieve a transaction identified by its ID. If the pending parameter is set to true, the response may include a pending transaction with a null meta field. Use this option when you want to retrieve pending transactions, providing flexibility in accessing real-time transaction data.

If no transaction is found, the response will be be a 200 with a null body.

Parameters

idstringrequiredpath

The transaction ID

rawbooleanquery

Whether the response should include a raw transaction represented in hexadecimal format.

headstringquery

Explicitly define the ID of the head block. Best block is assumed if omitted.

pendingbooleanquery

Allows you to indicate whether the response should include transactions that are still pending

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Retrieve a transaction by ID

curl -X GET 'https://vet.nownodes.io/transactions/{id}'

const response = await fetch('https://vet.nownodes.io/transactions/{id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/transactions/{id}')
data = response.json()

{
  "id": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8",
  "chainTag": 1,
  "blockRef": "0x00000001511fc0be",
  "expiration": 30,
  "clauses": [],
  "gasPriceCoef": 128,
  "gas": 21000,
  "origin": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
  "delegator": null,
  "nonce": "0xd92966da424d9939",
  "dependsOn": null,
  "size": 180,
  "meta": {
    "blockID": "0x00000001c458949985a6d86b7139690b8811dd3b4647c02d4f41cdefb7d32327",
    "blockNumber": 1,
    "blockTimestamp": 1523156271
  }
}

Invalid transaction ID

Retrieve transaction receipt

GET

https://vet.nownodes.io/transactions/{id}/receipt

This endpoint allows you to retrieve the receipt of a transaction identified by its ID. If the transaction is not found, the response will be null.

Parameters

idstringrequiredpath

The transaction ID

headstringquery

Explicitly define the ID of the head block. Best block is assumed if omitted.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Retrieve transaction receipt

curl -X GET 'https://vet.nownodes.io/transactions/{id}/receipt'

const response = await fetch('https://vet.nownodes.io/transactions/{id}/receipt', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/transactions/{id}/receipt')
data = response.json()

{
  "gasUsed": 21000,
  "gasPayer": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d",
  "paid": "0x1236efcbcbb340000",
  "reward": "0x576e189f04f60000",
  "reverted": false,
  "outputs": [
    {
      "contractAddress": "0x0000000000000000000000000000456e65726779",
      "events": [
        {
          "address": "0x0000000000000000000000000000456e65726779",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000435933c8064b4ae76be665428e0307ef2ccfbd68"
          ],
          "data": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8"
        }
      ],
      "transfers": [
        {
          "sender": "0x5034aa590125b64023a0262112b98d72e3c8e40e",
          "recipient": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
          "amount": "0x47fdb3c3f456c0000"
        }
      ]
    }
  ],
  "meta": {
    "blockID": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
    "blockNumber": 325324,
    "blockTimestamp": 1533267900,
    "txID": "0x284bba50ef777889ff1a367ed0b38d5e5626714477c40de38d71cedd6f9fa477",
    "txOrigin": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d"
  }
}

Invalid transaction ID

Send a transaction

POST

https://vet.nownodes.io/transactions

This endpoint allows you to send a transaction to the blockchain. The transaction must be signed and RLP encoded.

The below is a TypeScript example of how to sign and RLP encode a transaction using the thor-devkit library:

Copied!

import { Transaction, secp256k1 } from 'thor-devkit'

const clauses = [{
    to: '0x7567d83b7b8d80addcb281a71d54fc7b3364ffed',
    value: 10000,
    data: '0x'
}]

let body: Transaction.Body = {
    chainTag: '0x4a',
    blockRef: '0x0000000000000000',
    expiration: 32,
    clauses: clauses,
    gasPriceCoef: 128,
    gas: Transaction.intrinsicGas(clauses),
    dependsOn: null,
    nonce: 12345678
}

const tx = new Transaction(body)
const signingHash = tx.signingHash()
tx.signature = secp256k1.sign(signingHash, Buffer.from("99f0500549792796c14fed62011a51081dc5b5e68fe8bd8a13b86be829c4fd36", "hex"))

const raw = tx.encode()
const decoded = Transaction.decode(raw)

axios.post('http://localhost:8669/transactions', {
  raw: '0x' + raw.toString('hex')
})

Body

application/json

rawstring<hex>

The raw RLP encoded transaction.

Response

200OK

400Bad Request

Bad Request

403Forbidden

Forbidden

Authorization

api-keyAuthapiKey in header

Send a transaction

curl -X POST 'https://vet.nownodes.io/transactions' \
  -H 'Content-Type: application/json' \
  -d '{
    "raw": "0xf901854a880104c9cf34b0f5701ef8e7f8e594058d4c951aa24ca012cef3408b259ac1c69d1258890254beb02d1dcc0000b8c469ff936b00000000000000000000000000000000000000000000000000000000ee6c7f95000000000000000000000000167f6cc1e67a615b51b5a2deaba6b9feca7069df000000000000000000000000000000000000000000000000000000000000136a00000000000000000000000000000000000000000000000254beb02d1dcc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080830469978084cb6b32c5c101b88272da83429a49a354f566dd8c85ba288a7c86d1d3161c0aad6a276a7c9f8e69c14df3d76f0d3442a4f4a2a13d016c32c45e82d5010f27386eeb384dee3d8390c0006adead8b8ce8823c583e1ac15facef8f1cc665a707ade82b3c956a53a2b24e0c03d80504bc4b276b5d067b72636d8e88d2ffc65528f868df2cadc716962978a000"
  }'

const response = await fetch('https://vet.nownodes.io/transactions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "raw": "0xf901854a880104c9cf34b0f5701ef8e7f8e594058d4c951aa24ca012cef3408b259ac1c69d1258890254beb02d1dcc0000b8c469ff936b00000000000000000000000000000000000000000000000000000000ee6c7f95000000000000000000000000167f6cc1e67a615b51b5a2deaba6b9feca7069df000000000000000000000000000000000000000000000000000000000000136a00000000000000000000000000000000000000000000000254beb02d1dcc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080830469978084cb6b32c5c101b88272da83429a49a354f566dd8c85ba288a7c86d1d3161c0aad6a276a7c9f8e69c14df3d76f0d3442a4f4a2a13d016c32c45e82d5010f27386eeb384dee3d8390c0006adead8b8ce8823c583e1ac15facef8f1cc665a707ade82b3c956a53a2b24e0c03d80504bc4b276b5d067b72636d8e88d2ffc65528f868df2cadc716962978a000"
    }),
});

const data = await response.json();

import requests

payload = {
  "raw": "0xf901854a880104c9cf34b0f5701ef8e7f8e594058d4c951aa24ca012cef3408b259ac1c69d1258890254beb02d1dcc0000b8c469ff936b00000000000000000000000000000000000000000000000000000000ee6c7f95000000000000000000000000167f6cc1e67a615b51b5a2deaba6b9feca7069df000000000000000000000000000000000000000000000000000000000000136a00000000000000000000000000000000000000000000000254beb02d1dcc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080830469978084cb6b32c5c101b88272da83429a49a354f566dd8c85ba288a7c86d1d3161c0aad6a276a7c9f8e69c14df3d76f0d3442a4f4a2a13d016c32c45e82d5010f27386eeb384dee3d8390c0006adead8b8ce8823c583e1ac15facef8f1cc665a707ade82b3c956a53a2b24e0c03d80504bc4b276b5d067b72636d8e88d2ffc65528f868df2cadc716962978a000"
}

response = requests.post('https://vet.nownodes.io/transactions', json=payload)
data = response.json()

Request Body

{
  "raw": "0xf901854a880104c9cf34b0f5701ef8e7f8e594058d4c951aa24ca012cef3408b259ac1c69d1258890254beb02d1dcc0000b8c469ff936b00000000000000000000000000000000000000000000000000000000ee6c7f95000000000000000000000000167f6cc1e67a615b51b5a2deaba6b9feca7069df000000000000000000000000000000000000000000000000000000000000136a00000000000000000000000000000000000000000000000254beb02d1dcc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080830469978084cb6b32c5c101b88272da83429a49a354f566dd8c85ba288a7c86d1d3161c0aad6a276a7c9f8e69c14df3d76f0d3442a4f4a2a13d016c32c45e82d5010f27386eeb384dee3d8390c0006adead8b8ce8823c583e1ac15facef8f1cc665a707ade82b3c956a53a2b24e0c03d80504bc4b276b5d067b72636d8e88d2ffc65528f868df2cadc716962978a000"
}

{
  "id": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8"
}

Invalid transaction

Insufficient energy

Blocks

Retrieve a block

GET

https://vet.nownodes.io/blocks/{revision}

Retrieve information about a block identified by its revision.

If the provided revision is not found, the response will be null

Parameters

revisionstringrequiredpath

Revision can be one of:

a block ID (hex string)
a block number (integer)
best stands for latest block
finalized stands for the finalized block

expandedbooleanquery

Whether the returned block is expanded.

true returns transactions as an array of objects with the transaction details and outputs
false returns transactions as an array of transaction IDs (hex strings)

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Retrieve a block

curl -X GET 'https://vet.nownodes.io/blocks/{revision}'

const response = await fetch('https://vet.nownodes.io/blocks/{revision}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/blocks/{revision}')
data = response.json()

{
  "number": 325324,
  "id": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
  "size": 373,
  "parentID": "0x0004f6cb730dbd90fed09d165bfdf33cc0eed47ec068938f6ee7b7c12a4ea98d",
  "timestamp": 1533267900,
  "gasLimit": 11253579,
  "beneficiary": "0xb4094c25f86d628fdd571afc4077f0d0196afb48",
  "gasUsed": 21000,
  "totalScore": 1029988,
  "txsRoot": "0x89dfd9fcd10c9e53d68592cf8b540b280b72d381b868523223992f3e09a806bb",
  "txsFeatures": 0,
  "stateRoot": "0x86bcc6d214bc9d8d0dedba1012a63c8317d19ce97f60c8a2ef5c59bbd40d4261",
  "receiptsRoot": "0x15787e2533c470e8a688e6cd17a1ee12d8457778d5f82d2c109e2d6226d8e54e",
  "com": true,
  "signer": "0xab7b27fc9e7d29f9f2e5bd361747a5515d0cc2d1",
  "isTrunk": true,
  "isFinalized": false,
  "transactions": [
    "0x284bba50ef777889ff1a367ed0b38d5e5626714477c40de38d71cedd6f9fa477"
  ]
}

Invalid revision

Logs

Query smart contract events

POST

https://vet.nownodes.io/logs/event

Query event logs generated by vechain smart contracts. Events are created using the LOG opcode in the Ethereum Virtual Machine (EVM).

Event logs provide a way to track specific occurrences and state changes within a smart contract. By querying these logs, you can gain insights into the history of events emitted by a particular contract.

Body

application/json

rangeFilterRange | null

Defines the range for filtering. Setting values to null indicates the entire range.

Note: If omitted or set to null, a timeout may occur if there is a large amount of data to query.

Example:

Copied!

{
  "range": {
    "unit": "block",
    "from": 10,
    "to": 1000
  }
}

This refers to the range from block 10 to block 1000.

Show child attributes

unitstring | nullblocktime

Specifies the unit of measurement for the from and to values. Use block for block numbers or time for block timestamps. Default is block.

frominteger<uint64> | null

Defines the starting block number or timestamp for the specified range.

tointeger<uint64> | null

Specifies the ending block number or timestamp for the specified range.

optionsFilterOptions | null

Include these parameters to receive filtered results in a paged format.

Note: If omitted, a timeout may occur if there is a large amount of data to query. If there is a small amount of data you can omit to receive all results in a single response.

Example:

Copied!

{
  "options": {
    "offset": 0,
    "limit": 10
  }
}

In this example, the page offset is 0, and the page size is 10.

Show child attributes

offsetinteger | null

The offset in the matched record set. Use this parameter for pagination.

Default's to 0.

limitinteger | null

The limit of records to be included in the output. Use this parameter for pagination.

Default's to all results.

criteriaSetArray<EventCriteria> | null

Show child attributes

addressstring | null

The address of the contract that emits the event.

topic0string | null

The keccak256 hash representing the event signature. For example, the signature for the Transfer event is keccak256("Transfer(address,address,uint256)").

topic1string | null

Filters events based on the 1st parameter in the event.

Note: The parameter must be padded to 32 bytes.

For example, for the event MySolidityEvent(address,uint256), use topic1 to match the address parameter.

topic2string | null

Filters events based on the 2nd parameter in the event.

Note: The parameter must be padded to 32 bytes.

For example, for the event MySolidityEvent(address,uint256), use topic2 to match the uint256 parameter.

topic3string | null

Filters events based on the 3rd parameter in the event.

Note: The parameter must be padded to 32 bytes.

For example, for the event MySolidityEvent(address,address,uint256), use topic3 to match the uint256 parameter.

topic4string | null

Filters events based on the 4th parameter in the event.

Note: The parameter must be padded to 32 bytes.

For example, for the event MySolidityEvent(address,address,address,uint256), use topic4 to match the uint256 parameter.

orderstring | nullascdesc

Specifies the order of the results. Use asc for ascending order, and desc for descending order.

Default value: asc

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Query smart contract events

curl -X POST 'https://vet.nownodes.io/logs/event' \
  -H 'Content-Type: application/json' \
  -d '{
    "range": {
      "unit": "block",
      "from": 17240365,
      "to": 17289864
    },
    "options": {
      "offset": 0,
      "limit": 100
    },
    "criteriaSet": [
      {
        "address": "0x0000000000000000000000000000456E65726779",
        "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "topic1": "0x0000000000000000000000006d95e6dca01d109882fe1726a2fb9865fa41e7aa"
      }
    ],
    "order": "asc"
  }'

const response = await fetch('https://vet.nownodes.io/logs/event', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "range": {
        "unit": "block",
        "from": 17240365,
        "to": 17289864
      },
      "options": {
        "offset": 0,
        "limit": 100
      },
      "criteriaSet": [
        {
          "address": "0x0000000000000000000000000000456E65726779",
          "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "topic1": "0x0000000000000000000000006d95e6dca01d109882fe1726a2fb9865fa41e7aa"
        }
      ],
      "order": "asc"
    }),
});

const data = await response.json();

import requests

payload = {
  "range": {
    "unit": "block",
    "from": 17240365,
    "to": 17289864
  },
  "options": {
    "offset": 0,
    "limit": 100
  },
  "criteriaSet": [
    {
      "address": "0x0000000000000000000000000000456E65726779",
      "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "topic1": "0x0000000000000000000000006d95e6dca01d109882fe1726a2fb9865fa41e7aa"
    }
  ],
  "order": "asc"
}

response = requests.post('https://vet.nownodes.io/logs/event', json=payload)
data = response.json()

Request Body

{
  "range": {
    "unit": "block",
    "from": 17240365,
    "to": 17289864
  },
  "options": {
    "offset": 0,
    "limit": 100
  },
  "criteriaSet": [
    {
      "address": "0x0000000000000000000000000000456E65726779",
      "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "topic1": "0x0000000000000000000000006d95e6dca01d109882fe1726a2fb9865fa41e7aa"
    }
  ],
  "order": "asc"
}

[
  {
    "address": "0x0000000000000000000000000000456e65726779",
    "topics": [
      "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "0x000000000000000000000000435933c8064b4ae76be665428e0307ef2ccfbd68"
    ],
    "data": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8",
    "meta": {
      "blockID": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
      "blockNumber": 325324,
      "blockTimestamp": 1533267900,
      "txID": "0x284bba50ef777889ff1a367ed0b38d5e5626714477c40de38d71cedd6f9fa477",
      "txOrigin": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d",
      "clauseIndex": 0
    }
  }
]

Invalid request body

Query VET transfer events

POST

https://vet.nownodes.io/logs/transfer

Query VET transfers with a given criteria.

Body

application/json

rangeFilterRange | null

Defines the range for filtering. Setting values to null indicates the entire range.

Note: If omitted or set to null, a timeout may occur if there is a large amount of data to query.

Example:

Copied!

{
  "range": {
    "unit": "block",
    "from": 10,
    "to": 1000
  }
}

This refers to the range from block 10 to block 1000.

Show child attributes

unitstring | nullblocktime

Specifies the unit of measurement for the from and to values. Use block for block numbers or time for block timestamps. Default is block.

frominteger<uint64> | null

Defines the starting block number or timestamp for the specified range.

tointeger<uint64> | null

Specifies the ending block number or timestamp for the specified range.

optionsFilterOptions | null

Include these parameters to receive filtered results in a paged format.

Note: If omitted, a timeout may occur if there is a large amount of data to query. If there is a small amount of data you can omit to receive all results in a single response.

Example:

Copied!

{
  "options": {
    "offset": 0,
    "limit": 10
  }
}

In this example, the page offset is 0, and the page size is 10.

Show child attributes

offsetinteger | null

The offset in the matched record set. Use this parameter for pagination.

Default's to 0.

limitinteger | null

The limit of records to be included in the output. Use this parameter for pagination.

Default's to all results.

criteriaSetArray<TransferCriteria> | null

Show child attributes

txOriginstring | null

The address from which the transaction was sent.

senderstring | null

The address that sent the VET. In most cases this is the same as txOrigin, but it may be different if the VET was sent by a contract.

recipientstring | null

The address that received the VET.

orderstring | nullascdesc

Specifies the order of the results. Use asc for ascending order, and desc for descending order.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Query VET transfer events

curl -X POST 'https://vet.nownodes.io/logs/transfer' \
  -H 'Content-Type: application/json' \
  -d '{
    "range": {
      "unit": "block",
      "from": 17240365,
      "to": 17289864
    },
    "options": {
      "offset": 0,
      "limit": 100
    },
    "criteriaSet": [
      {
        "txOrigin": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
        "sender": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
        "recipient": "0x45429a2255e7248e57fce99e7239aed3f84b7a53"
      }
    ],
    "order": "asc"
  }'

const response = await fetch('https://vet.nownodes.io/logs/transfer', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "range": {
        "unit": "block",
        "from": 17240365,
        "to": 17289864
      },
      "options": {
        "offset": 0,
        "limit": 100
      },
      "criteriaSet": [
        {
          "txOrigin": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
          "sender": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
          "recipient": "0x45429a2255e7248e57fce99e7239aed3f84b7a53"
        }
      ],
      "order": "asc"
    }),
});

const data = await response.json();

import requests

payload = {
  "range": {
    "unit": "block",
    "from": 17240365,
    "to": 17289864
  },
  "options": {
    "offset": 0,
    "limit": 100
  },
  "criteriaSet": [
    {
      "txOrigin": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
      "sender": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
      "recipient": "0x45429a2255e7248e57fce99e7239aed3f84b7a53"
    }
  ],
  "order": "asc"
}

response = requests.post('https://vet.nownodes.io/logs/transfer', json=payload)
data = response.json()

Request Body

{
  "range": {
    "unit": "block",
    "from": 17240365,
    "to": 17289864
  },
  "options": {
    "offset": 0,
    "limit": 100
  },
  "criteriaSet": [
    {
      "txOrigin": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
      "sender": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
      "recipient": "0x45429a2255e7248e57fce99e7239aed3f84b7a53"
    }
  ],
  "order": "asc"
}

[
  {
    "sender": "0x5034aa590125b64023a0262112b98d72e3c8e40e",
    "recipient": "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa",
    "amount": "0x47fdb3c3f456c0000",
    "meta": {
      "blockID": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
      "blockNumber": 325324,
      "blockTimestamp": 1533267900,
      "txID": "0x284bba50ef777889ff1a367ed0b38d5e5626714477c40de38d71cedd6f9fa477",
      "txOrigin": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d",
      "clauseIndex": 0
    }
  }
]

Invalid request body

Node

Retrieve connected peers

GET

https://vet.nownodes.io/node/network/peers

Retrieve information about the peers connected to the node.

Response

200OK

Authorization

api-keyAuthapiKey in header

Retrieve connected peers

curl -X GET 'https://vet.nownodes.io/node/network/peers'

const response = await fetch('https://vet.nownodes.io/node/network/peers', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/node/network/peers')
data = response.json()

200

[
  {
    "name": "thor/v1.0.0-6680b98-dev/linux/go1.10.3",
    "bestBlockID": "0x000087b3a4d4cdf1cc52d56b9704f4c18f020e1b48dbbf4a23d1ee4f1fa5ff94",
    "totalScore": 68497,
    "peerID": "50e122a505ee55b84331068acfd857e37ad58f463a0fab9aaff2c1e4b2e2d22ae71dc14fdaf6eead74bd3f60594644aa35c588f9ca6be3341e2ce18ddc413321",
    "netAddr": "128.1.39.120:11235",
    "inbound": false,
    "duration": 28
  }
]

Subscriptions

(Websocket) Blocks

GET

https://vet.nownodes.io/subscriptions/block

Establish a websocket connection to the node to receive real-time updates on new blocks.

This endpoint can also be used to resume a subscription from a specific point in time.

Example:

Copied!

const ws = new WebSocket('ws://localhost:8669/subscriptions/block')

ws.onmessage = (event) => {
  console.log(event.data)
}

Parameters

posstringquery

A saved block ID for resuming the subscription. If omitted, the best block ID is assumed.

Note: If the provided position is too far behind the best block, a 403 error will be thrown. The allowable difference depends on the configuration of each node.

See the argument api-backtrace-limit when starting a node.

Response

200OK

400Bad Request

Bad Request

403Forbidden

Forbidden

Authorization

api-keyAuthapiKey in header

(Websocket) Blocks

curl -X GET 'https://vet.nownodes.io/subscriptions/block'

const response = await fetch('https://vet.nownodes.io/subscriptions/block', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/subscriptions/block')
data = response.json()

{
  "number": 325324,
  "id": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
  "size": 373,
  "parentID": "0x0004f6cb730dbd90fed09d165bfdf33cc0eed47ec068938f6ee7b7c12a4ea98d",
  "timestamp": 1533267900,
  "gasLimit": 11253579,
  "beneficiary": "0xb4094c25f86d628fdd571afc4077f0d0196afb48",
  "gasUsed": 21000,
  "totalScore": 1029988,
  "txsRoot": "0x89dfd9fcd10c9e53d68592cf8b540b280b72d381b868523223992f3e09a806bb",
  "txsFeatures": 0,
  "stateRoot": "0x86bcc6d214bc9d8d0dedba1012a63c8317d19ce97f60c8a2ef5c59bbd40d4261",
  "receiptsRoot": "0x15787e2533c470e8a688e6cd17a1ee12d8457778d5f82d2c109e2d6226d8e54e",
  "com": true,
  "signer": "0xab7b27fc9e7d29f9f2e5bd361747a5515d0cc2d1",
  "obsolete": false,
  "transactions": [
    [
      "0x284bba50ef777889ff1a367ed0b38d5e5626714477c40de38d71cedd6f9fa477"
    ]
  ]
}

Invalid position

"pos" is out of range

(Websocket) Events

GET

https://vet.nownodes.io/subscriptions/event

Subscribe to events generated by vechain smart contracts. Events are created using the LOG opcode in the Ethereum Virtual Machine (EVM).

Example:

Copied!


// Filter the events by 'Transfer(address,address,uint256)'
const ws = new WebSocket('ws://localhost:8669/subscriptions/event?t0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef')

ws.onmessage = (event) => {
  console.log(event.data)
}

Parameters

posstringquery

A saved block ID for resuming the subscription. If omitted, the best block ID is assumed.

Note: If the provided position is too far behind the best block, a 403 error will be thrown. The allowable difference depends on the configuration of each node.

See the argument api-backtrace-limit when starting a node.

addrstringquery

The address of the contract that emits the event.

t0stringquery

The keccak256 hash representing the event signature. For example, the signature for the Transfer event is keccak256("Transfer(address,address,uint256)").

t1stringquery

Filters events based on the 1st parameter in the event.

Note: The parameter must be padded to 32 bytes.

For example, for the event MySolidityEvent(address,uint256), use t1 to match the address parameter.

t2stringquery

Filters events based on the 2nd parameter in the event.

Note: The parameter must be padded to 32 bytes.

For example, for the event MySolidityEvent(address,uint256), use t2 to match the uint256 parameter.

t3stringquery

Filters events based on the 3rd parameter in the event.

Note: The parameter must be padded to 32 bytes.

For example, for the event MySolidityEvent(address,address,uint256), use t3 to match the uint256 parameter.

Response

200OK

400Bad Request

Bad Request

403Forbidden

Forbidden

Authorization

api-keyAuthapiKey in header

(Websocket) Events

curl -X GET 'https://vet.nownodes.io/subscriptions/event'

const response = await fetch('https://vet.nownodes.io/subscriptions/event', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/subscriptions/event')
data = response.json()

{
  "address": "0x0000000000000000000000000000456e65726779",
  "topics": [
    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
    "0x000000000000000000000000435933c8064b4ae76be665428e0307ef2ccfbd68"
  ],
  "data": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8",
  "obsolete": false,
  "meta": {
    "blockID": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
    "blockNumber": 325324,
    "blockTimestamp": 1533267900,
    "txID": "0x284bba50ef777889ff1a367ed0b38d5e5626714477c40de38d71cedd6f9fa477",
    "txOrigin": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d",
    "clauseIndex": 0
  }
}

Invalid position

"pos" is out of range

(Websocket) Transfers

GET

https://vet.nownodes.io/subscriptions/transfer

Subscribe to VET transfers with a given criteria.

Example:

Copied!

const ws = new WebSocket('ws://localhost:8669/subscriptions/transfer?sender=0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa')

ws.onmessage = (event) => {
  console.log(event.data)
}

Parameters

posstringquery

A saved block ID for resuming the subscription. If omitted, the best block ID is assumed.

Note: If the provided position is too far behind the best block, a 403 error will be thrown. The allowable difference depends on the configuration of each node.

See the argument api-backtrace-limit when starting a node.

txOriginstringquery

The address from which the transaction was sent.

recipientstringquery

The address that received the VET.

senderstringquery

The address that sent the VET. In most cases this is the same as txOrigin, but it may be different if the VET was sent by a contract.

Response

200OK

400Bad Request

Bad Request

403Forbidden

Forbidden

Authorization

api-keyAuthapiKey in header

(Websocket) Transfers

curl -X GET 'https://vet.nownodes.io/subscriptions/transfer'

const response = await fetch('https://vet.nownodes.io/subscriptions/transfer', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/subscriptions/transfer')
data = response.json()

{
  "address": "0x0000000000000000000000000000456e65726779",
  "topics": [
    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
    "0x000000000000000000000000435933c8064b4ae76be665428e0307ef2ccfbd68"
  ],
  "data": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8",
  "obsolete": false,
  "meta": {
    "blockID": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
    "blockNumber": 325324,
    "blockTimestamp": 1533267900,
    "txID": "0x284bba50ef777889ff1a367ed0b38d5e5626714477c40de38d71cedd6f9fa477",
    "txOrigin": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d",
    "clauseIndex": 0
  }
}

Invalid position

"pos" is out of range

(Websocket) Beats

GET

https://vet.nownodes.io/subscriptions/beat2

Establish a websocket connection to receive blockchain beats, which contain a summary of new blocks and bloom filters composited with affected addresses.

Example:

Copied!

const ws = new WebSocket('ws://localhost:8669/subscriptions/beat2')

ws.onmessage = (event) => {
  console.log(event.data)
}

Parameters

posstringquery

A saved block ID for resuming the subscription. If omitted, the best block ID is assumed.

Note: If the provided position is too far behind the best block, a 403 error will be thrown. The allowable difference depends on the configuration of each node.

See the argument api-backtrace-limit when starting a node.

Response

200OK

400Bad Request

Bad Request

403Forbidden

Forbidden

Authorization

api-keyAuthapiKey in header

(Websocket) Beats

curl -X GET 'https://vet.nownodes.io/subscriptions/beat2'

const response = await fetch('https://vet.nownodes.io/subscriptions/beat2', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/subscriptions/beat2')
data = response.json()

{
  "obsolete": false,
  "number": 325324,
  "id": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
  "parentID": "0x0004f6cb730dbd90fed09d165bfdf33cc0eed47ec068938f6ee7b7c12a4ea98d",
  "timestamp": 1533267900,
  "txsFeatures": 0,
  "bloom": "0x0424c1ff47029280",
  "k": 13,
  "gasLimit": 12000000
}

Invalid position

"pos" is out of range

(Websocket) Subscribe to new transactions

GET

https://vet.nownodes.io/subscriptions/txpool

Establish a websocket connection to receive real-time updates on transactions that are pending inclusion in a future block.

Example:

Copied!

const ws = new WebSocket('ws://localhost:8669/subscriptions/txpool')

ws.onmessage = (event) => {
  console.log(event.data)
}

Response

200OK

400Bad Request

Bad Request

403Forbidden

Forbidden

Authorization

api-keyAuthapiKey in header

(Websocket) Subscribe to new transactions

curl -X GET 'https://vet.nownodes.io/subscriptions/txpool'

const response = await fetch('https://vet.nownodes.io/subscriptions/txpool', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/subscriptions/txpool')
data = response.json()

{
  "id": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8"
}

Invalid position

"pos" is out of range

(Websocket) Subscribe to Blockchain Beats

deprecated

GET

https://vet.nownodes.io/subscriptions/beat

Establish a websocket connection to receive blockchain beats, which contain a summary of new blocks and bloom filters composited with affected addresses.

Example:

Copied!

const ws = new WebSocket('ws://localhost:8669/subscriptions/beat')

ws.onmessage = (event) => {
  console.log(event.data)
}

Parameters

posstringquery

A saved block ID for resuming the subscription. If omitted, the best block ID is assumed.

Note: If the provided position is too far behind the best block, a 403 error will be thrown. The allowable difference depends on the configuration of each node.

See the argument api-backtrace-limit when starting a node.

Response

200OK

400Bad Request

Bad Request

403Forbidden

Forbidden

Authorization

api-keyAuthapiKey in header

(Websocket) Subscribe to Blockchain Beats

curl -X GET 'https://vet.nownodes.io/subscriptions/beat'

const response = await fetch('https://vet.nownodes.io/subscriptions/beat', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://vet.nownodes.io/subscriptions/beat')
data = response.json()

{
  "obsolete": false,
  "number": 325324,
  "id": "0x0004f6cc88bb4626a92907718e82f255b8fa511453a78e8797eb8cea3393b215",
  "parentID": "0x0004f6cb730dbd90fed09d165bfdf33cc0eed47ec068938f6ee7b7c12a4ea98d",
  "timestamp": 1533267900,
  "txsFeatures": 0,
  "bloom": "0x0424c1ff47029280",
  "k": 13
}

Invalid position

"pos" is out of range

Debug

Trace a transaction clause

POST

https://vet.nownodes.io/debug/tracers

This endpoint allows you to create a tracer for a specific clause. Tracers are instrumental in monitoring and analyzing the execution flow within the EVM. You can customize the tracer using various options to tailor it to your specific debugging needs.

Body

application/json

namestring | null4bytecallnoopprestateunigrambigramtrigramevmdisopcount

The name of the tracer. An empty name stands for the default struct logger tracer.

configobject | null

The configuration of the tracer. It is specific to the name

targetstring

The unified path of the target to be traced. Currently, only the clause is supported.

Format: blockID/(txIndex|txId)/clauseIndex

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Trace a transaction clause

curl -X POST 'https://vet.nownodes.io/debug/tracers' \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0",
    "name": "prestate",
    "config": {}
  }'

const response = await fetch('https://vet.nownodes.io/debug/tracers', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0",
      "name": "prestate",
      "config": {}
    }),
});

const data = await response.json();

import requests

payload = {
  "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0",
  "name": "prestate",
  "config": {}
}

response = requests.post('https://vet.nownodes.io/debug/tracers', json=payload)
data = response.json()

Request Body

{
  "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0",
  "name": "prestate",
  "config": {}
}

{}

Invalid target

Trace a contract call

POST

https://vet.nownodes.io/debug/tracers/call

This endpoint enables clients to create a tracer for a specific vechain function call.

You can customize the tracer using various options to suit your debugging requirements.

Body

application/json

namestring | null4bytecallnoopprestateunigrambigramtrigramevmdisopcount

The name of the tracer. An empty name stands for the default struct logger tracer.

configobject | null

The configuration of the tracer. It is specific to the name

valuestring

The amount of token to be transferred.

datastring

The input data for the contract call.

tostring | null

The recipient of the call. Null indicates contract deployment.

gasinteger<uint64> | null

The maximum allowed gas for execution.

gasPricestring | null

The absolute gas price.

callerstring | null

The caller's address (msg.sender).

provedWorkstring | null

The transaction's proved work (for extension contract).

gasPayerstring | null

The address of the gas payer (for extension contract).

expirationinteger<uint32> | null

The transaction expiration (for extension contract).

blockRefstring | null

The block reference (for extension contract).

Parameters

headstringquery

Explicitly define the ID of the head block. Best block is assumed if omitted.

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Trace a contract call

curl -X POST 'https://vet.nownodes.io/debug/tracers/call' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "0x0",
    "to": "0x0000000000000000000000000000456E65726779",
    "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000",
    "gas": 50000,
    "gasPrice": "1000000000000000",
    "caller": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
    "provedWork": "1000",
    "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
    "expiration": 1000,
    "blockRef": "0x00000000851caf3c"
  }'

const response = await fetch('https://vet.nownodes.io/debug/tracers/call', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "0x0",
      "to": "0x0000000000000000000000000000456E65726779",
      "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000",
      "gas": 50000,
      "gasPrice": "1000000000000000",
      "caller": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
      "provedWork": "1000",
      "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
      "expiration": 1000,
      "blockRef": "0x00000000851caf3c"
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "0x0",
  "to": "0x0000000000000000000000000000456E65726779",
  "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000",
  "gas": 50000,
  "gasPrice": "1000000000000000",
  "caller": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
  "provedWork": "1000",
  "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
  "expiration": 1000,
  "blockRef": "0x00000000851caf3c"
}

response = requests.post('https://vet.nownodes.io/debug/tracers/call', json=payload)
data = response.json()

Request Body

{
  "value": "0x0",
  "to": "0x0000000000000000000000000000456E65726779",
  "data": "0xa9059cbb0000000000000000000000000f872421dc479f3c11edd89512731814d0598db50000000000",
  "gas": 50000,
  "gasPrice": "1000000000000000",
  "caller": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
  "provedWork": "1000",
  "gasPayer": "0xd3ae78222beadb038203be21ed5ce7c9b1bff602",
  "expiration": 1000,
  "blockRef": "0x00000000851caf3c"
}

{}

Invalid request body

Retrieve storage range

POST

https://vet.nownodes.io/debug/storage-range

The endpoint retrieves storage entries related to a particular clause execution and contract address. This could be useful for inspecting or analyzing storage changes.

Body

application/json

addressstring

The address of the contract/ account to be traced.

keyStartstring | null

The start key of the storage range. Default is 0x0000000000000000000000000000000000000000000000000000000000000000

maxResultnumber | null

The maximum number of results to be returned. Default is 1000.

targetstring

The unified path of the transaction clause.

Format: blockID/(txIndex|txId)/clauseIndex

Response

200OK

400Bad Request

Bad Request

Authorization

api-keyAuthapiKey in header

Retrieve storage range

curl -X POST 'https://vet.nownodes.io/debug/storage-range' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "0xd8ccdd85abdbf68dfec95f06c973e87b1b5a9997",
    "keyStart": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "maxResult": 10,
    "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0"
  }'

const response = await fetch('https://vet.nownodes.io/debug/storage-range', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "0xd8ccdd85abdbf68dfec95f06c973e87b1b5a9997",
      "keyStart": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "maxResult": 10,
      "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0"
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "0xd8ccdd85abdbf68dfec95f06c973e87b1b5a9997",
  "keyStart": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "maxResult": 10,
  "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0"
}

response = requests.post('https://vet.nownodes.io/debug/storage-range', json=payload)
data = response.json()

Request Body

{
  "address": "0xd8ccdd85abdbf68dfec95f06c973e87b1b5a9997",
  "keyStart": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "maxResult": 10,
  "target": "0x010709463c1f0c9aa66a31182fb36d1977d99bfb6526bae0564a0eac4006c31a/0/0"
}

{
  "nextKey": null,
  "storage": {
    "0x33e423980c9b37d048bd5fadbd4a2aeb95146922045405accc2f468d0ef96988": {
      "key": "0x0000000000000000000000000000000000000000000000000000000000000001",
      "value": "0x00000000000000000000000000000000000000000000000000000000000000c8"
    }
  }
}

Invalid address

Documentation

Authentication

General

Accounts

Parameters

Response

Authorization

Body

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Transactions

Parameters

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

Blocks

Parameters

Response

Authorization

Logs

Body

Response

Authorization

Body

Response

Authorization

Node

Response

Authorization

Subscriptions

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Debug

Body

Response

Authorization

Body

Parameters

Response

Authorization

Body

Response

Authorization