fuming/hardhat-node

fuming/hardhat-node

镜像概述

本镜像封装了Hardhat Node实例，Hardhat是生态常用的开发框架，可快速启动本地节点，为智能合约开发、测试与调试提供便捷环境。

核心功能

1. 提供本地***节点环境，支持智能合约部署、交互与调试
2. 支持从主流***网络（如主网）分叉，模拟真实链上场景
3. 可配置端口映射，方便外部应用或工具连接节点

使用场景

• ***智能合约开发者本地验证合约逻辑
• DApp开发过程中模拟链上交互行为
• 测试网络分叉后的合约兼容性与性能

配置说明

• 端口映射：默认使用8545端口，需将容器端口映射到主机端口（如-p 8545:8545）
• 网络分叉：通过--fork参数指定目标网络RPC地址（如Infura主网地址）

部署示例

Docker Run命令

普通运行

bash
docker run -it -d --name hardhat-node-instance -p 8545:8545 fuming/hardhat-node:latest

网络分叉运行

bash
docker run -it -d --name hardhat-node-instance -p 8545:8545 fuming/hardhat-node:latest --fork https://mainnet.infura.io/v3/<你的Infura密钥>

Docker Compose配置

yaml
version: '3'
services:
  hardhat-node:
    image: fuming/hardhat-node:latest
    container_name: hardhat-node-instance
    ports:
      - "8545:8545"

Dockerfile说明

基于node:lts-alpine3.22镜像构建，安装指定版本Hardhat（v2.24.3），配置节点允许相同时间戳的区块，暴露8545端口并启动节点。

Dockerfile
FROM node:lts-alpine3.22
WORKDIR /root/hardhat-node
RUN npm install --save-dev hardhat@2.24.3
RUN echo "/** @type import('hardhat/config').HardhatUserConfig */" > hardhat.config.js \
    && echo "module.exports = {" >> hardhat.config.js \
    && echo "  networks: {" >> hardhat.config.js \
    && echo "    hardhat: {" >> hardhat.config.js \
    && echo "      allowBlocksWithSameTimestamp: true" >> hardhat.config.js \
    && echo "    }" >> hardhat.config.js \
    && echo "  }" >> hardhat.config.js \
    && echo "};" >> hardhat.config.js
EXPOSE 8545
ENTRYPOINT ["npx", "hardhat", "node", "--hostname", "0.0.0.0", "--port", "8545"]