百度区块链引擎BBE

    接口说明

    简介

    Quorum是在以太坊(Ethereum)的基础上开发的,提供私有智能合约执行方案,并满足企业级的性能要求。基于Quorum开发Dapp,与智能合约交互通常使用web3,需要开发者管理Nonce、构建交易、签名交易、解析合约返回数据等,并且在调用过程中容易出现各种错误,没有很好的提示和处理机制,对开发人员来说,并不是特别友好。 基于此,我们提供的Quorum合约网关旨在为用户提供企业级的合约管理服务,使用传统的RESTful API设计让应用开发人员聚焦于自身的业务逻辑和用户体验,将复杂的合约事物提交、Nonce管理等交由合约网关来处理。 Quorum合约网关支持发起私有交易和公开交易、链上结果查询以及Event日志检索功能。

    使用流程

    Quorum合约网关使用流程如下图所示。 quorum-gateway.png

    服务域名

    Quorum合约网关接口服务域名地址详见BBE中所创建或加入的Quorum联盟网络详情。查看Quorum联盟

    认证机制

    Quorum合约网关接口采用Basic auth认证方式。 其中用户名和密码详见所创建或加入的Quorum联盟。查看Quorum联盟

    幂等性

    当调用创建接口时如果遇到了请求超时或服务器内部错误,用户可能会尝试重发请求,这时用户通过clientToken参数避免创建出比预期要多的资源,即保证请求的幂等性。

    幂等性基于clientToken,clientToken是一个长度不超过64位的ASCII字符串,通常放在query string里。

    如果用户使用同一个clientToken值调用创建接口,则服务端会返回相同的请求结果。因此用户在遇到错误进行重试的时候,可以通过提供相同的clientToken值,来确保只创建一个资源。

    clientToken的有效期为24小时,以服务端最后一次收到该clientToken为准。

    上一篇
    合约管理相关接口
    下一篇
    调用合约方法接口