10.1. Bitcoin Depolymerizer Setup Manual

depolymerizer-bitcoin is a bitcoin blockhain Taler adapter.

In this manual, we explain how to setup an adapter.

10.1.1. Installing Bitcoin Depolymerizer

10.1.1.1. Building from source

Bitcoin Depolymerizer belongs to the Depolymerization project, and can be downloaded via Git:

$ git clone git://git.taler.net/depolymerization

You will need the latest version of the rust stable toolchain:

$ sudo apt install rustup
$ rustup toolchain install stable

Navigate into the depolymerization local repository, and from top-level run:

$ ./bootstrap
$ ./configure --prefix=$PREFIX
$ make install

If the previous steps succeeded, the depolymerizer-bitcoin command should be found in the $PATH.

10.1.2. Database setup

The configuration file must include a connection string that tells Bitcoin Depolymerizer how it should connect to the database. The default is:

[depolymerizer-bitcoindb-postgres]
config = postgres:///depolymerizer-bitcoin

You must make sure that this database exists and is accessible to the user running Bitcoin Depolymerizer before continuing. Then, the Bitcoin Depolymerizer database schema must be created (or updated) to the current Bitcoin Depolymerizer version using the following command:

$ depolymerizer-bitcoin-dbinit -c "$CONFIG_FILE"

where $CONFIG_FILE is again the path to a configuration that contains at least the above [depolymerizer-bitcoindb-postgres] section.

10.1.3. Setting up a local bitcoin node

Note that bitcoind & bitcoin-cli should already be in $PATH.

TODO