Simulate Transaction on Environment Virtual Environment

curl --request POST \
  --url https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <api-key>' \
  --data '
{
  "callArgs": {
    "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "gas": "0x7a1200",
    "gasPrice": "0x0",
    "value": "0x0",
    "data": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b"
  },
  "blockNumber": "0x124214",
  "blockOverrides": {
    "number": "0x124214",
    "time": "0x124124"
  },
  "stateOverrides": {
    "0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF": {
      "balance": "0x124125"
    }
  }
}
'

import requests

url = "https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate"

payload = {
    "callArgs": {
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x7a1200",
        "gasPrice": "0x0",
        "value": "0x0",
        "data": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b"
    },
    "blockNumber": "0x124214",
    "blockOverrides": {
        "number": "0x124214",
        "time": "0x124124"
    },
    "stateOverrides": { "0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF": { "balance": "0x124125" } }
}
headers = {
    "X-Access-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Access-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    callArgs: {
      from: '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
      to: '0x6b175474e89094c44da98b954eedeac495271d0f',
      gas: '0x7a1200',
      gasPrice: '0x0',
      value: '0x0',
      data: '0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b'
    },
    blockNumber: '0x124214',
    blockOverrides: {number: '0x124214', time: '0x124124'},
    stateOverrides: {'0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF': {balance: '0x124125'}}
  })
};

fetch('https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'callArgs' => [
        'from' => '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
        'to' => '0x6b175474e89094c44da98b954eedeac495271d0f',
        'gas' => '0x7a1200',
        'gasPrice' => '0x0',
        'value' => '0x0',
        'data' => '0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b'
    ],
    'blockNumber' => '0x124214',
    'blockOverrides' => [
        'number' => '0x124214',
        'time' => '0x124124'
    ],
    'stateOverrides' => [
        '0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF' => [
                'balance' => '0x124125'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Access-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate"

	payload := strings.NewReader("{\n  \"callArgs\": {\n    \"from\": \"0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2\",\n    \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"gas\": \"0x7a1200\",\n    \"gasPrice\": \"0x0\",\n    \"value\": \"0x0\",\n    \"data\": \"0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b\"\n  },\n  \"blockNumber\": \"0x124214\",\n  \"blockOverrides\": {\n    \"number\": \"0x124214\",\n    \"time\": \"0x124124\"\n  },\n  \"stateOverrides\": {\n    \"0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF\": {\n      \"balance\": \"0x124125\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Access-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate")
  .header("X-Access-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"callArgs\": {\n    \"from\": \"0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2\",\n    \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"gas\": \"0x7a1200\",\n    \"gasPrice\": \"0x0\",\n    \"value\": \"0x0\",\n    \"data\": \"0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b\"\n  },\n  \"blockNumber\": \"0x124214\",\n  \"blockOverrides\": {\n    \"number\": \"0x124214\",\n    \"time\": \"0x124124\"\n  },\n  \"stateOverrides\": {\n    \"0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF\": {\n      \"balance\": \"0x124125\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Access-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"callArgs\": {\n    \"from\": \"0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2\",\n    \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"gas\": \"0x7a1200\",\n    \"gasPrice\": \"0x0\",\n    \"value\": \"0x0\",\n    \"data\": \"0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b\"\n  },\n  \"blockNumber\": \"0x124214\",\n  \"blockOverrides\": {\n    \"number\": \"0x124214\",\n    \"time\": \"0x124124\"\n  },\n  \"stateOverrides\": {\n    \"0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF\": {\n      \"balance\": \"0x124125\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "blockNumber": "0xfc497b",
  "cumulativeGasUsed": "0x10",
  "gasUsed": "0xb412",
  "status": true,
  "type": "0x0",
  "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "metadata": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "logs": [
    {
      "name": "Transfer",
      "anonymous": false,
      "raw": {
        "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x000000000000000000000000fa78a211f7df670338daed1f96177c9fe154fcb1",
          "0x0000000000000000000000006c8b8870c415f3b2d5fe0cd61e9c6960bad8e0c9"
        ]
      },
      "inputs": [
        {
          "name": "from",
          "type": "address",
          "value": "<unknown>",
          "indexed": true
        }
      ]
    }
  ],
  "trace": [
    {
      "from": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "balance": "0x0",
      "gas": "0x6f18c5",
      "gasUsed": "0x6da1",
      "input": "0xa9059cbb000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f10000000000000000000000000000000000000000000000000de0b6b3a7640000",
      "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
      "method": "transfer",
      "error": "Revert",
      "errorReason": "ERC20: transfer amount exceeds balance",
      "refundAddress": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "subtraces": 1,
      "type": "CALL",
      "value": "0x0",
      "traceAddress": [
        0
      ],
      "decodedInput": [
        {
          "name": "recipient",
          "type": "address",
          "value": "<unknown>",
          "indexed": false
        }
      ],
      "decodedOutput": [
        {
          "name": "<string>",
          "type": "bool",
          "value": "<unknown>",
          "indexed": false
        }
      ]
    }
  ],
  "assetChanges": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "Transfer",
      "from": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "to": "0x6c8b8870c415f3b2d5fe0cd61e9c6960bad8e0c9",
      "amount": "1.0",
      "rawAmount": "1000000000000000000",
      "dollarValue": "2500.00",
      "assetInfo": {
        "contractAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "name": "Dai Stablecoin",
        "symbol": "DAI",
        "decimals": 18,
        "logo": "https://assets.tenderly.co/tokens/dai.png",
        "dollarValue": "1.00",
        "standard": "ERC20",
        "type": "Fungible"
      }
    }
  ],
  "balanceChanges": [
    {
      "address": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "dollarValue": "-0.05"
    }
  ],
  "exposureChanges": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "type": "Approve",
      "owner": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "spender": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
      "amount": "unlimited",
      "rawAmount": "115792089237316195423570985008687907853269984665640564039457584007913129639935",
      "dollarValue": "unlimited",
      "assetInfo": {
        "contractAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "name": "Dai Stablecoin",
        "symbol": "DAI",
        "decimals": 18,
        "logo": "https://assets.tenderly.co/tokens/dai.png",
        "dollarValue": "1.00",
        "standard": "ERC20",
        "type": "Fungible"
      }
    }
  ],
  "stateChanges": [
    {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "balance": {
        "previousValue": "0x16345785d8a0000",
        "newValue": "0x1bc16d674ec80000"
      },
      "nonce": {
        "previousValue": "0x5",
        "newValue": "0x6"
      },
      "storage": [
        {
          "slot": "0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3",
          "previousValue": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
          "newValue": "0x0000000000000000000000000000000000000000000000001bc16d674ec80000"
        }
      ]
    }
  ],
  "interopInfo": {
    "chainId": "10",
    "relayError": "relay failed: insufficient gas",
    "transactionAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "bad_request",
    "message": "Bad request input parameters"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "unauthorized",
    "message": "Unauthorized"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "insufficient_permissions",
    "message": "Insufficient permissions"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "resource_not_found",
    "message": "The resource you requested could not be found."
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "internal_server_error",
    "message": "Internal server error"
  }
}

POST

public

account

{accountSlug}

project

{projectSlug}

environments

{environmentId}

instance

{instanceId}

vnet

{vnetId}

transactions

simulate

Simulate Transaction on Environment Virtual Environment

curl --request POST \
  --url https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <api-key>' \
  --data '
{
  "callArgs": {
    "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "gas": "0x7a1200",
    "gasPrice": "0x0",
    "value": "0x0",
    "data": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b"
  },
  "blockNumber": "0x124214",
  "blockOverrides": {
    "number": "0x124214",
    "time": "0x124124"
  },
  "stateOverrides": {
    "0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF": {
      "balance": "0x124125"
    }
  }
}
'

import requests

url = "https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate"

payload = {
    "callArgs": {
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x7a1200",
        "gasPrice": "0x0",
        "value": "0x0",
        "data": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b"
    },
    "blockNumber": "0x124214",
    "blockOverrides": {
        "number": "0x124214",
        "time": "0x124124"
    },
    "stateOverrides": { "0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF": { "balance": "0x124125" } }
}
headers = {
    "X-Access-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Access-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    callArgs: {
      from: '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
      to: '0x6b175474e89094c44da98b954eedeac495271d0f',
      gas: '0x7a1200',
      gasPrice: '0x0',
      value: '0x0',
      data: '0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b'
    },
    blockNumber: '0x124214',
    blockOverrides: {number: '0x124214', time: '0x124124'},
    stateOverrides: {'0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF': {balance: '0x124125'}}
  })
};

fetch('https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'callArgs' => [
        'from' => '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
        'to' => '0x6b175474e89094c44da98b954eedeac495271d0f',
        'gas' => '0x7a1200',
        'gasPrice' => '0x0',
        'value' => '0x0',
        'data' => '0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b'
    ],
    'blockNumber' => '0x124214',
    'blockOverrides' => [
        'number' => '0x124214',
        'time' => '0x124124'
    ],
    'stateOverrides' => [
        '0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF' => [
                'balance' => '0x124125'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Access-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate"

	payload := strings.NewReader("{\n  \"callArgs\": {\n    \"from\": \"0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2\",\n    \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"gas\": \"0x7a1200\",\n    \"gasPrice\": \"0x0\",\n    \"value\": \"0x0\",\n    \"data\": \"0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b\"\n  },\n  \"blockNumber\": \"0x124214\",\n  \"blockOverrides\": {\n    \"number\": \"0x124214\",\n    \"time\": \"0x124124\"\n  },\n  \"stateOverrides\": {\n    \"0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF\": {\n      \"balance\": \"0x124125\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Access-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate")
  .header("X-Access-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"callArgs\": {\n    \"from\": \"0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2\",\n    \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"gas\": \"0x7a1200\",\n    \"gasPrice\": \"0x0\",\n    \"value\": \"0x0\",\n    \"data\": \"0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b\"\n  },\n  \"blockNumber\": \"0x124214\",\n  \"blockOverrides\": {\n    \"number\": \"0x124214\",\n    \"time\": \"0x124124\"\n  },\n  \"stateOverrides\": {\n    \"0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF\": {\n      \"balance\": \"0x124125\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}/environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Access-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"callArgs\": {\n    \"from\": \"0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2\",\n    \"to\": \"0x6b175474e89094c44da98b954eedeac495271d0f\",\n    \"gas\": \"0x7a1200\",\n    \"gasPrice\": \"0x0\",\n    \"value\": \"0x0\",\n    \"data\": \"0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b\"\n  },\n  \"blockNumber\": \"0x124214\",\n  \"blockOverrides\": {\n    \"number\": \"0x124214\",\n    \"time\": \"0x124124\"\n  },\n  \"stateOverrides\": {\n    \"0x3F41a1CFd3C8B8d9c162dE0f42307a0095A6e5DF\": {\n      \"balance\": \"0x124125\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "blockNumber": "0xfc497b",
  "cumulativeGasUsed": "0x10",
  "gasUsed": "0xb412",
  "status": true,
  "type": "0x0",
  "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "metadata": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "logs": [
    {
      "name": "Transfer",
      "anonymous": false,
      "raw": {
        "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x000000000000000000000000fa78a211f7df670338daed1f96177c9fe154fcb1",
          "0x0000000000000000000000006c8b8870c415f3b2d5fe0cd61e9c6960bad8e0c9"
        ]
      },
      "inputs": [
        {
          "name": "from",
          "type": "address",
          "value": "<unknown>",
          "indexed": true
        }
      ]
    }
  ],
  "trace": [
    {
      "from": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "balance": "0x0",
      "gas": "0x6f18c5",
      "gasUsed": "0x6da1",
      "input": "0xa9059cbb000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f10000000000000000000000000000000000000000000000000de0b6b3a7640000",
      "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
      "method": "transfer",
      "error": "Revert",
      "errorReason": "ERC20: transfer amount exceeds balance",
      "refundAddress": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "subtraces": 1,
      "type": "CALL",
      "value": "0x0",
      "traceAddress": [
        0
      ],
      "decodedInput": [
        {
          "name": "recipient",
          "type": "address",
          "value": "<unknown>",
          "indexed": false
        }
      ],
      "decodedOutput": [
        {
          "name": "<string>",
          "type": "bool",
          "value": "<unknown>",
          "indexed": false
        }
      ]
    }
  ],
  "assetChanges": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "Transfer",
      "from": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "to": "0x6c8b8870c415f3b2d5fe0cd61e9c6960bad8e0c9",
      "amount": "1.0",
      "rawAmount": "1000000000000000000",
      "dollarValue": "2500.00",
      "assetInfo": {
        "contractAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "name": "Dai Stablecoin",
        "symbol": "DAI",
        "decimals": 18,
        "logo": "https://assets.tenderly.co/tokens/dai.png",
        "dollarValue": "1.00",
        "standard": "ERC20",
        "type": "Fungible"
      }
    }
  ],
  "balanceChanges": [
    {
      "address": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "dollarValue": "-0.05"
    }
  ],
  "exposureChanges": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "type": "Approve",
      "owner": "0xfa78a211f7df670338daed1f96177c9fe154fcb1",
      "spender": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
      "amount": "unlimited",
      "rawAmount": "115792089237316195423570985008687907853269984665640564039457584007913129639935",
      "dollarValue": "unlimited",
      "assetInfo": {
        "contractAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "name": "Dai Stablecoin",
        "symbol": "DAI",
        "decimals": 18,
        "logo": "https://assets.tenderly.co/tokens/dai.png",
        "dollarValue": "1.00",
        "standard": "ERC20",
        "type": "Fungible"
      }
    }
  ],
  "stateChanges": [
    {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "balance": {
        "previousValue": "0x16345785d8a0000",
        "newValue": "0x1bc16d674ec80000"
      },
      "nonce": {
        "previousValue": "0x5",
        "newValue": "0x6"
      },
      "storage": [
        {
          "slot": "0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3",
          "previousValue": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
          "newValue": "0x0000000000000000000000000000000000000000000000001bc16d674ec80000"
        }
      ]
    }
  ],
  "interopInfo": {
    "chainId": "10",
    "relayError": "relay failed: insufficient gas",
    "transactionAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "bad_request",
    "message": "Bad request input parameters"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "unauthorized",
    "message": "Unauthorized"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "insufficient_permissions",
    "message": "Insufficient permissions"
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "resource_not_found",
    "message": "The resource you requested could not be found."
  }
}

{
  "error": {
    "id": "596b1dc7-af60-477b-aab3-6c93eb92ddfa",
    "slug": "internal_server_error",
    "message": "Internal server error"
  }
}

Authorizations

X-Access-Key

string

header

required

An API key is a token that a client provides when making API calls. Send it as the X-Access-Key request header on any endpoint:

curl '<API_ENDPOINT>' \
  -H 'X-Access-Key: ${TENDERLY_ACCESS_KEY}' \
  ...

Learn how to generate API access tokens at Tenderly Docs.

Path Parameters

accountSlug

string

required

Account ID or slug

projectSlug

string

required

Project ID or slug

environmentId

string<uuid>

required

Environment ID

instanceId

string<uuid>

required

Environment instance ID

vnetId

string<uuid>

required

Virtual Environment ID

Body

application/json

Simulation parameters

callArgs

callArgs · object

Transaction call arguments

Show child attributes

blockNumber

string

Block number on which the transaction is simulated (hex-encoded)

Example:

"0x151924A"

blockOverrides

blockOverrides · object

Overrides for block data

Show child attributes

Example:

{ "number": "0x124214", "time": "0x124124" }

stateOverrides

stateOverrides · object

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

Show child attributes

Response

A successful response.

Result of simulating a transaction on an environment Virtual Environment

blockNumber

string

Block number on which the simulation was executed (hex-encoded)

Example:

"0xfc497b"

cumulativeGasUsed

string

Cumulative gas used up to and including this transaction in the block (hex-encoded)

Example:

"0x10"

gasUsed

string

Gas consumed by this transaction (hex-encoded)

Example:

"0xb412"

status

boolean

Whether the simulated transaction succeeded

Example:

true

type

string

Transaction type (hex-encoded)

Example:

"0x0"

logsBloom

string

Bloom filter of all logs emitted during simulation (hex-encoded)

Example:

"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"

metadata

metadata · object

Simulation metadata

Show child attributes

logs

decodedLog · object[]

ABI-decoded logs emitted during simulation

Show child attributes

trace

traceResponse · object[]

Execution trace call tree

Show child attributes

assetChanges

assetChange · object[]

Token transfers that occurred during simulation

Show child attributes

balanceChanges

balanceChange · object[]

Native ETH balance changes during simulation

Show child attributes

exposureChanges

exposureChange · object[]

Token approval and allowance changes during simulation

Show child attributes

stateChanges

stateChange · object[]

Account and storage state changes during simulation

Show child attributes

interopInfo

interopInfo · object | null

Cross-chain interoperability information (only present for cross-chain simulations)

Show child attributes

Send Transaction on Environment Virtual Environment Delete Alert

⌘I

Simulator

Virtual Environments

Alerts

Actions

Delivery Channels

Contracts

Wallets

Other

Simulate Transaction on Environment Virtual Environment

Authorizations

Path Parameters

Body

Response