bitcoinj

欢迎来到比特币j

bitcoinj 库是比特币协议的 Java 实现，它允许它维护钱包并发送/接收交易，而不需要 Bitcoin Core 的本地副本。它附带完整的文档和一些示例应用程序，展示如何使用它。

技术

• Java 8+（需要 Java 8 API 或 Android 8.0 API，编译为 Java 8 字节码）作为base和core模块

• Java 17+ 用于tools 、 wallettool 、 examples和基于 JavaFX 的wallettemplate

• 摇篮

  • Gradle 7.3+ 用于构建整个项目或

  • Debian Gradle 4.4 仅适用于base 、 core 、 tools 、 wallettool和examples模块（请参阅下面的“参考构建”）

• Google Protocol Buffers - 用于序列化和硬件通信

入门

首先，最好安装最新的 JDK 和 Gradle。 master分支的HEAD包含最新的开发代码，并且在功能分支上提供各种生产版本。

从命令行构建

官方构建当前使用 JDK 17。我们的 GitHub Actions 使用 JDK 17 和 21 进行构建和测试。

 gradle clean build

输出位于build目录下。

要在没有单元/集成测试的情况下执行完整构建，请使用：

 gradle clean assemble 

从 IDE 构建

或者，只需使用 IDE 导入项目即可。 IntelliJ 内置了 Gradle 集成，并且有免费的社区版。只需使用File | New | Project from Existing Sources并在克隆的项目源树的根中找到build.gradle 。

构建和使用钱包工具

bitcoinj wallettool子项目包括一个命令行钱包工具（ wallet-tool ），可用于创建和管理基于bitcoinj的钱包（HD 钥匙串和 SPV 区块链状态）。在比特币测试网上使用wallet-tool是一个很棒的选择了解比特币和bitcoinj的方式。

要构建运行命令行钱包工具的可执行 shell 脚本，请使用：

 gradle bitcoinj-wallettool:installDist

您现在可以运行不带参数的wallet-tool来获取有关其操作的帮助：

 ./wallettool/build/install/wallet-tool/bin/wallet-tool

要在~/bitcoinj/bitcoinj-test.wallet中创建测试网钱包文件，您可以使用：

 mkdir ~/bitcoinj 

 ./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet create

要将~/bitcoinj/bitcoinj-test.wallet中新创建的钱包与测试网同步，您可以使用：

 ./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet sync

要使用测试网将钱包的状态转储到~/bitcoinj/bitcoinj-test.wallet中，您可以使用：

 ./wallettool/build/install/wallet-tool/bin/wallet-tool --net=TESTNET --wallet=$HOME/bitcoinj/bitcoinj-test.wallet dump 

笔记	这些说明适用于 macOS/Linux，对于 Windows，请使用wallettool/build/install/wallet-tool/bin/wallet-tool.bat批处理文件以及等效的 Windows 命令行命令和选项。

构建参考版本

我们的参考版本（也用于我们的版本）在容器内运行，以提供良好的可重复性。支持 Buildah 1.26+、Podman 4.1+ 和 Docker（带有 BuildKit）。我们测试了主机操作系统（Debian、Ubuntu、macOS、Windows+WSL）和架构（amd64、arm64）的各种组合。有关使用说明，请参阅build.Containerfile 。

这使用 Debian Gradle 和settings-debian.gradle设置。如果您碰巧使用 Debian 并从 Debian 存储库安装了 Gradle，则可以直接调用这些设置：

 gradle --settings-file settings-debian.gradle clean build

应用示例

这些可以在examples模块中找到。

接下来去哪里？

现在您已准备好按照教程进行操作。

测试快照构建

本教程介绍了如何使用bitcoinj的官方版本构建应用程序。

如果您想使用由 Jitpack 驱动的bitcoinj最新master或release-0.17分支的版本来开发或测试您的应用程序，请通过正确的链接按照该分支动态生成的说明进行操作。

• 主分支

• 版本 0.17 分支