作为跨链交互的基础，接口（API）是跨链平台中重要一环。目前各大区块链平台提供了丰富的接口，这些接口是否都要在跨链平台中重新实现？为了实现普适通用的跨链平台，如何确定接口设计基调？为了满足复杂多变的跨链需求，哪些接口是必须的？WeCross的接口实现是怎样的？本文将带你一探究竟。

区块链接口众多，跨链是否“我都要”

随着区块链技术的发展，区块链被广泛地运用到各行各业中，为了支撑越来越多样的应用场景与复杂的业务需求，区块链接口也在不断增长、完善。目前，主流区块链平台动辄提供几十个接口。丰富的接口极大方便了开发，不过，对跨链而言，是不是所有区块链接口都需要用上，有待商榷。

以FISCO BCOS的getPbftView为例，该接口用于获取节点所在指定群组内的最新PBFT视图，是面向PBFT共识算法特有的接口，而对于采用其它共识算法的异构区块链平台，这个接口显然不够通用。

因此，虽然区块链接口众多，如何挑选合适的接口来设计跨链平台，还需结合实际情况具体分析。

明确核心诉求，跨链可以“我只要”

跨链平台是联通异构链的桥梁。为了屏蔽区块链的差异性，降低跨链访问复杂度，平台与不同区块链之间的交互需要通用统一的接口，因此，跨链所需的区块链接口一定是不同区块链都有的共性接口。

通过对主流区块链平台的服务接口进行分类整理，大致可分为如下三类：

• 合约类：这类接口用于实现智能合约部署、智能合约调用等功能，它们是支撑区块链业务的主力接口，被频繁访问。其中合约调用又可以细分为查询类（不发交易）的读接口和更新类（发交易）的写接口，常说的“上链”就是通过这个写接口完成。

• 事件类：主要用于构建区块链事件响应机制，实现区块链与业务层的触发式联动功能。区块链通过回调或者Log的方式实现事件推送，然后业务层基于监听接口完成事件捕获以进行后续逻辑。

• 状态类：主要用于区块链系统管理，例如获取区块头、查询区块高度、查看交易等。这类接口多面向运维系统，通过配合区块链节点日志，能够实现整个区块链系统的实时监控，并对异常情况进行告警。

对跨链平台而言，要操作跨链资源，合约类接口必不可少；为了监听跨链请求，事件类接口也得有；为了完成跨链交易验证，就得拿到各个链的区块头，因此，状态类接口也需要。

虽然每个分类都有不少接口，但只有各个区块链通用的接口交集才是跨链的接口基础。由此可见，跨链的功能需求是相对确定的，涉及的接口数量也可以收敛。

抽象凝练，跨链6个接口就够了

既然已经确定跨链接口的基调，那么跨链到底需要哪几个接口？首先需要明确一点，跨链平台的接口设计包含两个层面，面向上层业务提供的服务接口，以及面向各类异构区块链平台的交互接口。

大家熟悉的HTTP协议将所有网络访问操作抽象成了GET（获取数据）和POST（提交数据）两种方法。在跨链场景中有跨链资产流通、资源原子兑换、信息获取、数据跨链更新以及关联交易等众多需求，它们本质是获取链上数据或更新链上数据。

因此，在服务接口方面，我们借鉴互联网的成功经验，对跨链行为进行抽象凝练，发现只需要包含以下三个即可：

• 初始化：跨链资源初始化接口，例如部署智能合约；

• 读接口：获取链上信息，面向只读场景；

• 写接口：更新链上数据，面向跨链发交易场景。

跨链访问除了获取和发送数据外，还肩负了跨链可信验证以及跨链事务保证的使命，这依赖于区块头同步、跨链交易验证以及跨链事件监听等功能。通过对交互过程进行抽象凝练，跨链还需要以下三个交互接口：

• 获取块高：查询当前块高以完成区块头同步；

• 获取区块：查询区块头等信息完成跨链交易验证；

• 注册事件：用于监听跨链事件。

有了上层服务和底层交互6个接口，便能打通业务层到区块链之间的信息链路，同时也为跨链应用屏蔽了不同区块链平台在接口访问协议上的差异性，通过统一的数据协议和调用格式完成与多条区块链的交互。

设计落地，WeCross带你一探究竟

WeCross的接口实现基于上述思路完成。WeCross包括跨链路由（router）和跨链适配器（stub）两个核心组件，其中跨链适配器以插件的方式集成到跨链路由中。

跨链路由向外提供的三个主要服务接口分别是call、sendTransaction和customCommand。其中call和sendTransaction用于合约的调用，customCommand用于其它自定义命令如合约部署，也为平台保留扩展的可能性，以适应不断发展的跨链需求。

跨链适配器定义了6个核心区块链操作接口，包括call、sendTransaction、customCommand、getBlockNumber、getBlock和registerEvent。

其中前三个与服务接口对应，getBlockNumber和getBlock分别用于区块头同步和跨链交易验证，registerEvent用于监听跨链事件。

在开发不同区块链的跨链适配器时，只需要实现上述6个接口便可基于插件化的方式完成异构区块链的接入。

跨链路由管理不同区块链的跨链适配器，当收到来自业务层的调用请求，通过请求包中的调用目标字段确定该请求的最终去向，然后挑选对应的跨链适配器完成请求的转发，最终完成一次跨链调用。

基于上述接口，WeCross目前已实现对基于HTLC的跨链资产原子兑换、基于2PC的跨链事务等功能的支持，并面向数字存证场景完成多种跨链功能验证。

跨链技术尚处探索阶段，从业务实用性考虑，接口协议设计应去繁从简，“小而美”胜过“大而全”。

随着区块链平台发展以及跨链需求的不断演化，跨链接口也会与时俱进，不断改进和完善，迭代式前行。目前，跨链6个接口就能应对！未来，WeCross社区和你一起，见招拆招！