1 区块链API

指的是面向区块链平台基础和通用的功能（例如账户操作等），这些功能在不同区块链平台中都有各自的实现，但是接口有很大的不同，通过物链适配器统一为简单的接口，提高了应用层程序的开发效率。

1.1 区块链平台管理

应用层程序需要指定当前使用的是哪一个区块链平台，例如，布比、小蚁、北航链等等。

1.1.1 打开区块链平台连接

区块链平台打开后，除非关闭它，物链适配器将一直使用指定的区块链平台提供各种应用支撑功能。

1.1.2 关闭区块链平台连接

关闭区块链平台意味着关闭了物链适配器与区块链平台的连接，所有接口功能将不能被使用。

1.1.3 得到当前区块链平台信息

调用本接口可以得到物链适配器当前正在使用的区块链平台信息，包括名称、提供商、版本等信息。

1.2 账户管理

使用账户API来管理的证书颁发机构（CA）的最终用户注册。这些API用于注册CA用户，确定指定用户是否已注册，并从本地存储中删除任何目标用户的登录令牌，防止他们执行任何进一步的交易。注册API也用于从系统中检索用户注册和交易证书。

1.2.1 注册新用户

1.2.2 删除用户

1.2.3 用户登录

1.2.4 用户取消登录

1.2.5 得到当前用户信息

1.2.6 得到当前用户审核状态

用户注册，尤其是机构用户，为保证其身份的可靠性，应用端往往会要求其提交相关证照信息，以进行审核。

1.2.7 修改当前用户私钥

1.2.8 检查用户证书的有效性

1.2.9 重新获取用户证书

1.3 智能合约

物链适配器提供几种常见的智能合约，并内置在适配器中，应用层程序可以直接使用索引来设置这些智能合约。另外，物链适配器支持自定义智能合约的管理，应用层程序可以进行自定义智能合约的设置并指定智能合约的运行状态。

1.3.1 智能合约的设置

1.3.2 智能合约的触发

1.3.3 智能合约的停止

1.4 隐私管理（信息安全基础）

1.4.1 隐私设定

信息创建者/拥有者可以对信息是否公开进行设定。

1.4.2 隐私状况查询

1.5 区块记录操作

物链适配器中区块记录API的功能是通用的API，广泛应用在所有发生区块记录需要改变的场景下。同时，适配器提供对区块记录的查询API。

区块记录变更也可以通过智能合约的执行来自动实现。

1.5.1 写入区块记录

1.5.2 查询区块记录

1.6 审计

审计接口的作用是使应用程序层能够验证数据的真实性、私密性、安全性和防篡改等特性，物链适配器通过整合区块链的底层API，可以开放给有权限的用户进行区块链中的块信息、链信息、节点信息、账户信息以及智能合约的执行情况信息等的跟踪和审计。

1.6.1 账户信息审计

追踪账户信息变化，检查各个节点账户信息的一致性。

1.6.2 区块信息审计（对账基础）

使用API可以检索区块链中各个块的内容、区块链的当前状态、查询链码以及组成区块链的节点的网络信息，检查各个节点区块信息的一致性。

1.6.3 链信息审计（可靠的追溯信息基础）

使用API可以检索区块链中指定条件的链信息，检查各个节点链信息的一致性。

1.6.4 智能合约信息审计

使用API可以检索指定条件的智能合约的执行信息和内容，检查各个节点智能合约信息的一致性。

1.6.5 共识节点信息审计

使用API可以检索网络共识节点的投票情况。

2 应用领域API

区块链技术应用广泛，物链适配器上承各类应用领域，下启各类主流区块链平台，提供了能够方便各类应用系统集成的API，使用这些API可以减少应用层直接针对区块链平台的逻辑处理，大幅度减少实施量和运维投入量，提升应用效率和系统运行可靠度。目前支持的领域主要围绕供应链、数字资产、身份证明三大主线进行。

2.1 供应链

传统的供应链业务流程高度依赖人工，包括大量审阅、验证交易单据及纸质文件的环节，不但人力成本高，各个环节出现失误的风险也很高，如果在区块链上管理这些流程，就可以降低人力等成本，提高效率和透明度，降低欺诈风险和人工工作失误风险。

物链供应链溯源可保证展品信誉度、降低造假售假的情况，同时满足厂家和消费者的双向追溯。

图4 供应链

2.1.1 参与者相关

2.1.1.1 创建服务机构

创建供应链上的各类服务机构。

2.1.1.2 创建监管部门

2.1.1.3 创建消费者

2.1.1.4 加入到一个供应链条

服务机构、监管部门和消费者均可以加入到一个设定好的即有供应链条中，以参与各类活动，这个即有的供应链条是注册用户（服务机构、监管部门）通过物链管理平台创建。

2.1.1.5 设定供应链条参与者状态

这是参与者申请加入即有供应链条后能否正常参与活动的基础。未验证（审核）、已验证（审核）、已停用。

2.1.1.6 获取供应链条参与者的状态

供应链参与者在已验证（审核）的状态下，能够进行正常操作；在未验证（审核）、已停用状态下，不能进行正常操作。

2.1.2 物品相关

物品是指在供应链上流转的原材料、零部件、半成品、成品等实体商品以及以电子文件为载体的电子商品（已经发行的数字资产）。物品中包含唯一的指纹信息（物链码）。

2.1.2.1 物品定义

根据物品的类型对物品进行定义，定义的内容包括物品名称、属性名称等。

2.1.2.2 物品登记

物品登记是把物品加入到供应链中，使之可以开始在供应链中流转。对于数字资产来说相当于资产的发行。登记内容包括物品基本属性（依照定义设定）、物品指纹信息（物链码）。登记方式包括单个登记和批量登记。

2.1.2.3 设定物品流通情况

物品指纹、批次情况、拥有者、位置信息、产生（出生）时间、演变情况、转移性质（物权转移、位置转移、复制/引用）、转移情况、流通时间等。

2.1.2.4 设定物品流通的智能合约

2.1.2.5 触发物品流通的智能合约

2.1.2.6 停止触发物品流通的智能合约

2.1.2.7 物品信息查询

2.1.2.8 物品信息追踪

2.2 数字资产

物链适配器针对区块链平台在数字资产方面的优势，结合数字资产领域的特征，提供资产的创设、分配、变更、注销、冻结、查询等接口。

需要注意的是，资产一旦进入了流通环节，也就进入了物链的供应链接口体系，可以利用供应链相关接口完成操作。