如何在TypeScript测试中无缝引用Anvil部署的合约及优化测试方案？

一、自动部署合约，彻底告别硬编码地址 #

不用单独写部署脚本再手动抄地址，直接在TypeScript测试的前置流程中完成合约部署，全程自动化：

• 在测试文件的beforeAll或beforeEach钩子中，通过viem的deployContract函数连接Anvil节点，直接部署合约。
• 部署完成后直接拿到合约地址和实例，后续测试用例直接调用，完全不需要手动记录或硬编码。

示例代码：

import { createPublicClient, createWalletClient, http, deployContract } from 'viem'
import { privateKeyToAccount } from 'viem/accounts'
import { foundry } from 'viem/chains'
import MyContract from '../artifacts/MyContract.json'

// 连接Anvil本地节点
const publicClient = createPublicClient({
  chain: foundry,
  transport: http('http://localhost:8545'),
})

// 使用Anvil默认测试账户
const testAccount = privateKeyToAccount('0xac0974bec39a17e36ba4a6b4d238ff949bacb478cbed5efcae784d7bf4f2ff80')
const walletClient = createWalletClient({
  account: testAccount,
  chain: foundry,
  transport: http('http://localhost:8545'),
})

let contractAddress: `0x${string}`

// 所有测试执行前完成合约部署
beforeAll(async () => {
  const deployHash = await deployContract(walletClient, {
    abi: MyContract.abi,
    bytecode: MyContract.bytecode as `0x${string}`,
    // 传入合约构造函数参数（如果有）
    args: ['initialValue'],
  })

  // 获取部署完成后的合约地址
  const receipt = await publicClient.waitForTransactionReceipt({ hash: deployHash })
  contractAddress = receipt.contractAddress!
})

test('验证合约核心功能', async () => {
  // 直接使用自动部署的合约地址调用合约
  const result = await publicClient.readContract({
    address: contractAddress,
    abi: MyContract.abi,
    functionName: 'getSomeValue',
  })
  expect(result).toEqual('initialValue')
})

如果需要每个测试用例隔离环境，把部署逻辑放到beforeEach里即可，每个测试都会拿到全新的合约实例，避免测试间的状态污染。

二、链下计算的处理原则 #

链下计算不用全堆在测试文件里，分场景处理更合理：

• 测试专属辅助计算：比如为生成测试输入、验证合约返回值写的临时计算逻辑，直接放在测试用例里就行，逻辑简单且和测试强绑定，无需额外拆分。
• 通用可复用计算：比如签名生成、复杂参数预处理这类可能在前端或其他脚本中也会用到的逻辑，抽成独立的TypeScript工具函数（比如放在utils/目录下），测试时直接导入使用。既保证测试代码简洁，也能避免重复造轮子。
• 合约镜像逻辑计算：如果链下计算是合约逻辑的镜像（比如用来验证合约执行结果的正确性），建议同时在TypeScript和Solidity测试（比如Foundry测试）中实现该逻辑，双向验证确保链上链下逻辑一致。

示例：抽离通用签名生成逻辑

// utils/signature.ts
import { signMessage, hexToBytes } from 'viem'
import type { Account } from 'viem'

export function generateContractAuthSignature(account: Account, payload: string) {
  return signMessage({
    account,
    message: hexToBytes(payload),
  })
}

测试中直接导入使用即可。

内容的提问来源于stack exchange，提问作者Yan Digilov