Chain33的Java SDK提供交易构造、交易签名、数据加密、发送交易、查询交易、区块链查询等能力，以便于应用层更容易的接入区块链。
支持离线生成助记词，私钥，公钥，地址。
支持查询区块链信息，如区块高度、交易、节点信息、同步状态。
支持部署EVM和WASM合智能合约，并调用。
支持JSON-RPC和gRPC调用。
兼容国密标准SM2、SM3和SM4。
支持原生存证、积分发行和转账等能力。
支持EVM合约部署，调用能力
支持web3j abi库与chain33的适配工作
1.下载最新的JAVA-SDK版本
下载地址：https://github.com/33cn/chain33-sdk-java/releases/download/1.0.18/chain33-sdk-java-1.0.18.zip
2.将SDK压缩包中的JAR包安装到本地仓库。 在JAR包所在目录，执行以下命令：
mvn install:install-file -Dfile=chain33-sdk-java.jar -DgroupId=cn.chain33 -DartifactId=chain33-sdk-java -Dversion=1.0.18 -Dpackaging=jar执行结果中打印BUILD SUCCESS，表明添加成功。 如果time out导致构建失败，可以再次执行以上命令，直至构建成功。
3.通过pom.xml导入依赖的jar包 如果导入依赖缓慢，或出现Connection timed out的报错信息，则可能是因为默认中央仓库下载超时，可以切换成阿里云镜像重试。
<!—阿里云镜像 -->
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>4.准备好环境，使用RpcClient调用接口
// JSONRPC调用方式：初始化,设置Ip端口
RpcClient client = new RpcClient("x.x.x.x",8801);
调用接口
client.接口();// GRPC调用方式
GrpcClient client = new GrpcClient(host);
调用接口
client.run(o->o.method(builder));| 包名 | 功能 | 测试用例 |
|---|---|---|
| CoinsUtil | coins主币积分交易构造 | CoinsTest |
| EvmUtil | evm相关交易构造 | EvmTest |
| AddressUtil | 地址相关操作工具 | |
| TransactionUtil | 交易相关操作工具 | |
| http | http日志订阅服务 | httpTest |
| Transaction | 交易包装类,交易签名重构等一系列方法 | |
| Transactions | 交易组的包装类,交易组签名重构等一系列方法 | |
| abi | 兼容chain33系统的abi库 |
下面罗列的是java sdk提供的接口，具体调用可以参考测试代码里的例子
- client.isSync() 查询节点同步状态
- client.submitTransaction(txhash) 提交交易
- client.queryTransaction(txhash) 根据哈希查询交易信息
- client.getTxByHashes(hashlist) 根据哈希数组批量获取交易信息
- client.getHexTxByHash(hash) 根据哈希获取交易的hex字符串
- client.getBlocks(start,end,isdetail) 获取区间区块
- client.getLastHeader() 获取最新的区块头
- client.getHeaders(start,end,isdetail) 获取区间区块头
- client.getBlockHash(height) 获取区块的 hash 值
- client.getBlockOverview(hash) 获取区块的详细信息
- client.getPeerInfo() 获取远程节点列表
- client.getTxByHashes() 根据哈希数组批量获取交易信息
- client.getWalletStatus() 获取钱包状态
- client.lock() 钱包上锁
- client.importPrivatekey() 导入私钥
- client.unlock(passwd,walletorticket,timeout) 钱包解锁
- client.newAccount(label) 创建账户
- client.seedGen() 生成随机的seed
- client.seedSave(seed,password) 保存seed并用密码加密
- client.seedGet(passwd) 通过钱包密码获取钱包的seed原文
- client.setlabel(addr,label) 设置标签
- client.getAccountList() 获取账户列表
- client.createRawTokenPreCreateTx(参数) 创建预创建token的交易（未签名）
- client.createRawTokenFinishTx(参数) 创建完成创建token的交易（未签名）
- client.CreateRawTokenRevokeTx(参数) 创建撤销预创建token的交易（未签名）
- client.createRawTransaction(参数) 构造交易
- client.signRawTx(参数) 交易签名
- client.getTokenBalance(参数) 查询地址token余额
- client.getTxByAddr(参数) 根据地址获取交易信息
- client.queryCreateTokens(参数) 查询token列表
- client.queryAccountBalance(参数) 查询地址下的token/trace合约下的token资产
- client.queryBalance(参数) 查询地址余额
- client.submitRawTransaction(参数) 发送签名后的交易
- client.sendToAddress(参数) 交易
- client.createTransaction(参数) 合约交易创建
- client.addPushSubscribe(参数) 注册推送回调
- client.listPushes(参数) 列举推送服务
- client.getPushSeqLastNum(参数) 获取某推送服务最新序列号的值
- TransactionUtil.createTransferPayLoad(参数) 本地构造转账交易payload
- TransactionUtil.createTransferTx(参数,payload) 本地构造转账交易体
- 创建好的交易体使用client.submitTransaction提交交易
- TransactionUtil.generatorPrivateKeyString() 创建私钥
- TransactionUtil.getHexPubKeyFromPrivKey(私钥) 根据私钥获得公钥
- TransactionUtil.genAddress(公钥) 根据公钥获取地址
- TransactionUtil.validAddress(地址) 校验地址是否正确
- TransactionUtil.createPrecreateTokenTx(参数) 本地创建预创建token交易
- TransactionUtil.createTokenFinishTx(地址) 本地创建完成创建token交易
- StorageUtil.createOnlyNotaryStorage 创建内容存证模型(payload)
- StorageUtil.createHashStorage 创建哈希存证模型(payload)
- StorageUtil.createLinkNotaryStorage 创建链接存证模型(payload)
- StorageUtil.createEncryptNotaryStorage 隐私存证模型型(payload)
- StorageUtil.createEncryptShareNotaryStorage 创建分享隐私存证模型(payload)
- SeedUtil.generateMnemonic 离线生成助记词
- SeedUtil.createAccountBy33PATH 根据助记词离线生成私钥和地址
POS公链： https://github.com/andyYuanFZM/btyDemo
联盟链： https://github.com/andyYuanFZM/consortiumDemo
POS33公链： https://github.com/andyYuanFZM/yccDemo