SuperAPI AI 工具集

mini-apps-scaffold

前端与建站

查看项目

更新于 10-16 01:38

技能介绍

用途:该技能用于从零创建一个运行在移动端 Nimiq Pay 内的迷你应用(网页应用)。迷你应用通过注入的 provider 与钱包通信:Nimiq provider 负责 NIM 操作,Ethereum provider(window.ethereum)负责 EVM 链与代币交互。

主要流程:先确认应用功能、需要哪些 provider(Nimiq、Ethereum 或两者)、使用何种框架(文档提供 Vue、React、Svelte 示例,无偏好时推荐 Vue)以及是否涉及特定代币或链,向开发者复述理解并等待确认。随后创建项目并安装 SDK:npm create vite@latest my-mini-app -- --template vue-ts、npm install、npm install @nimiq/mini-app-sdk;若仅用 Ethereum provider 则无需 SDK;需要 ERC-20 ABI 编码时再安装 viem。

配置与验证:在 Vite 配置中设置 server.host: true 与 server.port: 5173,使手机可通过局域网访问。在主组件中初始化 provider 并做错误处理,使应用在 Nimiq Pay 外打开时仍可用;Ethereum provider 仅做特性检测。添加简单调用(Nimiq 用 isConsensusEstablished() 或 listAccounts(),Ethereum 用 eth_requestAccounts)验证连接,运行 npm run dev -- --host,在 Nimiq Pay 的 Mini Apps 中输入终端显示的 Network URL(勿用 localhost)。

限制与前提:需要 Node.js 22 或更高版本,手机与开发机处于同一 Wi-Fi,且必须通过 Nimiq Pay 打开。仅支持 Ethereum、Polygon、Arbitrum One、Optimism、Base、BNB Smart Chain、Sepolia 等 EVM 链。不支持需要服务端钱包访问、未支持链或绕过审批弹窗的方案。涉及支付或质押时建议先在测试网测试;长按设置按钮 10 秒可显示隐藏开发菜单并切换到 Testnet,但测试网仅影响 Nimiq provider 操作,EVM 操作仍在主网。开发细节可安装 mini-apps-best-practices 技能,发布前运行 mini-apps-checklist 技能校验。完整文档见 https://nimiq.dev/raw/mini-apps/index.md。