cat out/.sol/.json | jq .metadata > /tmp/metadata.json
COMPILER_VERSION=$(jq -r .metadata | fromjson | .compiler.version out/.sol/.json)

2. 调用验证 API

cat > /tmp/verify.json << EOF
{
chainId: 10143,
contractAddress: 0xYOURCONTRACTADDRESS,
contractName: src/MyContract.sol:MyContract,
compilerVersion: v${COMPILER_VERSION},
standardJsonInput: $STANDARD_INPUT,
foundryMetadata: $FOUNDRY_METADATA
}
EOF

curl -X POST https://agents.devnads.com/v1/verify \
-H Content-Type: application/json \
-d @/tmp/verify.json

带构造函数参数： 添加 constructorArgs（ABI 编码，不带 0x 前缀）：
bash
ARGS=$(cast abi-encode constructor(string,string,uint256) MyToken MTK 1000000000000000000000000)
ARGSNOPREFIX=${ARGS#0x}

添加到请求中：constructorArgs: $ARGSNOPREFIX

手动验证备用方案（如果 API 失败）：
bash
forge verify-contract --chain 10143 \
--verifier sourcify \
--verifier-url https://sourcify-api-monad.blockvision.org/

钱包持久化

对代理至关重要： 如果为用户生成了钱包，必须持久化保存以供将来使用。

生成新钱包时：

1. 1. 创建钱包：cast wallet new
2. 立即保存 地址和私钥到安全位置
3. 告知用户钱包详情存储位置
4. 部署前通过水龙头为钱包充值

存储选项：

• - 写入 ~/.monad-wallet，权限设为 chmod 600
• 存储在项目特定的 .env 文件中（添加到 .gitignore）
• 将凭证返回给用户，并要求其安全保存

为什么这很重要： 用户需要访问其钱包以：

• - 部署更多合约
• 与已部署的合约交互
• 管理资金
• 验证所有权

部署工作流

使用 forge script 进行部署：

bash
forge script script/Deploy.s.sol:DeployScript \
--rpc-url https://testnet-rpc.monad.xyz \
--private-key $PRIVATE_KEY \
--broadcast

部署脚本模板：

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.27;
import forge-std/Script.sol;
import ../src/MyContract.sol;

contract DeployScript is Script {
function run() external {
vm.startBroadcast();
MyContract contract = new MyContract();
console.log(合约部署地址：, address(contract));
vm.stopBroadcast();
}
}

技术细节

EVM 版本（关键）

始终设置 evmVersion: prague。需要 Solidity 0.8.27+。

Foundry（foundry.toml）：
toml
[profile.default]
evm_version = prague
solc_version = 0.8.28

Foundry 提示

不存在的标志（不要使用）：

• - --no-commit - 对 forge init 或 forge install 无效

部署 - 使用 forge script，而非 forge create：

forge create --broadcast 存在 bug 且经常被忽略。请改用 forge script。

bash
forge script script/Deploy.s.sol:DeployScript \
--rpc-url https://testnet-rpc.monad.xyz \
--private-key $PRIVATE_KEY \
--broadcast

部署脚本不得硬编码地址：

solidity
// ✅ 正确 - 从 --private-key 标志读取私钥
function run() external {
vm.startBroadcast();
new MyContract();
vm.stopBroadcast();
}

// ❌ 错误 - 硬编码地址，导致No associated wallet错误
function run() external {
vm.startBroadcast(0x1234...);
}

前端

从 viem/chains 导入。不要定义自定义链：

ts
import { monadTestnet } from viem/chains;

与 wagmi 一起使用：

ts
import { createConfig, http } from wagmi
import { monadTestnet } from viem/chains

const config = createConfig({
chains: [monadTestnet],
transports: {
[monadTestnet.id]: http()
}
})

示例：部署 ERC20

1. 创建项目：
bash
forge init my-token
cd my-token

2. 配置 foundry.toml：
toml
[profile.default]
src = src
out = out
libs = [lib]
evm_version = prague
solc_version = 0.8.28

3. 创建合约 src/MyToken.sol：
solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.27;

import @openzeppelin/contracts/token/ERC20/ERC20.sol;

contract MyToken is ERC20 {
constructor(uint256 initialSupply) ERC20(MyToken, MTK) {
_mint(msg.sender, initialSupply);
}
}

4. 安装依赖：
bash
forge install OpenZeppelin/openzeppelin-contracts --no-commit

5. 创建部署脚本 script/Deploy.s.sol：
solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.27;
import forge-std/Script.sol;
import ../src/MyToken.sol;

contract DeployScript is Script {
function run() external {
vm.startBroadcast();
MyToken token = new MyToken(1000000 10*18);
console.log(代币部署地址：, address(token));
vm.stopBroadcast();
}