Struct TestConfig 

pub struct TestConfig {
    pub rpc_port: u16,
    pub rpc_username: String,
    pub rpc_password: String,
    pub network: Network,
    pub extra_args: Vec<String>,
}

TestConfig represents the configuration needed to run a Bitcoin node in a test environment. This struct is the single source of truth for test‑node settings: RPC port, username, and password. Defaults are:

• rpc_port = 0 (auto‑select a free port)
• rpc_username = "rpcuser"
• rpc_password = "rpcpassword"
• network = Network::Regtest (for isolation and testability)

To override any of these, simply modify fields on TestConfig::default() (or assign directly in code). If you prefer not to recompile for every change, consider using TestConfig::from_env() to read overrides from environment variables.

Examples

let mut cfg = TestConfig::default();
cfg.rpc_port = 18545;
cfg.rpc_username = "alice".into();
cfg.network = Network::Testnet;

Environment Overrides

Reads RPC_PORT, RPC_USER, RPC_PASS, and RPC_NETWORK environment variables to override defaults.

Fields

rpc_port: u16

The port number for RPC communication with the Bitcoin node. A value of 0 indicates that an available port should be automatically selected.

rpc_username: String

The username for RPC authentication. Can be customized to match your bitcoin.conf rpcuser setting.

rpc_password: String

The password for RPC authentication. Can be customized to match your bitcoin.conf rpcpassword setting.

network: Network

Which Bitcoin network to run against.

extra_args: Vec<String>

Extra command-line arguments to pass to bitcoind

Implementations

impl TestConfig

pub fn as_chain_str(&self) -> &'static str

Return the value used with -chain=<value> for the configured network

pub fn network_from_str(s: &str) -> Option<Network>

Parse network from common strings (case-insensitive). Accepts: regtest, testnet|test, signet, mainnet|main|bitcoin, testnet4.

pub fn from_env() -> Self

Create a TestConfig, overriding defaults with environment variables:

• RPC_PORT: overrides rpc_port
• RPC_USER: overrides rpc_username
• RPC_PASS: overrides rpc_password
• RPC_NETWORK: one of regtest, testnet|test, signet, mainnet|main|bitcoin, testnet4

pub fn into_config(self) -> Config

Convert this test configuration into a full Config instance

pub fn from_config(config: &Config) -> Self

Create a TestConfig from a full Config instance

Trait Implementations

impl Clone for TestConfig

fn clone(&self) -> TestConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TestConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TestConfig

fn default() -> Self

Returns the “default value” for a type.