Develop port

.env.example

@@ -0,0 +1,8 @@
+# Example environment variables for testing
+# Copy this file to .env.local and fill in your actual values
+
+# ARC Broadcaster API Key
+ARC_API_KEY=your_api_key_here
+
+# WhatsOnChain API Key for wallet tests
+WOC_API_KEY=your_woc_api_key_here

.github/workflows/build.yml

@@ -1,6 +1,6 @@
 name: build
 permissions:
-  contents: read
+  contents: write
 
 on:
   push:
@@ -33,6 +33,25 @@ jobs:
           flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
           # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
           flake8 . --count --exit-zero --max-complexity=10 --max-line-length=140 --statistics
-      - name: Test with pytest
+      - name: Test with pytest and coverage
         run: |
-          pytest
+          pytest --cov=bsv --cov-report=html --cov-report=term --cov-report=xml
+      - name: Extract coverage percentage
+        if: matrix.python-version == '3.11'
+        id: coverage
+        run: |
+          COVERAGE=$(python -c "import xml.etree.ElementTree as ET; root = ET.parse('coverage.xml').getroot(); print(f\"{float(root.attrib['line-rate'])*100:.1f}\")")
+          echo "coverage_percentage=$COVERAGE" >> $GITHUB_OUTPUT
+      - name: Update README with coverage
+        if: matrix.python-version == '3.11' && github.ref == 'refs/heads/master' && github.event_name == 'push'
+        run: |
+          python update_coverage.py ${{ steps.coverage.outputs.coverage_percentage }}
+      - name: Commit coverage update
+        if: matrix.python-version == '3.11' && github.ref == 'refs/heads/master' && github.event_name == 'push'
+        # Pin to specific commit SHA for security - v9.1.4
+        uses: EndBug/add-and-commit@777a761e0f8293b7b051170404976d7cf10611cb  # v9.1.4
+        with:
+          add: README.md
+          message: "Update coverage badge to ${{ steps.coverage.outputs.coverage_percentage }}%"
+          author_name: github-actions[bot]
+          author_email: github-actions[bot]@users.noreply.github.com

.gitignore

@@ -8,4 +8,10 @@ dist/
 htmlcov/
 .coverage
 build/
-.venv/
+.wallet
+.venv/
+
+# Environment files
+.env
+.env.local
+.env.*.local

CHANGELOG.md

@@ -26,25 +26,38 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - [0.1.0 - 2024-04-09](#010---2024-04-09)
 
 ---
-## [Unreleased]
+## [1.0.12] - 2025-11-25
 
 ### Added
-- (Include new features or significant user-visible enhancements here.)
+- Complete Wallet infrastructure with serializers, substrates, and implementations for full wallet functionality
+- Authentication system including peer authentication, certificates, session management, and HTTP transport
+- Enhanced BEEF infrastructure with dedicated builder, serializer, and validator modules for advanced transaction management
+- Script interpreter with comprehensive opcode support, stack operations, and script execution engine
+- Storage interfaces and implementations for data upload/download with encryption support
+- Overlay tools including lookup resolver, SHIP broadcaster, historian, and host reputation tracker
+- Registry client for overlay network management
+- Identity client with contacts manager for identity and contact management
+- Headers client for blockchain header synchronization
+- Keystore with local key-value store implementation supporting encrypted storage
+- Additional cryptographic primitives: Schnorr signatures, DRBG (Deterministic Random Bit Generator), AES-GCM encryption
+- Compatibility modules for BSM (Bitcoin Signed Message) and ECIES encryption
+- TOTP (Time-based One-Time Password) support for two-factor authentication
+- BIP-276 payment destination encoding support
+- PushDrop token protocol implementation
+- Teranode broadcaster support
 
 ### Changed
-- (Detail modifications that are non-breaking but relevant to the end-users.)
+- Refactored `bsv/utils.py` monolithic module into organized submodules under `bsv/utils/` for better maintainability
+- Enhanced broadcaster implementations with improved error handling and status categorization
+- Updated chain trackers with block headers service integration
+- Improved transaction handling with extended BEEF support and validation
+- Reorganized entire test suite into `tests/bsv/` structure with comprehensive coverage tests (455 files changed, 74,468+ additions)
 
-### Deprecated
-- (List features that are in the process of being phased out or replaced.)
-
-### Removed
-- (Indicate features or capabilities that were taken out of the project.)
-
-### Fixed
-- (Document bugs that were fixed since the last release.)
-
-### Security
-- (Notify of any improvements related to security vulnerabilities or potential risks.)
+### Notes
+- **No breaking changes** - All existing APIs remain fully compatible
+- Legacy tests continue to pass but have been superseded by new comprehensive test structure
+- Test organization now follows a more modular and maintainable structure under `tests/bsv/`
+- Added extensive test coverage across all modules ensuring code quality and reliability
 
 ---
 ## [1.0.11] - 2025-11-23

README.md

@@ -3,6 +3,7 @@
 [![build](https://github.com/bitcoin-sv/py-sdk/actions/workflows/build.yml/badge.svg)](https://github.com/bitcoin-sv/py-sdk/actions/workflows/build.yml)
 [![PyPI version](https://img.shields.io/pypi/v/bsv-sdk)](https://pypi.org/project/bsv-sdk)
 [![Python versions](https://img.shields.io/pypi/pyversions/bsv-sdk)](https://pypi.org/project/bsv-sdk)
+[![Coverage](https://img.shields.io/badge/coverage-85.7%25-green)](https://github.com/bitcoin-sv/py-sdk/actions/workflows/build.yml)
 
 
 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.
@@ -12,9 +13,10 @@ Welcome to the BSV Blockchain Libraries Project, the comprehensive Python SDK de
 2. [Getting Started](#getting-started)
 3. [Features & Deliverables](#features--deliverables)
 4. [Documentation](#documentation)
-5. [Tutorial](#Tutorial)
-5. [Contribution Guidelines](#contribution-guidelines)
-6. [Support & Contacts](#support--contacts)
+5. [Testing & Quality](#testing--quality)
+6. [Tutorial](#Tutorial)
+7. [Contribution Guidelines](#contribution-guidelines)
+8. [Support & Contacts](#support--contacts)
 
 ## Objective
 
@@ -33,6 +35,16 @@ pip package manager
 pip install bsv-sdk
 ```
 
+### Development Setup
+
+For contributors and developers, install with test dependencies:
+
+```bash
+pip install -e .[test]
+```
+
+This installs the package in development mode along with all testing dependencies including pytest-cov for code coverage analysis.
+
 ### Basic Usage
 
 ```python
@@ -105,6 +117,59 @@ For a more detailed tutorial and advanced examples, check our [Documentation](#d
 * 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](https://docs.bsvblockchain.org/guides/sdks/py).
@@ -114,6 +179,32 @@ Detailed documentation of the SDK with code examples can be found at [BSV Skills
 You can also refer to the [User Test Report](./docs/Py-SDK%20User%20Test%20Report.pdf) for insights and feedback provided by
 [Yenpoint](https://yenpoint.jp/).
 
+## Testing & Quality
+
+This project maintains high code quality standards with comprehensive test coverage:
+
+- **567+ tests** covering core functionality
+- **85.7%+ code coverage** across the entire codebase
+- Automated testing with GitHub Actions CI/CD
+
+### Running Tests & Coverage
+
+```bash
+# Install test dependencies
+pip install -e .[test]
+
+# Run all tests
+pytest
+
+# Run tests with coverage analysis
+pytest --cov=bsv --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.
+
 ## Beginner Tutorial
 #### [Step-by-Step BSV Tutorial: Sending BSV and NFTs](./docs/beginner_tutorial.md)
 
@@ -125,9 +216,21 @@ We're always looking for contributors to help us improve the project. Whether it
 contributions are welcome.
 
 1. **Fork & Clone**: Fork this repository and clone it to your local machine.
-2. **Set Up**: Run `pip install -r requirements.txt` to install all dependencies.
+2. **Set Up**: Install in development mode with test dependencies:
+   ```bash
+   pip install -e .[test]
+   ```
 3. **Make Changes**: Create a new branch and make your changes.
-4. **Test**: Ensure all tests pass by running `pytest --cov=bsv --cov-report=html`.
+4. **Test**: Ensure all tests pass and check code coverage:
+   ```bash
+   # 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
+   ```
+
+   Current target: 64%+ code coverage. Help us improve this by adding tests for uncovered areas!
 5. **Commit**: Commit your changes and push to your fork.
 6. **Pull Request**: Open a pull request from your fork to this repository.
 

bsv/__init__.py

@@ -1,23 +1,52 @@
-from .broadcasters import *
-from .broadcaster import *
-from .chaintrackers import *
-from .chaintracker import *
+"""bsv Python SDK package initializer.
+
+Provides backward-compatible exports while maintaining modular structure.
+You can import commonly used classes directly:
+    from bsv import Transaction, PrivateKey, PublicKey
+    from bsv.auth.peer import Peer
+"""
+
+# Phase 1: Safe imports - constants, hash, curve (no dependencies)
 from .constants import *
-from .curve import *
-from .fee_models import *
-from .fee_model import *
-from .script import * 
 from .hash import *
-from .utils import *
-from .transaction_preimage import *
+from .curve import *
+
+# Base58 encoding/decoding functions
+from .base58 import base58check_encode, base58check_decode, b58_encode, b58_decode, to_base58check, from_base58check
+
+# Step 2: HTTP client
 from .http_client import HttpClient, default_http_client
-from .keys import verify_signed_text, PublicKey, PrivateKey
+
+# Step 3: Keys
+from .keys import PrivateKey, PublicKey, verify_signed_text
+
+# Step 4: Data structures
 from .merkle_path import MerklePath, MerkleLeaf
-from .transaction import Transaction, InsufficientFunds
-from .transaction_input import TransactionInput
-from .transaction_output import TransactionOutput
 from .encrypted_message import *
 from .signed_message import *
+from .transaction_input import TransactionInput
+from .transaction_output import TransactionOutput
+from .transaction_preimage import *
+
+# Step 5: Transaction
+from .transaction import Transaction, InsufficientFunds
 
+# Phase 3: Wildcard imports (one at a time, testing for circular imports)
+# Step 6.1: broadcaster (base classes)
+from .broadcaster import *
+# Step 6.2: broadcasters (implementations)
+from .broadcasters import *
+# Step 6.3: chaintracker (base classes)
+from .chaintracker import *
+# Step 6.4: chaintrackers (implementations)
+from .chaintrackers import *
+# Step 6.5: fee_model (base classes)
+from .fee_model import *
+# Step 6.6: fee_models (implementations)
+from .fee_models import *
+# Step 6.7: script
+from .script import *
+# Step 6.8: utils
+from .utils import *
 
-__version__ = '1.0.11'
+__version__ = '1.0.12'

bsv/__init__.py.backup

@@ -0,0 +1,9 @@
+"""bsv Python SDK package minimal initializer.
+
+Avoid importing heavy submodules at package import time to prevent circular imports
+and reduce side effects. Import submodules explicitly where needed, e.g.:
+    from bsv.keys import PrivateKey
+    from bsv.auth.peer import Peer
+"""
+
+__version__ = '1.0.10'