本地AvalancheGo节点部署Hardhat合约遇链未启动错误求助

核心解决方案：修正AvalancheGo启动参数 #

你的问题根源是单节点未明确禁用bootstrap节点检测，导致链一直无法完成启动。使用以下完整启动命令即可解决：

./avalanchego --network-id=local --staking-enabled=false --bootstrap-ids="" --snow-sample-size=1 --snow-quorum-size=1

各参数作用：

• --network-id=local：锁定本地测试网络环境，避免连接外部节点
• --staking-enabled=false：关闭质押机制，单节点无需验证人身份
• --bootstrap-ids=""：关键参数，明确设置空的bootstrap节点列表，彻底跳过外部节点同步检查，让单节点直接完成启动
• --snow-sample-size=1 & --snow-quorum-size=1：适配单节点共识逻辑，覆盖默认的多节点集群共识参数

验证节点启动状态 #

等待节点日志输出类似"chain finished bootstrapping"的信息（C、P、X链均会输出），也可通过API手动验证C链状态：

curl -X POST --data '{"jsonrpc":"2.0","method":"info.isBootstrapped","params":{"chain":"C"},"id":1}' localhost:9650/ext/info

返回{"result":{"isBootstrapped":true}}即说明C链已就绪。

Hardhat配置适配 #

在hardhat.config.js中添加本地Avalanche网络配置：

module.exports = {
  solidity: "0.8.20", // 根据你的合约版本调整
  networks: {
    avalancheLocal: {
      url: "http://localhost:9650/ext/bc/C/rpc", // 本地C链RPC地址
      chainId: 43112, // 本地Avalanche C链专属chainId
      accounts: ["0x56289e99c94b6912bfc12adc093c9b51124f0dc54ac7a766b2bc5ccf558d8027"] // 本地节点默认测试账户私钥
    }
  }
};

执行部署命令：

npx hardhat run scripts/deploy.js --network avalancheLocal

常见注意事项 #

• 必须等待节点完全启动后再执行部署，避免过早触发API拒绝错误
• 不要省略--bootstrap-ids=""，这是解决"no provided bootstraps"日志问题的核心
• 若使用自定义测试账户，确保私钥对应账户有足够的AVAX测试币（本地节点启动时默认账户会预充测试币）

内容的提问来源于stack exchange，提问作者János