简介

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

使用流程

Quorum合约网关使用流程如下图所示。

服务域名

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

认证机制

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

幂等性

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

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

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

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