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>
从 Asset
页面下载 jar
包,并手动将 jar
包上传到私服2. 初始化客户端#
代码中的 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. 进行上链操作#
至此已经完成所有上链前的准备工作,可以开始进行上链操作。