—

请选择端点

{{baseUrl}} /api/...

选择端点开始调试

从左侧列表选择一个 API 端点
填写参数后点击「发送」按钮

快捷键 Ctrl + Enter 发送请求
待发送
-- ms -- B

等待请求

发送请求后响应结果将在此展示

暂无响应头数据

发送请求后可查看 cURL 命令

接口文档

从左侧选择接口查看详细文档

选择接口查看文档

从左侧列表选择一个接口
查看详细的请求参数与响应示例

SDK 调用示例

选择左侧示例查看完整的 Go SDK 调用代码

// 选择左侧示例查看代码

错误码字典

常见错误码、原因分析与处理建议

—

请选择 IDL 方法

app ::method

选择 IDL 方法开始调用

从左侧按 app 分组列表选择一个方法
填写参数后点击「发送」按钮

待发送
-- ms -- B

等待请求

发送请求后响应结果将在此展示

暂无响应头数据

发送请求后可查看 cURL 命令

MCP 接入

本服务内置 MCP(Model Context Protocol)端点 /mcp,把全部 REST 能力映射为 64 个 MCP 工具。AI 编程代理接入后,可直接用自然语言驱动链上操作:账户与密钥、代币转账、合约读写、交易解析、DID / VC / SFT 全生命周期——无需写一行 REST 调用代码。工具与 REST 端点一一对应、行为完全一致。

把下面的 JSON 加入 ZCode / Claude Code 的 MCP 配置(mcpServers 字段)。URL 端口跟随当前页面访问地址自动生成。

ZCode / Claude Code 配置
加载中...

Cursor 需将配置写入 ~/.cursor/mcp.json(全局生效)或项目根目录 .cursor/mcp.json(仅当前项目),保存后重启 Cursor 生效。

~/.cursor/mcp.json
加载中...
鉴权(可选)

默认无需鉴权(适合本机 / 内网)。服务端设置 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
publicKeyfndsa512 必填抗量子曲线公钥无法从私钥派生,必须显式携带(account_generate 返回里有,897 字节);其他曲线可省,服务端派生并校验与地址、私钥的配对

配置有误时所有请求返回 400,错误定位到具体条目(如 X-Milon-Accounts[0]: privateKey 与 publicKey 不配对)。用下方生成器粘贴账户数组,本地完成 base64 编码(私钥不发送到服务端),直接得到可粘贴的完整配置:

账户数组 JSON(粘贴此处)
生成的完整配置(复制加入 mcpServers)
加载中...
配置形态示范(占位符,手填 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 轮询)
尚未启动
尚未启动