模拟交易 - Tenderly

自定义 RPC 方法位于 tenderly_ 命名空间下。

这些方法运行于 Node RPC 之上；参见完整的 JSON-RPC 参考以了解所有方法和网络。有两个方法针对给定区块执行单笔交易而不将其发送到链上：

tenderly_simulateTransaction 返回完整的已解码执行结果：日志、调用跟踪、资产变化和余额变化。
tenderly_estimateGas 以同样的方式执行交易，但仅返回 gas 数值。当您需要精确的 gas 值而无需完整模拟负载时使用此方法。

`tenderly_simulateTransaction`

模拟交易在给定区块上的执行情况。参数

Transaction 交易 OBJECT
- from（可选）STRING：十六进制编码地址
- to STRING：十六进制编码地址
- gas（可选）NUMBER
- maxFeePerGas（可选）NUMBER 最高费用：发送方愿意为每单位 gas 支付的最大总费用（包含网络/基础费用和矿工/优先费），单位为 wei
- maxPriorityFeePerGas（可选）NUMBER 最高优先费：发送方愿意支付给矿工的每单位 gas 最大费用，单位为 wei
- gasPrice（可选）NUMBER：发送方愿意支付的 gas 价格，单位为 wei
- value（可选）NUMBER
- data（可选）STRING：十六进制编码字节
- accessList（可选）ARRAY，元素为访问列表条目 OBJECT
  - address STRING 十六进制编码地址
  - storageKeys ARRAY，元素为 32 字节十六进制编码存储键的 STRING 表示
Simulation Block Number（可选）交易应据以模拟的区块号。可为：
- STRING 区块号
- ENUM 区块标签 earliest|finalized|safe|latest|pending
State Overrides（可选）MAP：从账户（地址）到覆盖规范的映射
- key STRING：此覆盖适用的账户
- value OBJECT：覆盖规范
  - nonce（可选）STRING：账户的十六进制编码 8 字节 nonce 覆盖
  - code（可选）STRING：账户代码覆盖的数据
  - balance（可选）STRING：账户十六进制编码 32 字节余额覆盖，单位为 wei
  - stateDiff（可选）MAP：存储键到存储值覆盖的映射
    - key STRING：存储键
    - value STRING：给定存储键的值覆盖
Block Overrides（可选）OBJECT：区块中要覆盖的头字段集。
- number （可选） STRING：hex，覆盖区块号
- difficulty （可选） STRING：hex，覆盖区块难度
- time（可选）STRING：hex，覆盖区块时间戳
- gasLimit （可选） STRING：hex，覆盖 gas 限制
- coinbase （可选） STRING：hex，覆盖区块矿工
- random （可选） STRING：hex，覆盖区块的额外数据，该数据将输入到 RANDOM 操作码
- baseFee （可选） STRING：hex，覆盖区块基础费

示例

example.json
example
example.js
example.json

example.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "method": "tenderly_simulateTransaction",
  "params": [
    {
      "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "data": "0xa9059cbb00000000000000000000000020a5814b73ef3537c6e099a0d45c798f4bd6e1d60000000000000000000000000000000000000000000000000000000000000001"
    },
    "0xF4D880"
  ]
}

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": "tenderly_simulateTransaction",
"params": [
{
"from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"data": "0xa9059cbb00000000000000000000000020a5814b73ef3537c6e099a0d45c798f4bd6e1d60000000000000000000000000000000000000000000000000000000000000001"
},
"0xF4D880"
]
}'

example.js

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

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

// Execute method
const result = await provider.send('tenderly_simulateTransaction', [

{
from: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
to: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
data: '0xa9059cbb00000000000000000000000020a5814b73ef3537c6e099a0d45c798f4bd6e1d60000000000000000000000000000000000000000000000000000000000000001',
},
'0xF4D880',
]);

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

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

example.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
  "status": true,
  "gasUsed": "0xc94e",
  "cumulativeGasUsed": "0x0",
  "blockNumber": "0x1103aae",
  "type": "0x0",
  "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000002000000080000000000000000000000000000000000000000000008000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000010000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000020000000000000000000000000000000000200000800000000000000000000000000000000000000000000000000000",
  "logs": [
{
  "name": "Transfer",
  "anonymous": false,
  "inputs": [
{
  "value": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "type": "address",
  "name": "src"
},
{
  "value": "0x20a5814b73ef3537c6e099a0d45c798f4bd6e1d6",
  "type": "address",
  "name": "dst"
},
{
  "value": "1",
  "type": "uint256",
  "name": "wad"
}
  ],
  "raw": {
  "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "topics": [
  "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
  "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",
  "0x00000000000000000000000020a5814b73ef3537c6e099a0d45c798f4bd6e1d6"
  ],
  "data": "0x0000000000000000000000000000000000000000000000000000000000000001"
}
}
  ],
  "trace": [
{
  "type": "CALL",
  "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "gas": "0xbeb6dbc",
  "gasUsed": "0x750a",
  "value": "0x0",
  "input": "0xa9059cbb00000000000000000000000020a5814b73ef3537c6e099a0d45c798f4bd6e1d60000000000000000000000000000000000000000000000000000000000000001",
  "decodedInput": [
{
  "value": "0x20a5814b73ef3537c6e099a0d45c798f4bd6e1d6",
  "type": "address",
  "name": "dst"
},
{
  "value": "1",
  "type": "uint256",
  "name": "wad"
}
  ],
  "method": "transfer",
  "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
  "decodedOutput": [
{
  "value": true,
  "type": "bool",
  "name": ""
}
  ],
  "subtraces": 0,
  "traceAddress": [
  0
  ]
}
  ],
  "assetChanges": [
{
  "assetInfo": {
  "standard": "ERC20",
  "type": "Fungible",
  "contractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "symbol": "weth",
  "name": "WETH",
  "logo": "https://assets.coingecko.com/coins/images/2518/large/weth.webp?1628852295",
  "decimals": 18,
  "dollarValue": "1834.6199951171875"
},
  "type": "Transfer",
  "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "to": "0x20a5814b73ef3537c6e099a0d45c798f4bd6e1d6",
  "rawAmount": "0x1",
  "amount": "0.000000000000000001",
  "dollarValue": "0.0000000000000018346199951171875"
}
  ],
  "balanceChanges": [
{
  "address": "0x20a5814b73ef3537c6e099a0d45c798f4bd6e1d6",
  "dollarValue": "0.0000000000000018346199951171875",
  "transfers": [
  0
  ]
},
{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "dollarValue": "-0.0000000000000018346199951171875",
  "transfers": [
  0
  ]
}
  ]
}
}

结果模拟结果 OBJECT

status NUMBER：``1（成功）或 0（失败）
gasUsed NUMBER：单笔交易本身使用的 gas 数量
cumulativeGasUsed NUMBER：该交易在区块中执行时使用的总 gas 数量
blockNumber NUMBER：该交易被模拟所在的区块号
type NUMBER：交易类型，0x00 为传统交易，0x01 为访问列表类型，0x02 为动态费用
logsBloom STRING：供轻客户端快速检索相关日志的布隆过滤器
logs：发出的事件数组 ARRAY，元素为 OBJECT
- name STRING：事件名称
- anonymous BOOLEAN：指示事件是否为匿名
- inputs：已解码日志参数数组 ARRAY，元素为已解码日志 OBJECT
  - name STRING：事件参数名称
  - type STRING：来自 Solidity 类型系统的事件参数类型
  - value（可选）STRING：参数值的字符串表示；请根据 type 字段解读
- raw OBJECT：原始日志
  - address STRING 十六进制编码地址：发出日志的合约地址
  - topics ARRAY，元素为 STRING 32 十六进制编码字节
  - data STRING 表示事件数据的十六进制编码字符串
trace：跟踪 ARRAY，元素为 OBJECT
- type STRING 类型：跟踪项类型——CALL、CALLCODE、STATICCALL、DELEGATECALL、CREATE、CREATE2、SELFDESTRUCT 之一
- from STRING：十六进制编码地址
- to STRING：十六进制编码地址
- gas STRING：表示事件 gas 的十六进制编码无符号 64 字节整数
- gasUsed STRING：表示事件 gasUsed 的十六进制编码无符号 64 字节整数
- value STRING：表示事件 value（单位 wei）的十六进制编码无符号 64 字节整数
- error STRING：来自虚拟机的低级错误
- errorReason STRING：回滚时提取的错误原因
- input STRING：表示跟踪点原始输入字节的十六进制编码字符串
- method STRING：被调用的合约方法
- decodedInput：被调用方法的已解码输入——ARRAY，元素为已解码入参 OBJECT
  - value STRING：参数值的字符串表示；请根据 type 字段解读。
  - type STRING：该参数的 Solidity 类型
  - name STRING：该参数的名称
- output STRING：原始跟踪输出
- decodedOutput：被调用方法的已解码输出——ARRAY，元素为已解码出参 OBJECT
  - value STRING：参数值的字符串表示；请根据 type 字段解读。
  - type STRING：该参数的 Solidity 类型
  - name STRING：该参数的名称
- subtraces NUMBER：子跟踪数量
- traceAddress：跟踪位置 ARRAY，元素为 NUMBER
assetChanges ARRAY：
- type STRING 资产变化类型，可为 transfer、mint、burn
- from STRING：发送方地址（mint 转账时为空）
- to STRING：接收方地址（burn 转账时为空）
- amount STRING：转移的代币数量
- rawAmount STRING：代币的原始转移数量
- dollarValue STRING：转移代币的美元价值
- assetInfo OBJECT：资产信息
  - standard STRING：受支持的代币标准：ERC20、ERC721、NativeCurrency
  - type STRING：代币类型：Native、Fungible、Non-Fungible
  - contractAddress STRING：合约地址
  - symbol STRING：代币符号
  - name STRING：代币名称
  - logo STRING：代币图标的 URL
  - decimals NUMBER：代币小数位数
  - dollarValue STRING：单个代币的美元价值
balanceChanges ARRAY：余额变化数组——累计资产变化
- address STRING 地址
- dollarValue STRING：累计资产变化的美元价值
- transfers ARRAY：资产变化索引数组

`tenderly_estimateGas`

为给定交易计算精确的 gas 估算，可选地采用类似模拟的状态和区块覆盖。即便指定的 gas 不足，估算也基于完全执行的交易，因此返回值是准确的。相反，eth_estimateGas 可能会回滚并给出低估值。 与 tenderly_simulateTransaction 的差异：

两种方法都以相同方式针对给定区块执行交易，并且都接受相同的状态和区块覆盖。
tenderly_simulateTransaction 返回完整的已解码执行结果：日志、调用跟踪、资产变化和余额变化。
tenderly_estimateGas 仅返回两个 gas 数值：推荐 gas 限制和实际消耗的 gas。当您只需要 gas 值时使用它；当您需要预览交易效果时，请使用 tenderly_simulateTransaction。

参数

Transaction 交易 OBJECT：结构与 tenderly_simulateTransaction 相同（from、to、gas、gasPrice、value、data、accessList）
Simulation Block Number（可选）执行交易所依据的区块号。可为：
- STRING 区块号
- ENUM 区块标签 earliest|finalized|safe|latest|pending
State Overrides（可选）MAP：从账户（地址）到覆盖规范的映射，结构与 tenderly_simulateTransaction 相同
Block Overrides（可选）OBJECT：区块中要覆盖的头字段集，结构与 tenderly_simulateTransaction 相同

示例

example.json
example
response.json

example.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "method": "tenderly_estimateGas",
  "params": [
    {
      "from": "0x8516feaea147ea0db64d1c5b97bb651ca5435155",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "data": "0xa9059cbb0000000000000000000000003fc3c4c84bdd2db5ab2cc62f93b2a9a347de25fb00000000000000000000000000000000000000000000001869c36187f3430000",
      "value": "0x0"
    },
    "21285787"
  ]
}

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": "tenderly_estimateGas",
"params": [
{
"from": "0x8516feaea147ea0db64d1c5b97bb651ca5435155",
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"data": "0xa9059cbb0000000000000000000000003fc3c4c84bdd2db5ab2cc62f93b2a9a347de25fb00000000000000000000000000000000000000000000001869c36187f3430000",
"value": "0x0"
},
"21285787"
]
}'

response.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "gas": "0x12579",
    "gasUsed": "0xff06"
  }
}

结果 Gas 估算 OBJECT

gas STRING：十六进制编码的推荐 gas 限制，用于交易设置（在实际消耗 gas 的基础上包含安全余量）
gasUsed STRING：十六进制编码的已执行交易实际消耗 gas 数量

​tenderly_simulateTransaction

​tenderly_estimateGas

`tenderly_simulateTransaction`

`tenderly_estimateGas`