TenderlyCheatcodes.

- evm_increaseTime
- evm_setNextBlockTimestamp
- tenderly_setNextBlockTimestamp
- evm_increaseBlocks
- evm_mine
- tenderly_setBalance
- tenderly_addBalance
- tenderly_setErc20Balance
- tenderly_addErc20Balance
- tenderly_setMaxErc20Balance
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
Отправляет неподписанную транзакцию.
Параметры
- Transaction - объект транзакции
from:DATA, 20 байт - адрес, с которого отправляется транзакция.to:DATA, 20 байт - (необязательно, опускается при создании нового контракта) адрес, на который направляется транзакция.gas:QUANTITY- (необязательно) целое число газа, предоставленного для исполнения транзакции. Неиспользованный газ будет возвращён.gasPrice:QUANTITY- (необязательно) целое числоgasPrice, используемое за каждую единицу оплаченного газа.value:QUANTITY- (необязательно) целое число значения, отправляемого с этой транзакцией.data:DATA- (необязательно) скомпилированный код контракта ИЛИ хеш вызываемой сигнатуры метода и закодированные параметры.
example.json
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-20WALLET- адрес кошелька, который будет пополнен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-20WALLETS- массив адресов кошельков, которые получат токены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-20WALLET- адрес кошелька, который будет пополнен
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
evm_snapshot
Возвращает ID снимка, позволяющий откатить Virtual Environment к предыдущей точке (совпадает с hash блока из evm_getLatest).
Параметры
Возвращает
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, если вам нужно, чтобы они сработали немедленно.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илиcanceledstartedAt-STRING, время запуска задания (RFC 3339). Отсутствует, пока задание не запущено.finishedAt-STRING, время завершения задания (RFC 3339). Отсутствует, пока задание выполняется.syncedTransactionCount-NUMBER, число уже синхронизированных транзакций родительской сети
example.json
example.json