请选择端点
选择端点开始调试
从左侧列表选择一个 API 端点
填写参数后点击「发送」按钮
等待请求
发送请求后响应结果将在此展示
暂无响应头数据
发送请求后可查看 cURL 命令
接口文档
从左侧选择接口查看详细文档
选择接口查看文档
从左侧列表选择一个接口
查看详细的请求参数与响应示例
SDK 调用示例
选择左侧示例查看完整的 Go SDK 调用代码
// 选择左侧示例查看代码
错误码字典
常见错误码、原因分析与处理建议
请选择 IDL 方法
选择 IDL 方法开始调用
从左侧按 app 分组列表选择一个方法
填写参数后点击「发送」按钮
等待请求
发送请求后响应结果将在此展示
暂无响应头数据
发送请求后可查看 cURL 命令
MCP 接入
本服务内置 MCP(Model Context Protocol)端点 /mcp,把全部 REST 能力映射为 64 个 MCP 工具。AI 编程代理接入后,可直接用自然语言驱动链上操作:账户与密钥、代币转账、合约读写、交易解析、DID / VC / SFT 全生命周期——无需写一行 REST 调用代码。工具与 REST 端点一一对应、行为完全一致。
把下面的 JSON 加入 ZCode / Claude Code 的 MCP 配置(mcpServers 字段)。URL 端口跟随当前页面访问地址自动生成。
加载中...
Cursor 需将配置写入 ~/.cursor/mcp.json(全局生效)或项目根目录 .cursor/mcp.json(仅当前项目),保存后重启 Cursor 生效。
加载中...
默认无需鉴权(适合本机 / 内网)。服务端设置 MCP_AUTH_TOKEN 环境变量后,/mcp 要求携带 Authorization: Bearer <token> 头,不对则返回 401。带鉴权的客户端配置:
加载中...
把操作账户常驻在 MCP 客户端配置里(headers.X-Milon-Accounts,值为 base64(JSON 数组),上限 64 条),之后全部写工具只传地址、免传私钥:contract_write / transfer_mil(传 fromAddress)/ faucet_claim / DID / SFT / VC / 保存指令执行——私钥缺省时按地址自动引用配置账户,显式传私钥仍优先。服务端零持久化(账户只随单请求过境,多用户共用一台服务互不串);该头等同于持有私钥的通道——能带此头即能签名,请像保管私钥一样保管客户端配置文件。
| 字段 | 必填 | 说明 |
|---|---|---|
name | 否 | 展示名,account_config_list 回显用 |
address | 是 | base58 地址;数组内不可重复 |
privateKey | 是 | hex 或 base58 私钥 |
keyType | 否 | secp256k1(缺省)/ ed25519 / bls12381 / fndsa512 |
publicKey | fndsa512 必填 | 抗量子曲线公钥无法从私钥派生,必须显式携带(account_generate 返回里有,897 字节);其他曲线可省,服务端派生并校验与地址、私钥的配对 |
配置有误时所有请求返回 400,错误定位到具体条目(如 X-Milon-Accounts[0]: privateKey 与 publicKey 不配对)。用下方生成器粘贴账户数组,本地完成 base64 编码(私钥不发送到服务端),直接得到可粘贴的完整配置:
加载中...
加载中...
也可用命令行生成 base64(输出粘贴到 headers 的值里):
# bash(-n 去尾换行,-w0 不折行)
echo -n '[{"name":"main","address":"<地址>","privateKey":"<私钥>"}]' | base64 -w0
# PowerShell
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('[{"name":"main","address":"<地址>","privateKey":"<私钥>"}]'))安全边界:账户头随每个请求过境,服务端不落盘、不跨请求共享、不进日志(ENABLE_BODY_LOG 记录的是请求体,不含该头)。account_config_list 工具可随时核对自己已配置的账户(脱敏回显,永不返回私钥)。
注意事项:MCP 端点单次工具调用回环超时 120s(长任务如 sft_flow / vc_flow 请耐心等待);开启 ENABLE_BODY_LOG 时 /mcp 工具入参(含私钥字段)会写入日志,仅限 devNet 调试,生产勿开;对外暴露服务务必设置 MCP_AUTH_TOKEN。多网络并存时可对 /mcp 请求携带 X-Milon-Network 头(客户端在 mcpServers 配置的 headers 中设置,如 {"X-Milon-Network": "devNet"}),全部工具调用按该网络执行,缺省走服务端默认网络。
工具清单
…全部工具实时来自 GET /api/mcp/tools(与 /mcp 注册表同源,服务端新增工具后本页自动同步)。每个工具注明对应的 REST 端点。
快速上手
接入成功后,直接对 AI 说这些话试试(按场景从易到难):
- 网络「当前连的是哪个网络?查一下最新区块头」
- 账户「生成一个 ed25519 新账户,然后去领水」
- 转账「查我的余额,把 500 MIL 转到
目标地址,等确认后给我 txHash」 - 合约「用 idl_metadata 看看 token app 有哪些方法,然后帮我查这个地址的 MIL 余额」
- DID「给我创建一个 DID,别名绑成 alice,再加一个服务端点」
- 编排「跑一遍 SFT 全流程:建 SFT、建 slot、mint 100 份给我」
- 排错「这笔交易 0x… 卡住没确认,帮我解析一下它的内容和事件」
测试数据播种
确定性派生测试数据一键写入当前网络,同 seed 短语重建后地址不变。v2:模板 + 旋钮全参数化,计划预览不上链
当前数据集总览
账号/私钥/代币 owner/SFT 一屏速览;私钥由 seed 短语在浏览器本地派生,服务端不返回账号本(自定义测试账号)
自有的密钥库,与播种账号并列使用;仅给私钥的条目服务端自动补地址。服务端存 data/custom_accounts.json(已 gitignore)模板与启动
模板由服务端下发;改任一旋钮 500ms 后自动刷新计划预览账户
普通账号:领水 / 余额档 / DID / VC 证书多签
签名者从普通账号轮取;数量 0 = 不建多签代币
多精度铸造 + 可选合规/冻结演示SFT
集合 + 场景 slot;数量 0 = 不建 SFT计划预览
POST /api/tool/seed/plan — 不上链;配置非法时在此列出全部错误改任一旋钮后自动预览
改任一旋钮后自动预览
执行进度
job — 状态 idle(2s 轮询)尚未启动
尚未启动