用OKX签名SDK自建钱包：密钥、广播与验收

欧易OKX

2026年10月23日

OKX 的签名 SDK 做的是离线签名，它不负责广播，也不替你保管密钥。用它自建钱包时，密钥生成和签名都在本地完成，交易上链需要你自己接 RPC 节点或广播服务。这个边界先分清，后面每一步的取舍就清楚了。

欧易OKX交易所
全球领先的加密货币平台，适合新手与进阶交易者
新手福利：注册即享20% 交易手续费减免！

标题里的"验收"在 SDK 语境下对应两层：签名结果是否有效（用 validSignedTransaction 校验），以及交易是否真正上链（拿 TxID 去区块浏览器核对）。两者不是一回事，签名成功不等于广播成功，广播成功也不等于链上确认。

选哪个 SDK：看语言和链

OKX 提供多语言、多链的签名工具包。JavaScript/TypeScript 项目用 @okxweb3/coin-* 系列，按链安装对应包，比如 @okxweb3/coin-ethereum、@okxweb3/coin-bitcoin、@okxweb3/coin-solana。Go 项目用 github.com/okx/go-wallet-sdk，公共包 crypto 提供 BIP32、BIP39、ECDSA、Ed25519 等基础算法，各币种模块单独引入。

两条路都支持离线签名，覆盖 Ethereum/EVM、Bitcoin 系（含 BRC20、Atomicals、Runes）、Solana、Cosmos、Aptos、Sui、Tron 等主流链。如果你只需要签名、不想自己写各链的序列化逻辑，选 SDK 是对的；如果你连节点运维也不想碰，需要额外接广播服务。

密钥：生成、派生与验证都在本地

SDK 的私钥相关函数包括 getRandomPrivateKey（生成随机私钥）、getDerivedPrivateKey（从助记词或种子派生）、validPrivateKey（验证私钥格式）、getNewAddress（通过私钥获取地址）。

一个关键判断：私钥从生成那一刻起就不应该离开你的本地环境。OKX 的签名 SDK 设计就是离线操作的，不需要调用 OKX 服务器。如果你在代码里把私钥发给任何远程接口，这个 SDK 的安全前提就被你自己破坏了。

派生路径用 getDerivedPath 获取，遵循 BIP44。多链钱包场景下，同一个助记词可以按不同 coin type 派生出各链地址，但不要假设不同链的派生结果可以混用，每条链的路径参数需要单独确认。

签名：先构造原始交易，再签

签名流程分两步：先 getRawTransaction 生成原始交易数据，再 signTransaction 对原始交易签名。以太坊的签名参数通常包括 to、value、nonce、gasLimit、gasPrice（或 EIP-1559 的 maxFeePerGas/maxPriorityFeePerGas），Bitcoin 系还涉及 UTXO 选择和找零地址。

签名完成后用 validSignedTransaction 校验签名交易的有效性。这一步值得做，因为它能拦住私钥与地址不匹配、签名格式错误这类问题，避免你拿一个无效的签名交易去广播才发现失败。

SDK 也提供 signMessage 和 verifyMessage 用于消息签名，以及 ecRecover 从签名恢复公钥。消息签名和交易签名是两套用途，消息签名常用于登录验证或证明地址控制权，不能直接当交易用。

广播：SDK 不负责，这是你需要补的一环

签名 SDK 的文档没有把广播作为内置能力。交易上链需要你把签好的原始交易发给某个 RPC 节点或广播服务。OKX 自己的 Onchain OS 提供交易广播 API，整合了自研节点和第三方节点做智能多路广播，但这是独立于签名 SDK 的产品，需要单独接入。

如果你不想接 OKX 的广播服务，可以用任意公开或自建的 RPC 节点发送原始交易。无论走哪条路，广播前先做链上模拟（如果有条件），尤其是涉及合约交互的交易，模拟能提前暴露 revert 风险，避免付了矿工费却失败。

验收：两个阶段，分开核验

签名阶段验收：validSignedTransaction 返回有效，且交易哈希（用 calcTxHash 从原始交易计算）与预期一致。注意 calcTxHash 计算的是原始交易的哈希，不是链上确认后的 TxID，两者在未广播前是同一串字符，但含义不同。

链上阶段验收：广播后拿到 TxID，去对应链的区块浏览器查状态。pending 不等于成功，success 才是链上执行成功。如果交易涉及代币转账或合约调用，还要核对事件日志里的实际转账数量和接收地址，不要只看交易状态是 success 就认为资产到了正确的地方。

一个容易忽略的边界

OKX 的 WaaS 产品线里有"无私钥钱包"方案，基于 MPC/TSS 做门限签名。这和签名 SDK 是两套东西：签名 SDK 给你完整的私钥控制权，MPC 方案把密钥分片管理、不让你接触完整私钥。如果你需要的是"用户无感、社交登录恢复"的钱包体验，MPC 方案更合适；如果你要的是自己完全掌控私钥、离线签名的自建钱包，签名 SDK 才是对的路径。两者不要混着用，也不要以为用了签名 SDK 就自动获得了 MPC 的安全模型。