用途:本技能讲解 Orderly Network 的两层认证体系,适用于创建 Orderly 账户与 API 密钥(EVM 或 Solana)、构建服务端交易机器人、直接调用 API、理解两层认证流程以及排查签名问题。
主要能力:第一层为钱包认证,负责账户注册、API 密钥增删与提现等特权操作;EVM 使用 EIP-712 类型化数据签名,Solana 使用原生 Ed25519 消息签名。第二层为 API 认证,使用本地生成的 Ed25519 密钥对签名下单/撤单、读取持仓与余额、建立 WebSocket 连接等请求。
使用方式:环境上主网 API 为 https://api.orderly.org、WebSocket 为 wss://ws.orderly.org/ws/stream;测试网为 https://testnet-api.orderly.org 与 wss://testnet-ws.orderly.org/ws/stream,同一套端点同时支持 EVM 与 Solana。链 ID 不应硬编码,可通过 https://api.orderly.org/v1/public/chain_info?broker_id=${BROKER_ID} 动态获取。EIP-712 分两类域:链下域用于注册与密钥管理,verifyingContract 为 0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC;链上域用于提现、内部转账与结算 PnL,主网 verifyingContract 为 0x6F7a338F2aA472838dEFD3283eB360d4Dff5D203,测试网为 0x1826B75e2ef249173FC735149AE4B8e9ea10abff。注册流程为:查询账户、获取 registration_nonce、签名 Registration 消息、提交 /v1/register_account;随后生成 Ed25519 密钥对,签名 AddOrderlyKey 消息并提交 /v1/orderly_key。密钥 scope 可为 read、trading、asset,逗号分隔组合。Solana 账户查询需带 chain_type=SOL,注册与加签需在请求中传 chainType: 'SOL',并借助 Solana 适配器生成消息。
适用场景:交易机器人、服务端直连 API、多链账户接入。
限制:需 Web3 钱包、Broker ID、Node.js 18+,并理解 EIP-712 或 Ed25519 签名;注册 nonce 有效期 2 分钟;私钥须安全保存;资料未提供收费、价格与具体平台支持范围等信息。