Python Bitcoin Library
The Python BitcoinLib is a library that provides developers with a wide range of tools to work with Bitcoin.
- With BitcoinLib you can:
Create and manage wallets
Use various key-structures for your wallet such as HD (Hierarchical Deterministic) wallets following the BIP32 standard
Interact with the Blockchain, retrieve and decode blockchain data
Build, sign and verify transactions and signatures. This could be a standard segwit transactions but also multisig, nulldata or custom made transactions
Create, analyse and run Bitcoin scripts
Generate Bitcoin addresses and represent them in different address formats like P2PKH, P2SH, Bech32, etc
Create private keys and work with Mnemonic password phrases
Use external Service providers to fetch address, transaction, utxo and blockchain data.
Connect to you local Bitcoin core, Bcoin, Blockbook or ElectrumX node.
Can be extended to support other cryptocurrencies by configuring custom parameters.
At the moment Litecoin, Dogecoin and various test networks are supported out-of-the-box.
Install
Install required packages on Ubuntu or related Linux systems:
$ sudo apt install build-essential python3-dev libgmp3-devThen install using pip
$ pip install bitcoinlibCheck out the more detailed installation instructions to read how to install on other systems or for troubleshooting.
If you are using docker you can check some Dockerfiles to create images in the docker directory.
Documentation
Read the full documentation at: http://bitcoinlib.readthedocs.io/
Example
The bitcoin library contains a wallet implementation using SQLite3 or SQLAlchemy to import, create and manage keys in a Hierarchical Deterministic way.
Example: Create wallet and generate new address (key) to receive bitcoins
>>> from bitcoinlib.wallets import Wallet
>>> w = Wallet.create('Wallet1')
>>> w.get_key().address
'bc1qk25wwkvz3am9smmm3372xct5s7cwf0hmnq8szj'Now send a small transaction to your wallet and use the scan() method to update transactions and UTXO’s
>>> w.scan()
>>> w.info() # Shows wallet information, keys, transactions and UTXO'sWhen your wallet received a payment and has unspent transaction outputs, you can send bitcoins easily. If successful a transaction ID is returned
>>> t = w.send_to('bc1qemtr8ywkzg483g8m34ukz2l4pl3730776vzq54', '0.001 BTC', offline=False)
'b7feea5e7c79d4f6f343b5ca28fa2a1fcacfe9a2b7f44f3d2fd8d6c2d82c4078'
>>> t.info # Shows transaction information and send resultsMore Examples and Use Cases
You can find many more examples in the documentation for instance about the Wallet.create() method.
There are many working examples on how to create wallets, specific transactions, encrypted databases, parse the blockchain, connect to specific service providers in the examples directory in the source code of this library.
BitcoinLib is used at Blocksmurfer Explorer and many other repositories: https://github.com/1200wd/bitcoinlib/network/dependents
Contact
If you have any questions, encounter a problem or want to share an idea, please use Github Discussions
Implements the following Bitcoin Improvement Proposals
Hierarchical Deterministic Wallets (BIP0032)
Passphrase-protected private key (BIP0038)
Mnemonic code for generating deterministic keys (BIP0039)
Purpose Field for Deterministic Wallets (BIP0043)
Multi-Account Hierarchy for Deterministic Wallets (BIP0044)
Structure for Deterministic P2SH Multisignature Wallets (BIP0045)
Bech32/base32 address format for native v0-16 witness outputs (BIP0173)
Native and P2SH nested Segregated Witness transactions (BIP0141 and BIP0143)
Bech32m format for v1+ witness addresses (BIP0350)
and many more…
Future / Roadmap
Fully support timelocks
Support Taproot and Schnorr signatures
Support advanced scripts
Support for Trezor wallet or other hardware wallets
Allow to scan full blockchain
Integrate simple SPV client
Disclaimer
This library is still in development, please use at your own risk and test sufficiently before using it in a production environment.
1 maintainer
Metadata
1 maintainer
Release files for bitcoinlib 0.7.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bitcoinlib-0.7.10.tar.gz | 4.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bitcoinlib-0.7.10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.6 MB
Release files / bitcoinlib-0.7.10.tar.gz
| Download URL | bitcoinlib-0.7.10.tar.gz |
|---|---|
| Size | 4.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
57f689d567c2d92421bbec19cfdbf8e55492bccae5e932ab0aaf138a1fbe4856
|
|
BLAKE2b-256 checksum How to use checksums |
18dcc65c552f37f22a9fa0943566508e80292ca31762c9923502347703f80035
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / bitcoinlib-0.7.10-py3-none-any.whl
| Download URL | bitcoinlib-0.7.10-py3-none-any.whl |
|---|---|
| Size | 4.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f24029d473e9d26350a160d86d5543f7c440614a1e98e21480716942e6150b5d
|
|
BLAKE2b-256 checksum How to use checksums |
b43c6ceab115fcf6c895ab79948c3ec5bbffc7d52a47f5dc3204eaaa205e7960
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
