Package: bitcoin-utils
This is a bitcoin library that provides tools/utilities to interact with the Bitcoin network. One of the primary goals of the library is to explain the low-level details of Bitcoin. The code is easy to read and properly documented explaining in detail all the thorny aspects of the implementation. It is a low-level library which assumes some high-level understanding of how Bitcoin works. In the future this might change.This is an early version of the library (v0.6.5) and currently, it supports private/public keys, all type of addresses and creation of any transaction, incl. segwit and taproot, with all SIGHASH types. All script op codes are included. Extra functionality will be added continuously and the documentation will be improved as the work progresses.The API documentation can be build with Sphinx but is also available as a PDF for convenience. One can currently use the library for experimenting and learning the inner workings of Bitcoin. It is not meant for production yet and parts of the API might be updated with new versions.Complementary to this library is a CC BY-SA 4.0 licensedBitcoin programming book.NotesFor schnorr, bech32[m], ripemd160 the python Bitcoin Core reference implementations are used.For making calls to a Bitcoin node a simple node proxy object exists, which wraps the python-bitcoinrpc library.For Hierarchical Deterministic keys we wrap the python hdwallet library. For now we wrap only some very basic functionality to acquire a PrivateKey object that is used throughtout the library.InstallationPython version 3 is required. Then just install with:$ pip install bitcoin-utilsExamplesKeys and AddressesLegacy Keys and Addresseshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/keys_addresses.py- creates a private key which we use to derive a public key and in turn an address. We also use the private key to sign a message and then verify it using the public key.Segwit Addresseshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/keys_segwit_addresses.py- creates P2WPKH, P2SH-P2WPKH, P2WSH and P2SH-P2WSH addresses.Hierarchical Deterministic Keyshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/hd_keys.py- creates an extended private key, from an xpriv/tpriv and path, which we use to derive a public key and in turn all different address (legacy, segwit v0 and taproot (segwit v1).Legacy Transactions (P2PKH, P2SH)Transaction with P2PKH input and outputshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/p2pkh_transaction.py- creates a simple transaction with one input and two outputs.Create a P2PKH Transaction with different SIGHASHeshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/multi_input_sighash_transaction.py- creates a 2-input 2-output transaction with different signature types.Create a P2SH Addresshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/send_to_p2sh_transaction.py- creates a P2SH address that corresponds to a P2PK redeem script and sends some funds to it.Create (spent) a P2SH Transactionhttps://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2sh_transaction.py- creates a transaction that spends a P2SH output.Non-standard TransactionsCreate a non-standard txhttps://github.com/karask/python-bitcoin-utils/blob/master/examples/create_non_std_tx.py- sends funds to an address with a non-standard tx (script: OP_ADD OP_5 OP_EQUAL)Spend a non-standard txhttps://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_non_std_tx.py- spends funds from script OP_ADD OP_5 OP_EQUALSegwit TransactionsTransaction to pay to a P2WPKHhttp://github.com/karask/python-bitcoin-utils/blob/master/examples/send_to_p2wpkh_transaction.py- send coins from two P2PKH UTXOs to a native segwit address (P2WPKH)Spend from a P2SH(P2WPKH) nested segwit addresshttp://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2sh_p2wpkh_address.py- spend a P2WPKH that is nested into a P2SH for old client compatibilityTransaction to pay to a P2SH(P2WSH(P2PK))http://github.com/karask/python-bitcoin-utils/blob/master/examples/send_to_p2sh_p2wsh_p2pk_address.py- send coins from a P2PKH UTXO to a P2SH(P2WSH(P2PK))Spend from a P2SH(P2WPKH) nested segwit addresshttp://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_from_p2sh_p2wsh_p2pk_address.py- spend a P2WSH with a P2PK as witness script that is nested into a P2SH for old client compatibilityTimelock TransactionsCreate a P2SH address with a relative timelockhttps://github.com/karask/python-bitcoin-utils/blob/master/examples/create_p2sh_csv_p2pkh_address.py- creates a P2SH address that locks funds (sent to it) with a private key (P2PKH) and a relative locktime of 200 blocks in the future.Spend from a timelocked addresshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2sh_csv_p2pkh.py- spends from a P2SH(CSV+P2PKH) address as created from above.Taproot (segwit v1) TransactionsSpend from a taproot addresshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2tr_default_path.py- single input, single output default key path spending.Spend a multi input that contains both taproot and legacy UTXOshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_multi_input_p2tr_and_p2pkh.py- three inputs (two taproot and one legacy), single legacy output.Send to taproot address that contains a single script path spendhttps://github.com/karask/python-bitcoin-utils/blob/master/examples/send_to_p2tr_with_single_script.py- single input, single output (key path and single script path).Spend taproot from key path (has single alternative script path spend)https://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2tr_single_script_by_key_path.py- single input, single output, spend key path.Spend taproot from script path (has single alternative script path spend)https://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2tr_single_script_by_script_path.py- single input, single output, spend script path.Send to taproot address that contains two scripts path spendshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/send_to_p2tr_with_two_scripts.py- single input, single output (key path and two script paths - A and B).Spend taproot from script path (has two alternative script path spend - A and B)https://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2tr_two_scripts_by_script_path.py- single input, single output, spend script path A.Send to taproot address that contains three scripts path spendshttps://github.com/karask/python-bitcoin-utils/blob/master/examples/send_to_p2tr_with_three_scripts.py- single input, single output (key path and three script paths - A, B and C).Spend taproot from script path (has three alternative script path spends - A, B and C)https://github.com/karask/python-bitcoin-utils/blob/master/examples/spend_p2tr_three_scripts_by_script_path.py- single input, single output, spend script path B.OtherUse NodeProxy to make calls to a Bitcoin nodehttps://github.com/karask/python-bitcoin-utils/blob/master/examples/node_proxy.py- make Bitcoin command-line interface calls programmatically (NodeProxy wraps jsonrpc-requests library)Please explore the codebase or the API documentation (BitcoinUtilities.pdf) for supported functionality and other options.