所谓与合约交互,就是部署好合约之后,客户端去连接以太坊节点,然后调用合约的方法。
部署智能合约的步骤
一般来说,部署智能合约的步骤为:
1、启动一个以太坊节点 (例如geth或者testrpc),或者使用Infura直接连接。
2、使用solc编译智能合约。 => 获得二进制代码。
3、将编译好的合约部署到网络。(这一步会消耗以太币,还需要使用你的节点的默认地址或者指定地址来给合约签名。) => 获得合约的区块链地址和ABI(合约接口的JSON表示,包括变量,事件和可以调用的方法)。
4、用web3j提供的API来调用合约。(部分调用类型会消耗以太币。)
2,3步的话,Remix可以直接完成。
案例解析
1、编写一个简单的合约文件SimpleStorage.sol
pragma solidity ^0.4.0;
contract SimpleStorage {
uint storedData;
function set(uint num){
storedData = num;
}
function get() constant returns (string retVal){
return "first depoly call contract";
}
}
2、通过solc、web3j命令行工具把sol合约文件编译成Java类SimpleStorage.class
如果这一步,你还不熟悉,请参考以太坊Web3j命令行生成Java版本的智能合约
3、测试节点是否链接成功
这里我连接的是infura的Rinkeby测试网络
String rinkebyUrl = "https://rinkeby.infura.io/v3/YOURE-API-KEY";
Web3j web3j = Web3jFactory.build(new HttpService(rinkebyUrl));
/**
* 获取版本信息
*/
public void getWeb3ClientVersion() {
try {
Web3ClientVersion web3ClientVersion = web3j.web3ClientVersion().sendAsync().get();
Log.i(TAG, "getWeb3ClientVersion: " + web3ClientVersion.getWeb3ClientVersion());
} catch (InterruptedException e) {
e.printStackTrace();
} catch (ExecutionException e) {
e.printStackTrace();
}
}
如果能够返回版本号,就是连接成功了。
4、部署合约
注意:合约你可以使用remix+MetaMask或者Mist钱包部署,也可以使用代码部署
//加载账户人信息,转账人私钥
Credentials credentials = Credentials.create(privateKey);
/**
* 部署合约
*/
public void deploy() {
//部署智能合约
try {
SimpleStorage simpleStorage = SimpleStorage.deploy(web3j, credentials, Contract.GAS_PRICE, Contract.GAS_LIMIT).sendAsync().get();
//部署合约后的地址
String deployContractAddress = simpleStorage.getContractAddress();
Log.i(TAG, "deployContractAddress : " + deployContractAddress);
load(deployContractAddress);
} catch (Exception e) {
e.printStackTrace();
Log.i(TAG, "deploy: " + e.getMessage());
}
}
SimpleStorage
是SimpleStorage.sol
合约文件编译生成的java类
5、加载合约
加载一个已经成功部署到ETH链上的合约
/**
* 加载一个已经部署的合约
* @param contractAddress 合约地址
*/
public void load(String contractAddress) {
simpleStorage = SimpleStorage.load(contractAddress, web3j, credentials, Contract.GAS_PRICE, Contract.GAS_LIMIT);
new Thread(new Runnable() {
@Override
public void run() {
try {
boolean isValid = simpleStorage.isValid();
Log.i(TAG, "contract isValid : " + isValid);
if (isValid) {
get();
}
} catch (IOException e) {
e.printStackTrace();
Log.i(TAG, "load: " + e.getMessage());
}
}
}).start();
}
simpleStorage.isValid()
是验证合约是否可用,如果合约地址没有问题,接下来就可以调用合约的方法进行交互了。
6、合约交互
注意:这里是调用合约中的一个get()
方法
/**
* 调用合约的方法
*/
public void get() {
RemoteCall<String> remoteCall = simpleStorage.get();
try {
String result = remoteCall.sendAsync().get();
Log.i(TAG, "get result : " + result);
} catch (InterruptedException e) {
e.printStackTrace();
Log.i(TAG, "get: " + e.getMessage());
} catch (ExecutionException e) {
e.printStackTrace();
Log.i(TAG, "get: " + e.getMessage());
}
}
这里的get
在java类中是这样的
public RemoteCall<String> get() {
final Function function = new Function(FUNC_GET,
Arrays.<Type>asList(),
Arrays.<TypeReference<?>>asList(new TypeReference<Utf8String>() {}));
return executeRemoteCallSingleValueReturn(function, String.class);
}
调用合约get()
方法的结果
至此,android与ETH合约交互就成功了。