java以太坊库web3j文档

入门介绍
入门开始 Maven Gradle 启动客户端 发送请求 IPC 通过java打包以太坊智能合约 Filters 交易 命令行工具 其他的细节
模块
模块简介
交易
交易简介 如何获得以太币Ether 以太坊测试链 在testnet测试链或者私有链上挖掘 gas 交易机制 通过以太坊ethereum客户端进行认证签名交易 离线交易签名认证 创建和使用钱包文件 签署以太坊交易 交易随机数 交易类型 以太币从一方交易到另一方 使用智能合约打包器 创建一个智能合约 与智能合约交易 查询智能合约状态
智能合约
智能合约简介 从solidity语言开始 编译solidity源代码 部署智能合约及与智能合约交互 智能合约示例demo EIP-20以太坊智能合约通证标准 智能合约封装包 构建与部署智能合约 智能合约有效性 交易管理器 在交易中指定链ID:EIP-155 交易收据处理器 调用交易和事件 调用常量方法 动态gas价格与限价 web3j实例
应用二进制接口即ABI简介
应用二进制接口即ABI简介 类型映射 ABI的进一步细节 依赖关系
递归长度前缀RLP编码方案
递归长度前缀RLP编码方案 RLP类型 交易编码 依赖关系
过滤器Filters和事件Events
过滤器Filters和事件Events 块和交易过滤器 再现过滤器 主题过滤器和EVM事件 操作组合注记 进一步的例子
命令行工具
命令行工具 web3j命令行工具作为钱包工具 智能合约封装包
如何管理APIs
如何管理APIs
如何在web3j中使用Infura
签名 Infura Http 客户端 交易
以太坊名称服务ENS
以太坊名称服务ENS ENS在web3j中的使用 web3j实现 Unicode技术标准UTS46 注册域名
web3j常见问题解决方案
你有一个使用web3j开发的项目吗? 我提交了一个交易,但没有被开采。 我想了解JSON-RPC请求和响应的详细信息。 我想在测试链上获得一些以太,又不想去开采。 如何从交易调用的智能合约方法中获取返回值? 是否可以用交易发送任意文本? 我已生成智能合约封装包但二进制文件是空的? 我的ENS查询失败了 以太坊常见问题集 web3j项目捐赠地址 我在哪里可以获得Web3J的商业支持?
在线工具推荐: Three.js AI纹理开发包 - YOLO合成数据生成器 - GLTF/GLB在线编辑 - 3D模型格式在线转换 - 可编程3D场景编辑器

调用交易和事件

所有交易的智能合约方法以相同的参数值命名为它们的solidity方法。交易调用不返回任何值,同样不需要考虑方法指定的返回类型。因此,对于所有交易的方法,只是返回与交易关联的交易收据。

TransactionReceipt transactionReceipt = contract.someMethod(
             <param1>,
             ...).send();

交易收据是十分有用的有两个主要原因:

  • 它提供了交易驻留的挖掘块的详细信息。
  • 被调用的solidity事件将被记录为交易的一部分,然后可以被提取。

在智能合约中定义的任何事件都将用一个名为process<Event Name>Event方法在智能合约封装包中进行表示,该事件采用交易收据,并从中提取索引和非索引事件参数,这些参数在EventValues实例中被解码返回:

EventValues eventValues = contract.processSomeEvent(transactionReceipt);

或者,你可以使用可观察的过滤器Observable filter,而不是监听与智能合约相关联的事件:

contract.someEventObservable(startBlock, endBlock).
        .subscribe(event -> ...);

有关使用可观察过滤器的详细信息,请参阅过滤器和事件

请记住,对于任何索引数组、字节和字符串solidity参数类型,它们的Keccak-256 hash值将被返回,请参阅事件文档以获取更多信息。