跳到主要内容

链外运营

本分组是 zepto-server(zepto-offchain)的 HTTP 接口,不是链节点接口。

链节点zepto-server
仓库zepto-chainzepto-offchain
生产基址https://rpc.auroran.io · https://api.auroran.iohttps://admin.auroran.io/api/
协议JSON-RPC / REST /api/v1/* / WSREST /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/*对象存储