简介

开发以太坊Dapp，与智能合约交互通常使用web3，这种方式需要开发者管理Nonce、构建交易、签名交易、解析合约返回数据等，并且在调用过程中容易出现各种错误，没有很好的提示和处理机制，对开发人员来说，并不是特别友好。 基于此，我们开发的以太坊合约网关旨在为用户提供企业级的合约管理服务，使用传统的RESTful API设计让应用开发人员聚焦于自身的业务逻辑和用户体验，将复杂的合约事物提交、Nonce管理等交由合约网关来处理。

使用流程

以太坊合约网关使用流程如下图所示。

服务域名

以太坊合约网关接口服务域名地址详见BBE中所创建的以太坊网络详情。查看以太坊网络

认证机制

以太坊合约网关接口采用Basic auth认证方式。 其中用户名和密码详见所创建的以太坊网络。查看以太坊网络

幂等性

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

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

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

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