Bitcoin.Core.Regtest

Run an ephemeral regtest node

data NodeHandle

Data needed to connect to a bitcoind-regtest ephemeral node

Constructors

NodeHandle

Fields

• nodePort :: Int
• nodeAuth :: BasicAuthData

runBitcoind :: Manager -> NodeHandle -> BitcoindClient r -> IO (Either BitcoindException r)

Run an RPC computation with an ephemeral node

withBitcoind

Arguments

:: Int

node port

-> (NodeHandle -> IO r)

-> IO r

Provide bracketed access to a fresh ephemeral node

Funding

oneBitcoin :: Word64

createOutput

Arguments

:: Address

address for the newly created output

-> Word64

target amount

-> BitcoindClient (OutPoint, Word64)

Funds an output with the minimum of the given amount and 100 blocks of subsidies

generate :: BitcoindClient (OutPoint, Word64)

A simplified block generator which does not require the tester to manage a wallet. Use spendPackageOutputs to spend.

spendPackageOutputs

Arguments

:: [(OutPoint, Word64)]

outputs produced by generate

-> Address

recipient address

-> Word64

amount to spend

-> Either String (Tx, Word64)

Spend outputs created by generate

Internal wallet

In the following lists, entries correspond to each other e.g. the p2pkh address for keys !! 1 is addrs !! 1.

xprv :: XPrvKey

Root key for the package wallet

keys :: [SecKey]

Example secret keys

pubKeys :: [PubKeyI]

Example public keys

addrs :: [Address]

Example p2pkh addresses

textAddrs :: [Text]

Text versions of the example addresses