EOS Java
Java API,用于使用EOSIO RPC API与基于EOSIO的区块链集。适用Java 和 Android。特色:支持自定义智能合约。
安装
方式一(推荐)
- Maven
com.redli
eoslibrary_v2.5
2.5
pom
- Gradle
implementation 'com.redli:eoslibrary_v2.5:2.5'
方式二
- 导入jar包 eoslibrary_v2.5.jar
方式三
- 下载源码导入eoslibrary module (自行修改源码针对自己项目个性化制定)
API (Ecc and Rpc)
接口返回说明(所有接口返回统一格式)如下:
{
"isSuccess":true or false,
"message":"操作成功 or 操作成功",
"data":"链返回的json信息"
}
例如(获得链信息):
{
"isSuccess":true,
"message":"操作成功",
"data":"{"server_version":"5e8e2949","chain_id":"cf057bbfb72640471fd910bcb67639c22df9f92470936cddc1ade0e2f2e7dc4f","head_block_num":28601043,"last_irreversible_block_num":28601030,"last_irreversible_block_id":"01b46ac611697416b029dc9d7ea9e0033904ddb84bb40a7cc0447e6b3a39a02f","head_block_id":"01b46ad38b76ccff4e1c31b1e64f6f80eb4b40ee870b57427cfa26961957d2da","head_block_time":"2019-06-06T06:33:54.000","head_block_producer":"sunny","virtual_block_cpu_limit":200000000,"virtual_block_net_limit":1048576000,"block_cpu_limit":199900,"block_net_limit":1048576,"server_version_string":"v1.6.3"}"
}
Ecc类
- 生成私钥 (Ecc.seedPrivate)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
seed | String | 种子 | 随机数 | Ecc.seedPrivate("随机种子") |
2.私钥获取公钥(Ecc.getPublicKey)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
privateKey | String | 私钥 | 用户私钥 | Ecc.getPublicKey("私钥") |
Rpc类
初始化Rpc
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
baseUrl | String | 链地址 | Rpc rpc = new Rpc("http://链IP:链端口") |
1.获取链信息(getChainInfo)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
无 |
2.获取账户信息(getAccount)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
account | String | 账户名称 | rpc.getAccount("smallred1111") |
3.通过私钥获取账户名(getKeyAccounts)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
privateKey | String | 私钥 | rpc.getKeyAccounts("123425") |
4.获得交易信息(getActions)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
account | String | 账户名称 | rpc.getActions("smallred1111") |
5.获得交易信息(getActions)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
account | String | 账户名称 | 必填 | |
pos | String | 账户名称 | 可选 | 默认-1 |
offset | String | 账户名称 | 可选 | 默认-20 |
6.获取表数据(getTableRows)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
scope | String | 作用域 | 必填 | |
code | String | 合约名 | 必填 | |
table | String | 表名 | 必填 | |
keyType | String | 可选 | 默认"" | |
encodeType | String | 可选 | ||
lowerBound | String | 可选 | ||
upperBound | String | 可选 | ||
limit | String | 限制 | 可选 | 默认10 |
7.获得交易信息(getCurrencyBalance)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
account | String | 账户名称 | 必填 | |
code | String | 合约名 | 必填 | |
symbol | String | 象征 | 必填 |
8.发起交易(pushTransaction)重点(支持自定义合约名)
参数 | 类型 | 参数名 | 描述 | 示例 |
---|---|---|---|---|
code | String | 合约名 | 必填 | |
action | String | 合约方法 | 必填 | |
account | String | 用户名 | 必填 | |
privateKey | String | 用户私钥 | 必填 | |
args | Map |
合约方法参数集 | 必填 |
注意:API中 1 - 7 接口可以通过EOSIO RPC API的api可以通过http请求操作,这里是根据个人项目需求把API 1-7 封装到包里方便使用的。
使用
Java
直接调用即可
Android
- 推荐使用方式如下:
final ThreadPoolExecutor threadPoolExecutor = new ThreadPoolExecutor(1, 1,0L, TimeUnit.MILLISECONDS,new LinkedBlockingQueue());
Map args1 = new HashMap<>();
args2.put("msg", "testtest");
args2.put("index", 123321);
Map args2 = new HashMap<>();
args2.put("from", "smallred1111");
args2.put("to", "smallred1112");
args2.put("quantity", "0.0001 TOK");
args2.put("memo", "阿卡丽3");
threadPoolExecutor.execute(new Runnable() {
@Override public void run() {
//自定义智能合约交易
String txnResponse1 = rpc.pushTransaction("sakuyatest13", "test", "smallred111167", SAMPLE_PRIV_KEY_FOR_TEST, args2);
System.out.println();
System.out.println("PushTransaction1: " + gson.toJson(txnResponse1));
//EOS 官方智能合约交易
String txnResponse2 = rpc.pushTransaction("eosio.token", "transfer", "smallred1111", SAMPLE_PRIV_KEY_FOR_TEST, args2);
System.out.println();
System.out.println("PushTransaction2: " + gson.toJson(txnResponse2));
threadPoolExecutor.shutdown();
}
});
ANDROID 版本使用注意项(Android P 限制了明文流量的网络请求,非加密的流量请求都会被系统禁止掉)配置如下:
1、在res目录下创建xml文件夹并在xml目录下创建network_security_config.xml,内容如下:
2、AndroidManifest:
有问题欢迎评论,或者需要自定义接口的。也欢迎Github项目地址 Issues 厘米特科技 :clap::clap::clap:
最后
致谢:
- EosCommander 椭圆曲线算法及blockchain工具类
- eos4j