Sign in

v2

latestOpenAPI 3.1.0Apache 2.02026-07-31441011.7 MB
Virtual Environments

Send Transaction on Environment Virtual Environment

Send a transaction to be executed on a specific Virtual Environment within an environment instance

post/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions

Path parameters

accountSlugstring required

Account ID or slug

projectSlugstring required

Project ID or slug

environmentIdstring uuid required

Environment ID

instanceIdstring uuid required

Environment instance ID

vnetIdstring uuid required

Virtual Environment ID

Request body

stateOverridesStateOverrideVnet

Overrides of account state. In this mapping, the key is the address of the account, and the value contains the override.

Example request

{
  "callArgs": {
    "from": "0xb5f45E52649123117C175B2016Ed3fCd26f9bE06",
    "to": "0xe5f48e692e0e12c04d5c15bbb54e8a8e5fc87589",
    "gas": "0x7a1200",
    "gasPrice": "0x0",
    "value": "0x0",
    "data": "0x6a761202000000000000000000000000b4f1737af37711e9a5890d9510c9bb60e170cb0d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001c00000000000000000000000000000000000000000000000000000000000000044a9059cbb000000000000000000000000d385a69be7506be3920e2d66611db370218839980000000000000000000000000000000000000000000000000de0b6b3a7640000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041000000000000000000000000b5f45e52649123117c175b2016ed3fcd26f9be0600000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000"
  },
  "stateOverrides": {
    "0xe5f48e692e0e12c04d5c15bbb54e8a8e5fc87589": {
      "balance": "0x124125",
      "stateDiff": {
        "0x0000000000000000000000000000000000000000000000000000000000000004": "0x0000000000000000000000000000000000000000000000000000000000000001",
        "0x0000000000000000000000000000000000000000000000000000000000000005": "0x0000000000000000000000000000000000000000000000000000000000000002"
      }
    }
  },
  "blockOverrides": {
    "number": "0x143722873",
    "time": "0x124124"
  }
}

Response

A successful response.

idstring

Unique identifier of the transaction.

vnet_idstring

Identifier of the Virtual Environment.

origin'rpc' | 'copy' | 'api' | 'system' | 'dashboard' | 'cli' | 'sdk'

Origin of the transaction.

category'write' | 'read' | 'compute' | 'subscribe' | 'config' | 'chain_sync'

Category of the transaction.

kind'simulation' | 'blockchain' | 'fixture' | 'cheatcode' | 'cheatcode_faucet' | 'internal' | 'sync' | 'chain_sync'

Kind of transaction.

status'success' | 'failed' | 'pending' | 'unknown'

Status of the transaction.

error_reasonstring nullable

Reason for the error. Null if no error.

revertedboolean

True if the transaction was reverted using evm_revert rpc method.

rpc_methodstring

RPC method used to create the transaction.

created_atstring date-time

Timestamp when the transaction was created.

dashboard_urlstring

URL to the transaction in the Tenderly dashboard.

public_explorer_urlstring

URL to the transaction in the public explorer. Only present if public explorer page is enabled.

block_numberstring

Block number of the transaction.

block_hashstring

Hash of the block containing the transaction.

tx_hashstring

Hash of the transaction.

tx_indexstring

Index of the transaction within the block.

fromstring

Sender address of the transaction.

tostring

Receiver address of the transaction.

inputstring

Input data of the transaction.

noncestring

Nonce of the transaction.

valuestring

Value of the transaction.

gasstring

Gas of the transaction.

gas_pricestring

Gas price of the transaction.

max_priority_fee_per_gasstring

Maximum priority fee per gas of the transaction.

max_fee_per_gasstring

Maximum fee per gas of the transaction.

typestring

Type of the transaction.

function_namestring

Name of the function invoked by the transaction.

Example response

{
  "id": "a3235752-0f5a-4d32-8e43-e7629a9f7462",
  "vnet_id": "d6cf4c06-24c3-4841-9a85-e77ed341d8e2",
  "origin": "rpc",
  "category": "write",
  "kind": "cheatcode",
  "status": "success",
  "error_reason": null,
  "reverted": false,
  "rpc_method": "hardhat_mine",
  "created_at": "2024-04-19T12:21:48.373698Z",
  "dashboard_url": "https://dashboard.tenderly.co/transactions/a3235752-0f5a-4d32-8e43-e7629a9f7462",
  "block_number": "0x12c5113",
  "block_hash": "0xe28d8b295d236f85db34dc12982f5235e361101a26cf35f4be798fb000997194",
  "tx_hash": "0x0288ab91522c19cd1589eb73b86f4b874c52ed39cdce1ba7cef790f314c4523f",
  "tx_index": "0x0",
  "from": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
  "to": "0x6c8b8870c415f3b2d5fe0cd61e9c6960bad8e0c9",
  "input": "0x071e9503000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000a",
  "nonce": "0x15",
  "value": "0x0",
  "gas": "0xc0dec0de",
  "gas_price": "0x0",
  "max_priority_fee_per_gas": "0x0",
  "max_fee_per_gas": "0x0",
  "type": "0x0",
  "function_name": "mint"
}