链外运营
本分组是 zepto-server(zepto-offchain)的 HTTP 接口,不是链节点接口。
| 链节点 | zepto-server | |
|---|---|---|
| 仓库 | zepto-chain | zepto-offchain |
| 生产基址 | https://rpc.auroran.io · https://api.auroran.io | https://admin.auroran.io/api/ |
| 协议 | JSON-RPC / REST /api/v1/* / WS | REST /api/public/*(公开)· /api/*(管理) |
| 鉴权 | L1 / User-Signed EIP-712 | 公开读无鉴权;其余为 Admin Bearer |
| 状态 | 链上共识 / 节点内存与索引 | 本机 SQLite |
| 谁用 | 做市商、SDK、钱包 | 交易前端、zepto-admin、官网 |
https://admin.auroran.io/api/v1/* 由 nginx 转到链节点,不属于本分组。
本分组路径是 /api/health、/api/public/…、/api/bridge/… 等(不含 /api/v1)。
完整 URL = https://admin.auroran.io + 下文路径,例如
https://admin.auroran.io/api/public/announcements。
交易站(zepto-web)对公开读另有同源反代:/announcements-api/*、
/market-classifications-api/* → zepto-server /api/public/*。
对接时优先用 https://admin.auroran.io/api/。
官方 SDK 不封装本分组。CORS:Access-Control-Allow-Origin: *。
错误体一般为 { "error": "…" }。
鉴权
公开路径(/api/health、/api/auth/challenge、/api/auth/login、
/api/keys/encryption-key、/api/public/*)无 Bearer。
其余路径:Authorization: Bearer <token>。token 来自 鉴权。
登录地址须持链上 Admin 角色。Challenge 5 分钟有效;session 24 小时。
未带 token → 401;非 Admin → 403。
本分组分册
| 用途 | 入口 |
|---|---|
| 健康检查、challenge / login / me | 鉴权 |
| 签名密钥、服务绑定 | 密钥与服务 |
| 组件开关 / 状态 / 事件 / 日志 | 组件与观测 |
| 运营公告(公开 + 管理) | 运营公告 |
| 两级分类树 + symbol 目录 | 市场分类 |
| 自动充提、人工打款、EVM 流水 | 桥接运营 |
| HL 对冲账户 / 策略 / 订单 | 对冲 |
| S3 / R2 对象存储 | 对象存储 |
路由总表
公开(无鉴权)
| 方法 | 路径 | 分册 |
|---|---|---|
| GET | /api/health | 鉴权 |
| GET | /api/auth/challenge | 鉴权 |
| POST | /api/auth/login | 鉴权 |
| GET | /api/keys/encryption-key | 密钥与服务 |
| GET | /api/public/announcements | 运营公告 |
| GET | /api/public/announcements/{id} | 运营公告 |
| GET | /api/public/announcements/{id}/locales | 运营公告 |
| GET | /api/public/assets/announcements/{filename} | 运营公告 |
| GET | /api/public/market-categories | 市场分类 |
| GET | /api/public/market-catalog | 市场分类 |
| GET | /api/public/market-classifications | 市场分类 |
管理(Bearer)
| 方法 | 路径 | 分册 |
|---|---|---|
| GET | /api/auth/me | 鉴权 |
| GET | /api/status | 组件与观测 |
| GET | /api/oracle/status · /api/liquidator/status · /api/liquidator/watch | 组件与观测 |
| GET | /api/hedger/status · /api/bridge/status | 组件与观测 |
| GET | /api/events · /api/logs | 组件与观测 |
| POST | /api/components/toggle · /restart · /config | 组件与观测 |
| GET/POST/DELETE | /api/keys · /api/keys/{id} | 密钥与服务 |
| GET/PUT | /api/service-config | 密钥与服务 |
| GET/POST/PUT/DELETE | /api/announcements · /{id} · /{id}/locales/{locale} · /upload | 运营公告 |
| GET/POST/PUT/DELETE | /api/market-categories · /catalog · /sync/* · /cleanup | 市场分类 |
| GET/PUT/POST/DELETE | /api/bridge/* | 桥接运营 |
| GET/PUT/POST/DELETE | /api/hedge/* | 对冲 |
| GET/PUT/POST | /api/object-storage/* | 对象存储 |