【思前享后web3j】web3j开始
小猿“思前享后”为大家分享优质内容!————Share猿
Hi大家好:
我是Share猿,Share是英文(SHARE),猿是猿猴的猿,在微信公众号、微博、简书、掘金、今日头条、CSDN都可以通过搜索“Share猿”找到我,我等你哦!小猿 “思前享后”为大家分享优质的内容!今天小猿为大家分享:开始
大家可以用最新的web3j构建项目。
2.1Maven(java8)
<dependency>
<groupId>org.web3j</groupId>
<artifactId>core</artifactId>
<version>3.3.1</version>
</dependency>
2.2.Gradle(java8)
java
compile ('org.web3j:core:3.3.1')
Android
compile ('org.web3j:core:3.3.1-android')
2.3.开始一个客户端
如果你还没有运行一个Ethereum客户端,比如Geth可以如下运行:
$ geth --rpcapi personal,db,eth,net,web3 --rpc --rinkeby
Parity(钱包)
$ parity --chain testnet
或者用Infura,他提供了免费的客户端
Web3j web3 = Web3j.build(new HttpService("https://morden.infura.io/your-token"));
想进一步学习web3j和Infura,可以到运用他们的章节去查看。
2.4.发送请求
发送一个同步请求
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/
Web3ClientVersion web3ClientVersion = web3.web3ClientVersion().send();
String clientVersion = web3ClientVersion.getWeb3ClientVersion();
发送一个异步请求给Android
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/
Web3ClientVersion web3ClientVersion = web3.web3ClientVersion().sendAsync().get();
String clientVersion = web3ClientVersion.getWeb3ClientVersion();
用于RxJava Observable
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/
web3.web3ClientVersion().observable().subscribe(x -> {
String clientVersion = x.getWeb3ClientVersion();
...
});
Android的运用
Web3j web3 = Web3jFactory.build(new HttpService()); // defaults to http://localhost:8545/
2.5.IPC
web3j还支持通过文件套接字的快速进程间通信(IPC),与web3j运行在同一主机上的客户端。在创建服务时,只需使用相关的IpcService实现而不是HttpService:
// OS X/Linux/Unix:
Web3j web3 = Web3j.build(new UnixIpcService("/path/to/socketfile"));
...
// Windows
Web3j web3 = Web3j.build(new WindowsIpcService("/path/to/namedpipefile"));
...
注意:IPC 不能应用在web3j-android.
2.6.基于java包装的智能合约的运用
在JVM中web3j可以自动生成智能合约,部署运行智能合约。
常用生成智能合约的相关代码:
$ solc <contract>.sol --bin --abi --optimize -o <output-dir>/
运用web3j命令行工具生成智能合约代码:
web3j solidity generate /path/to/<smart-contract>.bin /path/to/<smart-contract>.abi -o /path/to/src/main/java -p com.your.organisation.name
用java代码实现智能合约
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/
Credentials credentials = WalletUtils.loadCredentials("password", "/path/to/walletfile");
YourSmartContract contract = YourSmartContract.deploy(
<web3j>, <credentials>,
GAS_PRICE, GAS_LIMIT,
<param1>, ..., <paramN>).send(); // constructor params
或者你可以用一个构造好的方法去实现智能合约:
YourSmartContract contract = YourSmartContract.load(
"0x<address>|<ensName>", <web3j>, <credentials>, GAS_PRICE, GAS_LIMIT);
用一个智能合约去进行交易
TransactionReceipt transactionReceipt = contract.someMethod(
<param1>,
...).send();
去访问一个智能合约
Type result = contract.someMethod(<param1>, ...).send();
更多的智能合约请参考Solidity的智能合约编写方法。
2.7.过滤器
web3j让大家在区块链上进行开发变的更加简单。
把一个新的区块添加到区块链中:
Subscription subscription = web3j.blockObservable(false).subscribe(block -> {
...
});
把收到的所有交易添加到区块链中
Subscription subscription = web3j.transactionObservable().subscribe(tx -> {
...
});
接受一些待确认的交易记录
Subscription subscription = web3j.pendingTransactionObservable().subscribe(tx -> {
...
});
或者你已经收到了所有的区块链信息,同时又有新的区块被创建:
Subscription subscription = catchUpToLatestAndSubscribeToNewBlocksObservable(
<startBlockNumber>, <fullTxObjects>)
.subscribe(block -> {
...
});
区块链和确认交易中还有好多过滤器和方法。
主流的一些过滤器也被支持
EthFilter filter = new EthFilter(DefaultBlockParameterName.EARLIEST,
DefaultBlockParameterName.LATEST, <contract-address>)
.addSingleTopic(...)|.addOptionalTopics(..., ...)|...;
web3j.ethLogObservable(filter).subscribe(log -> {
...
});
服务即是不用也要一直可以开着
subscription.unsubscribe();
注意:在Infura中不支持过滤器。
2.8.交易
web3j可以为以太坊钱包和以太坊客户端交易提供服务。
发送以太坊给另一个账号通过你的以太坊钱包秘钥
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/
Credentials credentials = WalletUtils.loadCredentials("password", "/path/to/walletfile");
TransactionReceipt transactionReceipt = Transfer.sendFunds(
web3, credentials, "0x<address>|<ensName>",
BigDecimal.valueOf(1.0), Convert.Unit.ETHER)
.send();
创建自定义的交易
Web3j web3 = Web3j.build(new HttpService()); // defaults to http://localhost:8545/
Credentials credentials = WalletUtils.loadCredentials("password", "/path/to/walletfile");
// get the next available nonce
EthGetTransactionCount ethGetTransactionCount = web3j.ethGetTransactionCount(
address, DefaultBlockParameterName.LATEST).send();
BigInteger nonce = ethGetTransactionCount.getTransactionCount();
// create our transaction
RawTransaction rawTransaction = RawTransaction.createEtherTransaction(
nonce, <gas price>, <gas limit>, <toAddress>, <value>);
// sign & send our transaction
byte[] signedMessage = TransactionEncoder.signMessage(rawTransaction, credentials);
String hexValue = Numeric.toHexString(signedMessage);
EthSendTransaction ethSendTransaction = web3j.ethSendRawTransaction(hexValue).send();
// ...
如此,基于web3j进行以太坊的交易和转移很简单!
用管理员身份运行以太坊命令行(确保你有你钱包的秘钥)
Admin web3j = Admin.build(new HttpService()); // defaults to http://localhost:8545/
PersonalUnlockAccount personalUnlockAccount = web3j.personalUnlockAccount("0x000...", "a password").sendAsync().get();
if (personalUnlockAccount.accountUnlocked()) {
// send a transaction
}
如果你想运用Parity的命令行、Trace、Geth命令行的API,你可以用 org.web3j:parity 和org.web3j:geth modules respectively.
2.9.命令行工具
在每个web3j的jar中都有命令行工具,命令行工具允许你通过一些简单的命令去操作web3j相关功能。
- 钱包的创建
- 钱包密码管理
- 交易
- 一般的Solidity智能合约
2.10.更多详情
在java 8中构建:
- web3j提供安全的响应类型,它的类型在java 8有都有封装。
- 异步请求被封装到了java8的CompletableFutures。web3j提供了一个异步的封装类,所有的异常都能被及时的捕获到,因为CompletableFutures对一些异常缺乏支持,经常会造成捕捉不到异常。
java8和Android的构建:
- 高负载的情况下返回BigInteger,对于简单的返回可以通过Response.getResual()获得String。
- 还可以通过包容的响应参数包括原始JSON有效负载,在HttpService和IpcService类中出现。
→→→目录阅读(小猿英语没过四级,翻译的过程中难免会有好多翻译不到位的地方,如果有错请在评论区及时指正!谢谢!!)
参考文章:
【1】web3j文档·web3j
【2】区块链编程一翻译篇<一>:web3j介绍·Lucien_Lang
扫描以下公众号关注小猿↓↓↓↓↓↓↓↓
更多资讯请在简书、微博、今日头条、掘金、CSDN都可以通过搜索“Share猿”找到小猿哦!!!