# 午夜基础设施设置使用官方“midnight-infra-dev-tools”在本地运行 Midnight 基础设施的完整指南。这使得无需连接到测试网即可进行完整的本地开发。 ## 架构概述 ┌────────────────────────────────────────────────────────────────┐ │ 本地开发堆栈 │ ├────────────────────────────────────────────────────────────────┤ │ │ │ ┌────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ │ │ 午夜节点 │ │ 索引器 │ │ 证明服务器 │ │ │ │ │ │ │ │ │ │ │ │ ws://127.0.0.1 │ │ http://127.0.0.1 │ http://127.0.0.1 │ │ │ │ :9944 │ │ :8088 │ │ :6300 │ │ │ │ │ │ │ │ │ │ │ │ - 区块链 │ │ - 查询状态 │ │ - ZK 证明 │ │ │ │ - 共识 │ │ - 索引交易 │ │ - 验证 │ │ │ - 状态 │ │ - GraphQL API │ │ - 电路 │ │ │ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ │ │ │ │ │ │ │ └──────────────────┼────────────────────┘ │ │ │ │ │ ┌────────────┴────────────┐ │ │ │ 你的 dApp / 测试 │ │ │ └────────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────────┘ ## 何时使用 * 设置本地Midnight开发环境 * 在本地运行节点、索引器和证明服务器 * 解决基础设施问题 * 同步组件版本 * 无需测试网即可构建/测试 ## 官方存储库组件|存储库 |目的 ---|---|--- **开发工具** | [midnight-infra-dev-tools]() |本地设置的脚本和指南 **节点** | [午夜节点]() |区块链节点（基于Substrate） **索引器** | [午夜索引器]() |状态索引和 GraphQL API **分类帐** | [午夜分类帐]() |证明服务器和 ZK 电路 ## 快速入门 ### 第 1 步：克隆开发工具 git 克隆 https://github.com/midnightntwrk/midnight-infra-dev-tools.git cd 午夜基础设施开发工具 ### 第 2 步：选择提交版本开发工具允许您为每个组件选择特定的提交以确保兼容性。 # 检查可用版本猫版本.json # 或者在配置中选择特定提交 ### 步骤 3：克隆组件存储库 # 克隆节点 git 克隆 https://github.com/midnightntwrk/midnight-node.git # 克隆索引器 git 克隆 https://github.com/midnightntwrk/midnight-indexer.git # 克隆账本（证明服务器） git 克隆 https://github.com/midnightntwrk/midnight-ledger.git ### 第 4 步：启动基础设施 # 启动所有三个组件 ./scripts/start-all.sh # 或者单独开始： ./scripts/start-node.sh ./scripts/start-indexer.sh ./scripts/start-proof-server.sh ## 组件详细信息 ### 午夜节点区块链节点处理共识、状态管理和事务处理。 **默认端点：** `ws://127.0.0.1:9944` # 启动节点 cd 午夜节点货物构建--发布 ./target/release/midnight-node --dev # 或者使用 Docker docker run -p 9944:9944 midnightntwrk/midnight-node:latest --dev **主要特点：** * 基于Substrate的区块链 * 区块生产 * 交易池 * 状态存储 ### 午夜索引器索引区块链状态并提供用于查询的 GraphQL API。 **默认端点：** `http://127.0.0.1:8088` # 启动索引器 CD 午夜索引器 npm 安装 npm 运行开始 # GraphQL 游乐场位于： # http://127.0.0.1:8088/graphql **主要特点：** * 实时状态索引 * GraphQL API * 合约状态查询 * 交易历史 **重要：** 索引器必须与节点版本同步。更改节点提交时更新索引器解释的元数据。 ### 证明服务器（账本）生成并验证交易的零知识证明。 **默认端点：** `http://127.0.0.1:6300` # 启动证明服务器 CD午夜分类账货物构建--发布 ./target/release/proof-server # 或者使用 Docker docker run -p 6300:6300 Midnightntwrk/proof-server:最新 **关键：** 证明服务器必须使用集成到“午夜节点”中的相同账本版本。检查版本：午夜节点/Cargo.toml 第 63-70 行来自 Cargo.toml 的示例： [依赖项] 午夜分类帐 = { git = "https://github.com/midnightntwrk/midnight-ledger", rev = "abc123" } ## 版本同步 ### 为什么版本匹配很重要所有三个组件必须版本兼容： * 节点生成具有特定账本格式的区块 * 索引器使用匹配的元数据解析块 * 证明服务器生成账本版本的证明 ### 检查版本 # 检查节点的账本依赖关系 grep“午夜分类帐”午夜节点/Cargo.toml # 检查索引器元数据版本猫午夜索引器/元数据/version.json # 验证证明服务器版本 ./proof-server --version ### 将索引器同步到节点当您更改节点提交时： 1.在node的Cargo.toml中找到账本版本 2. 更新索引器元数据以匹配 3. 重新启动索引器以重新索引 # 更新索引器元数据 CD 午夜索引器 ./scripts/update-metadata.sh <节点提交> npm 运行重建索引 ## 配置 ### 网络配置为您的 dApp 创建配置文件： // 配置.ts 导出 const localConfig = { 节点：{ 网址：“ws://127.0.0.1:9944”， }, 索引器：{ 网址：“http://127.0.0.1:8088”， graphql：“http://127.0.0.1:8088/graphql”， }, 证明服务器：{ 网址：“http://127.0.0.1:6300”， }, }; 导出常量 PreviewConfig = { 节点：{ url: "wss://rpc.preview.midnight.network", }, 索引器：{ url: "https://indexer.preview.midnight.network", graphql：“https://indexer.preview.midnight.network/graphql”， }, 证明服务器：{ url: "https://proof.preview.midnight.network", }, }; ### 环境变量 # .env.local MIDNIGHT_NODE_URL=ws://127.0.0.1:9944 MIDNIGHT_INDEXER_URL=http://127.0.0.1:8088 MIDNIGHT_PROOF_SERVER_URL=http://127.0.0.1:6300 ## 与入门模板一起使用入门模板与本地基础设施集成： # 克隆启动模板 git 克隆 https://github.com/MeshJS/midnight-starter-template.git cd 午夜入门模板 # 安装依赖项 npm 安装 # 启动本地基础设施（使用 Docker） npm 运行安装程序-独立 # 在另一个终端中，启动前端 npm 运行 dev:前端 ## 故障排除 ### 节点无法启动错误：无法绑定到端口 9944 **解决方案：**另一个进程正在使用该端口 lsof -i :9944 杀死-9 ### 索引器无法连接到节点错误：WebSocket 连接失败 **解决方案：** 确保节点正在运行且可访问 # 测试节点连接 wscat -c ws://127.0.0.1:9944 ### 证明服务器版本不匹配错误：账本版本不兼容 **解决方案：** 将证明服务器同步到节点的账本版本 # 检查节点的账本依赖关系 grep“午夜分类帐”午夜节点/Cargo.toml # 在午夜账本中查看匹配版本 CD午夜分类账 git checkout <匹配提交> 货物构建--发布 ### 索引器不同步错误：块解析失败 **解决方案：** 更新索引器元数据并重新索引 CD 午夜索引器 ./scripts/update-metadata.sh npm 运行重建索引 ### Docker 问题错误：无法连接到 Docker 守护进程 **解决方案：** 启动 Docker Desktop 或守护进程 # macOS 打开-a Docker # Linux sudo systemctl 启动 docker ## 健康检查 ### 检查所有服务 # 节点健康状况卷曲 -s http://127.0.0.1:9944/health # 索引器健康状况卷曲 -s http://127.0.0.1:8088/health # 证明服务器健康状况卷曲 -s http://127.0.0.1:6300/health ### 验证连接 # 测试 WebSocket 到节点 wscat -c ws://127.0.0.1:9944 # 测试 GraphQL 卷曲-X POST http://127.0.0.1:8088/graphql \ -H“内容类型：application/json”\ -d '{"查询": "{ __schema { 类型 { 名称 } } }"}' ## 脚本使用提供的设置脚本： bash /path/to/skills/midnight-infra-setup/scripts/setup.sh [操作] **行动：** * `start` \- 启动所有基础设施 * `stop` \- 停止所有基础设施 * `status` \- 检查服务状态 * `logs` \- 查看日志 * `reset` \- 重置并重新启动 ## 将结果呈现给用户午夜基础设施状态：节点：✓正在运行（ws://127.0.0.1:9944）索引器：✓ 运行 (http://127.0.0.1:8088) 证明服务器：✓正在运行（http://127.0.0.1:6300）所有服务均健康且同步。后续步骤： 1. 部署合约：npm run deploy:local 2.启动前端：npm run dev:frontend 3.连接钱包并互动 ## 参考文献 * [midnight-infra-dev-tools]() \- 官方安装脚本 * [midnight-node]() \- 区块链节点 * [midnight-indexer]() \- 状态索引器 * [midnight-ledger]() \- 证明服务器 * [Token Vault 示例]() \- 屏蔽/非屏蔽代币

午夜基础设施设置

包含技能