create-hardhat3-app

Create Hardhat 3 App

构建npm包

# 1. 登录 npm（首次）
npm login

# 2. 检查配置
npm whoami  # 确认登录的账户
npm config list

# 3. 构建项目
npm run build

版本管理

# 更新版本号（自动更新 package.json）
npm version patch  # 1.0.0 -> 1.0.1 (bug 修复)
npm version minor  # 1.0.0 -> 1.1.0 (新功能)
npm version major  # 1.0.0 -> 2.0.0 (破坏性更改)

# 或手动编辑 package.json 中的 version

发布

# 发布到 npm
npm publish

创建新项目

# 使用 npx (推荐)
npx create-hardhat3-app my-project

# 使用 npm
npm create-hardhat3-app my-project

# 使用 yarn
yarn create-hardhat3-app my-project

本地创建

node evm-cli/bin/cli.js test-hardhat-app --package-manager npm

项目创建后

cd my-project
npm run compile  # 编译合约
npm test         # 运行测试
npm run deploy   # 部署合约

生成的项目包含：

合约

• Counter.sol - 示例计数器合约
• Storage.sol - 数据存储示例

测试

• Counter.t.sol - Solidity 测试（Foundry 风格）
• Counter.ts - TypeScript 测试（Mocha + Ethers）

脚本

• deploy.ts - 部署脚本
• utils/helpers.ts - 工具函数

配置

• Hardhat 3 完整配置
• TypeScript 支持
• Hardhat Ignition 集成
• OpenZeppelin 集成

📖 项目结构

my-project/
├── contracts/              # Solidity 合约
│   ├── Counter.sol
│   └── examples/
│       └── Storage.sol
├── test/                   # 测试文件
│   ├── Counter.t.sol      # Solidity 测试
│   └── Counter.ts         # TypeScript 测试
├── scripts/                # 部署和交互脚本
│   ├── deploy.ts
│   └── utils/
├── ignition/              # Hardhat Ignition
│   └── modules/
├── hardhat.config.ts      # Hardhat 配置
├── package.json
├── tsconfig.json
└── README.md