运维手册
完整的交易台就绪检查清单与集成认证测试。
交易台就绪检查清单
上线前,请确认以下事项:
API 连接
- 已配置生产环境端点
- 健康检查端点正常响应
- WebSocket 连接稳定
身份验证
- EIP-712 签名正常工作
- 已配置代理授权(如适用)
- 已实现 Nonce 管理
- 已测试签名验证
报价系统
- 已测试批量下单
- 已验证订单生命周期对账
- 已实现成交跟踪
- 已测试撤单功能
风险控制
- 已配置并测试 MMP
- 已理解保证金模型
- 已验证等级限制
- 已实现投资组合监控
监控
- 已订阅 WebSocket 数据流
- 订单/成交对账已自动化
- 已配置健康检查
- 已设置告警
紧急停止开关
- 能够撤销所有订单
- 能够立即断开连接
- 已记录应急流程
对冲
- 已验证与 Hyperliquid 永续合约的集成
- 已实现 Delta对冲策略
- 已理解永续合约保证金计算
结算
- 已测试到期处理
- 已验证持仓结算
- 已理解参考价格来源
集成认证测试
测试 1:下单
步骤:
- 通过
POST /order提交单个订单 - 确认订单响应状态为
ACKED或OPEN - 检查订单是否出现在
GET /orders?wallet=...中 - 确认已收到 WebSocket
order_updates推送
预期结果:订单提交成功,并收到状态更新
测试 2:批量下单
步骤:
- 通过
POST /bulk_order提交 10 个订单 - 确认所有订单均被接受
- 通过 REST 和 WS 检查订单状态
- 确认没有签名/身份验证错误
预期结果:所有订单提交成功
测试 3:成交跟踪
步骤:
- 提交一个将会成交的订单
- 监控 WebSocket
fills频道 - 确认收到的成交带有正确的
order_id - 检查成交是否出现在
GET /fills?wallet=...中 - 确认订单状态更新为
FILLED
预期结果:成交被正确跟踪,订单状态已更新
测试 4:部分成交跟踪
步骤:
- 提交一个将会部分成交的订单
- 监控 WebSocket
fills和order_updates频道 - 确认部分成交推送到
fills - 确认
order_updates报告PARTIALLY_FILLED,并带有累计的filled_size - 按
order_id汇总成交,检查总量等于filled_size
预期结果:fills 上为逐笔成交数量,order_updates 上为累计成交数量
测试 5:撤单
步骤:
- 通过
POST /order提交订单 - 通过
DELETE /order撤销订单 - 确认订单状态:
CANCELED - 确认已收到 WebSocket
order_updates推送
预期结果:订单撤销成功,并收到状态更新
测试 6:MMP 触发
步骤:
- 通过签名的
POST /mmp-config配置 MMP。若客户端将立即读取投影数据,请发送X-Hypercall-Fence-Wait: 1,并保留返回的X-Hypercall-Fence值。 - 提交启用 MMP 的订单
- 通过超出限额触发 MMP
- 确认订单因 MMP 原因被撤销
- 检查其他启用 MMP 的订单也已被撤销
预期结果:MMP 正确触发,订单被撤销
读取 MMP 配置同样需要身份验证。请对 GetMmpConfig 签名,并将其过期时间和签名分别作为
X-Hypercall-Expires-At-Ms 和 X-Hypercall-Signature 请求头发送。在此 GET 请求中回传写入响应的
X-Hypercall-Fence 值,即可等待该确切的已提交配置生效。未携带 X-Hypercall-Fence-Wait: 1 的写入请求
有意不返回 fence 请求头。
测试 7:保证金拒单
步骤:
- 提交一个超出保证金的订单
- 确认订单以 "Insufficient margin" 原因被拒绝
- 检查拒单原因包含所需保证金、权益和缺口数值
- 确认订单状态:
REJECTED
预期结果:订单被拒绝,并给出明确原因
测试 8:等级限制
步骤:
- 使用一个等级仅允许备兑卖出的钱包(查看
GET /risk/limits?wallet=...) - 尝试在没有多头持仓的情况下提交卖单
- 确认订单因等级原因被拒绝
- 提交买单(应成功)
- 提交卖单平仓(应成功)
预期结果:等级限制被正确执行
测试 9:WebSocket 重连
步骤:
- 连接 WebSocket
- 订阅频道
- 断开 WebSocket
- 使用指数退避重新连接
- 重新订阅频道
- 轮询 REST 以补齐遗漏的更新
预期结果:重连正常,状态已恢复
测试 10:投资组合对账
步骤:
- 提交订单并成交
- 通过
GET /portfolio?wallet=...检查投资组合 - 确认持仓与成交一致
- 检查保证金占用正确
- 与 WebSocket
portfolio更新进行对账
预期结果:投资组合状态准确,对账成功
生产就绪
生产前检查清单
- 所有集成测试均已通过
- 已配置监控与告警
- 已测试紧急停止开关
- 已记录应急流程
- 团队已接受事件响应培训
- 已确定支持联系人
上线检查清单
- 已在生产环境中以小规模通过认证测试
- 已验证生产环境端点
- 监控仪表盘已就绪
- 已配置告警
- 已建立团队值班安排
- 已审阅文档