Edit on Github

Bitcoin Core with addrindex Patch

Bitcoin Core is used by Counterparty to interact with the Bitcoin blockchain.

Download

Depending on your OS and other preferences, download one of the binaries or source code from the link below. Optionally you can verify the file’s checksum and author’s PGP signature. These binaries are built deterministically.

https://github.com/bitcoin/bitcoin/releases

Installation

Windows Installer

Unlike the Linux binaries, the Windows packages are installers. Uninstall any older version and download and install a 32-bit or 64-bit version. A 32-bit version consumes slightly less memory and is recommended for regular desktop use.

  • 32-bit: C:\Program Files (x86)\Bitcoin
  • 64-bit: C:\Program Files\Bitcoin

bitcoind.exe can be found in the daemon subdirectory. This path can be manually added to the system PATH variable.

Linux Binaries

The Linux binaries are precompiled executables + dependencies, and they’re deployed by decompressing them into the desired location. Once that is done, they can be executed directly like so.

    ./bitcoin-*/bin/bitcoind -help

You may want to do one or more of the following optional steps: * Move the binaries around. * Edit your PATH variable to allow you to execute the binaries (bitcoin-cli, bitcoind, bitcoin-qt) without specifying their path.

Configuration

Your Bitcoin Core configuration file should match this:

rpcuser=bitcoinrpc
rpcpassword=<password>
server=1
daemon=1
rpctimeout=300
txindex=1
addrindex=1
  • Choose a secure password.
  • By default, on Windows, this file is located at %APPDATA%\Bitcoin\bitcoin.conf.
  • By default, on Linux, this file is located at ~/.bitcoin/bitcoin.conf, and the permissions of the file should be set with chmod 600 ~/.bitcoin/bitcoin.conf.

Usage

To run with the standard GUI interface, start Bitcoin Core (./bitcoin-qt on Linux), and to run the daemon, execute bitcoind. A full list of options can be obtained like this: * Bitcoin Core: go to Help > Command-line options or execute ./bitcoin-qt -help * bitcoind: run ./bitcoind --help (bitcoind.exe -help on Windows)

Use bitcoin-cli to interact with Bitcoin Core.

Usage on Testnet

For testnet use, add testnet=1 to a separate copy of the above configuration file or run bitcoind with -testnet from a script or the console. Examples: * ./bitcoind -testnet - start bitcoind on testnet using the default configuration file (blockchain data would be stored in the default data path under testnet3 subdirectory) * bitcoind.exe -testnet -datadir=E:\testing\testnet-blockchain - use the default configuration file, run on testnet, but place blockchain data in the specified data directory * bitcoin-qt.exe -conf=E:\testing\testnet.conf - start Bitcoin Core GUI and service using a custom configuration file (which presumably cointains testnet=1 and other custom options that justify the creation of a testnet-specific configuration file)

To interact with a testnet instance of Bitcoin Core, use bitcoin-cli with the same testnet or conf options that were used to start it.

Leveraging existing blockchain data from a higher Bitcoin Core version

Existing Bitcoin Core users with blockchain data created by a higher version of the official Bitcoin Core may not be able to reuse their blockchain data from a lower version of Bitcoin Core because higher Bitcoin Core releases may have a database (or wallet, if used) format that older Bitcoin Core versions cannot recognize.

This changes from one Bitcoin Core version to another, so please check Bitcoin Core Release Notes for database (and wallet, if applicable) format changes.

In cases where an in-place change is not possible or desired, you can setup a separate Bitcoin Core instance and add adddnode=<IP-address-of-newer-version-on-LAN> to the new instance’s bitcoin.conf.