跳转到主要内容
您可以通过特殊的 RPC 方法完全控制您的 Virtual Environment。这些方法通过 Admin RPC 提供,您可以从 Dashboard 中复制。 它们允许您操纵网络状态,例如账户余额、区块号和存储,以满足您的开发需求。 对这些 RPC 方法的调用由对虚拟 TenderlyCheatcodes 合约的调用表示。 此处列出的特殊 RPC 方法仅在通过 Admin RPC 调用时才有效。 网络自定义 发送交易 无限水龙头 存储操纵 字节码操纵 状态回滚 Network Mirror Mode 同步控制

evm_increaseTime

将区块链时间按指定数量向前推进,并使用新的时间戳创建一个空区块。 后续对 eth_call 和 eth_sendRawTransaction 的调用会根据它们所针对的 blockNumber 获取不同的 block.timestamp 值:
  • 对于 pending 区块:返回 current_time + time_increase 这表示下一个将被挖掘区块的预期时间戳。
  • 对于 latest 区块:返回 time_of_evm_increaseTimestamp_call + time_increase。这是调用 evm_increaseTimestamp 时创建的空区块的时间戳。
参数
  • QUANTITY - 十六进制编码的 time_increase(要向前跳跃的秒数)
返回值
  • DATA - 新生成区块的 32 字节区块哈希
示例请求
example.json
示例响应
example.json

evm_setNextBlockTimestamp

将当前时间偏移到指定时间戳,并使用给定的时间戳创建一个空区块。 后续对 eth_call 和 eth_sendRawTransaction 的调用将根据它们所针对的 blockNumber 返回不同的 block.timestamp 值:
  • 对于 pending 区块:返回 specified_timestamp + time_since_evmSetNextBlockTimestamp_call。这表示设置的时间戳加上自方法被调用以来经过的任何时间。
  • 对于 latest 区块:返回 specified_timestamp。这是调用 evm_setNextBlockTimestamp 时创建的空区块的时间戳。
参数
  • QUANTITY - 十六进制编码的 specified_timestamp,表示 epoch 时间戳(以秒为单位)
返回值
  • QUANTITY - 为下一个区块设置的整数(epoch 时间戳)
示例请求
example.json
示例响应
example.json

tenderly_setNextBlockTimestamp

将当前时间偏移到给定的时间戳,而不创建空区块。 后续对 eth_call 和 eth_sendRawTransaction 的调用将根据它们所针对的 blockNumber 返回不同的 block.timestamp 值:
  • 对于 pending 区块:返回 specified_timestamp + time_since_tenderly_setNextBlockTimestamp。这表示设置的时间戳加上自方法被调用以来经过的任何时间。
  • 对于 latest 区块:返回最新创建区块的时间戳。
参数
  • QUANTITY - 十六进制编码的 specified_timestamp,表示 epoch 时间戳(以秒为单位)
返回值
  • QUANTITY - 为下一个区块设置的整数(epoch 时间戳)
示例请求
example.json
示例响应
example.json

evm_increaseBlocks

跳过若干区块,并使用新的区块号生成一个新区块。 参数
  • QUANTITY - 十六进制编码的要跳过的区块数
返回值
  • DATA - 新生成区块的 32 字节区块哈希
示例请求
example.json
示例响应
example.json

eth_sendTransaction

提交一笔未签名的交易。 参数
  1. Transaction - 交易对象
  • from:DATA,20 字节 - 交易发送方的地址。
  • to:DATA,20 字节 - (可选,创建新合约时省略)交易的目标地址。
  • gas:QUANTITY - (可选)为交易执行提供的 gas 整数。将返回未使用的 gas。
  • gasPrice:QUANTITY - (可选)每单位已付 gas 使用的 gasPrice 整数。
  • value:QUANTITY - (可选)随此交易发送的 value 整数。
  • data:DATA - (可选)合约的编译代码,或调用方法签名与编码参数的哈希。
example.json
RESULT:交易哈希 STRING,32 字节十六进制值

eth_createAccessList

返回此交易将访问的访问元组。 参数
  • SendTransactionObject - 交易对象(与提供给 eth_sendTransaction 的对象相同)
  • BlockNumber - 区块号参数
返回值
  • AccessList - 交易访问的访问元组数组
示例请求
example.json
示例响应
example.json

evm_getLatest

获取网络 Virtual Environment 上的最新交易 ID。 参数 返回值
  • DATA - 最新 Virtual Environment 交易的 UUID
示例请求
example.json
示例响应
example.json

tenderly_setBalance

修改一个或多个账户的余额。 参数
  • ADDRESS/ADDRESSES - 账户地址字符串或字符串数组
  • AMOUNT - 以 wei 为单位的十六进制编码金额
返回值
  • DATA - 新创建交易的 32 字节区块哈希
示例请求
example.json
或者
example.json
示例响应
example.json

tenderly_addBalance

向提供的一个或多个账户添加余额。 参数
  • ADDRESS/ADDRESSES - 账户地址字符串或字符串数组
  • AMOUNT - 以 wei 为单位的十六进制编码金额
返回值
  • DATA - 新创建交易的 32 字节区块哈希
示例请求
example.json
或者
example.json
示例响应
example.json

tenderly_setErc20Balance

在提供的 erc20 合约上为钱包设置代币余额。
tenderly_setErc20Balance 会将新余额直接写入代币合约的存储中,并不会发出 ERC-20 Transfer 事件。如果您的下游工具(索引器、subgraph、账务系统)依赖 Transfer 事件来追踪余额,请改用 tenderly_addErc20Balance,它会为每个被充值的账户发出一个合成的 Transfer 日志。
参数
  • TOKEN_ADDRESS - ERC20 合约的地址
  • WALLET - 将被充值的钱包地址
  • VALUE - 表示代币 wei 值的 32 字节哈希
返回值 DATA - 新创建交易的 32 字节哈希(存储覆盖通过交易提交) 示例请求
example.json
示例响应
example.json

tenderly_addErc20Balance

在提供的 ERC-20 合约上向一个或多个钱包添加指定数量的代币。与 tenderly_setErc20Balance 不同,此方法会为每个被充值的账户发出一个合成的 Transfer 事件,因此索引器、subgraph 以及任何从日志中对账余额的工具都会与最终状态保持同步。 发出的日志使用标准的 ERC-20 Transfer(address,address,uint256) topic,将交易发送方作为 from 地址,将被充值的钱包作为 to 地址,并在 data 字段中携带添加的 amount。 参数
  • TOKEN_ADDRESS - ERC-20 合约的地址
  • WALLETS - 将接收代币的钱包地址数组
  • VALUE - 32 字节哈希,表示向每个钱包添加的代币的 wei 数量
返回值 DATA - 新创建交易的 32 字节哈希(存储覆盖通过交易提交) 示例请求
example.json
示例响应
example.json

tenderly_setMaxErc20Balance

在提供的 erc20 合约上,将钱包地址充值至最大可能的代币余额(主要用于没有简单余额映射的代币)。
与 tenderly_setErc20Balance 类似,此方法直接写入存储,不会发出 ERC-20 Transfer 事件。当您需要索引器或基于日志的工具捕获余额变化时,请使用 tenderly_addErc20Balance。
参数
  • YIELD_TOKEN_ADDRESS - ERC20 合约的地址
  • WALLET - 将被充值的钱包地址
返回值 DATA - 新创建交易的 32 字节哈希(存储覆盖通过交易提交) 示例请求
example.json
示例响应
example.json

tenderly_setStorageAt

在提供地址的指定存储槽上设置存储。 参数
  • ADDRESS - 要覆盖存储的地址
  • SLOT - 表示存储槽键的 32 字节哈希
  • VALUE - 表示键 slot 处值的 32 字节哈希
返回值
  • DATA - 新创建交易的 32 字节哈希(存储覆盖通过交易提交)
示例请求
example.json
示例响应
example.json

tenderly_setCode

替换所提供地址的字节码。该账户的 nonce 和 storage 保持不变。 参数
  • ADDRESS - 要替换字节码的地址
  • BYTECODE - 要部署到 ADDRESS 的 runtime 字节码,十六进制编码
返回值
  • DATA - 新创建交易的 32 字节哈希(代码覆盖通过交易提交)
示例请求
example.json
示例响应
example.json
部署修改过的字节码会破坏目标地址的验证信息,因此该地址不再提供 trace 和 Debugger。完整示例见字节码部署作弊码。

evm_snapshot

返回一个快照 ID,让您可以将 Virtual Environment 回退到先前的时间点(与 evm_getLatest 中的区块 hash 相同)。 参数 返回值
  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 个区块之前的时间点,请改为在目标历史区块处 fork Virtual Environment。 参数
  • DATA - 快照的 ID
返回值
  • BOOLEAN - 操作成功标志
示例请求
example.json
示例响应
example.json

Network Mirror Mode 同步控制

以下方法控制 Network Mirror Mode Virtual Environment 上的同步:启动和停止持续同步、同步固定数量的区块、回退已同步的区块,以及报告同步任务的进度。它们仅适用于 Network Mirror Mode Virtual Environment。
当 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 之前替换这些区块。 tenderly_startSync 和 tenderly_syncBlocks 接受的可选 blockTimeSec 设置指定任务在同步区块之间等待的秒数。0 表示以区块能够执行的最快速度同步。各网络的默认值和允许范围:

tenderly_startSync

从 Virtual Environment 的当前头部开始持续同步。任务逐个同步父网络区块,并持续跟随父网络,直到您调用 tenderly_stopSync。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 当前头部之后的区块开始,然后停止。Virtual Environment 内存池中的交易会以 FIFO 顺序前置到下一个同步的区块中。任务创建后调用即返回;使用 tenderly_getSyncStatus 跟踪进度。 参数
  • QUANTITY - 要同步的区块数,可以是十进制数字或十六进制字符串。必须大于零。
  • OBJECT (可选) - 同步配置:
    • blockTimeSec - NUMBER,同步区块之间的秒数。默认为该网络的出块时间。
返回值
  • OBJECT - 创建的同步任务:
    • syncId - STRING,同步任务的 ID
    • startBlock - QUANTITY,任务同步的第一个父网络区块
    • targetBlock - QUANTITY,任务同步的最后一个父网络区块
示例请求
example.json
示例响应
example.json

tenderly_rewindSync

回退 Virtual Environment 上最近 N 个已同步的区块,并丢弃它们产生的状态。下一个同步任务从 Virtual Environment 的新头部开始。请先停止正在运行的同步:任务运行期间调用会返回错误 cannot rewind while a chain sync is running; stop the sync first。 参数
  • QUANTITY - 要回退的区块数,1 到 100,可以是十进制数字或十六进制字符串。
返回值
  • OBJECT - 回退结果:
    • targetHash - DATA,回退后 Virtual Environment 所在区块的 32 字节哈希
    • 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