dcrdtest

Package dcrdtest provides a dcrd-specific RPC testing harness crafting and executing integration tests by driving a dcrd instance via the RPC interface. Each instance of an active harness comes equipped with a simple in-memory HD wallet capable of properly syncing to the generated chain, creating new addresses, and crafting fully signed transactions paying to an arbitrary set of outputs.

This package was designed specifically to act as an RPC testing harness for dcrd. However, the constructs presented are general enough to be adapted to any project wishing to programmatically drive a dcrd instance of its systems/integration tests.

Installation and Updating

$ go get github.com/decred/dcrtest/dcrdtest@latest

Choice of dcrd Binary

This library requires a dcrd binary to be available for running and driving its operations. The specific binary that is used can be selected in two ways:

Manually

Using the package-level SetPathToDCRD() function, users of dcrdtest can specify a path to a pre-existing binary. This binary must exist and have executable permissions for the current user.

Automatically

When a path to an existing dcrd binary is not defined via SetPathToDCRD(), then this package will attempt to build one in a temporary directory. This requires the Go toolchain to be available for the current user.

The version of the dcrd binary that will be built will be chosen following the rules for the standard Go toolchain module version determination:

The version or replacement specified in the currently active Go Workspace.
The version or replacement specified in the main module (i.e. in the go.mod of the project that imports this package).
The version specified in the go.mod of this package.

License