Перейти к основному содержанию
Вы можете полностью управлять вашей Virtual Environment с помощью специальных RPC-методов. Эти методы доступны через Admin RPC, который можно скопировать из Dashboard. Они позволяют вам изменять состояние сети (балансы аккаунтов, номера блоков и хранилище) под нужды вашей разработки. Вызовы этих RPC-методов представлены вызовом виртуального контракта TenderlyCheatcodes. Список специальных RPC-методов ниже работает только при вызове через Admin RPC. Кастомизация сети Отправка транзакции Безлимитный фаусет Управление хранилищем Управление байткодом Откат состояния Управление синхронизацией Network Mirror Mode

evm_increaseTime

Продвигает время блокчейна на указанную величину и создаёт пустой блок с новой временной меткой. Последующие вызовы eth_call и eth_sendRawTransaction будут получать разные значения block.timestamp в зависимости от того, на какой blockNumber они нацелены:
  • Для блока pending: возвращается current_time + time_increase. Это ожидаемая временная метка следующего майнящегося блока.
  • Для блока latest: возвращается time_of_evm_increaseTimestamp_call + time_increase. Это временная метка пустого блока, созданного при вызове evm_increaseTimestamp.
Параметры
  • QUANTITY - hex-кодированный time_increase в секундах, на которое нужно перепрыгнуть вперёд
Возвращает
  • DATA - 32-байтный хеш вновь сгенерированного блока
Пример запроса
example.json
Пример ответа
example.json

evm_setNextBlockTimestamp

Смещает текущее время на указанную временную метку и создаёт пустой блок с заданной временной меткой. Последующие вызовы eth_call и eth_sendRawTransaction будут возвращать разные значения block.timestamp в зависимости от того, на какой blockNumber они нацелены:
  • Для блока pending: возвращается specified_timestamp + time_since_evmSetNextBlockTimestamp_call. Это установленная временная метка плюс любое время, прошедшее с момента вызова метода.
  • Для блока latest: возвращается specified_timestamp. Это временная метка пустого блока, созданного при вызове evm_setNextBlockTimestamp.
Параметры
  • QUANTITY - hex-кодированный specified_timestamp, представляющий epoch-временную метку (в секундах)
Возвращает
  • QUANTITY - целое число (epoch-временная метка), устанавливаемое для следующего блока
Пример запроса
example.json
Пример ответа
example.json

tenderly_setNextBlockTimestamp

Смещает текущее время на заданную временную метку, не создавая пустой блок. Последующие вызовы eth_call и eth_sendRawTransaction будут возвращать разные значения block.timestamp в зависимости от того, на какой blockNumber они нацелены:
  • Для блока pending: возвращается specified_timestamp + time_since_tenderly_setNextBlockTimestamp. Это установленная временная метка плюс любое время, прошедшее с момента вызова метода.
  • Для блока latest: возвращается временная метка последнего созданного блока.
Параметры
  • QUANTITY - hex-кодированный specified_timestamp, представляющий epoch-временную метку (в секундах)
Возвращает
  • QUANTITY - целое число (epoch-временная метка), устанавливаемое для следующего блока
Пример запроса
example.json
Пример ответа
example.json

evm_increaseBlocks

Пропускает заданное количество блоков и генерирует новый блок с новым номером блока. Параметры
  • QUANTITY - hex-кодированное количество блоков для пропуска
Возвращает
  • DATA - 32-байтный хеш вновь сгенерированного блока
Пример запроса
example.json
Пример ответа
example.json

eth_sendTransaction

Отправляет неподписанную транзакцию. Параметры
  1. Transaction - объект транзакции
  • from: DATA, 20 байт - адрес, с которого отправляется транзакция.
  • to: DATA, 20 байт - (необязательно, опускается при создании нового контракта) адрес, на который направляется транзакция.
  • gas: QUANTITY - (необязательно) целое число газа, предоставленного для исполнения транзакции. Неиспользованный газ будет возвращён.
  • gasPrice: QUANTITY - (необязательно) целое число gasPrice, используемое за каждую единицу оплаченного газа.
  • value: QUANTITY - (необязательно) целое число значения, отправляемого с этой транзакцией.
  • data: DATA - (необязательно) скомпилированный код контракта ИЛИ хеш вызываемой сигнатуры метода и закодированные параметры.
example.json
RESULT: хеш транзакции STRING, 32-байтное hex-значение

eth_createAccessList

Возвращает access-tuples, которые будут затронуты транзакцией. Параметры
  • SendTransactionObject - объект транзакции (такой же, как передаваемый в eth_sendTransaction)
  • BlockNumber - параметр номера блока
Возвращает
  • AccessList - массив access-tuples, затронутых транзакцией
Пример запроса
example.json
Пример ответа
example.json

evm_getLatest

Получает идентификатор последней транзакции в сетевой Virtual Environment. Параметры Возвращает
  • DATA - UUID последней транзакции Virtual Environment
Пример запроса
example.json
Пример ответа
example.json

tenderly_setBalance

Изменяет баланс аккаунта или аккаунтов. Параметры
  • ADDRESS/ADDRESSES - строка или массив адресов аккаунтов
  • AMOUNT - hex-кодированное число суммы в wei
Возвращает
  • DATA - 32-байтный хеш вновь созданной транзакции
Пример запроса
example.json
ИЛИ
example.json
Пример ответа
example.json

tenderly_addBalance

Добавляет баланс к указанному аккаунту или аккаунтам. Параметры
  • ADDRESS/ADDRESSES - строка или массив адресов аккаунтов
  • AMOUNT - hex-кодированное число суммы в wei
Возвращает
  • DATA - 32-байтный хеш вновь созданной транзакции
Пример запроса
example.json
ИЛИ
example.json
Пример ответа
example.json

tenderly_setErc20Balance

Устанавливает баланс токенов для кошелька на указанном ERC-20 контракте.
tenderly_setErc20Balance записывает новый баланс напрямую в хранилище контракта токена и не эмитирует событие ERC-20 Transfer. Если ваш нижестоящий инструментарий (индексеры, subgraphs, учёт) полагается на события Transfer для отслеживания балансов, используйте вместо этого tenderly_addErc20Balance: он эмитирует синтетический лог Transfer для каждого пополненного аккаунта.
Параметры
  • TOKEN_ADDRESS - адрес контракта ERC-20
  • WALLET - адрес кошелька, который будет пополнен
  • VALUE - 32-байтный хеш, представляющий значение токенов в wei
Возвращает DATA - 32-байтный хеш вновь созданной транзакции (переопределение хранилища фиксируется через транзакцию) Пример запроса
example.json
Пример ответа
example.json

tenderly_addErc20Balance

Добавляет указанное количество токенов одному или нескольким кошелькам на указанном ERC-20 контракте. В отличие от tenderly_setErc20Balance, этот метод эмитирует синтетическое событие Transfer для каждого пополненного аккаунта, так что индексеры, subgraphs и любые инструменты, сверяющие балансы по логам, остаются в синхронизации с итоговым состоянием. Эмитируемый лог имеет стандартный ERC-20 топик Transfer(address,address,uint256), использует отправителя транзакции как адрес from и пополняемый кошелёк как адрес to, а также несёт добавленную сумму amount в поле данных. Параметры
  • TOKEN_ADDRESS - адрес контракта ERC-20
  • WALLETS - массив адресов кошельков, которые получат токены
  • VALUE - 32-байтный хеш, представляющий сумму токенов в wei, добавляемую каждому кошельку
Возвращает DATA - 32-байтный хеш вновь созданной транзакции (переопределение хранилища фиксируется через транзакцию) Пример запроса
example.json
Пример ответа
example.json

tenderly_setMaxErc20Balance

Пополняет адрес кошелька максимально возможным балансом токенов (в основном предназначено для токенов без простого mapping баланса) на указанном ERC-20 контракте.
Как и tenderly_setErc20Balance, этот метод пишет напрямую в хранилище и не эмитирует событие ERC-20 Transfer. Используйте tenderly_addErc20Balance, если вам нужно, чтобы индексеры или инструменты на основе логов подхватили изменение баланса.
Параметры
  • YIELD_TOKEN_ADDRESS - адрес контракта ERC-20
  • WALLET - адрес кошелька, который будет пополнен
Возвращает DATA - 32-байтный хеш вновь созданной транзакции (переопределение хранилища фиксируется через транзакцию) Пример запроса
example.json
Пример ответа
example.json

tenderly_setStorageAt

Устанавливает хранилище указанного адреса по указанному слоту. Параметры
  • ADDRESS - адрес, у которого будет переопределено хранилище
  • SLOT - 32-байтный хеш, представляющий ключ слота хранилища
  • VALUE - 32-байтный хеш, представляющий значение по ключу slot
Возвращает
  • DATA - 32-байтный хеш вновь созданной транзакции (переопределение хранилища фиксируется через транзакцию)
Пример запроса
example.json
Пример ответа
example.json

tenderly_setCode

Заменяет байт-код указанного адреса. Nonce и хранилище аккаунта остаются без изменений. Параметры
  • ADDRESS: адрес, байт-код которого будет заменён
  • BYTECODE: runtime-байткод для развёртывания по адресу ADDRESS, в hex-кодировке
Возвращает
  • DATA: 32-байтный хеш вновь созданной транзакции (замена кода фиксируется через транзакцию)
Пример запроса
example.json
Пример ответа
example.json
Развёртывание изменённого байткода нарушает верификацию целевого адреса, поэтому трассировки и Debugger для него больше недоступны. Полный пример смотрите в Чит-код развёртывания байткода.

evm_snapshot

Возвращает ID снимка, позволяющий откатить Virtual Environment к предыдущей точке (совпадает с hash блока из evm_getLatest). Параметры Возвращает
  1. DATA - хеш последнего блока, произведённого Virtual Environment (ID снимка)
Пример запроса
example.json
Пример ответа
example.json

evm_revert

Откатывает состояние Virtual Environment к предыдущему снимку. Одиночный evm_revert может откатить не более 2000 блоков. Если снимок находится дальше в прошлом, вызов завершается ошибкой revert operation is limited to maximum 2000 blocks. Чтобы вернуться в точку более чем на 2000 блоков назад, вместо этого сделайте форк Virtual Environment на целевом историческом блоке. Параметры
  • DATA - ID снимка
Возвращает
  • BOOLEAN - флаг успешности операции
Пример запроса
example.json
Пример ответа
example.json

Управление синхронизацией Network Mirror Mode

Следующие методы управляют синхронизацией Virtual Environment в режиме Network Mirror Mode: они запускают и останавливают непрерывную синхронизацию, синхронизируют заданное число блоков, откатывают синхронизированные блоки и сообщают о ходе задания синхронизации. Они работают только в Virtual Environment в режиме Network Mirror Mode.
Пока синхронизация Network Mirror Mode активна, другие чит-коды Admin RPC (например, tenderly_setBalance, tenderly_setStorageAt) отключены. Сначала приостановите синхронизацию с помощью tenderly_stopSync, если вам нужно, чтобы они сработали немедленно.
Синхронизация выполняется как фоновое задание, и в Virtual Environment одновременно может выполняться только одно задание. Вызов tenderly_startSync или tenderly_syncBlocks во время выполнения задания возвращает ошибку a block sync is already in progress for this vnet, wait for it to finish before starting a new one. Каждое задание синхронизации держится на два блока позади головы родительской сети, поэтому неглубокая реорганизация в родительской сети заменяет блоки до того, как они попадут в Virtual Environment. Необязательный параметр blockTimeSec, который принимают tenderly_startSync и tenderly_syncBlocks, задаёт, сколько секунд задание ждёт между синхронизируемыми блоками. Значение 0 синхронизирует блоки так быстро, как их удаётся выполнить. Значения по умолчанию и допустимые значения по сетям:

tenderly_startSync

Запускает непрерывную синхронизацию с текущей головы Virtual Environment. Задание синхронизирует блоки родительской сети по одному и продолжает следовать за родительской сетью, пока вы не вызовете tenderly_stopSync. Транзакции из mempool Virtual Environment добавляются в порядке FIFO в начало следующего синхронизированного блока. Параметры
  • OBJECT (необязательно) - настройки синхронизации:
    • blockTimeSec - NUMBER, секунды между синхронизируемыми блоками. По умолчанию равно времени блока сети.
Возвращает
  • OBJECT - созданное задание синхронизации:
    • syncId - STRING, ID задания синхронизации. Передайте его в tenderly_getSyncStatus.
    • startBlock - QUANTITY, первый блок родительской сети, который синхронизирует задание
Пример запроса
example.json
Пример ответа
example.json

tenderly_stopSync

Останавливает выполняющееся задание синхронизации. Virtual Environment остаётся на своей текущей голове; возобновите синхронизацию через tenderly_startSync или продвиньтесь на заданное число блоков через tenderly_syncBlocks. Если ни одно задание не выполняется, вызов возвращает ошибку no sync currently running for this vnet. Параметры Нет. Возвращает
  • OBJECT - остановленное задание синхронизации:
    • syncId - STRING, ID остановленного задания синхронизации
    • stoppedBlock - QUANTITY, блок родительской сети, которого задание достигло к моменту остановки
Пример запроса
example.json
Пример ответа
example.json

tenderly_syncBlocks

Синхронизирует заданное число блоков родительской сети, начиная с блока после текущей головы Virtual Environment, и затем останавливается. Транзакции из mempool Virtual Environment добавляются в порядке FIFO в начало следующего синхронизированного блока. Вызов возвращает ответ сразу после создания задания; отслеживайте ход через tenderly_getSyncStatus. Параметры
  • QUANTITY - число блоков для синхронизации, десятичным числом или hex-строкой. Должно быть больше нуля.
  • OBJECT (необязательно) - настройки синхронизации:
    • blockTimeSec - NUMBER, секунды между синхронизируемыми блоками. По умолчанию равно времени блока сети.
Возвращает
  • OBJECT - созданное задание синхронизации:
    • syncId - STRING, ID задания синхронизации
    • startBlock - QUANTITY, первый блок родительской сети, который синхронизирует задание
    • targetBlock - QUANTITY, последний блок родительской сети, который синхронизирует задание
Пример запроса
example.json
Пример ответа
example.json

tenderly_rewindSync

Откатывает последние N синхронизированных блоков в Virtual Environment и отбрасывает созданное ими состояние. Следующее задание синхронизации начинается с новой головы Virtual Environment. Сначала остановите выполняющуюся синхронизацию: во время выполнения задания вызов возвращает ошибку cannot rewind while a chain sync is running; stop the sync first. Параметры
  • QUANTITY - число блоков для отката, от 1 до 100, десятичным числом или hex-строкой.
Возвращает
  • OBJECT - результат отката:
    • targetHash - DATA, 32-байтовый хеш блока, на котором Virtual Environment находится после отката
    • blocksReverted - NUMBER, число откатанных блоков
Пример запроса
example.json
Пример ответа
example.json

tenderly_getSyncStatus

Возвращает ход задания синхронизации, запущенного через tenderly_startSync или tenderly_syncBlocks. Параметры
  • STRING - syncId, полученный при создании задания
Возвращает
  • OBJECT - статус задания синхронизации:
    • startBlock - QUANTITY, первый блок родительской сети, который синхронизирует задание
    • targetBlock - QUANTITY, последний блок родительской сети, который синхронизирует задание. Есть только у заданий, запущенных через tenderly_syncBlocks.
    • currentBlock - QUANTITY, блок родительской сети, которого достигло задание
    • status - STRING, одно из значений running, paused, completed, stopped, failed или canceled
    • startedAt - STRING, время запуска задания (RFC 3339). Отсутствует, пока задание не запущено.
    • finishedAt - STRING, время завершения задания (RFC 3339). Отсутствует, пока задание выполняется.
    • syncedTransactionCount - NUMBER, число уже синхронизированных транзакций родительской сети
Пример запроса
example.json
Пример ответа
example.json