Develop port

.coveragerc

@@ -1,6 +1,6 @@
 [run]
 branch = True
-source = src
+source = bsv
 
 [report]
 exclude_lines =
@@ -11,3 +11,5 @@ ignore_errors = False
 omit =
     tests/*
     setup.py
+show_missing = True
+skip_covered = False

.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,27 @@ 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-branch --cov-report=html --cov-report=term --cov-report=xml
+      - name: Extract coverage percentage
+        if: matrix.python-version == '3.11'
+        id: coverage
+        run: |
+          LINE_COVERAGE=$(python -c "import xml.etree.ElementTree as ET; root = ET.parse('coverage.xml').getroot(); print(f\"{float(root.attrib['line-rate'])*100:.1f}\")")
+          BRANCH_COVERAGE=$(python -c "import xml.etree.ElementTree as ET; root = ET.parse('coverage.xml').getroot(); print(f\"{float(root.attrib['branch-rate'])*100:.1f}\")")
+          echo "line_coverage_percentage=$LINE_COVERAGE" >> $GITHUB_OUTPUT
+          echo "branch_coverage_percentage=$BRANCH_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.line_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.line_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

CLAUDE.md

@@ -14,11 +14,13 @@ The BSV SDK is a comprehensive Python library for developing scalable applicatio
 ## Development Commands
 
 ### Installation
+
 ```bash
 pip install -r requirements.txt
 ```
 
 ### Testing
+
 ```bash
 # Run full test suite with coverage
 pytest --cov=bsv --cov-report=html
@@ -31,6 +33,7 @@ pytest tests/bsv/auth/test_auth_peer_basic.py
 ```
 
 ### Building the Package
+
 ```bash
 # Build distribution packages (requires python3 -m build)
 make build
@@ -40,6 +43,7 @@ python3 -m build
 ```
 
 ### Publishing (Maintainers Only)
+
 ```bash
 make upload_test  # Upload to TestPyPI
 make upload       # Upload to PyPI
@@ -52,59 +56,71 @@ make upload       # Upload to PyPI
 The `bsv` package is organized into functional submodules:
 
 - **Core Transaction Components** (`bsv/transaction.py`, `bsv/transaction_input.py`, `bsv/transaction_output.py`)
+
   - `Transaction`: Main transaction class with serialization, signing, fee calculation, and broadcasting
   - Supports BEEF (Bitcoin Encapsulated Format) and EF (Extended Format) serialization
   - SPV validation through merkle paths
 
 - **Script System** (`bsv/script/`)
+
   - `ScriptTemplate`: Abstract base for locking/unlocking scripts
   - Built-in templates: `P2PKH`, `P2PK`, `OpReturn`, `BareMultisig`, `RPuzzle`
   - `Script`: Low-level script operations
   - `Spend`: Script validation engine
 
 - **Keys & Cryptography** (`bsv/keys.py`, `bsv/curve.py`, `bsv/hash.py`)
+
   - `PrivateKey`, `PublicKey`: ECDSA key management
   - Support for compressed/uncompressed keys
   - WIF format support
 
 - **HD Wallets** (`bsv/hd/`)
+
   - Full BIP32/39/44 implementation
   - Hierarchical deterministic key derivation
   - Mnemonic phrase support (multiple languages via `hd/wordlist/`)
 
 - **Authentication** (`bsv/auth/`)
+
   - `Peer`: Central authentication protocol implementation
   - `Certificate`: Certificate handling and verification
   - `SessionManager`: Session lifecycle management
   - `Transport`: Communication layer abstraction
   - PKI-based authentication between peers
 
 - **Wallet** (`bsv/wallet/`)
+
   - `WalletInterface`: Abstract wallet interface
-  - `WalletImpl`: Full wallet implementation
+  - `ProtoWallet`: Core wallet implementation providing cryptographic operations (TS/Go parity)
+  - `WalletImpl`: Deprecated alias for ProtoWallet (backward compatibility)
   - `KeyDeriver`: Protocol-based key derivation
   - `CachedKeyDeriver`: Optimized key derivation with caching
 
 - **Broadcasting** (`bsv/broadcasters/`)
+
   - `Broadcaster`: Interface for transaction broadcasting
   - `arc.py`: ARC broadcaster implementation
   - `whatsonchain.py`: WhatsOnChain broadcaster
   - `default_broadcaster.py`: Default broadcaster selection
 
 - **Chain Tracking** (`bsv/chaintrackers/`)
+
   - `ChainTracker`: Interface for chain state verification
   - `whatsonchain.py`: WhatsOnChain chain tracker
   - `default.py`: Default chain tracker
 
 - **Storage** (`bsv/storage/`)
+
   - `Uploader`, `Downloader`: File upload/download utilities
   - Integration with blockchain storage
 
 - **Keystore** (`bsv/keystore/`)
+
   - Key persistence and retention management
   - Local key-value store implementation
 
 - **BEEF Support** (`bsv/beef/`)
+
   - `build_beef_v2_from_raw_hexes`: BEEF format construction
   - Transaction validation with merkle proofs
 
@@ -116,18 +132,21 @@ The `bsv` package is organized into functional submodules:
 ### Important Design Patterns
 
 **Lazy Imports**: The `bsv/__init__.py` is intentionally minimal to avoid circular imports. Import specific modules where needed:
+
 ```python
 from bsv.keys import PrivateKey
 from bsv.transaction import Transaction
 ```
 
 **Async Operations**: Transaction broadcasting and verification are async:
+
 ```python
 await tx.broadcast()
 await tx.verify(chaintracker)
 ```
 
 **Template Pattern**: Script types use templates that provide `lock()` and `unlock()` methods:
+
 ```python
 script_template = P2PKH()
 locking_script = script_template.lock(address)
@@ -141,10 +160,12 @@ unlocking_template = script_template.unlock(private_key)
 ## Testing Structure
 
 Tests are organized in two locations:
+
 1. **Root-level tests** (`tests/`): Classic test structure with direct imports
 2. **Nested tests** (`tests/bsv/`): Mirror the `bsv/` package structure
 
 Test organization by feature:
+
 - `tests/bsv/primitives/`: Core cryptographic primitives
 - `tests/bsv/transaction/`: Transaction building and validation
 - `tests/bsv/auth/`: Full authentication protocol test suite
@@ -153,6 +174,7 @@ Test organization by feature:
 - `tests/bsv/broadcasters/`: Broadcaster integration tests
 
 **Running single test**: Use standard pytest patterns:
+
 ```bash
 pytest tests/bsv/auth/test_auth_peer_basic.py::test_function_name
 pytest -k "test_pattern"
@@ -178,18 +200,21 @@ The SDK implements Assembly (ASM) representation of Bitcoin Script via `Script.f
 **BRC-106 Standard**: https://github.com/bitcoin-sv/BRCs/blob/master/scripts/0106.md
 
 Key requirements from BRC-106:
+
 - Use full English names for op-codes (e.g., "OP_FALSE" not "OP_0")
 - Output should always use the most human-readable format
 - Multiple input names should parse to the same hex value
 - Ensure deterministic translation across different SDKs (Py-SDK, TS-SDK, Go-SDK)
 
 **Current Implementation** (bsv/script/script.py:140-191):
+
 - `from_asm()`: Accepts both "OP_FALSE" and "OP_0", converts to b'\x00'
 - `to_asm()`: Currently outputs "OP_0" for b'\x00' (see OPCODE_VALUE_NAME_DICT override at constants.py:343)
 
 **Note**: The current `to_asm()` output may need adjustment to fully comply with BRC-106's human-readability requirement (should output "OP_FALSE" instead of "OP_0").
 
 ### Working with ASM
+
 ```python
 # Parse ASM string to Script
 script = Script.from_asm("OP_DUP OP_HASH160 abcd1234 OP_EQUALVERIFY OP_CHECKSIG")
@@ -214,6 +239,7 @@ for chunk in script.chunks:
 ## Common Patterns
 
 ### Creating and Broadcasting a Transaction
+
 ```python
 priv_key = PrivateKey(wif_string)
 source_tx = Transaction.from_hex(hex_string)
@@ -237,6 +263,7 @@ await tx.broadcast()  # Broadcast to network
 ```
 
 ### Working with BEEF Format
+
 ```python
 # Parse BEEF
 tx = Transaction.from_beef(beef_hex)
@@ -246,6 +273,7 @@ beef_bytes = tx.to_beef()
 ```
 
 ### Script Templates
+
 ```python
 # P2PKH
 p2pkh = P2PKH()

CONTRIBUTING.md

@@ -54,7 +54,7 @@ contributors to adhere to.
 
 2. **Commit Your Changes**: Make your changes and commit them. Commit messages should be clear and concise to explain what was done.
 
-3. **Run Tests**: Ensure all tests pass using Jest: `pytest --cov=bsv --cov-report=html`.
+3. **Run Tests**: Ensure all tests pass and check coverage: `pytest --cov=bsv --cov-branch --cov-report=html`.
 
 4. **Documentation**: All code must be fully annotated with comments.
 
@@ -79,9 +79,12 @@ contributors to adhere to.
 
 - **Documentation**: Update the documentation whenever you add or modify the code.
 
-- **Testing**: We use Jest for all tests. Write comprehensive tests, ensuring edge cases are covered. All PRs should maintain or improve the
+- **Testing**: We use pytest for all tests. Write comprehensive tests, ensuring edge cases are covered. All PRs should maintain or improve the
   current test coverage.
 
+- **Branch Coverage**: We measure both line and branch coverage. For critical modules (wallet, auth, crypto), aim for 70%+ branch coverage.
+  Include tests for both branches of conditional statements. Run `pytest --cov=bsv --cov-branch --cov-report=html` to check branch coverage.
+
 ## Contact & Support
 
 If you have any questions or need assistance with your contributions, feel free to reach out. Remember, we're here to help each other grow