> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tenderly.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulation Mode

> 在 dashboard 中激活持久的钱包模拟上下文。页面以目标钱包的身份呈现，并支持余额覆盖和累积会话日志。

Simulation Mode 是一种持久的模拟上下文。使用钱包地址和网络激活它，dashboard 中每一个已接入该模式的页面都会以该钱包身份读取和模拟。不签名任何内容，也不会上链。模拟会在会话中累积：每次运行都能看到之前运行产生的状态变化。

<Frame caption="Simulation Mode 面板：钱包搜索和三项能力，Fund with any balance、Simulate chained transactions、Read and write contract state。">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/simulator-ui/15-simulation-mode-entry.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=f98768d1c969c634ee11ddbad02ae3ac" alt="Simulation Mode side panel open from the Enter Simulation Mode button, showing wallet search input and three capability descriptions" width="1600" height="1000" data-path="images/simulator-ui/15-simulation-mode-entry.webp" />
</Frame>

## 何时使用

* **在不持有其密钥的情况下浏览钱包的链上行为**。适用于支持、风险审查或事后分析。
* 以特定钱包身份**分阶段执行一系列操作**（例如 supply、borrow、repay）并检查累积的状态影响。
* **从钱包视角在合约 Read/Write 页面、Simulator 和重新模拟流程上进行测试**，而无需每次重新输入地址。
* **动态覆盖代币余额**，测试拥有更多（或更少）资产时某个操作的样子。

如果您只需要一次性模拟或多步骤 bundle，请使用 [Simulator](/simulator-ui/overview)。如果您需要完整的 RPC 环境，请使用 [Virtual Environment](/virtual-environments/overview)。

## 会话如何构建

| 属性      | 行为                                                            |
| ------- | ------------------------------------------------------------- |
| **键**   | `(wallet, network)`。一次只能有一个活动会话。                              |
| **持久性** | 对于同一个 `(wallet, network)` 对，会话在退出并重新进入 Simulation Mode 后仍会保留。 |
| **累积**  | 每次成功的模拟都会追加到会话日志，其状态会延续到下一次模拟。                                |
| **重置**  | **Reset session** 操作会清除活动会话的状态。                               |
| **跨网络** | 切换网络会重置活动会话。                                                  |

## 进入 Simulation Mode

点击顶部栏中的 **Enter Simulation Mode**，或在任何钱包详情页面上使用 **Impersonate** 操作以该钱包预填 Sim Mode。

激活后，顶部栏按钮将被替换为一个 `SIMULATING` 徽章，显示被模拟钱包的身份图标、缩略地址和总美元余额。

<Frame caption="顶部栏中的 Enter Simulation Mode 按钮（非活动状态），以及钱包搜索打开准备接受钱包地址或名称。">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/simulator-ui/16-simulation-mode-wallet-dropdown.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=a823831973c461736ebae3d9e523e56c" alt="Top bar showing Enter Simulation Mode button and the Simulation Mode panel with wallet search input expanded" width="1600" height="1000" data-path="images/simulator-ui/16-simulation-mode-wallet-dropdown.webp" />
</Frame>

## Sim Mode 面板

活动的 Sim Mode 面板锚定在 dashboard 的右上角。它有四个部分：

* **Network 行**：当前网络，带有切换用的下拉菜单。
* **State 行**：区块号、区块位置和时间戳设置（默认：最新区块、区块末尾、自动时间戳）。
* **Wallet 卡片**：身份图标、缩略地址、美元余额和刷新按钮。
* **标签页**：**Tokens** 和 **Simulated transactions**。

### Tokens 标签页

列出被模拟钱包在活动网络上持有的代币。

* 点击任何行上的 **+** 打开一个预填实时余额的内联编辑器。
* 已覆盖的行显示模拟金额、绿色差额徽章（例如 `+123.3K`）、撤销控件和编辑控件。
* 列表顶部显示模拟余额的计数和 **Reset to live** 操作。
* 底部：**+ Add tokens** 为钱包当前未持有的代币打开充值流程。

<Frame caption="Tokens 标签页：顶部有 '1 simulated balance' 计数器和 Reset to live 操作，ETH 行上打开了内联金额编辑器。">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/simulator-ui/30-sim-tokens-with-override.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=0a2f9ff30a42910bd5574106b924063a" alt="Simulation Mode Tokens tab showing 1 simulated balance badge, Reset to live link, and the ETH row with an amount-to-add input field open alongside other token rows" width="1600" height="1000" data-path="images/simulator-ui/30-sim-tokens-with-override.webp" />
</Frame>

### Simulated transactions 标签页

本会话中成功模拟的会话日志。

* 每行：状态点、函数名、相对时间。
* 底部操作栏：**▷ Simulate**（主操作）、**↺ Reset session**、**⚡ Convert to Virtual Environment**、**◆ Send onchain**。

<Frame caption="Simulated transactions 标签页，底部固定 Simulate、Reset 和 Open in Virtual Environment 操作栏。">
  <img src="https://mintcdn.com/tenderly/XsEZlaGXYskrtN68/images/simulator-ui/28-sim-mode-txs-action-bar.webp?fit=max&auto=format&n=XsEZlaGXYskrtN68&q=85&s=63a24f90dc9a68825dce814e4d37bad3" alt="Simulation Mode panel showing the Simulated transactions tab with empty session log and the Simulate / Reset / Open in Virtual Environment action bar pinned to the bottom" width="1600" height="1000" data-path="images/simulator-ui/28-sim-mode-txs-action-bar.webp" />
</Frame>

### State 设置

点击 **State** 行以显示底层模拟参数：

| 字段                | 默认值         |
| ----------------- | ----------- |
| Block number      | Latest      |
| Position in block | At end      |
| Block timestamp   | Auto        |
| Gas               | `8,000,000` |
| Gas price         | `0`         |
| Value             | `0`         |

## 切换网络

网络选择器**按被模拟钱包的总价值降序排列**，每个网络都有余额预览。

切换网络会**重置活动会话**。新网络从空白开始，没有余额覆盖，模拟日志为空。

## 已接入的界面

当 Simulation Mode 激活时，这些界面会自动采用会话上下文：

| 界面                           | 行为                                                                       |
| ---------------------------- | ------------------------------------------------------------------------ |
| **Simulator**                | 发送方预填为被模拟的钱包。成功的模拟会追加到会话日志。                                              |
| **合约 Read/Write 页面**         | 紫色横幅指示 Sim Mode 已激活。Write 按钮被隐藏。Simulate 成为主要操作。`From` 字段自动填充被模拟的钱包。     |
| **Re-Simulate（tx 和 sim 详情）** | Re-Simulate 下拉菜单会新增 **Re-simulate as \[wallet]** 选项。从这里进行的重新模拟不会追加到会话日志。 |
| **钱包详情页**                    | **Impersonate** 按钮位于 Create Alert 和 Simulate 之间。以该钱包预填 Sim Mode。         |

### 跨网络不匹配

如果您打开的页面所在网络与您的活动 Sim Mode 会话不同，横幅会提供一键 **Switch Sim Mode to \[network]** 选项。在切换之前，Read 和 Write 操作将被禁用。

### 替换活动会话

如果您在与活动会话不同的 `(wallet, network)` 对上启动 Simulation Mode 流程，会有一个模态框确认切换。切换会结束活动会话。

## 限制

Simulation Mode 的使用会计入您账户的模拟配额。没有单独的每会话限制。您可以运行的会话数量受您计划允许的模拟数量限制。

## 另请参阅

* [Simulator UI](/simulator-ui/overview)：单次模拟和多步骤 bundle。
* [Virtual Environments](/virtual-environments/overview)：当您需要完整的 RPC 环境时。