BSV SDK

Welcome to the BSV Blockchain Libraries Project, the comprehensive Python SDK designed to provide an updated and unified layer for developing scalable applications on the BSV Blockchain. This SDK addresses the limitations of previous tools by offering a fresh, peer-to-peer approach, adhering to SPV, and ensuring privacy and scalability.

Objective
Getting Started
Features & Deliverables
Documentation
Testing & Quality
Tutorial
Contribution Guidelines
Support & Contacts

Objective

The BSV Blockchain Libraries Project aims to structure and maintain a middleware layer of the BSV Blockchain technology stack. By facilitating the development and maintenance of core libraries, it serves as an essential toolkit for developers looking to build on the BSV Blockchain.

Getting Started

Requirements

Python 3.10 or higher pip package manager

Installation

pip install bsv-sdk

Development Setup

For contributors and developers, install with test and dev dependencies:

pip install -e .[test,dev]

This installs the package in development mode along with all testing and development dependencies.

Basic Usage

import asyncio
from bsv import (
    PrivateKey, P2PKH, Transaction, TransactionInput, TransactionOutput
)


# Replace with your private key (WIF format)
PRIVATE_KEY = 'KyEox4cjFbwR---------VdgvRNQpDv11nBW2Ufak'

# Replace with your source tx which contains UTXO that you want to spend (raw hex format)
SOURCE_TX_HEX = '01000000018128b0286d9c6c7b610239bfd8f6dcaed43726ca57c33aa43341b2f360430f23020000006b483045022100b6a60f7221bf898f48e4a49244e43c99109c7d60e1cd6b1f87da30dce6f8067f02203cac1fb58df3d4bf26ea2aa54e508842cb88cc3b3cec9b644fb34656ff3360b5412102cdc6711a310920d8fefbe8ee73b591142eaa7f8668e6be44b837359bfa3f2cb2ffffffff0201000000000000001976a914dd2898df82e086d729854fc0d35a449f30f3cdcc88acce070000000000001976a914dd2898df82e086d729854fc0d35a449f30f3cdcc88ac00000000'

async def create_and_broadcast_transaction():
    priv_key = PrivateKey(PRIVATE_KEY)
    source_tx = Transaction.from_hex(SOURCE_TX_HEX)

    tx_input = TransactionInput(
        source_transaction=source_tx,
        source_txid=source_tx.txid(),
        source_output_index=1,
        unlocking_script_template=P2PKH().unlock(priv_key),
    )

    tx_output = TransactionOutput(
        locking_script=P2PKH().lock(priv_key.address()),
        change=True
    )

    tx = Transaction([tx_input], [tx_output], version=1)

    tx.fee()
    tx.sign()

    await tx.broadcast()

    print(f"Transaction ID: {tx.txid()}")
    print(f"Raw hex: {tx.hex()}")

if __name__ == "__main__":
    asyncio.run(create_and_broadcast_transaction())

For a more detailed tutorial and advanced examples, check our Documentation.

Features & Deliverables

Advanced Transaction Building:

Support for P2PKH, P2PK, OP_RETURN, and BareMultisig scripts
Automated fee calculation and change output management
Custom script development
Support for various SIGHASH types

HD Wallet Capabilities:

Full BIP32/39/44 implementation for hierarchical deterministic wallets
Multiple language support for mnemonic phrases (English, Chinese)
Advanced key derivation and management

SPV & Validation:

Built-in SPV verification with BEEF format support
Merkle proof validation
Efficient transaction broadcast with Arc
Support for chain tracking and verification

Wallet Infrastructure:

Complete wallet implementation with BIP270 payment protocols
Action serializers for creating, signing, and broadcasting transactions
Substrate support for various wallet backends (HTTP, Wire protocol)
Key derivation with caching for performance

Authentication & Security:

Peer-to-peer authentication with certificate management
Session handling with automatic renewal
Multiple transport protocols (HTTP, simplified transports)
Encrypted communications with AES-GCM

Script Interpreter:

Full Bitcoin script execution engine
Comprehensive opcode support (arithmetic, crypto, stack operations)
Configurable script flags for different validation modes
Thread-based execution for complex scripts

Storage & Overlay Services:

Upload/download interfaces with encryption support
Overlay network tools (SHIP broadcaster, lookup resolver)
Historian for tracking overlay data
Host reputation tracking
Registry client for overlay management

Identity & Registry:

Identity client with certificate management
Contacts manager for identity relationships
Registry services for overlay network coordination
Headers client for blockchain synchronization

Enhanced Cryptography & Protocols:

Schnorr signatures for advanced signing schemes
DRBG (Deterministic Random Bit Generator)
BSM (Bitcoin Signed Message) compatibility
ECIES encryption compatibility
TOTP (Time-based One-Time Password) 2FA support
BIP-276 payment destination encoding
PushDrop token protocol implementation
Teranode broadcaster support

Documentation

Detailed documentation of the SDK with code examples can be found at BSV Skills Center.

Dynamic fee models

You can also refer to the User Test Report for insights and feedback provided by Yenpoint.

Testing & Quality

This project maintains high code quality standards with comprehensive test coverage:

5,400+ tests covering core functionality
84.6%+ code coverage across the entire codebase
Automated testing with GitHub Actions CI/CD
Python 3.10, 3.11, 3.12, and 3.13 supported

Running Tests & Coverage

# Install test dependencies
pip install -e .[test]

# Run all tests
pytest

# Run tests with coverage analysis (includes branch coverage)
pytest --cov=bsv --cov-branch --cov-report=html --cov-report=term

# View detailed coverage report
xdg-open htmlcov/index.html

We welcome contributions that improve test coverage, especially in currently under-tested areas.

Chronicle Live Tests

The SDK includes a comprehensive live test suite for the Chronicle network upgrade, located in tests/bsv/live/. These tests validate real transaction building, signing, script execution, and broadcasting across all sighash flag combinations and script types.

Mock Tests (no network required)

250 tests that build real Transaction objects, sign them with real keys, and validate every input through the Spend script interpreter — without touching the network:

# Run all mock live tests
pytest tests/bsv/live/ -v -m "not testnet"

Test File	Tests	Coverage
`test_live_sighash_matrix.py`	102	All 12 sighash flags x 2 tx versions x P2PKH/P2PK/Multisig
`test_live_chronicle_opcodes.py`	43	10 restored opcodes (OP_VER, OP_VERIF, OP_2MUL, OP_SUBSTR, etc.) x BIP143 + OTDA
`test_live_standard_opcodes.py`	93	Stack, arithmetic, bitwise, crypto, flow control opcodes
`test_live_malleability.py`	12	6 malleability restrictions x v1-rejects/v2-relaxes pairs

Testnet Broadcast Tests (requires funded key)

98 tests that broadcast real transactions to BSV testnet via ARC, verifying end-to-end correctness:

# Set funded testnet private key
export FUNDED_TESTNET_WIF="cYourTestnetWifHere"

# Run testnet broadcast tests
pytest tests/bsv/live/test_live_testnet.py -v

Mainnet broadcast tests (optional, real funds)

Same structure as testnet, but uses mainnet APIs and .utxo_pool_mainnet.json. Costs real BSV; use a dedicated key.

export FUNDED_MAINNET_WIF="YourMainnetWifHere"
pytest tests/bsv/live/test_live_mainnet.py -v -m mainnet

How it works:

UTXO Fan-out: A single funded UTXO is split into ~130 small outputs via a fan-out transaction
Two-step transactions: For non-P2PKH scripts (P2PK, Multisig, custom opcodes), a setup tx converts the P2PKH UTXO into the test script type, then a second tx spends it with the target sighash
Spend pre-validation: Every test tx is validated through the Spend interpreter before broadcasting
UTXO persistence: The UTXO pool is saved to .utxo_pool.json between test runs. Failed broadcasts automatically return UTXOs to the pool
ARC headers: Uses X-SkipScriptValidation header to bypass ARC's script validator (which may lag behind the node's Chronicle support)

Test Class	Tests	Coverage
`TestTestnetP2PKH`	24	P2PKH x 12 sighash flags x 2 tx versions
`TestTestnetP2PK`	24	P2PK x 12 sighash flags x 2 tx versions
`TestTestnetMultisig`	24	2-of-3 BareMultisig x 12 sighash flags x 2 tx versions
`TestTestnetChronicleOpcodes`	20	10 Chronicle opcodes x BIP143 + OTDA paths
`TestTestnetStandardOpcodes`	7	ADD, SUB, MUL, CAT, HASH160, IF/ELSE, CHECKSIGVERIFY

Sighash flags tested (all 12):

Flag	Value	Algorithm
`ALL_FORKID`	0x41	BIP143
`NONE_FORKID`	0x42	BIP143
`SINGLE_FORKID`	0x43	BIP143
`ALL_ANYONECANPAY_FORKID`	0xC1	BIP143
`NONE_ANYONECANPAY_FORKID`	0xC2	BIP143
`SINGLE_ANYONECANPAY_FORKID`	0xC3	BIP143
`ALL_FORKID_CHRONICLE`	0x61	OTDA
`NONE_FORKID_CHRONICLE`	0x62	OTDA
`SINGLE_FORKID_CHRONICLE`	0x63	OTDA
`ALL_ANYONECANPAY_FORKID_CHRONICLE`	0xE1	OTDA
`NONE_ANYONECANPAY_FORKID_CHRONICLE`	0xE2	OTDA
`SINGLE_ANYONECANPAY_FORKID_CHRONICLE`	0xE3	OTDA

Beginner Tutorial

Step-by-Step BSV Tutorial: Sending BSV and NFTs

This beginner-friendly guide will walk you through sending BSV (Bitcoin SV) and creating NFTs using the BSV Python SDK. We'll take it step-by-step so you can learn at your own pace.

Contribution Guidelines

We're always looking for contributors to help us improve the project. Whether it's bug reports, feature requests, or pull requests - all contributions are welcome.

Fork & Clone: Fork this repository and clone it to your local machine.
Set Up: Install in development mode with test dependencies:
```
pip install -e .[test]
```
Make Changes: Create a new branch and make your changes.

Test: Ensure all tests pass and check code coverage:

# Run tests with coverage report
pytest --cov=bsv --cov-report=html --cov-report=term

# View detailed HTML coverage report
open htmlcov/index.html  # or xdg-open htmlcov/index.html on Linux

Help us improve coverage by adding tests for uncovered areas!

Commit: Commit your changes and push to your fork.
Pull Request: Open a pull request from your fork to this repository.

For more details, check the contribution guidelines.

Support & Contacts

Project Owners: Thomas Giacomo and Darren Kellenschwiler Development Team Lead: sCrypt Maintainer: Ken Sato @ Yenpoint inc. & Yosuke Sato @ Yenpoint inc. For questions, bug reports, or feature requests, please open an issue on GitHub or contact us directly.

License

The license for the code in this repository is the Open BSV License. Refer to LICENSE.txt for the license text.

Thank you for being a part of the BSV Blockchain ecosystem. Let's build the future of BSV Blockchain together!

Intended Audience
- Developers
Operating System
- OS Independent
Programming Language

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bsv_sdk-2.3.3.tar.gz (2.2 MB view details)

Uploaded Jul 22, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

bsv_sdk-2.3.3-cp313-cp313-win_amd64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.13Windows x86-64

bsv_sdk-2.3.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

bsv_sdk-2.3.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

bsv_sdk-2.3.3-cp313-cp313-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.13macOS 11.0+ ARM64

bsv_sdk-2.3.3-cp313-cp313-macosx_10_13_x86_64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.13macOS 10.13+ x86-64

bsv_sdk-2.3.3-cp312-cp312-win_amd64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.12Windows x86-64

bsv_sdk-2.3.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

bsv_sdk-2.3.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

bsv_sdk-2.3.3-cp312-cp312-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.12macOS 11.0+ ARM64

bsv_sdk-2.3.3-cp312-cp312-macosx_10_13_x86_64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.12macOS 10.13+ x86-64

bsv_sdk-2.3.3-cp311-cp311-win_amd64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.11Windows x86-64

bsv_sdk-2.3.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

bsv_sdk-2.3.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

bsv_sdk-2.3.3-cp311-cp311-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.11macOS 11.0+ ARM64

bsv_sdk-2.3.3-cp311-cp311-macosx_10_9_x86_64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.11macOS 10.9+ x86-64

bsv_sdk-2.3.3-cp310-cp310-win_amd64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.10Windows x86-64

bsv_sdk-2.3.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

bsv_sdk-2.3.3-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded Jul 22, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

bsv_sdk-2.3.3-cp310-cp310-macosx_11_0_arm64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.10macOS 11.0+ ARM64

bsv_sdk-2.3.3-cp310-cp310-macosx_10_9_x86_64.whl (1.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.10macOS 10.9+ x86-64

File details

Details for the file bsv_sdk-2.3.3.tar.gz.

File metadata

Download URL: bsv_sdk-2.3.3.tar.gz
Upload date: Jul 22, 2026
Size: 2.2 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for bsv_sdk-2.3.3.tar.gz
Algorithm	Hash digest
SHA256	`e6e7144075f11a71fca206aa0a6792e64002764be71a2f3802e6d41e720a2b05`
MD5	`9f7aeef6832d59a53090f2fc2c7d7331`
BLAKE2b-256	`9a4e56160b43c293a9787a6aba19a67a493ab094a1beb89f502314070e3089fe`

Algorithm	Hash digest
SHA256	`16ccd7052c1c3213ede0754e9eb2d47afa32d8bf4a4428201494e07af567caaf`
MD5	`56d4e845dd71f3bc3d07ce343744a471`
BLAKE2b-256	`825cb632fe7fd40f40876cb4d411b594f9f41259e252fe36f99a13e06927c794`

Algorithm	Hash digest
SHA256	`799e4a8bea9e36806b989b64631835919490f2a8c22323a6937796b99dd2983a`
MD5	`36ff32dbbeb478b990b58b3ef879bd2e`
BLAKE2b-256	`ebedce6003682c028e96776fab111c0fea3fe257c1fc8e41f44c02f60ac7b728`

Algorithm	Hash digest
SHA256	`e5937e2e6f32674aca24461f5439edd12c9e862ae83374db53740839e13717a1`
MD5	`78bb891a54c281dfbbd1387e67bc0882`
BLAKE2b-256	`4b0ea90a13f8dec337af3bf6acc8d150e319870a24ae8f1f6b87eef56327327c`

Algorithm	Hash digest
SHA256	`6cb3491fb63c3c546c3cdb6a74ed8e18e4c069eec020d40a3280f6f3ac3ffeec`
MD5	`c320e4097ce9da5e5267a970cca81515`
BLAKE2b-256	`92de699d23de41fade08e54b8974de1836dabc35ca2915509f73f822afc59e20`

Algorithm	Hash digest
SHA256	`bb1dfd7f798454e56f113ca7a623ee4c5a1e9d21dff84c02882c14179c37dbfb`
MD5	`2d07f9150185d9c9bd1cbadf416c2cdf`
BLAKE2b-256	`7c043a34b65fca930901eb3d99196ba9f9b53153b077e60d1da21c1c7396cd0c`

Algorithm	Hash digest
SHA256	`fba59491f276602c85f4954e578194f41549c1175b4bb061060ddf3b68f996e9`
MD5	`e6be53c516ed994d04677a7ca10ef3e8`
BLAKE2b-256	`d28f331723f4ad98c8d3ac9b5dcae4938bf3daeb09431b38ce59664325b61984`

Algorithm	Hash digest
SHA256	`a0f38917574b5eb9f09f4bf98a909da450ca001e06cf4f414bc2c689311373c2`
MD5	`2042ac0b206709202ecf2ae266a40714`
BLAKE2b-256	`ad37bea253662b6d3293fd4c3d5787fbc96fe460c0f47581e837d7d817fab8b2`

Algorithm	Hash digest
SHA256	`fcef71ffb5ec9bb995dd757515746f7c297afd2b39a02ff1b060676d6a96bff4`
MD5	`5bdec37bb455de4c4bdb5c83d033d6a8`
BLAKE2b-256	`009326995bcbe6252bb1f86cf15516a3b1d5cc01817f5765abcd2460931c7d42`

Algorithm	Hash digest
SHA256	`7903d01bc8a0725a1d6edbdbbbda7f4925da2df2a6d9f79eaca02b9dcb3e4390`
MD5	`fe0f42697728cc8d170da6023befa7cd`
BLAKE2b-256	`dbed36249a2e0e738a04487fc96cce40a854bd13364c2517329310e9c5d7a827`

Algorithm	Hash digest
SHA256	`6b524a85a7b034e9d5f8009352b11cd861b25daf64d185424bc1132009a7967d`
MD5	`d9e5c52feca77cfb541816071f66d0c6`
BLAKE2b-256	`fa95a92dafb8d361f6fe0e838886d17b54e72130ddf7e46f5436a51eb8d09f1a`

Algorithm	Hash digest
SHA256	`e9ce8866b9c4b71d7f1a0f6163b2ef286a9a5aad04076f25d592cbe48997c9a8`
MD5	`6abecc0e8e780cfb4d34925bdac8d26b`
BLAKE2b-256	`6a565e40b32eeb578285edf086434af7ba552f4aa84b6ed299b088f271f8b8fd`

Algorithm	Hash digest
SHA256	`f2652bec045261335b1b6df03082bc12df40179582d7d75a4c333199b7edd636`
MD5	`48b0d92be50c87d84c555a62b865ba72`
BLAKE2b-256	`84cd18d5173d3a03a0d336b5c143700a65127b02e06106f189b3c95459b67f15`

Algorithm	Hash digest
SHA256	`3b5919b44c10b79e7f7f86f6e4b293627a3b7e36d958fdbdab4427653be82f3f`
MD5	`87a33b5764e887dee0e1e856c2392818`
BLAKE2b-256	`e59ff2a106eefd5fd26a11202f79358ec78fdb1293745df569d5a008fd35f9fe`

Algorithm	Hash digest
SHA256	`8408dfdd4b934305c6b5358cfb9abf420a66dc3ab56173d47d0ed508b7df3fa5`
MD5	`c98dce4863fe7c8e8ab74561d1ed9998`
BLAKE2b-256	`c7e85f9115037e84f2014b63843ce06ac97c2a50ec484ef4e8bd048699544d36`

Algorithm	Hash digest
SHA256	`eb5eb9676aaed2cb0d973f4c1ffe1ee731a147626c135df61de56ed2ac7689e4`
MD5	`47ef0b24ea5472ec1bf0d63672e2e621`
BLAKE2b-256	`6917cbc0e89b41a7a85a6e841e79c14da5917213942a592a714df9165d0a3caf`

Algorithm	Hash digest
SHA256	`8381014202fde548a117747507339162fd1f405d818d086d5edc2ddd97eb3f43`
MD5	`7441810e776579a5f110e17cd0c7d097`
BLAKE2b-256	`af6149d8f6839d56de1bbb65a78243d28bd400e02455e6b734ab309cbda8597d`

Algorithm	Hash digest
SHA256	`cec62e084b6e3985cde0158c457f61560abf55b75ced9cec50cecc59fc507dfc`
MD5	`3f7192b97fc2b491c2e3909c0570fdb7`
BLAKE2b-256	`2ba5af1a81aa1a4444072498a56cfc75d2cd9740c838fe44727748fe19b06d4c`

Algorithm	Hash digest
SHA256	`06a03c9b03a66924a743819c8cef3ce102690c14f8d75a36dc33d47c3f65b8ea`
MD5	`e03b667224b96664d1689bdfb3e1d0f3`
BLAKE2b-256	`288b90e695b41f173ea0fef4da3a2ae70a08023386aad0cf018d2180bc32debc`

Algorithm	Hash digest
SHA256	`89759fc0c58473264f120898535f16c11b84b2bd7c62b023e079938a7233b008`
MD5	`b7c7954078d28b8fbfe25e9734ab1069`
BLAKE2b-256	`88981135c07995a06a37b0ee4f107b8e5d6ddb5f2a64fe2125e4f8af3d9cd2c3`

Algorithm	Hash digest
SHA256	`de93956975adddd9f8a80018ee8e526e390c62a50204fa08530eeee016197976`
MD5	`7e3002827a60dc7895d40416c0e3056c`
BLAKE2b-256	`594c41ed119c4bb2b6fded44460e7eb571417ca186e3e6f69b7c4bdf782971aa`

bsv-sdk 2.3.3

BSV SDK

Table of Contents

Objective

Getting Started

Requirements

Installation

Development Setup

Basic Usage

Features & Deliverables

Advanced Transaction Building:

HD Wallet Capabilities:

SPV & Validation:

Wallet Infrastructure:

Authentication & Security:

Script Interpreter:

Storage & Overlay Services:

Identity & Registry:

Enhanced Cryptography & Protocols:

Documentation

Testing & Quality

Running Tests & Coverage

Chronicle Live Tests

Mock Tests (no network required)

Testnet Broadcast Tests (requires funded key)

Mainnet broadcast tests (optional, real funds)

Beginner Tutorial

Step-by-Step BSV Tutorial: Sending BSV and NFTs

Contribution Guidelines

Support & Contacts

License

Project links

Key dates

5 maintainers

Credits

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details