Android开发实战,手把手教你调用以太坊智能合约
随着区块链技术的普及,越来越多的移动应用需要与以太坊智能合约进行交互,无论是钱包类App、NFT应用,还是链上游戏,安卓端调用以太坊合约都是核心功能之一,本文将以最流行的Java库 Web3j 为例,详细介绍在Android项目中调用以太坊智能合约的完整流程。
准备工作
添加依赖
在项目 build.gradle 中引入 Web3j:
dependencies {
implementation 'org.web3j:core:4.9.8'
}
注意:Web3j 需要 Java 8 支持,请在 android 块中配置:
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
添加网络权限
在 AndroidManifest.xml 中添加:
<uses-permission android:name="android.permission.INTERNET" />
核心概念
在与合约交互前,需要理解几个关键要素:
- RPC节点:安卓端不直接运行区块链节点,而是通过 Infura、Alchemy 等服务商提供的 RPC 接口连接以太坊网络。
- 合约地址:智能合约部署后的唯一地址。
- ABI:合约的接口描述文件,定义了可调用的函数与事件。
- 私钥/凭证(Credentials):只有涉及写操作(修改链上状态)时才需要,读操作通常无需签名。
连接以太坊网络
// 连接以太坊主网(这里以 Infura 为例)
Web3j web3j = Web3j.build(
new HttpService("https://mainnet.infura.io/v3/你的项目ID")
);
// 测试网络版本号(用于验证连接)
Web3ClientVersion clientVersion = web3j.web3ClientVersion().send();
Log.d("Web3j", "连接成功: " + clientVersion.getWeb3ClientVersion());
读取合约数据
读取数据不消耗Gas,也无需私钥,以调用合约中的 name() 方法为例:
// 合约地址
String contractAddress = "0x你的合约地址";
// 函数编码:调用 name(),无参数
Function function = new Function(
"name",
Collections.emptyList(),
Collections.singletonList(new TypeReference<Utf8String>() {})
);
String encodedFunction = FunctionEncoder.encode(function);
// 发起 eth_call 请求
EthCall response = web3j.ethCall(
Transaction.createEthCallTransaction(null, contractAddress, encodedFunction),
DefaultBlockParameterName.LATEST
).send();
// 解析返回值
List<Type> results = FunctionReturnDecoder.decode(
response.getValue(),
function.getOutputParameters()
);
if (!results.isEmpty()) {
String name = results.get(0).getValue().toString();
Log.d("合约数据", "Token名称: " + name);
}
写入合约数据
写操作会改变链上状态,需要创建交易、签名并支付Gas。
加载凭证
// 通过私钥加载凭证(实际项目中请妥善保管私钥,切勿硬编码)
Credentials credentials = Credentials.create("你的私钥");
发送交易
以调用合约的 transfer(address, uint256) 方法为例:
Function transfer = new Function(
"transfer",
Arrays.asList(
new Address("0x接收方地址"),
new Uint256(BigInteger.valueOf(1000000000000000000L)) // 1 ETH(以Wei为单位)
),
Collections.emptyList() // transfer 通常无返回值解析需求
);
// 获取当前Gas价格
EthGasPrice gasPrice = web3j.ethGasPrice().send();
// 估算Gas限制
BigInteger gasLimit = BigInteger.valueOf(60000);
// 获取Nonce,防止重放攻击
EthGetTransactionCount transactionCount = web3j.ethGetTransactionCount(
credentials.getAddress(),
DefaultBlockParameterName.PENDING
).send();
BigInteger nonce = transactionCount.getTransactionCount();
// 构建原始交易(链ID 1 为主网,测试网各不相同)
RawTransaction rawTransaction = RawTransaction.createTransaction(
nonce,
gasPrice.getGasPrice(),
gasLimit,
contractAddress,
BigInteger.ZERO, // 调用合约时 value 为 0
FunctionEncoder.encode(transfer)
);
// 签名并发送
byte[] signedMessage = TransactionEncoder.signMessage(
rawTransaction, 1, credentials);
String hexValue = Numeric.toHexString(signedMessage);
EthSendTransaction transactionResponse =
web3j.ethSendRawTransaction(hexValue).send();
if (transactionResponse.hasError()) {
Log.e("交易失败", transactionResponse.getError().getMessage());
} else {
String txHash = transactionResponse.getTransactionHash();
Log.d("交易成功", "交易哈希: " + txHash);
}
进阶技巧:使用合约包装类
手动编码调用较为繁琐,Web3j 提供了代码生成工具,可以根据ABI和BIN文件自动生成 Java 合约类:
web3j generate solidity -a Truffle合约ABI.json \
-b 合约BIN.bin \
-o app/src/main/java \
-p com.example.app.contracts
生成后调用就变得非常简洁:
// 部署的合约实例
MyContract contract = MyContract.load(
contractAddress, web3j, credentials,
new DefaultGasProvider()
);
// 异步调用转账
RemoteCall<TransactionReceipt> receipt = contract.transfer(
"0x接收方地址",
BigInteger.valueOf(1000000000000000000L)
);
注意事项
- 主线程禁止网络请求:所有Web3j调用必须放在子线程或使用异步方式,否则会触发
NetworkOnMainThreadException。 - 私钥安全:绝对不要将私钥硬编码或存储在明文配置中,建议使用 Android Keystore 系统或加密存储。
- Gas费用控制:写操作成本高昂,建议先在 Sepolia 等测试网充分验证。
- 交易确认机制:发送交易后需轮询交易回执(Receipt),确认交易被矿工打包成功。
- RPC服务限流:免费RPC节点有调用频率限制,生产环境建议使用付费服务或自建节点。
本文介绍了在安卓端使用 Web3j 调用以太坊智能合约的核心流程:连接RPC节点、读取数据(eth_call)、写入数据(签名交易)以及使用代码生成工具简化开发,掌握这些内容后,你就可以在Android应用中实现代币转账、NFT铸造、链上数据查询等功能了。
区块链移动端开发仍在快速发展,建议持续关注 Web3j 官方文档和以太坊生态的最新动态,祝各位开发顺利!
The End
发布于:2026-10-29,除非注明,否则均为原创文章,转载请注明出处。

