底层链 API 接入说明

第一步：注册并认证

• 1.1 注册并登录 AVATA 服务平台
• 1.2 进行您的 KYC 认证，包括实名认证和企业认证
• 1.3 等待认证审核结果（1-3个工作日），审核通过后可进行项目创建

第二步：创建项目并下载项目参数

• 2.2 项目创建完成后，系统会自动生成项目对应的 API 服务参数，您需下载保存（请仔细保管，谨防丢失）
• 2.3 获取项目参数后，可按照 Avata API 服务接口文档 提供的「API 服务网关鉴权签名示例」生成签名参数
• 2.4 在 AVATA 服务平台 完成企业认证后，系统会自动发放测试环境的项目参数至您的项目列表中，您可下载测试环境的项目参数进行在测试环境中使用

第三步：测试环境及生产环境的底层链 API 初始化配置

• 3.1 IRITA 测试环境

原生模块：

Chain-ID：testing
RPC：testnet.bianjie.ai:26657
gRPC：testnet.bianjie.ai:9090

EVM：

Chain-ID：12231
RPCAddr: https://evmrpc.testnet.bianjie.ai
wsAddr: wss://evmws.testnet.bianjie.ai

::: highlight yellow 💡
【IRITA 测试环境】没有网关接入要求，开发者可以根据业务需要先在测试网中进行相关应用接口的调试
:::

• 3.2 Turbo 测试环境

EVM：

Chain-ID：12232
RPCAddr: https://evmrpc.turbo.testnet.bianjie.ai 

::: highlight yellow 💡
【Turbo 测试环境】有网关接入要求，开发者使用 Web3 生态工具连接网关，请在 URL 的 Query 参数中传入项目 Key，例： https://evmrpc.turbo.testnet.bianjie.ai?x-api-key=<项目 Key>
:::

• 3.3 【文昌链-天舟】生产环境

原生模块：

Chain-ID：wenchang-tianzhou
RPCAddr: https://rpc.tianzhou.wenchang.bianjie.ai
wsAddr: wss://ws.tianzhou.wenchang.bianjie.ai
gRPCSAddr: grpcs.tianzhou.wenchang.bianjie.ai:443

EVM：

Chain-ID：1224
RPCAddr: https://evmrpc.tianzhou.wenchang.bianjie.ai
wsAddr: wss://evmws.tianzhou.wenchang.bianjie.ai

::: highlight yellow 💡
【文昌链-天舟】生产环境有网关接入要求，开发者在初始化 OPB 网关账号时，须传入项目 Key（之前已下载的项目接入配置参数），用于网关鉴权

EVM： 使用 Web3 生态工具连接网关，请在 URL 的 Query 参数中传入项目 Key，例： https://evmrpc.tianzhou.wenchang.bianjie.ai?x-api-key=<项目 Key>
:::

• 3.4 【文昌链-天和】生产环境

原生模块：

Chain-ID：wenchangchain
RPCAddr: https://rpc.tianhe.wenchang.bianjie.ai
wsAddr: wss://ws.tianhe.wenchang.bianjie.ai
gRPCSAddr: grpcs.tianhe.wenchang.bianjie.ai:443

EVM：

Chain-ID：1223
RPCAddr: https://evmrpc.tianhe.wenchang.bianjie.ai
wsAddr: wss://evmws.tianhe.wenchang.bianjie.ai

::: highlight yellow 💡
注： 【文昌链-天和】生产环境有网关接入要求，开发者在初始化 OPB 网关账号时，须传入项目 Key（之前已下载的项目接入配置参数），用于网关鉴权：

EVM：使用 Web3 生态工具连接网关，请在 URL 的 Query 参数中传入项目 Key，例： https://evmrpc.tianhe.wenchang.bianjie.ai?x-api-key=<项目 Key>
:::

• 3.5 【文昌链极速网】生产环境

EVM：

Chain-ID：1226 
RPCAddr: https://evmrpc.turbo.bianjie.ai 

::: highlight yellow 💡
【文昌链极速网】有网关接入要求，开发者使用 Web3 生态工具连接网关，请在 URL 的 Query 参数中传入项目 Key，例： https://evmrpc.turbo.bianjie.ai?x-api-key=<项目 Key>
:::

第四步：资金账户充值

• 4.1 充值方式：

  您可登录 AVATA 服务平台，在用户中心-我的账户-充值界面进行资金账户充值，AVATA 平台目前支持微信支付、支付宝支付、线下汇款三种充值方式

• 4.2 充值说明：

  AVATA 平台针对每个用户都提供专属的资金账户。文昌链原生模块上链交易所产生的能量值消耗，都将从您的专属资金账户中支出。您也可以针对不同底层链服务，自主使用您的“资金账户”余额购买平台提供的具体服务，包括但不限于服务包、能量值、业务费等服务

第五步：创建链账户并申请「创建 NFT/MT 类别」权限

• 5.1 您可登录 Avata 服务平台，在链账户管理-我的链账户界面上传您已经离线创建好的链账户地址
• 5.2 点击链账户列表中的操作项【申请权限】，获取「创建 NFT/MT 类别」权限(授权属于上链交易，需要一定时间等待)

第六步：购买能量值

 在区块链上发起交易时，需要消耗一定的计算和存储资源，由于这些资源是有限的，因此每笔交易需要消耗一定的通信费作为限制，可防止DDoS等恶意攻击造成的资源恶意消耗。上链交易通信费消耗通过链上编程的方式形成了链上事务级的收费记账单位，单位为“能量值”。

有两种扣费方式：

• 代付方式：
  由某代付链账户授权，其它链账户交易所消耗能量值都由该代付账户统一支付，方便管理；
  您需要为该代付账户购买能量值，并授权其它链账户代付权限。

• 非代付方式：
  由各链账户自行支付能量值。
  您需要为需要交易的链账户购买能量值，并管理各链账户的能量值余额，我们提供批量充值接口。

操作方式：

• 1.购买能量值（控制台与调用接口两种方法均可）

   AVATA 服务平台：链账户管理 - 我的链账户 - 更多 - 能量值购买

   调用充值接口

   批量充值接口

• 2.其它链账户代付授权：

   opb-sdk-Java 代付示例

   opb-sdk-go 代付示例

第七步：参考底层链 API 说明文档，使用 opb-sdk 工具包与区块链进行交互，实现业务对接

底层链 API 文档链接：

Java 语言版本：https://github.com/bianjieai/opb-sdk-java

Go 语言版本：https://github.com/bianjieai/opb-sdk-go