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。

 gradle clean build

輸出位於build目錄下。

要在沒有單元/集成測試的情況下執行完整構建，請使用：

 gradle clean assemble 

從 IDE 建構

或者，只需使用 IDE 匯入專案即可。 IntelliJ 內建了 Gradle 集成，並有免費的社群版。只需使用File | New | Project from Existing Sources並在克隆的專案來源樹的根中找到build.gradle 。

建置和使用錢包工具

bitcoinj wallettool子專案包括一個命令列錢包工具（ wallet wallet-tool wallet-tool ），可用於建立和管理基於bitcoinj的錢包（HD 鑰匙圈和 SPV 區塊鏈狀態）。的選擇了解比特幣和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 分支