dcrd/contrib
Josh Rickmar 8525c7d98d contrib: Use bash builtins instead of seq.
seq is not portable (for example, the command is not provided by
OpenBSD and would need to be installed as a package).

Since the script already assumes bash, use the numeric builtins to
iterate NUM times instead of using seq.
2022-01-11 21:36:18 +00:00
..
docker build/contrib: Improve docker support. 2021-09-18 13:17:41 -05:00
services contrib: Update OpenBSD rc script for 6.9 features. 2021-05-05 12:43:55 -05:00
dcr_tmux_simnet_setup.sh contrib: Use bash builtins instead of seq. 2022-01-11 21:36:18 +00:00
README.md build/contrib: Improve docker support. 2021-09-18 13:17:41 -05:00

contrib

Overview

This consists of extra optional tools which may be useful when working with dcrd and related software.

Contents

Example Service Configurations

  • OpenBSD rc.d
    Provides an example rc.d script for configuring dcrd as a background service on OpenBSD. It also serves as a good starting point for other operating systems that use the rc.d system for service management.

  • Service Management Facility
    Provides an example XML file for configuring dcrd as a background service on illumos. It also serves as a good starting point for other operating systems that use use SMF for service management.

  • systemd
    Provides an example service file for configuring dcrd as a background service on operating systems that use systemd for service management.

Simulation Network (--simnet) Preconfigured Environment Setup Script

The dcr_tmux_simnet_setup.sh script provides a preconfigured simnet environment which facilitates testing with a private test network where the developer has full control since the difficulty levels are low enough to generate blocks on demand and the developer owns all of the tickets and votes on the private network.

The environment will be housed in the $HOME/dcrdsimnetnodes directory by default. This can be overridden with the DCR_SIMNET_ROOT environment variable if desired.

See the full Simulation Network Reference for more details.

Building and Running OCI Containers (aka Docker/Podman)

The project does not officially provide container images. However, all of the necessary files to build your own lightweight non-root container image based on scratch from the latest source code are available in the docker directory. See docker/README.md for more details.