Одиночные симуляции

Tenderly поддерживает симуляции одиночных транзакций через RPC и API. По умолчанию симуляции выполняются на актуальном состоянии выбранной сети. Simulation API также позволяет закрепить исторический блок и позицию внутри него (см. Номер блока и индекс транзакции). Dapp’ы и кошельки могут использовать одиночные симуляции, чтобы дать пользователям возможность выполнить сухой прогон транзакций перед тем, как рисковать реальными активами. Это даёт им предпросмотр выполнения транзакции вместе с подробными изменениями балансов и активов. Предпросмотр транзакций может помочь пользователям укрепить доверие к dapp’ам, одобрять только успешные транзакции и предотвращать дорогостоящие сбои.

Симуляция через RPC

Node RPC позволяет читать данные из блокчейна и отправлять транзакции. Но вы также можете симулировать транзакции в Node. Преимущество симуляции через RPC заключается в том, что вы можете выполнять все эти операции через один RPC URL.

Симуляции через RPC или API доступны только в поддерживаемых сетях. Ознакомьтесь со списком поддерживаемых сетей.

Получите RPC URL и ключ доступа из Dashboard. Перейдите в Node > Copy HTTPS URL нужной вам сети.

example

https://mainnet.gateway.tenderly.co/$TENDERLY_NODE_ACCESS_KEY

Чтобы симулировать одиночную транзакцию через RPC, вызовите метод tenderly_simulateTransaction. См. справочник RPC. Пример

request
response.json

request

curl https://mainnet.gateway.tenderly.co/$TENDERLY_NODE_ACCESS_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d \
  '{
    "id": 0,
    "jsonrpc": "2.0",
    "method": "tenderly_simulateTransaction",
    "params": [
      {
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x7a1200",
        "value": "0x0",
        "data": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b"
      },
      "0xfc497b"
    ]
  }'

response.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "status": true,
    "gasUsed": "0xb412",
    "cumulativeGasUsed": "0xb412",
    "blockNumber": "0xfc497b",
    "type": "0x0",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000028000000000000000002000000000000000000000010000000000000000004000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000010000000000000000000000000040000000000000000000000000000800000",
    "logs": [
      {
        "name": "Approval",
        "anonymous": false,
        "inputs": [
          {
            "value": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
            "type": "address",
            "name": "src",
            "indexed": true
          },
          {
            "value": "0xf1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1",
            "type": "address",
            "name": "guy",
            "indexed": true
          },
          {
            "value": "299",
            "type": "uint256",
            "name": "wad",
            "indexed": false
          }
        ],
        "raw": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "topics": [
            "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
            "0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
            "0x000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1"
          ],
          "data": "0x000000000000000000000000000000000000000000000000000000000000012b"
        }
      }
    ],
    "trace": [
      {
        "type": "CALL",
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x79bdb0",
        "gasUsed": "0x5fc2",
        "value": "0x0",
        "input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
        "decodedInput": [
          {
            "value": "0xf1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1",
            "type": "address",
            "name": "usr",
            "indexed": false
          },
          {
            "value": "299",
            "type": "uint256",
            "name": "wad",
            "indexed": false
          }
        ],
        "method": "approve",
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
        "decodedOutput": [
          {
            "value": true,
            "type": "bool",
            "indexed": false
          }
        ],
        "subtraces": 0,
        "traceAddress": []
      }
    ],
    "exposureChanges": [
      {
        "assetInfo": {
          "standard": "ERC20",
          "type": "Fungible",
          "contractAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "symbol": "dai",
          "name": "Dai",
          "logo": "https://coin-images.coingecko.com/coins/images/9956/large/Badge_Dai.png?1696509996",
          "decimals": 18,
          "dollarValue": "1"
        },
        "type": "Approve",
        "owner": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "spender": "0xf1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1",
        "rawAmount": "0x12b",
        "amount": "0.000000000000000299",
        "dollarValue": "0.000000000000000299"
      }
    ],
    "stateChanges": [
      {
        "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "storage": [
          {
            "slot": "0x6f18ad69436c83a0d8b2c05ee70fa64e30403b1755cc38ee9cb6245926b14b17",
            "previousValue": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "newValue": "0x000000000000000000000000000000000000000000000000000000000000012b"
          }
        ]
      },
      {
        "address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "nonce": {
          "previousValue": "0x0",
          "newValue": "0x1"
        }
      }
    ]
  }
}

Симуляция через API

Используйте эндпоинт simulate API, чтобы симулировать одну транзакцию с разными параметрами.

Для использования симуляций в виртуальных окружениях мы рекомендуем Simulate RPC и Bundle Simulate RPC. Иначе можно использовать Simulation API виртуальных окружений.

URL должен содержать ваш account slug и project slug. Следуйте этому краткому руководству, чтобы найти slug’и.

Simulation API endpoint on public network

https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulate

Simulation API endpoint on a Virtual Environment

https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/vnets/{vnetId}/transactions/simulate

Вам также необходимо получить токен доступа API, который отправляется в заголовках. Узнайте, как сгенерировать ключ доступа API здесь.

Тело запроса

Отправьте POST-запрос на эндпоинт API. Полные сведения о теле запроса см. в Справочнике API. Симулируемое тело запроса похоже на JSON-RPC вызов eth_call. Следующие поля обязательны:

network_id (string): ID сети, в которой вы хотите запустить симуляцию.
to (string): адрес получателя транзакции.
from (string): адрес, инициирующий транзакцию.
input (string): закодированные данные вызова метода контракта.
gas (number): количество газа, предоставленного для симуляции.

Вы можете указать любой адрес отправителя в поле from. Поскольку Tenderly симулирует неподписанные транзакции, вам не нужно владеть приватным ключом аккаунта, чтобы симулировать транзакции от имени конкретного отправителя.

Вы также можете указать simulation_type, который может принимать значения full, quick или ABI. Это поле необязательно, поскольку по умолчанию установлено full. Узнайте больше о режимах симуляции.

Номер блока и индекс транзакции

block_number и transaction_index определяют состояние, на котором выполняется транзакция. Оба поля необязательны и принимают целые числа.

Поле	Значение	Состояние, на котором выполняется транзакция
`block_number`	не указано или `null`	Ожидающий (pending) блок: последнее состояние, доступное бэкенду симуляций.
`block_number`	`N` (0 и больше)	Блок `N`. `0` соответствует genesis-блоку.
`block_number`	отрицательное	Относительно головы цепочки: `-1` означает блок перед последним, `-2` два блока назад. Значение вне диапазона цепочки возвращает `UnknownBlockNumber`.
`transaction_index`	`0` (по умолчанию)	Начало блока `N`, до любой из его транзакций. Равно состоянию после блока `N-1`.
`transaction_index`	от `1` до `count-1`	После выполнения транзакций блока с `0` по `index-1`, на месте транзакции с этим индексом.
`transaction_index`	`count` (число транзакций в блоке)	После всех транзакций блока `N`, то есть состояние после блока.

Правила валидации:

block_number является целым числом. Теги блока, такие как "latest" или "pending", отклоняются с ошибкой 400 Bad request input parameters.
transaction_index требует явного block_number. Если блок не указан, ненулевой индекс отклоняется с ошибкой 400 Transaction index is not allowed when block number is pending.
Индекс больше числа транзакций в блоке завершается ошибкой transaction index too high: invalid transaction simulation. Индекс не ограничивается автоматически, и ключевого слова для конца блока не существует.

Чтобы симулировать на состоянии после самого последнего блока, сначала прочитайте блок и передайте число его транзакций как индекс:

состояние после последнего блока

const block = await provider.send("eth_getBlockByNumber", ["latest", false]);

const payload = {
  network_id: "1",
  from: "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
  to: "0x6b175474e89094c44da98b954eedeac495271d0f",
  input: "0x18160ddd",
  block_number: parseInt(block.number, 16),
  transaction_index: block.transactions.length,
};

Те же поля использует элемент управления Tx Index в Simulator UI: At start of block соответствует индексу 0, At tx выбранному индексу, а At end of block числу транзакций блока. При выполнении запросов к API добавьте заголовок X-Access-Key, значение которого — токен доступа. Пример Обязательно храните ключ доступа безопасно в файле .env.

request.ts
response.json

request.ts

dotenv.config();

const simulateTransaction = async () => {
  const { TENDERLY_ACCOUNT_SLUG, TENDERLY_PROJECT_SLUG, TENDERLY_ACCESS_KEY } = process.env;

  const simulation = await axios.post(
    `https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulate`,
    {
      network_id: '1',
      block_number: 16533883,
      from: '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
      to: '0x6b175474e89094c44da98b954eedeac495271d0f',
      gas: 8000000,
      gas_price: 0,
      value: 0,
      input: '0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b',
      simulation_type: 'quick',
    },
    {
      headers: {
        'X-Access-Key': TENDERLY_ACCESS_KEY as string,
      },
    },
  );

  console.log(simulation.data);
};

simulateTransaction();

response.json

{
  "transaction": {
    "hash": "0x7c1a33fb449b8d4eb5ec042d94d1c7ce2a5acae05f02af58ce4fd8b5c6beaf0a",
    "block_hash": "",
    "block_number": 16533883,
    "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
    "gas": 8000000,
    "gas_price": 0,
    "gas_fee_cap": 0,
    "gas_tip_cap": 0,
    "cumulative_gas_used": 0,
    "gas_used": 46098,
    "effective_gas_price": 0,
    "input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
    "nonce": 0,
    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "index": 0,
    "value": "0x",
    "access_list": null,
    "status": true,
    "addresses": null,
    "contract_ids": null,
    "network_id": "1",
    "timestamp": "2023-02-01T12:11:23Z",
    "function_selector": "",
    "l1_block_number": 0,
    "l1_timestamp": 0,
    "deposit_tx": false,
    "system_tx": false,
    "sig": {
      "v": "0x0",
      "r": "0x0",
      "s": "0x0"
    },
    "transaction_info": {
      "contract_id": "eth:1:0x6b175474e89094c44da98b954eedeac495271d0f",
      "block_number": 16533883,
      "transaction_id": "0x7c1a33fb449b8d4eb5ec042d94d1c7ce2a5acae05f02af58ce4fd8b5c6beaf0a",
      "contract_address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "method": null,
      "parameters": null,
      "intrinsic_gas": 21584,
      "refund_gas": 0,
      "call_trace": {
        "hash": "0x7c1a33fb449b8d4eb5ec042d94d1c7ce2a5acae05f02af58ce4fd8b5c6beaf0a",
        "contract_name": "",
        "function_pc": 0,
        "function_op": "CALL",
        "absolute_position": 0,
        "caller_pc": 0,
        "caller_op": "CALL",
        "call_type": "CALL",
        "address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "from_balance": "0",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "to_balance": "0",
        "value": "0",
        "block_timestamp": "0001-01-01T00:00:00Z",
        "gas": 7978416,
        "gas_used": 24514,
        "intrinsic_gas": 21584,
        "storage_address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
        "nonce_diff": [
          {
            "address": "0xe2E2E2e2e2e2E2E2E2E2e2E2e2E2E2e2e2e2E2e2",
            "original": "0",
            "dirty": "1"
          }
        ],
        "state_diff": [
          {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "soltype": null,
            "original": null,
            "dirty": null,
            "raw": [
              {
                "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
                "key": "0x6f18ad69436c83a0d8b2c05ee70fa64e30403b1755cc38ee9cb6245926b14b17",
                "original": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "dirty": "0x000000000000000000000000000000000000000000000000000000000000012b"
              }
            ]
          }
        ],
        "logs": [
          {
            "name": "",
            "anonymous": false,
            "inputs": null,
            "raw": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "topics": [
                "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
                "0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
                "0x000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1"
              ],
              "data": "0x000000000000000000000000000000000000000000000000000000000000012b"
            },
            "trace_index": null
          }
        ],
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
        "decoded_output": null,
        "network_id": "1",
        "calls": null
      },
      "stack_trace": null,
      "logs": [
        {
          "name": "",
          "anonymous": false,
          "inputs": null,
          "raw": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "topics": [
              "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
              "0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
              "0x000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1"
            ],
            "data": "0x000000000000000000000000000000000000000000000000000000000000012b"
          },
          "trace_index": null
        }
      ],
      "balance_diff": null,
      "nonce_diff": [
        {
          "address": "0xe2E2E2e2e2e2E2E2E2E2e2E2e2E2E2e2e2e2E2e2",
          "original": "0",
          "dirty": "1"
        }
      ],
      "state_diff": [
        {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "soltype": null,
          "original": null,
          "dirty": null,
          "raw": [
            {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "key": "0x6f18ad69436c83a0d8b2c05ee70fa64e30403b1755cc38ee9cb6245926b14b17",
              "original": "0x0000000000000000000000000000000000000000000000000000000000000000",
              "dirty": "0x000000000000000000000000000000000000000000000000000000000000012b"
            }
          ]
        }
      ],
      "raw_state_diff": null,
      "console_logs": null,
      "asset_changes": null,
      "balance_changes": [],
      "created_at": "2023-02-01T12:11:23Z"
    },
    "method": "",
    "decoded_input": null,
    "call_trace": [
      {
        "call_type": "CALL",
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": 7978416,
        "gas_used": 24514,
        "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
      }
    ]
  },
  "simulation": {
    "id": "cc4d422b-149c-4043-83ec-d2670c9ffe2c",
    "project_id": "dfdc391a-a15d-4590-9aef-8691259c7df4",
    "owner_id": "7d5e8b1f-8bf8-4eae-a70f-fb7d354b1cc2",
    "network_id": "1",
    "block_number": 16533883,
    "transaction_index": 0,
    "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
    "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
    "input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
    "gas": 8000000,
    "gas_price": "0",
    "gas_used": 46098,
    "value": "0",
    "status": true,
    "access_list": null,
    "queue_origin": "",
    "block_header": {
      "number": "0xfc497b",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "stateRoot": "0x3a3fd616aa768fc45b78d02fbd216e6a49a19153f92a091f5c4e9a2bbe494ef1",
      "parentHash": "0x57067724ea963c92291770db13ff945f9b7e11689d2494ba318cea6cdab1c2e2",
      "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
      "transactionsRoot": "0x912f0d5b52a308205d1c1a9b15409cbd455b414ac2d2bcb5b13ef01a5b4a41d8",
      "receiptsRoot": "0xfdc2b958b59f3ded07e132764112429f8e2827ed0e1d67954e05ee1be5e7e203",
      "logsBloom": "0xb0abe9644746d77234090df88b0c836b0d2966107c87597c568582618cc4c773104a2da2b011d90310a8db958c13cb208f196333ba08bb86625b405301beaf22028a2193076aaf7ffb0b64eb77ea6827ec293ac4fb754b719744ff2dd9813d751e5808704bc645bf31107e8472742879cd7acb090b643d4cc27986da095ced5c028143df0223190d1d515345a7e2b1a33333b52587c0c688e57e06e8a390493faff909012981eb860ea2ebc1153684e025c27e2460ae28db74e35eb260fbf8e9522c805356b1022928e8b408235e5e824d7483ecf4ba985a9b470c760c58e06716f0fc28003633d86c35ba840f3512c480039004724dd25a9e599898fab73cf3",
      "timestamp": "0x63da56eb",
      "difficulty": "0x0",
      "gasLimit": "0x1c9c380",
      "gasUsed": "0xcb7693",
      "miner": "0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
      "extraData": "0x496c6c756d696e61746520446d6f63726174697a6520447374726962757465",
      "mixHash": "0x43f7931adf192e8addc95bfae45f9db586434110ef7eac2d765e4a4b9ed6de4e",
      "nonce": "0x0000000000000000",
      "baseFeePerGas": "0x32c42d070",
      "size": "0x0",
      "totalDifficulty": "0x0",
      "uncles": null,
      "transactions": null
    },
    "deposit_tx": false,
    "system_tx": false,
    "nonce": 0,
    "addresses": null,
    "contract_ids": null,
    "shared": false,
    "created_at": "2024-01-08T17:30:06.992859393Z"
  },
  "contracts": [],
  "generated_access_list": []
}

Изучите сценарии использования

Предпросмотр результатов транзакции: выявляйте и устраняйте проблемы, которые могут привести к сбою транзакций.
Изменения активов и балансов: получайте точные долларовые значения для всех изменений балансов и активов.
Оценка газа: точно предсказывайте затраты на газ до отправки транзакции.
Переопределения состояния: изменяйте условия блокчейна, такие как временные метки и данные контракта, для тестирования различных сценариев.

Getting Started

Simulator

Console

Monitor

Node RPC

AI Tools

Account & Settings

Одиночные симуляции

Симуляция через RPC

Симуляция через API

Тело запроса

Номер блока и индекс транзакции

Изучите сценарии использования

Что дальше

Пакетные симуляции

Симуляция через SDK

​Симуляция через RPC

​Симуляция через API

​Тело запроса

​Номер блока и индекс транзакции

​Изучите сценарии использования

​Что дальше

Пакетные симуляции

Симуляция через SDK

Симуляция через RPC

Симуляция через API

Тело запроса

Номер блока и индекс транзакции

Изучите сценарии использования

Что дальше