核心用法
Zeko 技能是一套面向 Mina 生态二层网络 Zeko 的开发者工具集,主要服务于两类场景:网络交互(查询、跨链、领水)与 zkApp 开发。
网络交互层:
- Bridge CLI:使用
zeko-bridge bridge高阶命令完成资产跨链,避免直接调用低阶deposit submit等子命令(除非调试) - Faucet CLI:
zeko-faucet获取测试网资金 - GraphQL/curl:直接查询 Sequencer(实时状态)与 Archive Node(历史数据),默认使用网关代理的 Mina testnet 端点
开发层:
- o1js:TypeScript 零知识应用框架
- OCaml:原生 Mina 协议开发语言
显著优点
1. 自动化优先:明确偏好 CLI/HTTP 流而非浏览器钱包操作,适合 CI/CD、脚本批量处理
2. 分层端点策略:Sequencer 与 Archive Node 职责分离,文档清晰指引何时用 live node、何时查历史
3. 模块化引用:6 个细分参考文件按需加载,避免信息过载
4. 官方背书:docs.zeko.io 作为权威文档源
潜在缺点与局限性
- 环境依赖较重:需 Node.js、npx,以及
MINA_PRIVATE_KEY、GITHUB_TOKEN等敏感环境变量 - Mina 生态门槛:o1js 的 zk 编程模型、Pickles 证明系统有学习曲线
- 测试网局限:主网阶段部分端点或行为可能变动
- 非浏览器场景限制:若用户坚持使用 Auro Wallet 等浏览器插件,需显式切换模式
适合人群
- 构建 Zeko zkApp 的开发者(o1js/OCaml)
- 需要批量跨链、数据索引的自动化运维/DevOps
- 希望绕过浏览器、用私钥直接签名的进阶用户
常规风险
| 风险项 | 说明 |
|--------|------|
| 私钥泄露 | `MINA_PRIVATE_KEY` 等变量若写入日志或泄露,资金直接暴露 |
| 端点误用 | 向 Sequencer 发送历史查询或向 Archive Node 发送状态写操作,可能失败或延迟 |
| 合约风险 | Bridge 合约或 zkApp 逻辑漏洞可能导致资产锁定或丢失 |
| 测试网/主网混淆 | 技能默认 testnet,主网操作需显式确认环境变量 |
安全等级说明
技能本身为文档与 CLI 封装,无远程代码执行或自动签名风险;但涉及私钥环境变量与链上资产操作,需用户妥善保管密钥。