/

Inspect clauses

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.

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

Query parameters

Body

application/json

provedWorknullable string

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

Example: "1000"

gasPayernullable string

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

Example: "0xd3ae78222beadb038203be21ed5ce7c9b1bff602"

expirationnullable integer (uint32)

The transaction expiration (for extension contract).

Example: 1000

blockRefnullable string

The block reference (for extension contract).

Example: "0x00000000851caf3c"

clausesnullable array of Clause

An array of clauses to be executed.

gasnullable integer (uint64)

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

Example: 50000

gasPricenullable string

The absolute gas price for the batch call.

Example: 1000000000000000

callernullable string

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

Example: "0x6d95e6dca01d109882fe1726a2fb9865fa41e7aa"

Response

200400

OK

Body

application/json

datastring

The output data produced by the contract execution.

Example: "0x0000000000000000000000000000000000000000000000000000000000000001"

eventsarray of Event

An array of events generated during contract execution.

transfersarray of Transfer

An array of transfers that occurred during contract execution.

gasUsedinteger (uint64)

The amount of gas used during execution.

Example: 21000

revertedboolean

Indicates whether the transaction was reverted (true means reverted).

Example: false

vmErrorstring

The virtual machine error message if the execution encountered an error.

Example: "insufficient balance for transfer"

Request

JavaScriptCurlPython

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();

Response

200400

[
  {
    "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": ""
  }
]