Blockchain password recovery

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,44 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Note Regarding Scammers**
+Scammers monitor the issues section of this Github and automatically reply to new issues with links to phishing websites, etc. (And Github moderation tools are very poor) You should disregard all comments recieved before a response from @3rdIteration...
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Sample Wallet**
+Please provide a test wallet that demonstrates this issue.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Free Support: CryptoGuide YouTube channel
+    url: https://www.youtube.com/channel/UCEviBQwLv-yfv3BErm0ojHg/
+    about: BTCRecover Tutorials, free support happens in the comments section. (I reply to everything)
+  - name: Paid Support: CryptoGuide Recovery Services
+    url: https://cryptoguide.tips/recovery-services-consultations/
+    about: Request Paid Private support or Trusted Recoveries.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+**Note Regarding Scammers**
+Scammers monitor the issues section of this Github and automatically reply to new issues with links to phishing websites, etc. (And Github moderation tools are very poor) You should disregard all comments recieved before a response from @3rdIteration...
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/Latest-Run-All-Tests_Base.yml

@@ -0,0 +1,68 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Last Push - All Tests (Base Modules)
+
+on:
+  push:
+    branches: [ master ]
+
+jobs:
+  build:
+    timeout-minutes: 20 # allow extra time for occasional slow tests
+    runs-on: ${{matrix.os}}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04] # Test Ubuntu Only
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14'] # Test all supported versions of Python
+        backend: [coincurve, wallycore, purepython] # Test all three secp256k1 backends
+
+    steps:
+    - uses: actions/checkout@v7
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies (coincurve backend)
+      if: matrix.backend == 'coincurve'
+      run: |
+        python -m pip install --upgrade pip
+        # Install everything except coincurve first (this pulls in wallycore, the
+        # fallback backend), then try to add coincurve on top. On platforms where
+        # coincurve cannot be built (e.g. Python 3.14), the job still runs using
+        # the wallycore fallback instead of failing the install step.
+        grep -viE 'coincurve' requirements.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+        pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+        # Per-Python-version coincurve pin (matches available prebuilt wheels):
+        #  3.9 / 3.10 / 3.11 / 3.12 -> either 20 or 21 has a wheel
+        #  3.13 -> only 21.0.0 has a wheel
+        #  3.14 -> neither has a wheel; the install is allowed to fail and the job
+        #          runs on the already-installed wallycore fallback backend.
+        case "${{ matrix.python-version }}" in
+          3.13) pip install coincurve==21.0.0 || true ;;
+          3.14) pip install coincurve==21.0.0 || pip install coincurve==20.0.0 || true ;;
+          *)    pip install coincurve==21.0.0 || pip install coincurve==20.0.0 || true ;;
+        esac
+    - name: Install dependencies (wallycore backend)
+      if: matrix.backend == 'wallycore'
+      run: |
+        python -m pip install --upgrade pip
+        pip install wallycore
+        grep -viE 'coincurve|wallycore' requirements.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+        pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+    - name: Install dependencies (pure-python backend)
+      if: matrix.backend == 'purepython'
+      run: |
+        python -m pip install --upgrade pip
+        # Also exclude pycryptodome and protobuf so the pure-python AES,
+        # ChaCha20-Poly1305, and Keccak fallbacks are exercised.
+        # pycryptodome is the C-backed implementation; protobuf is the
+        # only remaining optional dependency that cannot be pure-python.
+        grep -viE 'coincurve|wallycore|pycryptodome|protobuf' requirements.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+        pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+    - name: Run All Tests
+      env:
+        BTCR_BACKEND: ${{ matrix.backend }}
+      run: |
+        python run-all-tests.py -vv

.github/workflows/Latest-Run-All-Tests_Full.yml

@@ -0,0 +1,76 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Last Push - All Tests (Full Modules)
+
+env:
+  PYO3_USE_ABI3_FORWARD_COMPATIBILITY: 1
+
+on:
+  push:
+    branches: [ master ]
+
+jobs:
+  build:
+    timeout-minutes: 20 # allow extra time for occasional slow tests
+    runs-on: ${{matrix.os}}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04] # Test Ubuntu Only
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14'] # Test all supported versions of Python
+        backend: [coincurve, wallycore, purepython] # Test all three secp256k1 backends
+
+    steps:
+    - uses: actions/checkout@v7
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies (coincurve backend)
+      if: matrix.backend == 'coincurve'
+      run: |
+        python -m pip install --upgrade pip
+        # Install everything except coincurve first (this pulls in wallycore, the
+        # fallback backend), then try to add coincurve on top. On platforms where
+        # coincurve cannot be built (e.g. Python 3.14), the job still runs using
+        # the wallycore fallback instead of failing the install step.
+        grep -viE 'coincurve' requirements-full.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+        # On Python 3.14 coincurve has no wheel and cannot build from source, and
+        # bip-utils (plus the packages that depend on it) hard-require coincurve.
+        # Exclude that subtree on 3.14 so the install succeeds using the wallycore
+        # fallback instead of failing on a coincurve source build.
+        if [ "${{ matrix.python-version }}" = "3.14" ]; then
+          grep -viE 'bip-utils|py_crypto_hd_wallet|slip10|stellar_sdk' "$RUNNER_TEMP/btcr-reqs.txt" > "$RUNNER_TEMP/btcr-reqs-3.14.txt"
+          mv "$RUNNER_TEMP/btcr-reqs-3.14.txt" "$RUNNER_TEMP/btcr-reqs.txt"
+        fi
+        pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+        sudo apt install python3-bsddb3
+        # Per-Python-version coincurve pin (matches available prebuilt wheels):
+        #  3.13 -> only 21.0.0 has a wheel; 3.14 -> no wheel, fall back to wallycore.
+        case "${{ matrix.python-version }}" in
+          3.13) pip install coincurve==21.0.0 || true ;;
+          *)    pip install coincurve==21.0.0 || pip install coincurve==20.0.0 || true ;;
+        esac
+    - name: Install dependencies (wallycore backend)
+      if: matrix.backend == 'wallycore'
+      run: |
+        python -m pip install --upgrade pip
+        pip install wallycore
+        grep -viE 'coincurve|wallycore' requirements-full.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+        pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+        sudo apt install python3-bsddb3
+    - name: Install dependencies (pure-python backend)
+      if: matrix.backend == 'purepython'
+      run: |
+        python -m pip install --upgrade pip
+        # Also exclude pycryptodome and protobuf so the pure-python AES,
+        # ChaCha20-Poly1305, and Keccak fallbacks are exercised.
+        grep -viE 'coincurve|wallycore|pycryptodome|protobuf' requirements-full.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+        pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+        sudo apt install python3-bsddb3
+    - name: Run All Tests
+      env:
+        BTCR_BACKEND: ${{ matrix.backend }}
+      run: |
+        python run-all-tests.py -vv

.github/workflows/PoCL-tests-full.yml

@@ -0,0 +1,34 @@
+name: OpenCL PoCL Tests (Full)
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+  workflow_dispatch:
+
+jobs:
+  pocl-full:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v7
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install OpenCL runtime
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y pocl-opencl-icd ocl-icd-opencl-dev opencl-headers clinfo
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install coincurve==21.0.0 || pip install coincurve==20.0.0 || true
+          grep -viE 'coincurve' requirements-full.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+          pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+          pip install pyopencl
+      - name: Run tests with PoCL
+        env:
+          PYOPENCL_COMPILER_OUTPUT: '1'
+        run: python run-all-tests.py -vv

.github/workflows/PoCL-tests.yml

@@ -0,0 +1,32 @@
+name: OpenCL PoCL Tests
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+  workflow_dispatch:
+
+jobs:
+  pocl:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v7
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install OpenCL runtime
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y pocl-opencl-icd ocl-icd-opencl-dev opencl-headers clinfo
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pyopencl
+      - name: Run tests with PoCL
+        env:
+          PYOPENCL_COMPILER_OUTPUT: '1'
+        run: python run-all-tests.py -vv

.github/workflows/Weekly-Run-All-Tests-Full.yml

@@ -0,0 +1,71 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Weekly - All Tests (+Optional Modules)
+
+env:
+  PYO3_USE_ABI3_FORWARD_COMPATIBILITY: 1
+
+on:
+  schedule:
+    - cron: "0 0 * * 6"
+  pull_request:
+    branches: [ master ]
+  workflow_dispatch:
+
+jobs:
+  build:
+    timeout-minutes: 20 # allow extra time for occasional slow tests
+    runs-on: ${{matrix.os}}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, windows-latest, macos-latest]
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14'] # Test all supported versions of Python
+        exclude:
+          - os: windows-latest
+            python-version: '3.13'
+
+    steps:
+    - uses: actions/checkout@v7
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install Build Environment
+      run: |
+        if [ "$RUNNER_OS" == "macOS" ]; then
+          /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+          brew install autoconf automake libffi libtool pkg-config gnu-sed swig
+        fi
+      shell: bash
+    - name: Install dependencies
+      shell: bash
+      run: |
+        python -m pip install --upgrade pip
+        # Install everything except coincurve first (this pulls in wallycore, the
+        # fallback backend), then try to add coincurve on top. On platforms where
+        # coincurve cannot be built (e.g. Python 3.14), the job still runs using
+        # the wallycore fallback instead of failing the install step.
+        grep -viE 'coincurve' requirements-full.txt > "$RUNNER_TEMP/btcr-reqs.txt"
+        # On Python 3.14 coincurve has no wheel and cannot build from source, and
+        # bip-utils (plus the packages that depend on it) hard-require coincurve.
+        # Exclude that subtree on 3.14 so the install succeeds using the wallycore
+        # fallback instead of failing on a coincurve source build.
+        if [ "${{ matrix.python-version }}" = "3.14" ]; then
+          grep -viE 'bip-utils|py_crypto_hd_wallet|slip10|stellar_sdk' "$RUNNER_TEMP/btcr-reqs.txt" > "$RUNNER_TEMP/btcr-reqs-3.14.txt"
+          mv "$RUNNER_TEMP/btcr-reqs-3.14.txt" "$RUNNER_TEMP/btcr-reqs.txt"
+        fi
+        pip install -r "$RUNNER_TEMP/btcr-reqs.txt"
+        # Per-Python-version coincurve pin (matches available prebuilt wheels):
+        #  3.13 -> only 21.0.0 has a wheel; 3.14 -> no wheel, fall back to wallycore.
+        case "${{ matrix.python-version }}" in
+          3.13) pip install coincurve==21.0.0 || true ;;
+          *)    pip install coincurve==21.0.0 || pip install coincurve==20.0.0 || true ;;
+        esac
+    - name: Install green on Windows (workaround for hanging tests on Github Actions)
+      if: runner.os == 'Windows'
+      run: pip install green
+    - name: Run All Tests
+      run: |
+        python run-all-tests.py -vv