开发指南
环境与配置
向平台获取同一环境的以下材料。文档站地址不等于业务 API 接入地址，不要从文档域名推断 {baseUrl}。
| 材料 | 用途 |
|---|---|
API 接入地址 {baseUrl} | 取址、玩家历史、单笔查询、提现提交、取消未广播提现及配置读取使用的 HTTPS 地址 |
| API Access Key、HMAC 密钥 | 你的业务后端调用 API 时签名 |
| Webhook Access Key、HMAC 密钥 | 你的通知端点验签和回签；与 API 凭据独立配置 |
平台提供的 environment、accessNamespace | 固定当前环境与稳定接入方身份，用于拒绝事件绑定；accessNamespace 不是 API Access Key，不能自行命名或采信通知自报值 |
| 已开放的链与资产 | chainName、chainId、USDT 合约 tokenContract、资产精度、确认要求 |
| 你的完整 HTTPS 通知 URL | 接收全部充值和提现通知；当前配置不支持 query |
用已鉴权的查询 Webhook 配置返回的 environment/accessId 与平台材料核对，其中 accessId 对应这里的 accessNamespace；核对一致后固定保存。轮换 API Access Key 不应改变该身份范围；不一致时先联系平台确认，不自行推导或替换。
当前本地接入版本使用测试环境与测试网；主网参数用于方案参考，主网接入须先由平台提供支持主网的运行版本和准入材料，不能直接替换 chainId 切换。预期先按平台开放的测试网联调；主网请求被拒绝时，先核对运行版本和准入材料。
开发与生产的地址、密钥和合约不能混用。密钥只保存在业务后端，不能放进玩家页面或代码仓库。正文采用 UTF-8；POST 使用 Content-Type: application/json，GET 的 body 必须为空；请求正文上限为 1 MiB。超过上限或正文读取失败时，取址和充值接口返回 401；提现提交、取消、玩家提现列表和通知配置返回 422。
实际开放链以平台提供的环境材料为准；每条链都需要分别确认取址、充值同步、查询、通知和提现流程已经验收。链已登记不代表所有交易流程都已接通；充值查询也不是完整链上历史。充值同步只接纳登记链名、链 ID 和代币合约匹配的记录，错误资产可能不会出现在查询或通知中。入账前仍必须逐笔比对登记链和合约；没有记录时先核对转账网络与资产，再请平台检查同步覆盖。
当前提现采用人工审批、链下出款的流程。提交接口只创建提现申请，不自动转币。开放前应分别确认取址、充值、查询、通知和提现流程可用；连接失败先查 API 地址与 HTTPS，状态异常先查环境配置和平台同步情况。
玩家提现分页和取消未广播提现属于当前接口。文档本身不证明每一个目标环境都已部署这两项。接入时先由平台确认运行版本与读取准入；旧环境缺少对应路由时，保留 OG 本地账本并按原订单单笔查询。