用途
该技能提供一个可运行的 Midnight Passport 基础版 dApp 模板,用于端到端演示以下流程:使用通行密钥(passkey)注册 → 部署托管合约 → 绑定 alice.night 身份 → 充值 Night → 进入托管工作区 → 登出后重新登录恢复。它适合作为学习、原型验证和二次开发的起点。
主要能力
- Vite + React 前端应用(app/)
- Compact 合约:account(按用户托管)、faucet(演示资金)、identity_registry(身份注册)
- 平台无关的钱包客户端(src/wallet/)
- Localnet Docker 栈与一键
npm run demo启动脚本 - 生命周期测试与无头 E2E 测试
使用方式
- 复制
templates/passport-dapp/或直接在原目录工作。 - 安装根目录与 app/ 依赖。
- 确保 Docker 与 Compact 编译器在 PATH 中(Node >= 22)。
- 运行
npm run demo,打开 http://localhost:5173/ 。 - 创建通行密钥(或使用
?demoMode=local)→ 充值 → 进入工作区。 - 可选运行
npm run demo:e2e、npm test及生命周期脚本。
演示脚本会自动创建 infra/.env、编译合约、启动 Midnight 节点/索引器/证明服务器、部署 faucet 与身份注册合约并注入地址、启动 Vite。
适用场景
- 学习 Midnight 上的通行密钥注册与托管账户模式
- 作为构建自定义钱包或身份应用的原型基础
- 在本地 Localnet 上验证合约与前端集成
限制
该模板明确为非生产原型:恢复份额以明文形式存放在公共账本上(PVSS 为 TODO);认证使用哈希原像而非 Schnorr(Schnorr 延后);充值依赖创世资金。生产钱包需替换创世钱包创建方式,更强认证与安全恢复方案超出本基础版范围。