Симуляция блоков с eth_simulateV1

eth_simulateV1 является стандартным методом мультиблочной симуляции из спецификации Ethereum execution APIs. Он симулирует последовательность блоков, каждый из которых содержит пакет вызовов, поверх базового блока, ничего не отправляя в сеть. Вызовы внутри блока выполняются последовательно и разделяют состояние, а каждый симулируемый блок строится поверх предыдущего. Метод работает на Node RPC и Virtual Environments; полный справочник JSON-RPC содержит все методы и сети. Небольшой набор сетей его не поддерживает; см. раздел Доступность в сетях. Используйте eth_simulateV1, когда нужна переносимая, соответствующая спецификации симуляция, возвращающая результаты в формате блоков. Для декодированных логов, трассировки вызовов, изменений активов и балансов используйте tenderly_simulateTransaction для одной транзакции или tenderly_simulateBundle для последовательности транзакций.

`eth_simulateV1`

Симулирует последовательность блоков поверх заданного базового блока. Каждый блок содержит пакет вызовов: вызов N видит изменения состояния вызова N-1, а каждый блок после первого строится на предыдущем. Параметры

Simulation payload OBJECT
- blockStateCalls ARRAY из Block state call OBJECT: последовательность блоков для симуляции, по порядку
  - blockOverrides (опционально) OBJECT: набор полей заголовка для переопределения в этом блоке
    - number (опционально) STRING: hex, переопределяет номер блока
    - difficulty (опционально) STRING: hex, переопределяет сложность блока
    - time (опционально) STRING: hex, переопределяет временную метку блока
    - gasLimit (опционально) STRING: hex, переопределяет лимит газа
    - coinbase (опционально) STRING: hex, переопределяет майнера блока
    - random (опционально) STRING: hex, переопределяет значение, которое подаётся в опкод PREVRANDAO
    - baseFee (опционально) STRING: hex, переопределяет базовую комиссию блока
    - excessBlobGas (опционально) STRING: hex, переопределяет избыточный blob-газ
    - blobGasUsed (опционально) STRING: hex, переопределяет использованный blob-газ
  - stateOverrides (опционально) MAP: сопоставление учётной записи (адреса) со спецификацией переопределения. Задавайте переопределения состояния на первой записи блока; см. Особенности реализации Tenderly
    - key STRING: учётная запись, к которой применяется переопределение
    - value OBJECT: спецификация переопределения
      - balance (опционально) STRING: hex-кодированное переопределение баланса учётной записи в wei
      - nonce (опционально) STRING: hex-кодированное переопределение nonce для учётной записи
      - code (опционально) STRING: данные переопределения кода для учётной записи
      - stateDiff (опционально) MAP: сопоставление ключа хранилища со значением переопределения
        
        key STRING: ключ хранилища
        
        value STRING: переопределяемое значение для указанного ключа хранилища
  - calls ARRAY из Transaction call OBJECT: выполняются по порядку; каждый вызов видит изменения состояния предшествующих ему вызовов
    - from (опционально) STRING: адрес в hex; по умолчанию нулевой адрес
    - to (опционально) STRING: адрес в hex
    - gas (опционально) STRING: hex-кодированный лимит газа для вызова
    - gasPrice (опционально) STRING: hex, цена газа, которую отправитель готов заплатить, в wei
    - maxFeePerGas (опционально) STRING: hex, максимальная суммарная комиссия за газ, которую отправитель готов заплатить (включает сетевую / базовую комиссию и комиссию майнера / приоритетную), в wei
    - maxPriorityFeePerGas (опционально) STRING: hex, максимальная комиссия за газ, которую отправитель готов заплатить майнерам, в wei
    - value (опционально) STRING: hex-кодированное значение в wei; по умолчанию 0x0
    - input (опционально) STRING: hex-кодированные данные вызова; data принимается как устаревший псевдоним, при одновременном указании приоритет имеет input
    - nonce (опционально) STRING: hex-кодированный nonce
    - type (опционально) STRING: hex-кодированный тип транзакции
    - accessList (опционально) ARRAY из записей access list OBJECT
      - address STRING: адрес в hex
      - storageKeys ARRAY из STRING: представление 32-байтовых hex-кодированных ключей хранилища
    - maxFeePerBlobGas (опционально) STRING: hex, максимальная комиссия за blob-газ в wei
    - blobVersionedHashes (опционально) ARRAY из STRING: 32-байтовые hex-кодированные версионированные хеши blob
    - authorizationList (опционально) ARRAY: кортежи авторизации EIP-7702
- returnFullTransactions (опционально) BOOLEAN: если true, блоки результата содержат полные объекты транзакций вместо хешей транзакций
Base block number (опционально) Блок, поверх которого выполняется симуляция. По умолчанию latest. Одно из:
- STRING номер блока
- ENUM тег блока earliest|finalized|safe|latest|pending

Пример Запрос симулирует два блока. Первый блок пополняет баланс отправителя через переопределение состояния, затем отправляет ETH и оборачивает 1 ETH в WETH; второй блок задаёт пользовательскую временную метку и переводит WETH, созданный в первом блоке.

Request
Shell
JavaScript
Response

example.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "method": "eth_simulateV1",
  "params": [
    {
      "blockStateCalls": [
        {
          "stateOverrides": {
            "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2": {
              "balance": "0x3635c9adc5dea00000"
            }
          },
          "calls": [
            {
              "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
              "to": "0x1111111111111111111111111111111111111111",
              "value": "0x1bc16d674ec80000"
            },
            {
              "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
              "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
              "value": "0xde0b6b3a7640000",
              "input": "0xd0e30db0"
            }
          ]
        },
        {
          "blockOverrides": { "time": "0x6ae00000" },
          "calls": [
            {
              "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
              "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
              "input": "0xa9059cbb00000000000000000000000011111111111111111111111111111111111111110000000000000000000000000000000000000000000000000de0b6b3a7640000"
            }
          ]
        }
      ]
    },
    "latest"
  ]
}

example

curl https://mainnet.gateway.tenderly.co/$TENDERLY_NODE_ACCESS_KEY \
-X POST \
-H "Content-Type: application/json" \
-d \
'{
"id": 0,
"jsonrpc": "2.0",
"method": "eth_simulateV1",
"params": [
{
"blockStateCalls": [
  {
    "stateOverrides": {
      "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2": {
        "balance": "0x3635c9adc5dea00000"
      }
    },
    "calls": [
      {
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0x1111111111111111111111111111111111111111",
        "value": "0x1bc16d674ec80000"
      },
      {
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "value": "0xde0b6b3a7640000",
        "input": "0xd0e30db0"
      }
    ]
  },
  {
    "blockOverrides": { "time": "0x6ae00000" },
    "calls": [
      {
        "from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "input": "0xa9059cbb00000000000000000000000011111111111111111111111111111111111111110000000000000000000000000000000000000000000000000de0b6b3a7640000"
      }
    ]
  }
]
},
"latest"
]
}'

example.js

// Installation Instructions: https://docs.ethers.io/v5/getting-started/#installing
const { ethers } = require('ethers');

async function runSimulateV1() {
// Initialize an ethers instance
const provider = new ethers.providers.JsonRpcProvider(
'https://mainnet.gateway.tenderly.co/$TENDERLY_NODE_ACCESS_KEY',
);

// Execute method
const result = await provider.send('eth_simulateV1', [
{
blockStateCalls: [
  {
    stateOverrides: {
      '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2': {
        balance: '0x3635c9adc5dea00000',
      },
    },
    calls: [
      {
        from: '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
        to: '0x1111111111111111111111111111111111111111',
        value: '0x1bc16d674ec80000',
      },
      {
        from: '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
        to: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
        value: '0xde0b6b3a7640000',
        input: '0xd0e30db0',
      },
    ],
  },
  {
    blockOverrides: { time: '0x6ae00000' },
    calls: [
      {
        from: '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
        to: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
        input: '0xa9059cbb00000000000000000000000011111111111111111111111111111111111111110000000000000000000000000000000000000000000000000de0b6b3a7640000',
      },
    ],
  },
],
},
'latest',
]);

// Print the output to console
console.log(result);
}

(async () => {
runSimulateV1();
})();

response.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": [
    {
      "number": "0x184b35b",
      "hash": "0x2b33857d4b0380d7b92a258c77d9357c9515701f914684789e959ae84d73347a",
      "parentHash": "0x1fe7faf7d5b3a57fe52192bcf634b62bda8cfd39a5509d5541a2fb30d5438463",
      "nonce": "0x88425305eb52b6f7",
      "mixHash": "0x5bf018c82ca9e0e3805b00475afe61be2b1077eff79abb6cb4617af8548aa514",
      "sha3Uncles": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "miner": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
      "difficulty": "0x0",
      "extraData": "0x546974616e2028746974616e6275696c6465722e78797a29",
      "size": "0x0",
      "gasLimit": "0x3938700",
      "gasUsed": "0x3938700",
      "timestamp": "0x6a4bb197",
      "transactionsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "receiptsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "baseFeePerGas": "0x18d7ee41",
      "blobGasUsed": "0x60000",
      "excessBlobGas": "0xba42085",
      "uncles": [],
      "transactions": [
        "0xbb42f5dcbfa507c52b64642c9b9e2a95fc4e2542cbd06b180239367d45f35e30",
        "0xcb06f645c2962f5dfff047efb2a000d05d0a58a619c63c97ec3e12cf48d02033"
      ],
      "calls": [
        {
          "returnData": "0x",
          "logs": [],
          "gasUsed": "0x5208",
          "status": "0x1"
        },
        {
          "returnData": "0x",
          "logs": [
            {
              "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
              "topics": [
                "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
                "0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2"
              ],
              "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
              "blockNumber": "0x184b35b",
              "transactionHash": "0xcb06f645c2962f5dfff047efb2a000d05d0a58a619c63c97ec3e12cf48d02033",
              "transactionIndex": "0x1",
              "blockHash": "0x2b33857d4b0380d7b92a258c77d9357c9515701f914684789e959ae84d73347a",
              "logIndex": "0x0",
              "removed": false
            }
          ],
          "gasUsed": "0xafee",
          "status": "0x1"
        }
      ]
    },
    {
      "number": "0x184b35c",
      "hash": "0xddb8a8a01c753b30acea4c8a12e36f3157dfa854ad0134b1dbb1e6227a9838cd",
      "parentHash": "0x2b33857d4b0380d7b92a258c77d9357c9515701f914684789e959ae84d73347a",
      "nonce": "0x0000000000000000",
      "mixHash": "0x5bf018c82ca9e0e3805b00475afe61be2b1077eff79abb6cb4617af8548aa514",
      "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "miner": "0x0000000000000000000000000000000000000000",
      "difficulty": "0x0",
      "extraData": "0x546974616e2028746974616e6275696c6465722e78797a29",
      "size": "0x18e",
      "gasLimit": "0x3938700",
      "gasUsed": "0x0",
      "timestamp": "0x6ae00000",
      "transactionsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
      "baseFeePerGas": "0x1bf2ec09",
      "excessBlobGas": "0xba62085",
      "uncles": [],
      "transactions": [
        "0x21ac69b18844a9f1345c2b29292852477672178b0d338092f20dcb850d261604"
      ],
      "calls": [
        {
          "returnData": "0x0000000000000000000000000000000000000000000000000000000000000001",
          "logs": [
            {
              "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
              "topics": [
                "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                "0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
                "0x0000000000000000000000001111111111111111111111111111111111111111"
              ],
              "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
              "blockNumber": "0x184b35b",
              "transactionHash": "0x21ac69b18844a9f1345c2b29292852477672178b0d338092f20dcb850d261604",
              "transactionIndex": "0x0",
              "blockHash": "0x2b33857d4b0380d7b92a258c77d9357c9515701f914684789e959ae84d73347a",
              "logIndex": "0x1",
              "removed": false
            }
          ],
          "gasUsed": "0x73fe",
          "status": "0x1"
        }
      ]
    }
  ]
}

Результат ARRAY из Block result OBJECT, по одному на каждую запись blockStateCalls, по порядку. Каждый результат блока содержит стандартные поля заголовка блока, возвращаемые eth_getBlockByNumber (number, hash, parentHash, timestamp, gasLimit, gasUsed, baseFeePerGas, logsBloom, miner и так далее), а также:

transactions ARRAY: хеши транзакций симулированных вызовов или полные объекты транзакций, если returnFullTransactions равно true
calls ARRAY из Call result OBJECT, по одному на вызов, по порядку:
- returnData STRING: hex-кодированные возвращаемые данные вызова
- logs ARRAY из Log OBJECT: события, эмитированные вызовом (address, topics, data, blockNumber, transactionHash, transactionIndex, blockHash, logIndex, removed); пустой массив для откатившихся вызовов
- gasUsed STRING: hex-кодированное количество газа, потреблённого вызовом
- status STRING: 0x1 при успехе, 0x0 при неудаче
- error OBJECT: присутствует только при неудачном вызове
  - code NUMBER: код ошибки
  - message STRING: сообщение об ошибке, включая причину revert, когда она доступна

Особенности реализации Tenderly

Реализация Tenderly отличается от эталонной спецификации execution-apis следующим образом:

validation не поддерживается. Установка validation: true возвращает ошибку validation flag is not supported. Симуляция всегда выполняется в невалидирующем режиме: требования к nonce, балансу и комиссиям не применяются к вызовам.
traceTransfers не поддерживается. Установка traceTransfers: true возвращает ошибку traceTransfers flag is not supported. Синтетические логи переводов ETH не создаются.
Переопределения state не поддерживаются. Поле state (полная замена хранилища) в переопределении состояния возвращает ошибку not supported. Используйте stateDiff для переопределения отдельных слотов хранилища.
Переопределения состояния применяются с первого блока. Задавайте stateOverrides на первой записи blockStateCalls; stateOverrides на последующих записях не применяются.
gas на уровне вызова ограничивается сверху. Значение gas выше лимита газа блока плюс 600 000 000 усекается до этого потолка, а не отклоняется.
Нет лимитов на количество блоков и вызовов. Максимальное количество записей blockStateCalls и количество вызовов в одном блоке не ограничены.
Хеши транзакций синтетические. Хеши в блоках результата идентифицируют симулированные вызовы, но не являются хешами подписанных транзакций.
Продвижение блоков. Каждый симулируемый блок после первого получает number = предыдущий + 1 и parentHash, связанный с предыдущим результатом, при этом базовая комиссия и лимит газа пересчитываются. Автоматически генерируемая временная метка берётся из системных часов ноды, поэтому задавайте blockOverrides.time явно, когда временные метки важны. Переопределённые номера блоков и временные метки применяются как есть; монотонность не проверяется. Если первая запись блока содержит blockOverrides без number, номер блока по умолчанию равен номеру базового блока плюс 1.

Доступность в сетях

eth_simulateV1 доступен в сетях Node RPC и Virtual Environments, за исключением следующих сетей, где ноды базовой сети не поддерживают этот метод:

ApeChain
Avalanche C-Chain
Avalanche C-Chain Fuji
Blast
Curtis
Flare
Immutable
Immutable Testnet
Lens
Lens Testnet
Metis Andromeda
Metis Sepolia
Monad
Monad Testnet
Moonbase Alpha
Moonbeam
Moonriver
Scroll Mainnet
Scroll Sepolia
Sonic
Sonic Testnet
Stable
Stable Testnet
ZKsync
ZKsync Sepolia

​eth_simulateV1

​Особенности реализации Tenderly

​Доступность в сетях

`eth_simulateV1`

Особенности реализации Tenderly

Доступность в сетях