Backpack API ED25519 与批量订单准备清单

决策矩阵

来源地图

• Backpack Exchange：Backpack Exchange API（backpack-api）
• Backpack Exchange Support：Generate API keys for Backpack Exchange（backpack-api-keys）
• Backpack Exchange Support：API and developer docs FAQs（backpack-api-faq）

控制说明

1. Key scope

这一项要求读者把公开来源翻译成操作规则。这里的含义是：API keys can be created and permissioned before code sends orders。可执行动作是：create the minimum needed key and record whether it is read-only。仍然未知的是：whether sub-account selection matches the intended trading account。因此本文不会把未知部分包装成收益承诺、牌照承诺、审批保证、安全保证、恢复保证、平台排名或价格暗示。

2. Signing string

这里的含义是：instruction-specific canonical strings determine whether a request is accepted。可执行动作是：unit-test the exact ordered parameters and header fields。仍然未知的是：whether a library silently reorders or omits a parameter。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

3. Timestamp window

这里的含义是：signed requests are valid only within a bounded time window。可执行动作是：monitor local clock drift and reject stale submissions locally。仍然未知的是：whether network delay pushes a request outside the window。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

4. Batch mapping

这里的含义是：batch order execution contains multiple item-level intents。可执行动作是：persist each item, clientId and expected response separately。仍然未知的是：which item should be retried after a partial failure。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

5. Cancel evidence

这里的含义是：orderId and clientId have precedence rules during query or cancel。可执行动作是：use one identifier per lookup and reconcile final state。仍然未知的是：whether an accepted cancel is already executed。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

6. Non-secret logging

这里的含义是：debuggability must not expose secrets。可执行动作是：log instruction, timestamp, window, clientId and result class but never private key or signature seed。仍然未知的是：whether support evidence requires additional private account context。

操作测试也必须很窄。这就是本文坚持以清单形式呈现的原因。

仍需明确的未知项

• whether sub-account selection matches the intended trading account
• whether a library silently reorders or omits a parameter
• whether network delay pushes a request outside the window
• which item should be retried after a partial failure
• whether an accepted cancel is already executed
• whether support evidence requires additional private account context

实用结论

Backpack Exchange API 集成应被视为签名订单控制流程，而不是复制 REST endpoint。Backpack 官方 API 文档说明，改变状态的调用需要 ED25519 签名、timestamp/window header，以及按 instruction 类型构造的签名字符串；文档还说明 order execution、batch order execution、order query 与 cancel 行为，包括 clientId 和 orderId 边界。实用结论是：生产自动化下单前，应先测试 key creation、timestamp window、canonical signing string、batch-item mapping、cancel acknowledgement、202 accepted state 与非秘密日志。 本文停在证据边界内，帮助读者决定下一步核验什么，而不是把公开文档改写成私人账户、钱包、API key、池子路径、稳定币余额、代币化资产或政策框架在任何未来条件下都能成功的承诺。