⚡

Midnight开发环境设置 midnight-tooling:midnight-setup

Midnight开发环境搭建指南，提供零知识智能合约和DApp开发所需的完整工具链配置。包括Node.js、Docker、Compact编译器、证明服务器等关键组件的安装与验证步骤，帮助开发者快速搭建隐私优先的区块链开发环境。关键词：Midnight开发环境、零知识证明、智能合约、DApp开发、Compact编译器、区块链工具链、隐私计算、开发环境配置

智能合约 0 次安装 0 次浏览 更新于 2/26/2026

name: midnight-tooling:midnight-setup description: 用于设置Midnight开发环境、安装Compact编译器与开发者工具、配置证明服务器、验证先决条件或开始Midnight开发时使用。

Midnight开发环境设置

指导开发者搭建完整的Midnight开发环境，用于构建零知识智能合约和去中心化应用（dApps）。

先决条件概览

在安装Midnight专用工具前，请验证以下先决条件：

要求 最低版本 推荐版本 检查命令
Node.js 18.x 20.x LTS node --version
npm 9.x 最新版 npm --version
Docker 20.x 最新版 docker --version
Git 2.x 最新版 git --version
Chrome浏览器 最新版 最新版 Lace钱包所需

运行先决条件检查脚本进行验证：

bash ${CLAUDE_PLUGIN_ROOT}/skills/midnight-setup/scripts/check-prerequisites.sh

如需详细验证先决条件：

python3 ${CLAUDE_PLUGIN_ROOT}/skills/midnight-setup/scripts/check-prerequisites.py

安装步骤

1. 通过nvm安装Node.js（推荐）

使用nvm可以方便地进行版本管理：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重启终端或加载配置文件
source ~/.zshrc  # 或 ~/.bashrc

# 安装Node.js 18 LTS
nvm install 18 --lts
nvm alias default 18

重要提示：安装或切换Node版本后，请打开新的终端窗口。仅加载配置文件可能会留下旧的引用。

2. 安装Docker Desktop

从docker.com/products/docker-desktop下载适合您平台的版本。安装后：

  1. 启动Docker Desktop
  2. 等待Docker守护进程启动
  3. 使用docker info验证

3. 安装Compact开发者工具

Compact开发者工具管理编译器版本并提供compact命令行界面：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/midnightntwrk/compact/releases/latest/download/compact-installer.sh | sh

安装后，将二进制文件添加到PATH中。安装程序会显示确切路径，通常为：

# 添加到 ~/.zshrc 或 ~/.bashrc
export PATH="$HOME/.compact/bin:$PATH"

然后重启终端或加载配置文件。

4. 安装Compact编译器

安装开发者工具后，下载编译器：

# 下载最新编译器
compact update

# 验证安装
compact --version          # 显示开发者工具版本
compact compile --version  # 显示编译器版本

5. 拉取证明服务器镜像

证明服务器在本地生成零知识证明：

docker pull midnightnetwork/proof-server:latest

启动证明服务器（开发时需要）：

docker run -p 6300:6300 midnightnetwork/proof-server -- midnight-proof-server --network testnet

6. 安装VS Code扩展（可选）

Midnight Compact VS Code扩展提供语法高亮和智能提示：

  1. 从Compact发布页面下载.vsix文件
  2. 在VS Code中：扩展 → "…"菜单 → “从VSIX安装…”
  3. 选择下载的文件

7. 安装Lace Midnight预览版钱包（可选）

用于使用钱包测试dApps：

  1. 从Chrome网上应用店安装：搜索"Lace Midnight"
  2. 创建新钱包并安全保存种子短语
  3. 从midnight.network/test-faucet/获取测试代币

验证

完成设置后，验证所有功能是否正常：

# 检查所有工具
node --version      # 应为18+
docker info         # 应显示Docker正在运行
compact --version   # 应显示开发者工具版本
compact compile --version  # 应显示编译器版本

# 检查证明服务器镜像
docker images | grep proof-server

或运行环境检查命令：/midnight:check

Compact开发者工具参考

命令 用途
compact update 下载/更新到最新编译器
compact update <版本> 切换到特定版本
compact list 显示所有可用版本
compact list --installed 显示本地安装的版本
compact check 检查更新但不下载
compact compile <文件> <输出目录> 编译合约
compact compile +0.25.0 <文件> <输出目录> 使用特定版本编译
compact self update 更新开发者工具本身
compact help 显示帮助

常见设置问题

问题 解决方案
compact: command not found 将~/.compact/bin添加到PATH，重启终端
安装后Node版本错误 打开新终端窗口
Docker守护进程未运行 启动Docker Desktop应用程序
证明服务器无法启动 检查Docker是否运行，端口6300是否空闲

其他资源

  • references/installation-steps.md - 详细的平台特定说明
  • references/bun-setup.md - 使用Bun运行时的替代设置

如需故障排除，请使用/midnight:doctor命令或参考midnight-debugging技能。