mirror of
https://github.com/bitcoinj/bitcoinj.git
synced 2025-03-13 11:36:15 +01:00
A library for working with Bitcoin
9e91ae629e
This happens if the store is relatively fresh and has not yet fully wrapped around at least once. Thus, entire entries of the ring buffer are still zeroed, and in particular the hash field of store entries will be zero. In consequence, get() is locating and returning an invalid block when asked to look for the zero hash. Valid blocks that hash to zero will require an astronomical amount of mining. So we fix this bug by hardcoding the zero hash to never be found in our store. Includes a test for this edge case. |
||
|---|---|---|
| .github | ||
| core | ||
| designdocs | ||
| examples | ||
| examples-kotlin | ||
| integration-test | ||
| tools | ||
| wallettemplate | ||
| wallettool | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| AUTHORS | ||
| build-scan-agree.gradle | ||
| build.Containerfile | ||
| build.gradle | ||
| COPYING | ||
| README.adoc | ||
| settings.gradle | ||
image:https://github.com/bitcoinj/bitcoinj/workflows/Java%20CI/badge.svg[GitHub Build Status,link=https://github.com/bitcoinj/bitcoinj/actions] image:https://gitlab.com/bitcoinj/bitcoinj/badges/master/pipeline.svg[GitLab Build Status,link=https://gitlab.com/bitcoinj/bitcoinj/-/pipelines] image:https://coveralls.io/repos/bitcoinj/bitcoinj/badge.png?branch=master[Coverage Status,link=https://coveralls.io/r/bitcoinj/bitcoinj?branch=master] image::https://img.shields.io/badge/chat-Join%20bitcoinj--users%20on%20Matrix-blue[Join the bitcoinj-users Matrix room, link=https://matrix.to/#/#bitcoinj-users:matrix.org] ### 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 8.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 17+ and Gradle 7.3+ for the JavaFX-based `wallettemplate` * https://gradle.org/[Gradle] - for building the project * https://github.com/google/protobuf[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 17. Our GitHub Actions build and test with JDK 11, 17 and 21. To perform a full build (_including_ JavaDocs, unit/integration _tests_, and `wallettemplate`) use JDK 17+. ``` gradle clean build ``` If you are using JDK 17+ and Gradle 7.3+, 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. http://www.jetbrains.com/idea/download/[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=TESTNET --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=TESTNET --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=TESTNET --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. ### Building the reference build Our reference build (which is also used for our releases) is running within a container to provide good reproducibility. Buildah 1.26+, Podman 4.1+ and Docker (with BuildKit) are supported. We tested various combinations of host OSes (Debian, Ubuntu, macOS, Windows+WSL) and architectures (amd64, arm64). For usage instructions see `build.Containerfile`. ### Example applications These are found in the `examples` module. ### Where next? Now you are ready to https://bitcoinj.github.io/getting-started[follow the tutorial]. ### Testing a SNAPSHOT build Building apps with official releases of *bitcoinj* is covered in the https://bitcoinj.github.io/getting-started[tutorial]. If you want to develop or test your app with a https://jitpack.io[Jitpack]-powered build of the latest `master` or `release-0.17` branch of *bitcoinj* follow the dynamically-generated instructions for that branch by following the correct link. * https://jitpack.io/#bitcoinj/bitcoinj/master-SNAPSHOT[master] branch * https://jitpack.io/#bitcoinj/bitcoinj/release-0.17-SNAPSHOT[release-0.17] branch