分享 Simulator draft 链接

Draft 链接会打开预填好表单的 Tenderly Simulator：单个调用或多调用 bundle，包括状态覆盖、注入的余额和编辑后的合约源码。在接收者点击 Simulate 之前不会执行任何操作，因此可以放心地在测试报告、pull request、治理提案或告警中分享该链接。 Draft 存储在服务端并通过 id 引用。链接本身不携带负载，也不包含项目： https://dashboard.tenderly.co/simulator/new?draftId=<id>

从 dashboard 分享 draft

在 Simulator 中构建模拟：选择网络，添加一个或多个调用，设置覆盖，应用源码编辑。
点击页面标题中的 Share draft。Draft 被保存，链接复制到剪贴板。

该链接支持 bundle 和编辑后的源码，且没有长度限制。从 dashboard 分享的 draft 可由其保存所在项目的成员读取，并会自动过期。

Simulator 标题栏，Simulate 旁边是 Share draft 按钮，提示说明该链接支持 bundle 和编辑后的源码 — Simulator 标题中的 Share draft 保存当前设置并复制一个可重新打开它的链接。

打开 draft 链接时会发生什么

Dashboard 发出一次请求获取 draft，然后根据响应：

Draft 所属项目的成员。 Dashboard 重定向到该项目的 Simulator，表单已预填，没有任何提示。
共享 draft（通过 API 以 shared: true 创建）。首先打开 Select Project 对话框；draft 在接收者选择的项目中打开。
无效的 id、过期的 draft 或没有访问权限。 这三种情况返回相同的响应，因此无法探测 draft id。接收者会看到 “This draft link is invalid, has expired, or you don’t have access to it.” 并回到 dashboard 首页。
未登录。 接收者先登录，然后流程用同一链接继续。
Simulator 中有未保存的编辑。 打开 draft 会替换当前表单，因此 dashboard 会在丢弃编辑之前请求确认。

打开共享 draft 链接时显示的 Select Project 对话框，包含项目下拉框 — 共享 draft 不绑定项目，因此由接收者选择在哪里打开。

部分恢复

Draft 中的每个调用独立恢复，因此一个有问题的调用不会导致整个 draft 被拒绝。一个可关闭的横幅会按调用列出未能恢复的内容：

情况	结果
无法加载合约	地址保留。重新选择合约以重试。
保存的函数不再存在于合约 ABI 中	函数选择框被清空。重新选择函数。
调用携带了导入的 ABI	ABI 文本保留但未重新应用。打开 Edit ABI 并再次导入。
编辑后的源码编译失败	源码保留在调用上；ABI 回退到已验证的合约。打开 Edit source 并重新应用以重试。
无法解析注入的 ERC-20 代币的余额槽位	代币保留在表单中。在 Fund address 中重新选择它以重试。

没有横幅表示一切都已恢复。格式错误的负载，或项目中未启用的网络，会整体拒绝 draft：接收者会看到错误和空表单。

Simulator 中预填了 3 个调用的 bundle，并显示警告横幅，列出合约或函数无法恢复的调用 — 恢复横幅列出 draft 打开后需要处理的调用。

从 CI 或工具创建 draft 链接

使用 drafts API 创建 draft，然后把返回的 id 放入链接。请求使用 access key 进行身份验证；调用者必须是 URL 中项目的成员。 POST https://api.tenderly.co/api/v2/account/{account}/project/{project}/simulation-drafts (API reference)

请求体字段	类型	必填	说明
`payload`	object	是	Draft 负载。按原样存储；API 不验证其结构。格式错误的负载在打开链接时被拒绝，而不是在创建 draft 时。
`shared`	boolean	否	`false`（默认）将 draft 限定在 URL 中的项目：只有该项目的成员可以打开，并且会被直接重定向到该项目。`true` 允许任何已登录的 Tenderly 用户在自己选择的项目中打开 draft。适用于面向组织外部的链接，例如预填提案模拟的治理 UI。

响应为 { "resource_id": "<uuid>" }。

curl -X POST "https://api.tenderly.co/api/v2/account/$ACCOUNT/project/$PROJECT/simulation-drafts" \
  -H "X-Access-Key: $TENDERLY_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "v": 2,
      "network": { "id": "1" },
      "rows": [
        {
          "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
          "inputDataType": "raw",
          "rawFunctionInput": "0xa9059cbb…"
        }
      ]
    }
  }'
# {"resource_id":"3f2a6c1e-…"}

import os, requests

payload = {
    "v": 2,
    "network": {"id": "1"},
    "rows": [
        {
            "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
            "inputDataType": "raw",
            "rawFunctionInput": "0xa9059cbb…",
        }
    ],
}

response = requests.post(
    f"https://api.tenderly.co/api/v2/account/{os.environ['ACCOUNT']}/project/{os.environ['PROJECT']}/simulation-drafts",
    headers={"X-Access-Key": os.environ["TENDERLY_ACCESS_KEY"]},
    json={"payload": payload},
)
response.raise_for_status()

url = f"https://dashboard.tenderly.co/simulator/new?draftId={response.json()['resource_id']}"

// Node.js 18+
const payload = {
  v: 2,
  network: { id: "1" },
  rows: [
    {
      contractAddress: "0xdac17f958d2ee523a2206206994597c13d831ec7",
      from: "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
      inputDataType: "raw",
      rawFunctionInput: "0xa9059cbb…",
    },
  ],
};

const response = await fetch(
  `https://api.tenderly.co/api/v2/account/${process.env.ACCOUNT}/project/${process.env.PROJECT}/simulation-drafts`,
  {
    method: "POST",
    headers: {
      "X-Access-Key": process.env.TENDERLY_ACCESS_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ payload }),
  },
);

const { resource_id } = await response.json();
const url = `https://dashboard.tenderly.co/simulator/new?draftId=${resource_id}`;

读取已保存的 draft

GET https://api.tenderly.co/api/v2/account/{account}/project/{project}/simulation-drafts/{id} (API reference) URL 中的项目是调用者自己的项目（任何其可查看的项目）。访问权限由 draft 的可见性决定：

项目范围的 draft 在调用者可查看 draft 来源项目时返回 { "payload": {…}, "account_id": "…", "project_id": "…" }。
共享 draft 返回 { "payload": {…} }，不含来源信息。
其他任何情况（未知 id、过期的 draft、无来源项目的访问权限）返回 404，"slug": "resource_not_found"。

为复杂设置获取正确负载最快的方法：在 Simulator 中构建它，点击 Share draft，然后用复制链接中的 id GET 该 draft。响应是 dashboard 能接受的负载，包括 stateOverrides、customSource 和 fundAddress 的结构。

Draft 负载

字段	类型	必填	说明
`v`	number	是	模式版本。必须为 `2`。
`network`	`{ "id": string }` 或 `null`	是	以字符串表示的 chain id（`"1"` 是 Mainnet，`"56"` 是 BNB Chain，依此类推）。必须是打开 draft 的项目中已启用的网络，否则接收者会收到 “network not available” 错误和空表单。请始终设置它。`null` 可被接受，但会跳过合约查找，使表单基本不可用。Chain id 参见支持的网络。
`rows`	array	是	每个调用一个对象，按执行顺序排列。至少需要一行。参见 Row 字段。会话级设置（区块选择、`from`、L2 参数）取自第一行。

Row 字段

只有 contractAddress 是必填的。不需要的字段可以省略。省略的字段保持表单默认值，未知的额外字段会被忽略。

合约与函数

字段	类型	说明
`contractAddress`	string	必填。 “to” 地址。打开链接时在接收者一侧获取合约及其 ABI。
`inputDataType`	`"decoded"` 或 `"raw"`	选择函数输入模式。`"raw"` 配合 `rawFunctionInput` 使用，`"decoded"` 配合 `contractFunction` 和 `functionInputs` 使用。
`rawFunctionInput`	string	Raw 模式下的十六进制 calldata（`0x…`）。不需要 ABI，是脚本最可靠的选择。
`contractFunction`	object 或 `null`	Decoded 模式的函数引用：`{ "name": string, "selector"?: string, "signature"?: string }`。对象内 `name` 为必填。`selector`（4 字节十六进制，例如 `"0xa9059cbb"`）可选但推荐：它精确匹配，对重载函数安全。没有它时匹配回退到 `name`，可能选到错误的重载。`signature` 仅供参考。
`functionInputs`	array 或 object	Decoded 模式的参数值。推荐：按 ABI 顺序的位置数组，例如 `["0xabc…", "1000000", ["0xa…", "0xb…"]]`。值为字符串、数字或布尔值。数组和元组参数可以直接以嵌套数组或对象传入，无需预先字符串化。也接受键值形式 `{ "input_0": … }`（dashboard 输出的格式）。
`contractAbiImport`	string	预填应用内的 Edit ABI 字段。打开 draft 时不会重新应用：函数匹配使用获取到的 ABI（或编译后的编辑源码），因此该字段不能让 decoded 模式对未验证的合约生效。对这类合约请使用 raw calldata。

交易参数

字段	类型	说明
`from`	string	发送者地址。
`gas`	string 或 number	Gas 限制，例如 `"8000000"`。带 `0x` 前缀的十六进制数量会转换为十进制。
`gasPrice`	string 或 number	以 wei 计的 gas 价格。
`value`	string 或 number	以 wei 计的原生代币价值。

区块选择

字段	类型	说明
`block`	string 或 number	模拟所在的区块号。省略则使用链头。
`blockIndex`	string、number 或 `null`	交易在区块内的位置。`null` 或省略表示区块开头。
`endOfBlock`	boolean	`true` 在区块内所有交易之后运行模拟交易（覆盖 `blockIndex`）。
`usePendingBlock`	boolean	`true` 在 pending 区块上模拟，而不是固定区块号。

关于区块选择和交易索引在 UI 中的行为，参见模拟参数。

L2 参数

这些字段仅适用于 OP-stack 和 Boba 网络。

字段	类型	说明
`depositTx`	boolean	标记为 L2 存款交易。
`mint`	string	存款 mint 数量。

覆盖

字段	类型	说明
`blockHeaderOverrides`	object	`{ "number"?: …, "timestamp"?: … }`，各为字符串、数字或 `null`。覆盖模拟的区块头。
`stateOverrides`	array	按合约的状态覆盖：`{ "id"?: string, "contractAddress": string, "balance": string, "storage"?: [{ "key": string, "value": string }], "code"?: string }`。`id` 可选，缺失时自动生成。`balance` 以 wei 计（`""` 表示不覆盖余额）。`storage` 的键和值为 32 字节十六进制。
`accessList`	array	EIP-2930 访问列表：`{ "address": string, "storageKeys": string[] }`。

资金注入与编辑后的源码

字段	类型	说明
`fundAddress`	object 或 `null`	Fund address cheatcode：`{ "targetAddress": string, "tokens": [{ "tokenAddress": string, "amount": string }] }`。将零地址 `0x0000000000000000000000000000000000000000`用作 `tokenAddress` 可注入原生余额。对于 ERC-20 代币，余额存储槽位在打开 draft 时解析；若无法解析，代币保留在表单中，恢复横幅会提示接收者重新选择。
`customSource`	object 或 `null`	已应用的源码编辑：`{ "compilerInfo": {…}, "customSourceData": [{ "name": string, "source": string, "path": string, "contractName"?: string, "address"?: string }] }`。`compilerInfo` 按原样传给编译器（编译器版本、优化设置、导入 remappings）；其结构请从 dashboard 分享的 draft 中获取。源码在打开 draft 时编译，其 ABI 接管该调用的函数匹配。
`contractSourceEdited`	boolean	标记该调用的源码已编辑。存在 `customSource` 时默认为 `true`。

验证与错误

创建 draft：

响应	含义
`400` `"Draft payload is required"`	`payload` 缺失或为 `null`。
`400` `"Draft payload exceeds the 256KB limit"`	序列化后的 `payload` 超过 256 KB。
`401`	access key 缺失或无效。
`404`	调用者不是 URL 中项目的成员。

打开 draft 在负载层面是全有或全无：错误的 v、缺少 rows 条目、非字符串的 contractAddress，或任何类型错误的 row 字段都会以 “This draft link is invalid or corrupted” 拒绝整个 draft。依赖实时数据的单个调用问题（合约获取、函数匹配、源码编译、代币槽位）按部分恢复中的描述单独降级。

限制

每个 draft 的负载上限为 256 KB，由 API 强制执行。
Draft 会自动过期。过期的 draft 从 API 返回 404，在 dashboard 中显示 “invalid, has expired, or you don’t have access” 消息。
打开 draft 链接需要 Tenderly 账户。共享 draft（shared: true）可由任何已登录用户读取；项目范围的 draft 仅限来源项目的成员。
合约 ABI 在打开链接时获取。若无法解析（未验证的合约），decoded 模式的调用会打开并填入地址，但不选择函数。Raw 模式不受影响。

旧版 `?draft=` 链接

在服务端 draft 出现之前，dashboard 将单个调用直接编码进 URL： https://dashboard.tenderly.co/<org>/<project>/simulator/new?draft=<value> <value> 是版本 1 的负载（{ "v": 1, "network": {…}, "row": {…} }，单个 row 而非 rows），先为 UTF-8 JSON，再进行 base64url 编码（+ 换为 -，/ 换为 _，去掉 = 填充）。现有链接仍可打开。row 对象接受上述 row 字段，但不包括 fundAddress、customSource 和 contractSourceEdited，且整个 URL 必须保持在约 2000 个字符以内。Dashboard 不再生成这种格式；新集成请使用 drafts API。关于 draft 填充的表单字段，参见模拟参数。若要将修改后的状态保留为持久环境而不是一次性模拟，请使用 Virtual Environments。

Getting Started

Simulator

Console

Monitor

Node RPC

AI Tools

Account & Settings

分享 Simulator draft 链接

从 dashboard 分享 draft

打开 draft 链接时会发生什么

部分恢复

从 CI 或工具创建 draft 链接

读取已保存的 draft

Draft 负载

Row 字段

合约与函数

交易参数

区块选择

L2 参数

覆盖

资金注入与编辑后的源码

验证与错误

限制

旧版 `?draft=` 链接

​从 dashboard 分享 draft

​打开 draft 链接时会发生什么

​部分恢复

​从 CI 或工具创建 draft 链接

​读取已保存的 draft

​Draft 负载

​Row 字段

​合约与函数

​交易参数

​区块选择

​L2 参数

​覆盖

​资金注入与编辑后的源码

​验证与错误

​限制

​旧版 ?draft= 链接

从 dashboard 分享 draft

打开 draft 链接时会发生什么

部分恢复

从 CI 或工具创建 draft 链接

读取已保存的 draft

Draft 负载

Row 字段

合约与函数

交易参数

区块选择

L2 参数

覆盖

资金注入与编辑后的源码

验证与错误

限制

旧版 `?draft=` 链接