mirrors/bitcoinj
1
0
Fork 0
mirror of https://github.com/bitcoinj/bitcoinj.git synced 2024-11-19 18:00:39 +01:00
Code Issues Packages Projects Releases Wiki Activity
A library for working with Bitcoin
3,880 Commits 15 Branches 53 Tags 57 MiB
Java 99.7%
Kotlin 0.2%
f75c55fe5a
Go to file
Sean Gilligan f75c55fe5a PeerGroup: migrate to BlockchainDownloadEventListener (breaking) 
* Deprecate PeerDataEventListener (aggregate of 4 listeners)
* Remove long-deprecated AbstractPeerDataEventListener (4 no-op listeners)
* Add BlockchainDownloadEventListener (aggregate of 2 listeners)
* PeerGroup: replace PeerDataEventListener with BlockchainDownloadEventListener (BREAKING!)
* DownloadProgressTracker: implement BlockchainDownloadEventListener instead of AbstractPeerDataEventListener

This is a breaking change and may require simple, one-line changes to consumers. However, it removes the
long-deprecated AbstractPeerDataEventListener and simplifies the listeners for blockchain downloading.

After another release the deprecated PeerDataEventListener can be removed.
2022-04-19 10:02:10 +02:00
.github wallettool: add some first basic JUnit 5 tests 2022-04-15 14:42:58 +02:00
core PeerGroup: migrate to BlockchainDownloadEventListener (breaking) 2022-04-19 10:02:10 +02:00
designdocs Design doc for contexts 2015-03-21 17:23:21 +01:00
examples InternalUtils: replace Guava Joiner and Splitter with native JDK equivalent 2022-04-10 16:20:00 +02:00
integration-test WalletLoadTest: add as a first integration test 2022-04-13 20:22:37 +02:00
tools convert ImmutableList to unmodifiable list 2022-03-30 16:33:22 +02:00
wallettemplate build.gradle: update javafxplugin to 0.0.12 2022-04-12 17:27:50 +02:00
wallettool Wallet: add WalletFactory parameter to loadFromFile() 2022-04-15 14:56:27 +02:00
.gitattributes Add a logo. 2013-03-01 13:59:48 +01:00
.gitignore Git-ignore Gradle wrapper files. 2018-07-31 10:37:39 +02:00
.gitlab-ci.yml .gitlab-ci.yml: Use Debian Bullseye 2021-08-31 18:19:46 +02:00
AUTHORS AUTHORS: update from git 2021-11-03 09:20:32 +01:00
build.gradle build.gradle: update protobuf-gradle-plugin to 0.8.18 2022-03-14 16:39:06 +01:00
COPYING Initial checkin of BitCoinJ 2011-03-07 10:17:10 +00:00
README.md WalletTool: Move to its own wallettool submodule 2022-01-05 00:24:42 +01:00
settings.gradle settings.gradle: print message if wallettemplate is skipped 2022-04-13 18:27:05 +02:00

README.md

Github Build Status GitLab Build Status Coverage Status

Visit our IRC channel

Welcome to bitcoinj

The bitcoinj library is a Java implementation of the Bitcoin protocol, which allows it to maintain a wallet and send/receive transactions without needing a local copy of Bitcoin Core. It comes with full documentation and some example apps showing how to use it.

Technologies

  • Java 8+ (needs Java 8 API or Android 7.0 API, compiles to Java 8 bytecode) and Gradle 4.4+ for the core module
  • Java 11+ and Gradle 4.4+ for tools, wallettool and examples
  • Java 11+ and Gradle 4.10+ for the JavaFX-based wallettemplate
  • Gradle - for building the project
  • Google Protocol Buffers - for use with serialization and hardware communications

Getting started

To get started, it is best to have the latest JDK and Gradle installed. The HEAD of the master branch contains the latest development code and various production releases are provided on feature branches.

Building from the command line

Official builds are currently using JDK 11. Our GitHub Actions build and test with JDK 11 and JDK 17.

To perform a full build (including JavaDocs and unit/integration tests) use JDK 11+.

gradle clean build

If you are using Gradle 4.10 or later, the build will automatically include the JavaFX-based wallettemplate module. The outputs are under the build directory.

To perform a full build without unit/integration tests use:

gradle clean assemble

Building from an IDE

Alternatively, just import the project using your IDE. IntelliJ has Gradle integration built-in and has a free Community Edition. Simply use File | New | Project from Existing Sources and locate the build.gradle in the root of the cloned project source tree.

Building and Using the Wallet Tool

The bitcoinj wallettool subproject includes a command-line Wallet Tool (wallet-tool) that can be used to create and manage bitcoinj-based wallets (both the HD keychain and SPV blockchain state.) Using wallet-tool on Bitcoin's test net is a great way to learn about Bitcoin and bitcoinj.

To build an executable shell script that runs the command-line Wallet Tool, use:

gradle bitcoinj-wallettool:installDist

You can now run the wallet-tool without parameters to get help on its operation:

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

To create a test net wallet file in ~/bitcoinj/bitcoinj-test.wallet, you would use:

mkdir ~/bitcoinj

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

To sync the newly created wallet in ~/bitcoinj/bitcoinj-test.wallet with the test net, you would use:

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

To dump the state of the wallet in ~/bitcoinj/bitcoinj-test.wallet with the test net, you would use:

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

Note: These instructions are for macOS/Linux, for Windows use the wallettool/build/install/wallet-tool/bin/wallet-tool.bat batch file with the equivalent Windows command-line commands and options.

Example applications

These are found in the examples module.

Where next?

Now you are ready to follow the tutorial.

Testing a SNAPSHOT build

Building apps with official releases of bitcoinj is covered in the tutorial.

If you want to develop or test your app with a Jitpack-powered build of the latest master or release-0.15 branch of bitcoinj follow the dynamically-generated instructions for that branch by following the correct link.