Hardhat项目中自定义区块链的配置方法

在区块链开发过程中，开发者经常需要配置自定义的本地开发网络。本文将详细介绍如何在Hardhat项目中，特别是使用hardhat-viem插件时，正确配置自定义的区块链。

自定义链配置的必要性

当开发者搭建本地区块链开发网络（非Hardhat或Foundry内置网络）时，通常需要在hardhat.config.ts文件中进行网络配置。例如：

config.networks = {
  devnet: {
    chainId: 3113031,
    url: "localhost:mygeth",
    accounts: ["myaccount"],
    gasPrice: '',
    gas: '',
  }
}

然而，使用hardhat-viem插件时，直接这样配置可能会遇到错误提示，指出无法识别指定的chainId。

解决方案：使用viem的defineChain

要解决这个问题，我们可以利用viem库提供的defineChain方法来明确定义自定义链。这种方法不仅解决了识别问题，还提供了更灵活的链配置选项。

实现步骤

1. 首先导入必要的模块：

import hre from "hardhat";
import { defineChain } from "viem";

2. 定义自定义链的详细配置：

const myChain = defineChain({
  name: "mygeth",  // 自定义链名称
  id: 3113031,     // 链ID
  nativeCurrency: {
    name: "mygeth",
    symbol: "mygeth",
    decimals: 18,   // 原生货币小数位数
  },
  rpcUrls: {
    default: {
      http: ["http://localhost:mygeth"],  // RPC端点
    },
  },
});

3. 创建客户端时传入自定义链配置：

const publicClient = await hre.viem.getPublicClient({ chain: myChain });
const walletClient = await hre.viem.getWalletClient("0x......", {
  chain: myChain,
});

配置详解

在defineChain方法中，我们可以配置以下关键参数：

• name: 链的名称标识
• id: 链的唯一ID，必须与本地网络的chainId一致
• nativeCurrency: 定义链的原生代币信息
  • name: 代币名称
  • symbol: 代币符号
  • decimals: 小数位数
• rpcUrls: RPC端点配置
  • default: 默认RPC端点
  • 可以配置多个备用端点

实际应用

配置完成后，开发者可以像使用标准链一样使用自定义链：

// 获取区块信息
console.log(await publicClient.getBlock());

// 获取当前链ID
console.log(await walletClient.getChainId());

这种方法不仅适用于本地开发网络，也可以用于连接测试网或私有链等非标准网络环境。

总结

通过viem的defineChain方法，Hardhat开发者可以灵活地配置各种自定义区块链网络，解决了hardhat-viem插件无法自动识别自定义链的问题。这种配置方式清晰明了，且保持了与标准链相同的使用体验，是连接非标准区块链网络的推荐做法。