1.3. Java SDK 使用说明
1.3.1. Java SDK
1.3.1.1. 下载
JS SDK 代码可在github上下载: Java SDK,可以查看详细的 文档
同时可以使用 maven:
<dependency> <groupId>com.baidu.xuper</groupId> <artifactId>xuper-java-sdk</artifactId> <version>0.3.0</version> </dependency>
|
1.3.1.2. 使用
创建客户端,假设你的节点地址为 127.0.0.1:37101:
XuperClient client = new XuperClient(“127.0.0.1:37101”);
|
向链上发交易前需要创建自己的账户,创建账户后余额为0,你可以使用 xchain-cli 程序向此地址转账:
Account account = Account.create(1, 2); System.out.println(account.getAddress()); System.out.println(account.getMnemonic());
|
当账户有余额后,你可以进行部署合约、调用合约,在这之前你需要先创建合约账户:
// 创建合约账户 client.createContractAccount(account, “1111111111111111”);
// 转账给合约账户 client.transfer(account, “XC1111111111111111@xuper”, BigInteger.valueOf(1000000), “1”);
// 查询余额 BigInteger result = client.getBalance(“XC1111111111111111@xuper”);
|
创建合约账户之后,可以部署合约,本次以部署 wasm 合约为例:
// 设置合约账户 account.setContractAccount(“XC1111111111111111@xuper”);
// 构造合约初始化参数 Map<String, byte[]> args = new HashMap<>(); args.put(“creator”, “icexin”.getBytes());
// wasm 合约编译的文件 String codePath = “./counter.wasm”; byte[] code = Files.readAllBytes(Paths.get(codePath));
// C++ 编写的合约,runtime 参数使用 “c”,合约名字为 counter client.deployWasmContract(account, code, “counter”, “c”, args);
|
部署合约后可以调用合约方法:
Map<String, byte[]> args = new HashMap<>(); args.put(“key”, “icexin”.getBytes()); Transaction tx = client.invokeContract(account, “wasm”, “counter”, “increase”, args); System.out.println(“txid: “ + tx.getTxid()); System.out.println(“response: “ + tx.getContractResponse().getBodyStr()); System.out.println(“gas: “ + tx.getGasUsed());
|
Java 合约还支持 evm 合约以及其他查询接口请参考 Java SDK 接口