比特派 API 接口变更通知公告

尊敬的比特派全球生态合作伙伴、开发者及广大用户：为进一步适配Web3行业快速迭代的技术需求，提升多链资产交互的安全冗余与响应效率，同时匹配比特派最新版本的账户抽象体系与跨链协议升级规划，我们将于近期完成比特派核心API接口的全量版本迭代，本次变更涉及资产查询、交易签名、链上交互、DApp连接等多个核心模块，所有在役版本接口将设置为期90天的缓冲过渡期，请所有接入方务必在过渡期内完成版本适配与功能测试，避免因接口下线影响业务正常运行。

自2014年比特派正式推出开发者开放平台以来，我们始终坚持以开放、安全、高效的原则为全球超过1200家生态合作伙伴提供稳定的API接口服务，覆盖交易所、DApp开发团队、链上数据分析平台、合规审计机构等多个领域，累计承载超过30亿次的接口调用请求，服务用户量级突破5000万。过去三年间，随着公链生态的快速扩张，比特派已支持包括比特币、以太坊、Solana、Polygon、Arbitrum、Sui、Aptos在内的超过80条主流公链与Layer2网络，原有v2版本接口的架构设计已逐渐无法匹配多链并行、账户抽象、跨链原子交换等新兴业务场景的需求，接口响应延迟、多链参数兼容不足、签名流程冗余等问题的反馈量较去年同期增长了47%，因此本次v3版本接口的升级是比特派开放生态迭代的必然选择。

本次接口变更的核心调整主要集中在五个维度，其一为多链统一参数体系，v3版本将摒弃原有按公链类型拆分接口路径的设计，采用统一的链ID标识参数，开发者仅需传入对应公链的chainId即可完成不同链上的资产查询与交易构建，无需针对每条链单独适配接口逻辑，预计可减少开发者60%以上的多链适配工作量；其二为账户抽象能力支持，新增ERC-4337标准下的智能账户签名接口、会话密钥授权接口、Gas代付接口，帮助合作伙伴快速接入社交恢复、无Gas交易、批量操作等账户抽象功能，降低普通用户的Web3使用门槛；其三为安全校验机制升级，在原有接口签名校验的基础上，新增设备指纹校验、交易风险实时拦截、地址黑名单同步三重安全防护，所有上链交易请求将先经过比特派安全风控引擎的毫秒级扫描，对于涉及地址、风险合约的交易将直接返回拦截提示，进一步保障用户资产安全；其四为跨链交互接口优化，整合比特派原生跨桥与主流跨链协议的流动性，推出统一跨链交易接口，开发者无需对接多家跨链协议即可支持用户在30+条公链之间的资产跨链转移，且跨链手续费与到账时间均有明确的预估返回；其五为数据接口扩容，新增链上NFT元数据查询、DeFi协议持仓解析、域名系统地址映射等17类数据接口，满足数据分析类、资产管理类合作伙伴的精细化数据需求。

为确保所有接入方能够平稳完成版本过渡，我们已在开发者后台上线了完整的v3版本接口文档、SDK开发工具包与沙箱测试环境，所有合作伙伴均可登录比特派开发者中心查看详细的接口变更说明与迁移指南，文档中针对每个接口的参数变化、返回字段调整、错误码更新均做了清晰的对比标注，同时提供了Java、Python、Go、JavaScript等8种主流开发语言的SDK示例代码。我们的开发者支持团队将开设专属的迁移答疑社群与技术支持热线，工作日9点至21点提供1对1的技术咨询服务，对于年调用量超过1000万次的核心合作伙伴，我们还将提供专属的技术对接人员，全程协助完成接口适配与测试验证工作，确保迁移过程零故障。

需要特别提醒的是，本次缓冲过渡期自公告发布之日起正式生效，至2024年12月31日24:00（UTC+8）正式结束，过渡期内v2与v3版本接口将并行提供服务，所有接入方需在过渡期结束前完成全部接口的v3版本切换，2025年1月1日起，v2版本接口将正式下线，所有请求将返回版本过期错误码，由此给未及时迁移的业务带来的影响需由接入方自行承担。对于在2024年10月31日前完成全量接口迁移并通过稳定性测试的合作伙伴，比特派将给予未来一年接口服务费15%的优惠补贴，同时优先获得比特派新功能内测资格与生态资源扶持。

比特派始终认为，开放的开发者生态是Web3行业持续繁荣的核心基石，过去十年我们见证了无数优质的应用从开发者的创意落地为服务千万用户的产品，也始终致力于为开发者提供更稳定、更安全、更易用的基础设施服务。本次接口升级不仅是一次技术架构的迭代，更是比特派面向下一代Web3应用场景的生态布局，未来我们还将持续投入研发资源，推出更多面向开发者的工具与服务，与所有合作伙伴一起构建更开放、更普惠的Web3生态。如果您在迁移过程中有任何问题，可随时通过开发者后台的工单系统、官方邮箱或社群渠道与我们取得联系，我们将第一时间为您提供支持。