verystable

(Because it's not very stable.)

This project contains a number of useful Python bindings for interaction with bitcoin.

Eventually it will contain a gallery of examples for doing useful things like interacting with the P2P network and building interesting scripts.

[!WARNING] This project is not maintained with use of real (mainnet) funds in mind. The bulk of the code comes from a test framework that is intended for use with regtest only. You might lose money using this!

Notably, this project copies the Bitcoin Core functional test framework in its entirety for use, which contains a number of helpful utilities.

This gives us good utilities for interacting with the P2P layer (p2p.P2PInterface) as well as handling process-level bitcoind invocation (test_node.TestNode).

This module could help with a variety of tasks:

• building a local relay which adapts the user's choice of protocol to bitcoin P2P messages,
• monitoring via the P2P network,
• programmatic management of bitcoind instances,
• general utilities related to bitcoin,
• and more.

Installation

$ git clone https://github.com/jamesob/verystable.git
$ cd verystable
$ pip install -e .

# The bitcoincore module is then importable.
$ python
>>> import verystable
>>> verystable.core.p2p.MAGIC_BYTES
{'mainnet': b'\xf9\xbe\xb4\xd9',
 'testnet3': b'\x0b\x11\t\x07',
 'regtest': b'\xfa\xbf\xb5\xda',
 'signet': b'\n\x03\xcf@'}

Examples

Examples are contained in examples/.

Pulling from upstream

To update the imported Bitcoin Core functional test framework code,

• run ./pull-from-upstream.sh <bitcoin-core-repo-path>
• examine/commit the diff
• bump the pyproject.toml version number if needed