部署和验证合约

使用 Foundry 或 Hardhat 将 Solidity 合约部署到 Virtual Environment。部署在 Virtual Environment 上的合约被称为虚拟合约（virtual contracts），会出现在 Contracts 部分的 Virtual Contracts 选项卡下。在部署时验证合约。经过验证的合约会解锁 Debugger、Gas Profiler、Simulator 以及浏览器中更丰富的交易视图。

开始之前

一个 Virtual Environment。从仪表板复制它的 RPC URL。
该 Virtual Environment 上一个已注资的部署者地址。

在 Virtual Environment 上进行验证不需要单独的 access key：RPC URL 本身即用于身份验证，验证器端点就是该 URL 后附加 /verify。

默认情况下，在 Virtual Environment 上验证的合约是私有的。根据公共浏览器的可见性设置，代码可能对外可见。在验证任何您想保密的内容之前，请检查公共浏览器开关和验证可见性。

部署与验证

Foundry
Hardhat

配置 `foundry.toml`

Tenderly 的验证器会将 Solidity 编译器附加到已部署字节码上的元数据哈希与您提交的源代码进行匹配。通过显式设置 cbor_metadata 和 bytecode_hash，将元数据保留在编译输出中：

foundry.toml

[profile.default]
src = "src"
out = "out"
libs = ["lib"]
solc_version = "0.8.24"
optimizer = true
optimizer_runs = 200

# Required for Tenderly contract verification:
# keep the CBOR metadata so the verifier can match the on-chain bytecode hash.
cbor_metadata = true
bytecode_hash = "ipfs"

cbor_metadata = true 和 bytecode_hash = "ipfs" 是 Foundry 的默认值，但某些模板会剥离它们；bytecode_hash = "none" 会破坏验证。固定 solc_version 和 optimizer 设置，以便重新验证时编译出相同的字节码。如果您的项目使用像 OpenZeppelin 这样的库，请在 remappings.txt 中显式声明 remappings：

remappings.txt

@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/
forge-std/=lib/forge-std/src/

使用自动检测的 remappings 时，验证载荷可能包含与构建时使用的不同的 remapping 字符串，从而导致字节码不匹配的失败。

设置环境变量

showLineNumbers

export TENDERLY_VIRTUAL_TESTNET_RPC=...   # paste your RPC URL
export TENDERLY_VERIFIER_URL=$TENDERLY_VIRTUAL_TESTNET_RPC/verify
export PRIVATE_KEY=...                    # deployer private key

在部署之前进行连通性检查。cast chain-id 应打印 Virtual Environment 的链 ID，部署者余额应为非零：

cast chain-id --rpc-url $TENDERLY_VIRTUAL_TESTNET_RPC
cast balance <DEPLOYER_ADDRESS> --rpc-url $TENDERLY_VIRTUAL_TESTNET_RPC

使用 `forge create` 部署

带上 verify 标志运行 forge create。构造函数参数作为原始值传入；Foundry 会对它们进行 ABI 编码，并将编码后的形式提交给验证器：

showLineNumbers

forge create src/Counter.sol:Counter \
  --rpc-url $TENDERLY_VIRTUAL_TESTNET_RPC \
  --private-key $PRIVATE_KEY \
  --broadcast \
  --verify \
  --verifier custom \
  --verifier-url $TENDERLY_VERIFIER_URL \
  --constructor-args 42

将 --constructor-args 放在最后。它会贪婪地吞掉命令行的其余部分，因此放在它之后的任何标志都会被视为另一个构造函数参数。

使用 Foundry 脚本部署

使用 forge script 在一次运行中部署多个合约。脚本中的每个 new Foo(...) 都会自动提交进行验证，构造函数参数会从广播日志中正确获取。导入会被透明处理：验证器会收到一个标准 JSON 载荷，其中包含编译器接触过的每个源文件，因此本地导入和库导入（例如 OpenZeppelin）无需额外步骤即可完成验证。使用 --slow 让交易一次发送一笔。不加它，广播批处理可能在上一笔交易被确认之前提交下一笔，这在托管 RPC 上不稳定，并且可能与验证步骤发生竞争。

showLineNumbers

forge script script/Counter.s.sol:CounterScript \
  --rpc-url $TENDERLY_VIRTUAL_TESTNET_RPC \
  --private-key $PRIVATE_KEY \
  --broadcast \
  --slow \
  --verify \
  --verifier custom \
  --verifier-url $TENDERLY_VERIFIER_URL

验证已有的合约

已经部署的合约可以使用 forge verify-contract 验证。与 forge create 不同，此命令期望构造函数参数已经过 ABI 编码；请使用 cast abi-encode 生成它们：

showLineNumbers

forge verify-contract $COUNTER_ADDRESS src/Counter.sol:Counter \
  --verifier custom \
  --verifier-url $TENDERLY_VERIFIER_URL \
  --constructor-args $(cast abi-encode "constructor(uint256)" 42) \
  --watch

--watch 会轮询验证器直到验证完成并打印结果。对于多合约部署，请为每个已部署地址运行一次 forge verify-contract。

@tenderly/hardhat-tenderly 插件与 Hardhat 的兼容版本最高为 2.22.0。支持的版本矩阵参见 Hardhat 验证。

npm install hardhat@2.22.0

安装插件和 CLI

安装 Tenderly Hardhat 插件：

npm install --save-dev @tenderly/hardhat-tenderly

安装 Tenderly CLI 并登录，以便插件可以进行身份验证：

macOS (Homebrew)
Linux
Manual

brew tap tenderly/tenderly
brew install tenderly
tenderly login

curl https://raw.githubusercontent.com/Tenderly/tenderly-cli/master/scripts/install-linux.sh | sudo sh
tenderly login

从发布页面下载最新的二进制文件，将其添加到 $PATH，然后运行：

tenderly login

配置 Hardhat

将 virtualMainnet（或任何为清晰起见以 virtual 为前缀的名称）添加到您的 networks 块，然后添加一个带有您项目和用户名 slug 的 tenderly 块。以 automaticVerifications: true 调用 tenderly.setup()，这样在每次部署时都会验证合约。

hardhat.config.ts

import * as tenderly from "@tenderly/hardhat-tenderly";

tenderly.setup({ automaticVerifications: true });

const config: HardhatUserConfig = {
  solidity: "0.8.19",
  networks: {
    virtualMainnet: {
      url: process.env.TENDERLY_VIRTUAL_MAINNET_RPC!,
      chainId: 73571, // the Chain ID you selected at Virtual Environment creation
    },
  },
  tenderly: {
    project: "YOUR_PROJECT_SLUG",
    username: "YOUR_USERNAME_SLUG",
  },
};

export default config;

部署

针对您定义的网络运行部署脚本。使用 automaticVerifications: true，插件会在部署时进行验证。

npx hardhat run scripts/deploy.ts --network virtualMainnet

检查仪表板

在 Tenderly Dashboard 中，打开 Contracts 并选择 Virtual Contracts 选项卡。您新部署的合约会显示在那里，并可看到每个合约的验证状态。

故障排除

症状	可能原因	修复
验证器返回 `unauthorized` / `-32004` 响应	验证器 URL 错误。常见错误是附加了 `/verify/etherscan` 而不是 `/verify`。	确保验证器 URL 精确地以 `/verify` 结尾。
`Bytecode does not match deployed contract`	提交的源代码编译结果与部署的不同：`optimizer_runs` 不匹配、`solc_version` 不同或元数据哈希被剥离。	在 `foundry.toml` 中固定 `solc_version`、`optimizer`、`optimizer_runs` 和 `bytecode_hash`。重新验证前运行 `forge clean && forge build`。
`Failed to deserialize content`	验证器返回了一个 Foundry 无法解析的错误字符串，通常包裹着上游身份验证或路径错误。	重新检查 URL 并使用 `-vvvv` 重新运行以查看原始响应。
在 `forge create` 上 `Dry run enabled, not broadcasting transaction`	未传入 `--broadcast`，或被 `--constructor-args` 吞掉。	将 `--constructor-args` 移到最后一个标志。
`forge script` 只有第一个合约被验证	RPC 竞态：第二笔交易在第一笔收据之前就已提交。	添加 `--slow`。
验证器报告 `OK`，但浏览器仍显示未验证	UI 缓存。	硬刷新浏览器页面。API 响应中的状态是权威的。

后续步骤

使用 Foundry 验证代理合约：验证 UUPS 实现及其 ERC1967 代理，包括升级。
暂存合约：与您的团队共享 RPC 链接和合约地址。
暂存您的 dApp：将您的前端指向 Virtual Environment。
Fork Virtual Environment：从 Virtual Environment 状态分支出来。

Getting Started

Simulator

Console

Monitor

Node RPC

Account & Settings

部署和验证合约

开始之前

部署与验证

配置 `foundry.toml`

设置环境变量

使用 `forge create` 部署

使用 Foundry 脚本部署

验证已有的合约

安装插件和 CLI

配置 Hardhat

部署

检查仪表板

故障排除

后续步骤

​开始之前

​部署与验证

​配置 foundry.toml

​设置环境变量

​使用 forge create 部署

​使用 Foundry 脚本部署

​验证已有的合约

​安装插件和 CLI

​配置 Hardhat

​部署

​检查仪表板

​故障排除

​后续步骤

开始之前

部署与验证

配置 `foundry.toml`

设置环境变量

使用 `forge create` 部署

使用 Foundry 脚本部署

验证已有的合约

安装插件和 CLI

配置 Hardhat

部署

检查仪表板

故障排除

后续步骤