SuperAPI AI 工具集

example-passport-dapp

编程与开发

查看项目

更新于 11-18 23:59

技能介绍

用途

该技能提供一个可运行的 Midnight Passport 基础版 dApp 模板,用于端到端演示以下流程:使用通行密钥(passkey)注册 → 部署托管合约 → 绑定 alice.night 身份 → 充值 Night → 进入托管工作区 → 登出后重新登录恢复。它适合作为学习、原型验证和二次开发的起点。

主要能力

  • Vite + React 前端应用(app/)
  • Compact 合约:account(按用户托管)、faucet(演示资金)、identity_registry(身份注册)
  • 平台无关的钱包客户端(src/wallet/)
  • Localnet Docker 栈与一键 npm run demo 启动脚本
  • 生命周期测试与无头 E2E 测试

使用方式

  1. 复制 templates/passport-dapp/ 或直接在原目录工作。
  2. 安装根目录与 app/ 依赖。
  3. 确保 Docker 与 Compact 编译器在 PATH 中(Node >= 22)。
  4. 运行 npm run demo,打开 http://localhost:5173/ 。
  5. 创建通行密钥(或使用 ?demoMode=local)→ 充值 → 进入工作区。
  6. 可选运行 npm run demo:e2e、npm test 及生命周期脚本。

演示脚本会自动创建 infra/.env、编译合约、启动 Midnight 节点/索引器/证明服务器、部署 faucet 与身份注册合约并注入地址、启动 Vite。

适用场景

  • 学习 Midnight 上的通行密钥注册与托管账户模式
  • 作为构建自定义钱包或身份应用的原型基础
  • 在本地 Localnet 上验证合约与前端集成

限制

该模板明确为非生产原型:恢复份额以明文形式存放在公共账本上(PVSS 为 TODO);认证使用哈希原像而非 Schnorr(Schnorr 延后);充值依赖创世资金。生产钱包需替换创世钱包创建方式,更强认证与安全恢复方案超出本基础版范围。