15.7. depolymerizer-bitcoin(1)#
15.7.1. Name#
depolymerizer-bitcoin - Bitcoin depolymerizer.
15.7.2. Synopsis#
depolymerizer-bitcoin [-h | –help] [–version] COMMAND [ARGS…]
Subcommands: dbinit, setup, serve, worker, config
15.7.3. Description#
depolymerizer-bitcoin is a Taler depolymerizer for the Bitcoin blockhain.
Its options are as follows:
- -h | –help
Print short help on options.
- –version
Print version information.
The interaction model is as follows:
Configure the database with commands
dbinit
.Setup node access with commands
setup
. Setting the access means checking node RPC access and validating worker config.After a successful setup, the subcommands
worker
can be run to both send payments and sync the wallet transactionhistory.Start the HTTP server with command
serve
. Let this run in a shell, writing logs to stderr.
The following sections describe each command in detail.
15.7.3.1. dbinit#
This command defines the database schema for depolymerizer-bitcoin. It is mandatory to run this command before invoking the setup
or serve
commands.
Its options are as follows:
- -c | –config config_file
Specifies the configuration file.
- -L | –log LOGLEVEL
Configure logging to use LOGLEVEL.
- -r | –reset
Reset database (DANGEROUS: All existing data is lost)
- -h | –help
Print short help on options.
15.7.3.2. setup#
This command setup a working node connection. This command check RPC access and validate worker config.
It is mandatory to run this command before invoking the worker
command.
Its options are as follows:
- -c | –config config_file
Specifies the configuration file.
- -L | –log LOGLEVEL
Configure logging to use LOGLEVEL.
- -r | –reset
Reset sync state to the blockhain genesis.
- -h | –help
Print short help on options.
15.7.3.3. worker#
This subcommand sync the wallet history, submit transaction and bump stuck transactions. Incoming payments with an invalid Taler subject are bounced.
Its options are as follows:
- -c | –config config_file
Specifies the configuration file.
- -L | –log LOGLEVEL
Configure logging to use LOGLEVEL.
- –transient
Execute once and return.
- -h | –help
Print short help on options.
15.7.3.4. serve#
This command starts the HTTP server.
Its options are as follows:
- -c | –config config_file
Specifies the configuration file.
- -L | –log LOGLEVEL
Configure logging to use LOGLEVEL.
- –check
Check whether an API is in use (if it’s useful to start the HTTP server). Exit with 0 if at least one API is enabled, otherwise 1.
- -h | –help
Print short help on options.
15.7.3.5. config#
This command inspect or change the configuration.
- -h | –help
Print short help on options.
Subcommands: get, dump, pathsub
15.7.3.5.1. config get#
This command lookup config value.
It takes two arguments, the section name and the option name
- -c | –config config_file
Specifies the configuration file.
- -L | –log LOGLEVEL
Configure logging to use LOGLEVEL.
- -f | –filename
Interpret value as path with dollar-expansion.
- -h | –help
Print short help on options.
15.7.3.5.2. config dump#
This command dump the configuration.
- -c | –config config_file
Specifies the configuration file.
- -L | –log LOGLEVEL
Configure logging to use LOGLEVEL.
- -h | –help
Print short help on options.
15.7.3.5.3. config pathsub#
This command substitute variables in a path.
It takes one argument, a path expression.
- -c | –config config_file
Specifies the configuration file.
- -L | –log LOGLEVEL
Configure logging to use LOGLEVEL.
- -h | –help
Print short help on options.
15.7.4. SEE ALSO#
depolymerizer-bitcoin.conf(5)
15.7.5. Bugs#
Report bugs by using https://bugs.taler.net or by sending electronic mail to <taler@gnu.org>.