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

.env.local.example

@@ -0,0 +1,6 @@
+# Environment variables for local development
+# Copy this file to .env.local and fill in your actual values
+
+# BHS (Block Headers Service) API Key for chaintracker examples
+# Get your API key from your BHS service provider
+BHS_API_KEY=your_api_key_here

.github/workflows/build.yml

@@ -1,6 +1,4 @@
 name: build
-permissions:
-  contents: read
 
 on:
   push:
@@ -9,30 +7,95 @@ on:
     branches: [ master ]
 
 jobs:
-  pytest:
+  test:
     runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+      contents: write
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ "3.9", "3.10", "3.11", "3.12" ]
+        python-version: [ "3.10", "3.11", "3.12" ]
 
     steps:
-      - uses: actions/checkout@v3
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
-        with:
-          python-version: ${{ matrix.python-version }}
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install flake8
-          pip install '.[test]'
-      - name: Lint with flake8
-        run: |
-          # stop the build if there are Python syntax errors or undefined names
-          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
-        run: |
-          pytest
+    - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+      with:
+        fetch-depth: 0  # Fetch all history for all branches and tags
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Cache pip packages
+      uses: actions/cache@6f8efc29b200d32929f49075959781ed54ec270c
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .[test,dev]
+
+    - name: Run linting
+      run: |
+        echo "Running black..."
+        black --check bsv/ tests/
+        echo "Running ruff..."
+        ruff check bsv/ tests/
+
+    - name: Run tests with coverage
+      run: |
+        pytest tests/ -v --cov=bsv --cov-report=term-missing --cov-report=html --cov-report=json
+
+    - name: Extract coverage percentage
+      id: coverage
+      run: |
+        # Extract coverage percentage from coverage.json and format to one decimal place
+        COVERAGE=$(python -c "import json; data=json.load(open('coverage.json')); print(f\"{data['totals']['percent_covered']:.1f}\")")
+        echo "coverage=$COVERAGE" >> $GITHUB_OUTPUT
+        echo "Coverage: $COVERAGE%"
+
+    - name: Update coverage badge
+      if: matrix.python-version == '3.11'
+      run: |
+        python update_coverage.py ${{ steps.coverage.outputs.coverage }}
+
+    - name: Commit and push updated coverage badge (push to master only)
+      if: github.event_name == 'push' && github.ref == 'refs/heads/master' && matrix.python-version == '3.11'
+      run: |
+        # Only proceed if README.md has changes
+        if git diff --quiet README.md; then
+          echo "No coverage badge changes to commit."
+          exit 0
+        fi
+        git config user.name "github-actions[bot]"
+        git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+        git add README.md
+        git commit -m "chore: update coverage badge to ${{ steps.coverage.outputs.coverage }}% [skip ci]" || echo "No changes to commit."
+        git push
+
+    - name: Upload coverage reports
+      if: matrix.python-version == '3.11'
+      uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
+      with:
+        name: coverage-report
+        path: htmlcov/
+
+    - name: Comment PR with coverage
+      if: github.event_name == 'pull_request' && matrix.python-version == '3.11'
+      uses: actions/github-script@f28e40c7f34bde8b3046d885e986cb6290c5673b
+      with:
+        script: |
+          const coverage = '${{ steps.coverage.outputs.coverage }}';
+          const comment = `## Test Coverage Report\n\n📊 **Coverage: ${coverage}%**\n\nView the full coverage report in the build artifacts.`;
+          github.rest.issues.createComment({
+            issue_number: context.issue.number,
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            body: comment
+          });

.github/workflows/workflow.yml

@@ -0,0 +1,41 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065
+        with:
+          python-version: "3.11"
+
+      - name: Cache pip
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-build
+
+      - name: Install build dependencies
+        run: python -m pip install --upgrade pip build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check distribution
+        run: |
+          python -m pip install twine
+          twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e

.gitignore

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

.python-version

@@ -0,0 +1 @@
+3.9.25

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