bitcoinj

ビットコインへようこそ

bitcoinj ライブラリは、ビットコイン プロトコルの Java 実装であり、これにより、ビットコイン コアのローカル コピーを必要とせずに、ウォレットの管理とトランザクションの送受信が可能になります。完全なドキュメントとその使用方法を示すいくつかのサンプルアプリが付属しています。

テクノロジー

• baseおよびcoreモジュール用の Java 8+ (Java 8 API または Android 8.0 API が必要、Java 8 バイトコードにコンパイル)

• Java 17 以降 ( tools 、 wallettool 、 examples 、および JavaFX ベースのwallettemplate用)

• グラドル

  • プロジェクト全体をビルドするには Gradle 7.3 以降、または

  • Debian Gradle 4.4 ( base 、 core 、 tools 、 wallettoolおよびexamplesモジュールのみ) (以下の「リファレンス ビルド」を参照)

• Google プロトコル バッファ - シリアル化およびハードウェア通信で使用します

はじめる

始めるには、最新の JDK と Gradle をインストールすることが最善です。 masterブランチの HEAD には最新の開発コードが含まれており、さまざまな製品リリースが feature ブランチで提供されます。

コマンドラインからのビルド

公式ビルドは現在 JDK 17 を使用しています。GitHub Actions は JDK 17 および 21 でビルドおよびテストします。

 gradle clean build

出力はbuildディレクトリの下にあります。

単体テストや統合テストを行わずに完全なビルドを実行するには、以下を使用します。

 gradle clean assemble 

IDE からのビルド

あるいは、IDE を使用してプロジェクトをインポートするだけです。 IntelliJ には Gradle 統合が組み込まれており、無料の Community Edition があります。 File | New | Project from Existing Sources使用するだけです。 File | New | Project from Existing Sources 、クローンされたプロジェクトのソース ツリーのルートでbuild.gradle見つけます。

ウォレット ツールの構築と使用

bitcoinj wallettoolサブプロジェクトには、 bitcoinjベースのウォレット (HD キーチェーンと SPV ブロックチェーン状態の両方) を作成および管理するために使用できるコマンドライン ウォレット ツール ( wallet-tool wallet-tool ) が含まれています。ビットコインとbitcoinjについて学ぶ方法。

コマンドラインウォレットツールを実行する実行可能シェルスクリプトを構築するには、以下を使用します。

 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 を含む) がサポートされています。ホスト OS (Debian、Ubuntu、macOS、Windows+WSL) とアーキテクチャ (amd64、arm64) のさまざまな組み合わせをテストしました。使用方法については、 build.Containerfile参照してください。

これは、 settings-debian.gradle設定で Debian Gradle を使用します。 Debian を使用していて、Debian リポジトリから Gradle がインストールされている場合は、これらの設定を直接呼び出すことができます。

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

応用例

これらはexamplesモジュールにあります。

次はどこでしょうか？

これで、チュートリアルに従う準備が整いました。

スナップショット ビルドのテスト

bitcoinjの公式リリースを使用したアプリの構築については、チュートリアルで説明されています。

最新のmasterまたはbitcoinjのrelease-0.17ブランチの Jitpack を利用したビルドを使用してアプリを開発またはテストする場合は、正しいリンクに従って、そのブランチに対して動的に生成される手順に従ってください。

• マスターブランチ

• リリース-0.17 ブランチ