Merge branch 'bsv-blockchain:develop-port' into develop-port

Author: jo7ueb

.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,3 +8,10 @@ dist/
 htmlcov/
 .coverage
 build/
+.wallet
+.venv/
+
+# Environment files
+.env
+.env.local
+.env.*.local

CHANGELOG.md

@@ -7,6 +7,9 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 ## Table of Contents
 
 - [Unreleased](#unreleased)
+- [1.0.11 - 2025-11-23](#1011---2025-11-23)
+- [1.0.10 - 2025-10-30](#1010---2025-10-30)
+- [1.0.9 - 2025-09-30](#109---2025-09-30)
 - [1.0.8 - 2025-08-13](#108---2025-08-13)
 - [1.0.7.1- 2025-07-28](#1071---2025-07-28)
 - [1.0.7- 2025-07-28](#107---2025-07-28)
@@ -23,26 +26,79 @@ 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)
+
+### 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
 
-### Deprecated
-- (List features that are in the process of being phased out or replaced.)
+---
+## [1.0.11] - 2025-11-23
 
-### Removed
-- (Indicate features or capabilities that were taken out of the project.)
+### Changed
+- Converted `LivePolicy` fee model from asynchronous to synchronous implementation
+- Replaced `default_http_client()` (async) with `default_sync_http_client()` (sync) in `LivePolicy`
+- **`Transaction.fee()` can now be called from both synchronous and asynchronous functions without any special handling**
+- Removed unused `asyncio` and `inspect` imports from `transaction.py`
+- Simplified `Transaction.fee()` implementation by removing async helper methods
 
 ### Fixed
-- (Document bugs that were fixed since the last release.)
+- Updated all `LivePolicy` tests to use synchronous mocks instead of `AsyncMock`
+- Fixed `test_transaction_fee_with_default_rate` to use explicit fee model for deterministic testing
+- Removed `asyncio.run()` calls from `LivePolicy` test suite
 
-### Security
-- (Notify of any improvements related to security vulnerabilities or potential risks.)
+### Notes
+- This change is transparent to users - `tx.fee()` works seamlessly in both sync and async contexts without any API changes
+- You can call `tx.fee()` inside `async def` functions or regular `def` functions - it works the same way
+- All existing code and documentation remain compatible with no modifications required
+
+---
+## [1.0.10] - 2025-10-30
+
+### Changed
+- Updated Script ASM output to use BRC-106 compliant format (outputs `OP_FALSE` instead of `OP_0` for better human readability)
+- Converted `test_arc_ef_or_rawhex.py` from unittest.TestCase to pytest style for better async test handling
+
+### Fixed
+- Added missing test dependencies to requirements.txt: `ecdsa~=0.19.0` and `pytest-cov~=6.0.0`
+- Fixed pytest configuration by adding `asyncio_default_fixture_loop_scope` to eliminate deprecation warnings
+- Updated test expectations in `test_scripts.py` to match BRC-106 compliant ASM output
+- Resolved all pytest warnings for a clean test output (154 tests passing with zero warnings)
+
+
+---
+## [1.0.9] - 2025-09-30
+
+### Added
+- Integrated `LivePolicy` for dynamic fee computations with caching and fallback mechanisms.
+ [ts-sdk#343](https://github.com/bsv-blockchain/ts-sdk/pull/343).
 
 ---
 ## [1.0.8] - 2025-08-13