java 语言接入教程

1. 获取 opb-sdk-java 代码

• 从 maven 中央仓库引入 (load from central maven)

https://mvnrepository.com/artifact/io.github.bianjieai

<dependency>
    <groupId>io.github.bianjieai</groupId>
    <artifactId>opb-sdk</artifactId>
    <version>${version}</version>
</dependency>

• 手动下载引入 (manual load)

   从 Asset 页面下载 jar 包，并手动将 jar 包上传到私服

• 手动下载 SDK

下载链接： opb-sdk-java

2. 初始化客户端

:::tip
代码中的 nodeUri 应填写项目提供的参数 RPCAddr
:::

• 测试环境

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

注：测试网没有网关接入要求，开发者可以根据业务需要先在测试网中进行相关应用接口的调试

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

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

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

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

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

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

3. 创建离线链账户

  说明： 如果您是初次使用，请在完成链账户创建后，通过 AVATA 控制台上传该链账户作为主账户，并申请创建类别权限并对链账户充值能量值。

  如果您已经有主账户，可以忽略以上说明。

4. 恢复私钥

  在使用 sdk 方式对接前，此步骤是必须的。

5. 交易类型

  每笔交易都需要有对应的交易类型，来保证交易顺利完成。(建议按照次设置方式即可)

  如果您想深入了解三种提交交易的模式可以参考：最佳实践建议
BaseTx baseTx = new BaseTx(400000, new Fee("400000", "ugas"), BroadcastMode.sync);

6. 授权上链

  以上操作都完成后，准备工作已经完成。此时我们需要开始上链操作，当前创建的账户为非主账户，请使用主账户进行授权，来确认给该账户进行授权，否则无法主动发起交易。

• GrantAllowance(String granter, String grantee, BaseTx baseTx)：授予全部额度
• GrantAllowance(String granter, String grantee, String denom, String amount, Timestamp timestamp, BaseTx baseTx) ：授予指定额度
• RevokeAllowance(String granter, String grantee, BaseTx baseTx) ：撤销授权
  ### 7. 进行上链操作

  至此已经完成所有上链前的准备工作，可以开始进行上链操作。