Bitcoin Verde v1.3.0







v1.0.0 - Initial beta release.


Bitcoin-Verde is a ground-up implementation of the Bitcoin (Cash) (BCH) protocol. This project is an indexing full node, blockchain explorer, and library.


Bitcoin Core (BTC) is the primary group responsible for development on BTC's client. In the past, lack of a diversified development team and node implementation, have caused bugs to become a part of the protocol. BCH currently has roughly two popular full-node implementations (Bitcoin ABC and Bitcoin Unlimited). However, these implementations are forked versions of Bitcoin Core, which means they may share the same (undiscovered) bugs. With a diverse network of nodes, bugs in the implementation of the protocol will result in incompatible blocks, causing a temporary fork. This situation is healthy for the network in the long term, as the temporary forks will resolve over time, with the intended implementation becoming the consensus.


Bitcoin Verde has gone through weeks of testing, but v1.1.0 is still considered a Beta release. Please use this software with discretion. As v1.1.0, the Bitcoin Verde node validates the entirety of the BCH blockchain, relays new blocks and transactions, and can process upwards of 4,000 transactions per second; however this implementation does not have the bitcoind tests run against it yet, so there may still be implementation differences between this implementation and the reference client's derivatives.

Windows Users: Bitcoin Verde has been tested heavily on Linux and OS X. On Windows, there may be many issues. On Windows, expect your node to not run as quickly due to secp256k1 and utxo-cache libraries not being cross-compiled for Windows. Furthermore, the Windows build may not even complete its initial block download. If you are kind enough to run this implementation on Windows, please report any problems.

Getting Started

To build the node, run the following:


This command will run the gradle command to download dependencies and build the jar file, its configuration, and run-scripts, located within the out directory.

To enable and compile the btree-utxocache, configure your environment to compile C++ code; on linux installing the 'build-essential' package should suffice. Then cd into jni/utxo-cache and run ./scripts/, and ./scripts/ (NOTE: These scripts are located at jni/utxo-cache/scripts, not the project root). After the build completes, cd into the project root, and rebuild the project via ./scripts/

To run the node, you may cd into out and execute one of the run-* scripts. Or from the project directory, run ./scripts/, ./scripts/, ./scripts/ etc.

Review the conf/server.conf and change any settings as desired. Changes made to conf/server.conf will be semi-permanent across builds, while changes made to out/conf/server.conf are ephemeral.

For more more detailed instructions, please refer to

Upgrading from 1.0.x

IMPORTANT: the script will completely remove the out directory, which is where blocks are stored. Running this command to upgrade will cause your node to re-sync from scratch. To upgrade, checkout v1.1.0 and run ./scripts/ Restart your node via ./scripts/ and ./scripts/rpc/

Running the Node as a Service/Daemon

The ./scripts/ script will run the node in the current shell, which will exit upon logout. To run the Node as a detatched process, you can start the run-node script via nohup, like so: touch logs/node.log && nohup ./scripts/ >> logs/node.log & tail -f logs/node.log With this command you should be able to stop watching the logs with ctrl-c and may logout without the node quitting.

Alternatively, you can install the daemon scripts located in daemons directory. Currently, Bitcoin Verde comes with init.d and systemd versions of these scripts. Installing them is dependent on your OS, and is out of scope of this README, but there are plenty of guides online for installing systemd or init.d processes.


Any contributions are welcomed and will be reviewed via pull-requests. In order to be accepted, care must be taken for all immutable classes and their mutable counterparts. Additionally, PR resolving bugs preferrably be accepted along with a test proving their existence and fix.


Feel free to contact Software Verde, LLC at any appropriate email address. Generic enquiries may be directed to [email protected]

Running on macOS Catalina

If the embedded database fails to start due to being unable to find the SSL lib, consider executing the following commands and trying again:

sudo ln -s /usr/lib/libssl.dylib /usr/local/opt/openssl/lib/libssl.1.0.0.dylib
sudo ln -s /usr/lib/libcrypto.dylib /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib