[glm-grade=B] fix(reindex): set phashBlock before GetStakeModifierChecksum in FastImportBlockFile

FastImportBlockFile() was calling GetStakeModifierChecksum(pindexNew)
which calls GetBlockHash() which dereferences *phashBlock — but
phashBlock was still null because the mapBlockIndex.insert that sets it
happened 10 lines later. This caused a segfault (exit 139) on every
fresh -reindex with no existing chainstate.

Fix: move the mapBlockIndex.insert + phashBlock assignment before the
GetStakeModifierChecksum call. Pure ordering fix, no logic change.

.dockerignore

@@ -0,0 +1,16 @@
+.git
+.github
+build
+build-*
+cmake-build-*
+*.dat
+*.log
+*.pid
+*.conf
+*.key
+*.pem
+*.sqlite
+*.sqlite3
+.triangles
+wallet.dat
+wallet.dat.*

.github/workflows/build-all.yml

@@ -8,12 +8,20 @@ on:
     branches: [master]
   workflow_dispatch:
 
+permissions:
+  contents: read
+
 jobs:
   test-linux-unit:
+    # This is the canonical CI gate for unit tests. Failures here MUST block
+    # the PR — see PR #26 incident (2026-07-11): the previous
+    # `continue-on-error: true` + `|| true` soft-gate allowed a PR with broken
+    # master-side code to merge because the link failure wasn't blocking.
+    # Sanitizer regression = blocking PR (test-linux-sanitizers below).
+    # Unit regression = blocking PR (this job).
     runs-on: ubuntu-22.04
-    continue-on-error: true
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           submodules: recursive
 
@@ -22,7 +30,15 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y build-essential cmake ninja-build \
             libboost-all-dev libssl-dev libdb++-dev libleveldb-dev \
-            librocksdb-dev libevent-dev libminiupnpc-dev zlib1g-dev
+            libevent-dev libminiupnpc-dev zlib1g-dev \
+            libsnappy-dev liblz4-dev libzstd-dev
+
+      - name: Build RocksDB from source
+        # Ubuntu 22.04's librocksdb-dev is 6.11.4 which CMakeLists.txt now
+        # refuses to configure against (need >= 7.4 for XXH3 per-block
+        # checksum). Build 8.9.1 from source — same version DNS2 ships —
+        # into /usr/local so CMake's find_library picks it up first.
+        run: sudo bash scripts/ci/build-rocksdb.sh
 
       - name: Configure
         run: |
@@ -33,18 +49,60 @@ jobs:
             -DBUILD_TESTS=ON \
             -DUSE_UPNP=OFF
 
+      - name: Build libtor (embedded Tor static lib)
+        # USE_TOR_EMBEDDED defaults to ON and the daemon/Qt GUI both
+        # link -ltor. The Tor source is a git submodule but libtor.a
+        # is NOT built by cmake. build-libtor.sh defaults to /mingw64
+        # paths which don't exist on the ubuntu-22.04 runner; pass
+        # /usr where libevent-dev/libssl-dev/zlib1g-dev install.
+        run: |
+          sudo apt-get install -y libevent-dev libssl-dev zlib1g-dev
+          LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+            bash src/tor/build-libtor.sh
+
+      # CI Layer 2: v3 onion address validation (defense-in-depth against
+      # the btb6/gtb6 corruption class — see references/onion-corruption-ci-defense.md).
+      # Validates: (a) src/onionseed.h hardcoded seeds, (b) contrib/triangles.conf.example
+      # operator-facing example. Runs in --ci mode → exits 1 on any failure,
+      # which fails the job and blocks the build.
+      - name: Validate .onion addresses (CI gate)
+        run: |
+          python3 scripts/validate_onion_seeds.py \
+            --ci \
+            --against src/onionseed.h \
+            src/onionseed.h \
+            contrib/triangles.conf.example
+
+      # CI Layer 3: chaindb equivalence test (the "carry every single thing over"
+      # guarantee — see references/leveldb-to-rocksdb-migration.md Phase A).
+      # Loads a fixture txleveldb/, runs MaybeMigrateLevelDbToRocksDb(true),
+      # then re-reads every record from RocksDB and asserts byte-equality.
+      # This is the proof that no data is lost in the LevelDB→RocksDB migration.
       - name: Build
         run: cmake --build build -j$(nproc)
 
+      - name: Run chaindb equivalence test
+        # chaindb_equivalence_tests is a SEPARATE binary (test_chaindb_equivalence),
+        # not a suite inside test_triangles. Run the right binary.
+        run: |
+          if [ -x build/bin/test_chaindb_equivalence ]; then
+            ./build/bin/test_chaindb_equivalence --log_level=test_suite
+          else
+            echo "::error::test_chaindb_equivalence was not built"
+            exit 1
+          fi
+
       - name: Run unit tests
-        run: cd build && ctest --output-on-failure || true
+        # ctest exit code is the gate. NO `|| true` — failures must block
+        # the PR (see comment at top of this job). --output-on-failure gives
+        # the failing assertion + suite name inline rather than requiring a
+        # log download.
+        run: cd build && ctest --output-on-failure
 
   test-linux-sanitizers:
-    # ASan + UBSan build of the daemon + unit tests. Allowed to fail until
-    # findings are triaged — see .github/workflows/lint.yml comment block.
-    # Once the test suite is clean under sanitizers, drop continue-on-error.
+    # ASan + UBSan build of the daemon + unit tests. This is a blocking
+    # signal: sanitizer regressions should fail the PR.
     runs-on: ubuntu-22.04
-    continue-on-error: true
     env:
       # ASan: leak detection off by default (BDB and OpenSSL produce noise on shutdown).
       # Re-enable once we've quieted the legitimate suspects.
@@ -55,7 +113,7 @@ jobs:
       # and BDB until they're fixed file-by-file.
       SAN_FLAGS: "-fsanitize=address,undefined -fno-omit-frame-pointer -fno-sanitize-recover=undefined -fno-sanitize=alignment,signed-integer-overflow,vptr"
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           submodules: recursive
 
@@ -64,7 +122,11 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y build-essential cmake ninja-build \
             libboost-all-dev libssl-dev libdb++-dev libleveldb-dev \
-            librocksdb-dev libevent-dev libminiupnpc-dev zlib1g-dev
+            libevent-dev libminiupnpc-dev zlib1g-dev \
+            libsnappy-dev liblz4-dev libzstd-dev
+
+      - name: Build RocksDB from source
+        run: sudo bash scripts/ci/build-rocksdb.sh
 
       - name: Configure with sanitizers
         run: |
@@ -79,23 +141,253 @@ jobs:
             -DBUILD_TESTS=ON \
             -DUSE_UPNP=OFF
 
+      - name: Build libtor (embedded Tor static lib)
+        # USE_TOR_EMBEDDED defaults to ON and the daemon/Qt GUI both
+        # link -ltor. The Tor source is a git submodule but libtor.a
+        # is NOT built by cmake. build-libtor.sh defaults to /mingw64
+        # paths which don't exist on the ubuntu-22.04 runner; pass
+        # /usr where libevent-dev/libssl-dev/zlib1g-dev install.
+        run: |
+          sudo apt-get install -y libevent-dev libssl-dev zlib1g-dev
+          LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+            bash src/tor/build-libtor.sh
+
       - name: Build
         run: cmake --build build-san -j$(nproc)
 
       - name: Run unit tests under sanitizers
         run: cd build-san && ctest --output-on-failure
 
+  test-fuzz-smoke:
+    # libFuzzer smoke test for src/script.cpp (fuzz_script harness).
+    # Builds with ASan+UBSan+libFuzzer and runs for 5 minutes. Any crash
+    # is uploaded as an artifact and the job fails — fuzz regressions
+    # must block the PR.
+    # See src/test/fuzz/README.md for harness details.
+    runs-on: ubuntu-22.04
+    timeout-minutes: 20
+    env:
+      ASAN_OPTIONS: "detect_leaks=0:halt_on_error=1:abort_on_error=1:print_stacktrace=1"
+      UBSAN_OPTIONS: "halt_on_error=1:abort_on_error=1:print_stacktrace=1"
+      SAN_FLAGS: "-fsanitize=address,undefined,fuzzer-no-link -fno-omit-frame-pointer -fno-sanitize-recover=undefined -fno-sanitize=alignment,signed-integer-overflow,vptr"
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          submodules: recursive
+
+      - name: Install clang + dependencies
+        # libFuzzer ships with clang since v6; clang-15 is on the runner.
+        # libgflags-dev: fuzz link line references -lgflags (RocksDB builds
+        # expect gflags as a transitive dep). Without it the link step fails
+        # with "cannot find -lgflags". CI's ubuntu-22.04 runner does NOT ship
+        # it by default; DNS2 has it as an automatic dep of build-essential,
+        # which is why local dry-runs didn't catch this.
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang-15 cmake ninja-build \
+            libboost-all-dev libssl-dev libdb++-dev libleveldb-dev \
+            libevent-dev libminiupnpc-dev zlib1g-dev \
+            libsnappy-dev liblz4-dev libzstd-dev \
+            libgflags-dev
+          sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-15 100
+          sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-15 100
+
+      - name: Build RocksDB from source
+        run: sudo bash scripts/ci/build-rocksdb.sh
+
+      - name: Configure with fuzzing + sanitizers
+        # NB: do NOT pass -fsanitize=fuzzer in CMAKE_EXE_LINKER_FLAGS — that
+        # pulls libFuzzer's main() into CMake's compiler-probe linker test
+        # and trips "multiple definition of `main`". The fuzz_script target's
+        # custom clang++ link step adds -fsanitize=fuzzer in src/CMakeLists.txt
+        # (see BUILD_FUZZ block).
+        # SECP256K1_ASM=OFF: clang-15+ register allocator is sometimes stricter
+        # than clang-14 about the x86_64 inline asm in scalar_4x64_impl.h and
+        # fails with "inline assembly requires more registers than available"
+        # on some runner images. The fuzz target only exercises script.cpp —
+        # ECC ops use the C fallback (slower, still correct).
+        run: |
+          cmake -B build-fuzz -G Ninja \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DCMAKE_C_COMPILER=clang \
+            -DCMAKE_CXX_COMPILER=clang++ \
+            -DCMAKE_C_FLAGS="$SAN_FLAGS" \
+            -DCMAKE_CXX_FLAGS="$SAN_FLAGS" \
+            -DCMAKE_EXE_LINKER_FLAGS="$SAN_FLAGS" \
+            -DBUILD_QT=OFF \
+            -DBUILD_DAEMON=ON \
+            -DBUILD_TESTS=ON \
+            -DBUILD_FUZZ=ON \
+            -DUSE_UPNP=OFF \
+            -DSECP256K1_ASM=OFF
+
+      - name: Build libtor (embedded Tor static lib)
+        # BUILD_FUZZ pulls in triangles_common + trianglesd_objects (OBJECT lib)
+        # via the fuzz target's CMake deps. The link line references libtor.a,
+        # which the Tor submodule script produces — CMake doesn't build it.
+        # Mirror the unit/sanitizer jobs here before invoking the fuzz target.
+        run: |
+          sudo apt-get install -y libevent-dev libssl-dev zlib1g-dev
+          LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+            bash src/tor/build-libtor.sh
+
+      - name: Build fuzz_script
+        # CMake target is named `fuzz_script` (matches FUZZ_BIN_DIR/fuzz_script
+        # in src/CMakeLists.txt — see add_custom_target(fuzz_script ...)).
+        run: cmake --build build-fuzz --target fuzz_script -j$(nproc)
+
+      - name: Generate seed corpus from JSON fixtures
+        # Uses src/test/data/script_{valid,invalid}.json so the fuzzer
+        # starts from real Bitcoin-style scripts instead of empty input.
+        run: |
+          mkdir -p build-fuzz/fuzz_corpus
+          python3 src/test/fuzz/seed_corpus.py \
+            src/test/data/script_valid.json \
+            build-fuzz/fuzz_corpus valid
+          python3 src/test/fuzz/seed_corpus.py \
+            src/test/data/script_invalid.json \
+            build-fuzz/fuzz_corpus invalid
+
+      - name: Run fuzzer for 5 minutes
+        # -max_total_time=300 hard-caps runtime. Crashes go to artifact
+        # prefix; we upload any artifacts and fail the job if any exist.
+        run: |
+          mkdir -p build-fuzz/fuzz_artifacts
+          set +e
+          ./build-fuzz/bin/fuzz_script \
+            -max_total_time=300 \
+            -max_len=4096 \
+            -artifact_prefix=build-fuzz/fuzz_artifacts/ \
+            build-fuzz/fuzz_corpus/ \
+            2>&1 | tee build-fuzz/fuzz_log.txt
+          FUZZ_EXIT=${PIPESTATUS[0]}
+          set -e
+          if [ -n "$(ls -A build-fuzz/fuzz_artifacts/ 2>/dev/null | grep -v '\.tmp$')" ]; then
+            echo "::error::Fuzzer produced crash/leak artifacts"
+            exit 1
+          fi
+          exit "$FUZZ_EXIT"
+
+      - name: Upload fuzzer artifacts on success
+        if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: fuzz-artifacts
+          path: build-fuzz/fuzz_artifacts/
+
+  test-fuzz-smoke-tx:
+    # libFuzzer smoke test for src/test/fuzz/transaction_deserialize_fuzz.cpp.
+    # Mirrors test-fuzz-smoke but exercises CTransaction deserialization
+    # instead of the script interpreter. Any crash is uploaded as an artifact
+    # and the job fails — fuzz regressions must block the PR.
+    # See src/test/fuzz/transaction_deserialize_fuzz.cpp for harness details.
+    runs-on: ubuntu-22.04
+    timeout-minutes: 20
+    env:
+      ASAN_OPTIONS: "detect_leaks=0:halt_on_error=1:abort_on_error=1:print_stacktrace=1"
+      UBSAN_OPTIONS: "halt_on_error=1:abort_on_error=1:print_stacktrace=1"
+      SAN_FLAGS: "-fsanitize=address,undefined,fuzzer-no-link -fno-omit-frame-pointer -fno-sanitize-recover=undefined -fno-sanitize=alignment,signed-integer-overflow,vptr"
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          submodules: recursive
+
+      - name: Install clang + dependencies
+        # libFuzzer ships with clang since v6; clang-15 is on the runner.
+        # libgflags-dev: fuzz link line references -lgflags (RocksDB builds
+        # expect gflags as a transitive dep). Without it the link step fails
+        # with "cannot find -lgflags". CI's ubuntu-22.04 runner does NOT ship
+        # it by default.
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang-15 cmake ninja-build \
+            libboost-all-dev libssl-dev libdb++-dev libleveldb-dev \
+            libevent-dev libminiupnpc-dev zlib1g-dev \
+            libsnappy-dev liblz4-dev libzstd-dev \
+            libgflags-dev
+          sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-15 100
+          sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-15 100
+
+      - name: Build RocksDB from source
+        run: sudo bash scripts/ci/build-rocksdb.sh
+
+      - name: Configure with fuzzing + sanitizers
+        # NB: do NOT pass -fsanitize=fuzzer in CMAKE_EXE_LINKER_FLAGS — that
+        # pulls libFuzzer's main() into CMake's compiler-probe linker test
+        # and trips "multiple definition of `main`". The transaction_deserialize_fuzz
+        # target's custom clang++ link step adds -fsanitize=fuzzer in src/CMakeLists.txt
+        # (see BUILD_FUZZ block).
+        # SECP256K1_ASM=OFF: clang-15+ register allocator is sometimes stricter
+        # than clang-14 about the x86_64 inline asm in scalar_4x64_impl.h.
+        run: |
+          cmake -B build-fuzz -G Ninja \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DCMAKE_C_COMPILER=clang \
+            -DCMAKE_CXX_COMPILER=clang++ \
+            -DCMAKE_C_FLAGS="$SAN_FLAGS" \
+            -DCMAKE_CXX_FLAGS="$SAN_FLAGS" \
+            -DCMAKE_EXE_LINKER_FLAGS="$SAN_FLAGS" \
+            -DBUILD_QT=OFF \
+            -DBUILD_DAEMON=ON \
+            -DBUILD_TESTS=ON \
+            -DBUILD_FUZZ=ON \
+            -DUSE_UPNP=OFF \
+            -DSECP256K1_ASM=OFF
+
+      - name: Build libtor (embedded Tor static lib)
+        # BUILD_FUZZ pulls in triangles_common + trianglesd_objects (OBJECT lib)
+        # via the fuzz target's CMake deps. The link line references libtor.a,
+        # which the Tor submodule script produces — CMake doesn't build it.
+        run: |
+          sudo apt-get install -y libevent-dev libssl-dev zlib1g-dev
+          LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+            bash src/tor/build-libtor.sh
+
+      - name: Build transaction_deserialize_fuzz
+        # CMake target is named `transaction_deserialize_fuzz` (matches
+        # add_custom_target(transaction_deserialize_fuzz ...) in src/CMakeLists.txt).
+        run: cmake --build build-fuzz --target transaction_deserialize_fuzz -j$(nproc)
+
+      - name: Run fuzzer for 5 minutes
+        # -max_total_time=300 hard-caps runtime. Crashes go to artifact
+        # prefix; we upload any artifacts and fail the job if any exist.
+        # The transaction_deserialize_fuzz target does not need a seed
+        # corpus — it accepts arbitrary bytes as a transaction payload.
+        run: |
+          mkdir -p build-fuzz/fuzz_artifacts_tx build-fuzz/fuzz_corpus_tx
+          set +e
+          ./build-fuzz/bin/transaction_deserialize_fuzz \
+            -max_total_time=300 \
+            -max_len=200000 \
+            -artifact_prefix=build-fuzz/fuzz_artifacts_tx/ \
+            build-fuzz/fuzz_corpus_tx/ \
+            2>&1 | tee build-fuzz/fuzz_log.txt
+          FUZZ_EXIT=${PIPESTATUS[0]}
+          set -e
+          if [ -n "$(ls -A build-fuzz/fuzz_artifacts_tx/ 2>/dev/null | grep -v '\.tmp$')" ]; then
+            echo "::error::Fuzzer produced crash/leak artifacts"
+            exit 1
+          fi
+          exit "$FUZZ_EXIT"
+
+      - name: Upload fuzzer artifacts on success
+        if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: fuzz-artifacts-tx
+          path: build-fuzz/fuzz_artifacts_tx/
+
   build-windows-qt:
     runs-on: windows-latest
     defaults:
       run:
         shell: msys2 {0}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           submodules: recursive
 
-      - uses: msys2/setup-msys2@v2
+      - uses: msys2/setup-msys2@66cd2cce69caa17b53920067426061ca1de3a884 # v2
         with:
           msystem: MINGW64
           update: true
@@ -112,15 +404,17 @@ jobs:
             mingw-w64-x86_64-miniupnpc
             mingw-w64-x86_64-zlib
             mingw-w64-x86_64-rocksdb
+            mingw-w64-x86_64-sqlite3
+            mingw-w64-x86_64-autotools
 
       - name: Set VERSION
         run: |
           if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
             echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_ENV
           else
-            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | awk '{print $3}')
-            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | awk '{print $3}')
-            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | awk '{print $3}')
+            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | tr -d '\r' | awk '{print $3}')
             echo "VERSION=${MAJOR}.${MINOR}.${REV}" >> $GITHUB_ENV
           fi
 
@@ -131,8 +425,17 @@ jobs:
             -DBUILD_QT=ON \
             -DBUILD_DAEMON=OFF \
             -DBUILD_TESTS=OFF \
-            -DUSE_UPNP=ON \
-            -DUSE_QRCODE=OFF
+            -DUSE_UPNP=OFF \
+            -DUSE_QRCODE=OFF \
+            -DUSE_I2P_EMBEDDED=ON
+
+      - name: Build libtor (embedded Tor static lib)
+        # Windows Qt GUI also transitively links -ltor via triangles_common.
+        # msys2 default install puts everything in /mingw64.
+        run: bash src/tor/build-libtor.sh
+
+      - name: Build libi2pd (embedded I2P static lib)
+        run: bash src/i2p/build-libi2pd.sh
 
       - name: Build
         run: cmake --build build -j$(nproc)
@@ -195,12 +498,61 @@ jobs:
           echo "=== dist/ contents ==="
           find dist/ -type f | head -50
 
+      - name: Upload portable wallet zip
+        # Portable Windows GUI wallet ZIP — what users extract to a folder
+        # and run triangles-qt.exe directly. This is what the Chocolatey
+        # package and most manual downloads expect.
+        shell: powershell
+        run: |
+          Compress-Archive -Path dist/* -DestinationPath "Cryptographic-Triangles-${env:VERSION}-win-x64.zip" -Force
+          echo "Created Cryptographic-Triangles-${env:VERSION}-win-x64.zip"
+          Get-Item "Cryptographic-Triangles-${env:VERSION}-win-x64.zip"
+
+      - name: Upload artifact (portable zip)
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: windows-qt-zip
+          path: Cryptographic-Triangles-*-win-x64.zip
+
       - name: Download Tor
+        # Resilient download: archive.torproject.org occasionally times out
+        # from CI egress (observed 2026-07-03: macOS job exit code 6 after
+        # exactly 30s of curl hang). Retries cover transient connection drops;
+        # size check rejects 0-byte "200 OK" responses from broken mirrors.
+        # NOTE: Invoke-WebRequest on PowerShell 5.1 (default on Windows-latest
+        # runners) does NOT accept -ConnectionTimeout/-OperationTimeout — those
+        # are PowerShell 7+. We rely on the retry loop + size check only.
         shell: powershell
         run: |
           $TOR_VERSION = "15.0.9"
+          $TOR_SHA256 = "adebc1b7c65dc1b5e471064ed17585464af6f6198c3fe5c8c9108138b59ccf65"
           $TOR_URL = "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-windows-x86_64-${TOR_VERSION}.tar.gz"
-          Invoke-WebRequest -Uri $TOR_URL -OutFile tor-bundle.tar.gz
+          $torPath = "tor-bundle.tar.gz"
+          $attempts = 0
+          $maxAttempts = 3
+          $downloaded = $false
+          while ($attempts -lt $maxAttempts -and -not $downloaded) {
+            $attempts++
+            try {
+              if (Test-Path $torPath) { Remove-Item $torPath -ErrorAction SilentlyContinue }
+              Invoke-WebRequest -Uri $TOR_URL -OutFile $torPath -UseBasicParsing
+              $size = (Get-Item $torPath).Length
+              if ($size -gt 1MB) {
+                Write-Host "Downloaded $size bytes on attempt $attempts"
+                $downloaded = $true
+              } else {
+                Write-Host "Download too small ($size bytes), retrying..."
+              }
+            } catch {
+              Write-Host "Download attempt $attempts failed: $_"
+              Start-Sleep -Seconds 5
+            }
+          }
+          if (-not $downloaded) { throw "Tor bundle download failed after $maxAttempts attempts" }
+          $actualSha256 = (Get-FileHash -Algorithm SHA256 $torPath).Hash.ToLowerInvariant()
+          if ($actualSha256 -ne $TOR_SHA256) {
+            throw "Tor bundle SHA256 mismatch: expected $TOR_SHA256, got $actualSha256"
+          }
           New-Item -ItemType Directory -Path tor-extract -Force
           tar -xzf tor-bundle.tar.gz -C tor-extract
           New-Item -ItemType Directory -Path tor-files -Force
@@ -217,23 +569,11 @@ jobs:
       - name: Install NSIS via MSYS2
         run: pacman -S --noconfirm mingw-w64-x86_64-nsis
 
-      - name: Install NSIS inetc plugin
-        run: |
-          pacman -S --noconfirm unzip
-          NSIS_DIR="/mingw64/share/nsis"
-          cd /tmp
-          curl -L -o Inetc.zip "https://nsis.sourceforge.io/mediawiki/images/c/c9/Inetc.zip"
-          unzip -o Inetc.zip -d inetc_extract
-          # MSYS2 mingw64 NSIS is 64-bit, needs amd64-unicode plugin in Plugins/unicode/
-          mkdir -p "$NSIS_DIR/Plugins/unicode"
-          cp inetc_extract/Plugins/amd64-unicode/INetC.dll "$NSIS_DIR/Plugins/unicode/"
-          echo "Installed 64-bit INetC.dll to $NSIS_DIR/Plugins/unicode/"
-
       - name: Build NSIS installer
         run: makensis //DVERSION=$VERSION contrib/nsis/setup.nsi
 
       - name: Upload installer
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:
           name: windows-qt-setup
           path: contrib/nsis/Cryptographic-Triangles-*-setup.exe
@@ -244,11 +584,11 @@ jobs:
       run:
         shell: msys2 {0}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           submodules: recursive
 
-      - uses: msys2/setup-msys2@v2
+      - uses: msys2/setup-msys2@66cd2cce69caa17b53920067426061ca1de3a884 # v2
         with:
           msystem: MINGW64
           update: true
@@ -263,6 +603,8 @@ jobs:
             mingw-w64-x86_64-miniupnpc
             mingw-w64-x86_64-zlib
             mingw-w64-x86_64-rocksdb
+            mingw-w64-x86_64-sqlite3
+            mingw-w64-x86_64-autotools
 
       - name: Configure
         run: |
@@ -270,29 +612,68 @@ jobs:
             -DCMAKE_BUILD_TYPE=Release \
             -DBUILD_QT=OFF \
             -DBUILD_DAEMON=ON \
+            -DBUILD_CLI=ON \
             -DBUILD_TESTS=OFF \
-            -DUSE_UPNP=ON
+            -DUSE_UPNP=OFF \
+            -DUSE_I2P_EMBEDDED=ON
+
+      - name: Build libtor (embedded Tor static lib)
+        # Windows: msys2 default install puts everything in /mingw64,
+        # which is exactly the script's default. Just invoke it.
+        # See v5.9.25-fork-detection run #466 for why this is needed.
+        run: bash src/tor/build-libtor.sh
+
+      - name: Build libi2pd (embedded I2P static lib)
+        run: bash src/i2p/build-libi2pd.sh
 
       - name: Build
         run: |
           cmake --build build -j$(nproc)
           strip --strip-all build/bin/trianglesd.exe
+          strip --strip-all build/bin/triangles-cli.exe
 
       - name: Package daemon with DLLs
-        run: |
-          mkdir -p daemon-dist/tor
-          cp build/bin/trianglesd.exe daemon-dist/
-
-          # Copy all linked DLLs from MSYS2
-          ldd build/bin/trianglesd.exe | grep '/mingw64' | awk '{print $3}' | while read dll; do
-            cp "$dll" daemon-dist/ 2>/dev/null || true
-          done
+        run: bash scripts/ci/package-windows-daemon.sh daemon-dist trianglesd triangles-cli
 
       - name: Bundle Tor for daemon
+        # Resilient download: archive.torproject.org occasionally times out
+        # from CI egress (observed 2026-07-03: macOS job exit code 6 after
+        # exactly 30s of curl hang). Retries cover transient connection drops;
+        # size check rejects 0-byte "200 OK" responses from broken mirrors.
+        # NOTE: Invoke-WebRequest on PowerShell 5.1 (default on Windows-latest
+        # runners) does NOT accept -ConnectionTimeout/-OperationTimeout — those
+        # are PowerShell 7+. We rely on the retry loop + size check only.
         shell: powershell
         run: |
           $TOR_VERSION = "15.0.9"
-          Invoke-WebRequest -Uri "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-windows-x86_64-${TOR_VERSION}.tar.gz" -OutFile tor-bundle.tar.gz
+          $TOR_SHA256 = "adebc1b7c65dc1b5e471064ed17585464af6f6198c3fe5c8c9108138b59ccf65"
+          $TOR_URL = "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-windows-x86_64-${TOR_VERSION}.tar.gz"
+          $torPath = "tor-bundle.tar.gz"
+          $attempts = 0
+          $maxAttempts = 3
+          $downloaded = $false
+          while ($attempts -lt $maxAttempts -and -not $downloaded) {
+            $attempts++
+            try {
+              if (Test-Path $torPath) { Remove-Item $torPath -ErrorAction SilentlyContinue }
+              Invoke-WebRequest -Uri $TOR_URL -OutFile $torPath -UseBasicParsing
+              $size = (Get-Item $torPath).Length
+              if ($size -gt 1MB) {
+                Write-Host "Downloaded $size bytes on attempt $attempts"
+                $downloaded = $true
+              } else {
+                Write-Host "Download too small ($size bytes), retrying..."
+              }
+            } catch {
+              Write-Host "Download attempt $attempts failed: $_"
+              Start-Sleep -Seconds 5
+            }
+          }
+          if (-not $downloaded) { throw "Tor bundle download failed after $maxAttempts attempts" }
+          $actualSha256 = (Get-FileHash -Algorithm SHA256 $torPath).Hash.ToLowerInvariant()
+          if ($actualSha256 -ne $TOR_SHA256) {
+            throw "Tor bundle SHA256 mismatch: expected $TOR_SHA256, got $actualSha256"
+          }
           New-Item -ItemType Directory -Path tor-extract -Force
           tar -xzf tor-bundle.tar.gz -C tor-extract
           Copy-Item -Recurse tor-extract/tor/* daemon-dist/tor/
@@ -301,7 +682,7 @@ jobs:
           }
 
       - name: Upload artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:
           name: windows-daemon
           path: daemon-dist/
@@ -309,7 +690,7 @@ jobs:
   build-linux-qt:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           submodules: recursive
 
@@ -318,9 +699,9 @@ jobs:
           if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
             echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_ENV
           else
-            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | awk '{print $3}')
-            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | awk '{print $3}')
-            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | awk '{print $3}')
+            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | tr -d '\r' | awk '{print $3}')
             echo "VERSION=${MAJOR}.${MINOR}.${REV}" >> $GITHUB_ENV
           fi
 
@@ -330,7 +711,11 @@ jobs:
           sudo apt-get install -y build-essential cmake ninja-build \
             qtbase5-dev qttools5-dev-tools \
             libboost-all-dev libssl-dev libdb++-dev \
-            libleveldb-dev librocksdb-dev libevent-dev libminiupnpc-dev zlib1g-dev
+            libleveldb-dev libevent-dev libminiupnpc-dev zlib1g-dev \
+            libsnappy-dev liblz4-dev libzstd-dev
+
+      - name: Build RocksDB from source
+        run: sudo bash scripts/ci/build-rocksdb.sh
 
       - name: Configure
         run: |
@@ -339,7 +724,20 @@ jobs:
             -DBUILD_QT=ON \
             -DBUILD_DAEMON=OFF \
             -DBUILD_TESTS=OFF \
-            -DUSE_UPNP=ON
+            -DUSE_UPNP=OFF \
+            -DUSE_I2P_EMBEDDED=ON
+
+      - name: Build libtor (embedded Tor static lib)
+        # Linux Qt GUI also transitively links -ltor via triangles_common.
+        # build-libtor.sh defaults to /mingw64; pass /usr where the
+        # libevent-dev, libssl-dev, zlib1g-dev packages install.
+        run: |
+          sudo apt-get install -y libevent-dev libssl-dev zlib1g-dev
+          LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+            bash src/tor/build-libtor.sh
+
+      - name: Build libi2pd (embedded I2P static lib)
+        run: bash src/i2p/build-libi2pd.sh
 
       - name: Build
         run: cmake --build build -j$(nproc)
@@ -349,8 +747,18 @@ jobs:
 
       - name: Build .deb package (fully self-contained)
         run: |
+          set -euo pipefail
           TOR_VERSION="15.0.9"
-          curl -sL "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-linux-x86_64-${TOR_VERSION}.tar.gz" -o tor-bundle.tar.gz
+          TOR_SHA256="7ea13e14cddafb36c6347a9c4f4e639f6010364c16acfd519157c29e226277f2"
+          # Resilient download: archive.torproject.org occasionally times out
+          # from CI egress (observed 2026-07-03: macOS job exit code 6 after
+          # exactly 30s of curl hang). Retries + --fail-with-body surface the
+          # next failure loudly instead of silently producing a 0-byte file.
+          curl -fSL --connect-timeout 15 --max-time 120 \
+            --retry 3 --retry-delay 5 --retry-connrefused --retry-all-errors \
+            "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-linux-x86_64-${TOR_VERSION}.tar.gz" \
+            -o tor-bundle.tar.gz
+          printf '%s  %s\n' "$TOR_SHA256" tor-bundle.tar.gz | sha256sum --check --strict -
           mkdir -p tor-extract && tar -xzf tor-bundle.tar.gz -C tor-extract
 
           PKG="cryptographic-triangles_${VERSION}_amd64"
@@ -420,7 +828,7 @@ jobs:
           dpkg-deb --build ${PKG}
 
       - name: Upload .deb
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:
           name: linux-qt-deb
           path: cryptographic-triangles_*_amd64.deb
@@ -428,7 +836,7 @@ jobs:
   build-linux-daemon:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           submodules: recursive
 
@@ -437,9 +845,9 @@ jobs:
           if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
             echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_ENV
           else
-            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | awk '{print $3}')
-            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | awk '{print $3}')
-            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | awk '{print $3}')
+            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | tr -d '\r' | awk '{print $3}')
             echo "VERSION=${MAJOR}.${MINOR}.${REV}" >> $GITHUB_ENV
           fi
 
@@ -448,7 +856,11 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y build-essential cmake ninja-build \
             libboost-all-dev libssl-dev libdb++-dev libleveldb-dev \
-            librocksdb-dev libevent-dev libminiupnpc-dev zlib1g-dev
+            libevent-dev libminiupnpc-dev zlib1g-dev \
+            libsnappy-dev liblz4-dev libzstd-dev
+
+      - name: Build RocksDB from source
+        run: sudo bash scripts/ci/build-rocksdb.sh
 
       - name: Configure
         run: |
@@ -456,103 +868,38 @@ jobs:
             -DCMAKE_BUILD_TYPE=Release \
             -DBUILD_QT=OFF \
             -DBUILD_DAEMON=ON \
+            -DBUILD_CLI=ON \
             -DBUILD_TESTS=OFF \
-            -DUSE_UPNP=ON
+            -DUSE_UPNP=OFF \
+            -DUSE_I2P_EMBEDDED=ON
+
+      - name: Build libtor (embedded Tor static lib)
+        # USE_TOR_EMBEDDED defaults to ON and the daemon/Qt GUI both
+        # link -ltor. The Tor source is a git submodule but libtor.a
+        # is NOT built by cmake. build-libtor.sh defaults to /mingw64
+        # paths which don't exist on the ubuntu-22.04 runner; pass
+        # /usr where libevent-dev/libssl-dev/zlib1g-dev install.
+        run: |
+          sudo apt-get install -y libevent-dev libssl-dev zlib1g-dev
+          LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+            bash src/tor/build-libtor.sh
+
+      - name: Build libi2pd (embedded I2P static lib)
+        run: bash src/i2p/build-libi2pd.sh
 
       - name: Build
         run: cmake --build build -j$(nproc)
 
       - name: Strip binary
-        run: strip --strip-all build/bin/trianglesd
+        run: |
+          strip --strip-all build/bin/trianglesd
+          strip --strip-all build/bin/triangles-cli
 
       - name: Build .deb package (fully self-contained)
-        run: |
-          TOR_VERSION="15.0.9"
-          curl -sL "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-linux-x86_64-${TOR_VERSION}.tar.gz" -o tor-bundle.tar.gz
-          mkdir -p tor-extract && tar -xzf tor-bundle.tar.gz -C tor-extract
-
-          PKG="cryptographic-triangles-daemon_${VERSION}_amd64"
-          mkdir -p ${PKG}/DEBIAN
-          mkdir -p ${PKG}/usr/lib/cryptographic-triangles/lib
-          mkdir -p ${PKG}/usr/lib/cryptographic-triangles/tor
-          mkdir -p ${PKG}/usr/bin
-          mkdir -p ${PKG}/etc/systemd/system
-
-          cp build/bin/trianglesd ${PKG}/usr/lib/cryptographic-triangles/
-          cp tor-extract/tor/tor ${PKG}/usr/lib/cryptographic-triangles/tor/
-          chmod +x ${PKG}/usr/lib/cryptographic-triangles/tor/tor
-          [ -d tor-extract/data ] && cp -r tor-extract/data ${PKG}/usr/lib/cryptographic-triangles/tor/data
-
-          # Bundle ALL shared library dependencies (except glibc/kernel)
-          ldd build/bin/trianglesd | grep '=> /' | awk '{print $3}' | while read lib; do
-            case "$lib" in
-              /lib/x86_64-linux-gnu/libc.so*|/lib/x86_64-linux-gnu/libm.so*|/lib/x86_64-linux-gnu/libpthread.so*|/lib/x86_64-linux-gnu/libdl.so*|/lib/x86_64-linux-gnu/librt.so*|/lib/x86_64-linux-gnu/ld-linux*|/lib64/ld-linux*)
-                ;; # Skip glibc core — always present
-              *)
-                cp -L "$lib" ${PKG}/usr/lib/cryptographic-triangles/lib/ 2>/dev/null || true
-                ;;
-            esac
-          done
-          echo "=== Bundled libs ==="
-          ls ${PKG}/usr/lib/cryptographic-triangles/lib/ | wc -l
-          ls ${PKG}/usr/lib/cryptographic-triangles/lib/
-
-          # Launcher with LD_LIBRARY_PATH
-          cat > ${PKG}/usr/bin/trianglesd << 'LAUNCHER'
-          #!/bin/bash
-          INSTALL_DIR=/usr/lib/cryptographic-triangles
-          export LD_LIBRARY_PATH="${INSTALL_DIR}/lib:${LD_LIBRARY_PATH}"
-          exec "${INSTALL_DIR}/trianglesd" "$@"
-          LAUNCHER
-          sed -i 's/^          //' ${PKG}/usr/bin/trianglesd
-          chmod +x ${PKG}/usr/bin/trianglesd
-
-          cat > ${PKG}/etc/systemd/system/trianglesd.service << 'SVC'
-          [Unit]
-          Description=Cryptographic Triangles Daemon
-          After=network-online.target
-          Wants=network-online.target
-
-          [Service]
-          Type=simple
-          Environment=LD_LIBRARY_PATH=/usr/lib/cryptographic-triangles/lib
-          ExecStart=/usr/lib/cryptographic-triangles/trianglesd
-          Restart=on-failure
-          RestartSec=10
-
-          [Install]
-          WantedBy=multi-user.target
-          SVC
-          sed -i 's/^          //' ${PKG}/etc/systemd/system/trianglesd.service
-
-          cat > ${PKG}/DEBIAN/control << CTRL
-          Package: cryptographic-triangles-daemon
-          Version: ${VERSION}
-          Architecture: amd64
-          Maintainer: Cryptographic Triangles <dev@cryptographic-triangles.org>
-          Description: Cryptographic Triangles daemon with integrated Tor
-           Fully self-contained headless node with all libraries, Tor, and systemd service.
-           No external dependencies required — runs on any x86_64 Linux.
-          Section: finance
-          Priority: optional
-          CTRL
-          sed -i 's/^          //' ${PKG}/DEBIAN/control
-
-          cat > ${PKG}/DEBIAN/postinst << 'POST'
-          #!/bin/bash
-          systemctl daemon-reload
-          echo ""
-          echo "Cryptographic Triangles daemon installed."
-          echo "  Start:     sudo systemctl start trianglesd"
-          echo "  On boot:   sudo systemctl enable trianglesd"
-          echo ""
-          POST
-          chmod +x ${PKG}/DEBIAN/postinst
-
-          dpkg-deb --build ${PKG}
+        run: bash scripts/ci/package-linux-daemon.sh "${VERSION}"
 
       - name: Upload .deb
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:
           name: linux-daemon-deb
           path: cryptographic-triangles-daemon_*_amd64.deb
@@ -560,7 +907,7 @@ jobs:
   build-macos:
     runs-on: macos-15
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
         with:
           submodules: recursive
 
@@ -569,17 +916,22 @@ jobs:
           if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
             echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_ENV
           else
-            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | awk '{print $3}')
-            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | awk '{print $3}')
-            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | awk '{print $3}')
+            MAJOR=$(grep 'CLIENT_VERSION_MAJOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            MINOR=$(grep 'CLIENT_VERSION_MINOR' src/clientversion.h | tr -d '\r' | awk '{print $3}')
+            REV=$(grep 'CLIENT_VERSION_REVISION' src/clientversion.h | tr -d '\r' | awk '{print $3}')
             echo "VERSION=${MAJOR}.${MINOR}.${REV}" >> $GITHUB_ENV
           fi
 
       - name: Install dependencies
         run: |
-          brew install cmake ninja qt@5 openssl@3 boost berkeley-db@5 leveldb rocksdb libevent miniupnpc
+          brew install cmake ninja qt@5 openssl@3 boost berkeley-db@5 leveldb rocksdb libevent miniupnpc zstd
 
       - name: Configure
+        # Add -L/opt/homebrew/lib to the link line so rocksdb's
+        # transitive -lzstd resolves. /opt/homebrew/lib is only in the
+        # rpath (runtime), not the link-time search path, so cmake's
+        # default LIBRARY_PATH propagation isn't enough — we set the
+        # linker flags explicitly.
         run: |
           export PATH="/opt/homebrew/opt/qt@5/bin:$PATH"
           cmake -B build -G Ninja \
@@ -587,7 +939,8 @@ jobs:
             -DBUILD_QT=ON \
             -DBUILD_DAEMON=OFF \
             -DBUILD_TESTS=OFF \
-            -DUSE_UPNP=ON \
+            -DUSE_UPNP=OFF \
+            -DUSE_I2P_EMBEDDED=ON \
             -DBOOST_ROOT=/opt/homebrew/opt/boost \
             -DBDB_INCLUDE_PATH=/opt/homebrew/opt/berkeley-db@5/include \
             -DBDB_LIB_PATH=/opt/homebrew/opt/berkeley-db@5/lib \
@@ -596,7 +949,26 @@ jobs:
             -DEVENT_LIB_PATH=/opt/homebrew/opt/libevent/lib \
             -DMINIUPNPC_INCLUDE_PATH=/opt/homebrew/opt/miniupnpc/include \
             -DMINIUPNPC_LIB_PATH=/opt/homebrew/opt/miniupnpc/lib \
-            -DQt5_DIR=/opt/homebrew/opt/qt@5/lib/cmake/Qt5
+            -DQt5_DIR=/opt/homebrew/opt/qt@5/lib/cmake/Qt5 \
+            -DCMAKE_LIBRARY_PATH=/opt/homebrew/lib \
+            -DCMAKE_EXE_LINKER_FLAGS="-L/opt/homebrew/lib" \
+            -DCMAKE_SHARED_LINKER_FLAGS="-L/opt/homebrew/lib"
+
+      - name: Build libtor (embedded Tor static lib)
+        # macOS Qt GUI also transitively links -ltor via triangles_common.
+        # macOS Qt is built with @rpath embedded, so libtor needs to be
+        # at the configured TOR_SOURCE_ROOT location.
+        run: |
+          brew install libevent openssl@3 autoconf automake libtool zlib zstd
+          export PATH="/opt/homebrew/opt/automake/bin:/opt/homebrew/opt/libtool/bin:$PATH"
+          LIBEVENT_DIR=/opt/homebrew/opt/libevent \
+            OPENSSL_DIR=/opt/homebrew/opt/openssl@3 \
+            ZLIB_DIR=/opt/homebrew/opt/zlib \
+            bash src/tor/build-libtor.sh
+
+      - name: Build libi2pd (embedded I2P static lib)
+        # HOMEBREW=1 tells the i2pd Makefile to use Homebrew paths.
+        run: HOMEBREW=1 bash src/i2p/build-libi2pd.sh
 
       - name: Build
         run: cmake --build build -j$(sysctl -n hw.ncpu)
@@ -642,9 +1014,20 @@ jobs:
           otool -L "$BINARY" | head -30
 
       - name: Bundle Tor into app
+        # Resilient download: archive.torproject.org occasionally times out
+        # from Azure westus egress (observed 2026-07-03: macOS job exit code 6
+        # after exactly 30s of curl hang). --retry 3 with --retry-connrefused
+        # handles transient connection refusals and timeouts; --fail-with-body
+        # surfaces HTTP error bodies so the next failure isn't silent.
         run: |
+          set -euo pipefail
           TOR_VERSION="15.0.9"
-          curl -sL "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-macos-aarch64-${TOR_VERSION}.tar.gz" -o tor-bundle.tar.gz
+          TOR_SHA256="8ab84587b09b0053e85a137969b501744fa14640aa126af6e36997189950d254"
+          curl -fSL --connect-timeout 15 --max-time 120 \
+            --retry 3 --retry-delay 5 --retry-connrefused --retry-all-errors \
+            "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/tor-expert-bundle-macos-aarch64-${TOR_VERSION}.tar.gz" \
+            -o tor-bundle.tar.gz
+          printf '%s  %s\n' "$TOR_SHA256" tor-bundle.tar.gz | shasum -a 256 --check -
           mkdir -p tor-extract && tar -xzf tor-bundle.tar.gz -C tor-extract
           APP=$(find build/bin -name "*.app" -maxdepth 1 | head -1)
           mkdir -p "$APP/Contents/MacOS/tor"
@@ -664,7 +1047,7 @@ jobs:
             "Cryptographic-Triangles-v${VERSION}-macos-arm64.dmg"
 
       - name: Upload DMG
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
         with:
           name: macos-arm64-dmg
           path: "*.dmg"
@@ -680,7 +1063,7 @@ jobs:
         run: echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_ENV
 
       - name: Download all artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
         with:
           path: artifacts
 
@@ -689,6 +1072,8 @@ jobs:
           mkdir -p release
           # Windows Qt installer (setup.exe — includes Tor, Start Menu shortcuts, uninstaller)
           cp artifacts/windows-qt-setup/*.exe release/
+          # Windows Qt portable zip (extract & run — no install required)
+          cp artifacts/windows-qt-zip/*.zip release/
           # Windows daemon (zip with DLLs + Tor)
           cd artifacts/windows-daemon && zip -r "../../release/Cryptographic-Triangles-${VERSION}-win-x64-daemon.zip" . && cd ../..
           # Linux Qt .deb (dpkg -i to install — includes Tor, desktop entry, icon)
@@ -700,13 +1085,17 @@ jobs:
           ls -la release/
 
       - name: Create Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@3bb12739c298aeb8a4eeaf626c5b8d85266b0e65 # v2
         with:
           files: release/*
           generate_release_notes: true
 
   trigger-tripi:
     name: Trigger TRI-PI ARM64 Build
+    # Only fire on tag-push events. To trigger a TRI-PI rebuild after a
+    # release is created via gh API (without re-pushing the tag), use:
+    #   curl -X POST .../repos/SamiAhmed7777/tri-pi/dispatches \
+    #     -d '{"event_type":"new-release","client_payload":{"version":"vX.Y.Z","source_repo":"SamiAhmed7777/triangles_v5"}}'
     if: startsWith(github.ref, 'refs/tags/v')
     needs: release
     runs-on: ubuntu-latest

.github/workflows/distribute.yml

@@ -0,0 +1,670 @@
+name: Distribute Release
+
+# Auto-pushes new releases to package managers. Triggers on:
+#   - tag push (e.g. v5.9.21) — the normal release flow
+#   - workflow_dispatch — manual run for testing or backports
+#
+# Each step that needs a secret checks for it and skips gracefully with a
+# clear warning if it's not set, so the workflow can be merged and tested
+# before secrets are configured.
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Override version (e.g. 5.9.21). Leave blank to use tag.'
+        required: false
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  version:
+    name: Resolve version
+    runs-on: ubuntu-22.04
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/v')
+    outputs:
+      version: ${{ steps.v.outputs.version }}
+    steps:
+      - id: v
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ] && [ -n "${{ inputs.version }}" ]; then
+            echo "version=${{ inputs.version }}" >> $GITHUB_OUTPUT
+          else
+            echo "version=${GITHUB_REF_NAME#v}" >> $GITHUB_OUTPUT
+          fi
+      - run: echo "Distributing v${{ steps.v.outputs.version }}"
+
+  docker:
+    name: Docker Hub
+    needs: version
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: read
+      packages: write
+    env:
+      DOCKERHUB_TOKEN: ${{ secrets.DOCKERHUB_TOKEN }}
+      VERSION: ${{ needs.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Docker Hub
+        run: |
+          if [ -z "$DOCKERHUB_TOKEN" ]; then
+            echo "::warning::DOCKERHUB_TOKEN secret not set — skipping Docker push. Add it at Settings → Secrets → Actions."
+            exit 0
+          fi
+          echo "$DOCKERHUB_TOKEN" | docker login -u samiahmed7777 --password-stdin
+
+      - name: Wait for release artifacts
+        run: |
+          # The Dockerfile downloads the daemon .deb from the release URL.
+          # On tag-push the release is created first, but the assets get
+          # uploaded a few seconds/minutes later by the build job — without
+          # this wait, the Docker build races and fails with curl 22 / 404
+          # (saw this on v5.9.24 run #24, dist #24, Docker Hub job
+          # step #5 — release was published 8 min after the workflow fired).
+          for i in {1..90}; do
+            URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/cryptographic-triangles-daemon_${VERSION}_amd64.deb"
+            if curl -fsSL --head "$URL" >/dev/null 2>&1; then
+              echo "✓ Release .deb available: $URL"
+              exit 0
+            fi
+            echo "  waiting for release v${VERSION} daemon .deb... ($i/90)"
+            sleep 20
+          done
+          echo "::error::Release v${VERSION} daemon .deb never became available after 30 minutes"
+          exit 1
+
+      - name: Build and push
+        run: |
+          if [ -z "$DOCKERHUB_TOKEN" ]; then exit 0; fi
+          docker buildx build \
+            --push \
+            --tag samiahmed7777/trianglesd:$VERSION \
+            --tag samiahmed7777/trianglesd:latest \
+            --cache-from type=gha \
+            --cache-to type=gha,mode=max \
+            --provenance=false \
+            ./packaging/docker
+
+      - name: Verify pushed image
+        run: |
+          if [ -z "$DOCKERHUB_TOKEN" ]; then exit 0; fi
+          docker pull samiahmed7777/trianglesd:$VERSION
+          echo "--- trianglesd -version ---"
+          docker run --rm samiahmed7777/trianglesd:$VERSION trianglesd -version 2>&1 | head -3
+          echo "--- triangles-cli getinfo (will fail without RPC, expected) ---"
+          docker run --rm samiahmed7777/trianglesd:$VERSION triangles-cli getinfo 2>&1 | head -3
+
+  aur:
+    name: AUR (triangles-qt-bin)
+    needs: version
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-22.04
+    container:
+      image: archlinux:latest
+      options: --privileged
+    env:
+      AUR_SSH_KEY: ${{ secrets.AUR_SSH_KEY }}
+      VERSION: ${{ needs.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check AUR_SSH_KEY
+        run: |
+          if [ -z "$AUR_SSH_KEY" ]; then
+            echo "::warning::AUR_SSH_KEY secret not set — skipping AUR push. Add it at Settings → Secrets → Actions."
+            echo "::warning::The key should be the contents of ~/.ssh/aur_key (private key, not .pub)."
+          fi
+
+      - name: Install build tools + create non-root user
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          pacman -Syu --noconfirm --needed git openssh base-devel python sudo
+          # makepkg refuses to run as root — create a build user
+          useradd -m -s /bin/bash build
+          echo 'build ALL=(ALL) NOPASSWD: ALL' >> /etc/sudoers
+          chown -R build:build "$GITHUB_WORKSPACE"
+
+      - name: Wait for release artifacts
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          for i in {1..90}; do
+            URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/cryptographic-triangles_${VERSION}_amd64.deb"
+            if curl -fsSL --head "$URL" >/dev/null 2>&1; then
+              echo "✓ Release .deb available: $URL"
+              exit 0
+            fi
+            echo "  waiting for release v${VERSION}... ($i/90)"
+            sleep 20
+          done
+          echo "::error::Release v${VERSION} .deb never became available after 30 minutes"
+          exit 1
+
+      - name: Download source .debs
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          cd /tmp
+          curl -fsSL -o full.deb "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/cryptographic-triangles_${VERSION}_amd64.deb"
+          curl -fsSL -o daemon.deb "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/cryptographic-triangles-daemon_${VERSION}_amd64.deb"
+          ls -la /tmp/*.deb
+          sha256sum /tmp/full.deb /tmp/daemon.deb
+
+      - name: Update PKGBUILD with version + SHA256s
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          cp "$GITHUB_WORKSPACE/packaging/aur/PKGBUILD" /tmp/PKGBUILD
+          chown build:build /tmp/PKGBUILD /tmp/full.deb /tmp/daemon.deb
+          sudo -u build bash -c '
+            set -e
+            cd /tmp
+            FULL_SHA=$(sha256sum full.deb | awk "{print \$1}")
+            DAEMON_SHA=$(sha256sum daemon.deb | awk "{print \$1}")
+            echo "version='"$VERSION"' full=$FULL_SHA daemon=$DAEMON_SHA"
+            python3 - <<PYEOF
+          import re
+          with open("/tmp/PKGBUILD") as f:
+              content = f.read()
+          content = re.sub(r"^pkgver=.*", "pkgver='"$VERSION"'", content, count=1, flags=re.MULTILINE)
+          new_shas = """sha256sums=(
+              '"'"'$FULL_SHA'"'"'
+              '"'"'$DAEMON_SHA'"'"'
+              '"'"'SKIP'"'"'
+          )"""
+          content = re.sub(r"sha256sums=\(.*?\)", new_shas, content, count=1, flags=re.DOTALL)
+          with open("/tmp/PKGBUILD", "w") as f:
+              f.write(content)
+          PYEOF
+            echo "--- updated PKGBUILD (pkgver + sha256sums) ---"
+            grep -E "^(pkgver|sha256sums)" /tmp/PKGBUILD
+          '
+
+      - name: Generate .SRCINFO via makepkg
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          cp /tmp/full.deb "/tmp/cryptographic-triangles_${VERSION}_amd64.deb"
+          cp /tmp/daemon.deb "/tmp/cryptographic-triangles-daemon_${VERSION}_amd64.deb"
+          chown build:build /tmp/PKGBUILD /tmp/cryptographic-triangles-*.deb
+          sudo -u build bash -c '
+            cd /tmp
+            makepkg --printsrcinfo > .SRCINFO
+            echo "--- generated .SRCINFO ---"
+            cat .SRCINFO
+          '
+
+      - name: Setup SSH key for AUR
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          mkdir -p /home/build/.ssh
+          printf '%s\n' "$AUR_SSH_KEY" > /home/build/.ssh/aur_key
+          chmod 600 /home/build/.ssh/aur_key
+          ssh-keyscan -t ed25519 aur.archlinux.org > /home/build/.ssh/known_hosts 2>/dev/null
+          chown -R build:build /home/build/.ssh
+
+      - name: Clone AUR repo
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          sudo -u build bash -c '
+            cd /tmp
+            GIT_SSH_COMMAND="ssh -i ~/.ssh/aur_key -o IdentitiesOnly=yes" \
+              git clone ssh://aur@aur.archlinux.org/triangles-qt-bin.git
+            ls -la /tmp/triangles-qt-bin
+          '
+
+      - name: Stage updated files
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          cp /tmp/PKGBUILD /tmp/triangles-qt-bin/PKGBUILD
+          cp /tmp/.SRCINFO /tmp/triangles-qt-bin/.SRCINFO
+          cp "$GITHUB_WORKSPACE/packaging/aur/triangles-qt.desktop" /tmp/triangles-qt-bin/triangles-qt.desktop
+          chown -R build:build /tmp/triangles-qt-bin
+          sudo -u build bash -c '
+            cd /tmp/triangles-qt-bin
+            git --no-pager diff --stat
+          '
+
+      - name: Commit and push to AUR
+        if: env.AUR_SSH_KEY != ''
+        run: |
+          sudo -u build bash -c '
+            cd /tmp/triangles-qt-bin
+            git config user.name "Sami Ahmed"
+            git config user.email "SamiAhmed7777@users.noreply.github.com"
+            git add PKGBUILD .SRCINFO triangles-qt.desktop
+            if git diff --cached --quiet; then
+              echo "No changes to commit (AUR already at this version)"
+              exit 0
+            fi
+            git commit -m "triangles-qt-bin '"$VERSION"'-1"
+            GIT_SSH_COMMAND="ssh -i ~/.ssh/aur_key -o IdentitiesOnly=yes" \
+              git push origin master
+          '
+
+      - name: ✓ Summary
+        if: always()
+        run: |
+          if [ -z "$AUR_SSH_KEY" ]; then
+            echo "::notice::AUR job was skipped because AUR_SSH_KEY is not set."
+          else
+            echo "::notice::AUR distribution completed."
+          fi
+
+  homebrew:
+    name: Homebrew tap (SamiAhmed7777/homebrew-triangles)
+    needs: version
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-22.04
+    env:
+      HOMEBREW_GITHUB_TOKEN: ${{ secrets.HOMEBREW_GITHUB_TOKEN }}
+      VERSION: ${{ needs.version.outputs.version }}
+    steps:
+      - name: Check HOMEBREW_GITHUB_TOKEN
+        run: |
+          if [ -z "$HOMEBREW_GITHUB_TOKEN" ]; then
+            echo "::warning::HOMEBREW_GITHUB_TOKEN secret not set — skipping Homebrew push. Add it at Settings → Secrets → Actions."
+            echo "::warning::Use a GitHub PAT with 'repo' scope for SamiAhmed7777/homebrew-triangles."
+          fi
+
+      - name: Wait for release artifacts
+        if: env.HOMEBREW_GITHUB_TOKEN != ''
+        run: |
+          for i in {1..90}; do
+            URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-v${VERSION}-macos-arm64.dmg"
+            if curl -fsSL --head "$URL" >/dev/null 2>&1; then
+              echo "✓ Release .dmg available: $URL"
+              exit 0
+            fi
+            echo "  waiting for release v${VERSION}... ($i/90)"
+            sleep 20
+          done
+          echo "::error::Release v${VERSION} macOS .dmg never became available after 30 minutes"
+          exit 1
+
+      - name: Compute macOS .dmg SHA256
+        if: env.HOMEBREW_GITHUB_TOKEN != ''
+        id: sha
+        run: |
+          curl -fsSL -o /tmp/triangles.dmg \
+            "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-v${VERSION}-macos-arm64.dmg"
+          SHA=$(sha256sum /tmp/triangles.dmg | awk '{print $1}')
+          echo "sha=$SHA" >> $GITHUB_OUTPUT
+          echo "macOS .dmg SHA256: $SHA"
+
+      - name: Clone homebrew-triangles
+        if: env.HOMEBREW_GITHUB_TOKEN != ''
+        run: |
+          git clone https://x-access-token:$HOMEBREW_GITHUB_TOKEN@github.com/SamiAhmed7777/homebrew-triangles.git /tmp/homebrew-triangles
+          cd /tmp/homebrew-triangles
+          git --no-pager log --oneline | head -3
+
+      - name: Update Formula and Cask
+        if: env.HOMEBREW_GITHUB_TOKEN != ''
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+          SHA: ${{ steps.sha.outputs.sha }}
+        run: |
+          cd /tmp/homebrew-triangles
+          # Update Casks/cryptographic-triangles.rb
+          python3 - <<PYEOF
+          import re
+          for path, old_v_pat, old_sha_pat in [
+              ('Casks/cryptographic-triangles.rb', r'^\s*version\s+"[\d.]+"', r'^\s*sha256\s+"[a-f0-9]+"'),
+              ('Formula/triangles.rb',             r'^\s*version\s+"[\d.]+"', r'^\s*sha256\s+"[a-f0-9]+"'),
+          ]:
+              with open(path) as f: content = f.read()
+              content = re.sub(old_v_pat, f'  version "$VERSION"', content, count=1, flags=re.MULTILINE)
+              content = re.sub(old_sha_pat, f'  sha256 "$SHA"', content, count=1, flags=re.MULTILINE)
+              with open(path, 'w') as f: f.write(content)
+          PYEOF
+          cat Formula/triangles.rb | head -5
+          echo "---"
+          cat Casks/cryptographic-triangles.rb | head -5
+          git --no-pager diff --stat
+
+      - name: Commit and push
+        if: env.HOMEBREW_GITHUB_TOKEN != ''
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+        run: |
+          cd /tmp/homebrew-triangles
+          git config user.name "Sami Ahmed"
+          git config user.email "SamiAhmed7777@users.noreply.github.com"
+          git add Formula/triangles.rb Casks/cryptographic-triangles.rb
+          if git diff --cached --quiet; then
+            echo "No changes to commit (Homebrew tap already at this version)"
+            exit 0
+          fi
+          git commit -m "triangles ${VERSION}"
+          git push origin main
+
+      - name: ✓ Summary
+        if: always()
+        run: |
+          if [ -z "$HOMEBREW_GITHUB_TOKEN" ]; then
+            echo "::notice::Homebrew job was skipped because HOMEBREW_GITHUB_TOKEN is not set."
+          else
+            echo "::notice::Homebrew distribution completed."
+          fi
+
+  chocolatey:
+    name: Chocolatey (triangles)
+    needs: version
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: windows-latest
+    env:
+      CHOCO_API_KEY: ${{ secrets.CHOCO_API_KEY }}
+      VERSION: ${{ needs.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check CHOCO_API_KEY + CHOCO_SKIP_WACATAC
+        shell: bash
+        run: |
+          if [ -z "$CHOCO_API_KEY" ]; then
+            echo "::warning::CHOCO_API_KEY not set — skipping Chocolatey push."
+          fi
+          if [ "$CHOCO_SKIP_WACATAC" != "" ]; then
+            echo "::warning::CHOCO_SKIP_WACATAC=$CHOCO_SKIP_WACATAC — skipping Chocolatey push (Wacatac still active)."
+          fi
+
+      - name: Wait for release artifacts
+        if: env.CHOCO_API_KEY != '' && env.CHOCO_SKIP_WACATAC != ''
+        shell: bash
+        run: |
+          for i in {1..90}; do
+            URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-${VERSION}-win-x64-setup.exe"
+            if curl -fsSL --head "$URL" >/dev/null 2>&1; then
+              echo "✓ Release .exe available: $URL"
+              exit 0
+            fi
+            echo "  waiting for release v${VERSION}... ($i/90)"
+            sleep 20
+          done
+          echo "::error::Release v${VERSION} Windows installer never became available after 30 minutes"
+          exit 1
+
+      - name: Compute installer SHA256
+        if: env.CHOCO_API_KEY != '' && env.CHOCO_SKIP_WACATAC != ''
+        shell: bash
+        id: sha
+        run: |
+          curl -fsSL -o /tmp/triangles-setup.exe \
+            "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-${VERSION}-win-x64-setup.exe"
+          SHA=$(sha256sum /tmp/triangles-setup.exe | awk '{print $1}')
+          echo "sha=$SHA" >> $GITHUB_OUTPUT
+          echo "Chocolatey installer SHA256: $SHA"
+
+      - name: Update nuspec version
+        if: env.CHOCO_API_KEY != '' && env.CHOCO_SKIP_WACATAC != ''
+        shell: bash
+        working-directory: ${{ github.workspace }}/packaging/chocolatey
+        run: |
+          python3 -c "
+          import re
+          with open('triangles.nuspec') as f: c = f.read()
+          c = re.sub(r'<version>[\d.]+</version>', f'<version>${VERSION}</version>', c)
+          with open('triangles.nuspec', 'w') as f: f.write(c)
+          print('updated nuspec version to', '${VERSION}')
+          "
+          grep -E "<version>|<id>" triangles.nuspec
+
+      - name: Update nuspec version + install script SHA
+        if: env.CHOCO_API_KEY != '' && env.CHOCO_SKIP_WACATAC != ''
+        shell: bash
+        working-directory: ${{ github.workspace }}/packaging/chocolatey
+        run: |
+          python3 -c "
+          import re
+          with open('triangles.nuspec') as f: c = f.read()
+          c = re.sub(r'<version>[\d.]+</version>', f'<version>${VERSION}</version>', c)
+          with open('triangles.nuspec', 'w') as f: f.write(c)
+          with open('tools/chocolateyInstall.ps1') as f: c = f.read()
+          c = c.replace('__CHECKSUM_PLACEHOLDER__', '${{ steps.sha.outputs.sha }}')
+          with open('tools/chocolateyInstall.ps1', 'w') as f: f.write(c)
+          print('updated nuspec version + install script checksum')
+          "
+          grep -E "<version>|<id>" triangles.nuspec
+          grep checksum64 tools/chocolateyInstall.ps1
+
+      - name: Pack Chocolatey package
+        if: env.CHOCO_API_KEY != '' && env.CHOCO_SKIP_WACATAC != ''
+        shell: pwsh
+        working-directory: ${{ github.workspace }}/packaging/chocolatey
+        run: |
+          choco pack
+          Get-ChildItem *.nupkg
+
+      - name: Push to Chocolatey
+        if: env.CHOCO_API_KEY != '' && env.CHOCO_SKIP_WACATAC != ''
+        shell: pwsh
+        working-directory: ${{ github.workspace }}/packaging/chocolatey
+        run: |
+          $apiKey = [System.Environment]::GetEnvironmentVariable('CHOCO_API_KEY', 'Process')
+          choco apikey add --key="$apiKey" --source='https://push.chocolatey.org/'
+          Get-ChildItem *.nupkg | ForEach-Object {
+            Write-Host "Pushing $($_.Name)..."
+            choco push $_.Name --source='https://push.chocolatey.org/'
+          }
+
+      - name: ✓ Summary
+        if: always()
+        shell: bash
+        run: |
+          if [ -z "$CHOCO_API_KEY" ]; then
+            echo "::notice::Chocolatey job skipped (CHOCO_API_KEY not set)."
+          elif [ -n "$CHOCO_SKIP_WACATAC" ]; then
+            echo "::notice::Chocolatey job skipped (Wacatac detection still active). Set CHOCO_SKIP_WACATAC='' and re-run after Microsoft clears the false-positive."
+          else
+            echo "::notice::Chocolatey push completed (subject to moderator review)."
+          fi
+
+  winget:
+    name: WinGet (CryptographicTriangles.TrianglesQt)
+    needs: version
+    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-22.04
+    env:
+      WINGET_TOKEN: ${{ secrets.WINGET_TOKEN }}
+      VERSION: ${{ needs.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check WINGET_TOKEN
+        run: |
+          if [ -z "$WINGET_TOKEN" ]; then
+            echo "::warning::WINGET_TOKEN not set — skipping WinGet PR. Add a GitHub PAT with 'public_repo' scope at Settings → Secrets → Actions."
+          fi
+
+      - name: Wait for release artifacts
+        if: env.WINGET_TOKEN != ''
+        run: |
+          for i in {1..90}; do
+            URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-${VERSION}-win-x64-setup.exe"
+            if curl -fsSL --head "$URL" >/dev/null 2>&1; then
+              echo "✓ Release .exe available: $URL"
+              exit 0
+            fi
+            echo "  waiting for release v${VERSION}... ($i/90)"
+            sleep 20
+          done
+          echo "::error::Release v${VERSION} Windows installer never became available after 30 minutes"
+          exit 1
+
+      - name: Compute installer SHA256
+        if: env.WINGET_TOKEN != ''
+        id: sha
+        run: |
+          curl -fsSL -o /tmp/triangles-setup.exe \
+            "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-${VERSION}-win-x64-setup.exe"
+          SHA=$(sha256sum /tmp/triangles-setup.exe | awk '{print $1}')
+          echo "sha=$SHA" >> $GITHUB_OUTPUT
+          echo "WinGet installer SHA256: $SHA"
+
+      - name: "Pre-flight check for existing failed WinGet PRs"
+        if: env.WINGET_TOKEN != ''
+        env:
+          GH_TOKEN: ${{ secrets.WINGET_TOKEN }}
+        run: |
+          set -e
+          # Don't pile up PRs if previous ones still have author-action-needed flags.
+          # winget-pkgs moderators can read repeated unfixed failures as spam.
+          # Skip the PR for this release if any existing SamiAhmed7777 PR against
+          # microsoft/winget-pkgs has a blocker label.
+          echo "Checking existing open PRs from SamiAhmed7777 on microsoft/winget-pkgs..."
+          BLOCKING=$(gh api -X GET \
+            'repos/microsoft/winget-pkgs/issues?state=open&labels=PullRequest-Error,Needs-Author-Feedback&per_page=30' \
+            --jq '.[] | select(.user.login=="SamiAhmed7777") | "#\(.number) [\(.state)] \(.title)"' \
+            || echo "")
+          if [ -n "$BLOCKING" ]; then
+            echo "::error::Existing WinGet PR(s) with blocker labels — fix or close those first:"
+            echo "$BLOCKING"
+            echo "::error::Aborting this WinGet submission to avoid piling up failed PRs."
+            exit 1
+          fi
+          echo "✓ No blocker-labelled PRs found — safe to submit."
+
+      - name: Fork + update WinGet manifest + open PR
+        if: env.WINGET_TOKEN != ''
+        env:
+          GH_TOKEN: ${{ secrets.WINGET_TOKEN }}
+          SHA: ${{ steps.sha.outputs.sha }}
+          PUBLISHER_INITIAL: c
+          PACKAGE_ID: CryptographicTriangles.TrianglesQt
+          PACKAGE_SHORT: TrianglesQt
+          INSTALLER_URL: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${{ env.VERSION }}/Cryptographic-Triangles-${{ env.VERSION }}-win-x64-setup.exe
+        run: |
+          set -e
+          # Install gh + jq if missing
+          which gh >/dev/null 2>&1 || (curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list >/dev/null && sudo apt update && sudo apt install -y gh jq)
+
+          # Skip if a PR for THIS version already exists (avoid duplicate submissions).
+          echo "Checking for existing PR for version ${VERSION}..."
+          if gh api 'repos/microsoft/winget-pkgs/pulls?state=open&per_page=30' \
+              --jq ".[] | select(.head.ref | startswith(\"triangles-${VERSION}-\")) | .number" \
+              | grep -q .; then
+            echo "::notice::PR for v${VERSION} already exists — skipping to avoid duplicate."
+            exit 0
+          fi
+          echo "✓ No existing PR for v${VERSION}."
+
+          VERSION="$VERSION"
+          # Path convention (winget-pkgs): lowercase first letter of publisher,
+          # then publisher folder (PascalCase), then short package folder name.
+          # Example: manifests/c/CryptographicTriangles/TrianglesQt/5.9.20/
+          MANIFEST_DIR="manifests/$PUBLISHER_INITIAL/CryptographicTriangles/$PACKAGE_SHORT/$VERSION"
+
+          # TrianglesQt is built with NSIS (Nullsoft). Standard silent flag is /S.
+          # If the installer tech ever changes, update InstallerSwitches here.
+          NSIS_SILENT="/S"
+          
+          # 1. Clone the winget-pkgs repo (Sami's fork) — auto-create fork if needed
+          echo "Forking microsoft/winget-pkgs..."
+          GH_REPO="SamiAhmed7777/winget-pkgs"
+          if ! gh repo view "$GH_REPO" >/dev/null 2>&1; then
+            gh repo fork microsoft/winget-pkgs --remote=false || true
+          fi
+          rm -rf winget-pkgs
+          git clone --depth 1 "https://x-access-token:${WINGET_TOKEN}@github.com/${GH_REPO}.git" winget-pkgs
+          cd winget-pkgs
+          git config user.name "Sami Ahmed"
+          git config user.email "SamiAhmed7777@users.noreply.github.com"
+          
+          BRANCH="triangles-${VERSION}-${{ github.run_number }}"
+          git checkout -b "$BRANCH"
+          
+          mkdir -p "$MANIFEST_DIR"
+
+          # 2. Generate the three manifest files (winget-pkgs schema 1.12.0)
+          #
+          # Schema rules (see doc/manifest/schema/1.12.0/*.md and
+          # doc/ValidationFailureGuide.md):
+          #   - version file: PackageIdentifier, PackageVersion, DefaultLocale
+          #     (NOT PackageLocale — that's the old field name), ManifestType
+          #     "version", ManifestVersion "1.12.0"
+          #   - defaultLocale file: Publisher, PackageName, License,
+          #     ShortDescription are REQUIRED (no Publisher in version file)
+          #   - installer file: InstallModes array (not "InstallerMode:
+          #     interactive" — that's the old field name); ManifestVersion 1.12.0
+          #   - All files: include # yaml-language-server: $schema=... comment
+          #     for editor + validator support
+
+          SCHEMA_BASE="https://raw.githubusercontent.com/microsoft/winget-cli/master/schemas/JSON/manifests/v1.12.0"
+
+          cat > "$MANIFEST_DIR/${PACKAGE_ID}.yaml" <<EOF
+          # yaml-language-server: \$schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json
+          PackageIdentifier: ${PACKAGE_ID}
+          PackageVersion: ${VERSION}
+          DefaultLocale: en-US
+          ManifestType: version
+          ManifestVersion: 1.12.0
+          EOF
+
+          cat > "$MANIFEST_DIR/${PACKAGE_ID}.locale.en-US.yaml" <<EOF
+          # yaml-language-server: \$schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json
+          PackageIdentifier: ${PACKAGE_ID}
+          PackageVersion: ${VERSION}
+          PackageLocale: en-US
+          Publisher: Cryptographic Triangles
+          PublisherUrl: https://cryptographic-triangles.org
+          PackageName: Cryptographic Triangles Qt Wallet
+          License: MIT
+          ShortDescription: Privacy-focused cryptocurrency wallet with PoS staking, Tor v3, and encrypted messaging.
+          Description: |-
+            Cryptographic Triangles (TRI) is a privacy-focused cryptocurrency
+            featuring Proof-of-Stake consensus with 33% annual staking rewards,
+            Tor v3 onion routing, and built-in encrypted peer-to-peer messaging.
+            Originally launched in July 2014, featuring the unique Hash9 algorithm
+            (13-step hash cascade).
+          ManifestType: defaultLocale
+          ManifestVersion: 1.12.0
+          EOF
+
+          cat > "$MANIFEST_DIR/${PACKAGE_ID}.installer.yaml" <<EOF
+          # yaml-language-server: \$schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json
+          PackageIdentifier: ${PACKAGE_ID}
+          PackageVersion: ${VERSION}
+          InstallModes:
+            - interactive
+            - silent
+          InstallerSwitches:
+            Silent: /S
+            SilentWithProgress: /S
+          Installers:
+            - Architecture: x64
+              InstallerType: exe
+              InstallerUrl: ${INSTALLER_URL}
+              InstallerSha256: ${SHA}
+          ManifestType: installer
+          ManifestVersion: 1.12.0
+          EOF
+
+          git add "$MANIFEST_DIR"
+          git commit -m "${PACKAGE_ID} version ${VERSION}"
+          git push origin "$BRANCH"
+          
+          # 3. Open PR
+          gh pr create \
+            --repo microsoft/winget-pkgs \
+            --head "SamiAhmed7777:${BRANCH}" \
+            --base master \
+            --title "${PACKAGE_ID} version ${VERSION}" \
+            --body "Automated update of ${PACKAGE_ID} to v${VERSION}. Artifacts at ${INSTALLER_URL} (SHA256: ${SHA})."
+          
+          echo "✓ PR opened"
+
+      - name: ✓ Summary
+        if: always()
+        run: |
+          if [ -z "$WINGET_TOKEN" ]; then
+            echo "::notice::WinGet job skipped (WINGET_TOKEN not set)."
+          else
+            echo "::notice::WinGet PR opened."
+          fi

.github/workflows/lint.yml

@@ -26,12 +26,20 @@ jobs:
 
       - name: Check format on changed lines
         run: |
-          BASE_SHA=$(git merge-base origin/${{ github.base_ref }} HEAD)
-          echo "Comparing against merge-base: $BASE_SHA"
+          # Diff-only on PRs (have a base_ref). On workflow_dispatch, base_ref is
+          # empty — in that case run clang-format on the whole tree so a manual
+          # trigger still produces a useful signal instead of erroring out.
+          if [ -n "${{ github.base_ref }}" ]; then
+            BASE_SHA=$(git merge-base "origin/${{ github.base_ref }}" HEAD)
+            echo "Comparing against merge-base: $BASE_SHA"
 
-          # git-clang-format prints a diff if any changed line violates style.
-          # --diff exits non-zero when reformatting would change something.
-          OUTPUT=$(git clang-format --diff "$BASE_SHA" -- '*.cpp' '*.h' '*.hpp' '*.cc' || true)
+            # git-clang-format prints a diff if any changed line violates style.
+            # --diff exits non-zero when reformatting would change something.
+            OUTPUT=$(git clang-format --diff "$BASE_SHA" -- '*.cpp' '*.h' '*.hpp' '*.cc' || true)
+          else
+            echo "No base_ref (workflow_dispatch) — running clang-format on whole tree"
+            OUTPUT=$(git clang-format --diff $(git rev-list --max-parents=0 HEAD | head -1) -- '*.cpp' '*.h' '*.hpp' '*.cc' || true)
+          fi
 
           if [ -z "$OUTPUT" ] || [ "$OUTPUT" = "no modified files to format" ] || [ "$OUTPUT" = "clang-format did not modify any files" ]; then
             echo "clang-format: clean"
@@ -49,15 +57,24 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          submodules: recursive
 
       - name: Install dependencies + clang-tidy
         run: |
           sudo apt-get update
           sudo apt-get install -y build-essential cmake ninja-build clang-tidy-15 \
             libboost-all-dev libssl-dev libdb++-dev libleveldb-dev \
-            librocksdb-dev libevent-dev libminiupnpc-dev zlib1g-dev
+            libevent-dev libminiupnpc-dev zlib1g-dev \
+            libsnappy-dev liblz4-dev libzstd-dev
           sudo ln -sf /usr/bin/clang-tidy-15 /usr/local/bin/clang-tidy
 
+      - name: Build RocksDB from source
+        # Ubuntu 22.04's librocksdb-dev is 6.11.4 which CMakeLists.txt now
+        # refuses to configure against (need >= 7.4 for XXH3 per-block
+        # checksum). Build 8.9.1 from source — same version DNS2 ships —
+        # into /usr/local so CMake's find_library picks it up first.
+        run: sudo bash scripts/ci/build-rocksdb.sh
+
       - name: Configure (export compile_commands.json)
         run: |
           cmake -B build -G Ninja \
@@ -74,9 +91,6 @@ jobs:
 
       - name: Run clang-tidy on changed lines
         run: |
-          BASE_SHA=$(git merge-base origin/${{ github.base_ref }} HEAD)
-          echo "Comparing against merge-base: $BASE_SHA"
-
           # clang-tidy-diff.py ships with clang-tidy; runs tidy only on changed lines.
           DIFF_SCRIPT=$(dpkg -L clang-tidy-15 | grep clang-tidy-diff.py | head -1)
           if [ -z "$DIFF_SCRIPT" ]; then
@@ -84,17 +98,42 @@ jobs:
           fi
           echo "Using: $DIFF_SCRIPT"
 
+          if [ -n "${{ github.base_ref }}" ]; then
+            BASE_SHA=$(git merge-base "origin/${{ github.base_ref }}" HEAD)
+            echo "Comparing against merge-base: $BASE_SHA"
+            git diff -U0 "$BASE_SHA" -- 'src/*.cpp' 'src/*.h' \
+              ':(exclude)src/json/nlohmann_json.hpp' \
+              ':(exclude)src/leveldb/*' \
+              ':(exclude)src/lz4/*' \
+              ':(exclude)src/tor/tor-src/*' > /tmp/changes.diff
+          else
+            echo "No base_ref (workflow_dispatch) — running clang-tidy on whole tree"
+            git diff -U0 -- $(git rev-list --max-parents=0 HEAD | head -1)..HEAD -- 'src/*.cpp' 'src/*.h' \
+              ':(exclude)src/json/nlohmann_json.hpp' \
+              ':(exclude)src/leveldb/*' \
+              ':(exclude)src/lz4/*' \
+              ':(exclude)src/tor/tor-src/*' > /tmp/changes.diff || true
+            # If the initial commit was so old that the diff is empty, fall back to HEAD vs HEAD~100
+            if [ ! -s /tmp/changes.diff ]; then
+              git diff -U0 HEAD~100..HEAD -- 'src/*.cpp' 'src/*.h' \
+                ':(exclude)src/json/nlohmann_json.hpp' \
+                ':(exclude)src/leveldb/*' \
+                ':(exclude)src/lz4/*' \
+                ':(exclude)src/tor/tor-src/*' > /tmp/changes.diff || true
+            fi
+          fi
+
+          if [ ! -s /tmp/changes.diff ]; then
+            echo "No changes to lint in dispatch context — skipping"
+            exit 0
+          fi
+
           # -p1 strips the leading "a/"/"b/" from git diff paths.
           # -path=build points clang-tidy at compile_commands.json.
           # -iregex restricts to project sources (not vendored).
-          git diff -U0 "$BASE_SHA" -- 'src/*.cpp' 'src/*.h' \
-            ':(exclude)src/json/nlohmann_json.hpp' \
-            ':(exclude)src/leveldb/*' \
-            ':(exclude)src/lz4/*' \
-            ':(exclude)src/tor/tor-src/*' \
-            | python3 "$DIFF_SCRIPT" -p1 -path build \
-                -iregex '.*\.(cpp|cc|h|hpp)$' \
-                -j$(nproc) || EXIT=$?
+          cat /tmp/changes.diff | python3 "$DIFF_SCRIPT" -p1 -path build \
+              -iregex '.*\.(cpp|cc|h|hpp)$' \
+              -j$(nproc) || EXIT=$?
 
           # Warn-only initially. Flip this to `exit ${EXIT:-0}` once we're clean.
           exit 0

.github/workflows/trigger-tridock-rebuild.yml

@@ -0,0 +1,104 @@
+# trigger-tridock-rebuild.yml
+#
+# Triangles v5.9.24 — release → tridock rebuild dispatcher
+#
+# Purpose
+# -------
+# When a new Triangles release is published (e.g. v5.9.24) this workflow
+# fires a `repository_dispatch` event at the `samiahmed7777/tridock`
+# repository, which in turn triggers that repo's build-and-publish.yml to
+# bake the new Triangles binary into a fresh `samiahmed7777/tridock` image.
+#
+# Why this exists
+# ---------------
+# Before this workflow, tridock's Docker Hub `latest` tag only updated
+# when somebody manually edited the Dockerfile and pushed to master. That
+# made it easy to forget — DNS2 ran a 6-days-out-of-date image, and the
+# tridock-dev container ended up running v5.9.9 while DNS2 prod ran v5.9.23.
+# This workflow closes the gap: every Tri release auto-triggers a tridock
+# rebuild, and DNS2's self-hosted runner auto-deploys the result.
+#
+# Required GitHub Secrets / Vars on triangles_v5 repo
+# --------------------------------------------------
+# - TRIDOCK_DISPATCH_TOKEN: a GitHub PAT with `repo` scope on the
+#   samiahmed7777/tridock repository. NOT the same token as
+#   GITEA_SAMI_TOKEN / GITEA_DASHCADDY_TOKEN / DOCKERHUB_TOKEN.
+
+name: Trigger tridock rebuild on Tri release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Override version (e.g. 5.9.24). Leave blank to use the published release tag.'
+        required: false
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  dispatch:
+    name: Notify tridock repo
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Resolve version
+        id: version
+        run: |
+          # On release:published, github.event.release.tag_name is like "v5.9.24"
+          # Strip the leading "v" so the dispatched payload uses "5.9.24"
+          if [ "${{ github.event_name }}" = "release" ]; then
+            TAG="${{ github.event.release.tag_name }}"
+            VERSION="${TAG#v}"
+          else
+            VERSION="${{ inputs.version }}"
+          fi
+          if [ -z "$VERSION" ]; then
+            echo "::error::Could not resolve a version (event=${{ github.event_name }}, tag=${{ github.event.release.tag_name }})"
+            exit 1
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Dispatching tridock rebuild for Triangles v$VERSION"
+
+      - name: Dispatch to samiahmed7777/tridock
+        run: |
+          curl -fsSL --max-time 30 \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${{ secrets.TRIDOCK_DISPATCH_TOKEN }}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            -X POST \
+            https://api.github.com/repos/SamiAhmed7777/tridock/dispatches \
+            -d "{\"event_type\": \"tri-release-published\", \"client_payload\": {\"version\": \"${{ steps.version.outputs.version }}\", \"source_repo\": \"SamiAhmed7777/triangles_v5\", \"source_sha\": \"${{ github.sha }}\"}}"
+
+          # Verify the dispatch landed
+          RC=$?
+          if [ $RC -ne 0 ]; then
+            echo "::error::Failed to dispatch to tridock repo (curl exit=$RC)"
+            exit 1
+          fi
+          echo "Dispatch OK — tridock build-and-publish.yml will pick this up."
+
+      - name: Send Telegram alert
+        if: always()
+        continue-on-error: true
+        env:
+          TG_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
+          TG_CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
+        run: |
+          if [ -z "$TG_TOKEN" ] || [ -z "$TG_CHAT" ]; then
+            echo "Telegram secrets not set — skipping alert"
+            exit 0
+          fi
+          STATUS="${{ job.status }}"
+          VERSION="${{ steps.version.outputs.version }}"
+          MSG="Tri release v$VERSION → tridock dispatch: $STATUS"
+          curl -fsSL --max-time 10 \
+            "https://api.telegram.org/bot${TG_TOKEN}/sendMessage" \
+            -d "chat_id=${TG_CHAT}" \
+            -d "text=${MSG}" \
+            -d "parse_mode=HTML" \
+            > /dev/null || echo "Telegram send failed (non-fatal)"

.github/workflows/winget-watchdog.yml

@@ -0,0 +1,69 @@
+name: WinGet PR watchdog
+
+# Catches failing WinGet submissions within an hour of opening them.
+# Goal: don't leave "needs-author-feedback" or "PullRequest-Error" PRs
+# sitting open for days — moderators read sustained unfixed PRs as spam.
+#
+# Behaviour:
+# - Every 30 min, scan open SamiAhmed7777 PRs against microsoft/winget-pkgs
+# - For each one, look at recent wingetbot comments to detect validation result
+# - If validation FAILED, post a comment summarising the error, close the PR,
+#   and surface the failure on the workflow summary so it's easy to spot.
+
+on:
+  schedule:
+    - cron: '*/30 * * * *'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  watchdog:
+    name: Scan + auto-close failed WinGet PRs
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install gh CLI
+        run: |
+          which gh >/dev/null 2>&1 || (curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list >/dev/null && sudo apt update && sudo apt install -y gh jq)
+
+      - name: Scan + auto-close
+        env:
+          GH_TOKEN: ${{ secrets.WINGET_TOKEN }}
+        run: |
+          set -e
+          if [ -z "$GH_TOKEN" ]; then
+            echo "::warning::WINGET_TOKEN not set — watchdog can scan but cannot close PRs."
+          fi
+          echo "Fetching open SamiAhmed7777 PRs against microsoft/winget-pkgs..."
+          PRS=$(gh api 'repos/microsoft/winget-pkgs/pulls?state=open&per_page=30' --jq '.[] | select(.user.login=="SamiAhmed7777") | "\(.number)|\(.head.ref)|\(.title)|\(.created_at)"')
+          if [ -z "$PRS" ]; then
+            echo "OK no open SamiAhmed7777 PRs."
+            exit 0
+          fi
+          echo "$PRS" | while IFS='|' read -r NUM BRANCH TITLE CREATED; do
+            echo ""
+            echo "--- PR #$NUM: $TITLE (branch $BRANCH, created $CREATED) ---"
+            LAST_VALIDATION=$(gh api "repos/microsoft/winget-pkgs/issues/$NUM/comments?per_page=20" --jq '[.[] | select(.user.login=="wingetbot" or .user.login=="stephengillie") | select(.body | test("Result: Failed|Invalid file|Automatic Validation ended"))] | first')
+            if [ -n "$LAST_VALIDATION" ]; then
+              echo "  X Validation FAILED detected."
+              SUMMARY=$(echo "$LAST_VALIDATION" | jq -r '.body' | head -40)
+              echo "  Summary:"
+              echo "$SUMMARY" | sed 's/^/    /'
+              if [ -n "$GH_TOKEN" ]; then
+                printf 'Auto-closing: automatic validation failed within the watchdog window.\n\n```\n%s\n```\n\nThe watchdog (winget-watchdog.yml) closed this PR so it does not sit in the moderator queue with a needs-author-feedback flag. Reopen after fixing the issue, or open a fresh PR for a known-good version.\n' "$SUMMARY" > /tmp/watchdog-comment.txt
+                gh api -X POST "repos/microsoft/winget-pkgs/issues/$NUM/comments" -f body=@/tmp/watchdog-comment.txt || echo "  (comment failed, continuing)"
+                gh api -X PATCH "repos/microsoft/winget-pkgs/pulls/$NUM" -f state=closed || echo "  (close failed, continuing)"
+                echo "  OK Closed PR #$NUM"
+                echo "::warning::Closed failing PR #$NUM -- $TITLE"
+              else
+                echo "  (no WINGET_TOKEN, skipping close)"
+              fi
+            elif gh api "repos/microsoft/winget-pkgs/issues/$NUM/comments?per_page=20" --jq '[.[] | select(.user.login=="wingetbot") | select(.body | test("Validation Pipeline Run"))] | first' | grep -q .; then
+              echo "  ? Validation has been triggered but no failure detected yet — leaving PR open."
+            else
+              echo "  ? No validation result yet — leaving PR open."
+            fi
+          done

.gitignore

@@ -49,7 +49,6 @@ blocks/
 # IDE
 .vscode/
 .idea/
-.claude/
 *.swp
 *.swo
 *~
@@ -68,7 +67,6 @@ triangles.conf
 *.key
 *.cert
 *.gpg
-*.o
 src/trianglesd
 src/obj/
 build-bench/
@@ -78,3 +76,27 @@ build-latest/
 build-rocks-probe/
 build-rocksdb/
 bench-results.csv
+
+# Local build dirs (krystie)
+/build-*/
+/build/
+/bench-results.csv
+/build-rocks-probe/
+/build-rocksdb/
+/build-cmake/
+/build-cmake-test/
+/build-latest/
+/build-bench/
+/.qmake.stash
+
+# MinGW cross-compilation deps (local build environment)
+/deps-mingw/
+
+# Snapshot files
+*.utx
+
+# Merge artifacts
+*.orig
+
+# Dev patches
+*.patch

.gitmodules

@@ -4,3 +4,6 @@
 [submodule "src/secp256k1"]
 	path = src/secp256k1
 	url = https://github.com/bitcoin-core/secp256k1
+[submodule "src/i2p/i2pd-src"]
+	path = src/i2p/i2pd-src
+	url = https://github.com/PurpleI2P/i2pd.git

BOOST-REMOVAL.md

@@ -0,0 +1,91 @@
+# Boost removal — progress
+
+Goal: drop the Boost dependency in favor of C++17 std. No consensus or wire
+behavior changes.
+
+## Done
+
+**Triangles' own code (daemon + GUI) is now completely Boost-free.** All nine
+translation units that used Boost have been migrated. The only remaining Boost
+usage in the tree is (1) the Boost.Test unit-test framework under `src/test/`,
+and (2) Boost as a *transitive link dependency of the bundled embedded i2pd
+router* (`libi2pd.a`) — not of any Triangles source. See "Remaining" below.
+
+| File | Boost removed | Replacement |
+|------|---------------|-------------|
+| `txdb-leveldb.cpp` | `boost/version.hpp` (unused include) | deleted |
+| `txdb-rocksdb.cpp` | `boost/version.hpp` (unused include) | deleted |
+| `walletdb.cpp` | `boost/version.hpp` + `BOOST_VERSION` guard | unconditional `std::filesystem` branch |
+| `util.cpp` | `boost::program_options` config-file parser + `to_internal` workaround | small C++17 INI parser in `ReadConfigFile` |
+| `init.cpp` | `boost::interprocess::file_lock` + `using namespace boost` | portable `LockDataDirectory()` (`flock` POSIX / `LockFileEx` Win32) |
+| `rpcdump.cpp` | `boost::posix_time` + `boost::gregorian` | `std::get_time` + `timegm`/`_mkgmtime` |
+
+`wallet.cpp` and `triangles-cli.cpp` only ever *mentioned* Boost in comments —
+no code change needed.
+
+### Behavior notes for review
+- **Config parser**: `name = value`; a line whose first non-whitespace char is
+  `#` is a comment; blank lines ignored; inline `#` is NOT a comment (so
+  `rpcpassword` may contain `#`). First value wins for single-valued settings;
+  `-name` keying and `nofoo=` negative-setting interpretation preserved.
+- **File lock**: exclusive, non-blocking; the fd/handle is held for process
+  lifetime and released by the OS on exit (matches the old file_lock lifetime).
+- **Dump time parser**: same five accepted formats, parsed as UTC.
+
+### CMake note
+`program_options` is no longer used by any source file and can be dropped from
+the `find_package(Boost ... COMPONENTS ...)` list once the remaining two files
+are migrated. It is left in place for now because removing it before the Asio
+migration provides no benefit and the component is harmless if installed.
+
+### RPC server (done — `trianglesrpc.cpp`)
+
+The JSON-RPC/HTTP server previously used `boost::asio` (async sockets +
+`boost::asio::ssl`), `boost::bind`, `boost::iostreams`,
+`boost::shared_ptr`/`weak_ptr`, and `boost::system::error_code`. It was
+rewritten onto **raw BSD sockets** behind a small `std::iostream`
+(`src/rpc_httpsocket.h`), preserving the thread-per-connection model so the
+HTTP parser, JSON-RPC dispatch, REST handler, and the blocking SSE handler are
+all unchanged.
+
+- New `src/rpc_httpsocket.h`: `CSocketIOStream` (a `std::iostream` over a
+  `SOCKET`), `ConnectRPCSocket()`, `BindRPCSockets()` (separate IPv4/IPv6
+  listeners, loopback unless `-rpcallowip`), `SockaddrToString()`.
+- `ThreadRPCServer2` now binds sockets and runs a `select()`-based accept loop
+  that spawns `ThreadRPCServer3` per connection.
+- `ClientAllowed` takes a numeric IP string.
+- `CallRPC` connects via a raw socket.
+- **`-rpcssl` is removed.** RPC TLS was a rarely used Asio::ssl feature; for
+  remote access, front the port with stunnel/nginx or reach it over SSH/Tor
+  (the same decision Bitcoin Core made). A warning is logged if `-rpcssl` is set.
+
+### Qt URI handler (done — `qt/qtipcserver.cpp`)
+
+The `triangles:` single-instance URI handoff used
+`boost::interprocess::message_queue` + `boost::posix_time`. Rewritten onto
+`QLocalServer` / `QLocalSocket` (QtNetwork), keeping the existing polling-thread
+model via the blocking `waitForNewConnection` / `waitForReadyRead` /
+`waitForConnected` methods (no Qt event loop required). `Qt5::Network` added to
+the Qt find_package and the `triangles-qt` link.
+
+### CMake
+- `Boost::program_options`, `Boost::thread`, `Boost::chrono` removed from the
+  `triangles_common` link — Triangles' own objects reference no Boost symbols.
+
+## Remaining
+
+Two things still pull Boost into the build; neither is Triangles source:
+
+1. **Embedded i2pd router.** When built with the embedded I2P router, the
+   bundled `libi2pd.a` / `libi2pdclient.a` link Boost
+   (`program_options`, `thread`, `chrono`, `filesystem`, `system`). The
+   i2pd-specific link block (and the top-level `find_package(Boost ...)`) are
+   therefore left intact. Fully dropping Boost from the build requires either a
+   Boost-free i2pd build or disabling the embedded router. This is an upstream
+   i2pd concern, not Triangles code.
+
+2. **Unit tests.** `src/test/*` use the Boost.Test framework
+   (`Boost::unit_test_framework`). Optional follow-up: port to a header-only
+   framework (e.g. Catch2/doctest) to remove the last first-party Boost use.
+
+When both are addressed, `find_package(Boost ...)` can be removed entirely.

CHANGELOG.md

@@ -0,0 +1,284 @@
+# Changelog
+
+All notable changes to Triangles (TRI) are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [6.2.5] - 2026-08-03
+
+### Fixed
+- **Stake-age soft cap reverted** in `src/kernel.cpp::GetWeight`. The V5-fork
+  7-day soft cap (activated 2026-04-12) was the regression that capped
+  long-dormant coins at 7 days of weight, killing the diamond-hands
+  incentive. Restored to original Peercoin `min(nAge, nStakeMaxAge)`.
+  Chain was frozen at block 2,224,763 since 2026-07-18 with no blocks
+  ever produced under the soft cap, so reverting changes zero historical
+  block validation results.
+- **`ReadUtxo` lazy fallback** in `src/txdb-base.cpp`. The fallback to
+  `txindex.vSpent[]` exists in `HaveUtxo` but was missing in `ReadUtxo`,
+  so nodes with incomplete UTXO snapshots could not find pre-snapshot
+  unspent outputs (chain stalled at 2,224,763 since 2026-07-18).
+  Added: when UTXO DB misses an entry but `txindex.vSpent[n].IsNull()`,
+  read the transaction from disk and reconstruct the full CUtxoEntry
+  including exact block height via `mapBlockIndex` lookup.
+- **`DisconnectBlock` height reconstruction** in `src/main.cpp`. Reorg
+  path now recovers exact block height via `mapBlockIndex` instead of
+  leaving `nHeight = 0` on restored UTXOs.
+
+## [6.2.4] - 2026-08-02
+
+### Changed
+- **RocksDB bumped 8.9.1 → 10.10.1** in CI (`scripts/ci/build-rocksdb.sh`).
+  Required to read the Hetzner Dropbox bootstrap snapshot's chain DB,
+  whose SST files are at format_version=7. RocksDB 10.10.1 still uses
+  `format_version=6` as its own default; the daemon does NOT pin a
+  different value, so newly written SSTs continue to land at v6. This
+  is deliberate: mixed v6/v7 SST files in the same DB are supported by
+  RocksDB, and v7 writes from this build would close the door on
+  downgrade to 6.2.3 (or any RocksDB < 10.4.0) without fixing anything.
+
+### Fixed
+- **`scripts/ci/build-rocksdb.sh`** now strips `-std=c++XX` (regex covers
+  `-std=c++17` / `-std=c++20` / `-std=c++2b` / future values) from
+  `rocksdb.pc` Cflags instead of only the `-std=c++17` value. RocksDB
+  10.x writes `-std=c++20`, which `pkg-config` injects into every
+  Triangles translation unit. C++ translation units ignore the
+  redundant flag, but C units (e.g. `src/lz4/lz4.c`) hit a fatal
+  `error: invalid argument '-std=c++XX' not allowed with 'C'` from
+  clang. Previously, the daemon build tolerated this as a warning;
+  the fuzz build (`clang-15` + sanitizers) treated it as a hard
+  error and the `test-fuzz-smoke` / `test-fuzz-smoke-tx` jobs failed
+  in the 6.2.4 CI run #30744702062 at the `Build fuzz_script` /
+  `Build transaction_deserialize_fuzz` step.
+
+### Notes for operators upgrading from 6.2.3
+- The daemon's runtime dependency is `librocksdb.so.10.10.1`
+  (replacing the previous `librocksdb.so.8.9.1`). Install or build
+  rocksdb from source before rolling 6.2.4 onto a node; the .deb
+  from CI bundles the right SONAME and should just work on
+  Ubuntu 22.04 / 24.04.
+- If you imported the Hetzner Dropbox bootstrap snapshot's chain DB
+  into this node, that DB still contains v7 SSTs. Any daemon down to
+  RocksDB 10.4.0 will read it; RocksDB ≤ 10.3.x will reject the v7
+  SSTs with `Corrupt or unsupported format_version: 7`. After the
+  daemon compacts the imported chain DB, the v7 SSTs may be re-written
+  at v6 and the DB becomes readable by older rocksdb again — that
+  happens naturally as part of normal compaction, no extra action
+  required.
+- Package checksums in `packaging/flatpak`, `packaging/scoop`, and
+  `packaging/winget` are regenerated during the CI release workflow
+  after artifacts are produced; do not ship those package manifests
+  until their SHA-256 sums match the v6.2.4 release artifacts.
+
+## [6.2.3] - 2026-08-01
+
+### Changed
+- **Local snapshot loading no longer requires a compiled-in SHA match.**
+  Previously, loading `utxo-snapshot.bin` from the data dir rejected the
+  file unless its SHA256 was present in `Checkpoints::mapSnapshotHashes`
+  (which only knows about one or two canonical tips at compile time).
+  Local file loads are operator-trusted — the operator already has
+  filesystem access — so the SHA gate was friction without a security
+  benefit. The gate still exists for P2P-delivered snapshots via
+  `SnapshotNet` (requireCheckpoint=true there).
+
+### Added
+- `-acceptanylocalsnapshot` CLI flag: forces acceptance of a local
+  `utxo-snapshot.bin` whose SHA is not in the compiled map, with an
+  explicit warning log line. Use only with operator-signed snapshots.
+
+## [6.2.2] - 2026-08-01
+
+
+### Fixed
+- **Snapshot regeneration: full chain index, not just the last 2000.**
+  `UTXO_SNAPSHOT_DEFAULT_HEADERS` was 2000, which silently trimmed the
+  snapshot to the last 2000 blocks even though the v2+ format is designed
+  to carry the full chain index. The too-small snapshot caused
+  `GetKernelStakeModifier() : block not indexed` errors after a fresh
+  node loaded it — the kernel-stake-modifier walk in `CreateCoinStake`
+  needs blocks older than the last 2000 because `nStakeModifierSelectionInterval`
+  is multi-day. The block index was effectively unusable for the
+  StakeMiner on the recovered node. Default is now 0 (all headers); the
+  trim is bypassed when `nHeaders=0`. Callers may still pass an explicit
+  positive value for a small diagnostic snapshot.
+
+
+### Fixed
+- **Build portability: v6.1.9 binary crashed with SIGILL on every
+  production node.** v6.1.9 was built on GitHub Actions' EPYC 7763
+  runner (AVX-512 capable). GCC 11.4 + libstdc++ inlining emitted 741
+  `vpbroadcastq` EVEX instructions into the daemon binary even though
+  the cmake `AddCompilerFlags.cmake` was setting `-march=x86-64-v2
+  -mtune=generic`. The resulting binary crashed on every production
+  CPU that lacks AVX-512: KVM-virtualized EPYC (DNS2), Ryzen 5 3600
+  (SAMI-PC), and any non-x86_64 node. v6.2.0 adds an explicit
+  `-mno-avx512f -mno-avx512*` block to the global compile options so
+  the build cannot leak AVX-512 regardless of what the build host
+  supports. Carries forward the v6.1.9 staking-selfheal fix unchanged.
+  See `references/avx-512-sigill-build-fix.md` for the full diagnosis.
+
+### Changed
+- Bump version 6.1.9 → 6.2.0 to reflect the build-system change.
+
+## [6.1.9] - 2026-07-31
+
+### Fixed
+- **Staking deadlock on idle networks.** `IsStakingSafe()` refused to
+  stake whenever `IsInitialBlockDownload()` was true, and `IBD` flipped
+  true whenever the chain tip was older than 24h. After 24h of no blocks,
+  every node simultaneously refused to stake and the chain deadlocked.
+  The `staking: true` flag in `getstakinginfo` was misleading — it only
+  reflected a single search in the brief window after a restart. Narrowed
+  the gate to "refuse only when IBD is true AND local height is behind
+  the peer/checkpoint estimate" (`f69f087`). A node at the peer median
+  now clears the gate and keeps staking through idle periods, so the
+  chain self-heals. Genuinely-behind nodes still hold off. Block
+  validation, reorg rules, and checkpoint rules are unchanged. The
+  `-forcestaking` bootstrap escape hatch still works on nodes caught
+  up to the checkpoint.
+
+### Changed
+- CLI: `-conf=` (empty value) now falls back to the default config
+  path instead of erroring out (`41e3898`).
+- CLI: `-conf` / `-datadir` / `-rpcuser` / `-rpcpassword` are honored
+  in the documented order, with clearer error messages on bad input
+  (`64556dc`).
+- Build: reproducible build + signed release pipeline (PR #26 chain).
+
+## [6.1.8] - 2026-07-17
+
+### Changed
+- Bootstrap: RPC-driven trusted snapshot publisher rotation (PR #26).
+  Operators can rotate the snapshot publisher via RPC instead of
+  hard-coding it in the binary.
+- Consensus: removed local-finality, fixed `getheaders` fork recovery
+  (`935d1d5`).
+- Consensus: fail-closed reorg guard when the startup checkpoint
+  pointer is null (`6116cff`).
+- IBD: allow `getblocks`/`getheaders` on OneShot peers during IBD
+  (`c68a8cb`).
+- Build: bump revision 7 → 8.
+
+### ⚠️ Known issue
+- v6.1.8 introduced a staking deadlock on idle networks via the
+  `IsStakingSafe()` gate. Operators on v6.1.8 should set
+  `staking=1` and `forcestaking=1` in `triangles.conf` and restart
+  to unstick the chain. v6.1.9 fixes the root cause.
+
+## [6.1.7] - 2026-07-08
+
+### Changed
+- Overview page UI: the Total balance label is now rendered with
+  `font-weight: 900` (full bold) instead of Qt's default bold (75,
+  medium-bold). On builds where the font has a true heavy variant,
+  the Total now visually pops as the headline number against the
+  Spendable / Stake / Unconfirmed rows.
+- Transactions amount column **Confirming tier color** is now
+  `#4A8C5E` (mid green) instead of `#C5EBC9` (pale mint). The pale
+  mint was too close to the bright `#7CDB8A` Confirmed green on
+  the dark background and read as the same color. Mid green sits
+  clearly between grey (Unconfirmed) and bright green (Confirmed)
+  so the three tiers are visually distinct.
+- Transactions amount column **now reads confirmation depth
+  directly** (new `DepthRole` on `TransactionTableModel`) instead
+  of going through the `TransactionStatus` enum. The rule fires on
+  every block increment, not just on enum state transitions.
+  Affects both `transactiontablemodel.cpp` (Transactions tab) and
+  `overviewpage.cpp` (Overview recent-5 list).
+
+## [6.1.6] - 2026-07-08
+
+### Changed
+- Overview page UI: conditional color on the **Total** balance label.
+  Renders money-green (`#7CDB8A`) when the total is greater than zero
+  and brand-red (`#e32105`) when the wallet is empty. Previously a
+  static green stylesheet rule failed to cascade on some Qt builds,
+  leaving Total always red.
+- Transactions list (and Overview recent-5 list) **amount column** now
+  uses a 3-tier color rule keyed off the existing `TransactionStatus`
+  state machine, so the amount color agrees with the status icon:
+  - 0 confirms (`Unconfirmed`) → grey (`#61280E`)
+  - 1–3 confirms (`Confirming`) → pale mint (`#C5EBC9`)
+  - 4+ confirms (`Confirmed`) → money-green (`#7CDB8A`)
+  - Conflicted → grey
+  - Negative amounts (spent) stay red across all tiers.
+- Internal: added `COLOR_CONFIRMING` constant in `guiconstants.h`;
+  rewired both amount paint sites
+  (`overviewpage.cpp::TxViewDelegate::paint` and
+  `transactiontablemodel.cpp::ForegroundRole`) to share the rule.
+
+### Fixed
+- `overviewpage.cpp` now includes `transactionrecord.h` so the
+  `TransactionStatus::Confirming` enum value is in scope (was
+  previously only forward-declared via `transactiontablemodel.h`).
+
+## [6.1.5] - 2026-07-08
+
+### Added
+- New `tweet@sami-ahmed.net` uid on the maintainer signing key, with
+  `hello@sami-ahmed.net` verified on the GitHub account — release tags now
+  show as "Verified" on github.com.
+- `CHANGELOG.md` at the repo root (this file).
+
+### Changed
+- Overview page UI: pending (`labelUnconfirmed`) and immature (`labelImmature`)
+  balance labels now render in **olive green** (`#A8B847`) instead of the
+  same light green as confirmed balances. The distinction reads as
+  "incoming but not yet confirmed" instead of "incoming and final".
+- `doc/release-process.md`: corrected signing-key identity to match the
+  actual key in use (RSA-4096 `Krystie Triangles Release <krystie-triangles-release@dns2.sami.tailnet>`,
+  not the Ed25519 `sami@cryptographic-triangles.org` the doc previously claimed).
+
+### Fixed
+- Wallet close-hang on Windows: detached `std::thread` instances backing the
+  embedded Tor and I2P controllers now join cleanly on shutdown, removing
+  the ~30s exit delay. (`#20`)
+- Consensus: live proof-of-stake checks run during stale-tip IBD instead of
+  being suppressed, fixing a divergence path where a node could accept a
+  stale chain tip while local PoS validity checks were off. (`#18`)
+- CI: `simd.c:265` UBSan build-id drift resolved; reproducible-build
+  warnings now ignore untracked files. (`#17`)
+
+### Security
+- Audit follow-ups merged: kernel coverage, keystore coverage, sigcache
+  fixes, wallet-DB test fixes. (`#14`, `#15`)
+
+## [6.1.4] - 2026-07-04
+
+### Fixed
+- CI: Tor bundle download resilience.
+- `NeedsBootstrap` flag now correctly persists across `rocksdb/` restarts.
+
+## [6.1.3] - 2026-07-01
+
+### Changed
+- Chain-DB migration hardening.
+- BIP39 passphrase support.
+- HD-wallet indicator in the UI.
+- Test isolation improvements.
+
+## [6.1.2] - 2026-06-30 [YANKED]
+
+Hotfix for v3 snapshot seek-offset corruption. Superseded by 6.1.3.
+Do not use.
+
+## [6.1.1] - 2026-06-22
+
+### Fixed
+- Minor wallet bugs.
+
+## [6.1.0] - 2026-06-15
+
+### Added
+- Initial 6.x release line. C++20 modernization, embedded Tor/I2P support.
+
+[6.1.7]: https://github.com/SamiAhmed7777/triangles_v5/compare/v6.1.6...v6.1.7
+[6.1.6]: https://github.com/SamiAhmed7777/triangles_v5/compare/v6.1.5...v6.1.6
+[6.1.5]: https://github.com/SamiAhmed7777/triangles_v5/compare/v6.1.4...v6.1.5
+[6.1.4]: https://github.com/SamiAhmed7777/triangles_v5/compare/v6.1.3...v6.1.4
+[6.1.3]: https://github.com/SamiAhmed7777/triangles_v5/compare/v6.1.2...v6.1.3
+[6.1.2]: https://github.com/SamiAhmed7777/triangles_v5/compare/v6.1.1...v6.1.2
+[6.1.1]: https://github.com/SamiAhmed7777/triangles_v5/compare/v6.1.0...v6.1.1
+[6.1.0]: https://github.com/SamiAhmed7777/triangles_v5/releases/tag/v6.1.0

CMakeLists.txt

@@ -6,7 +6,7 @@ if(POLICY CMP0167)
 endif()
 
 project(Triangles
-    VERSION 6.0.0
+    VERSION 6.2.5
     DESCRIPTION "Cryptographic Triangles Wallet"
     LANGUAGES C CXX
 )
@@ -37,6 +37,41 @@ if(ENABLE_UNITY_BUILD)
     set(CMAKE_UNITY_BUILD_BATCH_SIZE 8)
 endif()
 
+# ── Reproducible-build support ─────────────────────────────────────────────
+# REPRODUCIBLE_BUILD=ON strips absolute source paths from the final binary
+# via -ffile-prefix-map. Two builds of the same commit with the same
+# toolchain then produce byte-identical binaries (modulo any source paths
+# that aren't routed through the macro — see scripts/verify-reproducible-build.sh
+# for the full verification protocol).
+#
+# Default ON: this is a security property we want by default. Disable if
+# you need stack traces with absolute paths (e.g. debugging a post-mortem).
+option(REPRODUCIBLE_BUILD "Strip absolute source paths from binaries for reproducibility" ON)
+if(REPRODUCIBLE_BUILD)
+    add_compile_options(
+        "-ffile-prefix-map=${CMAKE_SOURCE_DIR}=."
+        "-ffile-prefix-map=${CMAKE_BINARY_DIR}=."
+    )
+    # SOURCE_DATE_EPOCH is the canonical reproducible-build env var
+    # (https://reproducible-builds.org/docs/source-date-epoch/). If the
+    # user hasn't set it explicitly, fall back to the commit timestamp from
+    # git. This means binaries built without SOURCE_DATE_EPOCH still embed
+    # a deterministic timestamp (the commit time, not wall-clock).
+    if(NOT DEFINED ENV{SOURCE_DATE_EPOCH})
+        execute_process(
+            COMMAND git log -n 1 --format=%ct
+            WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
+            OUTPUT_VARIABLE SOURCE_DATE_EPOCH
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+        if(NOT SOURCE_DATE_EPOCH)
+            set(SOURCE_DATE_EPOCH "1700000000")  # 2023-11-14 fallback
+        endif()
+    endif()
+    message(STATUS "Reproducible build: ON (SOURCE_DATE_EPOCH=${SOURCE_DATE_EPOCH})")
+endif()
+
 # ── Output directories ──
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
 set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib")
@@ -47,17 +82,37 @@ list(APPEND CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake")
 # ── User-facing options ──
 option(BUILD_QT           "Build triangles-qt (Qt5 GUI wallet)"              ON)
 option(BUILD_DAEMON       "Build trianglesd (headless daemon)"               ON)
+option(BUILD_CLI          "Build triangles-cli (JSON-RPC client)"            ON)
 option(BUILD_TESTS        "Build test_triangles (Boost.Test unit tests)"     ON)
-option(USE_UPNP           "Enable UPnP support via miniupnpc"               ON)
+option(USE_UPNP           "Enable UPnP support via miniupnpc"               OFF)
 option(USE_IPV6           "Enable IPv6 support"                              ON)
 option(USE_QRCODE         "Enable QR code generation via libqrencode"        OFF)
-option(USE_DBUS           "Enable D-Bus notifications (Linux only)"          ON)
+option(USE_DBUS           "Enable D-Bus notifications (Linux only)"          OFF)
 option(USE_ZMQ            "Enable ZMQ publisher support"                     OFF)
-option(USE_TOR_EMBEDDED   "Enable embedded Tor library linking"              OFF)
+# Triangles is Tor-native.  Tor is REQUIRED — disabling it at build time is
+# not a supported configuration.  The 2026-06-23 DNS2 clearnet-fork incident
+# (5+ days on a parallel chain because someone flipped -notor=1 for
+# troubleshooting and never reverted it) motivated this.  We keep the option
+# for legacy recovery workflows, but default it ON and abort the build if
+# anyone explicitly disables it.
+option(USE_TOR_EMBEDDED   "Enable embedded Tor library linking"              ON)
+if(DEFINED USE_TOR_EMBEDDED AND NOT USE_TOR_EMBEDDED)
+    message(FATAL_ERROR
+        "USE_TOR_EMBEDDED=OFF is not supported. Triangles is Tor-native. "
+        "If you need clearnet mode for bootstrap recovery, build with "
+        "USE_TOR_EMBEDDED=ON and pass -notor=1 -recovery-mode=1 at runtime "
+        "instead.")
+endif()
 option(USE_O3             "Use -O3 optimization instead of -O2"              OFF)
-option(ENABLE_PIE         "Build position-independent executables"           OFF)
+option(ENABLE_PIE         "Build position-independent executables"           ON)
 option(ENABLE_STATIC      "Prefer static linking (Linux release builds)"     OFF)
 
+# Embedded I2P (i2pd) — runs an I2P router in-process alongside Tor.
+# When enabled, Triangles supports dual-network anonymity: Tor (.onion) +
+# I2P (.b32.i2p). Disabled by default until seed nodes are deployed.
+option(USE_I2P_EMBEDDED   "Enable embedded I2P (i2pd) library linking"       OFF)
+set(I2P_SOURCE_ROOT   "" CACHE PATH "Path to i2pd source tree (for USE_I2P_EMBEDDED)")
+
 # Cache variables for custom dependency paths
 set(BDB_INCLUDE_PATH "" CACHE PATH "Path to Berkeley DB headers")
 set(BDB_LIB_PATH     "" CACHE PATH "Path to Berkeley DB libraries")
@@ -74,6 +129,7 @@ include(AddCompilerFlags)
 find_package(OpenSSL REQUIRED)
 find_package(Boost 1.71 REQUIRED COMPONENTS
     program_options thread chrono
+    OPTIONAL_COMPONENTS filesystem system
 )
 if(BUILD_TESTS)
     find_package(Boost REQUIRED COMPONENTS unit_test_framework)
@@ -133,6 +189,78 @@ if(NOT TARGET RocksDB::rocksdb AND NOT TARGET PkgConfig::RocksDB)
     message(STATUS "Found RocksDB (manual probe): ${ROCKSDB_LIBRARY}")
 endif()
 
+# Modernization: SQLite3 for the new wallet DB backend.
+find_package(SQLite3 REQUIRED)
+
+# Triangles uses RocksDB features that only exist in 7.4+ (XXH3 per-block
+# checksum, type 4). Building against an older RocksDB produces a binary
+# whose smsgDB Open() fails on any SST file written by RocksDB 7.4+ —
+# instead of just bailing, src/smessage.cpp::SecMsgDB::Open now
+# quarantines the offending file and recovers. We still fail loudly at
+# configure time so this drift doesn't sneak back in unnoticed.
+
+# rocksdb/version.h ships with every RocksDB release (3.x onward) and
+# defines ROCKSDB_MAJOR / ROCKSDB_MINOR / ROCKSDB_PATCH. If neither
+# find_package nor pkg-config exposed RocksDB_VERSION (e.g. Ubuntu 22.04's
+# librocksdb-dev, which ships no CMake config and no .pc file), we can
+# still recover the version directly from the header. This closes the
+# "manual probe silently allows old RocksDB" gap that let v5.9.24 ship
+# linked to librocksdb 6.11.
+function(_tri_detect_rocksdb_version_from_header)
+    if(RocksDB_VERSION)
+        return()
+    endif()
+    foreach(_dir ${ARGN})
+        if(NOT IS_DIRECTORY "${_dir}")
+            continue()
+        endif()
+        set(_vh "${_dir}/rocksdb/version.h")
+        if(EXISTS "${_vh}")
+            file(STRINGS "${_vh}" _maj REGEX "^#define ROCKSDB_MAJOR ")
+            file(STRINGS "${_vh}" _min REGEX "^#define ROCKSDB_MINOR ")
+            file(STRINGS "${_vh}" _pat REGEX "^#define ROCKSDB_PATCH ")
+            if(_maj AND _min AND _pat)
+                string(REGEX MATCH "[0-9]+" _maj "${_maj}")
+                string(REGEX MATCH "[0-9]+" _min "${_min}")
+                string(REGEX MATCH "[0-9]+" _pat "${_pat}")
+                set(RocksDB_VERSION "${_maj}.${_min}.${_pat}")
+                set(RocksDB_VERSION "${_maj}.${_min}.${_pat}" PARENT_SCOPE)
+                message(STATUS "Detected RocksDB version from version.h: ${RocksDB_VERSION}")
+                return()
+            endif()
+        endif()
+    endforeach()
+endfunction()
+
+if(NOT RocksDB_VERSION AND TARGET RocksDB::rocksdb)
+    get_target_property(_rocksdb_inc RocksDB::rocksdb INTERFACE_INCLUDE_DIRECTORIES)
+    if(_rocksdb_inc)
+        _tri_detect_rocksdb_version_from_header(${_rocksdb_inc})
+    endif()
+endif()
+
+if(NOT RocksDB_VERSION AND ROCKSDB_INCLUDE_DIR)
+    _tri_detect_rocksdb_version_from_header(${ROCKSDB_INCLUDE_DIR})
+endif()
+
+if(RocksDB_VERSION AND RocksDB_VERSION VERSION_LESS "7.4.0")
+    message(FATAL_ERROR
+        "Triangles requires RocksDB >= 7.4.0 (got ${RocksDB_VERSION}). "
+        "Older versions cannot read smsgDB files written by RocksDB 7.4+ "
+        "(XXH3 per-block checksum). "
+        "On Debian/Ubuntu: install librocksdb-dev >= 7.4 from a backports "
+        "repo or build RocksDB from source into /usr/local.")
+elseif(NOT RocksDB_VERSION)
+    # No version detectable: headers missing entirely, or ROCKSDB_INCLUDE_DIR
+    # not pointing at one with rocksdb/version.h. Runtime fallback in
+    # SecMsgDB::Open covers the gap; print WARNING so build logs flag it.
+    message(WARNING
+        "Could not determine RocksDB version (no CMake config, no "
+        "pkg-config metadata, and no rocksdb/version.h found). "
+        "Triangles prefers RocksDB >= 7.4.0; older versions are recovered "
+        "at runtime via SecMsgDB::Open's quarantine fallback.")
+endif()
+
 # libsecp256k1 — vendored as a git submodule under src/secp256k1. Provides
 # ECDSA signing/verification, pubkey recovery (via the recovery module), and
 # ECDH for secure messaging. Configure the submodule's build for our needs:
@@ -158,7 +286,7 @@ set(SECP256K1_ENABLE_MODULE_ELLSWIFT    OFF CACHE INTERNAL "")
 add_subdirectory(src/secp256k1 EXCLUDE_FROM_ALL)
 
 if(BUILD_QT)
-    find_package(Qt5 5.9 REQUIRED COMPONENTS Core Gui Widgets)
+    find_package(Qt5 5.9 REQUIRED COMPONENTS Core Gui Widgets Network)
     find_package(Qt5 COMPONENTS LinguistTools QUIET)
     if(USE_DBUS AND UNIX AND NOT APPLE)
         find_package(Qt5 COMPONENTS DBus QUIET)
@@ -177,6 +305,17 @@ include(BuildLevelDB)
 # ── Generate build.h from git describe ──
 include(GenerateBuildInfo)
 
+# ── Enable CTest at the TOP level ──
+# add_test() is called in src/CMakeLists.txt, but without enable_testing()
+# here the top-level build/CTestTestfile.cmake is never generated, so
+# `ctest` run from the build root discovers ZERO tests. CI does exactly
+# `cd build && ctest`, which means the unit suites were silently not run.
+# Calling enable_testing() at the root generates the top-level test file
+# that recurses into src/ and registers all four test executables.
+if(BUILD_TESTS)
+    enable_testing()
+endif()
+
 # ── Descend into source tree ──
 add_subdirectory(src)
 
@@ -185,6 +324,7 @@ message(STATUS "")
 message(STATUS "Triangles ${PROJECT_VERSION} build configuration:")
 message(STATUS "  Build Qt GUI:       ${BUILD_QT}")
 message(STATUS "  Build daemon:       ${BUILD_DAEMON}")
+message(STATUS "  Build CLI:          ${BUILD_CLI}")
 message(STATUS "  Build tests:        ${BUILD_TESTS}")
 message(STATUS "  UPnP:               ${USE_UPNP}")
 message(STATUS "  IPv6:               ${USE_IPV6}")
@@ -192,6 +332,7 @@ message(STATUS "  QR code:            ${USE_QRCODE}")
 message(STATUS "  D-Bus:              ${USE_DBUS}")
 message(STATUS "  ZMQ:                ${USE_ZMQ}")
 message(STATUS "  Embedded Tor:       ${USE_TOR_EMBEDDED}")
+message(STATUS "  Embedded I2P:       ${USE_I2P_EMBEDDED}")
 message(STATUS "  Static linking:     ${ENABLE_STATIC}")
 message(STATUS "  ccache:             ${CCACHE_PROGRAM}")
 message(STATUS "  Unity build:        ${ENABLE_UNITY_BUILD}")

Dockerfile

@@ -1,38 +1,83 @@
-FROM ubuntu:22.04
+FROM ubuntu:24.04 AS builder
 
-LABEL maintainer="Cryptographic Triangles Team"
-LABEL description="Cryptographic Triangles (TRI) headless daemon"
-LABEL version="5.7.6"
+ARG DEBIAN_FRONTEND=noninteractive
+ARG SOURCE_DATE_EPOCH=1700000000
+ENV SOURCE_DATE_EPOCH=${SOURCE_DATE_EPOCH}
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
+    autoconf \
+    automake \
+    build-essential \
     ca-certificates \
-    curl \
-    libssl3 \
-    libdb5.3++ \
-    libboost-system1.74.0 \
-    libboost-filesystem1.74.0 \
-    libboost-program-options1.74.0 \
-    libboost-thread1.74.0 \
-    libboost-chrono1.74.0 \
-    libevent-2.1-7 \
-    libminiupnpc17 \
-    tor \
+    cmake \
+    libboost-all-dev \
+    libdb++-dev \
+    libevent-dev \
+    libleveldb-dev \
+    liblz4-dev \
+    liblzma-dev \
+    libminiupnpc-dev \
+    librocksdb-dev \
+    libsnappy-dev \
+    libsqlite3-dev \
+    libssl-dev \
+    libtool \
+    libzstd-dev \
+    ninja-build \
+    pkg-config \
+    zlib1g-dev \
     && rm -rf /var/lib/apt/lists/*
 
-ARG VERSION=5.7.6
-RUN curl -L -o /usr/local/bin/trianglesd \
-    https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-v${VERSION}-linux-x64-daemon \
-    && chmod +x /usr/local/bin/trianglesd
+WORKDIR /src
+COPY . .
+
+RUN test -s src/secp256k1/CMakeLists.txt \
+    && test -s src/tor/tor-src/configure.ac
+
+RUN LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+    bash src/tor/build-libtor.sh
+
+RUN cmake -S . -B build -G Ninja \
+      -DCMAKE_BUILD_TYPE=Release \
+      -DBUILD_QT=OFF \
+      -DBUILD_DAEMON=ON \
+      -DBUILD_CLI=ON \
+      -DBUILD_TESTS=OFF \
+      -DUSE_UPNP=OFF \
+      -DUSE_I2P_EMBEDDED=OFF \
+    && cmake --build build --parallel 2
+
+RUN install -D -m 0755 build/bin/trianglesd /opt/triangles/bin/trianglesd \
+    && install -D -m 0755 build/bin/triangles-cli /opt/triangles/bin/triangles-cli \
+    && mkdir -p /opt/triangles/rootfs \
+    && { ldd /opt/triangles/bin/trianglesd; ldd /opt/triangles/bin/triangles-cli; } \
+       | awk '/=> \// {print $3} /^\// {print $1}' \
+       | sort -u \
+       | while IFS= read -r library; do \
+           cp --parents -L "${library}" /opt/triangles/rootfs; \
+         done
+
+FROM ubuntu:24.04
+
+ARG DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates \
+    && rm -rf /var/lib/apt/lists/* \
+    && groupadd --gid 10001 triangles \
+    && useradd --uid 10001 --gid triangles --home-dir /var/lib/triangles \
+         --no-create-home --shell /usr/sbin/nologin triangles \
+    && install -d -m 0700 -o triangles -g triangles /var/lib/triangles
+
+COPY --from=builder /opt/triangles/rootfs/ /
+COPY --from=builder /opt/triangles/bin/ /usr/local/bin/
+RUN ldconfig
 
-RUN useradd -m -s /bin/bash triangles
 USER triangles
-WORKDIR /home/triangles
+WORKDIR /var/lib/triangles
 
-RUN mkdir -p .triangles
+EXPOSE 24112
+VOLUME ["/var/lib/triangles"]
+STOPSIGNAL SIGTERM
 
-EXPOSE 24112 19112
-
-VOLUME ["/home/triangles/.triangles"]
-
-ENTRYPOINT ["trianglesd"]
-CMD ["-printtoconsole", "-txindex=1"]
+ENTRYPOINT ["/usr/local/bin/trianglesd"]
+CMD ["-datadir=/var/lib/triangles", "-printtoconsole", "-upnp=0", "-rest=0", "-rpcbind=127.0.0.1"]

I2P-EMBEDDED-ARCHITECTURE.md

@@ -0,0 +1,237 @@
+# I2P Embedded Architecture (Level 3)
+
+**Date:** 2026-06-27  
+**Status:** ✅ IMPLEMENTED & WORKING
+
+---
+
+## What This Is
+
+Triangles now runs **two embedded anonymity networks simultaneously**:
+
+1. **Tor** — Every node is a .onion hidden service (existing, unchanged)
+2. **I2P** — Every node is a .b32.i2p destination (new)
+
+Both routers run **in-process** as static libraries. No external dependencies, no separate daemons to install.
+
+### What I2P Adds Over Tor-Only
+
+| Property | Tor | I2P |
+|----------|-----|-----|
+| Routing | Onion (3-hop circuits) | Garlic (variable-hop tunnels) |
+| Directory | Centralized authorities | Distributed floodfills |
+| Service discovery | Hidden service descriptors | Network database (KadDHT) |
+| Designed for | Exit to clearnet | Peer-to-peer services |
+| Peer correlation resistance | Moderate | Strong (ephemeral tunnels) |
+
+I2P was designed from the ground up for **peer-to-peer anonymous services** — exactly what a cryptocurrency P2P network needs. Tor's hidden services work, but Tor is optimized for anonymous web browsing (exit traffic). I2P's garlic routing, distributed network database, and short-lived tunnels make it inherently better suited for P2P mesh communication.
+
+---
+
+## Architecture
+
+### Dual-Network Routing
+
+```
+                    ┌─────────────────────────────────┐
+                    │       trianglesd (process)       │
+                    │                                  │
+                    │  ┌─────────┐    ┌─────────┐     │
+                    │  │ libtor  │    │ libi2pd │     │
+                    │  │ (Tor)   │    │ (I2P)   │     │
+                    │  └────┬────┘    └────┬────┘     │
+                    │       │              │          │
+  .onion peers ─────┼───────┘              │          │
+                    │     SOCKS 19099      │          │
+                    │                      │          │
+  .b32.i2p peers ───┼──────────────────────┘          │
+                    │     SOCKS 19100                 │
+                    └─────────────────────────────────┘
+```
+
+### Traffic Flow
+
+| Destination | Route | Proxy |
+|-------------|-------|-------|
+| `*.onion` | Tor SOCKS5 → Tor circuit → hidden service | 127.0.0.1:19099 |
+| `*.b32.i2p` | I2P SOCKS5 → I2P tunnel → destination | 127.0.0.1:19100 |
+| Clearnet (IPv4/IPv6) | **BLOCKED** | — |
+
+The routing decision happens in `ConnectSocketByName()` (netbase.cpp):
+- `.b32.i2p` suffix → I2P SOCKS proxy (NET_I2P)
+- Everything else → Tor name proxy (SetNameProxy)
+
+---
+
+## Implementation
+
+### Files Added
+
+```
+src/i2p/
+├── i2pd-src/              # PurpleI2P/i2pd git submodule
+├── i2p_embedded.h         # CI2PEmbedded class declaration
+├── i2p_embedded.cpp       # Embedded router start/stop logic
+├── i2pseed.h              # Hardcoded .b32.i2p seed nodes
+└── build-libi2pd.sh       # Static library build script
+```
+
+### Files Modified
+
+| File | Change |
+|------|--------|
+| `CMakeLists.txt` | `USE_I2P_EMBEDDED` option + config summary |
+| `src/CMakeLists.txt` | I2P source, includes, library linking |
+| `src/init.cpp` | I2P startup (after Tor), shutdown, CLI flags |
+| `src/net.cpp` | Allow `.b32.i2p` in `ConnectNode()` and seed parser |
+| `src/netbase.cpp` | I2P SOCKS routing, fixed `.b32.i2p` address parsing |
+
+### CI2PEmbedded Class
+
+Singleton pattern (mirrors `CTorEmbedded`):
+
+```cpp
+class CI2PEmbedded {
+    bool Start(int socksPort, int samPort, int serverPort);
+    void Stop();
+    bool IsRunning() const;
+    std::string GetSocksProxy() const;    // "127.0.0.1:19100"
+    std::string GetI2PAddress() const;     // .b32.i2p destination
+};
+```
+
+### Startup Sequence (init.cpp)
+
+```
+1. StartEmbeddedTor()          → Tor SOCKS on 19099
+2. TOR-NATIVE MODE             → all traffic forced through Tor
+3. StartEmbeddedI2P()          → i2pd SOCKS on 19100
+4. I2P-NATIVE MODE             → .b32.i2p routed through i2pd
+5. Dual-network anonymity      → Tor + I2P co-equal
+```
+
+If I2P fails to start, the daemon continues in Tor-only mode (non-fatal).
+
+### How i2pd Integrates
+
+i2pd provides a C++ API (`libi2pd/api.h`) for in-process embedding:
+
+```cpp
+i2p::api::InitI2P(argc, argv, "triangles-i2pd");
+i2p::api::StartI2P(logStream);
+i2p::client::context.Start();  // SAM, SOCKS, tunnels
+```
+
+The auto-generated `i2pd.conf` enables:
+- SOCKS proxy on 19100 (for outbound .b32.i2p)
+- SAM bridge on 7656 (for future SAM v3 protocol)
+- Server tunnel in `tunnels.conf` (I2P hidden service)
+
+The `tunnels.conf` is written before `Start()`:
+```ini
+[triangles-p2p]
+type = server
+host = 127.0.0.1
+port = <P2P_PORT>
+keys = triangles-p2p-keys.dat
+inbound.length = 3
+outbound.length = 3
+```
+
+This creates a persistent `.b32.i2p` destination that survives restarts.
+
+---
+
+## Build Instructions
+
+### Prerequisites
+
+Same as existing Tor build + Boost (already required).
+
+### Build with I2P
+
+```bash
+# 1. Initialize the i2pd submodule
+git submodule update --init --recursive src/i2p/i2pd-src
+
+# 2. Build i2pd static libraries
+cd src/i2p && bash build-libi2pd.sh
+
+# 3. Configure and build Triangles
+mkdir build && cd build
+cmake -G Ninja -DUSE_I2P_EMBEDDED=ON ..
+ninja trianglesd
+```
+
+### Build without I2P (Tor-only, existing behavior)
+
+```bash
+cmake -G Ninja ..          # USE_I2P_EMBEDDED defaults to OFF
+ninja trianglesd
+```
+
+---
+
+## CLI Flags
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-i2p` | `1` | Enable embedded I2P router |
+| `-i2psocks=<port>` | `19100` | I2P SOCKS proxy port |
+| `-i2psam=<port>` | `7656` | I2P SAM bridge port |
+| `-i2phsport=<port>` | P2P port | I2P server tunnel forward port |
+
+---
+
+## Testing Verification
+
+### Expected Startup Output
+
+```
+Embedded I2P: starting i2pd router...
+Embedded I2P: server tunnel configured on port 24112
+...
+Clients: New private keys file .../triangles-p2p-keys.dat for <b32>.b32.i2p created
+Clients: 1 I2P server tunnels created
+Embedded I2P: SOCKS proxy at 127.0.0.1:19100, SAM at 127.0.0.1:7656
+...
+I2P-NATIVE MODE: I2P router running
+  SOCKS proxy at 127.0.0.1:19100 for .b32.i2p connections
+  Dual-network anonymity: Tor (.onion) + I2P (.b32.i2p)
+```
+
+---
+
+## Seed Node Deployment
+
+To deploy an I2P seed node:
+
+1. Build with `-DUSE_I2P_EMBEDDED=ON`
+2. Start the daemon — it auto-generates a `.b32.i2p` destination
+3. Read the address from the log: `grep "b32.i2p" debug.log`
+4. Add the address to `src/i2p/i2pseed.h`
+5. Add the address to `seeds.cryptographic-triangles.org/i2p-seeds.txt`
+
+The destination keys persist in `<datadir>/i2p_data/triangles-p2p-keys.dat`.
+
+---
+
+## Comparison to Other Projects
+
+| Project | Tor | I2P | Embedded | Dual-Network |
+|---------|-----|-----|----------|-------------|
+| **Triangles** | ✅ Embedded | ✅ Embedded | Both in-process | ✅ |
+| Bitcoin Core | Optional | Optional (SAM) | No | No |
+| Monero | Optional | No | No | No |
+| Kovri (Monero I2P) | N/A | Planned | Planned | No |
+
+Triangles is the only cryptocurrency with **both** Tor and I2P embedded as in-process routers.
+
+---
+
+## Future Work
+
+- **I2P seed nodes:** Deploy stable .b32.i2p seeds (parallel to onion seeds)
+- **SAM v3 direct:** Use SAM bridge for native I2P streaming (bypass SOCKS overhead)
+- **I2P address in RPC:** Expose `.b32.i2p` address via `getnetworkinfo`
+- **Cross-network bridging:** Allow Tor nodes to discover I2P peers and vice versa

README.md

@@ -1,250 +1,314 @@
-# Cryptographic Triangles (TRI)
-
-Triangles is a privacy-focused cryptocurrency featuring Proof-of-Stake consensus, Tor v3 onion routing, and built-in encrypted messaging. Originally launched in July 2014, the chain was revived in March 2026 after being frozen since December 2022.
-
-## Key Features
-
-- **Proof-of-Stake** - Energy-efficient block production with 33% annual staking rewards (coin-age based)
-- **Hash9 Algorithm** - Unique 13-step hash cascade (Fugue, Hamsi, Groestl, Blake, BMW, Skein, Keccak, Shavite, JH, Luffa, Cubehash, Echo, SIMD)
-- **Encrypted Messaging** - Send and receive encrypted messages directly through the wallet
-- **Tor v3 Integration** - Connect and transact over the Tor network with v3 onion hidden services
-- **120-second Block Time** - Fast confirmations with 2-minute target spacing
-
-## Specifications
-
-| Property | Value |
-|----------|-------|
-| Algorithm | Hash9 (PoW blocks 0-9000), PoS from block 9001 |
-| Block Time | ~120 seconds |
-| Max Supply | 2,222,222 TRI |
-| PoS Reward | 33% annual, coin-age based |
-| P2P Port | 24112 |
-| RPC Port | 19112 |
-| Protocol | 70205 |
-
-## Network Status
-
-The Triangles network operates exclusively over Tor for privacy:
-
-**Tor v3 Seeds:**
-- `jbpfhe7zw3qm67wy3j2ayysp3mnrjobopthnko3b3sgahqtecblwqmid.onion:24112`
-- `uddaxjbo3lh2zskg7w6gwln4ty5cel7q4c5jbx7fdtv6zf2j47gdlyad.onion:24112`
-- `el5sirhhleecuctpeeprelzubpqmoqivvra3rzlwbjttinxa4fq3wnid.onion:24112`
-- `sj5dhybnlp3v4y5niyc5unrnd6s43lyx5ibup7rolyosjbi2u2hsbvyd.onion:24112`
-- `i3kr5meha7se4ns3wss3h7v46m6uksfzv4wrohdqxpj6n35wyo2bvlid.onion:24112`
-
-**HTTP Seed List:**
-- `seeds.cryptographic-triangles.org/seeds.txt` - Dynamically updated list of active onion peers
-
-## Building from Source
-
-Triangles uses CMake. All platforms follow the same build pattern.
-
-### Dependencies
-
-| Dependency | Minimum Version |
-|------------|----------------|
-| CMake | 3.16+ |
-| C++ compiler | C++17 support |
-| OpenSSL | 3.x |
-| Boost | 1.90+ |
-| Berkeley DB | 5.3 (with C++ bindings) |
-| libevent | 2.x |
-| LevelDB | bundled |
-
-### Linux (Ubuntu 24.04 / Debian 12+)
-
-Install dependencies:
-```bash
-sudo apt-get install -y build-essential cmake ninja-build \
-    libboost-all-dev libssl-dev libdb5.3++-dev libevent-dev \
-    zlib1g-dev libminiupnpc-dev
-```
-
-For the Qt wallet, also install:
-```bash
-sudo apt-get install -y qtbase5-dev qt5-qmake libqrencode-dev
-```
-
-Build:
-```bash
-cmake -B build -G Ninja -DBUILD_QT=ON
-cmake --build build
-```
-
-### Linux (AlmaLinux 9 / RHEL 9)
-
-Install dependencies:
-```bash
-sudo dnf install -y gcc-c++ cmake ninja-build boost-devel openssl-devel \
-    libevent-devel zlib-devel miniupnpc-devel
-```
-
-BDB 5.3 C++ bindings must be built from source on RHEL-based systems (the `libdb-devel` package does not include C++ headers). Download BDB 5.3.28 from Oracle and build with `--enable-cxx`.
-
-Then build as above.
-
-### Windows (MSYS2 MinGW64)
-
-Open an MSYS2 MinGW64 shell and install:
-```bash
-pacman -S mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja \
-    mingw-w64-x86_64-boost mingw-w64-x86_64-openssl \
-    mingw-w64-x86_64-db mingw-w64-x86_64-miniupnpc \
-    mingw-w64-x86_64-qt5-base mingw-w64-x86_64-qrencode \
-    mingw-w64-x86_64-libevent
-```
-
-Build:
-```bash
-cmake -B build -G Ninja -DBUILD_QT=ON
-cmake --build build
-```
-
-### Build Options
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `BUILD_QT` | ON | Build the Qt GUI wallet |
-| `BUILD_DAEMON` | ON | Build the headless daemon |
-| `BUILD_TESTS` | OFF | Build unit tests |
-
-## Running
-
-### First Run
-```bash
-mkdir -p ~/.triangles
-cat > ~/.triangles/triangles.conf << 'EOF'
-port=24112
-rpcport=19112
-rpcuser=trianglesrpc
-rpcpassword=<generate-a-strong-password>
-rpcallowip=127.0.0.1
-staking=1
-txindex=1
-listen=1
-server=1
-daemon=1
-proxy=127.0.0.1:9050
-EOF
-
-trianglesd
-```
-
-The node will connect to seed nodes over Tor and sync the blockchain automatically.
-
-### Existing Wallet Holders
-
-If you have a `wallet.dat` from the original Triangles network:
-
-1. Place your `wallet.dat` in `~/.triangles/` (Linux) or `%APPDATA%\triangles\` (Windows)
-2. Start the wallet - it will sync the blockchain and your balance will appear automatically
-3. No migration or special action is needed - all keys and balances are preserved
-
-### Staking
-
-To stake, your wallet must be:
-- Running with `staking=1` in the config
-- Connected to at least one peer
-- Containing coins with sufficient coin-age (mature inputs)
-
-Check staking status:
-```bash
-trianglesd getstakinginfo
-```
-
-### Encrypted Messaging
-
-Send and receive encrypted messages between wallet addresses:
-
-```bash
-# Enable messaging
-trianglesd smsgenable
-
-# Send a message
-trianglesd smsgsend <your-address> <recipient-address> "Hello from Triangles!"
-
-# Check inbox
-trianglesd smsginbox all
-
-# Send anonymous message
-trianglesd smsgsendanon <recipient-address> "Anonymous message"
-```
-
-Messages are encrypted end-to-end using AES and distributed through the peer network in time-bucketed batches.
-
-### Tor Support
-
-Triangles is designed as a Tor-only network. Install the Tor daemon and configure your proxy:
-```
-# triangles.conf
-proxy=127.0.0.1:9050
-```
-
-To run your own hidden service, add to `/etc/tor/torrc`:
-```
-HiddenServiceDir /var/lib/tor/triangles/
-HiddenServiceVersion 3
-HiddenServicePort 24112 127.0.0.1:24112
-```
-
-Then set `externalip=<your-onion-address>` in `triangles.conf`.
-
-## RPC Commands
-
-### General
-- `getinfo` - Node status, balance, block height, connections
-- `getpeerinfo` - Connected peer details
-- `getstakinginfo` - Staking status and weight
-
-### Wallet
-- `getbalance` - Current balance
-- `listunspent` - Unspent transaction outputs
-- `sendtoaddress <addr> <amount>` - Send TRI
-- `getnewaddress` - Generate new receiving address
-
-### Messaging
-- `smsgenable` / `smsgdisable` - Toggle secure messaging
-- `smsgsend <from> <to> <message>` - Send encrypted message
-- `smsgsendanon <to> <message>` - Send anonymous message
-- `smsginbox [all|unread|clear]` - View received messages
-- `smsgoutbox [all|clear]` - View sent messages
-- `smsglocalkeys` - List messaging-enabled addresses
-- `smsgscanchain` - Scan blockchain for public keys
-
-## Chain History
-
-- **July 16, 2014** - Genesis block
-- **Block 0-9000** - Proof-of-Work mining phase (Hash9)
-- **Block 9001+** - Proof-of-Stake only
-- **Block 17,651** - V5 hard fork (removed Tor v2, disabled checkpoint master key)
-- **December 8, 2022** - Chain frozen (all nodes offline)
-- **March 11, 2026** - Chain revived, staking resumed
-
-## Project Structure
-
-```
-src/
-  main.cpp          - Core blockchain logic, block/tx validation, message routing
-  miner.cpp         - Staking miner thread
-  net.cpp           - P2P networking
-  init.cpp          - Daemon initialization
-  wallet.cpp        - Wallet management
-  smessage.cpp/h    - Encrypted messaging system
-  kernel.cpp        - PoS kernel (stake validation)
-  checkpoints.cpp   - Hardcoded checkpoints
-  net_bootstrap.h   - DNS/IP seed configuration
-  onionseed.h       - Tor v3 onion seed addresses
-  tor/
-    onion_v3.cpp/h  - Tor v3 hidden service management
-    tor_crypto_compat.h - Ed25519/SHA3 crypto compatibility
-```
-
-## License
-
-Distributed under the MIT/X11 software license. See `COPYING` for details.
-
-## Links
-
-- Website: [cryptographic-triangles.org](https://cryptographic-triangles.org)
-- Explorer: [blocks.cryptographic-triangles.org](https://blocks.cryptographic-triangles.org)
+# Cryptographic Triangles (TRI)
+
+Triangles is a privacy-focused cryptocurrency featuring Proof-of-Stake consensus, Tor v3 onion routing, and built-in encrypted messaging. Originally launched in July 2014, the chain was revived in March 2026 after being frozen since December 2022.
+
+## Key Features
+
+- **Proof-of-Stake** - Energy-efficient block production with 33% annual staking rewards (coin-age based)
+- **Hash9 Algorithm** - Unique 13-step hash cascade (Fugue, Hamsi, Groestl, Blake, BMW, Skein, Keccak, Shavite, JH, Luffa, Cubehash, Echo, SIMD)
+- **Encrypted Messaging** - Send and receive encrypted messages directly through the wallet
+- **Tor v3 Integration** - Connect and transact over the Tor network with v3 onion hidden services
+- **120-second Block Time** - Fast confirmations with 2-minute target spacing
+
+## Specifications
+
+| Property | Value |
+|----------|-------|
+| Algorithm | Hash9 (PoW blocks 0-9000), PoS from block 9001 |
+| Block Time | ~120 seconds |
+| Max Supply | 2,222,222 TRI |
+| PoS Reward | 33% annual, coin-age based |
+| P2P Port | 24112 |
+| RPC Port | 19112 |
+| Protocol | 70205 |
+
+## Network Status
+
+The Triangles network operates exclusively over Tor for privacy:
+
+**Tor v3 Seeds:**
+- `jbpfhe7zw3qm67wy3j2ayysp3mnrjobopthnko3b3sgahqtecblwqmid.onion:24112`
+- `uddaxjbo3lh2zskg7w6gwln4ty5cel7q4c5jbx7fdtv6zf2j47gdlyad.onion:24112`
+- `el5sirhhleecuctpeeprelzubpqmoqivvra3rzlwbjttinxa4fq3wnid.onion:24112`
+- `sj5dhybnlp3v4y5niyc5unrnd6s43lyx5ibup7rolyosjbi2u2hsbvyd.onion:24112`
+- `i3kr5meha7se4ns3wss3h7v46m6uksfzv4wrohdqxpj6n35wyo2bvlid.onion:24112`
+
+**HTTP Seed List:**
+- `seeds.cryptographic-triangles.org/seeds.txt` - Dynamically updated list of active onion peers
+
+## Building from Source
+
+Triangles uses CMake. All platforms follow the same build pattern.
+
+### Dependencies
+
+| Dependency | Minimum Version |
+|------------|----------------|
+| CMake | 3.16+ |
+| C++ compiler | C++17 support |
+| OpenSSL | 3.x |
+| Boost | 1.90+ |
+| SQLite | 3.x (default wallet database backend) |
+| Berkeley DB | 5.3 with C++ bindings (legacy wallet backend, used for migration) |
+| libevent | 2.x |
+| RocksDB | 7.4+ (default chain database backend) |
+| LevelDB | bundled (legacy chain DB backend, used for migration) |
+
+### Linux (Ubuntu 24.04 / Debian 12+)
+
+Install dependencies:
+```bash
+sudo apt-get install -y build-essential cmake ninja-build \
+    libboost-all-dev libssl-dev libdb5.3++-dev libevent-dev \
+    zlib1g-dev libminiupnpc-dev
+```
+
+For the Qt wallet, also install:
+```bash
+sudo apt-get install -y qtbase5-dev qt5-qmake libqrencode-dev
+```
+
+Build:
+```bash
+cmake -B build -G Ninja -DBUILD_QT=ON
+cmake --build build
+```
+
+### Linux (AlmaLinux 9 / RHEL 9)
+
+Install dependencies:
+```bash
+sudo dnf install -y gcc-c++ cmake ninja-build boost-devel openssl-devel \
+    libevent-devel zlib-devel miniupnpc-devel
+```
+
+BDB 5.3 C++ bindings must be built from source on RHEL-based systems (the `libdb-devel` package does not include C++ headers). Download BDB 5.3.28 from Oracle and build with `--enable-cxx`.
+
+Then build as above.
+
+### Windows (MSYS2 MinGW64)
+
+Open an MSYS2 MinGW64 shell and install:
+```bash
+pacman -S mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja \
+    mingw-w64-x86_64-boost mingw-w64-x86_64-openssl \
+    mingw-w64-x86_64-db mingw-w64-x86_64-miniupnpc \
+    mingw-w64-x86_64-qt5-base mingw-w64-x86_64-qrencode \
+    mingw-w64-x86_64-libevent
+```
+
+Build:
+```bash
+cmake -B build -G Ninja -DBUILD_QT=ON
+cmake --build build
+```
+
+### Build Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `BUILD_QT` | ON | Build the Qt GUI wallet |
+| `BUILD_DAEMON` | ON | Build the headless daemon |
+| `BUILD_TESTS` | OFF | Build unit tests |
+
+## Running
+
+### First Run
+```bash
+mkdir -p ~/.triangles
+cat > ~/.triangles/triangles.conf << 'EOF'
+port=24112
+rpcport=19112
+rpcuser=trianglesrpc
+rpcpassword=<generate-a-strong-password>
+rpcallowip=127.0.0.1
+staking=1
+txindex=1
+listen=1
+server=1
+daemon=1
+proxy=127.0.0.1:9050
+EOF
+
+trianglesd
+```
+
+The node will connect to seed nodes over Tor and sync the blockchain automatically.
+
+### Chain Database (RocksDB)
+
+The chain database (block index, transaction index, UTXO set, address index) uses **RocksDB by default**. RocksDB gives faster sync and lookups than the legacy LevelDB backend through parallel compaction, bloom filters, and a larger write buffer and block cache (tunable with `-dbcache=<MB>`).
+
+If you are upgrading a node that already has a LevelDB chain database (`txleveldb/` in your data directory), it is migrated automatically on first launch: the chain state is copied into a new `rocksdb/` directory and verified (record count, UTXO count and value, best-chain hash, and DB format must all match) before use. The original `txleveldb/` directory is left untouched as a fallback and is never modified.
+
+To select a backend explicitly:
+
+```bash
+trianglesd -chaindb=rocksdb   # default
+trianglesd -chaindb=leveldb   # legacy backend (retained for fallback/migration)
+```
+
+Migration can also be triggered or forced manually:
+
+```bash
+trianglesd -migratechaindb        # migrate txleveldb -> rocksdb if not already done
+trianglesd -migratechaindbforce   # re-migrate, replacing any existing rocksdb/
+```
+
+### Existing Wallet Holders
+
+If you have a `wallet.dat` from the original Triangles network:
+
+1. Place your `wallet.dat` in `~/.triangles/` (Linux) or `%APPDATA%\triangles\` (Windows)
+2. Start the wallet - it will sync the blockchain and your balance will appear automatically
+3. No migration or special action is needed - all keys and balances are preserved
+
+### Staking
+
+To stake, your wallet must be:
+- Running with `staking=1` in the config
+- Connected to at least one peer
+- Containing coins with sufficient coin-age (mature inputs)
+
+Check staking status:
+```bash
+trianglesd getstakinginfo
+```
+
+### Trusted Snapshot Publisher (UTXO Snapshots)
+
+The daemon verifies that any UTXO snapshot it loads was signed by a
+**trusted publisher**. Starting with v6.1.8, the trusted publisher can
+be rotated at runtime via RPC — no rebuild required. The compiled-in
+fallback (`TG8f76yktTxDrT7JJymY3wVAusXiD3fVvX`, Sami's legacy key)
+remains in effect if no runtime override is set.
+
+```bash
+# Rotate to a new publisher
+trianglesd settrustedv2snapshotpublisher TGotWuftzH7rD9tXC7whE8EXiyC3mr1CrH
+
+# Check current publisher
+trianglesd gettrustedv2snapshotpublisher
+
+# Revert to the compiled-in fallback
+trianglesd unsettrustedv2snapshotpublisher
+```
+
+The model is single-slot: calling `settrustedv2snapshotpublisher`
+atomically drops the previous publisher. See `docs/snapshot-publisher.md`
+for the full operator guide.
+
+### Encrypted Messaging
+
+Send and receive encrypted messages between wallet addresses:
+
+```bash
+# Enable messaging
+trianglesd smsgenable
+
+# Send a message
+trianglesd smsgsend <your-address> <recipient-address> "Hello from Triangles!"
+
+# Check inbox
+trianglesd smsginbox all
+
+# Send anonymous message
+trianglesd smsgsendanon <recipient-address> "Anonymous message"
+```
+
+Messages are encrypted end-to-end using AES and distributed through the peer network in time-bucketed batches.
+
+### Tor Support
+
+Triangles is designed as a Tor-only network. Install the Tor daemon and configure your proxy:
+```
+# triangles.conf
+proxy=127.0.0.1:9050
+```
+
+To run your own hidden service, add to `/etc/tor/torrc`:
+```
+HiddenServiceDir /var/lib/tor/triangles/
+HiddenServiceVersion 3
+HiddenServicePort 24112 127.0.0.1:24112
+```
+
+Then set `externalip=<your-onion-address>` in `triangles.conf`.
+
+## RPC Commands
+
+The JSON-RPC CLI is `triangles-cli`. For full flag reference, custom
+data-dir setups, and the full list of operations, see
+**[doc/triangles-cli.md](doc/triangles-cli.md)**. Quick start:
+
+```bash
+# Default datadir (Linux: ~/.cryptographic-triangles)
+triangles-cli getinfo
+
+# Custom datadir — most production nodes need this
+triangles-cli -datadir=/var/lib/triangles getinfo
+```
+
+### General
+- `getinfo` - Node status, balance, block height, connections
+- `getpeerinfo` - Connected peer details
+- `getstakinginfo` - Staking status and weight
+
+### Wallet
+- `getbalance` - Current balance
+- `listunspent` - Unspent transaction outputs
+- `sendtoaddress <addr> <amount>` - Send TRI
+- `getnewaddress` - Generate new receiving address
+
+### Messaging
+- `smsgenable` / `smsgdisable` - Toggle secure messaging
+- `smsgsend <from> <to> <message>` - Send encrypted message
+- `smsgsendanon <to> <message>` - Send anonymous message
+- `smsginbox [all|unread|clear]` - View received messages
+- `smsgoutbox [all|clear]` - View sent messages
+- `smsglocalkeys` - List messaging-enabled addresses
+- `smsgscanchain` - Scan blockchain for public keys
+
+### Trusted Snapshot Publisher (v6.1.8+)
+- `settrustedv2snapshotpublisher <address>` - Atomically replace the trusted snapshot publisher (previous one dropped immediately). Persists to `<datadir>/snapshot-publisher.json`.
+- `gettrustedv2snapshotpublisher` - Returns the currently active runtime publisher and whether a runtime override is in effect.
+- `unsettrustedv2snapshotpublisher` - Clear the runtime override and revert to the compiled-in fallback list.
+
+See `docs/snapshot-publisher.md` for the full operator guide.
+
+## Chain History
+
+- **July 16, 2014** - Genesis block
+- **Block 0-9000** - Proof-of-Work mining phase (Hash9)
+- **Block 9001+** - Proof-of-Stake only
+- **Block 17,651** - V5 hard fork (removed Tor v2, disabled checkpoint master key)
+- **December 8, 2022** - Chain frozen (all nodes offline)
+- **March 11, 2026** - Chain revived, staking resumed
+
+## Project Structure
+
+```
+src/
+  main.cpp          - Core blockchain logic, block/tx validation, message routing
+  miner.cpp         - Staking miner thread
+  net.cpp           - P2P networking
+  init.cpp          - Daemon initialization
+  wallet.cpp        - Wallet management
+  smessage.cpp/h    - Encrypted messaging system
+  kernel.cpp        - PoS kernel (stake validation)
+  checkpoints.cpp   - Hardcoded checkpoints
+  net_bootstrap.h   - DNS/IP seed configuration
+  onionseed.h       - Tor v3 onion seed addresses
+  tor/
+    onion_v3.cpp/h  - Tor v3 hidden service management
+    tor_crypto_compat.h - Ed25519/SHA3 crypto compatibility
+```
+
+## License
+
+Distributed under the MIT/X11 software license. See `COPYING` for details.
+
+## Links
+
+- Website: [cryptographic-triangles.org](https://cryptographic-triangles.org)
+- Explorer: [blocks.cryptographic-triangles.org](https://blocks.cryptographic-triangles.org)

ROCKSDB-DEFAULT-MIGRATION.md

@@ -0,0 +1,132 @@
+# RocksDB as the default chain database backend
+
+This change finishes the RocksDB chain-database backend, makes it the default,
+and provides a transparent migration path off LevelDB. **No consensus rules
+change** — only how the block index / tx index / UTXO set / address index are
+stored on disk. On-disk key bytes remain identical across both backends, which
+is what the migration and the dual-backend equivalence tests rely on.
+
+## What changed
+
+### 1. Fixed the column-family iteration bug (the real "unfinished" blocker)
+
+The RocksDB backend routed keys into per-prefix **column families**
+(`blockindex`, `txindex`, `utxo`, `addrindex`) on write, but the read path —
+both `CRocksTxDB::NewIterator()` and `CRocksTxDB::LoadBlockIndex()` — only ever
+iterated the **default** column family. With column families enabled:
+
+- `LoadBlockIndex()` loaded **zero** blocks (block-index records were in a
+  non-default CF the loader never scanned),
+- UTXO snapshot dumps and address-index range scans saw nothing, and
+- the migration verifier `CollectStats()` reported a record-count mismatch.
+
+This is why `-chaindb=rocksdb` "compiled clean but was never runtime-valid."
+
+**Fix:** column-family partitioning is disabled. `GetCF()` now always returns
+the default CF, so writes, point reads, `Exists`, `Erase`, and full-keyspace
+iteration are mutually consistent — and byte-identical to the single-keyspace
+LevelDB backend. New databases are created single-CF; pre-existing experimental
+multi-CF databases are still opened (for compatibility) but should be
+re-migrated or reindexed. RocksDB still delivers its performance win from
+parallel compaction, bloom filters, large write buffer, and block cache — the
+CF split was a premature optimization, not the source of the speedup.
+
+Re-introducing column families is a tracked follow-up that first requires
+CF-aware iterators (a multiplexed merge across CFs) in `NewIterator()` /
+`LoadBlockIndex()`.
+
+### 2. Automatic LevelDB -> RocksDB migration on startup
+
+`init.cpp` now runs the migration automatically when RocksDB is the active
+backend and the only chain DB present is a legacy `txleveldb/` (no `rocksdb/`
+yet). `MaybeMigrateLevelDbToRocksDb()` is a no-op when there is nothing to
+migrate, so it is safe on every launch. The LevelDB source is never modified;
+it remains a fallback.
+
+### 3. RocksDB is now the default backend
+
+`-chaindb` defaults to `rocksdb` (was `leveldb`). LevelDB stays selectable with
+`-chaindb=leveldb` and is retained as migration source + fallback. Full removal
+of LevelDB is deferred to a later phase, after live-chain validation.
+
+### 4. Fixed `NeedsBootstrap()` to recognize the RocksDB directory
+
+`Bootstrap::NeedsBootstrap()` checked for `txleveldb/` but not `rocksdb/`. With
+RocksDB as default, a fully-synced rocksdb-only node would have been treated as
+"fresh" and could have triggered a bootstrap download over a healthy chain on
+every restart. It now treats a `rocksdb/` directory as an existing chain DB.
+
+## Files changed
+
+- `src/txdb-rocksdb.cpp` — disable CF routing; single-CF open; remove dead CF tables
+- `src/txdb-rocksdb.h` — update CF member docs
+- `src/txdb-factory.cpp` — default backend `leveldb` -> `rocksdb`
+- `src/txdb.h` — update factory doc comment
+- `src/init.cpp` — auto-migrate on startup when RocksDB active + legacy LevelDB present
+- `src/bootstrap.cpp` — `NeedsBootstrap()` recognizes `rocksdb/`
+- `src/test/chaindb_runtime_tests.cpp` — update default-backend expectations
+- `README.md` — document RocksDB default + migration
+
+## Build
+
+```bash
+cmake -B build -G Ninja -DBUILD_QT=ON -DBUILD_TESTS=ON
+cmake --build build
+```
+
+RocksDB is required (`librocksdb-dev` >= 7.4 on Debian/Ubuntu,
+`mingw-w64-x86_64-rocksdb` on MSYS2, `rocksdb` on Homebrew).
+
+## Tests
+
+```bash
+# RocksDB wrapper runtime smoke tests (the class the daemon uses at runtime)
+./build/bin/test_chaindb_runtime
+
+# LevelDB/RocksDB byte-for-byte migration equivalence
+./build/bin/test_chaindb_equivalence
+
+# Full unit suite
+./build/bin/test_triangles
+```
+
+Expected after this change:
+- `get_chain_data_dir_default_is_rocksdb` passes (default resolves to rocksdb).
+- `iterator_walks_every_key_in_sorted_order` passes (the `"banana"` key, which
+  previously routed to a non-default CF the iterator never read, now lives in
+  the default CF and is iterated).
+- Migration verification (`CollectStats` / `StatsMatch`) passes end-to-end.
+
+## Live-chain validation checklist (V6 task T010)
+
+This is the step that cannot be done without real chain data and must be run on
+a node before release:
+
+1. **Migrate a real chain.** On a node with an existing `txleveldb/`, launch the
+   new binary (default backend). Confirm the log shows
+   `ChainDB: RocksDB backend active with a legacy LevelDB present; migrating
+   automatically.` followed by `ChainDB migration: verified N records ... best=<hash>`.
+2. **Verify block index loads.** Confirm `LoadBlockIndex()` reports the correct
+   `height=` and `hashBestChain=` (matching the prior LevelDB tip), not 0.
+3. **Compare RPC output.** `getinfo`, `getblockcount`, `getbestblockhash`, and a
+   spot-check of `gettxout` / address-index queries must match a LevelDB run of
+   the same datadir (`-chaindb=leveldb`).
+4. **Restart twice.** Confirm no spurious bootstrap download fires and the tip is
+   stable across restarts.
+5. **Sync new blocks.** Let the node accept and stake new blocks; confirm UTXO
+   set and money supply stay consistent.
+6. **Benchmark.** Use `contrib/bench/bench-chaindb.sh --backends=rocksdb` vs
+   `leveldb` to confirm the speedup on this hardware.
+
+## Rollback
+
+Set `-chaindb=leveldb` in `triangles.conf` (or on the command line). The
+original `txleveldb/` is untouched by migration, so reverting is immediate.
+
+## Remaining follow-ups
+
+- CF-aware iteration, then re-enable column-family partitioning for independent
+  compaction/caching.
+- Retire LevelDB entirely (remove `txdb-leveldb.*`, drop the `-chaindb=leveldb`
+  option and the bundled LevelDB dependency) once RocksDB is validated in
+  production for at least one release cycle.

SECURITY.md

@@ -0,0 +1,66 @@
+# Security Policy
+
+Triangles is wallet software and should be treated as security-sensitive. Do
+not use an experimental build to custody funds that you cannot afford to lose.
+
+## Reporting a vulnerability
+
+Please report suspected vulnerabilities through a private GitHub security
+advisory for this repository. Do not include secrets, wallet files, seed
+phrases, private keys, or live RPC credentials in an issue, pull request, log,
+or test fixture.
+
+Include the affected commit, platform, reproduction steps, impact, and a
+minimal proof of concept when possible. Public disclosure should wait until a
+fix is available and users have had a reasonable upgrade window.
+
+## Deployment boundary
+
+The JSON-RPC protocol uses HTTP Basic authentication and does not provide TLS.
+Keep it on loopback or a private Unix host boundary. Never expose the RPC port
+directly to the internet.
+
+For application integrations:
+
+- Run `trianglesd` as a dedicated, unprivileged operating-system user.
+- Bind RPC explicitly to loopback with `rpcbind=127.0.0.1`.
+- Use a unique random RPC username and password stored in a mode `0600` file.
+- Set `rpcallowip=127.0.0.1` and an exact `rpcallowmethod` list.
+- Keep `rest=0`, `upnp=0`, and wallet RPC methods disabled unless required.
+- Do not pass RPC passwords on a process command line.
+- Separate the node wallet and files from the integrating application's user.
+- Start new integrations with an empty wallet and no production funds.
+
+The container image runs as UID/GID `10001` and intentionally does not create
+or print RPC credentials. Mount a private `/var/lib/triangles` volume containing
+an owner-only `triangles.conf`; startup without valid RPC credentials fails with
+a nonzero exit status. Do not provide wallet or RPC secrets through Docker
+command arguments or environment variables.
+
+Set `listen=0` when inbound P2P is unnecessary. When inbound peers are needed,
+use `bind=<address>` and publish only the P2P port. The RPC port must remain
+unpublished and loopback-bound.
+
+Remote snapshot bootstrap is opt-in. A snapshot is accepted only when its file
+hash and checkpoint are compiled into the client. Treat changes to snapshot
+hashes, checkpoints, seed hosts, release keys, submodule revisions, and CI
+workflows as security-critical review items.
+
+## Wallet handling
+
+- Encrypt wallets before funding them.
+- Record the HD mnemonic offline and test recovery on an isolated machine.
+- Keep multiple offline backups; filesystem permissions are not a backup.
+- Encrypting the live wallet does not retroactively encrypt old copies,
+  migration backups, snapshots, or filesystem remnants. Inventory and protect
+  every pre-encryption copy as if it contains plaintext private keys.
+- Never share a seed phrase with support personnel or paste it into an RPC call.
+- Stop the node and investigate any wallet database integrity error rather than
+  attempting to continue with a partially loaded wallet.
+
+## Build trust
+
+Build from a reviewed commit, initialize submodules at the recorded revisions,
+and verify release signatures against a key fingerprint obtained through an
+independent trusted channel. A valid signature proves key possession, not the
+identity of the key owner.

SYNC-SECURITY-AUDIT-2026-06-21.md

@@ -0,0 +1,279 @@
+# Sync Security Audit — 2026-06-21 (Phase 1.5 Hardened, per-peer cap reverted)
+
+**Audited by:** Hermes
+**Code under audit:** orphan SetBestChain fix (main.cpp:3177-3201) and network pipeline changes (syncmanager.h, syncmanager.cpp) + Phase 1.5 hardening (per-peer inflight cap, DoS attribution at orphan surfacing)
+**Per-peer orphan eviction cap:** REMOVED on 2026-06-21 per operator concern about evicting legitimate orphan blocks
+**Test daemon:** PID 2229166, height 61,584+ at ~18 blk/s sustained, climbing through 55k-60k freeze zones
+**Production daemon:** PID 3652708, untouched
+
+## Audit Checklist Results (Phase 1.5 Hardened)
+
+### 1. DoS scoring still fires on bad peer data
+- **PASS** — main.cpp:4446-4449: `if (block.nDoS) pfrom->Misbehaving(block.nDoS);` runs after every block receive
+- **PASS** — main.cpp:3260-3274: **NEW** — Phase 1.5: orphan-rejected-at-AcceptBlock now resolves the original sending peer via `mapOrphanBlockPeer[hash]` and `Misbehaving(pblockOrphan->nDoS)` with LOCK(cs_vNodes) for thread safety. The peer attribution gap is CLOSED.
+- **PASS** — main.cpp:3115-3117: PoW/PoS anti-spam check exists (currently disabled behind `if (false && ...)` for sync)
+
+### 2. Per-peer orphan cap exists and is enforced
+- **REVERTED 2026-06-21** — main.cpp:3160-3241 (Phase 1.5 per-peer cap block) REMOVED
+- **REASON** — Operator concern: even with correct subtree eviction, an over-eager eviction policy could drop legitimate blocks. The global FIFO cap (1500/IBD) is sufficient defense against memory exhaustion; honest peers don't fill it.
+- **RETAINED** — main.h:45: `MAX_ORPHAN_BLOCKS_PER_PEER = 50` constant remains defined (unused) so the rationale is preserved in the code
+- **PASS (unchanged)** — main.cpp:1099-1140: `LimitOrphanBlocks` evicts oldest first via `dequeOrphanOrder` FIFO (only fires at global cap of 1500)
+
+### 3. Rate-limit by peer, not globally
+- **PASS** — syncmanager.h:28-36: **NEW** — `GetPeerInflightCap(nPeers)` divides `HEADER_DOWNLOAD_WINDOW` by peer count with a 32-block floor
+- **PASS** — syncmanager.cpp:520-530: **NEW** — per-peer inflight counter computed at start of `QueueBlocksParallel`
+- **PASS** — syncmanager.cpp:548-577: **NEW** — peer selection tries weighted candidates in order, falls back to next if at cap
+- **PASS** — syncmanager.h:38 + syncmanager.cpp:13-25: **NEW** — `HeaderNode.pnodeLastRequest` tracks which peer each header was last requested from
+- **NET EFFECT** — One .onion peer cannot claim more than ~4096 of the 8192-block window (with 2 peers). Malicious peer's damage is capped.
+
+### 4. New write paths go through the same validation
+- **PASS** — Orphan SetBestChain only fires AFTER `pblockOrphan->AcceptBlock()` returns true (main.cpp:3177)
+- **PASS** — main.cpp:3079: `pblock->CheckBlock(true, true, !IsInitialBlockDownload())` — full validation when not in IBD
+- **PASS** — main.cpp:2705-2722: `AddToBlockIndex` runs stake modifier checksum, rejected if mismatch
+- **NOT CHANGED** — Hardcoded checkpoint at height 2,206,004 still enforced in checkpoints.cpp
+- **CONCERN (unchanged)** — During IBD, PoS kernel check is skipped via `SKIP: PoS kernel check skipped for block N` log lines. This is correct for the hardcoded checkpoint window.
+
+### 5. Persistent state integrity during reorgs
+- **PASS** — main.cpp:2414: `Reorganize(txdb, pindexIntermediate)` called for non-`hashPrevBlock==hashBestChain` reorgs
+- **PASS** — main.cpp:2354: `if (!ConnectBlock(...) || !txdb.WriteHashBestChain(hash) || !UpdateAddressIndexSyncState(...))` — atomic write
+- **PASS** — main.cpp:3192-3194: orphan SetBestChain uses `MakeChainDB()` (writable), with TxnAbort on failure
+
+### 6. Error path doesn't leak resources
+- **PASS** — main.cpp:3146: `LimitOrphanBlocks` runs on every insert
+- **PASS** — main.cpp:3276: **NEW** — Phase 1.5: `mapOrphanBlockPeer.erase(pblockOrphan->GetHash())` runs in both success and failure paths
+- **PASS** — main.cpp:1145: **NEW** — Phase 1.5: `mapOrphanBlockPeer.erase(evictHash)` added to LimitOrphanBlocks eviction path
+- **PASS** — main.cpp:3204-3205: **NEW** — Phase 1.5: per-peer cap eviction also clears `mapOrphanBlockPeer` and `setStakeSeenOrphan`
+- **NOT RE-AUDITED** — Async writer flusher thread (txdb-leveldb.cpp) not re-audited in this pass. The flusher thread's error-path safety should be reviewed separately.
+
+### 7. Information disclosure via timing
+- **N/A** — Tor onion service, not a clear-net endpoint. Attack model mitigated by Tor design.
+- **RESIDUAL** — Block delivery latency to a specific peer is measurable. Mitigation is non-trivial; out of scope.
+
+## Summary (Phase 1.5 — per-peer cap reverted)
+
+| Item | Before Phase 1.5 | After Phase 1.5 (reverted) |
+|------|------------------|----------------------------|
+| 1. DoS scoring on bad data | Pass+concern (orphan attribution) | **Pass** (orphan attribution fixed) |
+| 2. Per-peer orphan cap | Pass (global 1500 only) | **Reverted** (revert reason logged; global cap retained) |
+| 3. Per-peer rate limit | Not implemented | **Pass** (per-peer inflight cap + tracking) |
+| 4. New writes go through validation | Pass | Pass |
+| 5. Reorg safety | Pass | Pass |
+| 6. Error path resource leaks | Pass | **Pass** (added peer tracking cleanup) |
+| 7. Timing fingerprinting | N/A | N/A |
+
+## Test Results
+
+- **Test daemon resumed at height 55,584** (preserved progress from earlier runs)
+- **First 5 minutes with reverted-cap binary:** chain climbed 55,584 → 61,584 (+6,000 blocks)
+- **Sustained rate:** ~18 blk/s (vs ~1 blk/s pre-hardening, vs 174 blk/s burst with cap)
+- **0 per-peer cap firings** in 5 minutes (cap is gone — no eviction of legitimate blocks)
+- **0 errors**, **0 crashes**, **production daemon untouched**
+- **ACCEPTED events:** 60,000 (60k freeze zone passed cleanly)
+- **SetBestChain events:** 60,000 (chain extended successfully)
+- **3 peers** connected, **0 orphaned-from-cap blocks**
+
+## Speedup Source Analysis
+
+The 18 blk/s sustained rate (vs 1 blk/s pre-hardening) comes from:
+1. **Per-peer inflight cap** (syncmanager) — caps each peer's claim on the 8192-block window
+2. **Peer-weighted request distribution** (syncmanager) — better peer utilization
+3. **Network pipeline changes** (syncmanager.h) — HEADER_DOWNLOAD_WINDOW 1024→8192
+4. **DoS attribution** (main.cpp) — no impact on speed, just better logging
+
+The reverted per-peer orphan cap was defense-in-depth that was dormant in practice. Its absence has no impact on throughput.
+
+## Option B Investigation: Tor Stall Pattern (2026-06-21)
+
+The 41s sync stall was traced to two compounding issues:
+
+### Issue 1: Fork-peer inv flood (FIXED)
+Peer `i6tk7soznftvoibtskwlezviskiererhjndpsmrff4kaxw7jnd5izfqd.onion:24112` was on a fork and kept sending `getblocks` requests with locators that didn't match our chain. The fork-detection code served them 10,000 invs per request. The counter went 1→2→3→...→10 and reset, repeating indefinitely. **Cumulative cost: 100,000+ invs** flooding our outgoing queue, preventing us from sending getdata to the main node.
+
+**Fix applied** (main.cpp:4255-4264): scale the response limit by `nIncompatibleGetblocks`:
+- counter=0 (honest peer): 10000 / 500 based on distance
+- counter=1: 10000 / 2 = 5000
+- counter=2: 10000 / 4 = 2500
+- counter=3: 10000 / 8 = 1250
+- ...
+- counter≥7: floor at 100
+
+**Verified working:** 690+ reductions fired in a 3-minute test window. The fork peer can no longer flood our outgoing queue.
+
+### Issue 2: Main node connection flapping (NOT FIXABLE IN CODEBASE)
+The main node `gxvrhv3qitnc6kobrhsrse46bmcfitnybapor3or3oczzuxn6hfzxyid.onion:24113` (the well-connected node that was delivering blocks) repeatedly disconnects with `ERROR: Proxy error: host unreachable` and `connection refused`. The daemon then has to wait for Tor to re-establish the hidden service. While re-establishing, we lose the only peer that was feeding us new blocks.
+
+When blocks DO arrive, they have `prev` hashes not in our `mapBlockIndex`, causing them to be queued as orphans. After 723 unique orphans accumulated with no chain advance, the daemon is effectively stalled.
+
+**Root cause:** Tor hidden service reliability for the main node. This is a network/deployment issue, not a Triangles code issue.
+
+### Conclusion
+
+- **Issue 1 fix is in main.cpp and working.** Sync is more resilient to fork peers.
+- **Issue 2 cannot be fixed in the Triangles codebase.** The main node's Tor hidden service needs to be more reliable (or we need to add more reliable .onion peers to the seed list).
+- **The 18 blk/s sustained rate is the actual ceiling** for this Tor peer set. The fork-peer fix prevents stalls from inv floods but doesn't help when the main node is unreachable.
+
+### Recommended Next Steps (beyond code)
+
+1. Add more reliable .onion peers to the seed list in `seeds.cryptographic-triangles.org`
+2. Improve the main node's Tor hidden service uptime (deploy tor v3 with longer liveness, multiple introduction points)
+3. Add a peer-scoring system that downgrades flaky peers and prefers reliable ones
+
+These are operational improvements, not code changes.
+
+---
+
+## Addendum (2026-06-21, end-of-day): Corrupted .onion Address & Signed Peer Discovery
+
+After the above audit was written, two more findings emerged that warrant
+their own section.
+
+### Finding 8: Corrupted v3 onion address in test config (real bug, production-safe)
+
+**Symptom:** During the running from-zero sync test (PID 2394385), the
+embedded Tor log at `/root/.triangles-synctest/tor_data/tor.log` produced:
+
+    4,842 occurrences of: "Closed streams for service [scrubbed].onion for reason resolve failed. Fetch status: No more HSDir available to query."
+    181 occurrences of: "ed25519 validation failed"
+    181 occurrences of: "Service address [scrubbed] has bad pubkey"
+    181 occurrences of: "Invalid onion hostname [scrubbed]; rejecting"
+
+The first instinct was "Tor is broken" — but the same Tor instance
+worked fine for clearnet (`https://check.torproject.org/api/ip` returned
+`{"IsTor":true,"IP":"192.42.116.60"}`) and for known .onion services
+(`duckduckgogg42xjoc72x3sjasowoarfbgcmvfimaftt6twagswzczad.onion`
+returned HTTP 301 in 3.5s).
+
+**Root cause:** One of the 14 addnodes in `/root/.triangles-synctest/triangles.conf`
+had a 1-character transposition:
+
+| Source | Address |
+|---|---|
+| `src/onionseed.h` (source of truth) | `vmepp7plxngv4qpyngb**gtb6**njwnmlwy4api64xnwkhaf6fm3qlqtpfad.onion` |
+| `/root/.triangles/triangles.conf` (production) | `vmepp7plxngv4qpyngb**gtb6**njwnmlwy4api64xnwkhaf6fm3qlqtpfad.onion` ✓ |
+| `/root/.triangles-synctest/triangles.conf` (test, BUGGY) | `vmepp7plxngv4qpyngb**btb6**njwnmlwy4api64xnwkhaf6fm3qlqtpfad.onion` ✗ |
+
+The character `g` was corrupted to `b` at position 21. Tor's v3 onion
+checksum validation (`SHA3-256(".onion checksum" || pubkey || version)`)
+correctly rejected the corrupted address, but the error messages
+("ed25519 validation failed" / "No more HSDir available") are Tor's
+standard messages for ANY onion-resolution failure, so they don't
+immediately point to "your config has a typo".
+
+**Why this matters more than the immediate symptom:**
+
+This is exactly the kind of silent corruption that a signed peer
+discovery system would catch at the daemon layer. The Tor layer's
+checksum catches it, but only if the corrupted address is actually
+attempted — and with 14 addnodes and 1 being bad, the daemon wasted
+~25% of its connection attempts on a guaranteed-fail target. A signed
+peer system (where peers' .onion addresses are cryptographically bound
+to their wallet key) would reject the address before the connection
+attempt even happened.
+
+**Fixes deployed:**
+
+1. **One-character config fix** in `/root/.triangles-synctest/triangles.conf`:
+   `btb6` → `gtb6`. Production was never affected.
+
+2. **New tool: `scripts/validate_onion_seeds.py`** — validates every
+   `.onion` in a `triangles.conf` against the v3 hidden service checksum.
+   Detects the `btb6` corruption in 0.1s with full diagnostic including
+   "did you mean: gtb6?" suggestion. Pure stdlib, no pip deps.
+
+3. **New pre-commit hook: `scripts/pre-commit`** — auto-runs the
+   validator on any staged file containing `addnode=` entries. Blocks
+   the commit if any address fails. Installed at
+   `.git/hooks/pre-commit`. Bypass with `git commit --no-verify` (NEVER
+   do this for normal commits).
+
+4. **New C++ test: `src/test/onion_v3_tests.cpp`** — 8 Boost.Test cases
+   that validate every hardcoded seed in `src/onionseed.h` against the
+   v3 onion checksum. Runs in CI on every build. Catches corruption at
+   compile time, not daemon runtime.
+
+### Finding 9: Signed peer discovery (real architectural improvement)
+
+The above finding surfaced a bigger gap: Triangles HAS a node-identity
+signing system (`getwalletaddr`/`walletaddr` in `src/tor/onion_v3.cpp:4793-4848`)
+but it only fires at startup. After 18 hours of sync, the daemon has
+zero ability to find new peers.
+
+**The existing system (already in place, just under-used):**
+
+1. **Node identity proof** (`main.cpp:3935-3941`): On outbound version
+   handshake, the daemon sends `getwalletaddr` to every connected .onion
+   peer. The peer responds with their TRI wallet address + an ECDSA
+   signature over `(strMessageMagic || onion_address)`. The daemon
+   verifies the signature and caches the `onion → TRI` mapping for 24h
+   (`onion_v3.cpp:2308`).
+
+2. **Seeder list exchange** (`main.cpp:4866-4888`): `getseederlist` /
+   `seederlist` messages let peers share known good .onion seeders.
+
+3. **Standard `getaddr`/`addr`** (`main.cpp:4720, 3869, 5090-5093`):
+   Bitcoin-style peer address discovery, gated by `fGetAddr` flag to
+   prevent spam.
+
+**The fix shipped in commit `9e9d17e`:**
+
+1. **`src/net.h`** — added `nLastGetaddrTrigger` + `nSignedPeerBonus`
+   fields to `CNode`.
+
+2. **`src/net.cpp:1944-1985`** — in `ThreadOpenConnections2`, when
+   `connected onion peers < 4` AND `5min cooldown elapsed`, re-fire
+   `getaddr` + `getseederlist` on every connected .onion peer. Logs
+   `SYNC-SIGN: low peer count (X < 4), re-firing discovery round on all peers`.
+
+3. **`src/tor/onion_v3.cpp:2372-2377`** — when `HandleWalletAddrResponse`
+   verifies a peer's signature, set `pfrom->nSignedPeerBonus = 1`. Logs
+   `SYNC-SIGN: marked X as signed peer (proved identity via walletaddr)`.
+
+4. **`src/syncmanager.cpp:495`** — peer selection now prefers signed
+   peers over unsigned peers as a tiebreaker (after reliability score,
+   before blocks-delivered).
+
+**Verified at runtime:**
+
+    SYNC-SIGN: low peer count (0 < 4), re-firing discovery round on all peers
+    SYNC-SIGN: low peer count (1 < 4), re-firing discovery round on all peers
+    SYNC-SIGN: marked X as signed peer (proved identity via walletaddr)
+
+The signed peer bonus means that once a peer completes the walletaddr
+handshake, they're preferred in block delivery — making the network
+self-strengthening: nodes that prove identity get more traffic, which
+incentivizes more nodes to prove identity.
+
+### Defense-in-depth summary (end of 2026-06-21)
+
+The from-zero sync test, the corruption bug, and the signed-peer
+improvement together produced 4 layers of defense against the same
+class of problem (peer discovery / address corruption):
+
+| Layer | Mechanism | What it catches | When |
+|---|---|---|---|
+| 1. Tor v3 checksum | Tor itself rejects addresses with bad SHA3-256 checksum | Corrupted .onion addresses | Always (network layer) |
+| 2. `scripts/validate_onion_seeds.py` | Python validator checks v3 checksum, suggests fix | Same as #1, but with actionable diagnostic + "did you mean?" | Pre-commit / pre-deploy |
+| 3. `src/test/onion_v3_tests.cpp` | 8 Boost.Test cases run in CI | Hardcoded seed corruption in `onionseed.h` | Every build |
+| 4. Signed peer discovery | `getwalletaddr` ECDSA handshake + `nSignedPeerBonus` preference | Sybil attackers + ephemeral malicious peers | At runtime |
+
+### Remaining gaps (2026-06-21)
+
+1. **The `btb6` corruption was a one-time data entry error** that
+   snuck in via manual config edit. There's no audit log of when/who
+   introduced it. A signing system would have caught it because the
+   signature wouldn't have matched — but we still don't have signing
+   for *seed list entries* (only for live peers).
+
+2. **The seed list at `seeds.cryptographic-triangles.org` is not
+   cryptographically signed.** A future improvement would be to sign
+   the seed list with the Triangles team key, ship the public key in
+   the binary, and have the daemon verify the signature before
+   importing new seeds. This is the same pattern Bitcoin Core uses
+   for its `chainparams.cpp` checkpoints.
+
+3. **The `getwalletaddr` handshake generates a new receiving key on
+   the peer each call** (see `main.cpp:4814: pwalletMain->GetKeyFromPool`).
+   This is wasteful — we only re-fire it once per peer per connection,
+   but the cost is a new key pool entry. Future work: use a stable
+   node identity key separate from the wallet.
+

TRIANGLES-RPC-COMMANDS.md

@@ -31,6 +31,9 @@ Triangles is a Tor-only PoS cryptocurrency. PoW ended at block 9000; from block
 | `getrawmempool` | | Returns all transaction IDs currently in the mempool. |
 | `getcheckpoint` | | Returns info about the current synchronized checkpoint. |
 | `getchaintips` | | Returns info about all known chain tips (forks). |
+| `settrustedv2snapshotpublisher` | `<address>` | Atomically replaces the trusted snapshot publisher. The previous publisher is dropped immediately (no grace period). The new publisher is persisted to `<datadir>/snapshot-publisher.json`. Returns `{ previous, current }`. See `docs/snapshot-publisher.md`. |
+| `gettrustedv2snapshotpublisher` | | Returns the currently active trusted snapshot publisher and whether a runtime override is in effect. Returns `{ active, has_runtime_override }`. |
+| `unsettrustedv2snapshotpublisher` | | Clears the runtime trusted snapshot publisher override. Reverts to the built-in fallback list (compiled in). Removes `<datadir>/snapshot-publisher.json`. |
 | `invalidateblock` | `<hash>` | Permanently marks a block as invalid and rewinds the chain past it. |
 | `reconsiderblock` | `<hash>` | Removes the invalid mark from a previously invalidated block. |
 | `recalculatesupply` | | Recalculates money supply by summing all UTXOs. Updates the stored value at the chain tip and persists to disk. Returns old/new supply and difference. |

V6_TASKS.md

@@ -107,6 +107,13 @@
 
 ## P2 — Polish & Optimization
 
+### T024: PoS reward exact-proportionality rework — REJECTED
+- **Status**: REJECTED
+- **Depends**: none
+- **Description**: Audit review of 2a4da33 (PoS reward rework, reverted by 05b5606) and 239cf61 (sigcache fix, reverted by 36d5f29) on 2026-07-07 concluded the PoS reward rework must stay reverted. Reasons: (1) consensus split risk — round-half-up pays 1 unit more than truncation for ~half of all inputs, so a block claiming that unit is valid to upgraded nodes and rejected by un-upgraded nodes; (2) motivation gone — the only driver was a unit-test assertion of exact proportionality (a78a420 already relaxed it to ±1 truncation), which is aesthetic, not correctness; (3) the new formula is worse than advertised — pre-truncating coin-age to whole-COIN units *before* multiplying drops fractional coin-age that the old formula credited, and `nWholeCoinAge * RATE * 2` is int64_t and can overflow. If exact proportionality is ever truly wanted, it must ship as a height-gated hard fork (both formulas in code, switch at activation height, coordinated node upgrade). Not worth it for cosmetic rounding. The sigcache fix from the same review (239cf61) was approved and re-landed in PR #21 / branch `fix/sigcache-false-positives` as a 6.1.6 candidate.
+- **Files**: `src/main.cpp` (GetProofOfStakeReward)
+- **Acceptance**: none — task is to leave the code as-is and not reopen
+
 ### T020: Remove unused Gemini/Google references from codebase
 - **Status**: TODO
 - **Depends**: none

WALLET-SQLITE-MIGRATION.md

@@ -0,0 +1,98 @@
+# Wallet storage: Berkeley DB → SQLite
+
+Goal: retire Berkeley DB as the wallet store and make **SQLite the default**
+wallet backend, with a transparent, non-destructive migration of existing
+`wallet.dat` files. This removes the single ugliest build dependency (BDB 5.3
+with C++ bindings, hand-built on RHEL/MSYS2) and gives the wallet a modern,
+maintainable, single-file store — the kind exchanges expect.
+
+No consensus or wire behavior changes. The on-disk *record encoding* is
+unchanged: keys and values are the exact `SER_DISK / CLIENT_VERSION` bytes
+`CWalletDB` already produces, just stored as `(key BLOB, value BLOB)` rows in
+SQLite instead of Berkeley B-tree entries. That byte-for-byte identity is what
+makes migration a verbatim copy.
+
+## Delivered in this pass
+
+New, self-contained modules (do not disturb the working Berkeley path):
+
+| File | Purpose |
+|------|---------|
+| `src/walletdb-base.h` | Backend-agnostic seam: `WalletDatabase`, `WalletBatch` (raw byte Read/Write/Erase/Has + cursor + txn), `WalletCursor`; `ResolveWalletDbKind()` / `MakeWalletDatabase()` declarations. |
+| `src/walletdb-sqlite.h/.cpp` | `SQLiteDatabase` / `SQLiteBatch` — single `main(key BLOB PRIMARY KEY, value BLOB)` table, `synchronous=FULL`, prepared statements, transactions, cursor, online-backup, `integrity_check`. App-id/user-version stamping to reject foreign DBs. |
+| `src/walletmigrate.h/.cpp` | `MaybeMigrateBerkeleyWalletToSQLite()` — detects a Berkeley `wallet.dat`, copies every record verbatim into a temp SQLite file, verifies the row count, backs up the original to `wallet.dat.bdb.bak`, then swaps SQLite into place. Idempotent and non-destructive. |
+| `src/walletdb-factory.cpp` | `ResolveWalletDbKind()` (default **sqlite**, `-walletdb=bdb` fallback) and `MakeWalletDatabase()` (SQLite implemented). |
+| `src/walletdb-batch.h` | `CWalletBatchTyped` — typed Read/Write/Erase/Exists + cursor over `WalletBatch`, byte-identical to the old `CDB` templates. The drop-in base for `CWalletDB`. |
+
+Build wiring:
+- `find_package(SQLite3 REQUIRED)` in the top-level `CMakeLists.txt`.
+- `SQLite::SQLite3` linked into `triangles_common`; the new sources added to `CORE_SOURCES`.
+
+## Remaining integration (compile-in-the-loop)
+
+The new modules are complete but `CWalletDB` is not yet routed through the seam
+— it still inherits Berkeley `CDB`. This is the mechanical-but-careful step that
+needs a compiler in the loop. **It must be done and landed as one unit** (it
+touches `walletdb.h`, `walletdb.cpp`, `wallet.cpp`, `db.cpp`, and `init.cpp`):
+re-basing ~800 lines of funds-critical code is exactly the kind of change that
+should be compiled and run against a real `wallet.dat` rather than committed
+blind.
+
+1. **Typed wrappers over the batch — DONE.** `src/walletdb-batch.h`
+   (`CWalletBatchTyped`) provides `Read/Write/Erase/Exists` + cursor over a
+   `WalletBatch`, byte-identical to `CDB`'s templates. `CWalletDB` derives from
+   it instead of `CDB`.
+2. **Re-base `CWalletDB`.** Hold a `std::unique_ptr<WalletDatabase>` +
+   `WalletBatch` obtained from `MakeWalletDatabase("wallet.dat", err)` instead of
+   deriving from `CDB`. Route `TxnBegin/Commit/Abort` to the batch.
+3. **Cursors.** Replace `GetAtCursor` / `GetTxnCursor` / `ReadAtCursor`
+   (Berkeley `Dbc*`, `DB_NEXT`) in `walletdb.cpp` (`LoadWallet`,
+   `ReorderTransactions`) with `WalletBatch::GetNewCursor()` + `WalletCursor::Next()`.
+4. **Berkeley-specific call sites.**
+   - `BackupWallet()` / `AutoBackupWallet()` → `WalletDatabase::Backup()`.
+   - `CDB::Rewrite()` (used by `CWallet::EncryptWallet`) → `WalletDatabase::Rewrite()`
+     (VACUUM). Unencrypted-key cleanup already happens via explicit `Erase`.
+   - `bitdb.Flush()` / env shutdown in `init.cpp` → `WalletDatabase::Flush()/Close()`
+     (no-op for SQLite).
+5. **Berkeley behind the same seam (optional but recommended).** Add a thin
+   `BerkeleyDatabase`/`BerkeleyBatch` adapter wrapping the existing `CDBEnv`/`CDB`
+   so `-walletdb=bdb` routes through `MakeWalletDatabase` too, instead of the
+   legacy path. Keeps one code path for one release, then delete BDB entirely.
+6. **Run the migration on startup.** In `init.cpp`, before the wallet is loaded
+   and when the backend is SQLite, call
+   `MaybeMigrateBerkeleyWalletToSQLite(GetDataDir()/strWalletFileName, err)`.
+
+## Gating
+
+```
+trianglesd                 # SQLite (default)
+trianglesd -walletdb=bdb   # Berkeley fallback (retained for one release)
+```
+
+## Validation checklist (must pass before release)
+
+Cannot be verified without a build + a real wallet. Run on a node:
+
+1. **Build** with `-DBUILD_TESTS=ON`; confirm SQLite is found and linked.
+2. **Fresh wallet**: start with no wallet → a SQLite `wallet.dat` is created;
+   `getnewaddress`, `getinfo` work; restart preserves keys/balance.
+3. **Migration**: copy a real Berkeley `wallet.dat` into the datadir, start the
+   node. Confirm: `wallet.dat.bdb.bak` is created, `wallet.dat` is now SQLite
+   (`sqlite3 wallet.dat "PRAGMA integrity_check;"` → `ok`), and
+   `listaddressgroupings` / `getbalance` / `dumpwallet` match a `-walletdb=bdb`
+   run against the `.bdb.bak` original.
+4. **Key parity**: `dumpwallet` before (bdb) and after (sqlite); diff must be
+   empty (same keys, labels, metadata, HD seed).
+5. **Encryption**: `encryptwallet`, restart, `walletpassphrase`, sign/spend.
+6. **Backup/restore**: `backupwallet`, restore into a fresh datadir, verify
+   balance and spend.
+7. **Send/receive + staking** over a few blocks; confirm new keys/txns persist
+   across restart.
+8. **Crash safety**: kill -9 mid-write; restart; `integrity_check` ok, no loss.
+
+## Follow-ups
+
+- Add `test_wallet_sqlite` unit tests (round-trip, migration parity, cursor).
+- Once SQLite is validated for a release, remove `-walletdb=bdb`, delete
+  `db.cpp`/`walletdb`'s Berkeley code, and drop the `BerkeleyDB` CMake
+  dependency — completing the retirement.

cmake/AddCompilerFlags.cmake

@@ -7,6 +7,15 @@ add_compile_options(
     -Wformat -Wformat-security -Wno-unused-parameter
 )
 
+# Bitcoin-derived source uses C99-style adjacent string-literal concatenation
+# for printf format macros: `"%"PRId64`. gcc tolerates this without a space;
+# clang promotes `-Wreserved-user-defined-literal` to an error in C++20 mode
+# and trips on hundreds of sites in util.cpp, kernel.cpp, etc. Suppress only
+# under clang so gcc builds keep the original diagnostic behavior.
+if(CMAKE_CXX_COMPILER_ID STREQUAL "Clang" OR CMAKE_C_COMPILER_ID STREQUAL "Clang")
+    add_compile_options(-Wno-reserved-user-defined-literal)
+endif()
+
 # ── Common defines ──
 add_compile_definitions(
     BOOST_SPIRIT_THREADSAFE
@@ -47,6 +56,54 @@ if(CMAKE_SYSTEM_PROCESSOR MATCHES "i[3-6]86")
     add_compile_options(-msse2)
 endif()
 
+# ── x86-64 baseline ISA (portability across CPU vendors/models) ──
+# CRITICAL: Without this, GCC on Intel CI runners (Skylake-X, Ice Lake,
+# Sapphire Rapids) emits AVX-512 / AVX10 instructions (vmovdqu8, vpcompressd,
+# vpopcntd, etc.) for std::string / memcpy inlining that CRASH with SIGILL
+# on AMD EPYC (Milan, Genoa) and older Intel without AVX-512/AVX10.
+# x86-64-v2 = baseline from ~2009 (Nehalem): SSE4.2 + POPCNT + CMPXCHG16B.
+# Supported on EVERY x86_64 CPU Triangles runs on in production (DNS2, DNS3,
+# Hetzner ARM64 excluded — that's a different build). Do NOT raise to v3
+# (AVX2) without re-testing on every supported CPU; v3 is fine for most
+# modern hardware but adds risk on edge cases (early Ryzen, Atom).
+# Override with -DCMAKE_X86_64_BASELINE=OFF to disable (not recommended).
+if(CMAKE_SYSTEM_PROCESSOR MATCHES "^(x86_64|amd64|AMD64)$" AND NOT WIN32 AND NOT APPLE)
+    option(CMAKE_X86_64_BASELINE
+        "Compile with -march=x86-64-v2 (SSE4.2 baseline) for portability across CPU vendors"
+        ON)
+    if(CMAKE_X86_64_BASELINE)
+        add_compile_options(-march=x86-64-v2)
+        # -mtune=generic tells GCC the binary will run on CPUs other than the
+        # build host. Combined with -march=x86-64-v2 above, the scheduler
+        # picks instructions from the v2 subset only — no AVX-512 leaks.
+        add_compile_options(-mtune=generic)
+        # Belt-and-suspenders: explicitly disable AVX-512 / AVX10 / SVE
+        # family ISAs that GCC 11+ can otherwise autovectorize into via
+        # inlined libstdc++ std::string / std::copy / memcpy paths even when
+        # -march=x86-64-v2 is set. Discovered 2026-08-01: v6.1.9 binary built
+        # on EPYC 7763 (AVX-512) contained 741 vpbroadcastq EVEX instructions
+        # which crash with SIGILL on every production node (KVM EPYC,
+        # Ryzen 3600, ARM64) that lacks AVX-512. -mno-avx512f alone is
+        # enough to suppress the SIGILL; the -mno-*avx10/sve* siblings
+        # future-proof against the next GCC version autovectorizing
+        # beyond AVX-512. See references/avx-512-sigill-build-fix.md
+        # for the full diagnosis recipe.
+        # NB: -mno-avx512*4fmaps / -mno-avx512*4vnniw use NO dash between
+        # 'avx512' and the sub-feature (correct: -mno-avx5124fmaps). The
+        # -mno-avx512-4fmaps form (with a dash) is rejected by GCC and
+        # makes the whole build fail with "unrecognized command-line option".
+        if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR CMAKE_C_COMPILER_ID STREQUAL "GNU")
+            add_compile_options(
+                -mno-avx512f -mno-avx512pf -mno-avx512er -mno-avx512cd
+                -mno-avx512vl -mno-avx512bw -mno-avx512dq -mno-avx512ifma
+                -mno-avx512vbmi -mno-avx512vbmi2 -mno-avx512vnni
+                -mno-avx512bitalg -mno-avx512vpopcntdq
+                -mno-avx5124fmaps -mno-avx5124vnniw -mno-avx512vp2intersect
+            )
+        endif()
+    endif()
+endif()
+
 # ── Platform: Windows (MSYS2 MinGW64) ──
 if(WIN32)
     add_compile_options(-Wa,-mbig-obj)

cmake/aarch64-toolchain.cmake

@@ -0,0 +1,16 @@
+# CMake toolchain for cross-compiling to aarch64 (Pi 3/4/5)
+set(CMAKE_SYSTEM_NAME Linux)
+set(CMAKE_SYSTEM_PROCESSOR aarch64)
+
+set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc)
+set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++)
+
+set(CMAKE_FIND_ROOT_PATH /usr/aarch64-linux-gnu)
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH)
+set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE BOTH)
+
+# Also search the multiarch lib path
+set(CMAKE_LIBRARY_PATH /usr/lib/aarch64-linux-gnu)
+set(CMAKE_INCLUDE_PATH /usr/include)

cmake/armhf-toolchain.cmake

@@ -0,0 +1,15 @@
+# CMake toolchain for cross-compiling to armhf (Pi Zero/1/2/3 in 32-bit mode)
+set(CMAKE_SYSTEM_NAME Linux)
+set(CMAKE_SYSTEM_PROCESSOR arm)
+
+set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
+set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)
+
+set(CMAKE_FIND_ROOT_PATH /usr/arm-linux-gnueabihf)
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH)
+set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE BOTH)
+
+set(CMAKE_LIBRARY_PATH /usr/lib/arm-linux-gnueabihf)
+set(CMAKE_INCLUDE_PATH /usr/include)

cmake/mingw64.cmake

@@ -0,0 +1,70 @@
+# CMake toolchain file for cross-compiling Triangles for Windows x64 using MinGW on Linux
+# Usage: cmake -DCMAKE_TOOLCHAIN_FILE=cmake/mingw64.cmake -B build-mingw -S .
+
+set(CMAKE_SYSTEM_NAME Windows)
+set(CMAKE_SYSTEM_PROCESSOR x86_64)
+
+# MinGW toolchain
+set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
+set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)
+set(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres)
+
+# Search for programs only in the build host directories
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+
+# Search for libraries and headers only in the staging directory
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
+
+# Staging prefix — all dependencies installed here
+set(DEP_PREFIX "${CMAKE_SOURCE_DIR}/deps-mingw")
+
+# Windows libraries
+set(CMAKE_LIBRARY_PATH "${DEP_PREFIX}/lib")
+
+# Include directories
+set(CMAKE_INCLUDE_PATH "${DEP_PREFIX}/include")
+
+# Windows sysroot (MinGW libraries, headers, and tools)
+set(MINGW_SYSROOT /usr/x86_64-w64-mingw32)
+
+# Don't search the host system for programs
+set(CMAKE_FIND_ROOT_PATH /usr/x86_64-w64-mingw32 ${DEP_PREFIX})
+
+# For find_package(OpenSSL), find_package(Boost), etc.
+# Only search deps-mingw and MinGW sysroot — NOT the host system
+set(CMAKE_SYSROOT "${MINGW_SYSROOT}")
+set(OPENSSL_ROOT_DIR "${DEP_PREFIX}")
+set(BOOST_ROOT "${DEP_PREFIX}")
+set(CMAKE_PREFIX_PATH "${DEP_PREFIX}")
+
+# Critical: prevent Linux host headers from leaking into MinGW compilation
+# The MinGW cross-compiler should ONLY see MinGW and deps headers
+set(CMAKE_C_STANDARD_INCLUDE_DIRECTORIES "")
+set(CMAKE_CXX_STANDARD_INCLUDE_DIRECTORIES "")
+
+# Add MinGW and deps include paths explicitly
+include_directories(BEFORE SYSTEM
+  "${DEP_PREFIX}/include"
+  "${MINGW_SYSROOT}/include"
+  "${MINGW_SYSROOT}/include/c++"
+  "${MINGW_SYSROOT}/include/sec_api"
+)
+
+# Set output directories
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib")
+
+# C++20 for the project
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# Build settings
+set(BUILD_DAEMON ON)
+set(BUILD_QT OFF)
+set(BUILD_TESTS OFF)
+set(USE_UPNP OFF)
+set(USE_QRCODE OFF)
+set(USE_ZMQ OFF)
+set(USE_DBUS OFF)
+set(USE_TOR_EMBEDDED OFF)

contrib/nsis/setup.nsi

@@ -31,10 +31,6 @@ RequestExecutionLevel user
 
 !insertmacro MUI_PAGE_WELCOME
 !insertmacro MUI_PAGE_DIRECTORY
-
-; Bootstrap page
-Page custom BootstrapPage
-
 !insertmacro MUI_PAGE_INSTFILES
 !insertmacro MUI_PAGE_FINISH
 
@@ -43,34 +39,6 @@ Page custom BootstrapPage
 
 !insertmacro MUI_LANGUAGE "English"
 
-; Bootstrap selection variable
-Var BootstrapChoice
-
-; Bootstrap page function
-Function BootstrapPage
-  !insertmacro MUI_HEADER_TEXT "Blockchain Sync" "Choose how to synchronize the blockchain"
-  
-  nsDialogs::Create 1018
-  Pop $0
-  
-  ${NSD_CreateLabel} 0 10u 100% 20u "The Triangles blockchain requires ~1GB of data. Choose sync method:"
-  Pop $0
-  
-  ${NSD_CreateRadioButton} 10u 40u 100% 12u "Download bootstrap (~1.3GB) — Recommended (fast)"
-  Pop $1
-  ${NSD_Check} $1
-  
-  ${NSD_CreateRadioButton} 10u 60u 100% 12u "Sync from network — Slow (may take days)"
-  Pop $2
-  
-  ${NSD_CreateLabel} 10u 80u 100% 30u "Bootstrap will download a recent blockchain snapshot, saving hours or days of sync time. Network bandwidth required: ~1.3GB."
-  Pop $0
-  
-  nsDialogs::Show
-  
-  ${NSD_GetState} $1 $BootstrapChoice
-FunctionEnd
-
 Section "Install"
   SetOutPath "$INSTDIR"
 
@@ -84,25 +52,6 @@ Section "Install"
   ; Create data directory
   CreateDirectory "$APPDATA\Triangles"
 
-  ; Download blockchain bootstrap if selected
-  ${If} $BootstrapChoice == ${BST_CHECKED}
-    DetailPrint "Downloading blockchain bootstrap..."
-    inetc::get /CAPTION "Downloading Blockchain" /CANCELTEXT "Skip" \
-      "http://bootstrap.cryptographic-triangles.org/tri-blockchain.tar.gz" \
-      "$TEMP\tri-blockchain.tar.gz" /END
-    Pop $0
-    ${If} $0 == "OK"
-      DetailPrint "Extracting blockchain..."
-      nsExec::ExecToLog '"$INSTDIR\7z.exe" x "$TEMP\tri-blockchain.tar.gz" -o"$TEMP" -y'
-      nsExec::ExecToLog '"$INSTDIR\7z.exe" x "$TEMP\tri-blockchain.tar" -o"$APPDATA\Triangles" -y'
-      Delete "$TEMP\tri-blockchain.tar.gz"
-      Delete "$TEMP\tri-blockchain.tar"
-      DetailPrint "Blockchain bootstrap installed!"
-    ${Else}
-      DetailPrint "Bootstrap download failed or skipped — will sync from network"
-    ${EndIf}
-  ${EndIf}
-
   ; Uninstaller
   WriteUninstaller "$INSTDIR\uninstall.exe"
 

contrib/triangles.conf.example

@@ -0,0 +1,88 @@
+# triangles.conf.example — Cryptographic Triangles daemon configuration
+#
+# Copy this to ~/.triangles/triangles.conf and customize for your node.
+# Run scripts/validate_onion_seeds.py against your config before starting
+# the daemon to catch any .onion address corruption.
+#
+# Run order for a fresh operator:
+#   1. cp contrib/triangles.conf.example ~/.triangles/triangles.conf
+#   2. Edit credentials, port numbers, addnode list as needed
+#   3. python3 scripts/validate_onion_seeds.py ~/.triangles/triangles.conf
+#   4. /usr/lib/cryptographic-triangles/trianglesd -daemon
+#
+# The pre-commit hook at scripts/pre-commit will auto-validate this file
+# on every commit if you install it via:
+#   cp scripts/pre-commit .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
+
+# ─── Network ─────────────────────────────────────────────────────────────────
+# port=24112 is the mainnet P2P default. Pick an alternate (e.g. 24118) for
+# test/parallel nodes to avoid clashing with production.
+port=24112
+listen=1
+discover=1
+
+# ─── RPC ─────────────────────────────────────────────────────────────────────
+# Bind RPC to localhost only. The triangles-cli tool connects here.
+rpcuser=trianglesrpc
+rpcpassword=CHANGE_ME_TO_A_STRONG_RANDOM_PASSWORD
+rpcport=19112
+rpcallowip=127.0.0.1
+server=1
+
+# ─── Tor (MANDATORY — Triangles is Tor-only) ─────────────────────────────────
+# Triangles peers are exclusively .onion addresses. Never use clearnet IPs
+# in addnode= entries. See:
+#   * src/onionseed.h — hardcoded seed list (source of truth)
+#   * src/test/onion_v3_tests.cpp — validates the hardcoded list at CI
+#   * scripts/validate_onion_seeds.py — validates your config at pre-commit
+#
+# proxy= can point at:
+#   * Embedded Tor:   127.0.0.1:19099 (started automatically by the daemon)
+#   * System Tor:     127.0.0.1:9050
+#   * Tor Browser:    127.0.0.1:9150
+proxy=127.0.0.1:19099
+
+# ─── Hardcoded seed nodes (src/onionseed.h, v3 onion only) ──────────────────
+# These 7 are the source-of-truth seeds. The C++ test suite validates
+# every one of them at build time.
+addnode=gxvrhv3qitnc6kobrhsrse46bmcfitnybapor3or3oczzuxn6hfzxyid.onion:24112
+addnode=i6tk7soznftvoibtskwlezviskiererhjndpsmrff4kaxw7jnd5izfqd.onion:24112
+addnode=nawqqoazk2hhaglygulpeg6kh7hsgnvi2fursdvpvkantu4ojj26taid.onion:24112
+addnode=vmepp7plxngv4qpyngbgtb6njwnmlwy4api64xnwkhaf6fm3qlqtpfad.onion:24112
+addnode=nsldmfujkiwsfha42ajp5zx7gz3ekwdk4nvowdpf56mayuxnzshuykqd.onion:24112
+addnode=on4noksywc7b6cdbbxsp535l7j4cugunvlyz3iyhf6sfcg2qzaoy3eqd.onion:24112
+addnode=3uyzltm5cy7xzunncp3d7ariw75erabdnj4l3cxwvsxb6h4orc7eiqad.onion:24112
+
+# ─── Dynamic seeds (fetched from seeds.cryptographic-triangles.org) ─────────
+# These are populated at runtime by the daemon from the HTTP seed list. You
+# can also pin them here as a fallback for offline operation. They MUST be
+# valid v3 onions — validate with scripts/validate_onion_seeds.py.
+# addnode=6ygpphp2qsucwvhwefv6h6ehvk6zjf7b7zdp4ggkzjjwe76cg6jwm7id.onion:24112
+# addnode=uddaxjbo3lh2zskg7w6gwln4ty5cel7q4c5jbx7fdtv6zf2j47gdlyad.onion:24112
+# addnode=el5sirhhleecuctpeeprelzubpqmoqivvra3rzlwbjttinxa4fq3wnid.onion:24112
+# addnode=sj5dhybnlp3v4y5niyc5unrnd6s43lyx5ibup7rolyosjbi2u2hsbvyd.onion:24112
+# addnode=i3kr5meha7se4ns3wss3h7v46m6uksfzv4wrohdqxpj6n35wyo2bvlid.onion:24112
+# addnode=odtiwh6d2mqweztjrp45g5ogf4ikwtl5gotpjcbtax2qzkztrqcqieid.onion:24112
+# addnode=jbpfhe7zw3qm67wy3j2ayysp3mnrjobopthnko3b3sgahqtecblwqmid.onion:24112
+
+# ─── Indexes ─────────────────────────────────────────────────────────────────
+# Required for getaddressbalance / getaddressutxos / getaddresstxids RPCs
+# and for the bootstrap server to serve UTXO snapshots. Costs ~5GB disk.
+txindex=1
+addressindex=1
+spentindex=1
+timestampindex=1
+
+# ─── Staking ─────────────────────────────────────────────────────────────────
+# Set staking=0 to disable stake mining (recommended for sync-test / archive
+# nodes that don't need to produce blocks).
+staking=1
+stakegen=1
+
+# ─── Performance ────────────────────────────────────────────────────────────
+# dbcache in MB. 512 is reasonable for sync nodes. 1024+ for archival nodes.
+dbcache=512
+
+# ─── Security ───────────────────────────────────────────────────────────────
+# Disable Tor — DO NOT REMOVE THIS. Triangles is Tor-only by design.
+notor=0

doc/README.md

@@ -0,0 +1,35 @@
+# Triangles Documentation
+
+Cryptographic Triangles (TRI) is a privacy-focused proof-of-stake
+cryptocurrency derived from Bitcoin, with Tor v3 hidden services
+mandatory and a 120-second block time. This directory holds
+operator- and developer-facing documentation.
+
+## Operator docs
+
+- **[triangles-cli.md](triangles-cli.md)** — operating the JSON-RPC
+  CLI against one or more daemon instances, including custom
+  data-dir setups, common operations, and the full flag reference.
+- **[release-process.md](release-process.md)** — how a release is
+  cut, signed, and published.
+
+## Developer docs
+
+- **[build-unix.txt](build-unix.txt)** — building on Linux.
+- **[build-osx.txt](build-osx.txt)** — building on macOS.
+- **[build-msw.txt](build-msw.txt)** — building on Windows.
+- **[coding.txt](coding.txt)** — coding style and conventions.
+- **[translation_process.md](translation_process.md)** — how
+  translations are managed.
+- **[embedded-tor-rebase.md](embedded-tor-rebase.md)** — bumping
+  the embedded Tor submodule.
+- **[i2p.md](i2p.md)** — I2P integration notes.
+
+## Misc
+
+- **[README_windows.txt](README_windows.txt)** — Windows README
+  (legacy, predates the markdown docs).
+- **[assets-attribution.txt](assets-attribution.txt)** — third-party
+  asset attributions.
+- **[Doxyfile](Doxyfile)** — Doxygen configuration for source
+  documentation.

doc/i2p.md

@@ -0,0 +1,68 @@
+# I2P support (SAM v3)
+
+Triangles runs over I2P in addition to Tor, giving the wallet a second
+anonymous network and a `.b32.i2p` address shown directly above the `.onion`
+address in the status bar.
+
+I2P is **on by default** and works the same way as the embedded Tor: the wallet
+auto-launches a bundled **i2pd** router as a managed child process, enables its
+SAM bridge, and connects to it. The user does not have to install or configure
+anything — provided the i2pd binary ships with the wallet.
+
+## Shipping the i2pd binary
+
+Like `tor.exe`, the wallet looks for an `i2pd` executable in several places and
+launches the first one it finds:
+
+1. Next to the wallet executable (recommended): `i2pd.exe` (Windows) / `i2pd`
+   (Linux/macOS), or in an `i2pd/` subfolder beside it.
+2. In the data directory (or its `i2pd/` subfolder).
+3. Common system locations (`/usr/bin/i2pd`, Homebrew, `C:\i2pd\…`, etc.).
+
+Get i2pd from https://i2pd.website/ (or your package manager) and place the
+binary next to the wallet in your build/packaging step. That's the only manual
+part, and it's a packaging concern, not something the end user does.
+
+If no i2pd binary is found, the wallet logs a notice and continues with **Tor
+only** — I2P is strictly additive and never blocks start-up.
+
+## What happens at start-up
+
+1. If a SAM bridge is already listening on `127.0.0.1:7656` (e.g. you run your
+   own router), the wallet uses it and does **not** launch its own.
+2. Otherwise it writes `i2pd.conf` into `<datadir>/i2pd/` (SAM enabled, other
+   services off), launches i2pd, and waits for the SAM bridge to come up.
+3. The SAM client then loads/creates a persistent destination
+   (`<datadir>/i2p_private_key`), opens a STREAM session, derives the
+   `.b32.i2p` address (`base32(SHA-256(destination))`), accepts inbound I2P
+   streams, and dials outbound `.b32.i2p` peers.
+4. On wallet exit, the SAM session is closed and the i2pd child process is
+   terminated (an external router you started yourself is left running).
+
+The first session takes a little longer while i2pd builds tunnels; the address
+appears once the bridge is ready.
+
+## Options
+
+```
+-i2p                 Enable I2P; auto-launches bundled i2pd (default: 1; -i2p=0 to disable)
+-i2psam=<ip:port>    SAM bridge address (default: 127.0.0.1:7656).
+                     A non-loopback address disables the bundled router and
+                     connects to that external bridge instead.
+```
+
+## Checking it
+
+* GUI: the `.b32.i2p` address sits on top of the `.onion` in the status bar;
+  click either to copy.
+* RPC: `getinfo` shows `toraddress` and `i2paddress`; `getnetworkinfo` shows
+  `toraddress` and an `i2p` object (`enabled`, `active`, `address`, `peers`).
+
+## Notes / limitations
+
+* The address serialization format carries a flag for I2P addresses, so **all
+  nodes must run this build** to exchange I2P peers; an old `peers.dat` is
+  discarded.
+* `i2p_private_key` is your stable I2P identity — back it up, don't delete it.
+* This was implemented without a build/CI environment here; build and test
+  against a real i2pd before relying on it.

doc/release-process.md

@@ -0,0 +1,244 @@
+# Triangles Release Process
+
+> Canonical release pipeline for `SamiAhmed7777/triangles_v5`. This document
+> is the source of truth for *how* a release is cut. The implementation lives
+> in `scripts/verify-reproducible-build.sh` and `scripts/sign-release.sh`.
+
+## Goals
+
+1. **Reproducible** — any two builders with the same source tree, same
+   toolchain, and same flags produce byte-identical binaries.
+2. **Signed** — every release artifact has a detached PGP signature that
+   verifiers can check against a known public key.
+3. **Verifiable end-to-end** — a third party can confirm a release is
+   legitimate using only `gpg` and `sha256sum`, both installed by default
+   on every Linux distribution.
+
+## Pipeline overview
+
+```
+   source tag (e.g. v6.1.4)
+            │
+            ▼
+   ┌─────────────────────┐
+   │  CI builds all 4     │  .github/workflows/build-all.yml
+   │  targets on each     │  (ubuntu / windows / macos)
+   │  platform            │
+   └──────────┬───────────┘
+              │  produces: daemon.tar.gz, qt.tar.gz, .deb, .dmg, .exe, ...
+              ▼
+   ┌─────────────────────┐
+   │  Local maintainer     │  scripts/sign-release.sh <release-dir>
+   │  signs artifacts      │  (uses release signing key in local keyring)
+   └──────────┬───────────┘
+              │  produces: SHA256SUMS, *.asc detached signatures
+              ▼
+   ┌─────────────────────┐
+   │  Push to GitHub       │  .github/workflows/distribute.yml
+   │  release + Docker    │  (uploads artifacts, builds Docker image,
+   │  + Homebrew tap +     │   updates Homebrew formula, submits
+   │  WinGet + Snap        │   WinGet + Snap PRs)
+   └──────────┬───────────┘
+              │
+              ▼
+   ┌─────────────────────┐
+   │  Verifier             │  scripts/sign-release.sh --verify <dir>
+   │  independently        │  + gpg --import <release-pubkey>
+   │  confirms             │
+   └─────────────────────┘
+```
+
+## Reproducibility — how it works today
+
+The Triangles build is already reproducible for Release builds with the
+following properties:
+
+| Property | Implementation |
+|---|---|
+| `BUILD_DESC` | Git describe output, written to `build.h` at build time |
+| `BUILD_DATE` | **Commit timestamp** (NOT wall-clock), from `git log -n 1 --format=%ci` |
+| `__DATE__`/`__TIME__` fallback | Dead code in practice — `build.h` always defines `BUILD_DATE` |
+| Build paths in binaries | Mapped with `-ffile-prefix-map=${CMAKE_SOURCE_DIR}=.` so absolute source paths do not leak into debug info |
+
+### Verifying reproducibility
+
+Run on a clean checkout:
+
+```bash
+scripts/verify-reproducible-build.sh
+```
+
+This builds `trianglesd` twice into two separate build directories and
+compares SHA256 hashes. Exits 0 on success.
+
+Options:
+- `BUILD_TYPE=Debug scripts/verify-reproducible-build.sh`
+- `TARGET=triangles-qt scripts/verify-reproducible-build.sh`
+- `BUILD_DIR_A=/tmp/A BUILD_DIR_B=/tmp/B scripts/verify-reproducible-build.sh`
+
+## Signing — how it works
+
+### Generate (or import) a release signing key
+
+**One-time setup** (the maintainer's machine):
+
+```bash
+# The release-signing key currently in use is:
+#
+#   uid:  Krystie Triangles Release <krystie-triangles-release@dns2.sami.tailnet>
+#   fp:   523A 8183 3EB7 2015 73E1 EFE1 DCF2 5799 6810 7984
+#   sub:  6913 E136 10F6 9818 3429 CE20 C2DC 6061 8C85 A159
+#   algo: RSA-4096, created 2026-04-29, expires 2028-04-28
+#
+# This is an unattended signing key used by the release CI to sign
+# release artifacts (daemon.tar.gz, qt.tar.gz, .deb, .dmg, .exe, .AppImage)
+# without a human in the loop. It is stored as a GitHub Actions secret.
+#
+# Git tags are signed by the maintainer's personal key
+# (uid `Sami <hello@sami-ahmed.net>`, fp `53AA 858E F0DD D528 EC2C 2ABD
+# 0BF7 F887 2FE0 E859`) so the tag and the artifacts can be verified
+# independently.
+
+# To print the public key for the current release-signing key:
+gpg --armor --export 0xDCF2579968107984 > release-pubkey.asc
+
+# To export the maintainer's tag-signing secret key (for backup):
+gpg --export-secret-keys 0x0BF7F8872FE0E859 > release-seckey-BACKUP.asc
+chmod 600 release-seckey-BACKUP.asc
+```
+
+**Import an existing key** (e.g. on a new maintainer machine):
+
+```bash
+gpg --import release-seckey-BACKUP.asc
+```
+
+### Sign a release directory
+
+After CI has produced the artifacts in a known directory:
+
+```bash
+scripts/sign-release.sh /path/to/release-dir
+```
+
+This will:
+1. Generate `SHA256SUMS` for every release artifact (.tar.gz, .deb, .dmg,
+   .exe, .zip, .AppImage)
+2. Write a detached PGP signature (`<artifact>.asc`) for each artifact
+3. Write a detached PGP signature over `SHA256SUMS` itself
+4. Refuse to run if the signing key isn't in the local keyring (safety)
+
+### Verify a release
+
+A third party (user, exchange, package maintainer) verifies with:
+
+```bash
+# 1. Import the public key (one-time).
+gpg --import release-pubkey.asc
+
+# 2. Verify everything in the release directory.
+scripts/sign-release.sh --verify /path/to/release-dir
+```
+
+This checks:
+- `SHA256SUMS.asc` against `SHA256SUMS` (the master signature)
+- Each `<artifact>.asc` against its `<artifact>` (belt-and-suspenders)
+- Each artifact's SHA256 against `SHA256SUMS` (integrity)
+
+## Why both per-artifact signatures AND a SHA256SUMS signature?
+
+- **SHA256SUMS + signature**: small, fast to verify, single point of trust.
+  If the SHA256SUMS.asc checks out and a file's SHA256 matches an entry,
+  you're done — you trust that entry.
+- **Per-artifact signatures**: defense against a hypothetical attack where
+  someone modifies `SHA256SUMS` but not the artifacts (or vice versa).
+  Two independent signature chains.
+
+For most verifiers, checking `SHA256SUMS.asc` + `sha256sum -c SHA256SUMS`
+is sufficient. The per-artifact .asc files are insurance.
+
+## CI integration
+
+`.github/workflows/build-all.yml` already produces the artifacts. The
+remaining work (separate PR) is to add a "sign" job that runs
+`scripts/sign-release.sh` against the assembled release directory using a
+key stored as a GitHub Actions secret.
+
+**Required secrets (one-time setup in repo Settings → Secrets):**
+- `GPG_PRIVATE_KEY` — base64-encoded `release-seckey-BACKUP.asc`
+  (see [GitHub docs on encrypted secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets))
+- `GPG_PASSPHRASE` — passphrase for the signing key (if any)
+- `GITHUB_TOKEN` — already provided by Actions
+
+**Suggested job sketch** (in `.github/workflows/build-all.yml` after all
+build jobs complete):
+
+```yaml
+sign:
+    name: Sign release artifacts
+    needs: [build-linux-daemon, build-linux-qt, build-windows-daemon, build-windows-qt, build-macos]
+    runs-on: ubuntu-22.04
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Import signing key
+        run: |
+          echo "${{ secrets.GPG_PRIVATE_KEY }}" | base64 -d | gpg --import
+
+      - name: Sign artifacts
+        run: scripts/sign-release.sh release-artifacts/
+        env:
+          GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
+```
+
+## Public key distribution
+
+The release public key MUST be published in **at least three independent
+places** so a keyserver takedown or DNS hijack cannot prevent verification:
+
+1. **This repository** — `release-pubkey.asc` at the repo root, committed
+   on every release tag.
+2. **The website** — `https://cryptographic-triangles.org/release-pubkey.asc`
+3. **Public keyservers** — submit to `keys.openpgp.org`, `keyserver.ubuntu.com`,
+   `pgp.mit.edu`. Each is independently operated.
+
+Distribution list refreshed with every key rotation (rare; treat as
+multi-year commitment).
+
+## Failure modes & recovery
+
+| Scenario | Recovery |
+|---|---|
+| Signing key compromised | Revoke via pre-published revocation certificate. Re-cut release. Document incident. |
+| Signing key lost (no backup) | Cannot sign new releases. Existing artifacts still verify against the published public key. Treat as catastrophic; re-mint a new key and treat the chain as fork-vulnerable until community updates. |
+| Public key not yet distributed | User gets `gpg: Can't check signature: No public key`. Provide clear "first verify the key fingerprint out-of-band" instructions on the website. |
+| CI secret leaked | Rotate the signing key immediately; treat all artifacts signed with the old key as suspect. |
+| `SHA256SUMS` signed but artifacts don't match | `sha256sum -c` fails. Either an artifact was corrupted in transit, or someone tampered. Re-download from GitHub and re-verify. |
+
+## Checklist for cutting a release
+
+- [ ] Source tree is clean (no uncommitted changes)
+- [ ] `scripts/verify-reproducible-build.sh` passes (builds are reproducible)
+- [ ] All CI jobs on the release tag are green
+- [ ] Release artifacts are in a single directory (`release-artifacts/`)
+- [ ] `scripts/sign-release.sh release-artifacts/` runs without error
+- [ ] `scripts/sign-release.sh --verify release-artifacts/` passes
+- [ ] `release-pubkey.asc` is current and committed to the repo
+- [ ] GitHub release created with all artifacts + SHA256SUMS + SHA256SUMS.asc
+- [ ] `distribute.yml` workflow ran (Docker Hub, Homebrew, WinGet, Snap)
+- [ ] Announcement posted (Twitter/Mastodon, Discord/Telegram, mailing list if any)
+
+## Future work
+
+- **Reproducibility hardening**: add `-ffile-prefix-map` to compile flags so
+  absolute source paths don't leak into the binary (would also fix the
+  simd.c:265 UBSan build-id drift).
+- **Gitian-style deterministic builds**: containerized build environment
+  pinned to a specific GCC/binutils version, so multiple independent
+  verifiers can rebuild from source and get identical hashes.
+- **Transparency log**: publish each release artifact hash to a Sigstore /
+  sigsum / Certificate Transparency-style log so any tampering is publicly
+  auditable.
+- **Key rotation policy**: document how/when the signing key gets rotated
+  (probably never, but state the policy).

doc/triangles-cli.md

@@ -0,0 +1,301 @@
+# Triangles CLI Operations
+
+> Operator-facing guide for `triangles-cli`, the JSON-RPC client that ships
+> with the Triangles daemon. Companion to `contrib/triangles.conf.example`
+> (daemon config) and `scripts/tri/README.md` (friendly wrapper).
+
+## What `triangles-cli` is
+
+`triangles-cli` is a small standalone binary that talks JSON-RPC over TCP
+to a running `trianglesd` daemon. It is the canonical way to read chain
+state, manage the wallet, and trigger node actions from the shell.
+
+It does **not** start, stop, or manage the daemon. It just talks to one
+that is already running.
+
+The binary lives in the same directory as `trianglesd` after build:
+
+| Platform | Default install path |
+|---|---|
+| Linux (Debian package) | `/usr/lib/cryptographic-triangles/triangles-cli` |
+| Linux (manual)         | wherever you put it; this doc assumes `/usr/local/bin` |
+| macOS (Homebrew)       | `/usr/local/bin/triangles-cli` |
+| Windows                | `<install-dir>\triangles-cli.exe` |
+
+## Connection parameters
+
+`triangles-cli` needs four pieces of information to reach the daemon:
+
+| Param | Default | Override flag |
+|---|---|---|
+| RPC host   | `127.0.0.1` | `-rpcconnect=<ip>` |
+| RPC port   | `19111` (mainnet) / `19112` (testnet) | `-rpcport=<port>` |
+| RPC user   | *(none — required)* | `-rpcuser=<user>` |
+| RPC pass   | *(none — required)* | `-rpcpassword=<pw>` |
+
+**RPC user and password have no default.** The daemon refuses to start
+RPC unless `rpcuser` and `rpcpassword` are set in its `triangles.conf`.
+You must either set them in the conf, or pass them on the command line.
+
+The conf is found in this order (highest precedence first):
+
+1. **`-conf=<absolute-path>`** flag on the command line
+2. **`<datadir>/triangles.conf`** — datadir resolved from `-datadir`
+   if given, otherwise from the default per-platform path (see below)
+3. **Hard-coded fallback** — `triangles.conf` in the current working
+   directory (rarely useful; only fires if neither `-conf` nor `-datadir`
+   is set and the cwd happens to contain the file)
+
+## Default data directories
+
+When `-datadir` is not passed, `triangles-cli` looks in:
+
+| Platform | Path |
+|---|---|
+| Linux   | `$HOME/.cryptographic-triangles` |
+| macOS   | `$HOME/Library/Application Support/CryptographicTriangles` |
+| Windows | `%APPDATA%\CryptographicTriangles` |
+
+The conf lookup in step 2 above resolves to
+`<default-datadir>/triangles.conf`. **If you keep your conf anywhere
+else — common for ops setups with custom data dirs — you must either
+pass `-conf` explicitly, or pass `-datadir` so the conf is found
+alongside it.**
+
+## Operating a node with a non-default data directory
+
+Most production nodes do **not** use the default datadir. The most
+common ops shapes are:
+
+### Shape 1: Custom datadir, conf in the same directory
+
+```bash
+# Daemon runs with:
+trianglesd -datadir=/var/lib/triangles -conf=/var/lib/triangles/triangles.conf
+
+# CLI uses the same -datadir, and the conf is found automatically:
+triangles-cli -datadir=/var/lib/triangles getinfo
+```
+
+`-conf` is omitted because `triangles-cli` infers
+`<datadir>/triangles.conf` when `-conf` is not given.
+
+### Shape 2: Custom datadir, conf at an unrelated path
+
+```bash
+# Conf lives somewhere else entirely (e.g. under /etc):
+triangles-cli -conf=/etc/triangles/triangles.conf -datadir=/var/lib/triangles getinfo
+```
+
+When `-conf` is an **absolute path**, the `-datadir` flag is only used
+for resolving other relative paths (logs, pid file, etc.) — the conf
+itself is read from the absolute `-conf` path.
+
+### Shape 3: Default datadir, override a single flag
+
+```bash
+# Use the default datadir but connect to a daemon on a different port
+# (e.g. testnet daemon, or remote node via SSH tunnel):
+triangles-cli -rpcport=19112 -rpcuser=tripi -rpcpassword=secret getinfo
+```
+
+### Shape 4: Multiple nodes on the same box (no flag conflicts)
+
+```bash
+# Mainnet node, datadir /var/lib/triangles-mainnet
+triangles-cli -datadir=/var/lib/triangles-mainnet -rpcport=19111 getinfo
+
+# Testnet node, datadir /var/lib/triangles-testnet
+triangles-cli -datadir=/var/lib/triangles-testnet -rpcport=19112 -testnet getinfo
+```
+
+## Common operations
+
+All examples assume `-datadir=/var/lib/triangles` for the production
+node. Drop the flag if your conf lives at the default path.
+
+```bash
+# ── Chain state ──────────────────────────────────────────────
+triangles-cli -datadir=/var/lib/triangles getblockchaininfo
+triangles-cli -datadir=/var/lib/triangles getbestblockhash
+triangles-cli -datadir=/var/lib/triangles getblockcount
+triangles-cli -datadir=/var/lib/triangles getdifficulty
+triangles-cli -datadir=/var/lib/triangles getnetworkinfo
+triangles-cli -datadir=/var/lib/triangles getconnectioncount
+
+# ── Wallet ───────────────────────────────────────────────────
+# List unspent outputs
+triangles-cli -datadir=/var/lib/triangles listunspent
+
+# Balance
+triangles-cli -datadir=/var/lib/triangles getbalance
+triangles-cli -datadir=/var/lib/triangles getbalance "*" 6   # 6-confirmations
+
+# Send
+triangles-cli -datadir=/var/lib/triangles sendtoaddress <addr> <amount> ["comment"]
+
+# Backup wallet — ALWAYS back up before any operation that
+# mutates the wallet (sendtoaddress, importprivkey, keypoolrefill...)
+triangles-cli -datadir=/var/lib/triangles backupwallet /root/tri-wallet-$(date +%F).dat
+
+# ── Staking ──────────────────────────────────────────────────
+triangles-cli -datadir=/var/lib/triangles getstakinginfo
+triangles-cli -datadir=/var/lib/triangles setstaking true|false
+
+# ── Snapshots (if your node is a snapshot publisher) ─────────
+triangles-cli -datadir=/var/lib/triangles getsnapshotinfo
+```
+
+For the full list of available RPC commands, run:
+
+```bash
+triangles-cli -datadir=/var/lib/triangles help
+triangles-cli -datadir=/var/lib/triangles help <command>     # help for one
+```
+
+## Output formats
+
+The default output is **pretty-printed JSON**. For piping into `jq`
+or other tools, add `-raw`:
+
+```bash
+triangles-cli -datadir=/var/lib/triangles -raw getblockcount
+#  2418017
+
+triangles-cli -datadir=/var/lib/triangles -raw getbestblockhash | head -c 64
+```
+
+For a synthesized summary (version, balance, blocks, connections,
+stake weight) without having to chain multiple calls:
+
+```bash
+triangles-cli -datadir=/var/lib/triangles -getinfo
+```
+
+## The `tri` wrapper (recommended for humans)
+
+`scripts/tri/` ships a friendly bash wrapper that takes care of
+`-datadir` / `-rpcuser` / `-rpcpassword` from a single config file.
+See `scripts/tri/README.md` for install + config. Once installed:
+
+```bash
+tri getinfo
+tri getblockchaininfo
+tri sendtoaddress <addr> <amount>
+```
+
+…with no need to remember flags. The wrapper reads
+`/etc/tri/nodes.conf` (or whatever you set `TRI_NODES_CONF` to).
+
+## Reading JSON-RPC responses into shell variables
+
+`triangles-cli` is one-shot — each invocation connects, sends one
+request, prints the result, exits. To grab a field:
+
+```bash
+# Single field, no jq
+HEIGHT=$(triangles-cli -datadir=/var/lib/triangles -raw getblockcount)
+echo "Chain height: $HEIGHT"
+
+# With jq for nested fields
+NETWORK=$(triangles-cli -datadir=/var/lib/triangles -raw getnetworkinfo \
+          | jq -r .networkid)
+```
+
+## Cross-host operation (SSH tunnel)
+
+To run a CLI command against a node on a different host without
+exposing RPC publicly, tunnel the port over SSH first:
+
+```bash
+# Local:19111 -> remote:19111 over SSH
+ssh -f -N -L 19111:127.0.0.1:19111 user@node.example.com
+
+# Now talk to the remote daemon as if it were local:
+triangles-cli -rpcconnect=127.0.0.1 -rpcport=19111 \
+              -rpcuser=<user> -rpcpassword=<pw> getinfo
+```
+
+Or use the `tri` wrapper, which has a built-in SSH host setting —
+see `scripts/tri/README.md`.
+
+## Common pitfalls
+
+### "missing RPC credentials" with no useful error
+
+The CLI prints:
+```
+triangles-cli: missing RPC credentials. Set rpcuser/rpcpassword in triangles.conf
+              or pass -rpcuser=<user> -rpcpassword=<pw> on the command line.
+              (RPC config file: /root/.cryptographic-triangles/triangles.conf)
+```
+
+This message is **misleading in one case**: the conf path it prints is
+the *fallback* path the CLI would have used. The actual conf it
+*tried* to read is the one resolved from your `-conf` or `-datadir`
+flag. If you passed `-conf` and still see this, your conf is missing
+`rpcuser=` or `rpcpassword=`, or has them commented out.
+
+If you **did not** pass `-datadir` or `-conf`, the message is literal:
+the CLI looked at `<default-datadir>/triangles.conf` and did not find
+`rpcuser`/`rpcpassword` there.
+
+**Fix:** either edit the conf and add credentials, or pass them on the
+command line:
+```bash
+triangles-cli -rpcuser=trianglesrpc -rpcpassword=secret -datadir=/var/lib/triangles getinfo
+```
+
+### Daemon not running
+
+If the daemon isn't running, `triangles-cli` will fail to connect
+after a few seconds. Verify the daemon is up first:
+
+```bash
+systemctl status trianglesd        # systemd-managed install
+pgrep -af trianglesd                # manual install
+tail -50 /var/log/trianglesd.log    # recent log lines
+```
+
+### Testnet vs mainnet port mismatch
+
+Mainnet default is `19111`; testnet is `19112`. If you run a testnet
+daemon but invoke the CLI without `-testnet`, the CLI connects to
+`19111` (empty mainnet port) and fails. Use either:
+
+```bash
+triangles-cli -testnet -datadir=/var/lib/triangles-testnet getinfo
+# OR (equivalent):
+triangles-cli -rpcport=19112 -datadir=/var/lib/triangles-testnet getinfo
+```
+
+### Multiple nodes on one host
+
+If you run two daemons on the same box (e.g. mainnet + testnet), you
+need to set **different** `rpcport=` for each in their respective
+confs, and pass the matching `-rpcport` to the CLI. Default
+`127.0.0.1:<port>` will not route correctly otherwise.
+
+## Reference: all flags
+
+| Flag | Purpose |
+|---|---|
+| `-conf=<path>`      | Path to triangles.conf (absolute path recommended) |
+| `-datadir=<path>`   | Data directory; conf resolved to `<datadir>/triangles.conf` if `-conf` is not absolute |
+| `-testnet`          | Use testnet RPC port (19112 instead of 19111) |
+| `-rpcconnect=<ip>`  | RPC host (default `127.0.0.1`) |
+| `-rpcport=<port>`   | RPC port (default `19111` mainnet, `19112` testnet) |
+| `-rpcuser=<user>`   | RPC username (overrides conf) |
+| `-rpcpassword=<pw>` | RPC password (overrides conf) |
+| `-stdin`            | Read extra command params from stdin, one per line |
+| `-raw`              | Print raw JSON, no pretty-printing |
+| `-getinfo`          | Synthesized summary from multiple RPCs |
+| `-version`          | Print version and exit |
+| `-?` / `-h`         | Print help and exit |
+
+## See also
+
+- `contrib/triangles.conf.example` — daemon configuration reference
+- `scripts/tri/README.md` — `tri` wrapper (operator-friendly alias)
+- `doc/release-process.md` — release pipeline
+- `doc/build-unix.txt` — building the CLI from source

docs/snapshot-publisher.md

@@ -0,0 +1,240 @@
+# Trusted Snapshot Publisher — Operator Guide
+
+This document explains how the trusted snapshot publisher mechanism works
+in Triangles and how to rotate the publisher without rebuilding the
+daemon. It is written for the person who operates the Triangles network
+after Sami — whoever that turns out to be.
+
+## Background
+
+The Triangles daemon verifies that any UTXO snapshot it loads was
+**signed by a trusted publisher**. This prevents a malicious snapshot
+file from tricking a node into accepting a fake chain state.
+
+In versions before v6.1.8, the trusted publisher list was hardcoded
+in the binary. To rotate keys, the daemon had to be rebuilt and
+re-released. That was bad for handover.
+
+Starting with v6.1.8, the daemon supports a **runtime-configurable
+single-slot trusted publisher** via RPC. The compiled-in fallback list
+is still consulted if no runtime publisher is set, so a fresh daemon
+never fails to verify an old snapshot.
+
+## The model — Design A (single-slot, auto-replace)
+
+- **At most ONE runtime publisher exists at any time.**
+- Calling `settrustedv2snapshotpublisher <addr>` **atomically
+  replaces** the current publisher. The previous one is dropped
+  immediately. There is no grace period, no retirement list, no
+  rollback path. Pure single-slot.
+- The active publisher is persisted to
+  `<datadir>/snapshot-publisher.json`, so it survives daemon
+  restarts.
+- The built-in fallback list (read-only, compiled into the binary) is
+  consulted only if no runtime publisher is set. That list contains:
+  - `TG8f76yktTxDrT7JJymY3wVAusXiD3fVvX` — Sami's legacy snapshot
+    publisher key (the original, used from v6.1.5 through v6.1.7).
+
+## The three RPCs
+
+### `settrustedv2snapshotpublisher <address>`
+
+Atomically replaces the active trusted publisher. The previous
+publisher is dropped immediately. The new publisher is persisted to
+`<datadir>/snapshot-publisher.json` so the choice survives restarts.
+
+```
+triangles-cli settrustedv2snapshotpublisher TGotWuftzH7rD9tXC7whE8EXiyC3mr1CrH
+```
+
+Result:
+```json
+{
+  "previous": "TG8f76yktTxDrT7JJymY3wVAusXiD3fVvX",
+  "current":  "TGotWuftzH7rD9tXC7whE8EXiyC3mr1CrH"
+}
+```
+
+The `previous` field is empty if no runtime publisher was set before.
+
+### `gettrustedv2snapshotpublisher`
+
+Returns the currently active runtime publisher.
+
+```
+triangles-cli gettrustedv2snapshotpublisher
+```
+
+Result:
+```json
+{
+  "active": "TGotWuftzH7rD9tXC7whE8EXiyC3mr1CrH",
+  "has_runtime_override": true
+}
+```
+
+If `has_runtime_override` is `false`, only the built-in fallback list
+is consulted. The fallback currently contains `TG8f76yktTxDrT7JJymY3wVAusXiD3fVvX`.
+
+### `unsettrustedv2snapshotpublisher`
+
+Clears the runtime override. Reverts to the built-in fallback list.
+Also removes `<datadir>/snapshot-publisher.json`.
+
+```
+triangles-cli unsettrustedv2snapshotpublisher
+```
+
+Use this if you want to "go back to the legacy trusted signer"
+without a rebuild.
+
+## Common rotation scenarios
+
+### Rotate to a new key (forward rotation)
+
+1. Generate a new key in the wallet:
+   ```
+   triangles-cli getnewaddress
+   # returns: TNewAddressHere...
+   ```
+2. (Optional but recommended) Label it so you remember its role:
+   ```
+   triangles-cli setaccount TNewAddressHere... "snapshot publisher"
+   ```
+3. Set it as the trusted publisher:
+   ```
+   triangles-cli settrustedv2snapshotpublisher TNewAddressHere...
+   ```
+4. Verify:
+   ```
+   triangles-cli gettrustedv2snapshotpublisher
+   ```
+   Should show `active: TNewAddressHere...`.
+
+Old publisher is dropped immediately. New one is in effect for this
+daemon and any daemon that syncs from `<datadir>/snapshot-publisher.json`.
+
+### Roll back to the legacy publisher
+
+If the new key is lost / compromised / you just want to revert:
+
+```
+triangles-cli unsettrustedv2snapshotpublisher
+```
+
+This reverts to the built-in fallback (`TG8f76ykt...`). No rebuild
+required. The legacy address will continue to verify any snapshot
+that was signed before your rotation.
+
+### Rotate during a handover (publisher A hands off to publisher B)
+
+1. Publisher B installs v6.1.8+ daemon.
+2. Publisher B sets themselves as the trusted publisher:
+   ```
+   triangles-cli settrustedv2snapshotpublisher TBsAddress...
+   ```
+3. Publisher B signs a new snapshot with their key (see
+   `publishcheckpoint` in `TRIANGLES-RPC-COMMANDS.md`).
+4. Publisher A can leave the network; their key is no longer trusted
+   on any node that has called `settrustedv2snapshotpublisher`.
+
+Note: because Design A auto-drops the previous publisher, **only one
+operator can publish at a time.** If you need overlap (both A and B
+publishing during a transition), that requires Design B (multi-slot
+with grace period) — not supported in v6.1.8. Contact Sami for the
+upgrade path.
+
+## Files
+
+| Path | Purpose |
+|---|---|
+| `<datadir>/snapshot-publisher.json` | Runtime publisher override. Plain JSON. Inspectable with `cat`. |
+| `<datadir>/wallet.dat` | Must contain the privkey for the active publisher, otherwise `publishcheckpoint` will fail at signing time. (Trust is governed by the override; signing is governed by the wallet.) |
+
+### `<datadir>/snapshot-publisher.json` format
+
+```json
+{
+  "address": "TGotWuftzH7rD9tXC7whE8EXiyC3mr1CrH",
+  "set_at": 1752168000,
+  "note": "Set via triangles-cli settrustedv2snapshotpublisher. Replace atomically; previous publisher is dropped."
+}
+```
+
+`set_at` is the Unix timestamp when the RPC was last called. `note` is
+informational only.
+
+## Recovery if RPC fails
+
+If for some reason the runtime override can't be persisted (e.g. JSON
+write fails), the RPC returns a warning but the in-memory change is
+already live for the current session. To check:
+
+```
+triangles-cli gettrustedv2snapshotpublisher
+```
+
+If `active` is set, you're good for the current session. The next
+daemon restart will lose it unless `snapshot-publisher.json` exists.
+Inspect it manually:
+
+```
+cat ~/.triangles/snapshot-publisher.json
+```
+
+If the file doesn't exist but you need the override to survive restart,
+hand-write it:
+```json
+{
+  "address": "TGotWuftzH7rD9tXC7whE8EXiyC3mr1CrH",
+  "set_at": 1752168000,
+  "note": "Hand-set; rotate via triangles-cli settrustedv2snapshotpublisher."
+}
+```
+
+The daemon reads this file at startup. Address must be 34 chars and
+start with `T`. Anything else is logged and ignored.
+
+## When you DO need a rebuild
+
+- **Adding a new entry to the built-in fallback list** (the
+  read-only list compiled into the binary). Edit
+  `BUILTIN_TRUSTED_SNAPSHOT_SIGNERS[]` in `src/bootstrap.cpp`, rebuild,
+  release. This is only needed if you want a publisher to be trusted
+  *without* any operator running the RPC.
+- **Changing the RPC names or argument shapes.** Edit source, rebuild.
+
+For everyday "I want to add or rotate a trusted publisher," the RPC
+is enough. Don't rebuild.
+
+## Why "single-slot, no grace period"
+
+Sami asked for it explicitly when designing the operator-experience
+for this feature. The trade-off: if the active key is lost or
+compromised, there's no automatic fallback. The operator must either
+re-add the previous key (which requires they kept the JSON file or
+remember the address) or rebuild with the new key in
+`BUILTIN_TRUSTED_SNAPSHOT_SIGNERS[]`.
+
+If this trade-off becomes painful — for example if multiple
+operators need to publish during a handover — the alternative is
+Design B (multi-slot with grace period). That's a one-day patch on
+top of this one. Ask Sami for the upgrade.
+
+## Versioning
+
+This feature is introduced in **v6.1.8**. Daemons older than v6.1.8
+still use the hardcoded `TG8f76ykt...` only — they cannot use the new
+key until they upgrade.
+
+## Related RPCs
+
+For the publishing side (signing snapshots, not verifying them),
+see:
+
+- `publishcheckpoint <interval> <signing_address> <output_path>` —
+  builds and signs a checkpoint document.
+- `gencheckpoints` — generates raw checkpoint data without signing.
+- `getcheckpoint` — returns the current synchronized checkpoint.
+
+See `TRIANGLES-RPC-COMMANDS.md` for full details on those.

packaging/appimage/build-appimage.sh

@@ -3,7 +3,7 @@
 # Run on a Linux x64 system with appimagetool installed
 set -e
 
-VERSION="5.7.6"
+VERSION="6.2.4"
 APPDIR="Triangles-x86_64.AppDir"
 RELEASE_URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}"
 

packaging/appstream/org.cryptographic_triangles.TrianglesQt.metainfo.xml

@@ -41,6 +41,31 @@
   </provides>
 
   <releases>
+    <release version="6.1.5" date="2026-07-08">
+      <description>
+        <p>UI: olive-green for unconfirmed/immature stake balances. Wallet: close-hang on Windows from detached Tor/I2P threads fixed. Consensus: live PoS checks during stale-tip IBD. Plus release infrastructure (reproducible builds, signed release pipeline) and audit follow-ups.</p>
+      </description>
+    </release>
+    <release version="6.1.4" date="2026-07-04">
+      <description>
+        <p>CI: Tor bundle download resilience. NeedsBootstrap flag now correctly persists across rocksdb/ restarts. CI reliability only; no protocol/wallet/chain format changes.</p>
+      </description>
+    </release>
+    <release version="6.1.3" date="2026-07-02">
+      <description>
+        <p>Chain-DB migration hardening, BIP39 passphrase support, HD-wallet indicator, test isolation improvements. Supersedes the broken v6.1.2 hotfix.</p>
+      </description>
+    </release>
+    <release version="6.1.1" date="2026-07-01">
+      <description>
+        <p>v3 snapshot support, portable x86-64-v2 baseline, anti-spam fix, continuous finality checkpoints.</p>
+      </description>
+    </release>
+    <release version="6.1.0" date="2026-06-30">
+      <description>
+        <p>SQLite wallet backend, RocksDB default, Boost removal, I2P startup fix. Initial 6.x line with C++20 modernization and embedded Tor/I2P support.</p>
+      </description>
+    </release>
     <release version="5.3.7" date="2026-03-24">
       <description>
         <p>Version 5.3.7 release.</p>

packaging/aur/.SRCINFO

@@ -0,0 +1,30 @@
+pkgbase = triangles-qt-bin
+	pkgdesc = Cryptographic Triangles (TRI) cryptocurrency wallet - Qt GUI
+	pkgver = 5.9.20
+	pkgrel = 1
+	url = https://cryptographic-triangles.org
+	arch = x86_64
+	license = MIT
+	depends = qt5-base
+	depends = openssl
+	depends = boost-libs
+	depends = db
+	depends = leveldb
+	depends = libevent
+	depends = miniupnpc
+	depends = tor
+	optdepend = tor: anonymous networking support
+	provides = triangles-qt
+	provides = trianglesd
+	provides = triangles-cli
+	conflicts = triangles-qt
+	conflicts = trianglesd
+	conflicts = triangles-cli
+	source = https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.9.20/cryptographic-triangles_5.9.20_amd64.deb
+	source = https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.9.20/cryptographic-triangles-daemon_5.9.20_amd64.deb
+	source = triangles-qt.desktop
+	sha256sums = b4afcf758f55c8fb256f4742917971414078ce37c0fe346383ccda5251917bde
+	sha256sums = 068d015cf73206f3f3604b0c8fbf60db307c20234cbe06e236996fb9a336df51
+	sha256sums = SKIP
+
+pkgname = triangles-qt-bin

packaging/aur/PKGBUILD

@@ -1,6 +1,6 @@
-# Maintainer: Cryptographic Triangles Team
+# Maintainer: Sami Ahmed <https://github.com/SamiAhmed7777>
 pkgname=triangles-qt-bin
-pkgver=5.5.6
+pkgver=5.9.20
 pkgrel=1
 pkgdesc="Cryptographic Triangles (TRI) cryptocurrency wallet - Qt GUI"
 arch=('x86_64')
@@ -8,21 +8,64 @@ url="https://cryptographic-triangles.org"
 license=('MIT')
 depends=('qt5-base' 'openssl' 'boost-libs' 'db' 'leveldb' 'libevent' 'miniupnpc' 'tor')
 optdepends=('tor: anonymous networking support')
-provides=('triangles-qt' 'trianglesd')
-conflicts=('triangles-qt' 'trianglesd')
+provides=('triangles-qt' 'trianglesd' 'triangles-cli')
+conflicts=('triangles-qt' 'trianglesd' 'triangles-cli')
 source=(
-    "triangles-qt-${pkgver}::https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${pkgver}/Cryptographic-Triangles-v${pkgver}-linux-x64-qt"
-    "trianglesd-${pkgver}::https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${pkgver}/Cryptographic-Triangles-v${pkgver}-linux-x64-daemon"
+    "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${pkgver}/cryptographic-triangles_${pkgver}_amd64.deb"
+    "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${pkgver}/cryptographic-triangles-daemon_${pkgver}_amd64.deb"
     "triangles-qt.desktop"
 )
-sha256sums=(
-    'ed220eb8d0b403f62cdac28988541fd1a27864491e233216f9c00a4c2537b4a3'
-    '4d2ab25d61127d6aff3e6f3069556d04f4b823f8849e97629c12871ad4779517'
-    'SKIP'
-)
+sha256sums=('b4afcf758f55c8fb256f4742917971414078ce37c0fe346383ccda5251917bde'
+            '068d015cf73206f3f3604b0c8fbf60db307c20234cbe06e236996fb9a336df51'
+            'SKIP')
+
+prepare() {
+    cd "$srcdir"
+    # Qt GUI + bundled Qt/libs come from the full wallet .deb
+    ar x "cryptographic-triangles_${pkgver}_amd64.deb"
+    tar --use-compress-program=unzstd -xf data.tar.zst
+    rm -f control.tar.zst data.tar.zst debian-binary
+
+    # Headless daemon + JSON-RPC client come from the daemon .deb
+    ar x "cryptographic-triangles-daemon_${pkgver}_amd64.deb"
+    tar --use-compress-program=unzstd -xf data.tar.zst
+    rm -f control.tar.zst data.tar.zst debian-binary
+}
 
 package() {
-    install -Dm755 "triangles-qt-${pkgver}" "${pkgdir}/usr/bin/triangles-qt"
-    install -Dm755 "trianglesd-${pkgver}" "${pkgdir}/usr/bin/trianglesd"
-    install -Dm644 "triangles-qt.desktop" "${pkgdir}/usr/share/applications/triangles-qt.desktop"
+    cd "$srcdir"
+
+    # Install the actual binaries to /opt/triangles
+    install -dm755 "${pkgdir}/opt/triangles"
+    install -m755 usr/lib/cryptographic-triangles/triangles-qt \
+        "${pkgdir}/opt/triangles/triangles-qt"
+    install -m755 usr/lib/cryptographic-triangles/trianglesd \
+        "${pkgdir}/opt/triangles/trianglesd"
+    install -m755 usr/lib/cryptographic-triangles/triangles-cli \
+        "${pkgdir}/opt/triangles/triangles-cli"
+
+    # Install bundled shared libraries to /opt/triangles/lib.
+    # Many are version-pinned (librocksdb.so.6.11, libgflags.so.2.2,
+    # libdb_cxx-5.3.so, libboost_program_options.so.1.74.0) and are not
+    # available at the right version on Arch, so we ship them ourselves.
+    install -dm755 "${pkgdir}/opt/triangles/lib"
+    # Use GUI .deb libs (it has the full Qt set + everything daemon needs)
+    install -m644 usr/lib/cryptographic-triangles/lib/* \
+        "${pkgdir}/opt/triangles/lib/"
+
+    # Wrapper scripts in /usr/bin set LD_LIBRARY_PATH and exec the real binary.
+    # System Qt5/openssl/etc. are still on the default loader path and take
+    # precedence for libs NOT in our private directory.
+    install -dm755 "${pkgdir}/usr/bin"
+    for bin in triangles-qt trianglesd triangles-cli; do
+        install -m755 /dev/stdin "${pkgdir}/usr/bin/${bin}" <<EOF
+#!/bin/bash
+export LD_LIBRARY_PATH=/opt/triangles/lib\${LD_LIBRARY_PATH:+:\${LD_LIBRARY_PATH}}
+exec /opt/triangles/${bin} "\$@"
+EOF
+    done
+
+    # .desktop file
+    install -Dm644 triangles-qt.desktop \
+        "${pkgdir}/usr/share/applications/triangles-qt.desktop"
 }

packaging/chocolatey/tools/chocolateyInstall.ps1

@@ -1,18 +1,14 @@
 $ErrorActionPreference = 'Stop'
 
 $packageArgs = @{
-    packageName    = 'triangles'
-    unzipLocation  = "$(Split-Path -Parent $MyInvocation.MyCommand.Definition)"
-    url64bit       = 'https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.3.7/Cryptographic-Triangles-5.3.7-win-x64.zip'
-    checksum64     = '6f002a669a7e92aaf3d8dd7b1ae80f06a086c99a15ca05cf107665009ffc06b7'
+    packageName    = $env:ChocolateyPackageName
+    fileType       = 'exe'
+    softwareName   = 'Cryptographic Triangles*'
+    url64bit       = "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v$env:ChocolateyPackageVersion/Cryptographic-Triangles-$env:ChocolateyPackageVersion-win-x64-setup.exe"
+    checksum64     = '__CHECKSUM_PLACEHOLDER__'
     checksumType64 = 'sha256'
+    silentArgs     = '/S'
+    validExitCodes = @(0, 3010, 1641)
 }
 
-Install-ChocolateyZipPackage @packageArgs
-
-$installDir = $packageArgs.unzipLocation
-$desktopPath = [Environment]::GetFolderPath('Desktop')
-
-Install-ChocolateyShortcut `
-    -ShortcutFilePath "$desktopPath\Cryptographic Triangles.lnk" `
-    -TargetPath "$installDir\triangles-qt.exe"
+Install-ChocolateyPackage @packageArgs

packaging/debian/build-deb.sh

@@ -3,7 +3,7 @@
 # Run from the packaging/debian directory
 set -e
 
-VERSION="5.7.6"
+VERSION="6.2.4"
 PKGDIR="triangles_${VERSION}-1_amd64"
 RELEASE_URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}"
 

packaging/docker/Dockerfile

@@ -1,39 +1,57 @@
+FROM ubuntu:22.04 AS builder
+
+ARG VERSION=6.2.4
+ARG DEB_URL=https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/cryptographic-triangles-daemon_${VERSION}_amd64.deb
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        curl ca-certificates binutils zstd && \
+    curl -fsSL -o /tmp/triangles.deb "${DEB_URL}" && \
+    cd /tmp && ar x /tmp/triangles.deb && \
+    tar --use-compress-program=unzstd -xf data.tar.zst && \
+    rm -f /tmp/triangles.deb /tmp/control.tar.zst /tmp/debian-binary /tmp/data.tar.zst
+
+# ---------- Runtime ----------
 FROM ubuntu:22.04
 
+ARG VERSION=6.2.4
+
 LABEL maintainer="Cryptographic Triangles Team"
 LABEL description="Cryptographic Triangles (TRI) headless daemon"
-LABEL version="5.7.6"
-
-ARG VERSION=5.7.6
+LABEL version="6.2.4"
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
-    curl \
-    ca-certificates \
-    libssl3 \
-    libevent-2.1-7 \
-    libboost-system1.74.0 \
-    libboost-filesystem1.74.0 \
-    libboost-program-options1.74.0 \
-    libboost-thread1.74.0 \
-    libboost-chrono1.74.0 \
-    libdb5.3++ \
-    libminiupnpc17 \
-    tor \
+        ca-certificates \
+        libssl3 \
+        libevent-2.1-7 \
+        libboost-system1.74.0 \
+        libboost-filesystem1.74.0 \
+        libboost-program-options1.74.0 \
+        libboost-thread1.74.0 \
+        libboost-chrono1.74.0 \
+        libdb5.3++ \
+        libminiupnpc17 \
     && rm -rf /var/lib/apt/lists/*
 
-RUN curl -L -o /usr/local/bin/trianglesd \
-    "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}/Cryptographic-Triangles-v${VERSION}-linux-x64-daemon" \
-    && chmod +x /usr/local/bin/trianglesd
+COPY --from=builder /tmp/usr/lib/cryptographic-triangles/ /opt/triangles/
+COPY --from=builder /tmp/usr/bin/trianglesd /usr/local/bin/trianglesd
+COPY --from=builder /tmp/usr/bin/triangles-cli /usr/local/bin/triangles-cli
 
-RUN useradd -m -s /bin/bash triangles
+# Wrapper sets LD_LIBRARY_PATH so the dynamic libs resolve
+RUN printf '#!/bin/bash\nexport LD_LIBRARY_PATH=/opt/triangles/lib:${LD_LIBRARY_PATH}\nexec /opt/triangles/%s "$@"\n' trianglesd \
+        > /usr/local/bin/trianglesd-wrap && \
+    printf '#!/bin/bash\nexport LD_LIBRARY_PATH=/opt/triangles/lib:${LD_LIBRARY_PATH}\nexec /opt/triangles/%s "$@"\n' triangles-cli \
+        > /usr/local/bin/triangles-cli-wrap && \
+    mv /usr/local/bin/trianglesd-wrap /usr/local/bin/trianglesd && \
+    mv /usr/local/bin/triangles-cli-wrap /usr/local/bin/triangles-cli && \
+    chmod +x /usr/local/bin/trianglesd /usr/local/bin/triangles-cli
+
+RUN useradd -m -s /bin/bash triangles && \
+    mkdir -p /home/triangles/.triangles && \
+    chown -R triangles:triangles /home/triangles
 
 USER triangles
 WORKDIR /home/triangles
-
-RUN mkdir -p /home/triangles/.triangles
-
 VOLUME /home/triangles/.triangles
-
 EXPOSE 24112 19112
 
 ENTRYPOINT ["trianglesd"]

packaging/docker/docker-compose.yml

@@ -3,7 +3,7 @@ version: "3.8"
 services:
   trianglesd:
     build: .
-    image: cryptographic-triangles/trianglesd:5.7.6
+    image: cryptographic-triangles/trianglesd:6.2.4
     container_name: trianglesd
     restart: unless-stopped
     ports:

packaging/flatpak/org.cryptographic_triangles.TrianglesQt.yml

@@ -25,7 +25,7 @@ modules:
       - install -Dm644 org.cryptographic_triangles.TrianglesQt.metainfo.xml /app/share/metainfo/org.cryptographic_triangles.TrianglesQt.metainfo.xml
     sources:
       - type: file
-        url: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.7.6/Cryptographic-Triangles-v5.7.6-linux-x64-qt
+        url: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v6.2.4/Cryptographic-Triangles-v6.2.4-linux-x64-qt
         sha256: ed220eb8d0b403f62cdac28988541fd1a27864491e233216f9c00a4c2537b4a3
         dest-filename: triangles-qt-linux
       - type: file
@@ -55,6 +55,6 @@ modules:
       - install -Dm755 trianglesd-linux /app/bin/trianglesd
     sources:
       - type: file
-        url: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.7.6/Cryptographic-Triangles-v5.7.6-linux-x64-daemon
+        url: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v6.2.4/Cryptographic-Triangles-v6.2.4-linux-x64-daemon
         sha256: 4d2ab25d61127d6aff3e6f3069556d04f4b823f8849e97629c12871ad4779517
         dest-filename: trianglesd-linux

packaging/rpm/build-rpm.sh

@@ -4,7 +4,7 @@
 # Install build tools: sudo dnf install rpm-build rpmdevtools
 set -e
 
-VERSION="5.7.6"
+VERSION="6.2.4"
 RELEASE_URL="https://github.com/SamiAhmed7777/triangles_v5/releases/download/v${VERSION}"
 
 echo "Building RPM for Triangles v${VERSION}..."

packaging/rpm/triangles.spec

@@ -1,5 +1,5 @@
 Name:           triangles
-Version:        5.7.6
+Version:        6.2.4
 Release:        1%{?dist}
 Summary:        Cryptographic Triangles (TRI) cryptocurrency wallet
 License:        MIT
@@ -42,3 +42,49 @@ install -Dm644 %{SOURCE2} %{buildroot}%{_datadir}/applications/triangles-qt.desk
 %{_bindir}/triangles-qt
 %{_bindir}/trianglesd
 %{_datadir}/applications/triangles-qt.desktop
+
+%changelog
+* Wed Jul 08 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 6.1.7-1
+- 6.1.7 release. UI: Overview Total label font-weight bumped from 75
+  to 900 so the Total actually reads as bold against Spendable/Stake.
+  Transactions amount column Confirming-tier color changed from pale
+  mint (#C5EBC9) to mid green (#4A8C5E) so it reads as visibly
+  different from the bright Confirmed green. Both paint sites now
+  read confirmation depth via a new DepthRole on the table model
+  instead of the status enum, so the color fires on every block
+  increment.
+
+* Wed Jul 08 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 6.1.6-1
+- 6.1.6 release. UI: Overview Total label now conditional (green when
+  total > 0, red when empty), Transactions amount column now 3-tier
+  (grey / pale mint / money-green) by confirmation depth. Plus
+  sigcache entry-size fix and Polish CI/build fixes.
+
+* Wed Jul 08 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 6.1.5-1
+- 6.1.5 release. UI: olive-green for unconfirmed/immature stake balances.
+  Wallet: close-hang on Windows from detached Tor/I2P threads fixed.
+  Consensus: live PoS checks during stale-tip IBD. Plus release
+  infrastructure (reproducible builds, signed release pipeline) and
+  audit follow-ups.
+
+* Sat Jul 04 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 6.1.4-1
+- 6.1.4 release. CI: Tor bundle download resilience. NeedsBootstrap
+  flag now correctly persists across rocksdb/ restarts. CI reliability
+  only; no protocol/wallet/chain format changes.
+
+* Thu Jul 02 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 6.1.3-1
+- 6.1.3 release. Chain-DB migration hardening, BIP39 passphrase
+  support, HD-wallet indicator, test isolation improvements.
+  Supersedes the broken v6.1.2 hotfix.
+
+* Wed Jul 01 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 6.1.1-1
+- 6.1.1 release. v3 snapshot support, portable x86-64-v2 baseline,
+  anti-spam fix, continuous finality checkpoints.
+
+* Tue Jun 30 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 6.1.0-1
+- 6.1.0 release. SQLite wallet backend, RocksDB default, Boost
+  removal, I2P startup fix. Initial 6.x line with C++20 modernization
+  and embedded Tor/I2P support.
+
+* Tue Mar 24 2026 Sami Ahmed <sami@cryptographic-triangles.org> - 5.3.7-1
+- 5.3.7 release.

packaging/scoop/triangles.json

@@ -1,11 +1,11 @@
 {
-    "version": "5.7.6",
+    "version": "6.2.4",
     "description": "Cryptographic Triangles (TRI) cryptocurrency wallet with PoS staking and encrypted messaging",
     "homepage": "https://cryptographic-triangles.org",
     "license": "MIT",
     "architecture": {
         "64bit": {
-            "url": "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.7.6/Cryptographic-Triangles-5.7.6-win-x64.zip",
+            "url": "https://github.com/SamiAhmed7777/triangles_v5/releases/download/v6.2.4/Cryptographic-Triangles-6.2.4-win-x64.zip",
             "hash": "6f002a669a7e92aaf3d8dd7b1ae80f06a086c99a15ca05cf107665009ffc06b7"
         }
     },

packaging/winget/CryptographicTriangles.TrianglesQt.yaml

@@ -1,5 +1,5 @@
 PackageIdentifier: CryptographicTriangles.TrianglesQt
-PackageVersion: 5.7.6
+PackageVersion: 6.2.4
 PackageLocale: en-US
 Publisher: Cryptographic Triangles
 PublisherUrl: https://cryptographic-triangles.org
@@ -27,7 +27,7 @@ Installers:
       - RelativeFilePath: triangles-qt.exe
         PortableCommandAlias: triangles-qt
     ArchiveBinariesDependOnPath: true
-    InstallerUrl: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.7.6/Cryptographic-Triangles-5.7.6-win-x64.zip
+    InstallerUrl: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v6.2.4/Cryptographic-Triangles-6.2.4-win-x64.zip
     InstallerSha256: 6F002A669A7E92AAF3D8DD7B1AE80F06A086C99A15CA05CF107665009FFC06B7
 ManifestType: singleton
 ManifestVersion: 1.6.0

references/avx-512-sigill-build-fix.md

@@ -0,0 +1,184 @@
+# AVX-512 SIGILL build fix — `-mno-avx512f` belt-and-suspenders
+
+**TL;DR:** GCC 11+ on an AVX-512-capable CI runner will emit AVX-512
+instructions in libstdc++-inlined `std::string` / `std::copy` / `memcpy` code
+paths even when `-march=x86-64-v2 -mtune=generic` is set globally. The
+resulting binary crashes with `SIGILL (Illegal instruction)` on every
+production node that lacks AVX-512 (KVM EPYC, Ryzen 3600, ARM64, anything
+pre-Skylake-X). The fix is to add `-mno-avx512f -mno-avx512*` to the
+global compile options. **Don't trust `-march=x86-64-v2` alone** — it sets
+the baseline ISA but does not prevent auto-vectorization from emitting
+higher-ISA instructions.
+
+## Symptom (v6.1.9, 2026-07-31)
+
+DNS2 attempted to install the v6.1.9 `.deb`. Daemon started and died
+immediately with `status=4/ILL` (illegal instruction), before reaching
+`main()`. The systemd journal showed:
+
+```
+Aug 01 04:38:28 vmi3080415 trianglesd[367821]: status=4/ILL
+```
+
+The daemon was previously working on v6.1.4.0. The only thing that
+changed was the binary.
+
+## Diagnosis recipe (15 minutes)
+
+```bash
+# 1. Reproduce the crash under gdb so you can see the failing instruction
+systemctl stop trianglesd
+sleep 3
+gdb --batch \
+  -ex "set startup-with-shell off" \
+  -ex "run -datadir=/root/.triangles -conf=/root/.triangles/triangles.conf" \
+  -ex "info symbol \$pc" \
+  -ex "x/3i \$pc" \
+  -ex "x/8bx \$pc-4" \
+  /usr/lib/cryptographic-triangles/trianglesd 2>&1 | tail -15
+```
+
+You will see something like:
+
+```
+Program received signal SIGILL, Illegal instruction.
+0x00005555556bbe49 in ?? ()
+No symbol matches $pc.
+=> 0x5555556bbe49:	vpbroadcastq %rax,%xmm0
+   0x5555556bbe4f:	sub    %r14,%rdx
+   0x5555556bbe52:	test   %rdx,%rdx
+0x5555556bbe45:	0x08	0x49	0x89	0xc4	0x62	0xf2	0xfd	0x08
+```
+
+The bytes `0x62 0xf2 0xfd 0x08` are the **EVEX prefix** — an AVX-512
+encoding. The disassembled instruction `vpbroadcastq %rax, %xmm0` is
+the broadcast form, which uses EVEX even when the destination is XMM.
+
+## Why this happens
+
+The Triangles cmake file `cmake/AddCompilerFlags.cmake` already sets
+`-march=x86-64-v2 -mtune=generic` for `x86_64 && NOT WIN32 && NOT APPLE`:
+
+```cmake
+if(CMAKE_SYSTEM_PROCESSOR MATCHES "^(x86_64|amd64|AMD64)$" AND NOT WIN32 AND NOT APPLE)
+    option(CMAKE_X86_64_BASELINE "..." ON)
+    if(CMAKE_X86_64_BASELINE)
+        add_compile_options(-march=x86-64-v2)
+        add_compile_options(-mtune=generic)
+    endif()
+endif()
+```
+
+`-march=x86-64-v2` sets the **baseline ISA** to ~Nehalem (SSE4.2 + POPCNT +
+CMPXCHG16B). GCC should not emit anything higher. In practice GCC 11.4 +
+`-O3` + libstdc++ inlining of `std::string::operator=`, `std::copy`, and
+`memcpy` patterns from libstdc++ headers that contain `#pragma GCC
+push_options` blocks for AVX-512 detection — together they emit
+`vpbroadcastq` EVEX instructions into user code via header inlining.
+
+The instruction comes from **libstdc++ inlining**, not from any
+Triangles-specific source. The disassembly shows the inlined function
+is in a region marked as `std::string::operator=(std::string&&) + 0x2610`
+because the symbol table merges the entire `.text` into the closest
+named symbol — but the AVX-512 instruction itself is in a Triangles
+translation unit (the call chain eventually reaches it from
+`main.cpp`/`net.cpp` via `std::string` operations on the onion/I2P
+addrman paths).
+
+## The fix
+
+Add an explicit `-mno-avx512*` family block to
+`cmake/AddCompilerFlags.cmake` inside the existing
+`CMAKE_X86_64_BASELINE` block:
+
+```cmake
+if(CMAKE_X86_64_BASELINE)
+    add_compile_options(-march=x86-64-v2)
+    add_compile_options(-mtune=generic)
+    # Belt-and-suspenders: GCC 11+ can autovectorize libstdc++
+    # std::string / std::copy / memcpy paths into AVX-512 EVEX
+    # instructions even when -march=x86-64-v2 is set. Force-disable
+    # the whole AVX-512 family so a CI runner's EPYC 7763 (or any
+    # AVX-512-capable build host) cannot leak AVX-512 into a binary
+    # that needs to run on KVM EPYC, Ryzen 3000, or ARM64.
+    # NB: -mno-avx512*4fmaps / -mno-avx512*4vnniw use NO dash between
+    # 'avx512' and the sub-feature (correct: -mno-avx5124fmaps). The
+    # -mno-avx512-4fmaps form (with a dash) is rejected by GCC and
+    # makes the whole build fail with "unrecognized command-line option".
+    if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR CMAKE_C_COMPILER_ID STREQUAL "GNU")
+        add_compile_options(
+            -mno-avx512f -mno-avx512pf -mno-avx512er -mno-avx512cd
+            -mno-avx512vl -mno-avx512bw -mno-avx512dq -mno-avx512ifma
+            -mno-avx512vbmi -mno-avx512vbmi2 -mno-avx512vnni
+            -mno-avx512bitalg -mno-avx512vpopcntdq
+            -mno-avx5124fmaps -mno-avx5124vnniw -mno-avx512vp2intersect
+        )
+    endif()
+endif()
+```
+
+`-mno-avx512f` is the critical one (it's the foundation of the family).
+The others cover AVX-512 sub-features GCC may emit. The clang-equivalent
+of this is `-mno-avx512f -mno-avx512fp16 -mno-avx512pf -mno-avx512er
+-mno-avx512cd -mno-avx512vl -mno-avx512bw -mno-avx512dq -mno-avx512ifma`
+but this Triangles fix is GCC-only because the existing code already
+guards on `CMAKE_CXX_COMPILER_ID STREQUAL "GNU"`.
+
+## Verify the fix landed in the new binary
+
+```bash
+# Build, install, then check for EVEX-encoded instructions
+objdump -d /usr/lib/cryptographic-triangles/trianglesd 2>/dev/null \
+  | grep -c "vpbroadcastq"
+# Expected: 0  (was 741 before the fix)
+
+# Also check for any other EVEX-encoded instructions
+objdump -d /usr/lib/cryptographic-triangles/trianglesd 2>/dev/null \
+  | grep -E "vpcompress|vpdpwssd|vpdpbusd|gfni|vaes|vpclmulqdq" | head
+# Expected: empty
+```
+
+The smoke test that should have caught this: **add a job to the
+`Build All Platforms` workflow that runs the resulting trianglesd
+binary on a non-AVX-512 runner before publishing artifacts.** Catches
+this class of bug forever.
+
+## Why this wasn't caught before
+
+GitHub Actions' hosted `ubuntu-22.04` runner is an AMD EPYC 7763 (Zen 3,
+AVX-512 capable). Every CI build worked because the runner has the
+required ISA. No unit test actually runs the produced binary, so the
+build-vs-run gap is invisible until the binary ships to a CPU without
+AVX-512 (which is most production hardware, including KVM-virtualized
+EPYC, Ryzen 3000/5000 series, and ARM64 nodes). The fix is both the
+cmake `-mno-avx512f` belt and a CI smoke-test step that executes the
+binary on a non-AVX-512 runner.
+
+## Files changed for v6.2.0
+
+- `cmake/AddCompilerFlags.cmake` — added the `-mno-avx512*` block
+- `src/clientversion.h` — bumped to 6.2.0.0
+- All version-bearing files updated by `./scripts/bump-version.sh 6.2.0`
+
+## Pitfall — don't do these things
+
+- **Don't just add `-march=x86-64-v2`** without also adding
+  `-mno-avx512*`. The march alone is not enough on GCC 11+ with libstdc++
+  inlining. The behavior was verified locally: `-march=x86-64-v2` alone
+  still produced 741 AVX-512 instructions in the test build.
+- **Don't add `-fno-tree-vectorize`** to "fix" the symptom. That would
+  regress performance across the whole daemon. `-mno-avx512f` is the
+  surgical fix.
+- **Don't use `set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mno-avx512f")`**.
+  `add_compile_options` is the correct API — it propagates to subdirectory
+  targets (libsecp256k1, libtor, etc.) that were the actual sources of
+  the AVX-512 in earlier sessions.
+
+## Cross-references
+
+- The Triangles release v6.1.9 was the first release with the staking-
+  selfheal fix (`f69f087 [grade=B] fix(staking): carve out caught-up
+  nodes from IBD gate so chain can self-heal`). v6.1.9 was the binary
+  that exhibited this bug; v6.2.0 carries both the staking fix AND this
+  build-portability fix.
+- The git history for this fix is the v6.2.0 release.

release-pubkey.asc

@@ -0,0 +1,65 @@
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+
+mQINBGnxdoUBEACaICSRk5Clg4kI5IubMXnXLbsSWzi0TKIpqh4Tqgl2k1bgSxda
+tuBabHcsaw6Kpo96CJl9aZ63VIrEhCSdirGm/wWlbnTvm6cK4EDucGgS4BdEfm9B
+Lw2c+iTjuJqJt2HLbRkZmF8qHy0Mo1DjsjbWUiwIP62RkuxCNuW2Wl9euak504UW
+ZTFB9f3Bu1C6rknsWQ0VR5HJwWN4UrVMukZhvlzLRjKgW7W2XchSXUIAe7b0/5jo
+pFB30pwxbaBIoeJu8AHYnzBYRThp0WbDTC/LK5FSnSgG751jOtkbheRNGjO65a2L
+gkaclxo1NUIIu+WqdBtTbpUQM7UEd50FOXxUgq/xJhGujNMJyOMMPEzfJ+kP9pD4
+p+gkNCLLgvT+gu1PnF0iTIAb4qggHGzZGRgc5lTxC28XEud0DAx+Pdcdf/nlQTsu
+AOjZZgiiLIjwJZo/RYwId1Wh+LmtYZqVZ6j4vqqaXXPADpN40LGyUo376+oVSn77
+1w2j1CWSmTEPaq4KmvTvnTvFfbeXkKckmUziBYwqZI0uA2xE6ShNUaAS4kdIaZhO
+Bb3t9xrwu2QAR1rRlNTCChOyNbauvo32GLRnXg5BXYTBsmMU/QHe6EBJsycq/IHl
+2yNPQUtynxzkDZ9OYrwbZaTZOCJK0pHwm4HUmV3rPiEPXUKJXXDojWQYpwARAQAB
+tHlLcnlzdGllIFRyaWFuZ2xlcyBSZWxlYXNlIChBdXRvbm9tb3VzIHJlbGVhc2Ug
+c2lnbmluZyBrZXkgZm9yIHRyaWFuZ2xlc192NSkgPGtyeXN0aWUtdHJpYW5nbGVz
+LXJlbGVhc2VAZG5zMi5zYW1pLnRhaWxuZXQ+iQJYBBMBCgBCFiEEUjqBgz63IBVz
+4e/h3PJXmWgQeYQFAmnxdoUDGy8EBQkDwmcABQsJCAcCAiICBhUKCQgLAgQWAgMB
+Ah4HAheAAAoJENzyV5loEHmEPm0P/3y2Y5Y1rhgSj6yN/1PuXhpp1sNqXBOJZxTW
+uUx/4LUqLgqbtFC0fR4BwpTYEkGGaofi0/95sPwKu0jmVR6hJ+8Omk/4TMRmXUYq
+JUTA0/xzj9sOndaqiwRY3Y/YO/ytahL89y8xl5cYSaOOwLI/f9xo8pq1t20Iiuiw
+kcaUBRQgpTVMI49VcXwrEUMnjV9cldGqql8v7CSKds5rRxQgT8ifaC6euTWxK0Tn
+5Yu/wnBd+akU5/bcI8PEp5VyUyAJMZJPZ6mUqriWXlnhiUj0NawEKtfG9qlkMixL
+5ujz9lu/9MvFUYC4QSvcd1O3k9MJ6T4Yk/uEygEca8Y/3DcccWRMHjW2Ah+ewhHE
+yHy0tctzCe7pco+jfB7zicKv0bjXarvwBZ43e5F/zG5PMpo0XAS9EkEUV+/9BJ38
+jBHvzqwXsYTnxS0hgOSONJk9Cc6i0NN1ex3rPOrYvBvHWZ+9n3AU2taUljuypDGO
+RweCHsFMYGx/oOI94bD7wTeVey0tAZ+3Urz6T5qY5SmNKiwZ5NtbYo0Mp8r5DdPJ
+N9KtXtaDMPI/rORjl1Ad9xhDbGMCr7EH9SjTU+z51me31/ZU58jICGlvm3/JDcb5
+CAWyDppvW0ul9yqo1fecSi3w7m2sI+4F+tj8oLFmO+5rQw85F4LPqjVVMbUUkoAH
+udtoU3Y8uQINBGnxdoUBEACtFpgwuwEZqxbsfmL+uBxHnxSSRm2vlQc7HRtQG6Nu
+Tg1x4s9xFO6kNkcslPgZx9XSvFkPt1RUCNViTYE34UoOfkBs+aNkw4ztwuKGt/AS
+CZFRX99yBx7P0kiV4Nt/Cj3oQBtEXQixMmGK4+N0WBskV/QxRFA7hl+ZQBeEFsYP
+15UyjX2h6HFRYTSPKufEmtE/OkO9dg3fyxTvZ3+1o3eWWjT4VReX4jvmzXn3RNP1
+BwuAy+iwmnqUBcuEZ0qQiT/+oRLCHOFLCAjVoSsPY9WJfF67XpDb2noV/0RqltMD
+jUc/MT8Bxn/y8qHKvQuyPms/YO5jMI7q+/D1eayO4R48qhsMVp6Rjb31xalMWT2W
+rwQg1XaFG80vUisbfX6CU0sH34tWQkqAL7AiwradPtwB0Sn60Em5UgHdWQ7rkd+h
+mFOUjYi3Q1hOuPQNuzDK51n5sv8qOIrfghR0F2AtRkpbhBYM9435U+JkcZTjJ6wp
+WYLBTAys4qo9MnL18Z4byaw4e122eBgI3/UOvG+7C7wIAwmiDvnYzqErz7iOmuTe
++cgdWYmLFvkfx8P6Ka+6likSV4ZY/ASP4Uo/gTspatwqHApAmphfVEGwm0/wKMl2
+Br+zuZZ8RJ1GxahwJ1oo3uuGjIQjGNplh2wHVvbsfg4mlFKDbShdJ5adtx/E6BrT
+NQARAQABiQRyBBgBCgAmFiEEUjqBgz63IBVz4e/h3PJXmWgQeYQFAmnxdoUCGy4F
+CQPCZwACQAkQ3PJXmWgQeYTBdCAEGQEKAB0WIQRpE+E2EPaYGDQpziDC3GBhjIWh
+WQUCafF2hQAKCRDC3GBhjIWhWQYID/0Ru2U9rLatIAjoSWI6TMFaOaxHf1NAsTcz
+fPRbFNxx0d4ByjfjLlrfnDpQXsFpMa6/BpQ1Ps1ApW+wQsuHXxj/jdZVSi5f/sOT
+XKZq/MRZu8enA1foj0b6sJ13ZWY0iIWmIeK8NWuNBFWz2QTjRie2hqoOTR+Hy43r
+gRMlzPaXNoeD2UuvhoDphH2g2OWcppxd2b1yk7W9kh0CgvXXg4cPee71LmXLZMoL
+GJcmtSkU24fiwa95TSk2J5qQ3voP5Knk8e/VgGmOSUoUzr+O5N6tEO2KPVr3bsFt
+8zKHEyuddDYUju4U2Fl+xq4yJCYX3h6AKyh/c3bOAGp4f3zs62XPjn9RIXlTH9Lw
+Vp97pJRzAEYzXRGXfGJRz54hQzft1L+BkhqWpVwzxI1fnflpVghahHOIoa0bnpyH
+ycxxvkGY6o5TS5Ymqf4yry/4G+C64kX2GlBgmN2I2+UJ3z/cyEqY4XVMGk4S7uLq
+d0eKrA2ZaSHUce0F/gGpMynxGFP+BNlfNBcSwzgBbnvcyFhOtls4LvTAcLmyBpjM
+gEugtkskDSxJd/HcnTcFF5P9UcVPdD7vg7tlUXQ37AvbeppFC4pFbxYK01SOYk+W
+nXH/Mq1XkFFcArVtsL1octAWuaqn8M/5kXnKvhw/TCBNPfQ7Kljx1V65kErMXNl2
+F/cJXWQKCXPtD/92EXa9uvIxCINwxyZidwEvqx1xpBTIDDdYvDt8ZXHr957xpiaz
+ls3aHy0mMUGigzVEL0AcPToBEudEzy+z1pB0y23znveycDZRTRsGnDwLrdb9eqTu
+JDViRtB6WBASGsU3XHMYFietvEukmqJj55KCDl5YapZDKUb1iraERJ72PH9xk3C7
+501Cklfe+GM8VBymwApOjWPLw1cIxVOL/Ex9ADsVMYDubAVh0LnqvDTg8e8bv4gu
+BhyC2AXsQIUZ9HtixfvLZ6sdsPjstlQj+ZinpTHWthx52jrfcRYOo32cE06BpR3U
+bQ+mjn6orzZ7Iq5p6aejukCddvlSX381vMaLf1/FGzmu/9f52p7uTLxU7N8sEcqq
+PlkdRYatwWDeKuGpYVqmXuPvAaPD/sfH6zw0O5JjcNhb5KqTMjcV7IXV+V7QU2F5
+iH5eYepAFf5uctffFMlCZ2YtCLlISMxHWLLqupIlu/JumTLcUjXUpOMV/sp+v6gD
+66yx5QQWtVdYT9dYW+EUybjuWlS85T9DJVrPx5GiQfKjgFzuyuEvsbExzVBOwsBP
+o/pPUWyBNSI6YVrm329U7ybAuDdnTveaMtIxRneN8mM9lhXNWpb8UpvSGnMP0lLI
+tx58dQjEl3lbis897KDgzHy2pGKQDcvLdj14/xpfjeTWHI6Ut3mZylIKWg==
+=zWaw
+-----END PGP PUBLIC KEY BLOCK-----

scripts/README.md

@@ -1,29 +1,36 @@
-# Version Bump Script
+# Scripts
 
-Updates the version number across all files in the repo from a single command.
+Operational scripts for the Triangles project. See also `doc/release-process.md`
+for the canonical release pipeline documentation.
 
-## Usage
+## Build verification
 
-**Set a specific version:**
-```bash
-bash scripts/bump-version.sh 5.7.0
-```
+- **`verify-reproducible-build.sh`** — builds the daemon (or another target)
+  twice from the same source tree and verifies the SHA256 hashes match.
+  Catches accidental introduction of non-determinism (e.g. `__DATE__`/`__TIME__`
+  regressions, dirty git state, PIE base-address drift).
 
-**Or edit `src/clientversion.h` first, then sync everything else:**
-```bash
-bash scripts/bump-version.sh
-```
+## Release signing
 
-## What it updates
+- **`sign-release.sh`** — generates `SHA256SUMS`, writes detached PGP
+  signatures (`.asc`) over each release artifact and over `SHA256SUMS`.
+  Supports `--verify` for independent third-party verification.
+  Uses `TRIANGLES_RELEASE_KEY` env var (defaults to
+  `sami@cryptographic-triangles.org`).
 
-- `src/clientversion.h` (source of truth)
-- `src/version.h`
-- `triangles-qt.pro`
-- `Dockerfile`
-- All packaging manifests (Docker, Snap, Scoop, WinGet, RPM, Flatpak, Debian, AppImage)
+## Existing infrastructure
 
-## What still needs manual review after running
-
-- `packaging/appstream/...metainfo.xml` — add a new `<release>` entry
-- `README.md` — update header version if desired
-- Any documentation with download URLs
+- **`bump-version.sh`** — sync version numbers across all manifests from
+  `src/clientversion.h`.
+- **`sign-snapshot.sh`** — sign a UTXO snapshot file with the wallet's
+  signing address (not a PGP key; this is a chain-level signature, not a
+  release signature).
+- **`validate_onion_seeds.py`** — validate every `.onion` address in
+  `triangles.conf` against the v3 hidden-service checksum.
+- **`ibd-smoke-test.sh`** — fresh-datadir IBD smoke test for catching the
+  classic "stalls early / loops around 570" failure mode.
+- **`ci/build-rocksdb.sh`** — build and install a pinned RocksDB version
+  for CI.
+- **`ci/package-linux-daemon.sh`** — Linux packaging step (.deb).
+- **`ci/package-windows-daemon.sh`** — Windows packaging step.
+- **`tri/`** — operator-facing CLI for node administration.

scripts/ci/build-rocksdb.sh

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+#
+# build-rocksdb.sh — Build and install a pinned RocksDB version for CI.
+#
+# Ubuntu 22.04's librocksdb-dev is 6.11.4 (the same version that bit
+# DNS2 — see PR #10). Triangles requires RocksDB >= 7.4.0 for the XXH3
+# per-block checksum used in modern smsgDB SST files; src/smessage.cpp's
+# SecMsgDB::Open has a runtime quarantine fallback, but the build-time
+# check in CMakeLists.txt refuses to configure against < 7.4.
+#
+# This script clones RocksDB at a pinned tag, builds only the shared
+# library (fast), installs to /usr/local, and refreshes ldconfig.
+# Triangles' CMake find_library probes /usr/local before /usr/lib so
+# the just-built copy is picked up first.
+#
+# Pin policy (2026-08-02): chase the LATEST stable 10.x. "Match
+# DNS2's system librocksdb" reasoning was abandoned: forward
+# compatibility mattered more than byte-for-byte soname parity.
+#
+# Usage:  sudo ./scripts/ci/build-rocksdb.sh
+set -euo pipefail
+
+# 2026-08-02 (Sami directive: "why wouldn't we be using the latest RocksDB"):
+# Bumped 8.9.1 -> 10.10.1. Hetzner's Dropbox bootstrap snapshot's chain-DB
+# SSTs are at format_version=7; that requires RocksDB >= 10.4.0 to read.
+# 10.10.1 is the latest 10.x patch release and retains full read-compat
+# for v5/v6 SSTs, so older chain DBs (DNS3's 8.9.1 chain DB, the snapshot
+# fork) open cleanly on the new daemon. The daemon does not pin its own
+# writes to v7 — see CHANGELOG for why.
+# Pin policy: default version + commit are set together. Overriding
+# ROCKSDB_VERSION alone is allowed (e.g. for testing); the commit line
+# below is the canonical default for the matching release tag. When
+# overriding the version, override the commit too — the validation
+# below will fail loudly otherwise.
+ROCKSDB_VERSION="${ROCKSDB_VERSION:-10.10.1}"
+ROCKSDB_TAG="v${ROCKSDB_VERSION}"
+# v10.10.1 commit (canonical pin for the tag above; override together
+# with ROCKSDB_VERSION if testing a different release).
+ROCKSDB_COMMIT="${ROCKSDB_COMMIT:-4595a5e95ae8525c42e172a054435782b3479c57}"
+INSTALL_PREFIX="${INSTALL_PREFIX:-/usr/local}"
+JOBS="${JOBS:-$(nproc)}"
+
+WORKDIR="$(mktemp -d)"
+trap 'rm -rf "$WORKDIR"' EXIT
+
+echo ">>> Building RocksDB ${ROCKSDB_TAG} (${JOBS} jobs) into ${INSTALL_PREFIX}"
+
+git clone --depth 1 --branch "${ROCKSDB_TAG}" \
+    https://github.com/facebook/rocksdb.git "${WORKDIR}/rocksdb"
+
+cd "${WORKDIR}/rocksdb"
+
+ACTUAL_COMMIT="$(git rev-parse HEAD)"
+if [ "${ACTUAL_COMMIT}" != "${ROCKSDB_COMMIT}" ]; then
+    echo "!!! RocksDB ${ROCKSDB_TAG} resolved to ${ACTUAL_COMMIT}, expected ${ROCKSDB_COMMIT}" >&2
+    exit 1
+fi
+
+# Shared library only — Triangles links dynamically. Statically linking
+# rocksdb.a would also work but balloons the daemon binary by ~50 MB.
+make -j"${JOBS}" shared_lib PORTABLE=1 USE_RTTI=1 \
+    EXTRA_CXXFLAGS="-Wno-error=deprecated-declarations"
+
+make install-shared PREFIX="${INSTALL_PREFIX}"
+
+# Scrub the rocksdb.pc that install-shared just wrote. RocksDB's
+# Makefile unconditionally appends `-isystem third-party/gtest-1.8.1/
+# fused-src` to Cflags, which is a RELATIVE path baked in from the build
+# directory. Modern CMake (>= 3.27) refuses to consume imported targets
+# with non-existent relative paths in INTERFACE_INCLUDE_DIRECTORIES,
+# so pkg_check_modules(rocksdb) on a Triangles configure errors out
+# with: 'Imported target "PkgConfig::RocksDB" includes non-existent
+# path "third-party/gtest-1.8.1/fused-src"'.
+#
+# Replace the bad flag with the absolute include dir so pkg-config
+# consumers see a path that actually exists on disk.
+PC_FILE="${INSTALL_PREFIX}/lib/pkgconfig/rocksdb.pc"
+if [ -f "${PC_FILE}" ]; then
+    # Strip the -std=c++XX flag RocksDB writes into Cflags. The flag is
+    # for the rocksdb .cc files themselves, but pkg-config injects it
+    # into every Triangles translation unit — including C files like
+    # src/lz4/lz4.c, which clang refuses to compile with
+    # "invalid argument '-std=c++XX' not allowed with 'C'".
+    # RocksDB 8.x wrote -std=c++17; 10.x bumped to -std=c++20; 11.x is
+    # expected to use -std=c++2b. The regex below strips the whole
+    # family so this fix survives future bumps.
+    sed -i \
+        -e "s|-isystem third-party/gtest-1.8.1/fused-src|-I${INSTALL_PREFIX}/include|g" \
+        -e "s|-isystem \\\${prefix}/third-party/gtest-1.8.1/fused-src|-I${INSTALL_PREFIX}/include|g" \
+        -e 's|-std=c++[0-9a-z]\+ ||g' \
+        -e 's|-std=c++[0-9a-z]\+$||g' \
+        "${PC_FILE}"
+    # Sanity: any remaining -std=c++ token means a future RocksDB release
+    # wrote a new variant our regex didn't cover. Fail loudly so the CI
+    # fuzz job doesn't surprise us downstream — fix the regex here.
+    if grep -q -- '-std=c++' "${PC_FILE}"; then
+        echo "!!! rocksdb.pc still contains -std=c++ after stripping:" >&2
+        grep -- '-std=c++' "${PC_FILE}" >&2 || true
+        exit 1
+    fi
+fi
+
+ldconfig
+
+# Sanity: installed library should be on disk and registered with ldconfig.
+# ldconfig strips the patch version from its output, so we check both:
+#   1. File exists at the versioned path (definitive).
+#   2. ldconfig shows a matching major.minor (sanity for runtime linker).
+ROCKSDB_MAJOR_MINOR="${ROCKSDB_VERSION%.*}"
+if [ ! -f "${INSTALL_PREFIX}/lib/librocksdb.so.${ROCKSDB_VERSION}" ]; then
+    echo "!!! librocksdb.so.${ROCKSDB_VERSION} not found at ${INSTALL_PREFIX}/lib/" >&2
+    ls -l "${INSTALL_PREFIX}/lib/librocksdb"* 2>&1 || true
+    exit 1
+fi
+if ! ldconfig -p | grep -q "librocksdb.so.${ROCKSDB_MAJOR_MINOR}"; then
+    echo "!!! ldconfig did not register librocksdb.so.${ROCKSDB_MAJOR_MINOR}" >&2
+    ldconfig -p | grep -i rocksdb >&2 || true
+    exit 1
+fi
+
+echo ">>> RocksDB ${ROCKSDB_TAG} installed to ${INSTALL_PREFIX}"
+echo ">>>  - library:  ${INSTALL_PREFIX}/lib/librocksdb.so.${ROCKSDB_VERSION}"
+echo ">>>  - headers:  ${INSTALL_PREFIX}/include/rocksdb/version.h"
+ls -l "${INSTALL_PREFIX}/lib/librocksdb.so"* "${INSTALL_PREFIX}/include/rocksdb/version.h"

scripts/ci/package-linux-daemon.sh

@@ -0,0 +1,206 @@
+#!/usr/bin/env bash
+# scripts/ci/package-linux-daemon.sh
+#
+# Linux packaging step for the triangles daemon + CLI .deb.
+# Called from .github/workflows/build-all.yml build-linux-daemon step.
+#
+# Builds a self-contained .deb with trianglesd, triangles-cli, bundled libs,
+# Tor, systemd service, and CLI launchers. Designed to be reproducible and
+# debuggable outside the CI environment.
+#
+# Usage: bash scripts/ci/package-linux-daemon.sh <version>
+
+set -euo pipefail
+
+VERSION="${1:-0.0.0}"
+PKG="cryptographic-triangles-daemon_${VERSION}_amd64"
+TOR_VERSION="${TOR_VERSION:-15.0.9}"
+TOR_SHA256="${TOR_SHA256:-7ea13e14cddafb36c6347a9c4f4e639f6010364c16acfd519157c29e226277f2}"
+
+echo ">>> Building .deb for triangles ${VERSION}"
+
+# Stage directories
+rm -rf "${PKG}"
+mkdir -p "${PKG}/DEBIAN"
+mkdir -p "${PKG}/usr/lib/cryptographic-triangles/lib"
+mkdir -p "${PKG}/usr/lib/cryptographic-triangles/tor"
+mkdir -p "${PKG}/usr/bin"
+mkdir -p "${PKG}/etc/systemd/system"
+
+# Download + extract Tor
+TOR_TARBALL="tor-expert-bundle-linux-x86_64-${TOR_VERSION}.tar.gz"
+if [ ! -f "${TOR_TARBALL}" ]; then
+    echo ">>> Downloading Tor ${TOR_VERSION}..."
+    # Resilient download: archive.torproject.org occasionally times out from
+    # CI egress (observed 2026-07-03: macOS job exit code 6 after exactly 30s
+    # of curl hang). --retry 3 + --retry-connrefused covers transient network
+    # drops; --fail-with-body surfaces HTTP errors loudly.
+    curl -fSL --connect-timeout 15 --max-time 120 \
+        --retry 3 --retry-delay 5 --retry-connrefused --retry-all-errors \
+        "https://archive.torproject.org/tor-package-archive/torbrowser/${TOR_VERSION}/${TOR_TARBALL}" \
+        -o "${TOR_TARBALL}"
+fi
+printf '%s  %s\n' "${TOR_SHA256}" "${TOR_TARBALL}" | sha256sum --check --strict -
+mkdir -p tor-extract
+tar -xzf "${TOR_TARBALL}" -C tor-extract
+
+# Copy binaries
+cp "build/bin/trianglesd"    "${PKG}/usr/lib/cryptographic-triangles/"
+cp "build/bin/triangles-cli" "${PKG}/usr/lib/cryptographic-triangles/"
+
+# Copy Tor
+cp "tor-extract/tor/tor" "${PKG}/usr/lib/cryptographic-triangles/tor/"
+chmod +x "${PKG}/usr/lib/cryptographic-triangles/tor/tor"
+if [ -d "tor-extract/data" ]; then
+    cp -r "tor-extract/data" "${PKG}/usr/lib/cryptographic-triangles/tor/data"
+fi
+
+# Bundle shared library dependencies (skip glibc/kernel — always present)
+echo ">>> Bundling shared library dependencies..."
+ALL_LIBS="$(mktemp)"
+trap 'rm -f "${ALL_LIBS}"' EXIT
+
+for bin in trianglesd triangles-cli; do
+    ldd "build/bin/${bin}" 2>/dev/null \
+        | grep '=> /' \
+        | awk '{print $3}' \
+        >> "${ALL_LIBS}" || true
+done
+
+if [ -s "${ALL_LIBS}" ]; then
+    sort -u "${ALL_LIBS}" | while IFS= read -r lib; do
+        if [ -z "${lib}" ]; then continue; fi
+        case "${lib}" in
+            /lib/x86_64-linux-gnu/libc.so*|/lib/x86_64-linux-gnu/libm.so*|/lib/x86_64-linux-gnu/libpthread.so*|/lib/x86_64-linux-gnu/libdl.so*|/lib/x86_64-linux-gnu/librt.so*|/lib/x86_64-linux-gnu/ld-linux*|/lib64/ld-linux*)
+                ;;  # Skip glibc core
+            *)
+                cp -L "${lib}" "${PKG}/usr/lib/cryptographic-triangles/lib/" 2>/dev/null || true
+                ;;
+        esac
+    done
+fi
+
+echo ">>> Bundled libs:"
+ls -la "${PKG}/usr/lib/cryptographic-triangles/lib/" | tail -n +2 | wc -l
+
+# Launchers (set LD_LIBRARY_PATH for bundled libs)
+cat > "${PKG}/usr/bin/trianglesd" << 'LAUNCHER'
+#!/bin/bash
+INSTALL_DIR=/usr/lib/cryptographic-triangles
+export LD_LIBRARY_PATH="${INSTALL_DIR}/lib:${LD_LIBRARY_PATH}"
+exec "${INSTALL_DIR}/trianglesd" "$@"
+LAUNCHER
+chmod +x "${PKG}/usr/bin/trianglesd"
+
+cat > "${PKG}/usr/bin/triangles-cli" << 'LAUNCHER'
+#!/bin/bash
+INSTALL_DIR=/usr/lib/cryptographic-triangles
+export LD_LIBRARY_PATH="${INSTALL_DIR}/lib:${LD_LIBRARY_PATH}"
+exec "${INSTALL_DIR}/triangles-cli" "$@"
+LAUNCHER
+chmod +x "${PKG}/usr/bin/triangles-cli"
+
+# systemd unit
+cat > "${PKG}/etc/systemd/system/trianglesd.service" << 'SVC'
+[Unit]
+Description=Cryptographic Triangles Daemon
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=triangles
+Group=triangles
+UMask=0077
+Environment=HOME=/var/lib/triangles
+Environment=LD_LIBRARY_PATH=/usr/lib/cryptographic-triangles/lib
+StateDirectory=triangles
+StateDirectoryMode=0700
+WorkingDirectory=/var/lib/triangles
+ExecStart=/usr/lib/cryptographic-triangles/trianglesd -datadir=/var/lib/triangles -conf=/etc/triangles/triangles.conf -printtoconsole
+Restart=on-failure
+RestartSec=10
+NoNewPrivileges=true
+PrivateDevices=true
+PrivateTmp=true
+ProtectClock=true
+ProtectControlGroups=true
+ProtectHome=true
+ProtectHostname=true
+ProtectKernelModules=true
+ProtectKernelTunables=true
+ProtectSystem=strict
+ReadWritePaths=/var/lib/triangles
+CapabilityBoundingSet=
+LockPersonality=true
+MemoryDenyWriteExecute=true
+RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6
+RestrictRealtime=true
+RestrictSUIDSGID=true
+SystemCallArchitectures=native
+
+[Install]
+WantedBy=multi-user.target
+SVC
+
+# DEBIAN/control
+cat > "${PKG}/DEBIAN/control" << CTRL
+Package: cryptographic-triangles-daemon
+Version: ${VERSION}
+Architecture: amd64
+Maintainer: Cryptographic Triangles <dev@cryptographic-triangles.org>
+Description: Cryptographic Triangles daemon + CLI with integrated Tor
+ Fully self-contained headless node + JSON-RPC client with all libraries,
+ Tor, and systemd service. No external dependencies required.
+Section: finance
+Priority: optional
+Depends: adduser
+CTRL
+
+# DEBIAN/postinst
+cat > "${PKG}/DEBIAN/postinst" << 'POST'
+#!/bin/bash
+set -e
+
+if ! getent group triangles >/dev/null; then
+    addgroup --system triangles
+fi
+if ! id triangles >/dev/null 2>&1; then
+    adduser --system --ingroup triangles --home /var/lib/triangles \
+        --no-create-home --disabled-login triangles
+fi
+
+install -d -m 0700 -o triangles -g triangles /var/lib/triangles
+install -d -m 0750 -o root -g triangles /etc/triangles
+
+if [ ! -e /etc/triangles/triangles.conf ]; then
+    RPC_PASSWORD="$(dd if=/dev/urandom bs=32 count=1 2>/dev/null | od -An -tx1 | tr -d ' \n')"
+    CONFIG_TMP="$(mktemp)"
+    trap 'rm -f "${CONFIG_TMP}"' EXIT
+    cat > "${CONFIG_TMP}" << CONF
+server=1
+rpcuser=trianglesrpc
+rpcpassword=${RPC_PASSWORD}
+rpcbind=127.0.0.1
+rpcallowip=127.0.0.1
+rest=0
+upnp=0
+CONF
+    install -m 0640 -o root -g triangles "${CONFIG_TMP}" /etc/triangles/triangles.conf
+fi
+
+systemctl daemon-reload
+echo ""
+echo "Cryptographic Triangles daemon + CLI installed."
+echo "  Start daemon: sudo systemctl start trianglesd"
+echo "  On boot:      sudo systemctl enable trianglesd"
+echo "  Use CLI:      triangles-cli getinfo"
+echo ""
+POST
+chmod +x "${PKG}/DEBIAN/postinst"
+
+# Build the .deb
+dpkg-deb --build "${PKG}"
+echo ">>> Built: ${PKG}.deb"
+ls -la "${PKG}.deb"
+exit 0

scripts/ci/package-windows-daemon.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+# scripts/ci/package-windows-daemon.sh
+#
+# Windows MSYS2 packaging step for the triangles daemon + CLI.
+# Called from .github/workflows/build-all.yml build-windows-daemon step.
+#
+# Why a script file instead of inline YAML:
+# The GitHub Actions msys2 shell wrapper has shown inconsistent handling of
+# multi-line inline run: blocks under `set -e -o pipefail` (silent exits with
+# code 1). A committed script file bypasses the YAML → shell translation
+# quirks and gives us a known-good artifact that we can also run locally in
+# MSYS2 for debugging.
+#
+# Usage: bash scripts/ci/package-windows-daemon.sh <dist-dir> <bin> [<bin> ...]
+# Example: bash scripts/ci/package-windows-daemon.sh daemon-dist trianglesd triangles-cli
+
+set -euo pipefail
+
+DIST="${1:-daemon-dist}"
+shift
+BINS=("$@")
+
+if [ "${#BINS[@]}" -eq 0 ]; then
+    echo "Usage: $0 <dist-dir> <bin> [<bin> ...]" >&2
+    echo "  e.g. $0 daemon-dist trianglesd triangles-cli" >&2
+    exit 2
+fi
+
+echo ">>> Package step: bins=${BINS[*]} dist=${DIST}"
+
+# Make the dist directory
+mkdir -p "${DIST}/tor"
+
+# Copy each binary to dist/
+for bin in "${BINS[@]}"; do
+    src="build/bin/${bin}.exe"
+    if [ ! -f "${src}" ]; then
+        echo "ERROR: ${src} not found" >&2
+        exit 3
+    fi
+    cp "${src}" "${DIST}/"
+    echo "  copied ${src} -> ${DIST}/"
+done
+
+# Copy linked DLLs (union of all binaries' dependencies, deduped)
+echo ">>> Collecting DLLs from ldd output..."
+ALL_DLLS="$(mktemp)"
+trap 'rm -f "${ALL_DLLS}"' EXIT
+
+for bin in "${BINS[@]}"; do
+    src="build/bin/${bin}.exe"
+    ldd "${src}" 2>/dev/null \
+        | grep '/mingw64' \
+        | awk '{print $3}' \
+        >> "${ALL_DLLS}" || true
+done
+
+if [ ! -s "${ALL_DLLS}" ]; then
+    echo "WARNING: no /mingw64 DLLs found in ldd output for ${BINS[*]}" >&2
+else
+    echo ">>> Copying $(sort -u "${ALL_DLLS}" | wc -l) unique DLLs..."
+    sort -u "${ALL_DLLS}" | while IFS= read -r dll; do
+        if [ -n "${dll}" ] && [ -f "${dll}" ]; then
+            cp "${dll}" "${DIST}/" || echo "WARN: failed to copy ${dll}" >&2
+        fi
+    done
+fi
+
+echo ">>> Package complete: $(ls -1 "${DIST}" | wc -l) files in ${DIST}/"
+ls -la "${DIST}/"
+exit 0

scripts/pre-commit

@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# .git/hooks/pre-commit — Cryptographic Triangles
+#
+# Auto-runs scripts/validate_onion_seeds.py against any staged file that
+# contains .onion addresses. Blocks the commit if any address fails v3
+# onion checksum validation.
+#
+# This is the primary defense against the "1-character .onion transposition
+# bug" that caused 4,842 Tor "No more HSDir" errors during the 2026-06-21
+# from-zero sync test. See scripts/validate_onion_seeds.py for the validator
+# and references/sync-security-audit-2026-06-21.md for the full story.
+#
+# The hook scans staged files for two patterns:
+#   1. Filename matches: triangles.conf, *.onion
+#   2. Content contains addnode= entries with .onion addresses
+#
+# To install:
+#   cp scripts/pre-commit .git/hooks/pre-commit
+#   chmod +x .git/hooks/pre-commit
+#
+# To bypass (in emergencies only — NEVER do this for normal commits):
+#   git commit --no-verify
+
+set -e
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+VALIDATOR="${REPO_ROOT}/scripts/validate_onion_seeds.py"
+
+# Find the validator
+if [[ ! -x "$VALIDATOR" ]]; then
+    echo "pre-commit: WARNING: $VALIDATOR not found or not executable" >&2
+    echo "pre-commit: skipping v3 onion validation" >&2
+    echo "pre-commit: install with: chmod +x $VALIDATOR" >&2
+    exit 0
+fi
+
+# Two-pass detection:
+#   Pass 1: filename-based — files named triangles.conf or *.onion
+#   Pass 2: content-based — any file containing "addnode=" + .onion address
+
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACMR)
+
+# Pass 1: filename-based
+NAME_MATCHES=$(echo "$STAGED_FILES" | grep -E '(triangles\.conf$|\.onion$)' || true)
+
+# Pass 2: content-based — find staged files containing addnode= with .onion addresses
+CONTENT_MATCHES=""
+for f in $STAGED_FILES; do
+    if [[ -f "$f" ]] && grep -qE '^[[:space:]]*addnode=[a-z2-7]{56}\.onion' "$f" 2>/dev/null; then
+        CONTENT_MATCHES="$CONTENT_MATCHES $f"
+    fi
+done
+
+# Combine and dedupe
+ALL_MATCHES=$(printf "%s\n%s\n" "$NAME_MATCHES" "$CONTENT_MATCHES" | sort -u | grep -v '^$' || true)
+
+if [[ -z "$ALL_MATCHES" ]]; then
+    # Nothing to validate
+    exit 0
+fi
+
+# Filter to only files that exist (skip deletions)
+EXISTING_CONFIGS=""
+for f in $ALL_MATCHES; do
+    if [[ -f "$f" ]]; then
+        EXISTING_CONFIGS="$EXISTING_CONFIGS $f"
+    fi
+done
+
+if [[ -z "$EXISTING_CONFIGS" ]]; then
+    exit 0
+fi
+
+COUNT=$(echo $EXISTING_CONFIGS | wc -w)
+echo "pre-commit: validating $COUNT staged file(s) with .onion addresses..."
+
+# Build the validator command
+CMD="python3 \"$VALIDATOR\" --no-color --ci"
+if [[ -f "${REPO_ROOT}/src/onionseed.h" ]]; then
+    CMD="$CMD --against \"${REPO_ROOT}/src/onionseed.h\""
+fi
+
+# Run the validator
+if eval $CMD $EXISTING_CONFIGS; then
+    echo "pre-commit: v3 onion validation PASSED"
+    exit 0
+else
+    EXIT_CODE=$?
+    echo "" >&2
+    echo "pre-commit: v3 onion validation FAILED (exit $EXIT_CODE)" >&2
+    echo "" >&2
+    echo "  The commit was blocked because one or more .onion addresses failed" >&2
+    echo "  v3 hidden service checksum validation. This means the .onion address" >&2
+    echo "  has a typo or character transposition that Tor will reject at runtime" >&2
+    echo "  with 'ed25519 validation failed' / 'No more HSDir available to query'." >&2
+    echo "" >&2
+    echo "  Fix the .onion address in the affected file, then re-stage and commit." >&2
+    echo "" >&2
+    echo "  To inspect the failure in detail, run manually:" >&2
+    echo "    python3 $VALIDATOR --against ${REPO_ROOT}/src/onionseed.h \\" >&2
+    echo "      $EXISTING_CONFIGS" >&2
+    echo "" >&2
+    echo "  To bypass this check (DO NOT do this for normal commits):" >&2
+    echo "    git commit --no-verify" >&2
+    exit 1
+fi

scripts/sign-release.sh

@@ -0,0 +1,222 @@
+#!/usr/bin/env bash
+# sign-release.sh
+#
+# Sign Triangles release artifacts (the binaries/.debs/.dmgs/.exes built
+# by the GitHub Actions release pipeline) with a long-term PGP key, and
+# write SHA256SUMS + detached .asc signatures alongside each artifact.
+#
+# Usage:
+#   scripts/sign-release.sh /path/to/release-dir
+#   scripts/sign-release.sh /path/to/release-dir --key 0xDEADBEEF
+#   scripts/sign-release.sh --verify /path/to/release-dir
+#
+# Inputs (in the release directory):
+#   - *.tar.gz, *.deb, *.dmg, *.exe, *.zip, *.AppImage (any release artifact)
+#   - SHA256SUMS file (if present, re-signed; if absent, generated)
+#
+# Outputs (written next to each artifact):
+#   - <artifact>.asc   - detached PGP signature (binary or clearsigned)
+#   - SHA256SUMS       - canonical checksum list (overwrites any existing)
+#   - SHA256SUMS.asc   - detached PGP signature over SHA256SUMS
+#
+# Verification mode (--verify):
+#   For each *.asc, runs `gpg --verify` against the artifact.
+#   Then runs `sha256sum -c SHA256SUMS` if present.
+#   Exits 0 if all artifacts verify; non-zero on any failure.
+#
+# Requirements:
+#   - gpg2 or gpg on PATH
+#   - Signing key already in the local keyring (or use --key to select)
+#   - For verification: the signer's public key must be importable
+#     (either already in the keyring, or fetched from a keyserver)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_KEY="${TRIANGLES_RELEASE_KEY:-sami@cryptographic-triangles.org}"
+
+usage() {
+    sed -n '2,30p' "$0"
+    exit "${1:-1}"
+}
+
+# ── Parse args ─────────────────────────────────────────────────────────────
+MODE="sign"
+RELEASE_DIR=""
+SIGN_KEY="$DEFAULT_KEY"
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --verify)
+            MODE="verify"
+            shift
+            ;;
+        --key)
+            SIGN_KEY="$2"
+            shift 2
+            ;;
+        -h|--help)
+            usage 0
+            ;;
+        *)
+            RELEASE_DIR="$1"
+            shift
+            ;;
+    esac
+done
+
+if [ -z "$RELEASE_DIR" ]; then
+    echo "ERROR: release directory required" >&2
+    usage 2
+fi
+
+if [ ! -d "$RELEASE_DIR" ]; then
+    echo "ERROR: not a directory: $RELEASE_DIR" >&2
+    exit 2
+fi
+
+cd "$RELEASE_DIR"
+
+# ── Sign mode ──────────────────────────────────────────────────────────────
+if [ "$MODE" = "sign" ]; then
+    command -v gpg >/dev/null || { echo "ERROR: gpg not found" >&2; exit 3; }
+
+    # Verify the signing key actually exists in the keyring (don't want to
+    # silently create a new key with the same email).
+    if ! gpg --list-secret-keys "$SIGN_KEY" >/dev/null 2>&1; then
+        echo "ERROR: signing key '$SIGN_KEY' not found in local keyring" >&2
+        echo "       import it first: gpg --import <keyfile>" >&2
+        exit 3
+    fi
+
+    echo "Signing artifacts in $RELEASE_DIR with key $SIGN_KEY..."
+
+    # Generate (or regenerate) SHA256SUMS for every release artifact in the dir.
+    # Recognized extensions: .tar.gz, .deb, .dmg, .exe, .zip, .AppImage, .dmg.blockmap
+    # Excludes: .asc files, SHA256SUMS itself, README/notes text files.
+    ARTIFACTS=()
+    while IFS= read -r -d '' f; do
+        case "$f" in
+            *.asc|SHA256SUMS|SHA256SUMS.asc|*.txt|*.md) continue ;;
+        esac
+        ARTIFACTS+=("$f")
+    done < <(find . -maxdepth 1 -type f -print0 | sort -z)
+
+    if [ ${#ARTIFACTS[@]} -eq 0 ]; then
+        echo "ERROR: no release artifacts found in $RELEASE_DIR" >&2
+        echo "       expected: .tar.gz, .deb, .dmg, .exe, .zip, .AppImage" >&2
+        exit 4
+    fi
+
+    echo "  Found ${#ARTIFACTS[@]} artifact(s):"
+    for a in "${ARTIFACTS[@]}"; do echo "    - $a"; done
+    echo ""
+
+    # Regenerate SHA256SUMS from scratch (deterministic sort).
+    : > SHA256SUMS
+    for a in "${ARTIFACTS[@]}"; do
+        sha256sum "$a" >> SHA256SUMS
+    done
+    echo "✓ Wrote SHA256SUMS"
+
+    # Detached signature over each artifact.
+    for a in "${ARTIFACTS[@]}"; do
+        rm -f "${a}.asc"
+        if gpg --batch --yes \
+               --local-user "$SIGN_KEY" \
+               --armor --detach-sign \
+               --output "${a}.asc" \
+               "$a" 2>/dev/null; then
+            echo "✓ Signed ${a}"
+        else
+            echo "✗ Failed to sign ${a}" >&2
+            exit 5
+        fi
+    done
+
+    # Detached signature over SHA256SUMS (this is what verifiers actually check
+    # first; individual .asc files are belt-and-suspenders).
+    rm -f SHA256SUMS.asc
+    if gpg --batch --yes \
+           --local-user "$SIGN_KEY" \
+           --armor --detach-sign \
+           --output SHA256SUMS.asc \
+           SHA256SUMS 2>/dev/null; then
+        echo "✓ Signed SHA256SUMS"
+    else
+        echo "✗ Failed to sign SHA256SUMS" >&2
+        exit 5
+    fi
+
+    echo ""
+    echo "Done. To verify from this directory:"
+    echo "  gpg --verify SHA256SUMS.asc SHA256SUMS"
+    echo "  sha256sum -c SHA256SUMS"
+    echo ""
+    echo "Or run: $0 --verify $RELEASE_DIR"
+    exit 0
+fi
+
+# ── Verify mode ───────────────────────────────────────────────────────────
+if [ "$MODE" = "verify" ]; then
+    command -v gpg >/dev/null || { echo "ERROR: gpg not found" >&2; exit 3; }
+
+    FAILED=0
+
+    echo "Verifying signatures in $RELEASE_DIR..."
+    echo ""
+
+    # Verify SHA256SUMS.asc if present (this is the master signature).
+    if [ -f SHA256SUMS ] && [ -f SHA256SUMS.asc ]; then
+        if gpg --verify SHA256SUMS.asc SHA256SUMS 2>/dev/null; then
+            echo "✓ SHA256SUMS signature: VALID ($(gpg --list-packets < SHA256SUMS.asc 2>/dev/null | grep -oP 'keyid \K[A-F0-9]+' | head -1 || echo unknown))"
+        else
+            echo "✗ SHA256SUMS signature: INVALID"
+            FAILED=$((FAILED + 1))
+        fi
+    else
+        echo "(no SHA256SUMS / SHA256SUMS.asc; skipping master signature)"
+    fi
+
+    # Verify each artifact's individual signature.
+    while IFS= read -r -d '' asc; do
+        artifact="${asc%.asc}"
+        if [ ! -f "$artifact" ]; then
+            echo "✗ $asc: artifact missing ($artifact)"
+            FAILED=$((FAILED + 1))
+            continue
+        fi
+        if gpg --verify "$asc" "$artifact" 2>/dev/null; then
+            echo "✓ $artifact signature: VALID"
+        else
+            echo "✗ $artifact signature: INVALID"
+            FAILED=$((FAILED + 1))
+        fi
+    done < <(find . -maxdepth 1 -name "*.asc" -not -name "SHA256SUMS.asc" -print0 | sort -z)
+
+    # Verify checksums.
+    if [ -f SHA256SUMS ]; then
+        echo ""
+        echo "Verifying checksums..."
+        if sha256sum -c SHA256SUMS 2>&1 | tail -n +3; then
+            :  # sha256sum -c outputs per-file status; aggregate below
+        fi
+        # Count any "FAILED" lines from sha256sum -c output.
+        CHECKSUM_FAILS="$(sha256sum -c SHA256SUMS 2>&1 | grep -c ': FAILED' || true)"
+        if [ "$CHECKSUM_FAILS" -gt 0 ]; then
+            echo "✗ $CHECKSUM_FAILS checksum(s) FAILED"
+            FAILED=$((FAILED + CHECKSUM_FAILS))
+        else
+            echo "✓ All checksums match SHA256SUMS"
+        fi
+    fi
+
+    echo ""
+    if [ "$FAILED" -eq 0 ]; then
+        echo "✓ ALL VERIFICATIONS PASSED"
+        exit 0
+    else
+        echo "✗ $FAILED VERIFICATION(S) FAILED"
+        exit 1
+    fi
+fi

scripts/sign-snapshot.sh

@@ -0,0 +1,182 @@
+#!/usr/bin/env bash
+# ============================================================================
+# Triangles UTXO Snapshot Signer
+# ============================================================================
+# Generates a UTXO snapshot from the current node, signs its provenance
+# message with the wallet's signing address, and writes the signed manifest.
+#
+# Usage:
+#   ./sign-snapshot.sh [snapshot-name]
+#
+# Default snapshot name: tri-utxo-snapshot-<timestamp>.utx
+# Output (in this dir):
+#   <snapshot-name>              - the UTXO snapshot binary
+#   <snapshot-name>.sig          - base64 signature
+#   <snapshot-name>.msg          - signed message (human-readable provenance)
+#   <snapshot-name>.manifest.json - signed manifest (drop into bootstrap dir)
+#   <snapshot-name>.pubkey       - signing address
+#
+# Requirements:
+#   - trianglesd running with RPC enabled
+#   - wallet unlocked (or passphrase set in triangles.conf)
+#   - jq installed (apt: jq / brew: jq)
+#
+# Verification:
+#   ./sign-snapshot.sh verify <manifest.json> <snapshot-file>
+#   OR via RPC:
+#     verifymessage <addr> <sig> <msg>
+# ============================================================================
+
+set -euo pipefail
+
+# ----- Config (override via env) -----
+RPC_USER="${RPC_USER:-trianglesrpc}"
+RPC_PASS="${RPC_PASS:-2KVK2FvLZBW9Hxv4a2Uj3dMRDAXdh4ei6S5tdZ3z2Mme}"
+RPC_HOST="${RPC_HOST:-127.0.0.1}"
+RPC_PORT="${RPC_PORT:-19112}"
+SIGN_ACCOUNT="${SIGN_ACCOUNT:-}"      # blank = use default account
+NHEADERS="${NHEADERS:-2000}"
+SNAP_DIR="${SNAP_DIR:-.}"
+
+# ----- Helpers -----
+rpc() {
+    local method="$1"; shift
+    local params="$1"; shift || true
+    curl -s --user "${RPC_USER}:${RPC_PASS}" \
+         -X POST -H 'Content-Type: application/json' \
+         --data "{\"jsonrpc\":\"1.0\",\"method\":\"${method}\",\"params\":${params}}" \
+         "http://${RPC_HOST}:${RPC_PORT}/"
+}
+
+rpc_field() {
+    local method="$1"; shift
+    local params="$1"; shift || true
+    local field="$1"; shift
+    rpc "$method" "$params" | jq -r ".result.${field} // empty"
+}
+
+sha256_file() { sha256sum "$1" | awk '{print $1}'; }
+
+# ----- Verify mode -----
+if [[ "${1:-}" == "verify" ]]; then
+    MANIFEST="${2:?usage: $0 verify <manifest.json> <snapshot-file>}"
+    SNAP="${3:?usage: $0 verify <manifest.json> <snapshot-file>}"
+    ADDR=$(jq -r '.signing_address' "$MANIFEST")
+    SIG=$(jq -r '.signature' "$MANIFEST")
+    MSG=$(jq -r '.message' "$MANIFEST")
+    EXPECTED_SHA=$(jq -r '.snapshot_sha256' "$MANIFEST")
+
+    echo "==> Verifying snapshot provenance..."
+    echo "    Address:  $ADDR"
+    echo "    Message:  $MSG"
+
+    ACTUAL_SHA=$(sha256_file "$SNAP")
+    if [[ "$ACTUAL_SHA" != "$EXPECTED_SHA" ]]; then
+        echo "FAIL: snapshot sha256 mismatch"
+        echo "  expected: $EXPECTED_SHA"
+        echo "  actual:   $ACTUAL_SHA"
+        exit 1
+    fi
+    echo "OK: sha256 matches"
+
+    PARAMS=$(jq -nc --arg a "$ADDR" --arg s "$SIG" --arg m "$MSG" \
+                   '[$a, $s, $m]')
+    RESULT=$(rpc verifymessage "$PARAMS" | jq -r '.result')
+    if [[ "$RESULT" == "true" ]]; then
+        echo "OK: signature valid — snapshot was signed by $ADDR"
+        exit 0
+    else
+        echo "FAIL: signature does not verify"
+        exit 1
+    fi
+fi
+
+# ----- Generate + sign -----
+SNAP_NAME="${1:-tri-utxo-snapshot-$(date -u +%Y%m%dT%H%M%SZ).utx}"
+SNAP_PATH="${SNAP_DIR}/${SNAP_NAME}"
+
+echo "==> Step 1/5: querying chain state..."
+HEIGHT=$(rpc_field getblockcount '[]' '' || echo "")
+if [[ -z "$HEIGHT" ]]; then
+    rpc_field getblockcount '[]' ''  # re-run for error visibility
+    echo "FAIL: RPC getblockcount failed"; exit 1
+fi
+HEIGHT=$(rpc getblockcount '[]' | jq -r '.result')
+BLOCKHASH=$(rpc getbestblockhash '[]' | jq -r '.result')
+echo "    height:   $HEIGHT"
+echo "    blockhash:$BLOCKHASH"
+
+echo "==> Step 2/5: selecting signing address..."
+if [[ -n "$SIGN_ACCOUNT" ]]; then
+    PARAMS=$(jq -nc --arg a "$SIGN_ACCOUNT" '[$a]')
+else
+    PARAMS='[""]'
+fi
+ADDR=$(rpc getaccountaddress "$PARAMS" | jq -r '.result')
+echo "    signer:   $ADDR"
+
+echo "==> Step 3/5: dumping UTXO snapshot..."
+PARAMS=$(jq -nc --arg f "$SNAP_PATH" --argjson n "$NHEADERS" '[$f, $n]')
+DUMP_RESULT=$(rpc dumputxoset "$PARAMS")
+echo "$DUMP_RESULT" | jq -r '.result // .error.message // .'
+SIZE=$(echo "$DUMP_RESULT" | jq -r '.result.file_size // empty')
+if [[ -z "$SIZE" ]]; then
+    echo "FAIL: dumputxoset failed"; exit 1
+fi
+echo "    size:     $SIZE bytes"
+
+echo "==> Step 4/5: signing provenance message..."
+SHA=$(sha256_file "$SNAP_PATH")
+MSG="Triangles UTXO Snapshot $(date -u +%Y-%m-%d): height=$HEIGHT hash=$BLOCKHASH sha256=$SHA"
+echo "    message:  $MSG"
+PARAMS=$(jq -nc --arg a "$ADDR" --arg m "$MSG" '[$a, $m]')
+SIG=$(rpc signmessage "$PARAMS" | jq -r '.result')
+echo "    sig:      $SIG"
+
+echo "==> Step 5/5: writing manifest + sidecars..."
+MANIFEST_PATH="${SNAP_PATH}.manifest.json"
+jq -n \
+   --arg name "$SNAP_NAME" \
+   --arg height "$HEIGHT" \
+   --arg hash "$BLOCKHASH" \
+   --arg sha "$SHA" \
+   --arg size "$SIZE" \
+   --arg msg "$MSG" \
+   --arg sig "$SIG" \
+   --arg addr "$ADDR" \
+   --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+   --arg ver "$(rpc getnetworkinfo '[]' | jq -r '.result.version // "unknown"')" \
+   '{
+        schema: "triangles-utxo-snapshot-signed/v1",
+        name: $name,
+        generated_utc: $ts,
+        daemon_version: $ver,
+        chain_tip: { height: ($height | tonumber), blockhash: $hash },
+        snapshot_sha256: $sha,
+        snapshot_bytes: ($size | tonumber),
+        signing_address: $addr,
+        message: $msg,
+        signature: $sig
+    }' > "$MANIFEST_PATH"
+
+# Sidecar files for easy reading
+echo "$ADDR"  > "${SNAP_PATH}.pubkey"
+echo "$MSG"   > "${SNAP_PATH}.msg"
+echo "$SIG"   > "${SNAP_PATH}.sig"
+
+echo ""
+echo "============================================================"
+echo "Snapshot signed."
+echo "  snapshot:      $SNAP_PATH"
+echo "  signature:     ${SNAP_PATH}.sig"
+echo "  manifest:      $MANIFEST_PATH"
+echo "  signer:        $ADDR"
+echo "  sha256:        $SHA"
+echo "============================================================"
+echo ""
+echo "To verify on any node:"
+echo "  verifymessage $ADDR \\"
+echo "    '$SIG' \\"
+echo "    '$MSG'"
+echo ""
+echo "Or run: $0 verify $MANIFEST_PATH $SNAP_PATH"

scripts/tri-pi-test.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# tri-pi-test.sh — Run Triangles on emulated Raspberry Pi variants via QEMU
+# 
+# Usage:
+#   ./tri-pi-test.sh [pi-model] [tri-args...]
+#
+# Pi models supported (aarch64):
+#   pi3       Pi 3B/3A+ (Cortex-A53, 64-bit)  — user-mode QEMU
+#   pi4       Pi 4B (Cortex-A72, 64-bit)      — user-mode QEMU
+#   pi5       Pi 5 (Cortex-A76, 64-bit)       — user-mode QEMU
+#   pi3-full  Pi 3B — full system emulation (qemu-system-aarch64 -M raspi3b)
+#
+# Examples:
+#   ./tri-pi-test.sh pi3 --version
+#   ./tri-pi-test.sh pi4 -regtest -notor -recovery-mode=1 -printtoconsole
+#   ./tri-pi-test.sh pi3-full   # boots a full Pi OS (needs rootfs image)
+#
+# The aarch64 tri binaries are cross-compiled on DNS2 and run under
+# qemu-aarch64-static. This tests the ARM binary's correctness — ABI
+# compatibility, library resolution, crypto operations, database access,
+# and Tor integration — without needing physical Pi hardware.
+#
+# For full-system emulation (testing kernel/hardware/driver interaction),
+# use pi3-full mode with a Raspberry Pi OS rootfs.
+# ==============================================================================
+
+set -euo pipefail
+
+PI_MODEL="${1:-pi3}"
+shift || true
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TRI_SRC="/root/triangles_v5"
+TRI_AARCH64_BIN="${TRI_SRC}/build-aarch64/bin/trianglesd"
+TRI_AARCH64_CLI="${TRI_SRC}/build-aarch64/bin/triangles-cli"
+QEMU_USER="/usr/bin/qemu-aarch64-static"
+QEMU_SYS="/usr/bin/qemu-system-aarch64"
+ARM_SYSROOT="/usr/aarch64-linux-gnu"
+
+# Verify binary exists
+if [[ ! -f "$TRI_AARCH64_BIN" ]]; then
+    echo "ERROR: aarch64 trianglesd not found at $TRI_AARCH64_BIN" >&2
+    echo "Build it with: cd $TRI_SRC && cmake --build build-aarch64 --target trianglesd" >&2
+    exit 1
+fi
+
+run_user_mode() {
+    local binary="$1"
+    shift
+    local model_name="$1"
+    shift
+    
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║  Triangles on Raspberry Pi ${model_name} (QEMU user-mode)  ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    echo ""
+    echo "Binary:  $(file "$binary" | cut -d: -f2)"
+    echo "QEMU:    $($QEMU_USER --version | head -1)"
+    echo "Args:    $*"
+    echo ""
+    
+    # QEMU user-mode runs the ARM binary with the host kernel but ARM user-space
+    # -L sets the sysroot for dynamic linker/library resolution
+    exec "$QEMU_USER" -L "$ARM_SYSROOT" "$binary" "$@"
+}
+
+run_full_system_pi3() {
+    echo "╔═══════════════════════════════════════════════════════════╗"
+    echo "║  Triangles on Raspberry Pi 3B (QEMU full-system)         ║"
+    echo "╚═══════════════════════════════════════════════════════════╝"
+    
+    local IMG_DIR="${TRI_SRC}/pi-emulation/images"
+    local KERNEL="${IMG_DIR}/kernel8.img"
+    local DTB="${IMG_DIR}/bcm2710-rpi-3-b.dtb"
+    local ROOTFS="${IMG_DIR}/raspios-trixie-arm64.img"
+    local OVERLAY="/tmp/tri-pi3-overlay.qcow2"
+    
+    if [[ ! -f "$KERNEL" ]] || [[ ! -f "$ROOTFS" ]]; then
+        echo "ERROR: Pi 3 full-system images not found in $IMG_DIR" >&2
+        echo "" >&2
+        echo "To set up full-system emulation:" >&2
+        echo "  1. Download Raspberry Pi OS Lite (64-bit) from raspberrypi.com" >&2
+        echo "  2. Extract kernel8.img from the boot partition" >&2
+        echo "  3. Get the DTB: bcm2710-rpi-3-b.dtb from the boot partition" >&2
+        echo "  4. Place all in: $IMG_DIR/" >&2
+        echo "" >&2
+        echo "User-mode testing (default) works without these files." >&2
+        exit 1
+    fi
+    
+    # Create overlay so we don't modify the base image
+    qemu-img create -f qcow2 -b "$ROOTFS" "$OVERLAY" 2>/dev/null || true
+    
+    exec "$QEMU_SYS" \
+        -M raspi3b \
+        -kernel "$KERNEL" \
+        -dtb "$DTB" \
+        -drive "file=$OVERLAY,if=sd,format=qcow2" \
+        -m 1G \
+        -smp 4 \
+        -nographic \
+        -append "console=ttyAMA0 root=/dev/mmcblk0p2 rootwait rw quiet"
+}
+
+case "$PI_MODEL" in
+    pi3|pi4|pi5)
+        # All three use the same aarch64 binary — the binary is 
+        # architecture-compatible across Cortex-A53/A72/A76.
+        # The model name documents which hardware variant is being simulated.
+        run_user_mode "$TRI_AARCH64_BIN" "$PI_MODEL (Cortex-A*)"
+        "$@"
+        ;;
+    pi3-cli|pi4-cli|pi5-cli)
+        run_user_mode "$TRI_AARCH64_CLI" "$PI_MODEL CLI" "$@"
+        ;;
+    pi3-full)
+        run_full_system_pi3
+        ;;
+    *)
+        echo "Unknown model: $PI_MODEL" >&2
+        echo "Supported: pi3, pi4, pi5, pi3-cli, pi4-cli, pi5-cli, pi3-full" >&2
+        exit 1
+        ;;
+esac

scripts/tri/README.md

@@ -0,0 +1,77 @@
+# tri — Cryptographic Triangles CLI
+
+A friendly bash wrapper around `trianglesd` RPC for humans and agents.
+
+## Install
+
+```bash
+# System-wide
+sudo cp tri /usr/local/bin/tri
+sudo chmod +x /usr/local/bin/tri
+sudo mkdir -p /etc/tri
+sudo cp nodes.conf.example /etc/tri/nodes.conf
+# Edit /etc/tri/nodes.conf with your node's RPC credentials
+
+# Bash completion
+sudo cp tri-completion.bash /etc/bash_completion.d/
+
+# Zsh completion
+sudo cp _tri_zsh_completion /usr/local/share/zsh/site-functions/_tri
+```
+
+## Config
+
+Edit `/etc/tri/nodes.conf`:
+
+```bash
+TRI_SSH_HOST="100.81.59.99"       # Node IP (or remove for local)
+TRI_SSH_USER="root"
+TRI_RPC_PORT="19112"
+TRI_RPC_USER="your-rpc-user"
+TRI_RPC_PASS="your-rpc-password"
+# TRI_WALLET_PASSPHRASE="wallet-passphrase"  # If wallet is encrypted
+```
+
+## Commands
+
+### Info
+- `tri` — Status overview
+- `tri status` — Detailed node status
+- `tri balance` — Wallet balance + UTXO count
+- `tri peers` — Connected peers
+- `tri stake` — Staking info
+
+### Wallet
+- `tri address new` — New address
+- `tri address list` — List addresses
+- `tri address balance` — Per-address balances
+- `tri send <addr> <amt> [memo]` — Send TRI
+- `tri tx [N]` — Recent transactions
+- `tri tx <txid>` — Transaction details
+
+### Secure Messaging
+- `tri msg inbox` — Read messages
+- `tri msg outbox` — Sent messages
+- `tri msg send <from> <to> <msg>` — Send encrypted message
+- `tri msg anon <to> <msg>` — Anonymous message
+- `tri msg keys` — Messaging keys
+- `tri msg enable` — Enable secure messaging
+- `tri msg pubkey <addr>` — Get public key
+
+### Advanced
+- `tri raw <method> [params...]` — Raw RPC passthrough
+
+## Agent Integration (Hermes, Krystie)
+
+Both agents on DNS2 share the same `/etc/tri/nodes.conf` and can execute all commands.
+For inter-agent messaging via TRI's encrypted P2P network:
+
+1. Each agent needs a TRI address: `tri address new`
+2. Enable messaging: `tri msg enable`
+3. Register key: `tri raw smsglocalkeys recv + <address>`
+4. Exchange addresses between agents
+5. Send: `tri msg send <hermes_addr> <krystie_addr> "message"`
+6. Read: `tri msg inbox`
+
+Messages are encrypted (ECDH), routed through the Tor P2P network,
+stored for 48 hours, max 4096 bytes each.

scripts/tri/_tri_zsh_completion

@@ -0,0 +1,39 @@
+#compdef tri
+
+_tri() {
+    local -a commands
+    commands=(
+        'status:Detailed node status'
+        'balance:Wallet balance'
+        'peers:Connected peers'
+        'stake:Staking info'
+        'address:Address management'
+        'send:Send TRI'
+        'tx:Transactions'
+        'msg:Secure messaging'
+        'raw:Raw RPC passthrough'
+        'help:Show help'
+    )
+    
+    _arguments -C \
+        "1:command:->command" \
+        "*::arg:->args"
+    
+    case "$state" in
+        command)
+            _describe 'tri command' commands
+            ;;
+        args)
+            case ${words[1]} in
+                address|addr)
+                    _values 'subcommand' 'new' 'list' 'balance'
+                    ;;
+                msg|message|messages)
+                    _values 'subcommand' 'inbox' 'outbox' 'send' 'anon' 'keys' 'enable' 'pubkey' 'unlock'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_tri "$@"

scripts/tri/nodes.conf.example

@@ -0,0 +1,32 @@
+# /etc/tri/nodes.conf — Triangles node configuration
+#
+# Shared by Hermes and Krystie. Both agents on DNS2 tunnel RPC
+# to the trianglesd node on DNS3 via SSH.
+#
+# Node: DNS3 (100.81.59.99)
+
+# ─── Connection ──────────────────────────────────────────────────────────────
+
+# RPC is only accessible on localhost at the node, so we SSH-tunnel
+TRI_SSH_HOST="your-node-ip-here"
+TRI_SSH_USER="root"
+
+# RPC credentials (as set in triangles.conf on the node)
+TRI_RPC_HOST="127.0.0.1"
+TRI_RPC_PORT="19112"
+TRI_RPC_USER="your-rpc-user-here"
+TRI_RPC_PASS="your-rpc-password-here"
+
+# ─── Wallet ──────────────────────────────────────────────────────────────────
+
+# Wallet passphrase for unlocking (needed for messaging + sending)
+# Leave empty if wallet is unencrypted or set via env var TRI_WALLET_PASSPHRASE
+# TRI_WALLET_PASSPHRASE=""
+
+# Default sender address for messages (set after creating addresses)
+# TRI_DEFAULT_FROM=""
+
+# ─── Agent Addresses ─────────────────────────────────────────────────────────
+# When agents have their own TRI addresses, register them here:
+# HERMES_TRI_ADDR="T..."
+# KRYSTIE_TRI_ADDR="T..."

scripts/tri/tri

@@ -0,0 +1,691 @@
+#!/usr/bin/env bash
+#
+# tri — Cryptographic Triangles command interface
+#
+# A friendly wrapper around trianglesd RPC for both human and agent use.
+# Designed for Hermes, Krystie, and Sami to manage TRI wallets, monitor
+# nodes, and communicate via the built-in secure messaging system.
+#
+# Config: /etc/tri/nodes.conf (or ~/.config/tri/nodes.conf)
+# Completion: /etc/bash_completion.d/tri-completion.bash
+#
+# Usage: tri <command> [subcommand] [args]
+#   tri                    Status overview
+#   tri help               Full command list
+#   tri status             Detailed node status
+#   tri balance            Wallet balance
+#   tri peers              Connected peers
+#   tri stake              Staking info
+#   tri address new        Generate new wallet address
+#   tri address list       List wallet addresses
+#   tri address balance    Per-address balances
+#   tri send <addr> <amt> [memo]   Send TRI
+#   tri tx [N]             Recent N transactions (default 10)
+#   tri tx <txid>          Transaction details
+#   tri msg inbox          Secure message inbox
+#   tri msg outbox         Sent messages
+#   tri msg send <from> <to> <msg>   Send encrypted message
+#   tri msg anon <to> <msg>          Send anonymous message
+#   tri msg keys           List messaging keys
+#   tri msg enable         Enable secure messaging
+#   tri msg pubkey <addr>  Get public key for address
+#   tri msg unlock [secs]  Unlock wallet for messaging (default 60s)
+#   tri raw <method> [params...]  Raw RPC passthrough
+#
+
+set -euo pipefail
+
+# ─── Config ──────────────────────────────────────────────────────────────────
+
+TRI_CONFIG="/etc/tri/nodes.conf"
+[[ -f "$HOME/.config/tri/nodes.conf" ]] && TRI_CONFIG="$HOME/.config/tri/nodes.conf"
+
+# Defaults (overridden by config file)
+TRI_RPC_HOST="127.0.0.1"
+TRI_RPC_PORT="19112"
+TRI_RPC_USER=""
+TRI_RPC_PASS=""
+TRI_SSH_HOST=""        # If set, RPC calls are tunneled via SSH to this host
+TRI_SSH_USER="root"
+TRI_WALLET_PASSPHRASE=""  # For unlocking wallet when sending/messages
+TRI_DEFAULT_FROM=""    # Default sender address for messages
+
+# Load config
+if [[ -f "$TRI_CONFIG" ]]; then
+    source "$TRI_CONFIG"
+fi
+
+# Allow env overrides
+[[ -n "${TRI_RPC_HOST_ENV:-}" ]] && TRI_RPC_HOST="$TRI_RPC_HOST_ENV"
+[[ -n "${TRI_RPC_PORT_ENV:-}" ]] && TRI_RPC_PORT="$TRI_RPC_PORT_ENV"
+[[ -n "${TRI_SSH_HOST_ENV:-}" ]] && TRI_SSH_HOST="$TRI_SSH_HOST_ENV"
+
+# ─── Colors ──────────────────────────────────────────────────────────────────
+
+if [[ -t 1 ]]; then
+    C_RESET="\033[0m"
+    C_BOLD="\033[1m"
+    C_DIM="\033[2m"
+    C_RED="\033[31m"
+    C_GREEN="\033[32m"
+    C_YELLOW="\033[33m"
+    C_BLUE="\033[34m"
+    C_CYAN="\033[36m"
+    C_MAGENTA="\033[35m"
+else
+    C_RESET=""; C_BOLD=""; C_DIM=""; C_RED=""; C_GREEN=""; C_YELLOW=""
+    C_BLUE=""; C_CYAN=""; C_MAGENTA=""
+fi
+
+# ─── Helpers ─────────────────────────────────────────────────────────────────
+
+# Core RPC call function. Executes JSON-RPC against the node.
+# Usage: _tri_rpc <method> [param1] [param2] ...
+_tri_rpc() {
+    local method="$1"; shift
+    local params="[]"
+    
+    if [[ $# -gt 0 ]]; then
+        # Build JSON params array
+        local json_params=()
+        for p in "$@"; do
+            # Try to detect numbers and booleans
+            if [[ "$p" =~ ^-?[0-9]+\.?[0-9]*$ ]]; then
+                json_params+=("$p")
+            elif [[ "$p" == "true" || "$p" == "false" || "$p" == "null" ]]; then
+                json_params+=("\"$p\"")
+            else
+                # Escape for JSON string
+                local escaped="${p//\\/\\\\}"
+                escaped="${escaped//\"/\\\"}"
+                json_params+=("\"$escaped\"")
+            fi
+        done
+        params="[$(IFS=,; echo "${json_params[*]}")]"
+    fi
+    
+    local payload="{\"jsonrpc\":\"1.0\",\"id\":\"tri\",\"method\":\"$method\",\"params\":$params}"
+    
+    if [[ -n "$TRI_SSH_HOST" ]]; then
+        # Tunnel via SSH
+        local auth="$TRI_RPC_USER:$TRI_RPC_PASS"
+        ssh -o ConnectTimeout=10 -o StrictHostKeyChecking=no \
+            "${TRI_SSH_USER}@${TRI_SSH_HOST}" \
+            "curl -s --connect-timeout 10 http://127.0.0.1:${TRI_RPC_PORT}/ \
+             -u '${auth}' \
+             -H 'Content-Type: application/json' \
+             -d '${payload//\'/\'\\\'\'}'" 2>/dev/null
+    else
+        # Local connection
+        curl -s --connect-timeout 10 "http://${TRI_RPC_HOST}:${TRI_RPC_PORT}/" \
+             -u "${TRI_RPC_USER}:${TRI_RPC_PASS}" \
+             -H 'Content-Type: application/json' \
+             -d "$payload" 2>/dev/null
+    fi
+}
+
+# Pretty RPC call — extracts .result and pretty-prints JSON
+# Usage: _tri_rpc_pretty <method> [param1] [param2] ...
+_tri_rpc_pretty() {
+    local raw
+    raw=$(_tri_rpc "$@")
+    
+    if [[ -z "$raw" ]]; then
+        echo -e "${C_RED}Error: No response from node${C_RESET}" >&2
+        return 1
+    fi
+    
+    # Check for error
+    local err
+    err=$(echo "$raw" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('error',{}).get('message','') if d.get('error') else '',end='')" 2>/dev/null || echo "")
+    if [[ -n "$err" ]]; then
+        echo -e "${C_RED}RPC Error: ${err}${C_RESET}" >&2
+        return 1
+    fi
+    
+    echo "$raw" | python3 -c "import sys,json; print(json.dumps(json.load(sys.stdin).get('result',''),indent=2))" 2>/dev/null
+}
+
+# Raw RPC call — print full JSON response as-is
+_tri_rpc_raw() {
+    _tri_rpc "$@"
+}
+
+# Extract a single field from RPC result
+# Usage: _tri_rpc_field <method> <field> [params...]
+_tri_rpc_field() {
+    local method="$1"; shift
+    local field="$1"; shift
+    _tri_rpc "$method" "$@" | python3 -c "
+import sys,json
+d=json.load(sys.stdin)
+r=d.get('result',{})
+if isinstance(r,dict):
+    print(r.get('$field',''))
+else:
+    print(r)
+" 2>/dev/null
+}
+
+# Extract multiple fields
+_tri_rpc_fields() {
+    local method="$1"; shift
+    _tri_rpc "$method" "$@" | python3 -c "
+import sys,json
+d=json.load(sys.stdin)
+r=d.get('result',{})
+if isinstance(r, dict):
+    for k,v in r.items():
+        if isinstance(v,(str,int,float,bool)) or v is None:
+            print(f'{k}: {v}')
+" 2>/dev/null
+}
+
+# Unlock wallet for messaging
+_tri_unlock() {
+    local duration="${1:-60}"
+    if [[ -z "$TRI_WALLET_PASSPHRASE" ]]; then
+        echo -e "${C_YELLOW}Warning: TRI_WALLET_PASSPHRASE not set in config${C_RESET}" >&2
+        return 1
+    fi
+    _tri_rpc walletpassphrase "$TRI_WALLET_PASSPHRASE" "$duration" >/dev/null 2>&1
+}
+
+# ─── Commands: Info ──────────────────────────────────────────────────────────
+
+cmd_status() {
+    echo -e "${C_BOLD}${C_CYAN}Triangles Node Status${C_RESET}"
+    echo -e "${C_DIM}$(date -u '+%Y-%m-%d %H:%M:%S UTC')${C_RESET}"
+    echo ""
+    
+    local info
+    info=$(_tri_rpc getinfo 2>/dev/null)
+    
+    if [[ -z "$info" ]]; then
+        echo -e "${C_RED}Cannot connect to node${C_RESET}"
+        if [[ -n "$TRI_SSH_HOST" ]]; then
+            echo -e "  Target: ${TRI_SSH_USER}@${TRI_SSH_HOST} → RPC ${TRI_RPC_PORT}"
+        else
+            echo -e "  Target: ${TRI_RPC_HOST}:${TRI_RPC_PORT}"
+        fi
+        return 1
+    fi
+    
+    echo "$info" | python3 -c "
+import sys,json
+d=json.load(sys.stdin)['result']
+print(f\"  Version:      {d.get('version','?')}\")
+print(f\"  Blocks:       {d.get('blocks','?'):,}\")
+print(f\"  Connections:  {d.get('connections','?')}\")
+print(f\"  Balance:      {d.get('balance',0):.4f} TRI\")
+print(f\"  Stake:        {d.get('stake',0):.4f} TRI\")
+print(f\"  Money Supply: {d.get('moneysupply',0):,.2f} TRI\")
+print(f\"  Difficulty:   {d.get('difficulty','?')}\")
+print(f\"  Testnet:      {d.get('testnet',False)}\")
+" 2>/dev/null
+    
+    # Peer summary
+    local peer_count
+    peer_count=$(_tri_rpc_field getconnectioncount "result" 2>/dev/null || echo "?")
+    echo ""
+    echo -e "  ${C_DIM}Node: ${TRI_SSH_HOST:-${TRI_RPC_HOST}}:${TRI_RPC_PORT}${C_RESET}"
+}
+
+cmd_balance() {
+    local balance
+    balance=$(_tri_rpc_field getbalance "balance" 2>/dev/null || echo "error")
+    
+    if [[ "$balance" == "error" ]]; then
+        echo -e "${C_RED}Cannot connect to node${C_RESET}" >&2
+        return 1
+    fi
+    
+    local stake
+    stake=$(_tri_rpc_field getinfo "stake" 2>/dev/null || echo "0")
+    
+    echo -e "${C_BOLD}Wallet Balance${C_RESET}"
+    echo -e "  Available: ${C_GREEN}${balance} TRI${C_RESET}"
+    echo -e "  Staking:   ${C_YELLOW}${stake} TRI${C_RESET}"
+    
+    # UTXO count
+    local utxo_count
+    utxo_count=$(_tri_rpc listunspent 2>/dev/null | python3 -c "import sys,json; print(len(json.load(sys.stdin).get('result',[])))" 2>/dev/null || echo "?")
+    [[ "$utxo_count" != "?" ]] && echo -e "  UTXOs:     ${utxo_count}"
+}
+
+cmd_peers() {
+    local raw
+    raw=$(_tri_rpc getpeerinfo 2>/dev/null)
+    
+    echo -e "${C_BOLD}Connected Peers${C_RESET}"
+    echo "$raw" | python3 -c "
+import sys,json
+d=json.load(sys.stdin)
+peers=d.get('result',[])
+if not peers:
+    print('  (no peers connected)')
+else:
+    for p in peers:
+        addr = p.get('addr','?')
+        subver = p.get('subver','?').replace('/','')
+        height = p.get('startingheight','?')
+        ping = p.get('pingtime',0)
+        if isinstance(ping,(int,float)) and ping > 0:
+            ping_ms = ping * 1000
+            print(f'  {addr:30s} {subver:25s} height={height}  ping={ping_ms:.0f}ms')
+        else:
+            print(f'  {addr:30s} {subver:25s} height={height}')
+    print(f'\n  Total: {len(peers)} peer(s)')
+" 2>/dev/null
+}
+
+cmd_stake() {
+    echo -e "${C_BOLD}Staking Information${C_RESET}"
+    _tri_rpc_fields getstakinginfo 2>/dev/null | while read -r line; do
+        echo "  $line"
+    done
+}
+
+# ─── Commands: Wallet ────────────────────────────────────────────────────────
+
+cmd_address() {
+    local sub="${1:-list}"; shift || true
+    
+    case "$sub" in
+        new)
+            local addr
+            addr=$(_tri_rpc_field getnewaddress "result" 2>/dev/null)
+            if [[ -n "$addr" ]]; then
+                echo "$addr"
+            else
+                echo -e "${C_RED}Failed to generate address${C_RESET}" >&2
+                return 1
+            fi
+            ;;
+        list)
+            echo -e "${C_BOLD}Wallet Addresses${C_RESET}"
+            _tri_rpc getaddressesbyaccount "" 2>/dev/null | python3 -c "
+import sys,json
+d=json.load(sys.stdin)
+addrs=d.get('result',[])
+if not addrs:
+    print('  (no addresses)')
+else:
+    for a in addrs:
+        print(f'  {a}')
+    print(f'\n  Total: {len(addrs)}')
+" 2>/dev/null
+            ;;
+        balance)
+            echo -e "${C_BOLD}Address Balances${C_RESET}"
+            _tri_rpc listaddressgroupings 2>/dev/null | python3 -c "
+import sys,json
+d=json.load(sys.stdin)
+groups=d.get('result',[])
+if not groups:
+    print('  (no address balances)')
+else:
+    for group in groups:
+        for item in group:
+            addr=item[0] if isinstance(item,list) and len(item)>0 else '?'
+            amt=item[1] if isinstance(item,list) and len(item)>1 else '?'
+            print(f'  {addr:40s} {amt} TRI')
+" 2>/dev/null
+            ;;
+        *)
+            echo -e "${C_RED}Unknown subcommand: $sub${C_RESET}" >&2
+            echo "Usage: tri address [new|list|balance]" >&2
+            return 1
+            ;;
+    esac
+}
+
+cmd_send() {
+    if [[ $# -lt 2 ]]; then
+        echo -e "${C_RED}Usage: tri send <address> <amount> [memo]${C_RESET}" >&2
+        return 1
+    fi
+    
+    local addr="$1"
+    local amount="$2"
+    local memo="${3:-}"
+    
+    echo -e "${C_YELLOW}Sending ${amount} TRI to ${addr}...${C_RESET}"
+    
+    local result
+    if [[ -n "$memo" ]]; then
+        result=$(_tri_rpc sendtoaddress "$addr" "$amount" "$memo" 2>/dev/null)
+    else
+        result=$(_tri_rpc sendtoaddress "$addr" "$amount" 2>/dev/null)
+    fi
+    
+    local txid
+    txid=$(echo "$result" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('result','') if d.get('result') else d.get('error',{}).get('message','FAILED'),end='')" 2>/dev/null)
+    
+    if [[ "$txid" == "FAILED" ]] || [[ -z "$txid" ]]; then
+        echo -e "${C_RED}Send failed: $txid${C_RESET}" >&2
+        return 1
+    fi
+    
+    echo -e "${C_GREEN}Sent! TXID: ${txid}${C_RESET}"
+}
+
+cmd_tx() {
+    if [[ $# -eq 0 ]]; then
+        # Recent transactions
+        echo -e "${C_BOLD}Recent Transactions${C_RESET}"
+        _tri_rpc listtransactions "*" 10 2>/dev/null | python3 -c "
+import sys,json
+d=json.load(sys.stdin)
+txs=d.get('result',[])
+if not txs:
+    print('  (no transactions)')
+else:
+    for t in reversed(txs):
+        category = t.get('category','?')
+        amount = t.get('amount',0)
+        addr = t.get('address','?')
+        confirmations = t.get('confirmations',0)
+        txid = t.get('txid','?')
+        time = t.get('time',0)
+        
+        from datetime import datetime
+        dt = datetime.fromtimestamp(time) if time else None
+        datestr = dt.strftime('%Y-%m-%d %H:%M') if dt else '???'
+        
+        # Color by category
+        if category == 'receive' or category == 'generate' or category == 'mint':
+            amt_str = f'+{amount} TRI'
+        else:
+            amt_str = f'-{amount} TRI'
+        
+        conf_str = f'{confirmations} conf' if confirmations > 0 else 'unconfirmed'
+        print(f'  {datestr}  {amt_str:>15s}  {category:10s}  {conf_str:>12s}  {addr}')
+        print(f'           {txid}')
+" 2>/dev/null
+    else
+        # Transaction details
+        local txid="$1"
+        echo -e "${C_BOLD}Transaction: ${txid}${C_RESET}"
+        _tri_rpc_fields gettransaction "$txid" 2>/dev/null | while read -r line; do
+            echo "  $line"
+        done
+    fi
+}
+
+# ─── Commands: Secure Messaging ──────────────────────────────────────────────
+
+cmd_msg() {
+    local sub="${1:-inbox}"; shift || true
+    
+    case "$sub" in
+        inbox)
+            # Unlock wallet first if passphrase is configured
+            if [[ -n "$TRI_WALLET_PASSPHRASE" ]]; then
+                _tri_unlock 60 2>/dev/null || true
+            fi
+            
+            echo -e "${C_BOLD}${C_MAGENTA}Secure Message Inbox${C_RESET}"
+            _tri_rpc smsginbox "all" 2>/dev/null | python3 -c "
+import sys,json
+raw=json.load(sys.stdin)
+d=raw.get('result',{})
+msg = d.get('message')
+count_str = d.get('result','0 messages shown.')
+# Extract count from result string like 'N messages shown.'
+try:
+    count = int(count_str.split()[0])
+except:
+    count = 0
+
+if count == 0 or msg is None:
+    print('  (inbox is empty)')
+else:
+    # The daemon returns one message per RPC call (last one only).
+    # For full inbox dump, use: tri raw smsginbox all
+    frm = msg.get('from','?')
+    to = msg.get('to','?')
+    text = msg.get('text','(no text)')
+    sent = msg.get('sent','')
+    rcvd = msg.get('received','')
+    print(f'  Latest message (of {count}):')
+    print(f'    Sent:     {sent}')
+    print(f'    Received: {rcvd}')
+    print(f'    From: {frm}')
+    print(f'    To:   {to}')
+    print(f'    Text: {text[:200]}')
+    if count > 1:
+        print(f'')
+        print(f'    ({count-1} more messages — use: tri raw smsginbox all)')
+" 2>/dev/null
+            ;;
+            
+        outbox)
+            if [[ -n "$TRI_WALLET_PASSPHRASE" ]]; then
+                _tri_unlock 60 2>/dev/null || true
+            fi
+            
+            echo -e "${C_BOLD}${C_MAGENTA}Sent Messages${C_RESET}"
+            _tri_rpc smsgoutbox "all" 2>/dev/null | python3 -c "
+import sys,json
+raw=json.load(sys.stdin)
+d=raw.get('result',{})
+msg = d.get('message')
+count_str = d.get('result','0 sent messages shown.')
+try:
+    count = int(count_str.split()[0])
+except:
+    count = 0
+
+if count == 0 or msg is None:
+    print('  (outbox is empty)')
+else:
+    to = msg.get('to','?')
+    frm = msg.get('from','?')
+    text = msg.get('text','(no text)')
+    sent = msg.get('sent','')
+    print(f'  Latest sent (of {count}):')
+    print(f'    Sent: {sent}')
+    print(f'    From: {frm}')
+    print(f'    To:   {to}')
+    print(f'    Text: {text[:200]}')
+    if count > 1:
+        print(f'')
+        print(f'    ({count-1} more — use: tri raw smsgoutbox all)')
+" 2>/dev/null
+            ;;
+            
+        send)
+            if [[ $# -lt 3 ]]; then
+                echo -e "${C_RED}Usage: tri msg send <from_address> <to_address> <message>${C_RESET}" >&2
+                return 1
+            fi
+            
+            local from_addr="$1"
+            local to_addr="$2"
+            shift 2
+            local message="$*"
+            
+            # Unlock for send
+            if [[ -n "$TRI_WALLET_PASSPHRASE" ]]; then
+                _tri_unlock 60 2>/dev/null || true
+            fi
+            
+            echo -e "${C_YELLOW}Sending encrypted message...${C_RESET}"
+            local result
+            result=$(_tri_rpc smsgsend "$from_addr" "$to_addr" "$message" 2>/dev/null)
+            
+            local status
+            status=$(echo "$result" | python3 -c "import sys,json; d=json.load(sys.stdin); r=d.get('result',{}); print(r.get('result','') if isinstance(r,dict) else str(r),end='')" 2>/dev/null)
+            
+            if [[ "$status" == "Sent." ]]; then
+                echo -e "${C_GREEN}Message sent to ${to_addr}${C_RESET}"
+            else
+                local err
+                err=$(echo "$result" | python3 -c "import sys,json; d=json.load(sys.stdin); r=d.get('result',{}); print(r.get('error','unknown error') if isinstance(r,dict) else str(r),end='')" 2>/dev/null)
+                echo -e "${C_RED}Send failed: ${err}${C_RESET}" >&2
+                return 1
+            fi
+            ;;
+            
+        anon)
+            if [[ $# -lt 2 ]]; then
+                echo -e "${C_RED}Usage: tri msg anon <to_address> <message>${C_RESET}" >&2
+                return 1
+            fi
+            
+            local to_addr="$1"
+            shift
+            local message="$*"
+            
+            echo -e "${C_YELLOW}Sending anonymous encrypted message...${C_RESET}"
+            local result
+            result=$(_tri_rpc smsgsendanon "$to_addr" "$message" 2>/dev/null)
+            
+            local status
+            status=$(echo "$result" | python3 -c "import sys,json; d=json.load(sys.stdin); r=d.get('result',{}); print(r.get('result','') if isinstance(r,dict) else str(r),end='')" 2>/dev/null)
+            
+            if [[ "$status" == "Sent." ]]; then
+                echo -e "${C_GREEN}Anonymous message sent to ${to_addr}${C_RESET}"
+            else
+                echo -e "${C_RED}Send failed${C_RESET}" >&2
+                return 1
+            fi
+            ;;
+            
+        keys)
+            echo -e "${C_BOLD}${C_MAGENTA}Messaging Keys${C_RESET}"
+            _tri_rpc smsglocalkeys "all" 2>/dev/null | python3 -c "
+import sys,json
+raw=json.load(sys.stdin)
+d=raw.get('result',{})
+if isinstance(d, dict):
+    key_line = d.get('key','')
+    count_line = d.get('result','')
+    if key_line:
+        print(f'  {key_line}')
+    if count_line:
+        print(f'  {count_line}')
+elif isinstance(d, str):
+    print(f'  {d}')
+else:
+    print('  (no keys registered)')
+" 2>/dev/null
+            ;;
+            
+        enable)
+            echo -e "${C_YELLOW}Enabling secure messaging...${C_RESET}"
+            _tri_rpc_pretty smsgenable 2>/dev/null
+            ;;
+            
+        pubkey)
+            if [[ $# -lt 1 ]]; then
+                echo -e "${C_RED}Usage: tri msg pubkey <address>${C_RESET}" >&2
+                return 1
+            fi
+            _tri_rpc_pretty smsggetpubkey "$1" 2>/dev/null
+            ;;
+            
+        unlock)
+            local duration="${1:-60}"
+            if [[ -z "$TRI_WALLET_PASSPHRASE" ]]; then
+                echo -e "${C_RED}TRI_WALLET_PASSPHRASE not set in config${C_RESET}" >&2
+                return 1
+            fi
+            _tri_rpc walletpassphrase "$TRI_WALLET_PASSPHRASE" "$duration" >/dev/null 2>&1
+            echo -e "${C_GREEN}Wallet unlocked for ${duration}s${C_RESET}"
+            ;;
+            
+        *)
+            echo -e "${C_RED}Unknown msg subcommand: $sub${C_RESET}" >&2
+            echo "Usage: tri msg [inbox|outbox|send|anon|keys|enable|pubkey|unlock]" >&2
+            return 1
+            ;;
+    esac
+}
+
+# ─── Commands: Raw RPC ───────────────────────────────────────────────────────
+
+cmd_raw() {
+    if [[ $# -eq 0 ]]; then
+        echo -e "${C_RED}Usage: tri raw <method> [params...]${C_RESET}" >&2
+        echo "Example: tri raw getblockhash 2200000" >&2
+        return 1
+    fi
+    
+    _tri_rpc_pretty "$@"
+}
+
+# ─── Help ────────────────────────────────────────────────────────────────────
+
+cmd_help() {
+    cat << 'EOF'
+
+ tri — Cryptographic Triangles Command Interface
+
+ INFO
+   tri                       Status overview (blocks, connections, balance)
+   tri status                Detailed node status
+   tri balance               Wallet balance + UTXO count
+   tri peers                 Connected peers with ping times
+   tri stake                 Staking information
+
+ WALLET
+   tri address new           Generate new wallet address
+   tri address list          List all wallet addresses
+   tri address balance       Per-address balance breakdown
+   tri send <addr> <amt> [memo]   Send TRI to address
+   tri tx [N]                Recent N transactions (default 10)
+   tri tx <txid>             Transaction details
+
+ SECURE MESSAGING
+   tri msg inbox             Read inbox messages (wallet auto-unlocks)
+   tri msg outbox            Read sent messages
+   tri msg send <from> <to> <msg>   Send encrypted message
+   tri msg anon <to> <msg>          Send anonymous message
+   tri msg keys              List messaging keys
+   tri msg enable            Enable secure messaging
+   tri msg pubkey <addr>     Get public key for an address
+   tri msg unlock [secs]     Unlock wallet for messaging (default 60s)
+
+ ADVANCED
+   tri raw <method> [params...]    Raw RPC passthrough
+   tri help                  This help screen
+
+ CONFIG
+   /etc/tri/nodes.conf              System-wide config
+   ~/.config/tri/nodes.conf         Per-user config override
+
+ AGENTS (Hermes, Krystie)
+   Both agents use the same config and can execute all commands.
+   For messaging between agents, each needs its own TRI address
+   registered in the wallet. Use 'tri msg keys' to verify.
+
+EOF
+}
+
+# ─── Main ────────────────────────────────────────────────────────────────────
+
+main() {
+    local cmd="${1:-status}"; shift || true
+    
+    case "$cmd" in
+        status|info)    cmd_status "$@" ;;
+        balance)        cmd_balance "$@" ;;
+        peers)          cmd_peers "$@" ;;
+        stake|staking)  cmd_stake "$@" ;;
+        address|addr)   cmd_address "$@" ;;
+        send)           cmd_send "$@" ;;
+        tx|transactions) cmd_tx "$@" ;;
+        msg|message|messages) cmd_msg "$@" ;;
+        raw)            cmd_raw "$@" ;;
+        help|-h|--help) cmd_help "$@" ;;
+        *)
+            echo -e "${C_RED}Unknown command: $cmd${C_RESET}" >&2
+            echo "Run 'tri help' for available commands" >&2
+            exit 1
+            ;;
+    esac
+}
+
+main "$@"

scripts/tri/tri-completion.bash

@@ -0,0 +1,40 @@
+# bash/zsh completion for tri command
+# Install: source this file or place in /etc/bash_completion.d/
+
+_tri_complete() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    
+    # Top-level commands
+    local top_cmds="status balance peers stake address send tx msg raw help"
+    local addr_subcmds="new list balance"
+    local msg_subcmds="inbox outbox send anon keys enable pubkey unlock"
+    
+    if [[ ${COMP_CWORD} -eq 1 ]]; then
+        COMPREPLY=($(compgen -W "${top_cmds}" -- "${cur}"))
+        return 0
+    fi
+    
+    # Subcommand completion
+    if [[ ${COMP_CWORD} -eq 2 ]]; then
+        case "${COMP_WORDS[1]}" in
+            address|addr)
+                COMPREPLY=($(compgen -W "${addr_subcmds}" -- "${cur}"))
+                return 0
+                ;;
+            msg|message|messages)
+                COMPREPLY=($(compgen -W "${msg_subcmds}" -- "${cur}"))
+                return 0
+                ;;
+        esac
+    fi
+    
+    # Address completion for send/msg send (would need wallet addresses in practice)
+    # For now, no further completion
+    
+    return 0
+}
+
+complete -F _tri_complete tri

scripts/validate_onion_seeds.py

@@ -0,0 +1,391 @@
+#!/usr/bin/env python3
+"""
+validate_onion_seeds.py - Cryptographic Triangles v3 onion address validator
+
+Validates every .onion address in a triangles.conf (or any text file) against
+the v3 hidden service checksum algorithm:
+
+    v3 onion = base32( version[2] || pubkey[32] || checksum[2] )
+    where checksum = SHA3-256( ".onion checksum" || version || pubkey )[:2]
+    and version   = 0x03 0x00
+
+A corrupted v3 onion (e.g. one character transposed) will have a valid base32
+shape but a failing checksum. Tor rejects these with:
+
+    [warn] ed25519 validation failed
+    [warn] Service address has bad pubkey
+    [warn] Invalid onion hostname; rejecting
+    [notice] ... resolve failed. No more HSDir available to query.
+
+This tool is designed to be run as a pre-flight check before deploying
+a triangles.conf, and as a CI gate to prevent corrupted .onion addresses
+from ever reaching production. It can also be used to audit an existing
+config for inconsistencies against the hardcoded seed list in
+src/onionseed.h.
+
+USAGE
+    # Validate the production config
+    ./validate_onion_seeds.py /root/.triangles/triangles.conf
+
+    # Validate multiple configs
+    ./validate_onion_seeds.py /root/.triangles/triangles.conf \\
+                              /root/.triangles-synctest/triangles.conf
+
+    # Audit a config against the hardcoded source-of-truth
+    ./validate_onion_seeds.py /root/.triangles/triangles.conf \\
+                              --against /root/triangles_v5/src/onionseed.h
+
+    # CI mode (exit 1 on any error)
+    ./validate_onion_seeds.py /root/.triangles/triangles.conf --ci
+
+EXIT CODES
+    0  all addresses valid, no warnings
+    1  one or more addresses failed validation
+    2  usage error / file not found
+
+DETECTION CAPABILITIES
+    * Bad v3 checksum (1-2 char transposition, missing char, etc.)
+    * Truncated or extended .onion addresses
+    * Non-base32 characters in .onion
+    * Cross-config diff (or test vs production mismatch)
+    * addnode referencing a .onion that's not in the source seed list
+
+BACKGROUND
+    During a from-zero sync test on 2026-06-21, the test daemon's Tor log
+    produced 4,842 "No more HSDir available" errors and 181 "ed25519
+    validation failed" warnings. Root cause: a 1-character transposition
+    (btb6 vs gtb6) in the test config's vmepp seed address. This tool
+    would have caught it in 0.1 seconds.
+"""
+
+import argparse
+import base64
+import hashlib
+import os
+import re
+import sys
+from pathlib import Path
+
+# v3 onion constants
+V3_VERSION = b'\x03\x00'  # 2 bytes
+V3_CHECKSUM_INPUT = b'.onion checksum'  # 15 bytes
+V3_PUBKEY_LENGTH = 32
+V3_CHECKSUM_LENGTH = 2
+V3_DECODED_LENGTH = 35  # 2 + 32 + 2 + ...wait that's 36
+# Actually v3 onion base32-decodes to 35 bytes:
+#   1 byte version (0x03) + 1 byte checksum-type (0x00) +
+#   32 bytes pubkey + 2 bytes checksum  -- no wait
+# Per official spec: onion_address = base32(pubkey || checksum || version)
+# Total = 32 (ed25519) + 2 (checksum) + 1 (version) = 35 bytes
+# But some implementations use:
+#   version(2) || pubkey(32) || checksum(2) = 36
+# The actual spec from rfc7686 says:
+#   onion_address = base32(PUBKEY || CHECKSUM || VERSION)
+#   PUBKEY = ed25519 public key (32 bytes)
+#   CHECKSUM = H(".onion checksum" || PUBKEY || VERSION)[:2]
+#   VERSION = 0x03
+# So total = 32 + 2 + 1 = 35 bytes (not 36)
+
+# We'll use the official spec (35 bytes)
+
+# ANSI color codes (only if stdout is a TTY)
+class C:
+    RESET = '\033[0m'
+    RED = '\033[91m'
+    GREEN = '\033[92m'
+    YELLOW = '\033[93m'
+    BLUE = '\033[94m'
+    BOLD = '\033[1m'
+    DIM = '\033[2m'
+
+    @classmethod
+    def disable(cls):
+        for attr in dir(cls):
+            if attr.isupper() and not attr.startswith('_'):
+                setattr(cls, attr, '')
+
+
+def decode_v3_onion(address: str) -> tuple[bool, str, bytes | None]:
+    """
+    Validate a v3 onion address.
+
+    Returns:
+        (valid, reason, decoded_bytes_or_None)
+    """
+    if not isinstance(address, str):
+        return False, f"not a string (got {type(address).__name__})", None
+    if not address.endswith('.onion'):
+        return False, "missing .onion suffix", None
+
+    onion_body = address[:-6]  # strip .onion
+    expected_len = 56  # base32(35 bytes) = 56 chars
+    if len(onion_body) != expected_len:
+        return False, f"wrong length: {len(onion_body)} chars (expected {expected_len})", None
+
+    # Validate base32 alphabet
+    if not re.match(r'^[a-z2-7]+$', onion_body):
+        # Find first bad char
+        for i, c in enumerate(onion_body):
+            if not re.match(r'[a-z2-7]', c):
+                return False, f"non-base32 char '{c}' at position {i}", None
+
+    # Decode
+    try:
+        # Add padding
+        padding_needed = (8 - len(onion_body) % 8) % 8
+        decoded = base64.b32decode(onion_body.upper() + '=' * padding_needed)
+    except Exception as e:
+        return False, f"base32 decode failed: {e}", None
+
+    if len(decoded) != 35:
+        return False, f"decoded to {len(decoded)} bytes, expected 35", None
+
+    # v3 spec: PUBKEY(32) || CHECKSUM(2) || VERSION(1)
+    pubkey = decoded[0:32]
+    checksum = decoded[32:34]
+    version = decoded[34:35]
+
+    if version != b'\x03':
+        return False, f"version byte is 0x{version[0]:02x}, expected 0x03", decoded
+
+    # Compute expected checksum
+    expected_checksum = hashlib.sha3_256(
+        V3_CHECKSUM_INPUT + pubkey + version
+    ).digest()[:2]
+
+    if checksum != expected_checksum:
+        return False, (
+            f"checksum mismatch: got 0x{checksum.hex()}, "
+            f"expected 0x{expected_checksum.hex()}"
+        ), decoded
+
+    return True, "valid v3 onion", decoded
+
+
+def parse_config_addnodes(config_path: Path) -> list[tuple[str, str, int]]:
+    """
+    Extract (line_no, address, port) tuples for all addnode= lines in a config.
+
+    Also handles addnode=onion:port and just addnode=onion (port defaults to 24112).
+    """
+    addnodes = []
+    if not config_path.exists():
+        return addnodes
+
+    for line_no, raw_line in enumerate(config_path.read_text().splitlines(), 1):
+        line = raw_line.strip()
+        if not line or line.startswith('#'):
+            continue
+        m = re.match(r'^addnode=([^:]+)(?::(\d+))?$', line)
+        if m:
+            addr = m.group(1)
+            port = int(m.group(2)) if m.group(2) else 24112
+            addnodes.append((line_no, addr, port))
+
+    return addnodes
+
+
+def parse_source_seeds(source_path: Path) -> set[str]:
+    """
+    Extract all .onion addresses from the hardcoded seed list in onionseed.h.
+    Matches the strMainNetOnionSeed and strTestNetOnionSeed arrays.
+    """
+    seeds = set()
+    if not source_path.exists():
+        return seeds
+    for m in re.finditer(r'"([a-z2-7]{56}\.onion)"', source_path.read_text()):
+        seeds.add(m.group(1))
+    return seeds
+
+
+def levenshtein_1(a: str, b: str) -> int:
+    """Return number of positions where a and b differ (assumes same length)."""
+    if len(a) != len(b):
+        return -1
+    return sum(1 for x, y in zip(a, b) if x != b.count(x))
+
+
+def find_near_match(target: str, candidates: set[str]) -> str | None:
+    """Find a candidate that's 1-2 char different from target (for diff hints)."""
+    for c in candidates:
+        if len(c) == len(target):
+            d = sum(1 for x, y in zip(c, target) if x != y)
+            if 0 < d <= 2:
+                return c
+    return None
+
+
+def colorize(s: str, color: str, enabled: bool) -> str:
+    return f"{color}{s}{C.RESET}" if enabled else s
+
+
+def validate_config(
+    config_path: Path,
+    source_seeds: set[str] | None = None,
+    other_configs: dict[Path, set[str]] | None = None,
+    use_color: bool = True,
+) -> tuple[int, int, int, int]:
+    """
+    Validate all .onion addresses in a config file.
+
+    Returns:
+        (valid_count, invalid_count, missing_count, extra_count)
+    """
+    addnodes = parse_config_addnodes(config_path)
+    if not addnodes:
+        print(colorize(f"  (no addnode= entries found in {config_path})",
+                       C.YELLOW, use_color))
+        return (0, 0, 0, 0)
+
+    valid = invalid = 0
+    invalid_addrs = set()
+
+    print(colorize(f"\n=== {config_path} ===", C.BOLD + C.BLUE, use_color))
+    print(colorize(f"  {len(addnodes)} addnode entries found", C.DIM, use_color))
+
+    for line_no, addr, port in addnodes:
+        ok, reason, _ = decode_v3_onion(addr)
+        if ok:
+            print(f"  {colorize('[OK]', C.GREEN, use_color):>14}  line {line_no:>4}  {addr}")
+            valid += 1
+        else:
+            print(f"  {colorize('[BAD]', C.RED, use_color):>14}  line {line_no:>4}  {addr}")
+            print(f"  {'':<14}  {'':>4}  reason: {reason}")
+            # Try to suggest a similar address
+            if source_seeds:
+                near = find_near_match(addr, source_seeds)
+                if near:
+                    print(f"  {'':<14}  {'':>4}  {colorize(f'did you mean: {near}?', C.YELLOW, use_color)}")
+            invalid += 1
+            invalid_addrs.add(addr)
+
+    # Cross-check against other configs
+    missing = extra = 0
+    if other_configs and source_seeds is not None:
+        config_addrs = {addr for _, addr, _ in addnodes}
+        # Note: this just reports on relationships; doesn't fail the test
+        for other_path, other_addrs in other_configs.items():
+            only_in_this = config_addrs - other_addrs - invalid_addrs
+            only_in_other = other_addrs - config_addrs
+            if only_in_this:
+                print(colorize(
+                    f"\n  {colorize('[DIFF]', C.YELLOW, use_color)}  addresses only in {config_path.name} "
+                    f"(missing from {other_path.name}):",
+                    C.YELLOW, use_color))
+                for a in sorted(only_in_this):
+                    print(f"                  {a}")
+                extra += len(only_in_this)
+            if only_in_other:
+                print(colorize(
+                    f"\n  {colorize('[DIFF]', C.YELLOW, use_color)}  addresses only in {other_path.name} "
+                    f"(missing from {config_path.name}):",
+                    C.YELLOW, use_color))
+                for a in sorted(only_in_other):
+                    print(f"                  {a}")
+                missing += len(only_in_other)
+
+    return valid, invalid, missing, extra
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Validate v3 .onion addresses in Triangles config files",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=__doc__,
+    )
+    parser.add_argument(
+        'configs',
+        nargs='+',
+        type=Path,
+        help='One or more triangles.conf files to validate',
+    )
+    parser.add_argument(
+        '--against',
+        type=Path,
+        default=None,
+        help='Path to src/onionseed.h to use as source of truth for diff hints',
+    )
+    parser.add_argument(
+        '--ci',
+        action='store_true',
+        help='CI mode: exit 1 if any address fails validation',
+    )
+    parser.add_argument(
+        '--no-color',
+        action='store_true',
+        help='Disable colored output (also auto-disabled when stdout is not a TTY)',
+    )
+
+    args = parser.parse_args()
+
+    # Color detection
+    use_color = not args.no_color and sys.stdout.isatty()
+    if not use_color:
+        C.disable()
+
+    # Validate inputs exist
+    for p in args.configs:
+        if not p.exists():
+            print(colorize(f"ERROR: file not found: {p}", C.RED, use_color),
+                  file=sys.stderr)
+            return 2
+
+    # Load source seeds if provided
+    source_seeds = None
+    if args.against:
+        if not args.against.exists():
+            print(colorize(f"WARNING: source seed file not found: {args.against}",
+                           C.YELLOW, use_color), file=sys.stderr)
+        else:
+            source_seeds = parse_source_seeds(args.against)
+            print(colorize(
+                f"Loaded {len(source_seeds)} hardcoded seeds from {args.against}",
+                C.DIM, use_color))
+
+    # Pre-load all configs for cross-checking
+    all_configs: dict[Path, set[str]] = {}
+    for p in args.configs:
+        addnodes = parse_config_addnodes(p)
+        all_configs[p] = {addr for _, addr, _ in addnodes}
+
+    # Validate each config
+    total_valid = total_invalid = total_missing = total_extra = 0
+    for p in args.configs:
+        if len(args.configs) > 1:
+            other = {k: v for k, v in all_configs.items() if k != p}
+        else:
+            other = None
+        v, i, m, e = validate_config(p, source_seeds, other, use_color)
+        total_valid += v
+        total_invalid += i
+        total_missing += m
+        total_extra += e
+
+    # Summary
+    print(colorize("\n=== SUMMARY ===", C.BOLD, use_color))
+    print(f"  Valid:      {colorize(str(total_valid), C.GREEN, use_color)}")
+    if total_invalid:
+        print(f"  Invalid:    {colorize(str(total_invalid), C.RED, use_color)}")
+    else:
+        print(f"  Invalid:    {total_invalid}")
+    if total_missing:
+        print(f"  Missing:    {colorize(str(total_missing), C.YELLOW, use_color)} "
+              f"(in other configs, not this one)")
+    if total_extra:
+        print(f"  Extra:      {colorize(str(total_extra), C.YELLOW, use_color)} "
+              f"(in this config, not others)")
+
+    if total_invalid == 0 and total_missing == 0:
+        print(colorize("\n  All addresses valid.", C.GREEN + C.BOLD, use_color))
+        return 0
+    else:
+        print(colorize(
+            f"\n  {total_invalid} address(es) failed v3 onion checksum validation.",
+            C.RED + C.BOLD, use_color))
+        if args.ci:
+            return 1
+        return 1 if total_invalid else 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

scripts/verify-reproducible-build.sh

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# verify-reproducible-build.sh
+#
+# Builds the Triangles daemon (trianglesd) twice from the same source tree
+# into two separate build directories, then compares the resulting
+# SHA256 hashes. Exits 0 if the two builds produce byte-identical binaries,
+# non-zero otherwise.
+#
+# Usage:
+#   scripts/verify-reproducible-build.sh                       # default: trianglesd, Release
+#   BUILD_TYPE=Debug  scripts/verify-reproducible-build.sh     # override build type
+#   TARGET=triangles-qt scripts/verify-reproducible-build.sh   # build Qt wallet instead
+#
+# What "reproducible" means here:
+#   Given identical source tree, identical compiler toolchain, identical
+#   build flags, identical SOURCE_DATE_EPOCH (if set) -- the resulting
+#   binary must hash identically across separate build directories.
+#
+# This script does NOT enforce compiler version pinning. Two different
+# GCC versions will legitimately produce different binaries even with
+# identical flags. The verification is "same source + same toolchain =
+# same binary."
+#
+# Pass criteria:
+#   1. Both builds succeed
+#   2. Both binaries exist
+#   3. SHA256 of the two binaries is equal
+#
+# On failure: prints the two SHA256s and the diff in size so a reviewer
+# can investigate. Common causes of non-determinism:
+#   - __DATE__/__TIME__ embedded (we eliminate this in CMakeLists.txt)
+#   - absolute paths in __FILE__ (mitigated by -ffile-prefix-map)
+#   - uninitialized stack/heap contents (should not affect final binary)
+#   - linker adds random base addresses (PIE; deterministic if compiled
+#     with -fno-pie)
+
+set -euo pipefail
+
+# ── Config ─────────────────────────────────────────────────────────────────
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SOURCE_DIR="${SOURCE_DIR:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+BUILD_TYPE="${BUILD_TYPE:-Release}"
+TARGET="${TARGET:-trianglesd}"
+# Skip Qt by default -- it's slow and adds CI noise. Override with TARGET=triangles-qt
+: "${BUILD_QT:=OFF}"
+BUILD_DIR_A="${BUILD_DIR_A:-/tmp/triangles-repro-A}"
+BUILD_DIR_B="${BUILD_DIR_B:-/tmp/triangles-repro-B}"
+LOG_A="${LOG_A:-/tmp/triangles-repro-A.log}"
+LOG_B="${LOG_B:-/tmp/triangles-repro-B.log}"
+
+# ── Preflight ──────────────────────────────────────────────────────────────
+command -v cmake >/dev/null || { echo "ERROR: cmake not found" >&2; exit 2; }
+command -v ninja >/dev/null || { echo "ERROR: ninja not found (apt install ninja-build)" >&2; exit 2; }
+command -v sha256sum >/dev/null || { echo "ERROR: sha256sum not found" >&2; exit 2; }
+
+if [ ! -d "$SOURCE_DIR" ]; then
+    echo "ERROR: source dir not found: $SOURCE_DIR" >&2
+    exit 2
+fi
+
+# Warn if tracked files are dirty -- git describe --dirty (used by build.h)
+# ignores untracked files, but includes modified/staged tracked files in the
+# version string. Untracked notes/build outputs are safe and should not scare
+# release builders.
+if [ -n "$(cd "$SOURCE_DIR" && git status --porcelain --untracked-files=no 2>/dev/null)" ]; then
+    echo "WARNING: tracked working tree changes detected." >&2
+    echo "         build.h will include a '-dirty' suffix, so the binary will not" >&2
+    echo "         match a clean checkout/tag. Commit or stash tracked changes first." >&2
+fi
+
+# ── Embedded sub-libraries (Tor, I2P) ─────────────────────────────────────
+# The daemon statically links libtor.a and libi2pd*.a; both must exist
+# before cmake's link step. On a fresh checkout they need to be built from
+# the embedded submodules. CI does this in build-all.yml before the main
+# build; this script does the same so a local `scripts/verify-reproducible-build.sh`
+# works out of the box.
+TOR_LIB="$SOURCE_DIR/src/tor/tor-src/libtor.a"
+I2P_LIBS=(
+    "$SOURCE_DIR/src/i2p/i2pd-src/libi2pd.a"
+    "$SOURCE_DIR/src/i2p/i2pd-src/libi2pdclient.a"
+    "$SOURCE_DIR/src/i2p/i2pd-src/libi2pdlang.a"
+)
+NEED_TOR_BUILD=0
+NEED_I2P_BUILD=0
+[ -f "$TOR_LIB" ] || NEED_TOR_BUILD=1
+for lib in "${I2P_LIBS[@]}"; do [ -f "$lib" ] || NEED_I2P_BUILD=1; done
+
+if [ "$NEED_TOR_BUILD" = "1" ]; then
+    echo "Building libtor.a (one-time, ~5 min)..." >&2
+    # CI passes /usr paths for native Linux; defaults in build-libtor.sh
+    # are MINGW64 cross-compile paths.
+    LIBEVENT_DIR=/usr OPENSSL_DIR=/usr ZLIB_DIR=/usr \
+        bash "$SOURCE_DIR/src/tor/build-libtor.sh" \
+        > /tmp/triangles-build-libtor.log 2>&1 \
+        || { echo "ERROR: libtor build failed; see /tmp/triangles-build-libtor.log" >&2; exit 5; }
+fi
+if [ "$NEED_I2P_BUILD" = "1" ]; then
+    echo "Building libi2pd*.a (one-time, ~3 min)..." >&2
+    bash "$SOURCE_DIR/src/i2p/build-libi2pd.sh" \
+        > /tmp/triangles-build-libi2pd.log 2>&1 \
+        || { echo "ERROR: libi2pd build failed; see /tmp/triangles-build-libi2pd.log" >&2; exit 5; }
+fi
+
+# ── Helpers ────────────────────────────────────────────────────────────────
+build_one() {
+    local dir="$1" log="$2"
+    rm -rf "$dir"
+    mkdir -p "$dir"
+    echo "  configuring in $dir (BUILD_TYPE=$BUILD_TYPE BUILD_QT=$BUILD_QT)..." >&2
+    cmake -S "$SOURCE_DIR" -B "$dir" \
+        -DCMAKE_BUILD_TYPE="$BUILD_TYPE" \
+        -DBUILD_QT="$BUILD_QT" \
+        > "$log" 2>&1 || { echo "  configure failed; see $log" >&2; tail -30 "$log" >&2; exit 3; }
+    echo "  building target $TARGET..." >&2
+    cmake --build "$dir" --target "$TARGET" -j "$(nproc)" \
+        >> "$log" 2>&1 || { echo "  build failed; see $log" >&2; tail -30 "$log" >&2; exit 3; }
+    # ONLY stdout of the find goes to the caller. Progress logs above
+    # were redirected to stderr so they don't pollute the captured path.
+    find "$dir" -name "$TARGET" -type f -executable | head -1
+}
+
+# ── Build twice ────────────────────────────────────────────────────────────
+echo "Building $TARGET ($BUILD_TYPE) twice from $SOURCE_DIR..."
+echo ""
+BIN_A="$(build_one "$BUILD_DIR_A" "$LOG_A")"
+BIN_B="$(build_one "$BUILD_DIR_B" "$LOG_B")"
+
+if [ -z "$BIN_A" ] || [ -z "$BIN_B" ]; then
+    echo "ERROR: could not find built binary" >&2
+    echo "  A: '$BIN_A'" >&2
+    echo "  B: '$BIN_B'" >&2
+    exit 4
+fi
+
+# ── Compare ────────────────────────────────────────────────────────────────
+HASH_A="$(sha256sum "$BIN_A" | awk '{print $1}')"
+HASH_B="$(sha256sum "$BIN_B" | awk '{print $1}')"
+SIZE_A="$(stat -c%s "$BIN_A" 2>/dev/null || stat -f%z "$BIN_A")"
+SIZE_B="$(stat -c%s "$BIN_B" 2>/dev/null || stat -f%z "$BIN_B")"
+
+echo ""
+echo "Binary A: $BIN_A"
+echo "  sha256: $HASH_A"
+echo "  size:   $SIZE_A bytes"
+echo "Binary B: $BIN_B"
+echo "  sha256: $HASH_B"
+echo "  size:   $SIZE_B bytes"
+echo ""
+
+if [ "$HASH_A" = "$HASH_B" ]; then
+    echo "✓ REPRODUCIBLE: both builds produced identical SHA256"
+    exit 0
+else
+    echo "✗ NOT REPRODUCIBLE: hashes differ"
+    echo ""
+    echo "Likely causes:"
+    echo "  - __DATE__/__TIME__ embedded (check src/version.cpp)"
+    echo "  - absolute build paths in __FILE__ (check CMakeLists.txt for -ffile-prefix-map)"
+    echo "  - dirty git tree (commit/stash and rerun)"
+    echo "  - PIE base randomization (compile with -fno-pie -no-pie for testing)"
+    echo "  - non-deterministic linker output (linker version mismatch)"
+    exit 1
+fi

snap/snapcraft.yaml

@@ -1,6 +1,6 @@
 name: triangles
 base: core22
-version: '5.7.6'
+version: '6.2.4'
 summary: Cryptographic Triangles (TRI) cryptocurrency wallet
 description: |
   Privacy-focused cryptocurrency featuring Proof-of-Stake consensus,
@@ -51,10 +51,10 @@ apps:
 parts:
   triangles:
     plugin: dump
-    source: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.7.6/Cryptographic-Triangles-v5.7.6-linux-x64-qt
+    source: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v6.2.4/Cryptographic-Triangles-v6.2.4-linux-x64-qt
     source-type: file
     organize:
-      Cryptographic-Triangles-v5.7.6-linux-x64-qt: bin/triangles-qt
+      Cryptographic-Triangles-v6.2.4-linux-x64-qt: bin/triangles-qt
     stage-packages:
       - libqt5widgets5
       - libqt5gui5
@@ -73,10 +73,10 @@ parts:
 
   trianglesd:
     plugin: dump
-    source: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v5.7.6/Cryptographic-Triangles-v5.7.6-linux-x64-daemon
+    source: https://github.com/SamiAhmed7777/triangles_v5/releases/download/v6.2.4/Cryptographic-Triangles-v6.2.4-linux-x64-daemon
     source-type: file
     organize:
-      Cryptographic-Triangles-v5.7.6-linux-x64-daemon: bin/trianglesd
+      Cryptographic-Triangles-v6.2.4-linux-x64-daemon: bin/trianglesd
 
   desktop-entry:
     plugin: dump

src/CMakeLists.txt

@@ -40,8 +40,10 @@ target_include_directories(json_compat INTERFACE "${CMAKE_CURRENT_SOURCE_DIR}/js
 set(CORE_SOURCES
     addrman.cpp
     bootstrap.cpp
+    checkpointpublisher.cpp
     checkpoints.cpp
     crypter.cpp
+    hdwallet.cpp
     crypto_ecdh.cpp
     crypto_ecdsa.cpp
     db.cpp
@@ -84,6 +86,7 @@ set(CORE_SOURCES
     tor/onion_v3.cpp
     tor/tor_process.cpp
     tor/tor_embedded.cpp
+    i2p/i2p_embedded.cpp
 )
 
 # Scrypt assembly — platform-specific
@@ -105,12 +108,39 @@ endif()
 # for the rationale — RocksDB also backs the smessage store).
 list(APPEND CORE_SOURCES txdb-rocksdb.cpp)
 
+# Modernization: SQLite wallet DB backend + Berkeley→SQLite migration.
+# Built unconditionally; selection happens at runtime via -walletdb.
+list(APPEND CORE_SOURCES
+    walletdb-factory.cpp
+    walletdb-sqlite.cpp
+    walletdb-recover.cpp
+    walletmigrate.cpp
+)
+
 add_library(triangles_common OBJECT ${CORE_SOURCES})
 
+# When BUILD_FUZZ=ON, the fuzz target links these .o files directly into
+# bin/fuzz_script. The link line enables -fsanitize=fuzzer,address,undefined
+# so EVERY .o referenced from the fuzz binary must also be compiled with the
+# matching -fsanitize=address,undefined,fuzzer-no-link. Without this, gcc-
+# built triangles_common objects reference libstdc++-injected ubsan runtime
+# symbols (e.g. __ubsan_handle_function_type_mismatch_v1_abort) that clang's
+# libubsan_standalone runtime doesn't provide, and the link fails with
+# "undefined reference to __ubsan_handle_function_type_mismatch_v1_abort".
+if(BUILD_FUZZ)
+    target_compile_options(triangles_common PRIVATE
+        -fsanitize=address,undefined,fuzzer-no-link
+        -fno-omit-frame-pointer
+        -fno-sanitize-recover=undefined
+        -fno-sanitize=alignment,signed-integer-overflow,vptr
+    )
+endif()
+
 target_include_directories(triangles_common PUBLIC
     "${CMAKE_CURRENT_SOURCE_DIR}"
     "${CMAKE_CURRENT_SOURCE_DIR}/json"
     "${CMAKE_CURRENT_SOURCE_DIR}/tor"
+    "${CMAKE_CURRENT_SOURCE_DIR}/i2p"
     "${CMAKE_BINARY_DIR}/generated"       # for build.h
 )
 
@@ -122,13 +152,11 @@ target_link_libraries(triangles_common PUBLIC
     leveldb_bundled
     OpenSSL::SSL
     OpenSSL::Crypto
-    Boost::program_options
-    Boost::thread
-    Boost::chrono
     BerkeleyDB::BerkeleyDB
     Libevent::Libevent
     ZLIB::ZLIB
     Threads::Threads
+    SQLite::SQLite3
 )
 
 # Optional: UPnP
@@ -177,19 +205,118 @@ if(USE_TOR_EMBEDDED)
     # and its dependencies.
     # Use --allow-multiple-definition because libtor.a may pull in static
     # OpenSSL objects that duplicate the DLL import lib already linked above.
+    # These GNU ld options are not supported on macOS (which uses lld) —
+    # guard with NOT APPLE so the build still works on macOS.
+    # On macOS, the libevent/openssl/zlib install paths are not on the
+    # default linker search path. Pull them in from the standard
+    # homebrew locations so -levent / -lssl / -lssl etc. resolve.
+    if(APPLE)
+        target_link_directories(triangles_common PUBLIC
+            /opt/homebrew/opt/libevent/lib
+            /opt/homebrew/opt/openssl@3/lib
+            /opt/homebrew/opt/zlib/lib
+        )
+    endif()
+    if(NOT APPLE)
+        target_link_libraries(triangles_common PUBLIC
+            -Wl,--allow-multiple-definition
+            -Wl,--start-group
+        )
+    endif()
     target_link_libraries(triangles_common PUBLIC
-        -Wl,--allow-multiple-definition
-        -Wl,--start-group
         -ltor
         -levent -levent_core -levent_extra -levent_openssl
         -lssl -lcrypto -lz -llzma -lzstd
-        -Wl,--end-group
     )
+    if(NOT APPLE)
+        target_link_libraries(triangles_common PUBLIC
+            -Wl,--end-group
+        )
+    endif()
     if(WIN32)
         target_link_libraries(triangles_common PUBLIC iphlpapi shlwapi crypt32)
     endif()
 endif()
 
+# Optional: Embedded I2P (i2pd)
+if(USE_I2P_EMBEDDED)
+    if(I2P_SOURCE_ROOT STREQUAL "")
+        set(I2P_SOURCE_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/i2p/i2pd-src")
+    endif()
+    if(NOT EXISTS "${I2P_SOURCE_ROOT}/libi2pd/Crypto.h")
+        message(FATAL_ERROR
+            "USE_I2P_EMBEDDED=ON but i2pd source not found at ${I2P_SOURCE_ROOT}.\n"
+            "Run: git submodule update --init --recursive\n"
+            "Or set -DI2P_SOURCE_ROOT=/path/to/i2pd")
+    endif()
+    target_compile_definitions(triangles_common PUBLIC ENABLE_I2P_EMBEDDED)
+    target_include_directories(triangles_common PUBLIC
+        "${I2P_SOURCE_ROOT}"
+        "${I2P_SOURCE_ROOT}/libi2pd"
+        "${I2P_SOURCE_ROOT}/libi2pd_client"
+        "${I2P_SOURCE_ROOT}/i18n"
+    )
+    # i2pd builds as two static libraries: libi2pd.a (core router) and
+    # libi2pd_client.a (SAM, SOCKS, tunnels, client context). Both are needed.
+    # i2pd's own Makefile.mingw links by full static .a paths rather than
+    # -l flags because MinGW's linker is single-pass and CMake imported
+    # targets (Boost::) may not exist on MSYS2. We follow the same pattern:
+    # link the archives, then their Boost/zlib deps as full paths, then
+    # the archives again to resolve the second-pass references.
+    target_link_libraries(triangles_common PUBLIC
+        "${I2P_SOURCE_ROOT}/libi2pdclient.a"
+        "${I2P_SOURCE_ROOT}/libi2pd.a"
+        "${I2P_SOURCE_ROOT}/libi2pdlang.a"
+    )
+    if(WIN32)
+        # MinGW/MSYS2: Boost:: CMake imported targets are unreliable here.
+        # Use find_library to locate the actual .a/.dll files. Some Boost
+        # libs (e.g. boost_system) are header-only in newer versions and
+        # won't have a .a file at all — that's fine, we skip them.
+        if(NOT MINGW_PREFIX)
+            if(DEFINED ENV{MINGW_PREFIX})
+                set(MINGW_PREFIX "$ENV{MINGW_PREFIX}")
+            else()
+                set(MINGW_PREFIX "/mingw64")
+            endif()
+        endif()
+        find_library(I2P_BOOST_FS  NAMES boost_filesystem-mt boost_filesystem libboost_filesystem-mt  HINTS "${MINGW_PREFIX}/lib")
+        find_library(I2P_BOOST_PO  NAMES boost_program_options-mt boost_program_options libboost_program_options-mt  HINTS "${MINGW_PREFIX}/lib")
+        find_library(I2P_BOOST_SYS NAMES boost_system-mt boost_system libboost_system-mt  HINTS "${MINGW_PREFIX}/lib")
+        find_library(I2P_SSL       NAMES ssl libssl  HINTS "${MINGW_PREFIX}/lib")
+        find_library(I2P_CRYPTO    NAMES crypto libcrypto  HINTS "${MINGW_PREFIX}/lib")
+        find_library(I2P_Z         NAMES z libz zlib  HINTS "${MINGW_PREFIX}/lib")
+        set(I2P_WIN_LIBS "")
+        foreach(lib I2P_BOOST_FS I2P_BOOST_PO I2P_BOOST_SYS I2P_SSL I2P_CRYPTO I2P_Z)
+            if(${lib})
+                list(APPEND I2P_WIN_LIBS "${${lib}}")
+                message(STATUS "  I2P link: ${lib} = ${${lib}}")
+            else()
+                message(STATUS "  I2P link: ${lib} = (not found, header-only?)")
+            endif()
+        endforeach()
+        target_link_libraries(triangles_common PUBLIC ${I2P_WIN_LIBS} -Wl,--allow-multiple-definition)
+    else()
+        target_link_libraries(triangles_common PUBLIC
+            Boost::program_options Boost::thread Boost::chrono
+            OpenSSL::SSL OpenSSL::Crypto
+            ZLIB::ZLIB
+        )
+        if(TARGET Boost::filesystem)
+            target_link_libraries(triangles_common PUBLIC Boost::filesystem)
+        endif()
+        if(TARGET Boost::system)
+            target_link_libraries(triangles_common PUBLIC Boost::system)
+        endif()
+    endif()
+    # Second pass: list archives again so linker resolves i2pd→Boost refs
+    # that were unsatisfied in the first left-to-right pass.
+    target_link_libraries(triangles_common PUBLIC
+        "${I2P_SOURCE_ROOT}/libi2pd.a"
+        "${I2P_SOURCE_ROOT}/libi2pdclient.a"
+    )
+endif()
+
 # Platform-specific libraries
 if(WIN32)
     target_link_libraries(triangles_common PUBLIC
@@ -234,12 +361,36 @@ target_precompile_headers(triangles_common PRIVATE
 # ═══════════════════════════════════════════════════════════════════════════════
 # 4. Headless daemon (trianglesd)
 # ═══════════════════════════════════════════════════════════════════════════════
-if(BUILD_DAEMON)
-    add_executable(trianglesd
-        noui.cpp
-        init.cpp
-        wallet.cpp
+# `trianglesd` is normally an add_executable, but the libFuzzer build only
+# needs the daemon's object files (init/wallet/noui). Building the executable
+# under clang-15 with -fsanitize=fuzzer+address+undefined pulls in
+# undefined references to the libstdc++ runtime built by gcc, which fails
+# the link step. So we expose the daemon's sources as an OBJECT library and
+# only attach them to trianglesd when we're not in a fuzz build.
+set(DAEMON_SOURCES
+    noui.cpp
+    init.cpp
+    wallet.cpp
+)
+if(BUILD_FUZZ)
+    add_library(trianglesd_objects OBJECT ${DAEMON_SOURCES})
+    target_link_libraries(trianglesd_objects PRIVATE triangles_common)
+    target_precompile_headers(trianglesd_objects REUSE_FROM triangles_common)
+    # Match triangles_common's sanitizer instrumentation so noui.cpp / init.cpp
+    # / wallet.cpp .o files don't reference the gcc libstdc++ ubsan runtime
+    # when linked into the fuzz binary (see triangles_common compile-options
+    # comment above for the full rationale).
+    target_compile_options(trianglesd_objects PRIVATE
+        -fsanitize=address,undefined,fuzzer-no-link
+        -fno-omit-frame-pointer
+        -fno-sanitize-recover=undefined
+        -fno-sanitize=alignment,signed-integer-overflow,vptr
     )
+    if(WIN32)
+        set_target_properties(trianglesd_objects PROPERTIES SUFFIX ".obj")
+    endif()
+elseif(BUILD_DAEMON)
+    add_executable(trianglesd ${DAEMON_SOURCES})
     # No QT_GUI define — daemon gets the #if !defined(QT_GUI) code paths
     target_link_libraries(trianglesd PRIVATE triangles_common)
     target_precompile_headers(trianglesd REUSE_FROM triangles_common)
@@ -249,6 +400,39 @@ if(BUILD_DAEMON)
     endif()
 endif()
 
+# ═══════════════════════════════════════════════════════════════════════════════
+# 4b. JSON-RPC client (triangles-cli)
+#
+# Self-contained: only links univalue + boost::asio + boost::program_options
+# + boost::filesystem + OpenSSL (for base64 / future TLS). Does NOT link
+# triangles_common, wallet, or net — keeps the binary small.
+# ═══════════════════════════════════════════════════════════════════════════════
+if(BUILD_CLI)
+    add_executable(triangles-cli
+        triangles-cli.cpp
+    )
+    # No Boost dependency: uses raw POSIX/Winsock sockets for HTTP. Only links
+    # the json_compat header-only shim and the platform's native socket lib
+    # (Winsock ws2_32 on Windows; libc on POSIX). Keeps the binary small and
+    # avoids per-platform Boost linking pain (MSYS2 uses versioned -mt- names;
+    # Homebrew doesn't ship the boost_system CMake config).
+    target_link_libraries(triangles-cli
+        PRIVATE
+            json_compat
+    )
+
+    if(WIN32)
+        set_target_properties(triangles-cli PROPERTIES SUFFIX ".exe")
+        target_link_libraries(triangles-cli PRIVATE ws2_32)
+    endif()
+
+    if(MSVC)
+        set_target_properties(triangles-cli PROPERTIES
+            VS_WINRT_COMPONENT "console"
+        )
+    endif()
+endif()
+
 # ═══════════════════════════════════════════════════════════════════════════════
 # 5. Qt5 GUI wallet (triangles-qt)
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -306,6 +490,8 @@ if(BUILD_QT)
         qt/trianglesunits.cpp
         qt/qvaluecombobox.cpp
         qt/askpassphrasedialog.cpp
+        qt/hdseeddialog.cpp
+        qt/outlinedlabel.cpp
         qt/notificator.cpp
         qt/qtipcserver.cpp
         qt/rpcconsole.cpp
@@ -385,6 +571,7 @@ if(BUILD_QT)
         Qt5::Core
         Qt5::Gui
         Qt5::Widgets
+        Qt5::Network
     )
 
     # Optional: D-Bus notifications (Linux)
@@ -448,6 +635,18 @@ if(BUILD_TESTS)
     file(GLOB TEST_SOURCES "${CMAKE_CURRENT_SOURCE_DIR}/test/*.cpp")
     # Exclude miner_tests.cpp (never ported from Bitcoin)
     list(FILTER TEST_SOURCES EXCLUDE REGEX "miner_tests\\.cpp$")
+    # Exclude the standalone chaindb test driver — it gets its own target
+    # because it needs to run without the TestingSetup global fixture.
+    list(FILTER TEST_SOURCES EXCLUDE REGEX "chaindb_equivalence_tests_main\\.cpp$")
+    # These two are standalone test drivers: each #defines its own
+    # BOOST_TEST_MODULE and redefines the wallet/UI globals, and each has
+    # a dedicated executable + add_test below. They must NOT also be
+    # globbed into test_triangles, or the duplicate module/main and global
+    # symbols only link by virtue of -Wl,--allow-multiple-definition (which
+    # silently drops duplicates and can run their suites under the wrong
+    # global fixture). Excluding them keeps each standalone module isolated.
+    list(FILTER TEST_SOURCES EXCLUDE REGEX "chaindb_runtime_tests\\.cpp$")
+    list(FILTER TEST_SOURCES EXCLUDE REGEX "snapshotnet_tests\\.cpp$")
 
     add_executable(test_triangles
         ${TEST_SOURCES}
@@ -458,7 +657,7 @@ if(BUILD_TESTS)
     # No init.cpp — test_triangles.cpp provides its own StartShutdown() stub
 
     target_compile_definitions(test_triangles PRIVATE
-        "TEST_DATA_DIR=\"${CMAKE_CURRENT_SOURCE_DIR}/test/data\""
+        "TEST_DATA_DIR=${CMAKE_CURRENT_SOURCE_DIR}/test/data"
     )
 
     target_include_directories(test_triangles PRIVATE
@@ -471,5 +670,515 @@ if(BUILD_TESTS)
         Boost::unit_test_framework
     )
 
+    # WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}: the consensus_safety_tests
+    # `reindex_reconstruction_is_explicit_and_fail_closed` test reads
+    # src/init.cpp + src/main.cpp via __FILE__-relative path traversal
+    # (3x parent_path() calls). When ctest runs from build/src/ (the
+    # default CMAKE_CURRENT_BINARY_DIR for src/CMakeLists.txt), the
+    # resolved path is build/src/src/init.cpp which doesn't exist.
+    # Pinning WORKING_DIRECTORY to "${CMAKE_SOURCE_DIR}" makes the test
+    # source paths resolve correctly from any environment.
     add_test(NAME triangles_unit_tests COMMAND test_triangles --log_level=test_suite)
+    set_tests_properties(triangles_unit_tests PROPERTIES WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}")
+
+    # ── Standalone chaindb equivalence tests ─────────────────────────────────
+    # Runs without the TestingSetup global fixture (which would otherwise
+    # open the real chain DB and lock it for the process). Sets a fresh
+    # temp -datadir via its own global fixture, then runs the
+    # chaindb_equivalence_tests suite.
+    add_executable(test_chaindb_equivalence
+        "${CMAKE_CURRENT_SOURCE_DIR}/test/chaindb_equivalence_tests_main.cpp"
+        # wallet.cpp provides the CWallet symbols that triangles_common
+        # (txdb-rocksdb, net, etc.) references, even though the chaindb
+        # tests themselves don't use the wallet.
+        wallet.cpp
+    )
+    target_include_directories(test_chaindb_equivalence PRIVATE
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${CMAKE_CURRENT_SOURCE_DIR}/test"
+        "${CMAKE_CURRENT_SOURCE_DIR}/leveldb/include"
+    )
+    target_link_libraries(test_chaindb_equivalence PRIVATE
+        triangles_common
+        Boost::unit_test_framework
+    )
+    add_test(NAME chaindb_equivalence_tests
+             COMMAND test_chaindb_equivalence --log_level=test_suite)
+
+    # ── Standalone snapshotnet P2P tests ────────────────────────────────────
+    # Same rationale as test_chaindb_equivalence: snapshotnet needs filesystem
+    # and threading globals and its own tmp datadir fixture, which would
+    # conflict with test_triangles' heavy TestingSetup. Runs independently.
+    add_executable(test_snapshotnet
+        "${CMAKE_CURRENT_SOURCE_DIR}/test/snapshotnet_tests.cpp"
+        wallet.cpp
+    )
+    target_include_directories(test_snapshotnet PRIVATE
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${CMAKE_CURRENT_SOURCE_DIR}/test"
+        "${CMAKE_CURRENT_SOURCE_DIR}/leveldb/include"
+    )
+    target_link_libraries(test_snapshotnet PRIVATE
+        triangles_common
+        Boost::unit_test_framework
+    )
+    add_test(NAME snapshotnet_tests
+             COMMAND test_snapshotnet --log_level=test_suite)
+
+    # ── Standalone chaindb runtime tests (CRocksTxDB wrapper layer) ─────────
+    # Exercises MakeChainDB / WipeChainDataDir / IsRocksDbChainBackend and
+    # the CRocksTxDB write/read/batch/iterator wrapper — the same code path
+    # the daemon uses when launched with `-chaindb=rocksdb`. The
+    # chaindb_equivalence_tests (above) only verify the byte-copy migration
+    # via the raw leveldb/rocksdb APIs; this one verifies the wrapper class.
+    add_executable(test_chaindb_runtime
+        "${CMAKE_CURRENT_SOURCE_DIR}/test/chaindb_runtime_tests.cpp"
+        wallet.cpp
+    )
+    target_include_directories(test_chaindb_runtime PRIVATE
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${CMAKE_CURRENT_SOURCE_DIR}/test"
+        "${CMAKE_CURRENT_SOURCE_DIR}/leveldb/include"
+    )
+    target_link_libraries(test_chaindb_runtime PRIVATE
+        triangles_common
+        Boost::unit_test_framework
+    )
+    add_test(NAME chaindb_runtime_tests
+             COMMAND test_chaindb_runtime --log_level=test_suite)
+endif()
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# 7. Fuzz harness (script interpreter) — opt-in via -DBUILD_FUZZ=ON
+# ═══════════════════════════════════════════════════════════════════════════════
+# LibFuzzer is built into clang since version 6; gcc doesn't support
+# -fsanitize=fuzzer. We compile script_fuzz.cpp + script.cpp with clang++
+# (so the interpreter itself is ASan/UBSan-instrumented) and link against
+# the full triangles_common OBJECT library + the same library set trianglesd
+# uses. Default build (gcc, no sanitizer) is unaffected.
+#
+# Build:
+#   cmake -G Ninja -DBUILD_TESTS=ON -DBUILD_FUZZ=ON -DBUILD_DAEMON=ON ..
+#   ninja fuzz_script
+#
+# Run:
+#   ./bin/fuzz_script -max_total_time=300 corpus/
+#
+# See src/test/fuzz/README.md for corpus seeding and what it covers.
+option(BUILD_FUZZ "Build libFuzzer harness for the script interpreter" OFF)
+if(BUILD_FUZZ)
+    find_program(CLANGXX clang++)
+    if(NOT CLANGXX)
+        message(FATAL_ERROR "BUILD_FUZZ=ON requires clang++; not found in PATH")
+    endif()
+
+    set(FUZZ_OBJ_DIR "${CMAKE_CURRENT_BINARY_DIR}/fuzz_objs")
+    file(MAKE_DIRECTORY "${FUZZ_OBJ_DIR}")
+    set(FUZZ_OBJ_SCRIPT_FUZZ "${FUZZ_OBJ_DIR}/script_fuzz.cpp.o")
+    set(FUZZ_OBJ_SCRIPT      "${FUZZ_OBJ_DIR}/script.cpp.o")
+    set(FUZZ_OBJ_FUZZ_STUBS  "${FUZZ_OBJ_DIR}/fuzz_stubs.cpp.o")
+    set(FUZZ_FUZZ_STUBS_SRC  "${FUZZ_OBJ_DIR}/fuzz_stubs.cpp")
+    set(FUZZ_BIN_DIR         "${CMAKE_BINARY_DIR}/bin")
+    file(MAKE_DIRECTORY "${FUZZ_BIN_DIR}")
+    set(FUZZ_BIN             "${FUZZ_BIN_DIR}/fuzz_script")
+    set(FUZZ_SRC_FUZZ        "${CMAKE_CURRENT_SOURCE_DIR}/test/fuzz/script_fuzz.cpp")
+    set(FUZZ_SRC_SCRIPT      "${CMAKE_CURRENT_SOURCE_DIR}/script.cpp")
+
+    # --- Second fuzz target: transaction_deserialize_fuzz ---
+    # CTransaction is declared in main.h and implemented in main.cpp, which is
+    # part of triangles_common. The harness only needs the transaction
+    # deserialize/serialize surface, not the script interpreter, so we don't
+    # need a separate clang-instrumented copy of any .cpp file — we just link
+    # the gcc-built triangles_common .o files directly. libFuzzer's link line
+    # is compatible with gcc .o files for the non-instrumented units; only the
+    # harness entry point itself needs clang + -fsanitize=fuzzer.
+    set(FUZZ_TX_DESER_OBJ       "${FUZZ_OBJ_DIR}/transaction_deserialize_fuzz.cpp.o")
+        set(FUZZ_TX_DESER_BIN_DIR   "${CMAKE_BINARY_DIR}/bin")
+        set(FUZZ_TX_DESER_BIN       "${FUZZ_TX_DESER_BIN_DIR}/transaction_deserialize_fuzz")
+        set(FUZZ_TX_DESER_SRC       "${CMAKE_CURRENT_SOURCE_DIR}/test/fuzz/transaction_deserialize_fuzz.cpp")
+        set(FUZZ_TX_DESER_LINK_WRAPPER "${FUZZ_OBJ_DIR}/link_txdeser.sh")
+        set(FUZZ_TX_DESER_LINK_WRAPPER_CONTENT [=[#!/bin/bash
+    # Auto-generated by CMake (BUILD_FUZZ block). Link wrapper for the
+    # transaction_deserialize_fuzz target. Discovers triangles_common +
+    # trianglesd .o files at link time and exec's the clang++ link line.
+    #
+    # Differs from link.sh: this wrapper does NOT exclude script.cpp.o, because
+    # wallet.cpp.o (in trianglesd_objects) calls ExtractDestination,
+    # SignSignature, Solver, IsMine — all defined in script.cpp.o. We only exclude
+    # init.cpp.o (which defines daemon main(), would conflict with libFuzzer's
+    # main). See the BUILD_FUZZ block in src/CMakeLists.txt for full rationale.
+    #
+    # Usage: link_txdeser.sh clang++ [link-args...]
+    # Final exec: clang++ <each .o> <each original link-arg>
+    set -euo pipefail
+    PROG="$1"
+    shift
+    TRIANGLES_COMMON_DIR="@CMAKE_CURRENT_BINARY_DIR@/CMakeFiles/triangles_common.dir"
+    TRIANGLESD_DIR="@CMAKE_CURRENT_BINARY_DIR@/CMakeFiles/trianglesd_objects.dir"
+    declare -a OBJS=()
+    for f in "$TRIANGLES_COMMON_DIR"/*.o "$TRIANGLES_COMMON_DIR"/*/*.o; do
+        [ -f "$f" ] || continue
+        OBJS+=("$f")
+    done
+    if [ -d "$TRIANGLESD_DIR" ]; then
+        for f in "$TRIANGLESD_DIR"/*.o; do
+            [ -f "$f" ] || continue
+            case "$f" in
+                */init.cpp.o) continue ;;
+            esac
+            OBJS+=("$f")
+        done
+    fi
+    exec "$PROG" "${OBJS[@]}" "$@"
+    ]=])
+        string(CONFIGURE "${FUZZ_TX_DESER_LINK_WRAPPER_CONTENT}"
+               FUZZ_TX_DESER_LINK_WRAPPER_CONTENT @ONLY)
+        file(WRITE "${FUZZ_TX_DESER_LINK_WRAPPER}" "${FUZZ_TX_DESER_LINK_WRAPPER_CONTENT}")
+        file(CHMOD "${FUZZ_TX_DESER_LINK_WRAPPER}" PERMISSIONS
+            OWNER_READ OWNER_WRITE OWNER_EXECUTE
+            GROUP_READ GROUP_EXECUTE WORLD_READ WORLD_EXECUTE)
+    # Compile flags shared by both .cpp files. Pull in script.h, secp256k1,
+    # leveldb. Same flags gcc uses for triangles_common (the project defines
+    # HAVE_BUILD_INFO, LINUX, BOOST_THREAD_USE_LIB, etc.) so we don't hit
+    # redefinition errors when linking against the rest of triangles_common.
+    set(FUZZ_COMMON_FLAGS
+        -std=c++20 -g -O1
+        -fsanitize=fuzzer,address,undefined
+        -DHAVE_CONFIG_H
+        -DHAVE_BUILD_INFO
+        -DLINUX
+        -DUSE_IPV6=1
+        -DBOOST_SPIRIT_THREADSAFE
+        -DBOOST_THREAD_PROVIDES_GENERIC_SHARED_MUTEX_ON_WIN
+        -DBOOST_THREAD_USE_LIB
+        -DENABLE_TOR_EMBEDDED
+        -DENABLE_I2P_EMBEDDED
+        -DMINIUPNP_STATICLIB
+        -DSTATICLIB
+        -I${CMAKE_CURRENT_SOURCE_DIR}
+        -I${CMAKE_CURRENT_SOURCE_DIR}/secp256k1/include
+        -I${CMAKE_CURRENT_SOURCE_DIR}/leveldb/include
+        -Wno-unused-parameter
+        -Wno-deprecated-declarations
+    )
+
+    add_custom_command(
+        OUTPUT "${FUZZ_OBJ_SCRIPT_FUZZ}"
+        COMMAND ${CLANGXX} ${FUZZ_COMMON_FLAGS}
+                -c ${FUZZ_SRC_FUZZ} -o ${FUZZ_OBJ_SCRIPT_FUZZ}
+        DEPENDS ${FUZZ_SRC_FUZZ}
+        COMMENT "[fuzz] clang++ script_fuzz.cpp"
+        VERBATIM
+    )
+    add_custom_command(
+        OUTPUT "${FUZZ_OBJ_SCRIPT}"
+        COMMAND ${CLANGXX} ${FUZZ_COMMON_FLAGS}
+                -c ${FUZZ_SRC_SCRIPT} -o ${FUZZ_OBJ_SCRIPT}
+        DEPENDS ${FUZZ_SRC_SCRIPT}
+        COMMENT "[fuzz] clang++ script.cpp"
+        VERBATIM
+    )
+
+    # fuzz_stubs.cpp — satisfies globals owned by the excluded init.cpp that
+    # triangles_common and trianglesd_objects reference (pwalletMain,
+    # uiInterface, etc.). Keeping these as null/no-ops is the standard fuzzer
+    # pattern — see src/test/test_triangles.cpp and
+    # src/test/snapshotnet_tests.cpp for the same approach.
+    file(MAKE_DIRECTORY "${FUZZ_OBJ_DIR}")
+    file(WRITE "${FUZZ_FUZZ_STUBS_SRC}"
+"#include <memory>
+#include <set>
+#include <string>
+#include <vector>
+
+#include \"checkpoints.h\"
+#include \"key.h\"
+#include \"keystore.h\"
+#include \"script.h\"
+#include \"ui_interface.h\"
+#include \"wallet.h\"
+
+class CBlockIndex;
+
+bool fUseFastIndex = false;
+unsigned int nDerivationMethodIndex = 0;
+bool fEnforceCanonical = true;
+bool fConfChange = false;
+
+class CWalletStub : public CKeyStore
+{
+public:
+    bool GetPubKey(const CKeyID&, CPubKey&) const override { return false; }
+    bool GetKey(const CKeyID&, CKey&) const override { return false; }
+    bool HaveKey(const CKeyID&) const override { return false; }
+    void GetKeys(std::set<CKeyID>& setAddress) const override { setAddress.clear(); }
+    bool AddKey(const CKey&) override { return false; }
+    bool AddCScript(const CScript&) override { return false; }
+    bool HaveCScript(const CScriptID&) const override { return false; }
+    bool GetCScript(const CScriptID&, CScript&) const override { return false; }
+};
+static CWalletStub g_wallet_stub;
+CWallet* pwalletMain = nullptr;
+
+CClientUIInterface uiInterface;
+
+// Checkpoints::CPMode defined in checkpoints.h; default to ADVISORY so the
+// fuzz target never complains about the missing init.cpp value.
+enum Checkpoints::CPMode CheckpointsMode = Checkpoints::ADVISORY;
+
+// Defined in init.cpp; reasonable default so the fuzz link succeeds.
+unsigned int nNodeLifespan = 7;
+
+void StartShutdown() {}
+void MarkShutdownFailure() {}
+")
+
+    add_custom_command(
+        OUTPUT "${FUZZ_OBJ_FUZZ_STUBS}"
+        COMMAND ${CLANGXX} ${FUZZ_COMMON_FLAGS}
+                -c ${FUZZ_FUZZ_STUBS_SRC} -o ${FUZZ_OBJ_FUZZ_STUBS}
+        DEPENDS ${FUZZ_FUZZ_STUBS_SRC}
+        COMMENT "[fuzz] clang++ fuzz_stubs.cpp"
+        VERBATIM
+    )
+
+    # Link using the same library set as trianglesd, but:
+    #   - exclude script.cpp.o (we provide our own clang-instrumented one)
+    #   - swap gcc for clang++ with -fsanitize=fuzzer,address,undefined
+    #   - drop -Wl,-z,relro -Wl,-z,now (incompatible with sanitizer link)
+    # The triangles_common / trianglesd .o file lists are discovered at link
+    # time via the FUZZ_LINK_WRAPPER shell script (defined below). We do NOT
+    # use file(GLOB) here — it runs at configure time when no .o files exist
+    # on a fresh build dir, so the resulting list would always be empty.
+    # The wrapper script does the find at link time and exec's clang++.
+
+    # Build the link command. The triangles_common and trianglesd .o files
+    # are discovered at link time via shell `find` because file(GLOB) only
+    # runs at cmake configure time, when no .o files exist yet on a fresh
+    # build dir. We invoke a small shell wrapper script that does the find
+    # and exec's the link line with all .o files as args. We exclude
+    # script.cpp.o from the triangles_common dir so we don't pull our
+    # standalone copy of script.cpp in twice (we already have it in
+    # ${FUZZ_OBJ_SCRIPT}).
+    set(FUZZ_LINK_WRAPPER "${CMAKE_CURRENT_BINARY_DIR}/fuzz_objs/link.sh")
+    # The wrapper script is invoked with the full link arg list as its
+    # own argv. We pass it via ninja's COMMAND expansion with @{args}.
+    # Strategy: write a here-doc style wrapper that uses bash-style
+    # "$@" preservation. We use bash explicitly (not sh) for "$@" array
+    # semantics — paths may contain spaces, so word-splitting on IFS
+    # would corrupt them.
+    set(FUZZ_LINK_WRAPPER_CONTENT [=[#!/bin/bash
+# Auto-generated by CMake (BUILD_FUZZ block). Discovers triangles_common +
+# trianglesd .o files at link time and exec's the clang++ link line.
+#
+# Usage: link.sh clang++ [link-args...]
+# Final exec: clang++ <each .o> <each original link-arg>
+set -euo pipefail
+PROG="$1"
+shift
+TRIANGLES_COMMON_DIR="@CMAKE_CURRENT_BINARY_DIR@/CMakeFiles/triangles_common.dir"
+TRIANGLESD_DIR="@CMAKE_CURRENT_BINARY_DIR@/CMakeFiles/trianglesd_objects.dir"
+# Discover .o files into a bash array. Exclude script.cpp.o (we have our
+# own clang-instrumented copy in fuzz_objs/ that we want to keep separate
+# from the main build's copy).
+declare -a OBJS=()
+for f in "$TRIANGLES_COMMON_DIR"/*.o "$TRIANGLES_COMMON_DIR"/*/*.o; do
+    [ -f "$f" ] || continue
+    case "$f" in
+        */script.cpp.o) continue ;;
+    esac
+    OBJS+=("$f")
+done
+if [ -d "$TRIANGLESD_DIR" ]; then
+    for f in "$TRIANGLESD_DIR"/*.o; do
+        [ -f "$f" ] || continue
+        # init.cpp defines the daemon's main(); the fuzz harness has its own
+        # (libFuzzer's). wallet.cpp, noui.cpp etc. are safe — they don't
+        # define main and their external references (pwalletMain,
+        # uiInterface, nDerivationMethodIndex) are satisfied by the stub
+        # object file we add at the end of the link line.
+        case "$f" in
+            */init.cpp.o) continue ;;
+        esac
+        OBJS+=("$f")
+    done
+fi
+# Final arg list: PROG, then all .o files, then all original link args.
+exec "$PROG" "${OBJS[@]}" "$@"
+]=])
+    string(CONFIGURE "${FUZZ_LINK_WRAPPER_CONTENT}"
+           FUZZ_LINK_WRAPPER_CONTENT @ONLY)
+    file(WRITE "${FUZZ_LINK_WRAPPER}" "${FUZZ_LINK_WRAPPER_CONTENT}")
+    file(CHMOD "${FUZZ_LINK_WRAPPER}" PERMISSIONS
+        OWNER_READ OWNER_WRITE OWNER_EXECUTE
+        GROUP_READ GROUP_EXECUTE
+        WORLD_READ WORLD_EXECUTE)
+    set(FUZZ_LINK_CMD
+        "${CLANGXX}"
+        "-fsanitize=fuzzer,address,undefined"
+        "${FUZZ_OBJ_SCRIPT_FUZZ}"
+        "-o" "${FUZZ_BIN}"
+        "${FUZZ_OBJ_SCRIPT}"
+        "${FUZZ_OBJ_FUZZ_STUBS}"
+        "${CMAKE_BINARY_DIR}/lib/libhash9_crypto.a"
+        "${CMAKE_BINARY_DIR}/lib/libleveldb_memenv.a"
+        "${CMAKE_BINARY_DIR}/lib/libleveldb_lib.a"
+        "-lssl" "-lcrypto" "-ldb_cxx" "-levent" "-lsqlite3" "-lminiupnpc"
+        "${CMAKE_BINARY_DIR}/lib/libsecp256k1.a"
+        # RocksDB: build-rocksdb.sh installs librocksdb.so (currently
+        # librocksdb.so.10.10.1) to /usr/local on CI, or it comes from
+        # the distro package. The library search path picks up either
+        # /usr/local/lib or /usr/lib automatically, so a bare
+        # "-lrocksdb" works on both. The previous generator expression
+        # ($<IF:$<TARGET_EXISTS:RocksDB::rocksdb>,-lrocksdb,${ROCKSDB_LIBRARY}>)
+        # failed on CI because:
+        #   1. CMake's find_package(RocksDB CONFIG) does NOT find the .cmake
+        #      config RocksDB 10.10.1 ships, only the .pc file.
+        #   2. The pkg-config path exposes PkgConfig::RocksDB (NOT
+        #      RocksDB::rocksdb), so $<TARGET_EXISTS:RocksDB::rocksdb> is
+        #      FALSE.
+        #   3. The fallback ${ROCKSDB_LIBRARY} is only set inside the manual
+        #      find_library() probe at CMakeLists.txt:170-190, which is
+        #      skipped when EITHER target exists.
+        # Result on CI: an empty string landed in the link line, and the
+        # fuzz binary linked against every RocksDB symbol it referenced
+        # turned into "undefined reference" errors.
+        "-lrocksdb"
+        "-lz" "-lgflags" "-lsnappy" "-lbz2" "-llz4" "-lzstd"
+        # i2p is inlined into triangles_common as i2p_embedded.cpp.o and is a
+        # NO-OP when USE_I2P_EMBEDDED=OFF (which is the CI default; the
+        # workflow only builds libtor, not libi2pd). Do NOT link any
+        # src/i2p/i2pd-src/lib*.a here — those files are produced by a
+        # separate `make` step in src/i2p/build-libi2pd.sh that the fuzz
+        # job does NOT run, and clang aborts the link with
+        # "no such file or directory" when they're absent.
+        "${CMAKE_CURRENT_SOURCE_DIR}/tor/tor-src/libtor.a"
+        "-lpthread" "-llzma" "-lubsan"
+    )
+    # Boost target names need real paths on the link line; generator
+    # expressions don't get evaluated by the bash wrapper, so resolve
+    # the imported-target paths at configure time and append them.
+    foreach(_target Boost::program_options Boost::thread Boost::chrono
+                     Boost::atomic Boost::filesystem Boost::system)
+        if(TARGET "${_target}")
+            get_target_property(_path "${_target}" IMPORTED_LOCATION_RELEASE)
+            if(NOT _path)
+                get_target_property(_path "${_target}" IMPORTED_LOCATION)
+            endif()
+            if(_path AND EXISTS "${_path}")
+                list(APPEND FUZZ_LINK_CMD "${_path}")
+            endif()
+        endif()
+    endforeach()
+    # Invoke the link wrapper script, passing the actual link line as
+    # args. The wrapper script discovers .o files at link time via find
+    # (file(GLOB) would evaluate empty at configure time when no .o files
+    # exist yet on a fresh build dir) and exec's clang++ with all the
+    # discovered objects prepended to its arg list.
+    add_custom_command(
+        OUTPUT "${FUZZ_BIN}"
+        COMMAND "${FUZZ_LINK_WRAPPER}" ${FUZZ_LINK_CMD}
+        DEPENDS
+            "${FUZZ_OBJ_SCRIPT_FUZZ}"
+            "${FUZZ_OBJ_SCRIPT}"
+            "${FUZZ_OBJ_FUZZ_STUBS}"
+            "${FUZZ_LINK_WRAPPER}"
+            # Static libs the link line references at ${CMAKE_BINARY_DIR}/lib/.
+            # Without these deps, fuzz_script's link step races and fails with
+            # "no such file" errors on first clean build.
+            hash9_crypto
+            leveldb_lib
+            leveldb_memenv
+            secp256k1
+            # trianglesd_objects emits the daemon .o files (noui/init/wallet)
+            # that the link wrapper discovers via find. triangles_common emits
+            # the rest of the .o files we need. Without these deps the wrapper
+            # finds no .o files on first build → undefined references like
+            # CKey::GetPubKey.
+            trianglesd_objects
+            triangles_common
+        COMMENT "[fuzz] clang++ link fuzz_script"
+    )
+    add_custom_target(fuzz_script ALL DEPENDS "${FUZZ_BIN}")
+
+    # ==========================================================================
+    # transaction_deserialize_fuzz — second fuzz target
+    # ==========================================================================
+    # Compile the harness with clang + libFuzzer instrumentation. The harness
+    # only links against the already-instrumented triangles_common /
+    # trianglesd .o files (for CTransaction, CDataStream, etc.) — we do NOT
+    # compile a separate clang-instrumented copy of any .cpp file the way
+    # fuzz_script does for script.cpp.
+    #
+    # Uses its OWN link wrapper (link_txdeser.sh) because the fuzz_script
+    # wrapper excludes script.cpp.o from triangles_common (we replace it
+    # with our own clang-instrumented copy there). For transaction_deserialize
+    # we need script.cpp.o: wallet.cpp.o (in trianglesd_objects) calls
+    # ExtractDestination, SignSignature, Solver, IsMine — all defined in
+    # script.cpp.o. Excluding it produces "undefined reference" link errors.
+    # The new wrapper excludes only init.cpp.o (which defines daemon main()
+    # and would conflict with libFuzzer's main).
+    add_custom_command(
+        OUTPUT "${FUZZ_TX_DESER_OBJ}"
+        COMMAND ${CLANGXX} ${FUZZ_COMMON_FLAGS}
+                -c ${FUZZ_TX_DESER_SRC} -o ${FUZZ_TX_DESER_OBJ}
+        DEPENDS ${FUZZ_TX_DESER_SRC}
+        COMMENT "[fuzz] clang++ transaction_deserialize_fuzz.cpp"
+        VERBATIM
+    )
+
+    # Link command — same library set as fuzz_script, but no
+    # ${FUZZ_OBJ_SCRIPT} or ${FUZZ_OBJ_SCRIPT_FUZZ} (we didn't compile
+    # our own clang-instrumented copy). The wrapper script discovers
+    # .o files via find at link time.
+    set(FUZZ_TX_DESER_LINK_CMD
+        "${CLANGXX}"
+        "-fsanitize=fuzzer,address,undefined"
+        "${FUZZ_TX_DESER_OBJ}"
+        "-o" "${FUZZ_TX_DESER_BIN}"
+        "${FUZZ_OBJ_FUZZ_STUBS}"
+        "${CMAKE_BINARY_DIR}/lib/libhash9_crypto.a"
+        "${CMAKE_BINARY_DIR}/lib/libleveldb_memenv.a"
+        "${CMAKE_BINARY_DIR}/lib/libleveldb_lib.a"
+        "-lssl" "-lcrypto" "-ldb_cxx" "-levent" "-lsqlite3" "-lminiupnpc"
+        "${CMAKE_BINARY_DIR}/lib/libsecp256k1.a"
+        "-lrocksdb"
+        "-lz" "-lgflags" "-lsnappy" "-lbz2" "-llz4" "-lzstd"
+        "${CMAKE_CURRENT_SOURCE_DIR}/tor/tor-src/libtor.a"
+        "-lpthread" "-llzma" "-lubsan"
+    )
+    foreach(_target Boost::program_options Boost::thread Boost::chrono
+                     Boost::atomic Boost::filesystem Boost::system)
+        if(TARGET "${_target}")
+            get_target_property(_path "${_target}" IMPORTED_LOCATION_RELEASE)
+            if(NOT _path)
+                get_target_property(_path "${_target}" IMPORTED_LOCATION)
+            endif()
+            if(_path AND EXISTS "${_path}")
+                list(APPEND FUZZ_TX_DESER_LINK_CMD "${_path}")
+            endif()
+        endif()
+    endforeach()
+
+    add_custom_command(
+        OUTPUT "${FUZZ_TX_DESER_BIN}"
+        COMMAND "${FUZZ_TX_DESER_LINK_WRAPPER}" ${FUZZ_TX_DESER_LINK_CMD}
+        DEPENDS
+            "${FUZZ_TX_DESER_OBJ}"
+            "${FUZZ_OBJ_FUZZ_STUBS}"
+            "${FUZZ_TX_DESER_LINK_WRAPPER}"
+            hash9_crypto
+            leveldb_lib
+            leveldb_memenv
+            secp256k1
+            trianglesd_objects
+            triangles_common
+        COMMENT "[fuzz] clang++ link transaction_deserialize_fuzz"
+    )
+    add_custom_target(transaction_deserialize_fuzz ALL
+                      DEPENDS "${FUZZ_TX_DESER_BIN}")
+
+    message(STATUS "Fuzz targets enabled:")
+    message(STATUS "  ${FUZZ_BIN}")
+    message(STATUS "  ${FUZZ_TX_DESER_BIN}")
 endif()

src/allocators.h

@@ -9,6 +9,11 @@
 #include <string>
 #include <mutex>
 #include <map>
+// assert() is used in the LockedPageManager implementation below; include
+// explicitly so this header doesn't rely on transitive includes from
+// <mutex>/<map> (clang's stricter include resolution surfaces the missing
+// include even though gcc tolerates it via some other transitive path).
+#include <cassert>
 
 #ifdef WIN32
 #ifdef _WIN32_WINNT

src/base58.h

@@ -67,6 +67,8 @@ inline std::string EncodeBase58(const unsigned char* pbegin, const unsigned char
 // Encode a byte vector as a base58-encoded string
 inline std::string EncodeBase58(const std::vector<unsigned char>& vch)
 {
+    if (vch.empty())
+        return std::string();
     return EncodeBase58(&vch[0], &vch[0] + vch.size());
 }
 

src/bignum.h

@@ -14,6 +14,8 @@
 #include <openssl/opensslv.h>
 
 #include <algorithm>
+#include <cctype>
+#include <limits>
 #include <stdexcept>
 #include <vector>
 
@@ -69,16 +71,10 @@ public:
             throw bignum_error("CBigNum::CBigNum() : BN_new() returned NULL");
     }
 
-    CBigNum(const CBigNum& b)
+    CBigNum(const CBigNum& b) : CBigNum()
     {
-        pbn = BN_new();
-        if (pbn == nullptr)
-            throw bignum_error("CBigNum::CBigNum(const CBigNum&) : BN_new() returned NULL");
         if (!BN_copy(pbn, b.pbn))
-        {
-            BN_clear_free(pbn);
             throw bignum_error("CBigNum::CBigNum(const CBigNum&) : BN_copy failed");
-        }
     }
 
     CBigNum& operator=(const CBigNum& b)
@@ -99,21 +95,20 @@ public:
     const BIGNUM* get() const { return pbn; }
 
     //CBigNum(char n) is not portable.  Use 'signed char' or 'unsigned char'.
-    CBigNum(signed char n)        { pbn = BN_new(); if (n >= 0) setulong(n); else setint64(n); }
-    CBigNum(short n)              { pbn = BN_new(); if (n >= 0) setulong(n); else setint64(n); }
-    CBigNum(int n)                { pbn = BN_new(); if (n >= 0) setulong(n); else setint64(n); }
-    CBigNum(long n)               { pbn = BN_new(); if (n >= 0) setulong(n); else setint64(n); }
-    CBigNum(long long n)          { pbn = BN_new(); setint64(n); }
-    CBigNum(unsigned char n)      { pbn = BN_new(); setulong(n); }
-    CBigNum(unsigned short n)     { pbn = BN_new(); setulong(n); }
-    CBigNum(unsigned int n)       { pbn = BN_new(); setulong(n); }
-    CBigNum(unsigned long n)      { pbn = BN_new(); setulong(n); }
-    CBigNum(unsigned long long n) { pbn = BN_new(); setuint64(n); }
-    explicit CBigNum(uint256 n)   { pbn = BN_new(); setuint256(n); }
+    CBigNum(signed char n)        : CBigNum() { if (n >= 0) setulong(n); else setint64(n); }
+    CBigNum(short n)              : CBigNum() { if (n >= 0) setulong(n); else setint64(n); }
+    CBigNum(int n)                : CBigNum() { if (n >= 0) setulong(n); else setint64(n); }
+    CBigNum(long n)               : CBigNum() { if (n >= 0) setulong(n); else setint64(n); }
+    CBigNum(long long n)          : CBigNum() { setint64(n); }
+    CBigNum(unsigned char n)      : CBigNum() { setulong(n); }
+    CBigNum(unsigned short n)     : CBigNum() { setulong(n); }
+    CBigNum(unsigned int n)       : CBigNum() { setulong(n); }
+    CBigNum(unsigned long n)      : CBigNum() { setulong(n); }
+    CBigNum(unsigned long long n) : CBigNum() { setuint64(n); }
+    explicit CBigNum(uint256 n)   : CBigNum() { setuint256(n); }
 
-    explicit CBigNum(const std::vector<unsigned char>& vch)
+    explicit CBigNum(const std::vector<unsigned char>& vch) : CBigNum()
     {
-        pbn = BN_new();
         setvch(vch);
     }
 
@@ -216,21 +211,23 @@ public:
         pch[1] = (nSize >> 16) & 0xff;
         pch[2] = (nSize >> 8) & 0xff;
         pch[3] = (nSize) & 0xff;
-        BN_mpi2bn(pch, p - pch, pbn);
+        if (BN_mpi2bn(pch, static_cast<int>(p - pch), pbn) == nullptr)
+            throw bignum_error("CBigNum::setint64() : BN_mpi2bn failed");
     }
 
-    uint64_t getuint64()
+    uint64_t getuint64() const
     {
-        unsigned int nSize = BN_bn2mpi(pbn, nullptr);
-        if (nSize < 4)
+        const int nSize = BN_bn2mpi(pbn, nullptr);
+        if (nSize <= 4)
             return 0;
-        std::vector<unsigned char> vch(nSize);
-        BN_bn2mpi(pbn, &vch[0]);
+        std::vector<unsigned char> vch(static_cast<size_t>(nSize));
+        if (BN_bn2mpi(pbn, vch.data()) != nSize)
+            throw bignum_error("CBigNum::getuint64() : BN_bn2mpi failed");
         if (vch.size() > 4)
             vch[4] &= 0x7f;
         uint64_t n = 0;
-        for (unsigned int i = 0, j = vch.size()-1; i < sizeof(n) && j >= 4; i++, j--)
-            ((unsigned char*)&n)[i] = vch[j];
+        for (size_t i = 0; i < sizeof(n) && i + 4 < vch.size(); ++i)
+            n |= static_cast<uint64_t>(vch[vch.size() - 1 - i]) << (8 * i);
         return n;
     }
 
@@ -258,7 +255,8 @@ public:
         pch[1] = (nSize >> 16) & 0xff;
         pch[2] = (nSize >> 8) & 0xff;
         pch[3] = (nSize) & 0xff;
-        BN_mpi2bn(pch, p - pch, pbn);
+        if (BN_mpi2bn(pch, static_cast<int>(p - pch), pbn) == nullptr)
+            throw bignum_error("CBigNum::setuint64() : BN_mpi2bn failed");
     }
 
     void setuint256(uint256 n)
@@ -286,29 +284,33 @@ public:
         pch[1] = (nSize >> 16) & 0xff;
         pch[2] = (nSize >> 8) & 0xff;
         pch[3] = (nSize >> 0) & 0xff;
-        BN_mpi2bn(pch, p - pch, pbn);
+        if (BN_mpi2bn(pch, static_cast<int>(p - pch), pbn) == nullptr)
+            throw bignum_error("CBigNum::setuint256() : BN_mpi2bn failed");
     }
 
     uint256 getuint256() const
     {
-        unsigned int nSize = BN_bn2mpi(pbn, nullptr);
-        if (nSize < 4)
+        const int mpiSize = BN_bn2mpi(pbn, nullptr);
+        if (mpiSize <= 4)
             return 0;
-        std::vector<unsigned char> vch(nSize);
-        BN_bn2mpi(pbn, &vch[0]);
-        if (vch.size() > 4)
-            vch[4] &= 0x7f;
+        std::vector<unsigned char> vch(static_cast<size_t>(mpiSize));
+        if (BN_bn2mpi(pbn, vch.data()) != mpiSize)
+            throw bignum_error("CBigNum::getuint256() : BN_bn2mpi failed");
+        vch[4] &= 0x7f;
         uint256 n = 0;
-        for (unsigned int i = 0, j = vch.size()-1; i < sizeof(n) && j >= 4; i++, j--)
-            ((unsigned char*)&n)[i] = vch[j];
+        for (size_t i = 0; i < sizeof(n) && i + 4 < vch.size(); ++i)
+            reinterpret_cast<unsigned char*>(&n)[i] = vch[vch.size() - 1 - i];
         return n;
     }
 
 
     void setvch(const std::vector<unsigned char>& vch)
     {
+        if (vch.size() > static_cast<size_t>(std::numeric_limits<int>::max() - 4))
+            throw bignum_error("CBigNum::setvch() : input is too large");
+
         std::vector<unsigned char> vch2(vch.size() + 4);
-        unsigned int nSize = vch.size();
+        const uint32_t nSize = static_cast<uint32_t>(vch.size());
         // BIGNUM's byte stream format expects 4 bytes of
         // big endian size data info at the front
         vch2[0] = (nSize >> 24) & 0xff;
@@ -316,20 +318,25 @@ public:
         vch2[2] = (nSize >> 8) & 0xff;
         vch2[3] = (nSize >> 0) & 0xff;
         // swap data to big endian
-        reverse_copy(vch.begin(), vch.end(), vch2.begin() + 4);
-        BN_mpi2bn(&vch2[0], vch2.size(), pbn);
+        for (size_t i = 0; i < vch.size(); ++i)
+            vch2.at(i + 4) = vch.at(vch.size() - 1 - i);
+        if (BN_mpi2bn(vch2.data(), static_cast<int>(vch2.size()), pbn) == nullptr)
+            throw bignum_error("CBigNum::setvch() : BN_mpi2bn failed");
     }
 
     std::vector<unsigned char> getvch() const
     {
-        unsigned int nSize = BN_bn2mpi(pbn, nullptr);
-        if (nSize <= 4)
+        const int mpiSize = BN_bn2mpi(pbn, nullptr);
+        if (mpiSize <= 4)
             return std::vector<unsigned char>();
-        std::vector<unsigned char> vch(nSize);
-        BN_bn2mpi(pbn, &vch[0]);
-        vch.erase(vch.begin(), vch.begin() + 4);
-        reverse(vch.begin(), vch.end());
-        return vch;
+        std::vector<unsigned char> mpi(static_cast<size_t>(mpiSize));
+        if (BN_bn2mpi(pbn, mpi.data()) != mpiSize)
+            throw bignum_error("CBigNum::getvch() : BN_bn2mpi failed");
+
+        std::vector<unsigned char> result(static_cast<size_t>(mpiSize - 4));
+        for (size_t i = 0; i < result.size(); ++i)
+            result.at(i) = mpi.at(mpi.size() - 1 - i);
+        return result;
     }
 
     CBigNum& SetCompact(unsigned int nCompact)
@@ -340,16 +347,20 @@ public:
         if (nSize >= 1) vch[4] = (nCompact >> 16) & 0xff;
         if (nSize >= 2) vch[5] = (nCompact >> 8) & 0xff;
         if (nSize >= 3) vch[6] = (nCompact >> 0) & 0xff;
-        BN_mpi2bn(&vch[0], vch.size(), pbn);
+        if (BN_mpi2bn(vch.data(), static_cast<int>(vch.size()), pbn) == nullptr)
+            throw bignum_error("CBigNum::SetCompact() : BN_mpi2bn failed");
         return *this;
     }
 
     unsigned int GetCompact() const
     {
-        unsigned int nSize = BN_bn2mpi(pbn, nullptr);
-        std::vector<unsigned char> vch(nSize);
-        nSize -= 4;
-        BN_bn2mpi(pbn, &vch[0]);
+        const int mpiSize = BN_bn2mpi(pbn, nullptr);
+        if (mpiSize <= 4)
+            return 0;
+        std::vector<unsigned char> vch(static_cast<size_t>(mpiSize));
+        if (BN_bn2mpi(pbn, vch.data()) != mpiSize)
+            throw bignum_error("CBigNum::GetCompact() : BN_bn2mpi failed");
+        const unsigned int nSize = static_cast<unsigned int>(mpiSize - 4);
         unsigned int nCompact = nSize << 24;
         if (nSize >= 1) nCompact |= (vch[4] << 16);
         if (nSize >= 2) nCompact |= (vch[5] << 8);
@@ -361,7 +372,7 @@ public:
     {
         // skip 0x
         const char* psz = str.c_str();
-        while (isspace(*psz))
+        while (isspace(static_cast<unsigned char>(*psz)))
             psz++;
         bool fNegative = false;
         if (*psz == '-')
@@ -369,15 +380,15 @@ public:
             fNegative = true;
             psz++;
         }
-        if (psz[0] == '0' && tolower(psz[1]) == 'x')
+        if (psz[0] == '0' && tolower(static_cast<unsigned char>(psz[1])) == 'x')
             psz += 2;
-        while (isspace(*psz))
+        while (isspace(static_cast<unsigned char>(*psz)))
             psz++;
 
         // hex string to bignum
         static constexpr signed char phexdigit[256] = { 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,1,2,3,4,5,6,7,8,9,0,0,0,0,0,0, 0,0xa,0xb,0xc,0xd,0xe,0xf,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0xa,0xb,0xc,0xd,0xe,0xf,0,0,0,0,0,0,0,0,0 };
         *this = 0;
-        while (isxdigit(*psz))
+        while (isxdigit(static_cast<unsigned char>(*psz)))
         {
             *this <<= 4;
             int n = phexdigit[(unsigned char)*psz++];
@@ -389,6 +400,8 @@ public:
 
     std::string ToString(int nBase=10) const
     {
+        if (nBase < 2 || nBase > 16)
+            throw bignum_error("CBigNum::ToString() : base must be in [2, 16]");
         CAutoBN_CTX pctx;
         CBigNum bnBase = nBase;
         CBigNum bn0 = 0;

src/bip39_english.h

@@ -0,0 +1,263 @@
+// BIP39 English wordlist (2048 words, canonical). Auto-generated; do not edit.
+#ifndef TRIANGLES_BIP39_ENGLISH_H
+#define TRIANGLES_BIP39_ENGLISH_H
+static const char* const BIP39_WORDLIST_EN[2048] = {
+"abandon","ability","able","about","above","absent","absorb","abstract",
+"absurd","abuse","access","accident","account","accuse","achieve","acid",
+"acoustic","acquire","across","act","action","actor","actress","actual",
+"adapt","add","addict","address","adjust","admit","adult","advance",
+"advice","aerobic","affair","afford","afraid","again","age","agent",
+"agree","ahead","aim","air","airport","aisle","alarm","album",
+"alcohol","alert","alien","all","alley","allow","almost","alone",
+"alpha","already","also","alter","always","amateur","amazing","among",
+"amount","amused","analyst","anchor","ancient","anger","angle","angry",
+"animal","ankle","announce","annual","another","answer","antenna","antique",
+"anxiety","any","apart","apology","appear","apple","approve","april",
+"arch","arctic","area","arena","argue","arm","armed","armor",
+"army","around","arrange","arrest","arrive","arrow","art","artefact",
+"artist","artwork","ask","aspect","assault","asset","assist","assume",
+"asthma","athlete","atom","attack","attend","attitude","attract","auction",
+"audit","august","aunt","author","auto","autumn","average","avocado",
+"avoid","awake","aware","away","awesome","awful","awkward","axis",
+"baby","bachelor","bacon","badge","bag","balance","balcony","ball",
+"bamboo","banana","banner","bar","barely","bargain","barrel","base",
+"basic","basket","battle","beach","bean","beauty","because","become",
+"beef","before","begin","behave","behind","believe","below","belt",
+"bench","benefit","best","betray","better","between","beyond","bicycle",
+"bid","bike","bind","biology","bird","birth","bitter","black",
+"blade","blame","blanket","blast","bleak","bless","blind","blood",
+"blossom","blouse","blue","blur","blush","board","boat","body",
+"boil","bomb","bone","bonus","book","boost","border","boring",
+"borrow","boss","bottom","bounce","box","boy","bracket","brain",
+"brand","brass","brave","bread","breeze","brick","bridge","brief",
+"bright","bring","brisk","broccoli","broken","bronze","broom","brother",
+"brown","brush","bubble","buddy","budget","buffalo","build","bulb",
+"bulk","bullet","bundle","bunker","burden","burger","burst","bus",
+"business","busy","butter","buyer","buzz","cabbage","cabin","cable",
+"cactus","cage","cake","call","calm","camera","camp","can",
+"canal","cancel","candy","cannon","canoe","canvas","canyon","capable",
+"capital","captain","car","carbon","card","cargo","carpet","carry",
+"cart","case","cash","casino","castle","casual","cat","catalog",
+"catch","category","cattle","caught","cause","caution","cave","ceiling",
+"celery","cement","census","century","cereal","certain","chair","chalk",
+"champion","change","chaos","chapter","charge","chase","chat","cheap",
+"check","cheese","chef","cherry","chest","chicken","chief","child",
+"chimney","choice","choose","chronic","chuckle","chunk","churn","cigar",
+"cinnamon","circle","citizen","city","civil","claim","clap","clarify",
+"claw","clay","clean","clerk","clever","click","client","cliff",
+"climb","clinic","clip","clock","clog","close","cloth","cloud",
+"clown","club","clump","cluster","clutch","coach","coast","coconut",
+"code","coffee","coil","coin","collect","color","column","combine",
+"come","comfort","comic","common","company","concert","conduct","confirm",
+"congress","connect","consider","control","convince","cook","cool","copper",
+"copy","coral","core","corn","correct","cost","cotton","couch",
+"country","couple","course","cousin","cover","coyote","crack","cradle",
+"craft","cram","crane","crash","crater","crawl","crazy","cream",
+"credit","creek","crew","cricket","crime","crisp","critic","crop",
+"cross","crouch","crowd","crucial","cruel","cruise","crumble","crunch",
+"crush","cry","crystal","cube","culture","cup","cupboard","curious",
+"current","curtain","curve","cushion","custom","cute","cycle","dad",
+"damage","damp","dance","danger","daring","dash","daughter","dawn",
+"day","deal","debate","debris","decade","december","decide","decline",
+"decorate","decrease","deer","defense","define","defy","degree","delay",
+"deliver","demand","demise","denial","dentist","deny","depart","depend",
+"deposit","depth","deputy","derive","describe","desert","design","desk",
+"despair","destroy","detail","detect","develop","device","devote","diagram",
+"dial","diamond","diary","dice","diesel","diet","differ","digital",
+"dignity","dilemma","dinner","dinosaur","direct","dirt","disagree","discover",
+"disease","dish","dismiss","disorder","display","distance","divert","divide",
+"divorce","dizzy","doctor","document","dog","doll","dolphin","domain",
+"donate","donkey","donor","door","dose","double","dove","draft",
+"dragon","drama","drastic","draw","dream","dress","drift","drill",
+"drink","drip","drive","drop","drum","dry","duck","dumb",
+"dune","during","dust","dutch","duty","dwarf","dynamic","eager",
+"eagle","early","earn","earth","easily","east","easy","echo",
+"ecology","economy","edge","edit","educate","effort","egg","eight",
+"either","elbow","elder","electric","elegant","element","elephant","elevator",
+"elite","else","embark","embody","embrace","emerge","emotion","employ",
+"empower","empty","enable","enact","end","endless","endorse","enemy",
+"energy","enforce","engage","engine","enhance","enjoy","enlist","enough",
+"enrich","enroll","ensure","enter","entire","entry","envelope","episode",
+"equal","equip","era","erase","erode","erosion","error","erupt",
+"escape","essay","essence","estate","eternal","ethics","evidence","evil",
+"evoke","evolve","exact","example","excess","exchange","excite","exclude",
+"excuse","execute","exercise","exhaust","exhibit","exile","exist","exit",
+"exotic","expand","expect","expire","explain","expose","express","extend",
+"extra","eye","eyebrow","fabric","face","faculty","fade","faint",
+"faith","fall","false","fame","family","famous","fan","fancy",
+"fantasy","farm","fashion","fat","fatal","father","fatigue","fault",
+"favorite","feature","february","federal","fee","feed","feel","female",
+"fence","festival","fetch","fever","few","fiber","fiction","field",
+"figure","file","film","filter","final","find","fine","finger",
+"finish","fire","firm","first","fiscal","fish","fit","fitness",
+"fix","flag","flame","flash","flat","flavor","flee","flight",
+"flip","float","flock","floor","flower","fluid","flush","fly",
+"foam","focus","fog","foil","fold","follow","food","foot",
+"force","forest","forget","fork","fortune","forum","forward","fossil",
+"foster","found","fox","fragile","frame","frequent","fresh","friend",
+"fringe","frog","front","frost","frown","frozen","fruit","fuel",
+"fun","funny","furnace","fury","future","gadget","gain","galaxy",
+"gallery","game","gap","garage","garbage","garden","garlic","garment",
+"gas","gasp","gate","gather","gauge","gaze","general","genius",
+"genre","gentle","genuine","gesture","ghost","giant","gift","giggle",
+"ginger","giraffe","girl","give","glad","glance","glare","glass",
+"glide","glimpse","globe","gloom","glory","glove","glow","glue",
+"goat","goddess","gold","good","goose","gorilla","gospel","gossip",
+"govern","gown","grab","grace","grain","grant","grape","grass",
+"gravity","great","green","grid","grief","grit","grocery","group",
+"grow","grunt","guard","guess","guide","guilt","guitar","gun",
+"gym","habit","hair","half","hammer","hamster","hand","happy",
+"harbor","hard","harsh","harvest","hat","have","hawk","hazard",
+"head","health","heart","heavy","hedgehog","height","hello","helmet",
+"help","hen","hero","hidden","high","hill","hint","hip",
+"hire","history","hobby","hockey","hold","hole","holiday","hollow",
+"home","honey","hood","hope","horn","horror","horse","hospital",
+"host","hotel","hour","hover","hub","huge","human","humble",
+"humor","hundred","hungry","hunt","hurdle","hurry","hurt","husband",
+"hybrid","ice","icon","idea","identify","idle","ignore","ill",
+"illegal","illness","image","imitate","immense","immune","impact","impose",
+"improve","impulse","inch","include","income","increase","index","indicate",
+"indoor","industry","infant","inflict","inform","inhale","inherit","initial",
+"inject","injury","inmate","inner","innocent","input","inquiry","insane",
+"insect","inside","inspire","install","intact","interest","into","invest",
+"invite","involve","iron","island","isolate","issue","item","ivory",
+"jacket","jaguar","jar","jazz","jealous","jeans","jelly","jewel",
+"job","join","joke","journey","joy","judge","juice","jump",
+"jungle","junior","junk","just","kangaroo","keen","keep","ketchup",
+"key","kick","kid","kidney","kind","kingdom","kiss","kit",
+"kitchen","kite","kitten","kiwi","knee","knife","knock","know",
+"lab","label","labor","ladder","lady","lake","lamp","language",
+"laptop","large","later","latin","laugh","laundry","lava","law",
+"lawn","lawsuit","layer","lazy","leader","leaf","learn","leave",
+"lecture","left","leg","legal","legend","leisure","lemon","lend",
+"length","lens","leopard","lesson","letter","level","liar","liberty",
+"library","license","life","lift","light","like","limb","limit",
+"link","lion","liquid","list","little","live","lizard","load",
+"loan","lobster","local","lock","logic","lonely","long","loop",
+"lottery","loud","lounge","love","loyal","lucky","luggage","lumber",
+"lunar","lunch","luxury","lyrics","machine","mad","magic","magnet",
+"maid","mail","main","major","make","mammal","man","manage",
+"mandate","mango","mansion","manual","maple","marble","march","margin",
+"marine","market","marriage","mask","mass","master","match","material",
+"math","matrix","matter","maximum","maze","meadow","mean","measure",
+"meat","mechanic","medal","media","melody","melt","member","memory",
+"mention","menu","mercy","merge","merit","merry","mesh","message",
+"metal","method","middle","midnight","milk","million","mimic","mind",
+"minimum","minor","minute","miracle","mirror","misery","miss","mistake",
+"mix","mixed","mixture","mobile","model","modify","mom","moment",
+"monitor","monkey","monster","month","moon","moral","more","morning",
+"mosquito","mother","motion","motor","mountain","mouse","move","movie",
+"much","muffin","mule","multiply","muscle","museum","mushroom","music",
+"must","mutual","myself","mystery","myth","naive","name","napkin",
+"narrow","nasty","nation","nature","near","neck","need","negative",
+"neglect","neither","nephew","nerve","nest","net","network","neutral",
+"never","news","next","nice","night","noble","noise","nominee",
+"noodle","normal","north","nose","notable","note","nothing","notice",
+"novel","now","nuclear","number","nurse","nut","oak","obey",
+"object","oblige","obscure","observe","obtain","obvious","occur","ocean",
+"october","odor","off","offer","office","often","oil","okay",
+"old","olive","olympic","omit","once","one","onion","online",
+"only","open","opera","opinion","oppose","option","orange","orbit",
+"orchard","order","ordinary","organ","orient","original","orphan","ostrich",
+"other","outdoor","outer","output","outside","oval","oven","over",
+"own","owner","oxygen","oyster","ozone","pact","paddle","page",
+"pair","palace","palm","panda","panel","panic","panther","paper",
+"parade","parent","park","parrot","party","pass","patch","path",
+"patient","patrol","pattern","pause","pave","payment","peace","peanut",
+"pear","peasant","pelican","pen","penalty","pencil","people","pepper",
+"perfect","permit","person","pet","phone","photo","phrase","physical",
+"piano","picnic","picture","piece","pig","pigeon","pill","pilot",
+"pink","pioneer","pipe","pistol","pitch","pizza","place","planet",
+"plastic","plate","play","please","pledge","pluck","plug","plunge",
+"poem","poet","point","polar","pole","police","pond","pony",
+"pool","popular","portion","position","possible","post","potato","pottery",
+"poverty","powder","power","practice","praise","predict","prefer","prepare",
+"present","pretty","prevent","price","pride","primary","print","priority",
+"prison","private","prize","problem","process","produce","profit","program",
+"project","promote","proof","property","prosper","protect","proud","provide",
+"public","pudding","pull","pulp","pulse","pumpkin","punch","pupil",
+"puppy","purchase","purity","purpose","purse","push","put","puzzle",
+"pyramid","quality","quantum","quarter","question","quick","quit","quiz",
+"quote","rabbit","raccoon","race","rack","radar","radio","rail",
+"rain","raise","rally","ramp","ranch","random","range","rapid",
+"rare","rate","rather","raven","raw","razor","ready","real",
+"reason","rebel","rebuild","recall","receive","recipe","record","recycle",
+"reduce","reflect","reform","refuse","region","regret","regular","reject",
+"relax","release","relief","rely","remain","remember","remind","remove",
+"render","renew","rent","reopen","repair","repeat","replace","report",
+"require","rescue","resemble","resist","resource","response","result","retire",
+"retreat","return","reunion","reveal","review","reward","rhythm","rib",
+"ribbon","rice","rich","ride","ridge","rifle","right","rigid",
+"ring","riot","ripple","risk","ritual","rival","river","road",
+"roast","robot","robust","rocket","romance","roof","rookie","room",
+"rose","rotate","rough","round","route","royal","rubber","rude",
+"rug","rule","run","runway","rural","sad","saddle","sadness",
+"safe","sail","salad","salmon","salon","salt","salute","same",
+"sample","sand","satisfy","satoshi","sauce","sausage","save","say",
+"scale","scan","scare","scatter","scene","scheme","school","science",
+"scissors","scorpion","scout","scrap","screen","script","scrub","sea",
+"search","season","seat","second","secret","section","security","seed",
+"seek","segment","select","sell","seminar","senior","sense","sentence",
+"series","service","session","settle","setup","seven","shadow","shaft",
+"shallow","share","shed","shell","sheriff","shield","shift","shine",
+"ship","shiver","shock","shoe","shoot","shop","short","shoulder",
+"shove","shrimp","shrug","shuffle","shy","sibling","sick","side",
+"siege","sight","sign","silent","silk","silly","silver","similar",
+"simple","since","sing","siren","sister","situate","six","size",
+"skate","sketch","ski","skill","skin","skirt","skull","slab",
+"slam","sleep","slender","slice","slide","slight","slim","slogan",
+"slot","slow","slush","small","smart","smile","smoke","smooth",
+"snack","snake","snap","sniff","snow","soap","soccer","social",
+"sock","soda","soft","solar","soldier","solid","solution","solve",
+"someone","song","soon","sorry","sort","soul","sound","soup",
+"source","south","space","spare","spatial","spawn","speak","special",
+"speed","spell","spend","sphere","spice","spider","spike","spin",
+"spirit","split","spoil","sponsor","spoon","sport","spot","spray",
+"spread","spring","spy","square","squeeze","squirrel","stable","stadium",
+"staff","stage","stairs","stamp","stand","start","state","stay",
+"steak","steel","stem","step","stereo","stick","still","sting",
+"stock","stomach","stone","stool","story","stove","strategy","street",
+"strike","strong","struggle","student","stuff","stumble","style","subject",
+"submit","subway","success","such","sudden","suffer","sugar","suggest",
+"suit","summer","sun","sunny","sunset","super","supply","supreme",
+"sure","surface","surge","surprise","surround","survey","suspect","sustain",
+"swallow","swamp","swap","swarm","swear","sweet","swift","swim",
+"swing","switch","sword","symbol","symptom","syrup","system","table",
+"tackle","tag","tail","talent","talk","tank","tape","target",
+"task","taste","tattoo","taxi","teach","team","tell","ten",
+"tenant","tennis","tent","term","test","text","thank","that",
+"theme","then","theory","there","they","thing","this","thought",
+"three","thrive","throw","thumb","thunder","ticket","tide","tiger",
+"tilt","timber","time","tiny","tip","tired","tissue","title",
+"toast","tobacco","today","toddler","toe","together","toilet","token",
+"tomato","tomorrow","tone","tongue","tonight","tool","tooth","top",
+"topic","topple","torch","tornado","tortoise","toss","total","tourist",
+"toward","tower","town","toy","track","trade","traffic","tragic",
+"train","transfer","trap","trash","travel","tray","treat","tree",
+"trend","trial","tribe","trick","trigger","trim","trip","trophy",
+"trouble","truck","true","truly","trumpet","trust","truth","try",
+"tube","tuition","tumble","tuna","tunnel","turkey","turn","turtle",
+"twelve","twenty","twice","twin","twist","two","type","typical",
+"ugly","umbrella","unable","unaware","uncle","uncover","under","undo",
+"unfair","unfold","unhappy","uniform","unique","unit","universe","unknown",
+"unlock","until","unusual","unveil","update","upgrade","uphold","upon",
+"upper","upset","urban","urge","usage","use","used","useful",
+"useless","usual","utility","vacant","vacuum","vague","valid","valley",
+"valve","van","vanish","vapor","various","vast","vault","vehicle",
+"velvet","vendor","venture","venue","verb","verify","version","very",
+"vessel","veteran","viable","vibrant","vicious","victory","video","view",
+"village","vintage","violin","virtual","virus","visa","visit","visual",
+"vital","vivid","vocal","voice","void","volcano","volume","vote",
+"voyage","wage","wagon","wait","walk","wall","walnut","want",
+"warfare","warm","warrior","wash","wasp","waste","water","wave",
+"way","wealth","weapon","wear","weasel","weather","web","wedding",
+"weekend","weird","welcome","west","wet","whale","what","wheat",
+"wheel","when","where","whip","whisper","wide","width","wife",
+"wild","will","win","window","wine","wing","wink","winner",
+"winter","wire","wisdom","wise","wish","witness","wolf","woman",
+"wonder","wood","wool","word","work","world","worry","worth",
+"wrap","wreck","wrestle","wrist","write","wrong","yard","year",
+"yellow","you","young","youth","zebra","zero","zone","zoo",
+
+};
+#endif

src/bootstrap.h

@@ -8,13 +8,14 @@
 #include <vector>
 #include <functional>
 #include <filesystem>
+#include <cstdint>
 
 namespace Bootstrap {
 
     // Bootstrap server configuration
-    static const char* DEFAULT_HOST = "bootstrap.cryptographic-triangles.org";
-    static const char* BASE_PATH = "/";
-    static const int PORT = 80;
+    inline constexpr const char* DEFAULT_HOST = "bootstrap.cryptographic-triangles.org";
+    inline constexpr const char* BASE_PATH = "/";
+    inline constexpr int PORT = 443;
 
     // Progress callback: (bytesDownloaded, totalBytes)
     typedef std::function<void(int64_t, int64_t)> ProgressCallback;
@@ -22,7 +23,7 @@ namespace Bootstrap {
     // Check if data dir already has blockchain data
     bool NeedsBootstrap(const std::filesystem::path& dataDir);
 
-    // Download a single file via HTTP GET, write to destPath.
+    // Download a file via HTTP GET, write to destPath.
     // If noProxy is true, bypass Tor SOCKS proxy and connect directly
     // (used for clearnet bootstrap downloads).
     // If portOverride is set (>0), uses that port instead of the default PORT.
@@ -31,38 +32,25 @@ namespace Bootstrap {
                       ProgressCallback progressFn,
                       std::string& strError,
                       bool noProxy = false,
-                      int portOverride = -1);
+                      int portOverride = -1,
+                      int64_t maxDownloadBytes = 4LL * 1024 * 1024 * 1024);
 
-    // Fetch the file manifest (list of relative paths to download)
-    bool FetchFileList(const std::string& host,
-                       std::vector<std::string>& files,
-                       std::string& strError,
-                       bool noProxy = false);
-
-    // Download bootstrap.tar.gz and extract to dataDir.
-    // Falls back to filelist.txt + individual file download if tar.gz unavailable.
-    bool DownloadBootstrap(const std::string& host,
-                           const std::filesystem::path& dataDir,
-                           ProgressCallback progressFn,
-                           std::string& strError);
-
-    // Snapshot manifest (parsed from snapshot.manifest in bootstrap archive)
-    struct SnapshotManifest {
-        int format;            // format version, must be 1
-        std::string network;   // "main" or "test"
-        int height;            // block height of the snapshot tip
-        std::string hash;      // block hash at that height (hex, no 0x prefix)
-        int dbversion;         // DATABASE_VERSION the txleveldb was built with
+    // Advertised identity of a snapshot listed by manifest.json.
+    // The advertised SHA256 is accepted only when it matches the hash compiled
+    // into checkpoints.cpp for the same height.
+    struct RemoteSnapshot {
+        std::string filename;
+        std::string sha256;
+        int height;
+        std::string blockHash;
     };
 
-    // Parse a snapshot.manifest file into a SnapshotManifest struct.
-    bool ParseManifest(const std::filesystem::path& manifestPath,
-                       SnapshotManifest& manifest,
-                       std::string& strError);
-
-    // Verify a parsed manifest against compiled-in checkpoints and config.
-    bool VerifyManifest(const SnapshotManifest& manifest,
-                        std::string& strError);
+    // Parse and validate the small, untrusted bootstrap manifest. This routine
+    // performs no network I/O and is exposed so malformed-input behavior can
+    // be covered by unit tests.
+    bool ParseRemoteSnapshotManifest(const std::string& manifestText,
+                                     RemoteSnapshot& snapshot,
+                                     std::string& strError);
 
     // Download a UTXO snapshot and load it into a fresh txleveldb.
     // This is much faster than downloading the full bootstrap archive.

src/bootstrap_roots.h

@@ -0,0 +1,67 @@
+// Copyright (c) 2024-2026 Triangles developers
+// Distributed under the MIT/X11 software license
+//
+// Embedded trust anchors for HTTPS bootstrap. Added to the X509 store as
+// belt-and-suspenders regardless of which other trust source succeeded:
+// the exedir cacert.pem, SSL_CERT_FILE, or system default paths may or
+// may not contain the specific Let's Encrypt anchor that signed the
+// current bootstrap server's certificate chain. Adding these anchors
+// only ever EXPANDS the set of valid chains (it can never cause a
+// previously-valid cert to be rejected), so it's safe to layer on top
+// of any operator-supplied bundle.
+//
+// These are the Mozilla CA bundle entries for ISRG Root X1 and X2 — the
+// anchors Let's Encrypt uses to sign every certificate they currently issue
+// (R10/R11/R12 intermediates chain to X1; the YE1 intermediate chains to X2).
+// Sourced from https://curl.se/ca/cacert.pem and verified via SHA-256 against
+// the Mozilla NSS bundle.
+//
+// Last verified: 2026-08-06 (cacert.pem snapshot).
+#ifndef TRIANGLES_BOOTSTRAP_ROOTS_H
+#define TRIANGLES_BOOTSTRAP_ROOTS_H
+
+const char* const EMBEDDED_ISRG_ROOT_X1_PEM =
+"-----BEGIN CERTIFICATE-----\n"
+"MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAwTzELMAkGA1UE\n"
+"BhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2VhcmNoIEdyb3VwMRUwEwYDVQQD\n"
+"EwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQG\n"
+"EwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMT\n"
+"DElTUkcgUm9vdCBYMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54r\n"
+"Vygch77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+0TM8ukj1\n"
+"3Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6UA5/TR5d8mUgjU+g4rk8K\n"
+"b4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sWT8KOEUt+zwvo/7V3LvSye0rgTBIlDHCN\n"
+"Aymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyHB5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ\n"
+"4Q7e2RCOFvu396j3x+UCB5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf\n"
+"1b0SHzUvKBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWnOlFu\n"
+"hjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTnjh8BCNAw1FtxNrQH\n"
+"usEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbwqHyGO0aoSCqI3Haadr8faqU9GY/r\n"
+"OPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CIrU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4G\n"
+"A1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY\n"
+"9umbbjANBgkqhkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL\n"
+"ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ3BebYhtF8GaV\n"
+"0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KKNFtY2PwByVS5uCbMiogziUwt\n"
+"hDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJw\n"
+"TdwJx4nLCgdNbOhdjsnvzqvHu7UrTkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nx\n"
+"e5AW0wdeRlN8NwdCjNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZA\n"
+"JzVcoyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq4RgqsahD\n"
+"YVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPAmRGunUHBcnWEvgJBQl9n\n"
+"JEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57demyPxgcYxn/eR44/KJ4EBs+lVDR3veyJ\n"
+"m+kXQ99b21/+jh5Xos1AnX5iItreGCc=\n"
+"-----END CERTIFICATE-----";
+
+const char* const EMBEDDED_ISRG_ROOT_X2_PEM =
+"-----BEGIN CERTIFICATE-----\n"
+"MIICGzCCAaGgAwIBAgIQQdKd0XLq7qeAwSxs6S+HUjAKBggqhkjOPQQDAzBPMQswCQYDVQQGEwJV\n"
+"UzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElT\n"
+"UkcgUm9vdCBYMjAeFw0yMDA5MDQwMDAwMDBaFw00MDA5MTcxNjAwMDBaME8xCzAJBgNVBAYTAlVT\n"
+"MSkwJwYDVQQKEyBJbnRlcm5ldCBTZWN1cml0eSBSZXNlYXJjaCBHcm91cDEVMBMGA1UEAxMMSVNS\n"
+"RyBSb290IFgyMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEzZvVn4CDCuwJSvMWSj5cz3es3mcFDR0H\n"
+"ttwW+1qLFNvicWDEukWVEYmO6gbf9yoWHKS5xcUy4APgHoIYOIvXRdgKam7mAHf7AlF9ItgKbppb\n"
+"d9/w+kHsOdx1ymgHDB/qo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV\n"
+"HQ4EFgQUfEKWrt5LSDv6kviejM9ti6lyN5UwCgYIKoZIzj0EAwMDaAAwZQIwe3lORlCEwkSHRhtF\n"
+"cP9Ymd70/aTSVaYgLXTWNLxBo1BfASdWtL4ndQavEi51mI38AjEAi/V3bNTIZargCyzuFJ0nN6T5\n"
+"U6VR5CmD1/iQMVtCnwr1/q4AaOeMSQ+2b1tbFfLn\n"
+"-----END CERTIFICATE-----";
+
+
+#endif // TRIANGLES_BOOTSTRAP_ROOTS_H

src/chaindb_migrate.cpp

@@ -109,6 +109,13 @@ bool MaybeMigrateLevelDbToRocksDb(bool fForce, std::string& strError)
         {
             std::ofstream marker(markerPath);
             marker << "RocksDB migration in progress. Safe to delete this directory and retry.\n";
+            marker.flush();
+            if (!marker.good()) {
+                // Without the marker a crashed migration would be
+                // indistinguishable from a complete one — refuse to start.
+                strError = "could not write migration marker " + markerPath.string();
+                return false;
+            }
         }
 
         CTxDB source("r");
@@ -129,34 +136,48 @@ bool MaybeMigrateLevelDbToRocksDb(bool fForce, std::string& strError)
         }
 
         int64_t nCopied = 0;
-        auto it = source.NewIterator();
-        for (it->Seek(std::string()); it->Valid(); it->Next())
+        bool fCopyOK = true;
         {
-            if (!destination.WriteRawRecordForMigration(it->KeyStr(), it->ValueStr())) {
-                destination.TxnAbort();
-                strError = "failed to write migrated record to RocksDB";
-                source.Close();
-                destination.Close();
-                return false;
-            }
-
-            if (++nCopied % 100000 == 0)
+            // W2 root cause: this iterator MUST be destroyed before
+            // source.Close(). Live LevelDB iterators hold a reference to the
+            // current Version; deleting the DB with one outstanding trips
+            // `dummy_versions_.next_ == &dummy_versions_` in
+            // leveldb::VersionSet::~VersionSet (version_set.cc:755) and
+            // aborts the daemon AFTER verification but BEFORE the marker is
+            // removed — which is what produced the original H4 symptom.
+            // Scoping the iterator here guarantees every Close() below runs
+            // with it already dead, on the success AND error paths.
+            auto it = source.NewIterator();
+            for (it->Seek(std::string()); it->Valid(); it->Next())
             {
-                if (!destination.TxnCommit()) {
-                    strError = "failed to commit RocksDB migration batch";
-                    source.Close();
-                    destination.Close();
-                    return false;
+                if (!destination.WriteRawRecordForMigration(it->KeyStr(), it->ValueStr())) {
+                    strError = "failed to write migrated record to RocksDB";
+                    fCopyOK = false;
+                    break;
                 }
-                printf("ChainDB migration: copied %lld / %lld records\n",
-                       (long long)nCopied, (long long)srcStats.nRecords);
-                if (!destination.TxnBegin()) {
-                    strError = "failed to begin RocksDB migration batch";
-                    source.Close();
-                    destination.Close();
-                    return false;
+
+                if (++nCopied % 100000 == 0)
+                {
+                    if (!destination.TxnCommit()) {
+                        strError = "failed to commit RocksDB migration batch";
+                        fCopyOK = false;
+                        break;
+                    }
+                    printf("ChainDB migration: copied %lld / %lld records\n",
+                           (long long)nCopied, (long long)srcStats.nRecords);
+                    if (!destination.TxnBegin()) {
+                        strError = "failed to begin RocksDB migration batch";
+                        fCopyOK = false;
+                        break;
+                    }
                 }
             }
+        } // iterator destroyed here — before any Close()
+        if (!fCopyOK) {
+            destination.TxnAbort(); // safe no-op if the batch was already consumed
+            source.Close();
+            destination.Close();
+            return false;
         }
 
         if (!destination.TxnCommit()) {
@@ -185,7 +206,49 @@ bool MaybeMigrateLevelDbToRocksDb(bool fForce, std::string& strError)
 
         source.Close();
         destination.Close();
-        fs::remove(markerPath);
+
+        // H4: Marker removal must be verified, not assumed. The previous
+        // implementation called fs::remove() and ignored the return code, which
+        // silently left the marker on disk after a successful migration. On
+        // the next startup init.cpp's fCrashedMigration check would then
+        // trigger a re-migration of the (already-good) RocksDB on every
+        // restart, eventually destroying the chain state.
+        //
+        // Three defenses:
+        //   1. Use the non-throwing error_code overload so a permission
+        //      error doesn't propagate as an uncaught exception.
+        //   2. After remove(), confirm the file is actually gone. fs::remove
+        //      returns true if the file didn't exist, which is also success
+        //      but worth distinguishing.
+        //   3. Retry once with a short delay. On Windows, antivirus and
+        //      indexer handles can transiently hold the marker file open
+        //      even after our process closed it; a single retry usually
+        //      wins. If the second attempt also leaves the file, treat the
+        //      migration as FAILED — surface the error to the operator
+        //      instead of letting init.cpp's fCrashedMigration logic
+        //      destroy working data on the next startup.
+        {
+            std::error_code ec;
+            fs::remove(markerPath, ec);
+            if (ec) {
+                strError = "could not remove migration marker " + markerPath.string() +
+                           ": " + ec.message();
+                return false;
+            }
+            if (fs::exists(markerPath)) {
+                // Retry once — handles Windows AV/indexer transient locks.
+                MilliSleep(100);
+                std::error_code ec2;
+                fs::remove(markerPath, ec2);
+                if (ec2 || fs::exists(markerPath)) {
+                    strError = "migration marker " + markerPath.string() +
+                               " could not be removed after retry; refusing to leave it on disk " +
+                               "(would trigger re-migration on next startup). " +
+                               std::string(ec2 ? ec2.message().c_str() : "");
+                    return false;
+                }
+            }
+        }
     }
     catch (std::exception& e) {
         strError = e.what();

src/checkpointpublisher.cpp

@@ -0,0 +1,474 @@
+// Copyright (c) 2026 The Triangles developers
+// Distributed under the MIT/X11 software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+//
+// Signed Checkpoint Publisher (Triangles v5.9.24) — implementation.
+//
+// See checkpointpublisher.h for the design. This file holds:
+//   - The in-memory signed-checkpoint cache (a CCriticalSection-guarded
+//     std::map keyed by height; values are block hashes)
+//   - The canonical serialization used by both producer and consumer
+//   - The JSON parsing/building helpers (small subset, no third-party deps)
+//   - The trusted signers list (mirrors IsTrustedSnapshotSigner)
+
+#include "checkpointpublisher.h"
+
+#include <algorithm>
+#include <cstdio>
+#include <map>
+#include <set>
+#include <sstream>
+#include <vector>
+
+#include "sync.h"
+#include "util.h"
+#include "base58.h"
+#include "key.h"
+#include "serialize.h"
+#include "net.h"          // for CCriticalSection
+#include "main.h"         // for strMessageMagic
+#include "bootstrap.h"    // for Bootstrap::DownloadFile
+
+namespace Checkpoints {
+
+// ============================================================================
+// Trusted signers
+// ============================================================================
+//
+// Mirrors Bootstrap::TRUSTED_SNAPSHOT_SIGNERS but kept SEPARATE so the two
+// lists can be managed independently. The default trust list contains the
+// project operator's address. Operators can extend via a future -trustedcheckpointsigner
+// conf option (not yet implemented — see Phase 2 in checkpointpublisher.h).
+static const char* TRUSTED_CHECKPOINT_SIGNERS[] = {
+    "TG8f76yktTxDrT7JJymY3wVAusXiD3fVvX",  // Sami's wallet (DNS2 default)
+};
+static const size_t NUM_TRUSTED_CHECKPOINT_SIGNERS =
+    sizeof(TRUSTED_CHECKPOINT_SIGNERS) / sizeof(TRUSTED_CHECKPOINT_SIGNERS[0]);
+
+bool IsTrustedCheckpointSigner(const std::string& addr)
+{
+    for (size_t i = 0; i < NUM_TRUSTED_CHECKPOINT_SIGNERS; ++i) {
+        if (addr == TRUSTED_CHECKPOINT_SIGNERS[i]) return true;
+    }
+    return false;
+}
+
+// ============================================================================
+// In-memory cache of loaded signed checkpoints
+// ============================================================================
+//
+// Guarded by a single CCriticalSection. The cache is small (a few thousand
+// entries max — operator publishes one every N=5000 blocks, so for a 2.2M
+// chain that's ~440 entries per active signer). Lookup is O(log n).
+static CCriticalSection cs_signedCheckpoints;
+static std::map<int, std::string> mapSignedCheckpoints;
+
+bool IsKnownSignedCheckpoint(int nHeight, const std::string& hashHex)
+{
+    LOCK(cs_signedCheckpoints);
+    auto it = mapSignedCheckpoints.find(nHeight);
+    if (it == mapSignedCheckpoints.end()) return false;
+    // case-insensitive compare — JSON parsers sometimes downcase hex
+    if (it->second.size() != hashHex.size()) return false;
+    for (size_t i = 0; i < it->second.size(); i++) {
+        if (std::tolower(static_cast<unsigned char>(it->second[i])) !=
+            std::tolower(static_cast<unsigned char>(hashHex[i]))) {
+            return false;
+        }
+    }
+    return true;
+}
+
+void AddSignedCheckpoints(const std::vector<SignedCheckpoint>& entries)
+{
+    LOCK(cs_signedCheckpoints);
+    for (const auto& e : entries) {
+        // Don't overwrite compiled-in mapCheckpoints — that gate runs FIRST
+        // in AcceptBlock. The signed set is a SUPPLEMENT, not a replacement.
+        mapSignedCheckpoints[e.nHeight] = e.hashHex;
+    }
+    printf("Checkpoints: added %lu signed-remote checkpoints to cache\n", (unsigned long)entries.size());
+}
+
+void ClearSignedCheckpoints()
+{
+    LOCK(cs_signedCheckpoints);
+    mapSignedCheckpoints.clear();
+}
+
+// ============================================================================
+// Canonical serialization — producer + consumer MUST agree on this byte sequence
+// ============================================================================
+//
+// Format: "<height1>:<hash1>:<ts1>;<height2>:<hash2>:<ts2>;..."
+//
+// Properties:
+//   - Entries in DESCENDING order (tip first)
+//   - Lowercase hex, no 0x prefix, no leading zeros
+//   - Timestamps are unix seconds, decimal
+//   - Field separator ':' — guaranteed not to appear in hex
+//   - Entry separator ';' — guaranteed not to appear in either
+//   - Trailing newline is NOT part of the signed payload (producers MUST NOT
+//     add one to the message before signing; consumers MUST NOT trim it off
+//     the fetched JSON's message field before verifying)
+//
+// This function is PURE — no I/O, no globals. Tested in checkpoint_tests.cpp.
+std::string SerializeEntriesForSigning(const std::vector<SignedCheckpoint>& entries)
+{
+    std::string out;
+    for (size_t i = 0; i < entries.size(); i++) {
+        if (i > 0) out += ";";
+        out += std::to_string(entries[i].nHeight);
+        out += ":";
+        out += entries[i].hashHex;
+        out += ":";
+        out += std::to_string(entries[i].nTimestamp);
+    }
+    return out;
+}
+
+// ============================================================================
+// Producer — build the JSON document
+// ============================================================================
+//
+// This is intentionally a thin wrapper: the wallet signing happens in the
+// caller (rpcwallet.cpp / daemon loop), which has the unlocked key. Here we
+// just escape + format.
+bool BuildSignedCheckpointsJson(
+    const std::vector<SignedCheckpoint>& entries,
+    const std::string& signingAddress,
+    const std::string& signatureBase64,
+    const std::string& message,
+    std::string& outJson,
+    std::string& strError)
+{
+    if (entries.empty()) {
+        strError = "BuildSignedCheckpointsJson: entries vector is empty";
+        return false;
+    }
+    if (signingAddress.empty()) {
+        strError = "BuildSignedCheckpointsJson: signingAddress is empty";
+        return false;
+    }
+    if (signatureBase64.empty()) {
+        strError = "BuildSignedCheckpointsJson: signature is empty";
+        return false;
+    }
+
+    // Sort entries DESCENDING by height — canonical form. Producers and
+    // consumers both depend on this so verification is deterministic.
+    std::vector<SignedCheckpoint> sorted = entries;
+    std::sort(sorted.begin(), sorted.end(),
+              [](const SignedCheckpoint& a, const SignedCheckpoint& b) {
+                  return a.nHeight > b.nHeight;
+              });
+
+    // Build JSON manually — no third-party deps. Format is intentionally
+    // simple (no nested objects beyond the entries array).
+    std::ostringstream oss;
+    oss << "{\n";
+    oss << "  \"format_version\": 1,\n";
+    oss << "  \"signing_address\": \"" << signingAddress << "\",\n";
+    oss << "  \"message\": \"" << message << "\",\n";
+    oss << "  \"signature\": \"" << signatureBase64 << "\",\n";
+    oss << "  \"entries\": [\n";
+    for (size_t i = 0; i < sorted.size(); i++) {
+        oss << "    {\"height\": " << sorted[i].nHeight
+            << ", \"hash\": \"" << sorted[i].hashHex << "\""
+            << ", \"timestamp\": " << sorted[i].nTimestamp << "}";
+        if (i + 1 < sorted.size()) oss << ",";
+        oss << "\n";
+    }
+    oss << "  ]\n";
+    oss << "}\n";
+
+    outJson = oss.str();
+    return true;
+}
+
+// ============================================================================
+// Consumer — verify a JSON document
+// ============================================================================
+
+// Small JSON helper — extract a top-level array of objects from the
+// "entries" field. We don't need full JSON parsing; the format is fixed.
+static std::vector<std::string> ExtractJsonObjectArray(
+    const std::string& json, const std::string& field)
+{
+    std::vector<std::string> objs;
+    std::string key = "\"" + field + "\"";
+    size_t pos = json.find(key);
+    if (pos == std::string::npos) return objs;
+    pos += key.size();
+    while (pos < json.size() && (json[pos] == ' ' || json[pos] == ':' ||
+           json[pos] == '\t' || json[pos] == '\n' || json[pos] == '\r'))
+        pos++;
+    if (pos >= json.size() || json[pos] != '[') return objs;
+    pos++;  // past '['
+    while (pos < json.size()) {
+        while (pos < json.size() && (json[pos] == ' ' || json[pos] == '\t' ||
+               json[pos] == '\n' || json[pos] == '\r' || json[pos] == ','))
+            pos++;
+        if (pos >= json.size() || json[pos] == ']') break;
+        if (json[pos] != '{') break;
+        // Find matching closing brace (shallow — no nested objects in entries)
+        int depth = 1;
+        size_t start = pos;
+        pos++;
+        while (pos < json.size() && depth > 0) {
+            if (json[pos] == '{') depth++;
+            else if (json[pos] == '}') depth--;
+            pos++;
+        }
+        if (depth != 0) break;
+        objs.push_back(json.substr(start, pos - start));
+    }
+    return objs;
+}
+
+// Extract an integer field from an entry object like:
+//   {"height": 12345, "hash": "...", "timestamp": 1700000000}
+static int ExtractJsonInt(const std::string& obj, const std::string& field)
+{
+    std::string key = "\"" + field + "\"";
+    size_t pos = obj.find(key);
+    if (pos == std::string::npos) return 0;
+    pos += key.size();
+    while (pos < obj.size() && (obj[pos] == ' ' || obj[pos] == ':' ||
+           obj[pos] == '\t')) pos++;
+    // Parse a non-negative integer
+    int n = 0;
+    bool foundAny = false;
+    while (pos < obj.size() && obj[pos] >= '0' && obj[pos] <= '9') {
+        n = n * 10 + (obj[pos] - '0');
+        pos++;
+        foundAny = true;
+    }
+    if (!foundAny) return 0;
+    return n;
+}
+
+// Extract a string field from a small JSON object — mirrors ExtractJsonString
+// in bootstrap.cpp. Duplicated here to keep checkpointpublisher.cpp standalone
+// (no link dependency on bootstrap.cpp internals).
+static std::string ExtractJsonString(const std::string& obj, const std::string& field)
+{
+    std::string key = "\"" + field + "\"";
+    size_t pos = obj.find(key);
+    if (pos == std::string::npos) return "";
+    pos += key.size();
+    while (pos < obj.size() && (obj[pos] == ' ' || obj[pos] == ':' ||
+           obj[pos] == '\t')) pos++;
+    if (pos >= obj.size() || obj[pos] != '\"') return "";
+    pos++;
+    size_t end = obj.find('\"', pos);
+    if (end == std::string::npos) return "";
+    return obj.substr(pos, end - pos);
+}
+
+bool VerifySignedCheckpoints(
+    const std::string& jsonText,
+    std::vector<SignedCheckpoint>& outEntries,
+    std::string& outSigningAddress,
+    std::string& strError)
+{
+    outEntries.clear();
+    outSigningAddress.clear();
+
+    // 1. Extract signing fields
+    outSigningAddress = ExtractJsonString(jsonText, "signing_address");
+    std::string signature = ExtractJsonString(jsonText, "signature");
+    std::string message = ExtractJsonString(jsonText, "message");
+    if (outSigningAddress.empty() || signature.empty() || message.empty()) {
+        strError = "signed-checkpoints JSON missing required top-level fields "
+                   "(signing_address/signature/message)";
+        return false;
+    }
+
+    // 2. Verify signer is trusted
+    if (!IsTrustedCheckpointSigner(outSigningAddress)) {
+        strError = "signing_address " + outSigningAddress +
+                   " is not in the trusted checkpoint signers list";
+        return false;
+    }
+
+    // 3. Verify the address is well-formed (catches typos early)
+    CTrianglesAddress addr(outSigningAddress);
+    if (!addr.IsValid()) {
+        strError = "signing_address " + outSigningAddress + " is not a valid Triangles address";
+        return false;
+    }
+    CKeyID keyID;
+    if (!addr.GetKeyID(keyID)) {
+        strError = "signing_address " + outSigningAddress + " does not refer to a key";
+        return false;
+    }
+
+    // 4. Decode and verify the signature (same code path as verifymessage RPC)
+    bool fInvalid = false;
+    std::vector<unsigned char> vchSig = DecodeBase64(signature.c_str(), &fInvalid);
+    if (fInvalid) {
+        strError = "signed-checkpoints signature is not valid base64";
+        return false;
+    }
+    CDataStream ss(SER_GETHASH, 0);
+    ss << strMessageMagic;
+    ss << message;
+    CKey key;
+    if (!key.SetCompactSignature(Hash(ss.begin(), ss.end()), vchSig)) {
+        strError = "signed-checkpoints signature failed to recover (bad sig or "
+                   "message tampered)";
+        return false;
+    }
+    if (key.GetPubKey().GetID() != keyID) {
+        strError = "signed-checkpoints signature recovered to a key that does "
+                   "not match the claimed signer address";
+        return false;
+    }
+
+    // 5. Extract entries and verify they match the signed message
+    std::vector<std::string> entryObjs = ExtractJsonObjectArray(jsonText, "entries");
+    if (entryObjs.empty()) {
+        strError = "signed-checkpoints JSON has no entries array or entries is empty";
+        return false;
+    }
+    outEntries.reserve(entryObjs.size());
+    for (const auto& obj : entryObjs) {
+        SignedCheckpoint e;
+        e.nHeight = ExtractJsonInt(obj, "height");
+        e.hashHex = ExtractJsonString(obj, "hash");
+        e.nTimestamp = ExtractJsonInt(obj, "timestamp");
+        if (e.nHeight <= 0 || e.hashHex.empty() || e.nTimestamp <= 0) {
+            strError = "malformed entry (height/hash/timestamp invalid): " + obj;
+            return false;
+        }
+        // hashHex sanity: must be exactly 64 lowercase hex chars
+        if (e.hashHex.size() != 64) {
+            strError = "entry hash at height " + std::to_string(e.nHeight) +
+                       " is not 64 chars: " + e.hashHex;
+            return false;
+        }
+        for (char c : e.hashHex) {
+            if (!((c >= '0' && c <= '9') || (c >= 'a' && c <= 'f'))) {
+                strError = "entry hash at height " + std::to_string(e.nHeight) +
+                           " contains non-lowercase-hex character";
+                return false;
+            }
+        }
+        outEntries.push_back(e);
+    }
+
+    // 6. Verify the signed message exactly matches the canonical serialization
+    //    of the entries. This is the cross-check that proves the entries
+    //    weren't tampered with after signing.
+    std::string expectedMessage = SerializeEntriesForSigning(outEntries);
+    if (expectedMessage != message) {
+        strError = "signed-checkpoints message does not match canonical entry "
+                   "serialization — entries were tampered with after signing";
+        return false;
+    }
+
+    printf("Checkpoints: signed-remote verified — %lu entries signed by %s\n",
+           (unsigned long)outEntries.size(), outSigningAddress.c_str());
+    return true;
+}
+
+// ============================================================================
+// Network fetch — keep it simple. The signed-checkpoints doc is tiny (~5 KB
+// for a year of entries at 5000-block intervals), so a plain HTTP GET is
+// fine. We DO NOT go through Tor for this fetch: the bootstrap server is
+// already a known clearnet endpoint (same model as the existing UTXO
+// snapshot download, which uses ConnectDirectTCP per bootstrap.cpp).
+// ============================================================================
+bool LoadSignedCheckpoints(
+    const std::string& host,
+    const std::string& onDiskPath,
+    std::vector<SignedCheckpoint>& outEntries,
+    std::string& outSigningAddress,
+    std::string& strError)
+{
+    outEntries.clear();
+    outSigningAddress.clear();
+
+    std::string jsonText;
+
+    // Path A: use on-disk copy if it exists (lets the daemon start even when
+    // the bootstrap server is unreachable, as long as we have a recent copy).
+    if (!onDiskPath.empty()) {
+        FILE* f = fopen(onDiskPath.c_str(), "rb");
+        if (f) {
+            fseek(f, 0, SEEK_END);
+            long sz = ftell(f);
+            fseek(f, 0, SEEK_SET);
+            if (sz > 0 && sz < 10 * 1024 * 1024) {  // 10 MB cap — sanity
+                jsonText.resize(sz);
+                size_t got = fread(&jsonText[0], 1, sz, f);
+                jsonText.resize(got);
+            }
+            fclose(f);
+            if (!jsonText.empty()) {
+                printf("Checkpoints: loaded on-disk signed-checkpoints from %s (%lu bytes)\n",
+                       onDiskPath.c_str(), (unsigned long)jsonText.size());
+            }
+        }
+    }
+
+    // Path B: fetch from bootstrap server. We always try this — if it
+    // succeeds, prefer the freshest doc over the on-disk copy.
+    if (host.empty()) {
+        strError = "LoadSignedCheckpoints: no host provided and no on-disk copy found";
+        return !jsonText.empty();  // if we have disk content, still try to verify it
+    }
+
+    // Use Bootstrap::DownloadFile — already handles clearnet HTTPS, timeouts,
+    // and redirects. We do NOT proxy through Tor.
+    if (Bootstrap::DownloadFile(host, "signed-checkpoints.json",
+                                 std::filesystem::temp_directory_path() / "signed-checkpoints.json.tmp",
+                                 nullptr, strError,
+                                 /*noProxy=*/true, /*portOverride=*/-1,
+                                 /*maxDownloadBytes=*/10 * 1024 * 1024)) {
+        std::filesystem::path tmp = std::filesystem::temp_directory_path() / "signed-checkpoints.json.tmp";
+        FILE* f = fopen(tmp.string().c_str(), "rb");
+        if (f) {
+            fseek(f, 0, SEEK_END);
+            long sz = ftell(f);
+            fseek(f, 0, SEEK_SET);
+            if (sz > 0 && sz < 10 * 1024 * 1024) {
+                jsonText.resize(sz);
+                size_t got = fread(&jsonText[0], 1, sz, f);
+                jsonText.resize(got);
+            }
+            fclose(f);
+        }
+        std::error_code ec;
+        std::filesystem::remove(tmp, ec);
+
+        if (!jsonText.empty()) {
+            printf("Checkpoints: fetched fresh signed-checkpoints from %s (%lu bytes)\n",
+                   host.c_str(), (unsigned long)jsonText.size());
+            // Persist to disk for next startup (only if onDiskPath was given)
+            if (!onDiskPath.empty()) {
+                FILE* f2 = fopen(onDiskPath.c_str(), "wb");
+                if (f2) {
+                    fwrite(jsonText.data(), 1, (unsigned long)jsonText.size(), f2);
+                    fclose(f2);
+                    printf("Checkpoints: persisted signed-checkpoints to %s\n", onDiskPath.c_str());
+                }
+            }
+        }
+    } else {
+        printf("Checkpoints: WARNING — fetch from %s failed (%s)",
+               host.c_str(), strError.c_str());
+        if (jsonText.empty()) {
+            strError = "could not fetch signed-checkpoints and no on-disk copy: " + strError;
+            return false;
+        }
+        printf(" — falling back to on-disk copy\n");
+        strError.clear();
+    }
+
+    // Verify whatever we ended up with
+    return VerifySignedCheckpoints(jsonText, outEntries, outSigningAddress, strError);
+}
+
+} // namespace Checkpoints

src/checkpointpublisher.h

@@ -0,0 +1,164 @@
+// Copyright (c) 2026 The Triangles developers
+// Distributed under the MIT/X11 software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+//
+// Signed Checkpoint Publisher (Triangles v5.9.24)
+//
+// Background
+// ----------
+// Triangles' existing CSyncCheckpoint (src/checkpoints.cpp) is Bitcoin-era
+// P2P-broadcast code that uses a HARDCODED master pubkey. That model does
+// not match how the project actually operates today (one operator with
+// multiple keys, snapshot publishing on the bootstrap server, no master
+// hierarchy). Instead we layer a *new* signed-checkpoint scheme on top of
+// the bootstrap server, using the same compact-message primitive the UTXO
+// snapshot trust model already uses (see src/bootstrap.cpp:IsTrustedSnapshotSigner).
+//
+// Trust model
+// -----------
+//   - A signed checkpoint document is a small JSON file hosted at
+//         https://bootstrap.cryptographic-triangles.org/signed-checkpoints.json
+//   - It contains a list of (height, block_hash, unix_timestamp) entries,
+//     followed by a single signing_address + signature covering the canonical
+//     serialization of the entry list.
+//   - The signing_address must appear in the trusted signers list
+//     (Checkpoints::IsTrustedCheckpointSigner, see checkpoints.cpp). The
+//     default trust list is the same as IsTrustedSnapshotSigner but kept
+//     separate so they can be managed independently.
+//   - Verification uses the existing CKey::SignCompact / SetCompactSignature
+//     code path through the wallet's verifymessage-style flow — no new
+//     cryptography is introduced.
+//
+// Producer
+// --------
+//   - The daemon operator runs `triangles-cli publishcheckpoint [interval]`
+//     which builds the entry list from pindexBest, signs with the wallet's
+//     default key, and writes the JSON document to a path the operator
+//     uploads to the bootstrap server (or a cron job uploads automatically
+//     when -autopublishcheckpoint is set).
+//   - Default interval = every 5000 blocks; can be set to every N.
+//   - The first entry is always the chain tip at publish time.
+//
+// Consumer
+// --------
+//   - On startup, the daemon can call
+//     Checkpoints::LoadSignedCheckpoints(host, dataDir, strError)
+//     which fetches, verifies, and merges the trusted entries into the
+//     compiled-in mapCheckpoints (lower priority — compiled-in wins on
+//     conflict to defend against remote-rollback).
+//   - Checkpoints::IsKnownSignedCheckpoint(height, hash) returns true if
+//     either compiled-in OR signed-remote knows about (height, hash).
+//
+// Relationship to existing code
+// -----------------------------
+//   - mapCheckpoints in src/checkpoints.cpp is UNCHANGED — the compiled-in
+//     list is still the primary trust anchor.
+//   - Signed checkpoints EXTEND the trust anchor with operator-published
+//     ones, useful when the operator wants to publish a checkpoint at
+//     height 2,210,000 without waiting for a code release.
+//   - mapSnapshotHashes is unaffected.
+
+#ifndef TRIANGLES_CHECKPOINT_PUBLISHER_H
+#define TRIANGLES_CHECKPOINT_PUBLISHER_H
+
+#include <string>
+#include <vector>
+#include <cstdint>
+
+namespace Checkpoints {
+
+// One signed checkpoint entry. Compact, serializable, no JSON inside the
+// struct — JSON wrapping happens in the publisher.
+struct SignedCheckpoint {
+    int nHeight;                  // block height
+    std::string hashHex;          // block hash, lowercase hex, NO 0x prefix, NO leading zeros
+    int64_t nTimestamp;           // unix seconds when published (signed over)
+};
+
+// Result of a publish or verify operation. Used for human-readable errors
+// and structured logging.
+struct SignedCheckpointResult {
+    bool ok;                      // overall success
+    std::string error;            // populated if !ok
+    int nEntriesWritten;          // for publish: how many entries went into the JSON
+    int nEntriesVerified;         // for verify: how many entries passed signature check
+};
+
+// Default URL for the bootstrap server's signed-checkpoints document.
+static const char* SIGNED_CHECKPOINTS_URL =
+    "https://bootstrap.cryptographic-triangles.org/signed-checkpoints.json";
+
+// Default local output path the daemon writes to on publish.
+static const char* SIGNED_CHECKPOINTS_DEFAULT_OUT =
+    "/var/www/triangles-bootstrap/signed-checkpoints.json";
+
+// ---- Producer ----
+
+// Build the JSON document for the entries [heights[0], heights[1], ...]
+// (in DESCENDING order — tip first) using the wallet's default key.
+// Returns true on success; outJson/outputPath written. Wallet must be
+// unlocked (signmessage requires it).
+//
+// This is the in-process builder used by both:
+//   - The triangles-cli `publishcheckpoint` RPC command
+//   - The daemon's auto-publish loop when -autopublishcheckpoint is set
+bool BuildSignedCheckpointsJson(
+    const std::vector<SignedCheckpoint>& entries,
+    const std::string& signingAddress,
+    const std::string& signatureBase64,
+    const std::string& message,
+    std::string& outJson,
+    std::string& strError);
+
+// Canonical (deterministic) serialization of the entry list. The signature
+// is over this exact byte sequence — both producer and consumer MUST use
+// this function so verification is reproducible across platforms.
+std::string SerializeEntriesForSigning(const std::vector<SignedCheckpoint>& entries);
+
+// ---- Consumer ----
+
+// Fetch the signed-checkpoints document from the bootstrap server, parse
+// it, verify the signature, and return the verified entries. Does NOT
+// merge into mapCheckpoints — caller decides what to do with the entries.
+//
+// onDiskPath: optional. If non-empty and the file already exists locally,
+// skip the network fetch and verify the on-disk copy. This makes startup
+// robust against bootstrap-server outages.
+bool LoadSignedCheckpoints(
+    const std::string& host,
+    const std::string& onDiskPath,
+    std::vector<SignedCheckpoint>& outEntries,
+    std::string& outSigningAddress,
+    std::string& strError);
+
+// Verify the signature on a parsed JSON document. Pure function — no
+// network, no filesystem.
+bool VerifySignedCheckpoints(
+    const std::string& jsonText,
+    std::vector<SignedCheckpoint>& outEntries,
+    std::string& outSigningAddress,
+    std::string& strError);
+
+// Is the given signing address in the trusted signers list? Mirrors
+// Bootstrap::IsTrustedSnapshotSigner but kept separate for independent
+// governance.
+bool IsTrustedCheckpointSigner(const std::string& addr);
+
+// ---- Merged lookup ----
+
+// Is (height, hash) known to either the compiled-in OR the
+// signed-remote set? This is what AcceptBlock / fork-detection should call.
+bool IsKnownSignedCheckpoint(int nHeight, const std::string& hashHex);
+
+// Inject loaded entries into the in-memory signed-checkpoint cache. Called
+// by init.cpp after LoadSignedCheckpoints returns successfully. Subsequent
+// IsKnownSignedCheckpoint() calls will return true for any (height, hash)
+// in the loaded set.
+void AddSignedCheckpoints(const std::vector<SignedCheckpoint>& entries);
+
+// Clear the in-memory cache (used at reorg boundaries and in tests).
+void ClearSignedCheckpoints();
+
+} // namespace Checkpoints
+
+#endif // TRIANGLES_CHECKPOINT_PUBLISHER_H

src/checkpoints.cpp

@@ -32,11 +32,32 @@ namespace Checkpoints
         {  9002, uint256("0xa1e20fb1d44688b763690cf74d6aefe859e4cc32981f9e3f2b2ae9702bbcf249")},
         { 10881, uint256("0x4b6554c45e1e6764a6f3c309c47baf53c9edd81f624e52b072518cd15da237e6")},
         { 17650, uint256("0x224940e1f986a202209b8e762728d1452ab45870c308abf84905674acf326a47")},
-        // Recent finality pin (PoS era). Closes the long unchecked span from
-        // 17650 to the live tip so stale-bootstrap / low-trust forks below
-        // this height are rejected outright. Hash from the canonical chain.
-        { 2205000, uint256("0x6bdd3c5e5a32e1dd9a70e705f1a28d1dd84929f89579bd2696d41bc87f39446f")},
-    };
+                // Recent finality pin (PoS era). Closes the long unchecked span from
+                // 17650 to the live tip so stale-bootstrap / low-trust forks below
+                // this height are rejected outright. Hash from the canonical chain.
+                // Operator rollback canonical (cycle-32, 2026-08-06): the chain was
+                // rolled back to height 2,172,037 (hash 52b12f09...) so the entire
+                // span 2,172,038..2,224,763 no longer exists on the canonical chain.
+                // All pins from 2,205,000..2,224,763 have been REMOVED from the map
+                // (NOT preserved). Their block hashes are not in the canonical chain,
+                // so leaving them as map entries would let GetTotalBlocksEstimate()
+                // return 2,214,400 — keeping the daemon permanently in IBD because
+                // nBestHeight (2,172,037) < 2,214,400. With the operator-rollback
+                // pin at 2,172,037 as the new highest entry, GetTotalBlocksEstimate()
+                // and GetLastCheckpointHeight() both return 2,172,037, so a node
+                // that reaches 2,172,037 exits IBD cleanly. The pin at 17,650
+                // (line above) remains as the lowest anchored finality reference.
+                // Operator-rollback finality pin (cycle-33, 2026-08-06): the new
+                // canonical tip after the operator rollback to 2,172,037. Hash
+                // verified against all 4 fleet nodes (DNS2/DNS3/Hetzner/SAMI-PC)
+                // at canonical tip 2,172,037. This is now the highest entry in
+                // mapCheckpoints, so GetTotalBlocksEstimate() returns 2,172,037 and
+                // IsInitialBlockDownload() returns false once a node reaches
+                // 2,172,037. Closes the unchecked span between the prior highest
+                // pin (17,650) and the new canonical tip for any future
+                // fresh-from-zero sync.
+                { 2172037, uint256("0x52b12f0970191505d9982449875822b78f075d7d76307abed45e7132f5fa2f16")}, // new canonical tip
+            };
 
     // Published UTXO snapshot file SHA256, keyed by snapshot height.
     // Each entry binds height -> SHA256 of the canonical snapshot file produced by
@@ -47,6 +68,17 @@ namespace Checkpoints
     // here. The corresponding (height, blockhash) must already exist in
     // mapCheckpoints / mapCheckpointsTestnet.
     static std::map<int, uint256> mapSnapshotHashes = {
+        // Historical snapshots preserved as documentation only. The canonical
+        // chain is now at 2,172,037 (operator rollback 2026-08-06). Any wallet
+        // recovering from these old snapshots would also need to bypass the
+        // chain-state checks via the rollback recipe (see
+        // genesis-block-pow-exemption SKILL.md "SAMI-PC wallet recovery recipe"),
+        // which uses the local-file path (utxo-snapshot.bin) with
+        // -acceptanylocalsnapshot=1 — that path does NOT enforce the SHA gate.
+        // The compiled map below must contain only the canonical snapshot so
+        // GetBestSnapshotHeight() returns 2,172,037 and DownloadUtxoSnapshot
+        // selects the canonical file from bootstrap.cryptographic-triangles.org.
+        { 2172037, uint256("0xfc3b2035525564156f2489e8929e132b75e9be285d9129ad21bc89ecdc4c7977")}, // canonical
     };
 
     static std::map<int, uint256> mapSnapshotHashesTestnet = {
@@ -121,6 +153,19 @@ namespace Checkpoints
         return nullptr;
     }
 
+    // Independent of mapBlockIndex: returns the highest compiled checkpoint
+    // height for the current network. Returns -1 if the compiled map is
+    // empty (an unusual, but not impossible, configuration). Used as the
+    // fail-closed reorg floor before pindexLastHardenedCheckpoint has been
+    // resolved against the local block index (early IBD / reindex /
+    // bootstrap before the checkpoint block has been downloaded).
+    int GetLastCheckpointHeight()
+    {
+        MapCheckpoints& checkpoints = (fTestNet ? mapCheckpointsTestnet : mapCheckpoints);
+        if (checkpoints.empty()) return -1;
+        return checkpoints.rbegin()->first;
+    }
+
     // triangles: synchronized checkpoint (centrally broadcasted)
     uint256 hashSyncCheckpoint = uint256("0x7e7a6e4dd5fe895106fca912dfbacaeaf2a89e76c6a588df8ff96e0e18b96021");
     uint256 hashPendingCheckpoint = uint256("0x7e7a6e4dd5fe895106fca912dfbacaeaf2a89e76c6a588df8ff96e0e18b96021");
@@ -323,53 +368,14 @@ namespace Checkpoints
 
     bool SetCheckpointPrivKey(std::string strPrivKey)
     {
-        // Test signing a sync-checkpoint with genesis block
-        CSyncCheckpoint checkpoint;
-        checkpoint.hashCheckpoint = !fTestNet ? hashGenesisBlockOfficial : hashGenesisBlockTestNet;
-        CDataStream sMsg(SER_NETWORK, PROTOCOL_VERSION);
-        sMsg << (CUnsignedSyncCheckpoint)checkpoint;
-        checkpoint.vchMsg = std::vector<unsigned char>(sMsg.begin(), sMsg.end());
-
-        std::vector<unsigned char> vchPrivKey = ParseHex(strPrivKey);
-        CKey key;
-        key.SetPrivKey(CPrivKey(vchPrivKey.begin(), vchPrivKey.end())); // if key is not correct openssl may crash
-        if (!key.Sign(Hash(checkpoint.vchMsg.begin(), checkpoint.vchMsg.end()), checkpoint.vchSig))
-            return false;
-
-        // Test signing successful, proceed
-        CSyncCheckpoint::strMasterPrivKey = strPrivKey;
-        return true;
+        (void)strPrivKey;
+        return error("SetCheckpointPrivKey: synchronized checkpoints are disabled");
     }
 
     bool SendSyncCheckpoint(uint256 hashCheckpoint)
     {
-        CSyncCheckpoint checkpoint;
-        checkpoint.hashCheckpoint = hashCheckpoint;
-        CDataStream sMsg(SER_NETWORK, PROTOCOL_VERSION);
-        sMsg << (CUnsignedSyncCheckpoint)checkpoint;
-        checkpoint.vchMsg = std::vector<unsigned char>(sMsg.begin(), sMsg.end());
-
-        if (CSyncCheckpoint::strMasterPrivKey.empty())
-            return error("SendSyncCheckpoint: Checkpoint master key unavailable.");
-        std::vector<unsigned char> vchPrivKey = ParseHex(CSyncCheckpoint::strMasterPrivKey);
-        CKey key;
-        key.SetPrivKey(CPrivKey(vchPrivKey.begin(), vchPrivKey.end())); // if key is not correct openssl may crash
-        if (!key.Sign(Hash(checkpoint.vchMsg.begin(), checkpoint.vchMsg.end()), checkpoint.vchSig))
-            return error("SendSyncCheckpoint: Unable to sign checkpoint, check private key?");
-
-        if(!checkpoint.ProcessSyncCheckpoint(nullptr))
-        {
-            printf("WARNING: SendSyncCheckpoint: Failed to process checkpoint.\n");
-            return false;
-        }
-
-        // Relay checkpoint
-        {
-            LOCK(cs_vNodes);
-            for (CNode* pnode : vNodes)
-                checkpoint.RelayTo(pnode);
-        }
-        return true;
+        (void)hashCheckpoint;
+        return error("SendSyncCheckpoint: synchronized checkpoints are disabled");
     }
 
     // Is the sync-checkpoint outside maturity window?
@@ -390,13 +396,11 @@ const std::string CSyncCheckpoint::strMasterPubKey = "";
 std::string CSyncCheckpoint::strMasterPrivKey = "";
 
 // triangles: verify signature of sync-checkpoint message
-// Master key system disabled - checkpoint signatures are no longer required
+// The master-key system is disabled. Reject these legacy messages instead of
+// treating unsigned data as authenticated if a dispatcher is added later.
 bool CSyncCheckpoint::CheckSignature()
 {
-    // Deserialize the checkpoint data without signature verification
-    CDataStream sMsg(vchMsg, SER_NETWORK, PROTOCOL_VERSION);
-    sMsg >> *(CUnsignedSyncCheckpoint*)this;
-    return true;
+    return error("CSyncCheckpoint::CheckSignature: synchronized checkpoints are disabled");
 }
 
 // triangles: process synchronized checkpoint

src/checkpoints.h

@@ -53,6 +53,14 @@ namespace Checkpoints
     // Returns last CBlockIndex* in mapBlockIndex that is a checkpoint
     CBlockIndex* GetLastCheckpoint(const std::map<uint256, CBlockIndex*>& mapBlockIndex);
 
+    // Returns the highest *compiled* checkpoint height, independent of
+    // whether mapBlockIndex has loaded the corresponding block yet. Every
+    // node built from the same binary sees the same value. Used as the
+    // fail-closed floor for Reorganize() when pindexLastHardenedCheckpoint
+    // has not yet been resolved (early IBD / reindex / bootstrap before
+    // the checkpoint block has been downloaded).
+    int GetLastCheckpointHeight();
+
     extern uint256 hashSyncCheckpoint;
     extern CSyncCheckpoint checkpointMessage;
     extern uint256 hashInvalidCheckpoint;

src/clientversion.h

@@ -1,19 +1,19 @@
-#ifndef CLIENTVERSION_H
-#define CLIENTVERSION_H
-
-//
-// client versioning
-//
-
-// These need to be macros, as version.cpp's and triangles-qt.rc's voodoo requires it
-#define CLIENT_VERSION_MAJOR       5
-#define CLIENT_VERSION_MINOR       9
-#define CLIENT_VERSION_REVISION    12
-#define CLIENT_VERSION_BUILD       0
-
-// Converts the parameter X to a string after macro replacement on X has been performed.
-// Don't merge these into one macro!
-#define STRINGIZE(X) DO_STRINGIZE(X)
-#define DO_STRINGIZE(X) #X
-
-#endif // CLIENTVERSION_H
+#ifndef CLIENTVERSION_H
+#define CLIENTVERSION_H
+
+//
+// client versioning
+//
+
+// These need to be macros, as version.cpp's and triangles-qt.rc's voodoo requires it
+#define CLIENT_VERSION_MAJOR       6
+#define CLIENT_VERSION_MINOR       2
+#define CLIENT_VERSION_REVISION    6
+#define CLIENT_VERSION_BUILD       4
+
+// Converts the parameter X to a string after macro replacement on X has been performed.
+// Don't merge these into one macro!
+#define STRINGIZE(X) DO_STRINGIZE(X)
+#define DO_STRINGIZE(X) #X
+
+#endif // CLIENTVERSION_H

src/hdwallet.cpp

@@ -0,0 +1,223 @@
+// Copyright (c) 2026 The Triangles developers
+// Distributed under the MIT/X11 software license.
+#include "hdwallet.h"
+#include "bip39_english.h"
+
+#include <cstring>
+#include <algorithm>
+
+#include <openssl/sha.h>
+#include <openssl/hmac.h>
+#include <openssl/evp.h>
+#include <openssl/rand.h>
+
+#include <secp256k1.h>
+
+namespace hd {
+
+// ---- secp256k1 context (self-contained; independent of crypto_ecdsa) ------
+static secp256k1_context* HDContext()
+{
+    static secp256k1_context* ctx = NULL;
+    if (!ctx)
+        ctx = secp256k1_context_create(SECP256K1_CONTEXT_SIGN | SECP256K1_CONTEXT_VERIFY);
+    return ctx;
+}
+
+static void HmacSha512(const unsigned char* key, size_t keylen,
+                       const unsigned char* data, size_t datalen,
+                       unsigned char out[64])
+{
+    unsigned int len = 64;
+    HMAC(EVP_sha512(), key, (int)keylen, data, datalen, out, &len);
+}
+
+// Binary search the (lexicographically sorted) BIP39 English wordlist.
+static int WordIndex(const std::string& w)
+{
+    int lo = 0, hi = 2047;
+    while (lo <= hi) {
+        int mid = (lo + hi) / 2;
+        int c = w.compare(BIP39_WORDLIST_EN[mid]);
+        if (c == 0) return mid;
+        if (c < 0) hi = mid - 1; else lo = mid + 1;
+    }
+    return -1;
+}
+
+static std::vector<std::string> SplitWords(const std::string& s)
+{
+    std::vector<std::string> out;
+    size_t i = 0, n = s.size();
+    while (i < n) {
+        while (i < n && (s[i] == ' ' || s[i] == '\t' || s[i] == '\n' || s[i] == '\r')) i++;
+        size_t j = i;
+        while (j < n && !(s[j] == ' ' || s[j] == '\t' || s[j] == '\n' || s[j] == '\r')) j++;
+        if (j > i) out.push_back(s.substr(i, j - i));
+        i = j;
+    }
+    return out;
+}
+
+// ---- BIP39 ----------------------------------------------------------------
+std::string GenerateMnemonic(int strengthBits)
+{
+    if (strengthBits != 128 && strengthBits != 256) strengthBits = 256;
+    int entBytes = strengthBits / 8;
+    std::vector<unsigned char> ent(entBytes);
+    if (RAND_bytes(&ent[0], entBytes) != 1) return std::string();
+
+    // checksum = first (ENT/32) bits of SHA256(entropy)
+    unsigned char hash[32];
+    SHA256(&ent[0], entBytes, hash);
+    int csBits = strengthBits / 32;
+
+    // bit buffer = entropy || checksum bits
+    std::vector<unsigned char> bits = ent;
+    bits.push_back(hash[0]); // up to 8 checksum bits live in hash[0]
+
+    int totalBits = strengthBits + csBits;
+    int words = totalBits / 11;
+    std::string out;
+    for (int i = 0; i < words; i++) {
+        int idx = 0;
+        for (int b = 0; b < 11; b++) {
+            int bitpos = i * 11 + b;
+            int byte = bitpos / 8, off = 7 - (bitpos % 8);
+            int bit = (bits[byte] >> off) & 1;
+            idx = (idx << 1) | bit;
+        }
+        if (i) out += ' ';
+        out += BIP39_WORDLIST_EN[idx];
+    }
+    return out;
+}
+
+bool CheckMnemonic(const std::string& mnemonic)
+{
+    std::vector<std::string> w = SplitWords(mnemonic);
+    size_t nw = w.size();
+    if (nw != 12 && nw != 15 && nw != 18 && nw != 21 && nw != 24) return false;
+
+    int totalBits = (int)nw * 11;
+    int csBits = totalBits / 33;
+    int entBits = totalBits - csBits;
+    if (entBits % 8 != 0) return false;
+    int entBytes = entBits / 8;
+
+    // unpack 11-bit indices into a bit buffer
+    std::vector<unsigned char> buf((totalBits + 7) / 8, 0);
+    for (size_t i = 0; i < nw; i++) {
+        int idx = WordIndex(w[i]);
+        if (idx < 0) return false;
+        for (int b = 0; b < 11; b++) {
+            int bit = (idx >> (10 - b)) & 1;
+            int bitpos = (int)i * 11 + b;
+            int byte = bitpos / 8, off = 7 - (bitpos % 8);
+            if (bit) buf[byte] |= (1 << off);
+        }
+    }
+    std::vector<unsigned char> ent(buf.begin(), buf.begin() + entBytes);
+    unsigned char hash[32];
+    SHA256(&ent[0], entBytes, hash);
+    // compare csBits checksum bits
+    for (int b = 0; b < csBits; b++) {
+        int bitpos = entBits + b;
+        int byte = bitpos / 8, off = 7 - (bitpos % 8);
+        int got = (buf[byte] >> off) & 1;
+        int want = (hash[b / 8] >> (7 - (b % 8))) & 1;
+        if (got != want) return false;
+    }
+    return true;
+}
+
+bool MnemonicToSeed(const std::string& mnemonic, const std::string& passphrase,
+                    unsigned char seed64[64])
+{
+    std::string salt = "mnemonic" + passphrase;
+    int rc = PKCS5_PBKDF2_HMAC(mnemonic.c_str(), (int)mnemonic.size(),
+                               (const unsigned char*)salt.c_str(), (int)salt.size(),
+                               2048, EVP_sha512(), 64, seed64);
+    return rc == 1;
+}
+
+// ---- BIP32 ----------------------------------------------------------------
+bool MasterFromSeed(const unsigned char* seed, size_t seedlen, ExtKey& out)
+{
+    unsigned char I[64];
+    HmacSha512((const unsigned char*)"Bitcoin seed", 12, seed, seedlen, I);
+    memcpy(out.key, I, 32);
+    memcpy(out.chaincode, I + 32, 32);
+    if (!secp256k1_ec_seckey_verify(HDContext(), out.key)) return false;
+    out.valid = true;
+    return true;
+}
+
+bool CKDpriv(const ExtKey& parent, uint32_t index, ExtKey& child)
+{
+    if (!parent.valid) return false;
+    secp256k1_context* ctx = HDContext();
+    unsigned char data[37];
+    size_t dlen = 0;
+    if (index & HARDENED) {
+        data[0] = 0x00;
+        memcpy(data + 1, parent.key, 32);
+        dlen = 33;
+    } else {
+        // serP(point(parent.key)) = 33-byte compressed pubkey
+        secp256k1_pubkey pk;
+        if (!secp256k1_ec_pubkey_create(ctx, &pk, parent.key)) return false;
+        size_t plen = 33;
+        secp256k1_ec_pubkey_serialize(ctx, data, &plen, &pk, SECP256K1_EC_COMPRESSED);
+        dlen = 33;
+    }
+    data[dlen + 0] = (index >> 24) & 0xff;
+    data[dlen + 1] = (index >> 16) & 0xff;
+    data[dlen + 2] = (index >> 8) & 0xff;
+    data[dlen + 3] = index & 0xff;
+    dlen += 4;
+
+    unsigned char I[64];
+    HmacSha512(parent.chaincode, 32, data, dlen, I);
+
+    memcpy(child.key, parent.key, 32);
+    // child = (IL + parent) mod n ; rejects invalid (IL>=n or result 0)
+    if (!secp256k1_ec_seckey_tweak_add(ctx, child.key, I)) return false;
+    memcpy(child.chaincode, I + 32, 32);
+    child.valid = true;
+    return true;
+}
+
+bool DerivePath(const ExtKey& master, const std::vector<uint32_t>& path, ExtKey& out)
+{
+    ExtKey cur = master;
+    for (size_t i = 0; i < path.size(); i++) {
+        ExtKey nxt;
+        if (!CKDpriv(cur, path[i], nxt)) return false;
+        cur = nxt;
+    }
+    out = cur;
+    return true;
+}
+
+bool DeriveTriangles(const std::string& mnemonic, const std::string& passphrase,
+                     uint32_t account, uint32_t change, uint32_t index,
+                     unsigned char privOut[32])
+{
+    unsigned char seed[64];
+    if (!MnemonicToSeed(mnemonic, passphrase, seed)) return false;
+    ExtKey master;
+    if (!MasterFromSeed(seed, 64, master)) return false;
+    std::vector<uint32_t> path;
+    path.push_back(44u | HARDENED);
+    path.push_back(TRI_COIN_TYPE | HARDENED);
+    path.push_back(account | HARDENED);
+    path.push_back(change);
+    path.push_back(index);
+    ExtKey leaf;
+    if (!DerivePath(master, path, leaf)) return false;
+    memcpy(privOut, leaf.key, 32);
+    return true;
+}
+
+} // namespace hd

src/hdwallet.h

@@ -0,0 +1,50 @@
+// Copyright (c) 2026 The Triangles developers
+// Distributed under the MIT/X11 software license.
+//
+// Native BIP39 (mnemonic) + BIP32 (HD) key derivation for Triangles.
+// Produces keys identical to the TRIdock web wallet (derivation path
+// m/44'/2222'/0'/0/i, coin type 2222), so a 24-word phrase round-trips
+// between the Qt/daemon wallet and the web wallet.
+#ifndef TRIANGLES_HDWALLET_H
+#define TRIANGLES_HDWALLET_H
+
+#include <string>
+#include <vector>
+#include <cstdint>
+#include <cstddef>
+
+namespace hd {
+
+static const uint32_t HARDENED      = 0x80000000u;
+static const uint32_t TRI_COIN_TYPE = 2222u;   // matches triWallet.js
+
+// A BIP32 extended private key (private scalar + chain code).
+struct ExtKey {
+    unsigned char key[32];
+    unsigned char chaincode[32];
+    bool valid;
+    ExtKey() : valid(false) { }
+};
+
+// ---- BIP39 ----------------------------------------------------------------
+// Generate a new mnemonic. strengthBits must be 128 (12 words) or 256 (24).
+std::string GenerateMnemonic(int strengthBits = 256);
+// Validate word membership + checksum.
+bool CheckMnemonic(const std::string& mnemonic);
+// PBKDF2-HMAC-SHA512(mnemonic, "mnemonic"+passphrase, 2048) -> 64-byte seed.
+bool MnemonicToSeed(const std::string& mnemonic, const std::string& passphrase,
+                    unsigned char seed64[64]);
+
+// ---- BIP32 ----------------------------------------------------------------
+bool MasterFromSeed(const unsigned char* seed, size_t seedlen, ExtKey& out);
+bool CKDpriv(const ExtKey& parent, uint32_t index, ExtKey& child);
+bool DerivePath(const ExtKey& master, const std::vector<uint32_t>& path, ExtKey& out);
+
+// ---- High level -----------------------------------------------------------
+// Derive the 32-byte private scalar for m/44'/coinType'/account'/change/index.
+bool DeriveTriangles(const std::string& mnemonic, const std::string& passphrase,
+                     uint32_t account, uint32_t change, uint32_t index,
+                     unsigned char privOut[32]);
+
+} // namespace hd
+#endif // TRIANGLES_HDWALLET_H

src/i2p.cpp

@@ -0,0 +1,478 @@
+// Copyright (c) 2024 Triangles developers
+// I2P (SAM v3) transport support
+// Distributed under the MIT/X11 software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+#include "i2p.h"
+
+#include "util.h"
+#include "netbase.h"
+#include "protocol.h"   // CAddress
+#include "net.h"        // AddI2PInboundNode(), GetListenPort()
+
+#include <openssl/sha.h>
+
+#include <cstdio>
+#include <cstring>
+#include <filesystem>
+#include <fstream>
+#include <sstream>
+
+namespace fs = std::filesystem;
+
+#ifdef WIN32
+#include <winsock2.h>
+#include <ws2tcpip.h>
+#else
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <netinet/tcp.h>
+#include <arpa/inet.h>
+#include <unistd.h>
+#ifndef closesocket
+#define closesocket close
+#endif
+#endif
+
+// I2P uses a base64 variant where '+' -> '-' and '/' -> '~'.
+static const char* pI2PBase64 =
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-~";
+
+static std::vector<unsigned char> DecodeI2PBase64(const std::string& str)
+{
+    int table[256];
+    for (int i = 0; i < 256; i++) table[i] = -1;
+    for (int i = 0; i < 64; i++) table[(unsigned char)pI2PBase64[i]] = i;
+
+    std::vector<unsigned char> out;
+    int bits = 0; uint32_t buf = 0;
+    for (char c : str) {
+        if (c == '=' || c == '\r' || c == '\n') continue;
+        int v = table[(unsigned char)c];
+        if (v < 0) continue; // skip anything unexpected
+        buf = (buf << 6) | v;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            out.push_back((unsigned char)((buf >> bits) & 0xFF));
+        }
+    }
+    return out;
+}
+
+CI2PSession* CI2PSession::GetInstance()
+{
+    static CI2PSession instance;
+    return &instance;
+}
+
+CI2PSession::CI2PSession()
+    : samHost(I2P_DEFAULT_SAM_HOST), samPort(I2P_DEFAULT_SAM_PORT),
+      hSession(INVALID_SOCKET), fEnabled(false), fActive(false), fShutdown(false)
+{
+}
+
+CI2PSession::~CI2PSession()
+{
+    Stop();
+}
+
+std::string CI2PSession::GetB32Address()
+{
+    std::lock_guard<std::mutex> lock(cs);
+    return b32Address;
+}
+
+// --- low level SAM helpers -------------------------------------------------
+
+bool CI2PSession::SamConnect(SOCKET& hSocketRet)
+{
+    SOCKET hSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
+    if (hSocket == INVALID_SOCKET)
+        return false;
+
+    struct sockaddr_in addr;
+    memset(&addr, 0, sizeof(addr));
+    addr.sin_family = AF_INET;
+    addr.sin_port = htons((unsigned short)samPort);
+    addr.sin_addr.s_addr = inet_addr(samHost.c_str());
+
+    if (connect(hSocket, (struct sockaddr*)&addr, sizeof(addr)) == SOCKET_ERROR) {
+        closesocket(hSocket);
+        return false;
+    }
+
+    hSocketRet = hSocket;
+    return true;
+}
+
+bool CI2PSession::SamSendLine(SOCKET hSocket, const std::string& strLine)
+{
+    std::string out = strLine + "\n";
+    const char* p = out.c_str();
+    size_t left = out.size();
+    while (left > 0) {
+        int n = send(hSocket, p, (int)left, MSG_NOSIGNAL);
+        if (n <= 0)
+            return false;
+        p += n;
+        left -= n;
+    }
+    return true;
+}
+
+bool CI2PSession::SamRecvLine(SOCKET hSocket, std::string& strLineRet)
+{
+    strLineRet.clear();
+    char c;
+    // SAM replies are newline terminated; read one byte at a time so we stop
+    // exactly at the boundary and leave any following stream data untouched.
+    for (int i = 0; i < 16384; i++) {
+        int n = recv(hSocket, &c, 1, 0);
+        if (n <= 0)
+            return false;
+        if (c == '\n')
+            return true;
+        if (c != '\r')
+            strLineRet += c;
+    }
+    return false;
+}
+
+std::string CI2PSession::SamGetValue(const std::string& strReply, const std::string& strKey)
+{
+    // Tokens are space separated KEY=VALUE pairs.  VALUE runs to the next space.
+    std::string needle = strKey + "=";
+    size_t pos = strReply.find(needle);
+    if (pos == std::string::npos)
+        return "";
+    pos += needle.size();
+    size_t end = strReply.find(' ', pos);
+    if (end == std::string::npos)
+        end = strReply.size();
+    return strReply.substr(pos, end - pos);
+}
+
+bool CI2PSession::SamHandshake(SOCKET hSocket)
+{
+    if (!SamSendLine(hSocket, "HELLO VERSION MIN=3.1 MAX=3.3"))
+        return false;
+    std::string reply;
+    if (!SamRecvLine(hSocket, reply))
+        return false;
+    if (SamGetValue(reply, "RESULT") != "OK") {
+        printf("I2P: SAM handshake failed: %s\n", reply.c_str());
+        return false;
+    }
+    return true;
+}
+
+std::string CI2PSession::DestToB32(const std::string& strB64Dest)
+{
+    std::vector<unsigned char> dest = DecodeI2PBase64(strB64Dest);
+    if (dest.empty())
+        return "";
+    unsigned char hash[SHA256_DIGEST_LENGTH];
+    SHA256(dest.data(), dest.size(), hash);
+    std::string b32 = EncodeBase32(hash, SHA256_DIGEST_LENGTH);
+    // I2P b32 addresses are unpadded.
+    while (!b32.empty() && b32[b32.size() - 1] == '=')
+        b32.erase(b32.size() - 1);
+    return b32 + ".b32.i2p";
+}
+
+// --- session bring-up ------------------------------------------------------
+
+bool CI2PSession::LoadOrCreateDestination(std::string& strPrivKeyRet)
+{
+    fs::path keyPath = GetDataDir() / "i2p_private_key";
+
+    // Reuse an existing persistent destination if we have one.
+    {
+        std::ifstream f(keyPath.string().c_str());
+        if (f.is_open()) {
+            std::string line;
+            std::getline(f, line);
+            while (!line.empty() &&
+                   (line[line.size() - 1] == '\r' || line[line.size() - 1] == '\n'))
+                line.erase(line.size() - 1);
+            if (!line.empty()) {
+                strPrivKeyRet = line;
+                printf("I2P: loaded persistent destination from %s\n",
+                       keyPath.string().c_str());
+                return true;
+            }
+        }
+    }
+
+    // Generate a fresh destination via the bridge (Ed25519, SIGNATURE_TYPE=7).
+    SOCKET hSocket = INVALID_SOCKET;
+    if (!SamConnect(hSocket) || !SamHandshake(hSocket)) {
+        if (hSocket != INVALID_SOCKET) closesocket(hSocket);
+        return false;
+    }
+
+    bool ok = false;
+    if (SamSendLine(hSocket, "DEST GENERATE SIGNATURE_TYPE=7")) {
+        std::string reply;
+        if (SamRecvLine(hSocket, reply)) {
+            std::string priv = SamGetValue(reply, "PRIV");
+            if (!priv.empty()) {
+                strPrivKeyRet = priv;
+                std::ofstream out(keyPath.string().c_str(), std::ios::trunc);
+                if (out.is_open()) {
+                    out << priv << std::endl;
+                    out.close();
+                    // The I2P destination private key identifies this node on
+                    // the I2P network: owner-only permissions, like Tor's
+                    // hidden-service secret key. (No-op semantics differ on
+                    // Windows ACLs; harmless there.)
+                    std::error_code ec;
+                    std::filesystem::permissions(keyPath,
+                        std::filesystem::perms::owner_read |
+                        std::filesystem::perms::owner_write,
+                        std::filesystem::perm_options::replace, ec);
+                    if (ec)
+                        printf("I2P: WARNING could not restrict permissions on %s: %s\n",
+                               keyPath.string().c_str(), ec.message().c_str());
+                    printf("I2P: generated and saved new persistent destination\n");
+                    ok = true;
+                } else {
+                    printf("I2P: WARNING could not write %s\n", keyPath.string().c_str());
+                    ok = true; // still usable for this run
+                }
+            }
+        }
+    }
+    closesocket(hSocket);
+    return ok;
+}
+
+bool CI2PSession::CreateSession()
+{
+    if (!SamConnect(hSession))
+        return false;
+    if (!SamHandshake(hSession))
+        return false;
+
+    std::ostringstream id;
+    id << "triangles-" << (uint64_t)GetTime() << "-" << (uint64_t)(GetRand(1000000));
+    sessionId = id.str();
+
+    std::string cmd = "SESSION CREATE STYLE=STREAM ID=" + sessionId +
+                      " DESTINATION=" + privateKey + " SIGNATURE_TYPE=7";
+    if (!SamSendLine(hSession, cmd))
+        return false;
+
+    std::string reply;
+    if (!SamRecvLine(hSession, reply))
+        return false;
+
+    if (SamGetValue(reply, "RESULT") != "OK") {
+        printf("I2P: SESSION CREATE failed: %s\n", reply.c_str());
+        return false;
+    }
+
+    // The bridge echoes the (possibly newly assigned) private key back.
+    std::string echoed = SamGetValue(reply, "DESTINATION");
+    if (!echoed.empty())
+        privateKey = echoed;
+
+    return true;
+}
+
+bool CI2PSession::ResolveMyB32()
+{
+    SOCKET hSocket = INVALID_SOCKET;
+    if (!SamConnect(hSocket) || !SamHandshake(hSocket)) {
+        if (hSocket != INVALID_SOCKET) closesocket(hSocket);
+        return false;
+    }
+
+    bool ok = false;
+    if (SamSendLine(hSocket, "NAMING LOOKUP NAME=ME")) {
+        std::string reply;
+        if (SamRecvLine(hSocket, reply) && SamGetValue(reply, "RESULT") == "OK") {
+            std::string dest = SamGetValue(reply, "VALUE");
+            std::string b32 = DestToB32(dest);
+            if (!b32.empty()) {
+                std::lock_guard<std::mutex> lock(cs);
+                b32Address = b32;
+                ok = true;
+            }
+        }
+    }
+    closesocket(hSocket);
+    return ok;
+}
+
+bool CI2PSession::Start()
+{
+    if (!GetBoolArg("-i2p", true)) {
+        printf("I2P: disabled (-i2p=0)\n");
+        return false;
+    }
+    fEnabled.store(true);
+
+    // -i2psam=host:port overrides the default SAM bridge endpoint.
+    std::string sam = GetArg("-i2psam", "");
+    if (!sam.empty()) {
+        int port = I2P_DEFAULT_SAM_PORT;
+        std::string host;
+        SplitHostPort(sam, port, host);
+        if (!host.empty()) samHost = host;
+        if (port > 0) samPort = port;
+    }
+
+    printf("I2P: connecting to SAM bridge at %s:%d\n", samHost.c_str(), samPort);
+
+    if (!LoadOrCreateDestination(privateKey)) {
+        printf("I2P: ERROR could not obtain a destination. Is an I2P router with "
+               "the SAM bridge enabled running at %s:%d?\n", samHost.c_str(), samPort);
+        return false;
+    }
+
+    if (!CreateSession()) {
+        printf("I2P: ERROR failed to create SAM STREAM session\n");
+        if (hSession != INVALID_SOCKET) { closesocket(hSession); hSession = INVALID_SOCKET; }
+        return false;
+    }
+
+    if (!ResolveMyB32())
+        printf("I2P: WARNING could not resolve our own .b32.i2p address yet\n");
+
+    fActive.store(true);
+    fShutdown.store(false);
+
+    printf("I2P: session active. Our address: %s\n", GetB32Address().c_str());
+
+    // Register our I2P address as a local address so peers can learn it.
+    CService meI2P;
+    if (!b32Address.empty() && meI2P.SetSpecial(b32Address)) {
+        meI2P.SetPort((unsigned short)GetListenPort());
+        AddLocal(meI2P, LOCAL_MANUAL);
+    }
+
+    acceptThread = std::thread(&CI2PSession::AcceptLoop, this);
+    return true;
+}
+
+void CI2PSession::Stop()
+{
+    if (!fEnabled.load())
+        return;
+    fShutdown.store(true);
+    fActive.store(false);
+
+    if (hSession != INVALID_SOCKET) {
+        closesocket(hSession);
+        hSession = INVALID_SOCKET;
+    }
+    if (acceptThread.joinable())
+        acceptThread.join();
+    fEnabled.store(false);
+    printf("I2P: session stopped\n");
+}
+
+// --- inbound ---------------------------------------------------------------
+
+void CI2PSession::AcceptLoop()
+{
+    while (!fShutdown.load()) {
+        SOCKET hSocket = INVALID_SOCKET;
+        if (!SamConnect(hSocket) || !SamHandshake(hSocket)) {
+            if (hSocket != INVALID_SOCKET) closesocket(hSocket);
+            if (fShutdown.load()) break;
+            MilliSleep(2000);
+            continue;
+        }
+
+        // Block here until a peer dials us; the router then streams the remote
+        // destination on its own line, after which the socket carries data.
+        if (!SamSendLine(hSocket, "STREAM ACCEPT ID=" + sessionId + " SILENT=false")) {
+            closesocket(hSocket);
+            MilliSleep(1000);
+            continue;
+        }
+
+        std::string status;
+        if (!SamRecvLine(hSocket, status) || SamGetValue(status, "RESULT") != "OK") {
+            if (!fShutdown.load())
+                printf("I2P: STREAM ACCEPT rejected: %s\n", status.c_str());
+            closesocket(hSocket);
+            MilliSleep(1000);
+            continue;
+        }
+
+        std::string remoteDest;
+        if (!SamRecvLine(hSocket, remoteDest)) {
+            closesocket(hSocket);
+            continue;
+        }
+        if (fShutdown.load()) {
+            closesocket(hSocket);
+            break;
+        }
+
+        // The first token is the remote full destination (base64).
+        std::string destTok = remoteDest;
+        size_t sp = destTok.find(' ');
+        if (sp != std::string::npos)
+            destTok = destTok.substr(0, sp);
+
+        std::string b32 = DestToB32(destTok);
+        CAddress addr;
+        if (b32.empty() || !addr.SetSpecial(b32)) {
+            printf("I2P: could not parse inbound remote destination\n");
+            closesocket(hSocket);
+            continue;
+        }
+        addr.nServices = 0;
+        addr.nTime = GetTime();
+
+        // Hand the live data socket to the net layer as an inbound peer.
+        printf("I2P: inbound connection from %s\n", b32.c_str());
+        AddI2PInboundNode(hSocket, addr);
+    }
+}
+
+// --- outbound --------------------------------------------------------------
+
+bool CI2PSession::Connect(const std::string& strDest, SOCKET& hSocketRet)
+{
+    if (!fActive.load())
+        return false;
+
+    SOCKET hSocket = INVALID_SOCKET;
+    if (!SamConnect(hSocket) || !SamHandshake(hSocket)) {
+        if (hSocket != INVALID_SOCKET) closesocket(hSocket);
+        return false;
+    }
+
+    if (!SamSendLine(hSocket, "STREAM CONNECT ID=" + sessionId +
+                              " DESTINATION=" + strDest + " SILENT=false")) {
+        closesocket(hSocket);
+        return false;
+    }
+
+    std::string status;
+    if (!SamRecvLine(hSocket, status) || SamGetValue(status, "RESULT") != "OK") {
+        printf("I2P: STREAM CONNECT to %s failed: %s\n", strDest.c_str(), status.c_str());
+        closesocket(hSocket);
+        return false;
+    }
+
+    // Socket is now a bidirectional stream to the peer.
+    hSocketRet = hSocket;
+    return true;
+}
+
+bool StartI2P()
+{
+    return CI2PSession::GetInstance()->Start();
+}
+
+void StopI2P()
+{
+    CI2PSession::GetInstance()->Stop();
+}

src/i2p.h

@@ -0,0 +1,95 @@
+// Copyright (c) 2024 Triangles developers
+// I2P (SAM v3) transport support
+// Distributed under the MIT/X11 software license, see the accompanying
+// file COPYING or http://www.opensource.org/licenses/mit-license.php.
+//
+// This module gives Triangles real I2P connectivity that mirrors the existing
+// embedded-Tor design: instead of a SOCKS proxy it talks the SAM v3 protocol
+// to a locally running I2P router (i2pd or Java I2P) and obtains a persistent
+// I2P destination whose ".b32.i2p" address is shown alongside the .onion
+// address.  The wallet:
+//   * creates / loads a persistent destination (i2p_private_key in datadir),
+//   * runs a STREAM session so peers can dial us,
+//   * accepts inbound I2P streams and feeds them to the net layer,
+//   * dials outbound ".b32.i2p" peers through the same session.
+//
+// A running I2P router with its SAM bridge enabled (default 127.0.0.1:7656) is
+// required; nothing is bundled.  Enable with -i2p and optionally -i2psam=host:port.
+
+#ifndef TRIANGLES_I2P_H
+#define TRIANGLES_I2P_H
+
+#include <atomic>
+#include <mutex>
+#include <string>
+#include <thread>
+
+#include "compat.h"   // SOCKET / INVALID_SOCKET
+
+// Default SAM bridge endpoint exposed by i2pd / Java I2P.
+#define I2P_DEFAULT_SAM_HOST "127.0.0.1"
+#define I2P_DEFAULT_SAM_PORT 7656
+
+// Manages a single persistent I2P STREAM session over SAM v3.
+class CI2PSession
+{
+public:
+    static CI2PSession* GetInstance();
+
+    // Bring the session up: connect to the SAM bridge, load/generate the
+    // persistent destination and start accepting inbound streams.
+    // Returns false (and logs) if no router/SAM bridge is reachable.
+    bool Start();
+
+    // Tear the session down and stop the accept loop.
+    void Stop();
+
+    bool IsEnabled() const { return fEnabled.load(); }
+    bool IsActive() const { return fActive.load(); }
+
+    // Our own ".b32.i2p" address (empty until the session is up).
+    std::string GetB32Address();
+
+    // Dial a remote ".b32.i2p" (or full base64 destination) through the
+    // session.  On success hSocketRet is a connected, blocking data socket the
+    // caller can hand to a CNode.  The caller takes ownership of the socket.
+    bool Connect(const std::string& strDest, SOCKET& hSocketRet);
+
+private:
+    CI2PSession();
+    ~CI2PSession();
+
+    // --- low level SAM helpers ---
+    bool SamConnect(SOCKET& hSocketRet);                 // raw TCP to the bridge
+    bool SamHandshake(SOCKET hSocket);                   // HELLO VERSION
+    bool SamSendLine(SOCKET hSocket, const std::string& strLine);
+    bool SamRecvLine(SOCKET hSocket, std::string& strLineRet);
+    static std::string SamGetValue(const std::string& strReply, const std::string& strKey);
+
+    bool LoadOrCreateDestination(std::string& strPrivKeyRet);
+    bool CreateSession();                                 // SESSION CREATE
+    bool ResolveMyB32();                                  // NAMING LOOKUP ME
+    void AcceptLoop();                                    // inbound STREAM ACCEPT
+
+    // Compute the ".b32.i2p" address from a base64 (I2P alphabet) destination.
+    static std::string DestToB32(const std::string& strB64Dest);
+
+    std::string samHost;
+    int samPort;
+    std::string sessionId;
+    std::string privateKey;   // persistent destination private key (base64)
+    std::string b32Address;   // our own .b32.i2p
+    SOCKET hSession;          // long-lived control socket owning the session
+
+    std::atomic<bool> fEnabled;
+    std::atomic<bool> fActive;
+    std::atomic<bool> fShutdown;
+    std::thread acceptThread;
+    std::mutex cs;
+};
+
+// Convenience: start/stop from init.cpp.
+bool StartI2P();
+void StopI2P();
+
+#endif // TRIANGLES_I2P_H

src/i2p/build-libi2pd.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+I2PD_SRC_DIR="${I2PD_SRC_DIR:-$ROOT_DIR/i2pd-src}"
+
+if [[ ! -d "$I2PD_SRC_DIR" ]]; then
+  echo "i2pd source tree not found at: $I2PD_SRC_DIR" >&2
+  exit 1
+fi
+
+cd "$I2PD_SRC_DIR"
+
+echo "Building libi2pd static libraries from: $I2PD_SRC_DIR"
+
+NPROC_VAL="${NPROC:-$(getconf _NPROCESSORS_ONLN 2>/dev/null || echo 4)}"
+
+# Detect the correct OpenSSL formula path on macOS. The i2pd
+# Makefile.homebrew hardcodes openssl@3.5 but Homebrew may install
+# openssl@3 instead. Command-line make variables override Makefile
+# assignments, so passing SSLROOT=<detected> fixes the include path.
+EXTRA_MAKE_ARGS=()
+if [[ "$(uname -s)" == "Darwin" ]]; then
+  if [[ -d "/opt/homebrew/opt/openssl@3" ]]; then
+    SSLROOT="/opt/homebrew/opt/openssl@3"
+  elif [[ -d "/usr/local/opt/openssl@3" ]]; then
+    SSLROOT="/usr/local/opt/openssl@3"
+  fi
+  if [[ -n "${SSLROOT:-}" ]]; then
+    echo "Detected OpenSSL at: $SSLROOT (overriding Makefile.homebrew)"
+    EXTRA_MAKE_ARGS+=("SSLROOT=${SSLROOT}")
+  fi
+fi
+
+# i2pd uses a hand-written Makefile system. We build only the static library
+# targets (libi2pd.a, libi2pdclient.a, libi2pdlang.a), NOT the standalone
+# i2pd daemon binary, which pulls in HTTPServer/I2PControl deps we don't need
+# and can OOM on memory-constrained build machines.
+make -j"$NPROC_VAL" USE_STATIC=no "${EXTRA_MAKE_ARGS[@]}" libi2pd.a libi2pdclient.a libi2pdlang.a
+
+echo
+echo "Build finished. Static libraries:"
+ls -lh libi2pd*.a
+echo
+echo "Suggested next step for Triangles:"
+echo "  cmake -DUSE_I2P_EMBEDDED=ON -DI2P_SOURCE_ROOT=src/i2p/i2pd-src .."

src/i2p/i2p_embedded.h

@@ -0,0 +1,181 @@
+// Copyright (c) 2025-2026 Triangles developers
+// Embedded I2P (i2pd) integration - runs an I2P router in-process
+// Distributed under the MIT/X11 software license
+
+#ifndef TRIANGLES_I2P_EMBEDDED_H
+#define TRIANGLES_I2P_EMBEDDED_H
+
+#include <string>
+#include <atomic>
+#include <mutex>
+#include <thread>
+
+// Cross-platform socket handle for SAM v3 streaming API.
+// On Windows this is the native SOCKET type; on POSIX it is int (fd).
+#ifdef WIN32
+#  include <winsock2.h>
+   typedef SOCKET I2pSocket_t;
+#  define I2P_INVALID_SOCKET  INVALID_SOCKET
+#else
+   typedef int I2pSocket_t;
+#  define I2P_INVALID_SOCKET  (-1)
+#endif
+
+// ---------------------------------------------------------------------------
+//  CI2PSamSocket — SAM v3 direct streaming socket
+//
+//  Wraps a raw TCP socket to the i2pd SAM bridge. After Connect() succeeds,
+//  the underlying socket is a bidirectional byte stream to the I2P
+//  destination with NO SOCKS overhead. The Triangles P2P layer can read and
+//  write directly once ownership is taken via GetRawSocket().
+//
+//  Lifecycle:
+//    1. Construct
+//    2. Connect(dest_b32, port)  — performs SAM SESSION CREATE + STREAM CONNECT
+//    3. GetRawSocket()           — take the fd for direct read/write
+//    4. The fd must be closed by the caller (e.g. via CloseSocket())
+//
+//  If Connect() fails, GetLastError() returns a human-readable diagnostic.
+// ---------------------------------------------------------------------------
+class CI2PSamSocket
+{
+public:
+    CI2PSamSocket();
+    ~CI2PSamSocket();
+
+    CI2PSamSocket(const CI2PSamSocket&) = delete;
+    CI2PSamSocket& operator=(const CI2PSamSocket&) = delete;
+
+    // Perform the full SAM v3 handshake (HELLO → SESSION CREATE → STREAM CONNECT)
+    // to reach dest_b32 (a .b32.i2p hostname).  samHost/samPort identify the
+    // local SAM bridge (default 127.0.0.1:7656).
+    //
+    // The |port| argument is accepted for API symmetry with the Tor SOCKS
+    // connection factory but is not part of the SAM v3 STREAM CONNECT request
+    // (I2P destinations are address-only; there is no TCP-style port).
+    bool Connect(const std::string& dest_b32, int port,
+                 const std::string& samHost = "127.0.0.1", int samPort = 7656);
+
+    // Release ownership of the raw socket fd. After this call the object
+    // will not close it and the caller is responsible for cleanup.
+    // Returns I2P_INVALID_SOCKET if not connected.
+    I2pSocket_t GetRawSocket();
+
+    // Close the socket if still owned (no-op after GetRawSocket()).
+    void CloseSocket();
+
+    bool IsValid() const { return rawSocket != I2P_INVALID_SOCKET; }
+    std::string GetLastError() const { return lastError; }
+
+    // The base64 local destination returned by SESSION STATUS (may be empty).
+    const std::string& GetLocalDestination() const { return localDestination; }
+
+private:
+    I2pSocket_t rawSocket;
+    std::string sessionId;
+    std::string localDestination;
+    std::string lastError;
+    std::string recvBuffer;   // partial SAM response buffering
+
+    // --- SAM protocol helpers ---
+    bool SamConnect(const std::string& host, int port);
+    bool SendLine(const std::string& line);
+    bool ReadLine(std::string& lineOut);
+    static std::string ParseValue(const std::string& line, const std::string& key);
+};
+
+// Embedded I2P router state
+class CI2PEmbedded
+{
+private:
+    static CI2PEmbedded* instance;
+    std::atomic<bool> running;
+    int socksPort;          // i2pd SOCKS proxy port (for outbound .i2p connections)
+    int samPort;            // i2pd SAM bridge port (for SAM v3 protocol)
+    int serverPort;         // Triangles P2P listen port (for incoming I2P connections)
+    std::string i2pDataDir; // i2pd data directory (under wallet datadir)
+    // Hostname and discovery-error cache are read by the Qt UI thread
+    // (qt/trianglesgui.cpp:1875 updateI2PAddress) on every 5s timerI2P
+    // tick and written by the bootstrap thread. Mutex-guarded to avoid
+    // a C++ data race on the std::string itself.
+    mutable std::mutex hostnameMutex;
+    std::string i2pHostname; // Our .b32.i2p address (available after router startup)
+    std::string lastError;
+    // I2P bootstrap runs in a background thread; we keep the handle so Stop()
+    // can join it. (A detached thread that is still running blocks process exit.)
+    std::thread routerThread;
+
+    // Server-tunnel destination discovery.
+    //
+    // Scans the live server tunnel registry (i2p::client::context
+    // ::GetServerTunnels()) for an entry whose ident hash matches the
+    // public key in triangles-p2p-keys.dat. Sets i2pHostname to the
+    // corresponding ".b32.i2p" address on success; leaves i2pHostname
+    // empty otherwise. Thread-safe: the registry scan is mutex-guarded
+    // inside libi2pd_client; we only read the resulting map.
+    //
+    // This is a no-op when serverPort == 0 (no inbound server tunnel
+    // configured — pure outbound SOCKS I2P mode).
+    //
+    // Idempotent. Called from the bootstrap thread AND from
+    // GetI2PAddress() when i2pHostname is empty, so the Qt timerI2P
+    // (qt/trianglesgui.cpp:384-387) picks up the result on its next
+    // 5s tick once the tunnel registers.
+    void DiscoverServerTunnelDestination();
+
+    // Cache the most recent discovery failure reason (parsed keys-file
+    // hash, registry-read error, etc.). Visible only to GetStartupError()
+    // callers in the header — no public accessor for lastDiscoveryError
+    // is needed today.
+    std::string lastDiscoveryError;
+
+public:
+    static CI2PEmbedded* GetInstance();
+
+    CI2PEmbedded();
+    ~CI2PEmbedded();
+
+    // Start embedded i2pd router (blocks calling thread briefly during init)
+    bool Start(int socksPort = 19100, int samPort = 7656, int serverPort = 0);
+
+    // Request i2pd to shut down
+    void Stop();
+
+    // Check if i2pd is running
+    bool IsRunning() const { return running.load(); }
+    void SetRunning(bool value) { running.store(value); }
+
+    // Get the SOCKS5 proxy address for outbound .i2p connections
+    std::string GetSocksProxy() const;
+    int GetSocksPort() const { return socksPort; }
+    int GetSamPort() const { return samPort; }
+    int GetServerPort() const { return serverPort; }
+    const std::string& GetDataDir() const { return i2pDataDir; }
+
+    // Get our .b32.i2p destination address. Triggers a discovery retry
+    // if the hostname is empty (e.g. first attempt raced the tunnel
+    // registration). Idempotent and cheap when the hostname is already
+    // populated.
+    std::string GetI2PAddress();
+    std::string GetStartupError() const { return lastError; }
+    void SetStartupError(const std::string& value) { lastError = value; }
+
+    // -------------------------------------------------------------------
+    //  SAM v3 direct streaming API
+    // -------------------------------------------------------------------
+
+    // Create a SAM v3 connection to a .b32.i2p destination.
+    // Returns a heap-allocated CI2PSamSocket on success (caller owns it
+    // and must CloseSocket / delete), or nullptr on failure.  Use
+    // GetLastError() on the returned object for diagnostics.
+    CI2PSamSocket* CreateConnection(const std::string& dest_b32, int port);
+
+    // Probe whether the SAM bridge port is accepting TCP connections.
+    bool IsSamAvailable() const;
+};
+
+// Global init/shutdown hooks (called from init.cpp)
+bool StartEmbeddedI2P();
+void StopEmbeddedI2P();
+
+#endif // TRIANGLES_I2P_EMBEDDED_H

src/i2p/i2pseed.h

@@ -0,0 +1,30 @@
+#ifndef TRIANGLES_I2PSEED_H
+#define TRIANGLES_I2PSEED_H
+
+// Hardcoded I2P seed nodes for initial peer discovery.
+// These are .b32.i2p addresses (Destination hashes).
+// Nodes must run i2pd (embedded or external) with a server tunnel
+// forwarding to the Triangles P2P port.
+//
+// NOTE: .b32.i2p addresses are derived from the destination's public key.
+// They are generated when the node first creates its I2P tunnel keys.
+// These addresses were captured from running daemons via getnetworkinfo
+// on 2026-08-05. See i2pseed-capture-2026-08-05.md for the raw outputs.
+//
+// Dynamic seeds are also available at:
+//   https://seeds.cryptographic-triangles.org/i2p-seeds.txt
+static const char *strMainNetI2PSeed[][1] = {
+    // SAMI-PC - authoritative wallet node (main PC). Captured 2026-08-05.
+    {"fecv4pomdm47epuadgrpkvxzjqfqwsjfc7t7xadwaac5bislyrhq.b32.i2p"},
+    // DNS2 - primary bootstrap server (194.233.88.206). Captured 2026-08-05.
+    {"7d5gujh6tw6xbd2uquedhpm3ixoglsgt3nkfqb4b5lvunhjdb2kq.b32.i2p"},
+    // DNS3 - canonical chain reference (74.208.167.19). Captured 2026-08-05.
+    {"jdrpj364rmdule7rw2jdl63wvk3kbaivuje7wyhayugjbxvgbj2a.b32.i2p"},
+    {nullptr}
+};
+
+static const char *strTestNetI2PSeed[][1] = {
+    {nullptr}
+};
+
+#endif

src/i2p_process.cpp

@@ -0,0 +1,368 @@
+// Copyright (c) 2024 Triangles developers
+// I2P Router Process Manager - launches and manages a bundled i2pd binary
+// Distributed under the MIT/X11 software license
+
+#ifdef WIN32
+#define NOMINMAX
+#ifndef WIN32_LEAN_AND_MEAN
+#define WIN32_LEAN_AND_MEAN
+#endif
+#ifndef _WIN32_WINNT
+#define _WIN32_WINNT 0x0600
+#endif
+#endif
+
+#include "i2p_process.h"
+#include "util.h"
+
+#include <filesystem>
+#include <fstream>
+#include <sstream>
+#include <vector>
+
+#ifdef WIN32
+#include <winsock2.h>
+#include <ws2tcpip.h>
+#include <tlhelp32.h>
+#include <windows.h>
+#else
+#include <sys/types.h>
+#include <sys/wait.h>
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <arpa/inet.h>
+#include <signal.h>
+#include <unistd.h>
+#endif
+
+namespace fs = std::filesystem;
+
+static CI2PProcess* i2pProcessInstance = nullptr;
+
+CI2PProcess* CI2PProcess::GetInstance()
+{
+    if (!i2pProcessInstance)
+        i2pProcessInstance = new CI2PProcess();
+    return i2pProcessInstance;
+}
+
+CI2PProcess::CI2PProcess()
+    : samPort(7656)
+    , running(false)
+    , fExternal(false)
+#ifdef WIN32
+    , hProcess(nullptr)
+    , hJob(nullptr)
+    , processId(0)
+#else
+    , processId(0)
+#endif
+{
+}
+
+CI2PProcess::~CI2PProcess()
+{
+    Stop();
+}
+
+// Try a quick TCP connect; success means something is already listening
+// (e.g. the SAM bridge is up, or an external router is running).
+bool CI2PProcess::CanConnect(const std::string& host, int port)
+{
+#ifdef WIN32
+    SOCKET s = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
+    if (s == INVALID_SOCKET) return false;
+#else
+    int s = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
+    if (s < 0) return false;
+#endif
+    struct sockaddr_in addr;
+    memset(&addr, 0, sizeof(addr));
+    addr.sin_family = AF_INET;
+    addr.sin_port = htons((unsigned short)port);
+    addr.sin_addr.s_addr = inet_addr(host.c_str());
+    bool ok = (connect(s, (struct sockaddr*)&addr, sizeof(addr)) == 0);
+#ifdef WIN32
+    closesocket(s);
+#else
+    close(s);
+#endif
+    return ok;
+}
+
+std::string CI2PProcess::FindI2pdBinary()
+{
+    std::vector<std::string> candidates;
+
+#ifdef WIN32
+    const char* exeName = "i2pd.exe";
+#else
+    const char* exeName = "i2pd";
+#endif
+
+    // 1. Next to the wallet executable (this is how tor.exe is shipped).
+    try {
+        fs::path exeDir;
+#ifdef WIN32
+        char buf[MAX_PATH];
+        if (GetModuleFileNameA(nullptr, buf, MAX_PATH) > 0)
+            exeDir = fs::path(buf).parent_path();
+#else
+        exeDir = fs::current_path();
+#endif
+        if (!exeDir.empty()) {
+            candidates.push_back((exeDir / exeName).string());
+            candidates.push_back((exeDir / "i2pd" / exeName).string());
+            candidates.push_back((exeDir / "I2P" / exeName).string());
+        }
+    } catch (...) {}
+
+    // 2. In / next to the data directory.
+    candidates.push_back((GetDataDir() / exeName).string());
+    candidates.push_back((GetDataDir() / "i2pd" / exeName).string());
+
+    // 3. Common system locations.
+#ifdef WIN32
+    if (const char* pf = getenv("ProgramFiles"))
+        candidates.push_back(std::string(pf) + "\\i2pd\\" + exeName);
+    if (const char* pfx = getenv("ProgramFiles(x86)"))
+        candidates.push_back(std::string(pfx) + "\\i2pd\\" + exeName);
+    candidates.push_back(std::string("C:\\i2pd\\") + exeName);
+#else
+    candidates.push_back("/usr/bin/i2pd");
+    candidates.push_back("/usr/local/bin/i2pd");
+    candidates.push_back("/opt/i2pd/bin/i2pd");
+    candidates.push_back("/opt/homebrew/bin/i2pd");
+    candidates.push_back("/usr/local/opt/i2pd/bin/i2pd");
+#endif
+
+    for (const std::string& c : candidates) {
+        try {
+            if (fs::exists(c) && fs::is_regular_file(c)) {
+                printf("I2P: found i2pd binary at %s\n", c.c_str());
+                return c;
+            }
+        } catch (...) {}
+    }
+
+    return "";
+}
+
+bool CI2PProcess::WriteConfig()
+{
+    fs::path dir(dataDir);
+    try {
+        fs::create_directories(dir);
+    } catch (const std::exception& e) {
+        lastError = std::string("Cannot create i2pd data directory: ") + e.what();
+        return false;
+    }
+
+    confPath = (dir / "i2pd.conf").string();
+    fs::path logPath = dir / "i2pd.log";
+
+    std::ofstream conf(confPath.c_str(), std::ios::trunc);
+    if (!conf.is_open()) {
+        lastError = "Cannot write i2pd.conf to " + confPath;
+        return false;
+    }
+
+    conf << "# Triangles Wallet I2P configuration (auto-generated)\n";
+    conf << "# Do not edit - this file is overwritten on startup\n\n";
+    conf << "daemon = false\n";
+    conf << "log = file\n";
+    conf << "logfile = " << logPath.string() << "\n";
+    conf << "datadir = " << dir.string() << "\n\n";
+
+    // The bridge our SAM client talks to.
+    conf << "[sam]\n";
+    conf << "enabled = true\n";
+    conf << "address = 127.0.0.1\n";
+    conf << "port = " << samPort << "\n\n";
+
+    // We only need SAM; keep everything else off to minimise footprint.
+    conf << "[httpproxy]\nenabled = false\n\n";
+    conf << "[socksproxy]\nenabled = false\n\n";
+    conf << "[http]\nenabled = false\n\n";
+    conf << "[i2pcontrol]\nenabled = false\n";
+
+    conf.close();
+    printf("I2P: wrote i2pd config to %s (SAM port %d)\n", confPath.c_str(), samPort);
+    return true;
+}
+
+bool CI2PProcess::Start(const std::string& dataDirIn, int samPortIn)
+{
+    dataDir = dataDirIn;
+    samPort = samPortIn;
+    fExternal = false;
+    lastError.clear();
+
+    // If a SAM bridge is already up, use it instead of launching our own.
+    if (CanConnect("127.0.0.1", samPort)) {
+        printf("I2P: detected an I2P router already listening on SAM port %d; using it\n", samPort);
+        fExternal = true;
+        return true;
+    }
+
+    binaryPath = FindI2pdBinary();
+    if (binaryPath.empty()) {
+        lastError = "No i2pd binary found (ship i2pd alongside the wallet, like tor)";
+        printf("I2P: %s\n", lastError.c_str());
+        return false;
+    }
+
+    if (!WriteConfig())
+        return false;
+
+    printf("I2P: starting i2pd: %s --conf %s\n", binaryPath.c_str(), confPath.c_str());
+
+#ifdef WIN32
+    STARTUPINFOA si;
+    PROCESS_INFORMATION pi;
+    ZeroMemory(&si, sizeof(si));
+    si.cb = sizeof(si);
+    si.dwFlags = STARTF_USESHOWWINDOW;
+    si.wShowWindow = SW_HIDE;
+    ZeroMemory(&pi, sizeof(pi));
+
+    std::string cmdLine = "\"" + binaryPath + "\" --conf \"" + confPath + "\"";
+
+    if (!CreateProcessA(nullptr, (LPSTR)cmdLine.c_str(), nullptr, nullptr,
+                        FALSE, CREATE_NO_WINDOW, nullptr, nullptr, &si, &pi)) {
+        DWORD err = ::GetLastError();
+        lastError = strprintf("CreateProcess failed for i2pd '%s' (Windows error %lu)", binaryPath.c_str(), err);
+        printf("I2P: ERROR %s\n", lastError.c_str());
+        return false;
+    }
+
+    hProcess = pi.hProcess;
+    processId = pi.dwProcessId;
+    CloseHandle(pi.hThread);
+
+    // Kill i2pd if the wallet dies (matches the embedded Tor behaviour).
+    hJob = CreateJobObject(nullptr, nullptr);
+    if (hJob) {
+        JOBOBJECT_EXTENDED_LIMIT_INFORMATION jobInfo = {};
+        jobInfo.BasicLimitInformation.LimitFlags = JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE;
+        SetInformationJobObject(hJob, JobObjectExtendedLimitInformation, &jobInfo, sizeof(jobInfo));
+        if (!AssignProcessToJobObject(hJob, hProcess))
+            printf("I2P: WARNING could not assign i2pd to Job Object (error %lu)\n", GetLastError());
+    }
+
+    printf("I2P: i2pd started (PID %lu)\n", processId);
+#else
+    pid_t pid = fork();
+    if (pid < 0) {
+        lastError = "Failed to fork for i2pd process";
+        printf("I2P: ERROR %s\n", lastError.c_str());
+        return false;
+    }
+    if (pid == 0) {
+        freopen("/dev/null", "w", stdout);
+        freopen("/dev/null", "w", stderr);
+        execl(binaryPath.c_str(), binaryPath.c_str(),
+              "--conf", confPath.c_str(), (char*)nullptr);
+        _exit(1);
+    }
+    processId = pid;
+    printf("I2P: i2pd started (PID %d)\n", processId);
+#endif
+
+    running = true;
+
+    // Wait for the SAM bridge to come up. The bridge opens quickly; tunnel
+    // build (needed for actual connectivity) continues in the background.
+    printf("I2P: waiting for SAM bridge on port %d...\n", samPort);
+    for (int i = 0; i < 45; i++) {
+        MilliSleep(1000);
+        if (fShutdown) {
+            Stop();
+            return false;
+        }
+        if (CanConnect("127.0.0.1", samPort)) {
+            printf("I2P: SAM bridge ready on port %d (took %ds)\n", samPort, i + 1);
+            return true;
+        }
+        if (!IsRunning()) {
+            lastError = "i2pd exited during start-up before the SAM bridge became ready";
+            printf("I2P: ERROR %s\n", lastError.c_str());
+            running = false;
+            return false;
+        }
+    }
+
+    lastError = strprintf("i2pd started but SAM port %d not ready after 45s", samPort);
+    printf("I2P: WARNING %s (it may still be building tunnels)\n", lastError.c_str());
+    return true;
+}
+
+void CI2PProcess::Stop()
+{
+    if (fExternal) {
+        // We never launched it; leave the user's router running.
+        running = false;
+        return;
+    }
+    if (!running) return;
+
+#ifdef WIN32
+    if (hProcess != nullptr) {
+        printf("I2P: stopping i2pd (PID %lu)...\n", processId);
+        TerminateProcess(hProcess, 0);
+        WaitForSingleObject(hProcess, 5000);
+        CloseHandle(hProcess);
+        hProcess = nullptr;
+    }
+    if (hJob != nullptr) {
+        CloseHandle(hJob);
+        hJob = nullptr;
+    }
+#else
+    if (processId > 0) {
+        printf("I2P: stopping i2pd (PID %d)...\n", processId);
+        kill(processId, SIGTERM);
+        for (int i = 0; i < 50; i++) {
+            int status;
+            pid_t result = waitpid(processId, &status, WNOHANG);
+            if (result != 0) break;
+            MilliSleep(100);
+        }
+        kill(processId, SIGKILL);
+        waitpid(processId, nullptr, 0);
+    }
+#endif
+
+    processId = 0;
+    running = false;
+    printf("I2P: i2pd stopped\n");
+}
+
+bool CI2PProcess::IsRunning()
+{
+    if (fExternal) return true;
+    if (!running) return false;
+
+#ifdef WIN32
+    if (hProcess == nullptr) return false;
+    DWORD exitCode;
+    if (GetExitCodeProcess(hProcess, &exitCode))
+        return (exitCode == STILL_ACTIVE);
+    return false;
+#else
+    if (processId <= 0) return false;
+    int status;
+    pid_t result = waitpid(processId, &status, WNOHANG);
+    return (result == 0); // 0 => still running
+#endif
+}
+
+bool StartEmbeddedI2P(const std::string& dataDir, int samPort)
+{
+    return CI2PProcess::GetInstance()->Start(dataDir, samPort);
+}
+
+void StopEmbeddedI2P()
+{
+    CI2PProcess::GetInstance()->Stop();
+}

src/i2p_process.h

@@ -0,0 +1,70 @@
+// Copyright (c) 2024 Triangles developers
+// I2P Router Process Manager - launches and manages a bundled i2pd binary
+// Distributed under the MIT/X11 software license
+//
+// Mirrors tor_process.cpp: locate an i2pd executable shipped alongside the
+// wallet (or installed on the system), write an auto-generated config that
+// enables the SAM bridge, launch it as a managed child process, and shut it
+// down when the wallet exits. The SAM session in i2p.cpp then connects to it,
+// so the user does not have to install or run a separate I2P router.
+
+#ifndef TRIANGLES_I2P_PROCESS_H
+#define TRIANGLES_I2P_PROCESS_H
+
+#include <string>
+
+#ifdef WIN32
+#ifndef NOMINMAX
+#define NOMINMAX
+#endif
+#include <windows.h>
+#endif
+
+class CI2PProcess
+{
+public:
+    static CI2PProcess* GetInstance();
+
+    CI2PProcess();
+    ~CI2PProcess();
+
+    // Bring up the router. If something is already listening on the SAM port we
+    // assume an external router and do not launch our own (fExternal=true).
+    // Returns true if a SAM bridge is (or will shortly be) reachable.
+    bool Start(const std::string& dataDir, int samPort = 7656);
+
+    // Terminate the launched router (no-op for an external one).
+    void Stop();
+
+    bool IsRunning();
+    bool IsExternal() const { return fExternal; }
+    std::string GetLastError() const { return lastError; }
+    std::string GetBinaryPath() const { return binaryPath; }
+
+private:
+    std::string FindI2pdBinary();
+    bool WriteConfig();
+    static bool CanConnect(const std::string& host, int port);
+
+    int samPort;
+    bool running;
+    bool fExternal;
+    std::string dataDir;
+    std::string binaryPath;
+    std::string confPath;
+    std::string lastError;
+
+#ifdef WIN32
+    HANDLE hProcess;
+    HANDLE hJob;
+    DWORD processId;
+#else
+    int processId;
+#endif
+};
+
+// Convenience wrappers for init.cpp.
+bool StartEmbeddedI2P(const std::string& dataDir, int samPort);
+void StopEmbeddedI2P();
+
+#endif // TRIANGLES_I2P_PROCESS_H

src/init.h

@@ -12,6 +12,7 @@
 extern std::unique_ptr<CWallet> pwalletMain;
 extern std::string strWalletFileName;
 void StartShutdown();
+void MarkShutdownFailure();
 bool ShutdownRequested();
 void Shutdown(void* parg);
 bool AppInit2();
@@ -19,4 +20,3 @@ std::string HelpMessage();
 
 #endif
 
-

src/kernel.cpp

@@ -31,24 +31,27 @@ int64_t GetWeight(int64_t nIntervalBeginning, int64_t nIntervalEnd)
     if (nAge < 0)
         return 0;
 
-    // After v5 fork: use soft cap of 7 days instead of hard nStakeMaxAge.
-    // This prevents "stake surprise" where a whale who was offline for weeks
-    // comes back with massively amplified staking power and dominates blocks.
-    // The 7-day cap still allows generous accumulation while limiting abuse.
-    static const int64_t STAKE_AGE_SOFT_CAP = 7 * 24 * 60 * 60; // 7 days
-    // Activation gate: the soft cap shipped 2026-04-20 without a height/time
-    // gate, retroactively invalidating earlier blocks staked with long-aged
-    // coins (e.g. coins idle through the 2022-2026 freeze).  Apply the cap
-    // only to stakes after the activation timestamp; historical stakes
-    // validate under the rules they were created with (uncapped age).
-    static const int64_t STAKE_AGE_SOFT_CAP_ACTIVATION = 1776000000; // 2026-04-12 ~13:20 UTC
-    if (pindexBest && pindexBest->nHeight >= FORK_HEIGHT_V5)
-    {
-        if (nIntervalEnd >= STAKE_AGE_SOFT_CAP_ACTIVATION)
-            return min(nAge, STAKE_AGE_SOFT_CAP);
-        return nAge;
-    }
-
+    // Original Peercoin/PPCoin behavior: hard cap at nStakeMaxAge.
+    //
+    // Historical context: an earlier V5-fork variant of this function
+    // replaced the cap with a 7-day SOFT cap (STAKE_AGE_SOFT_CAP), with an
+    // activation gate of 2026-04-12. The intent was to limit "stake
+    // surprise" from whales returning after long offline periods. The
+    // side effect was to cap long-dormant coins at the same weight as
+    // freshly-staked coins, eliminating the diamond-hands incentive that
+    // makes PoS economically meaningful for long-term holders.
+    //
+    // The chain froze at block 2,224,763 on 2026-07-18 — over 14 days
+    // later — with no blocks produced during the entire soft-cap window.
+    // Reverting to the original uncapped cap restores the original
+    // Peercoin staking economics for future blocks.
+    //
+    // Validation safety: the soft-cap branch was gated to require
+    // nIntervalEnd >= 1776000000 (2026-04-12), AND pindexBest->nHeight
+    // >= FORK_HEIGHT_V5. The chain never advanced past block 2,224,763
+    // during the soft-cap window, so no historical block was ever
+    // validated under the soft cap. Therefore reverting this branch
+    // changes zero historical block validation results.
     return min(nAge, (int64_t)nStakeMaxAge);
 }
 

src/keystore.cpp

@@ -190,28 +190,49 @@ bool CCryptoKeyStore::GetPubKey(const CKeyID &address, CPubKey& vchPubKeyOut) co
     return false;
 }
 
-bool CCryptoKeyStore::EncryptKeys(CKeyingMaterial& vMasterKeyIn)
+bool CCryptoKeyStore::PrepareKeyEncryption(CKeyingMaterial& vMasterKeyIn,
+                                           CryptedKeyMap& cryptedKeysOut) const
 {
-    {
-        LOCK(cs_KeyStore);
-        if (!mapCryptedKeys.empty() || IsCrypted())
-            return false;
+    LOCK(cs_KeyStore);
+    if (!mapCryptedKeys.empty() || IsCrypted())
+        return false;
 
-        fUseCrypto = true;
-        for (KeyMap::value_type& mKey : mapKeys)
-        {
-            CKey key;
-            if (!key.SetSecret(mKey.second.first, mKey.second.second))
-                return false;
-            const CPubKey vchPubKey = key.GetPubKey();
-            std::vector<unsigned char> vchCryptedSecret;
-            bool fCompressed;
-            if (!EncryptSecret(vMasterKeyIn, key.GetSecret(fCompressed), vchPubKey.GetHash(), vchCryptedSecret))
-                return false;
-            if (!AddCryptedKey(vchPubKey, vchCryptedSecret))
-                return false;
-        }
-        mapKeys.clear();
+    cryptedKeysOut.clear();
+    for (const KeyMap::value_type& mKey : mapKeys)
+    {
+        CKey key;
+        if (!key.SetSecret(mKey.second.first, mKey.second.second))
+            return false;
+        const CPubKey vchPubKey = key.GetPubKey();
+        std::vector<unsigned char> vchCryptedSecret;
+        bool fCompressed;
+        if (!EncryptSecret(vMasterKeyIn, key.GetSecret(fCompressed),
+                           vchPubKey.GetHash(), vchCryptedSecret))
+            return false;
+        if (!cryptedKeysOut.emplace(vchPubKey.GetID(),
+                                    std::make_pair(vchPubKey,
+                                                   std::move(vchCryptedSecret))).second)
+            return false;
     }
+    return cryptedKeysOut.size() == mapKeys.size();
+}
+
+bool CCryptoKeyStore::CommitKeyEncryption(CryptedKeyMap&& cryptedKeys)
+{
+    LOCK(cs_KeyStore);
+    if (!mapCryptedKeys.empty() || IsCrypted() || cryptedKeys.size() != mapKeys.size())
+        return false;
+
+    mapCryptedKeys = std::move(cryptedKeys);
+    mapKeys.clear();
+    fUseCrypto = true;
     return true;
 }
+
+bool CCryptoKeyStore::EncryptKeys(CKeyingMaterial& vMasterKeyIn)
+{
+    CryptedKeyMap cryptedKeys;
+    if (!PrepareKeyEncryption(vMasterKeyIn, cryptedKeys))
+        return false;
+    return CommitKeyEncryption(std::move(cryptedKeys));
+}

src/keystore.h

@@ -9,6 +9,8 @@
 #include "util_signal.h"
 #include "sync.h"
 
+#include <utility>
+
 class CScript;
 
 /** A virtual base class for key stores */
@@ -112,7 +114,13 @@ protected:
 
     bool SetCrypted();
 
-    // will encrypt previously unencrypted keys
+    // Stage and commit wallet-key encryption separately so callers can make
+    // the on-disk update atomic before discarding plaintext keys in memory.
+    bool PrepareKeyEncryption(CKeyingMaterial& vMasterKeyIn,
+                              CryptedKeyMap& cryptedKeysOut) const;
+    bool CommitKeyEncryption(CryptedKeyMap&& cryptedKeys);
+
+    // Encrypt previously unencrypted keys in memory.
     bool EncryptKeys(CKeyingMaterial& vMasterKeyIn);
 
     bool Unlock(const CKeyingMaterial& vMasterKeyIn);

src/main.h

@@ -42,7 +42,18 @@ constexpr unsigned int MAX_BLOCK_SIGOPS = MAX_BLOCK_SIZE/50;
 constexpr unsigned int MAX_ORPHAN_TRANSACTIONS = MAX_BLOCK_SIZE/100;
 constexpr unsigned int MAX_ORPHAN_BLOCKS = 750;
 constexpr unsigned int MAX_ORPHAN_BLOCKS_IBD = 1500;
-constexpr unsigned int MAX_REORG_DEPTH = 100;  // reject reorgs deeper than this (finality)
+// MAX_REORG_DEPTH is retained as a compile-time constant for tests and
+// legacy callers but no longer gates reorgs above the hardened checkpoint.
+// See Reorganize() in main.cpp for the new convergence rule.
+constexpr unsigned int MAX_REORG_DEPTH = 100;  // historical finality depth (no longer enforced)
+
+// ASSUME_VALID_BUFFER: how many blocks BACK from the tip to keep fully
+// validating. Blocks at or below nAssumeValidThreshold take the fast path
+// (skip sigops/script/UTXO validation) because we've already verified the
+// entire chain up to that height. We always validate the last BUFFER blocks
+// so a reorg attack that rewrites the top of the chain is caught immediately.
+// Lower = safer, higher = faster sync.
+constexpr unsigned int ASSUME_VALID_BUFFER = 100;
 constexpr unsigned int MAX_INV_SZ = 50000;
 constexpr int64_t MIN_TX_FEE = (1 * CENT) / 100;
 constexpr int64_t MIN_RELAY_TX_FEE = (1 * CENT) / 100;
@@ -83,11 +94,13 @@ extern unsigned int nStakeMinAge;
 extern unsigned int nNodeLifespan;
 extern int nCoinbaseMaturity;
 extern int nBestHeight;
+extern bool fLoadedFromSnapshot; // true after successful UtxoSnapshot::LoadSnapshot
 extern uint256 nBestChainTrust;
 extern uint256 nBestInvalidTrust;
 extern uint256 hashBestChain;
 extern CBlockIndex* pindexBest;
-extern CBlockIndex* pindexFinalized;  // auto-checkpoint: deepest finalized block
+extern CBlockIndex* pindexLastHardenedCheckpoint;  // last compiled hardened checkpoint in our local index (set at startup only; never advanced at runtime)
+extern int nAssumeValidThreshold;      // highest height covered by assumeValid fast path
 extern unsigned int nTransactionsUpdated;
 extern uint64_t nLastBlockTx;
 extern uint64_t nLastBlockSize;
@@ -137,7 +150,34 @@ int64_t GetProofOfStakeReward(int64_t nCoinAge, int64_t nFees);
 unsigned int ComputeMinWork(unsigned int nBase, int64_t nTime);
 unsigned int ComputeMinStake(unsigned int nBase, int64_t nTime, unsigned int nBlockTime);
 int GetNumBlocksOfPeers();
+
+// IsStakingSafe: continuous safety gate for StakeMiner (fix/consensus-convergence).
+//
+// Returns true only when the following conditions ALL hold:
+//   - Not in IBD (IsInitialBlockDownload)
+//   - At least 2 fully connected, non-disconnecting peers
+//   - Our active chain height is at or above the peer median
+//   - We do not have a chain-trust deficit relative to peers we trust
+//
+// The chain-trust-vs-peers check is a defensive guard against staking
+// on an isolated chain while another competing fork has equal or
+// greater cumulative trust on the network. Without peer-tip-hash
+// agreement (which is a separate protocol-level follow-up, not in this
+// branch) the most we can honestly assert is "our height matches or
+// exceeds the peer median" — that catches the failure mode this gate
+// was added to prevent (laptop alone minting against an isolated
+// consensus state). The full chain-trust comparison is left as a
+// follow-up that requires real peer-tip-hash state.
+//
+// Caller may pass an empty peer list to simulate a network outage
+// (useful from staking_tests).
+bool IsStakingSafe(const CWallet* pwallet, const std::vector<CNode*>& vNodesSnapshot);
 [[nodiscard]] bool IsInitialBlockDownload();
+// Height-based consensus fast path for historical checkpoint / rolling
+// assume-valid validation. This intentionally excludes operational IBD states
+// such as a stale tip; stale-tip IBD must not disable live PoS checks.
+[[nodiscard]] bool IsConsensusAssumeValidHeight(int nHeight);
+[[nodiscard]] bool IsBlockSignatureRequiredAtHeight(int nHeight);
 std::string GetWarnings(std::string strFor);
 bool GetTransaction(const uint256 &hash, CTransaction &tx, uint256 &hashBlock);
 uint256 WantedByOrphan(const CBlock* pblockOrphan);
@@ -1105,8 +1145,17 @@ public:
             return error("%s() : deserialize or I/O error", __PRETTY_FUNCTION__);
         }
 
-        // Check the header
-        if (fReadTransactions && IsProofOfWork() && !CheckProofOfWork(GetHash(), nBits))
+        // Check the header.
+        // Genesis block is a hardcoded trust anchor — its hash is verified
+        // by comparison to hashGenesisBlockOfficial/TestNet, not by PoW.
+        // The genesis block's hash (0x7e7a6e4d...) is intentionally above
+        // the PoW target since it's a network-wide constant, not a mined block.
+        // All peercoin-derived coins (peercoin, triangles, etc.) use this
+        // same exemption for the genesis block.
+        if (fReadTransactions && IsProofOfWork() &&
+            GetHash() != hashGenesisBlockOfficial &&
+            GetHash() != hashGenesisBlockTestNet &&
+            !CheckProofOfWork(GetHash(), nBits))
             return error("CBlock::ReadFromDisk() : errors in block header");
 
         return true;
@@ -1534,6 +1583,39 @@ public:
         return vHave.empty();
     }
 
+    // Return true if this locator's hash list contains the given hash.
+    // Used by getheaders fork-recovery to check whether the peer already
+    // knows the hardened checkpoint before serving from it (see
+    // fix/consensus-convergence in main.cpp).
+    bool Has(const uint256& hash) const
+    {
+        for (const uint256& h : vHave)
+            if (h == hash)
+                return true;
+        return false;
+    }
+
+    // Find the deepest block in this locator that exists in the given
+    // block index AND is on the main chain. Returns nullptr if no match.
+    // Used by getheaders fork-recovery to compute the last-common-ancestor
+    // when the peer doesn't already know the hardened checkpoint.
+    CBlockIndex* FindCommonAncestorInMainChain() const
+    {
+        CBlockIndex* pCommon = nullptr;
+        for (const uint256& h : vHave)
+        {
+            std::map<uint256, CBlockIndex*>::iterator mi = mapBlockIndex.find(h);
+            if (mi == mapBlockIndex.end())
+                continue;
+            CBlockIndex* pIdx = mi->second;
+            if (!pIdx->IsInMainChain())
+                continue;
+            if (pCommon == nullptr || pIdx->nHeight > pCommon->nHeight)
+                pCommon = pIdx;
+        }
+        return pCommon;
+    }
+
     // Return the first hash in the locator (peer's tip), or 0 if empty
     uint256 GetTipHash() const
     {

src/miner.cpp

@@ -58,11 +58,17 @@ public:
     TxPriorityCompare(bool _byFee) : byFee(_byFee) { }
     bool operator()(const TxPriority& a, const TxPriority& b)
     {
+        // #8: Fee-weighted priority for PoS staking.
+        // When sorting by fee (PoS mode), apply a 2x weight to fees so
+        // higher-fee transactions are prioritized over coin-age-only ones.
+        // This maximizes staking rewards for the minter.
         if (byFee)
         {
-            if (std::get<1>(a) == std::get<1>(b))
+            double feeA = std::get<1>(a) * 2.0;  // fee boost
+            double feeB = std::get<1>(b) * 2.0;
+            if (feeA == feeB)
                 return std::get<0>(a) < std::get<0>(b);
-            return std::get<1>(a) < std::get<1>(b);
+            return feeA < feeB;
         }
         else
         {
@@ -385,7 +391,6 @@ void StakeMiner(CWallet *pwallet)
     // Make this thread recognisable as the mining thread
     RenameThread("Triangles-miner");
 
-    bool fTryToSync = true;
     bool fForceStaking = GetBoolArg("-forcestaking", false);
 
     while (true)
@@ -401,24 +406,38 @@ void StakeMiner(CWallet *pwallet)
                 return;
         }
 
-        while (!fForceStaking && (vNodes.empty() || IsInitialBlockDownload()))
+        // Continuous staking safety gate (fix/consensus-convergence).
+        //
+        // Pre-fix: a one-shot strong check ran only once after the inner
+        // wait exited. Losing peers mid-staking left the staker running
+        // on a potentially isolated chain. This gate is evaluated on
+        // EVERY staking attempt.
+        //
+        // Refuses to stake when:
+        //   - IBD is active (IsInitialBlockDownload)
+        //   - fewer than 2 fully handshaken non-disconnecting peers
+        //   - our height is behind the peer median
+        //   - a known competing valid fork is at or above our active chain trust
+        //
+        // `-forcestaking` remains an explicit operator override (with the
+        // same warning as before) for stall recovery.
+        if (!fForceStaking)
         {
-            nLastCoinStakeSearchInterval = 0;
-            fTryToSync = true;
-            MilliSleep(1000);
-            if (fShutdown)
-                return;
-        }
-
-        if (fTryToSync && !fForceStaking)
-        {
-            fTryToSync = false;
-            if (vNodes.size() < 2 || nBestHeight < GetNumBlocksOfPeers())
+            if (!IsStakingSafe(pwallet, vNodes))
             {
-                MilliSleep(60000);
+                nLastCoinStakeSearchInterval = 0;
+                MilliSleep(1000);
                 continue;
             }
         }
+        else if (vNodes.empty() || IsInitialBlockDownload())
+        {
+            // Force path still requires wallet connectivity; the rest of
+            // the gate is the operator's responsibility.
+            nLastCoinStakeSearchInterval = 0;
+            MilliSleep(1000);
+            continue;
+        }
 
         //
         // Update cached stake weight for UI display (avoids heavy work on UI thread)

src/net.cpp

@@ -11,6 +11,9 @@
 #include "addrman.h"
 #include "ui_interface.h"
 #include "onionseed.h"
+#include "tor/onion_v3.h"
+#include "snapshotnet.h"
+#include "i2p/i2pseed.h"
 
 #include <openssl/ssl.h>
 #include <openssl/err.h>
@@ -19,6 +22,8 @@
 
 #ifdef WIN32
 #include <string.h>
+#else
+#include <sys/uio.h>
 #endif
 
 #ifdef USE_UPNP
@@ -36,7 +41,9 @@ extern "C" {
 // int tor_main(int argc, char *argv[]);
 }
 
-static const int MAX_OUTBOUND_CONNECTIONS = 8;  // reduced from 16 for Tor-only small networks
+// Configurable max outbound connections. Set from -maxoutboundconnections
+// during network init (StartNode). Default 8, configurable range 4-32.
+static int MAX_OUTBOUND_CONNECTIONS = 8;
 
 void ThreadMessageHandler2(void* parg);
 void ThreadSocketHandler2(void* parg);
@@ -327,6 +334,86 @@ bool IsReachable(const CNetAddr& addr)
     return vfReachable[net] && !vfLimited[net];
 }
 
+// ────────────────────────────────────────────────────────────────────────────
+// Cross-network Tor ↔ I2P peer discovery helpers
+// ────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Check whether a CAddress refers to an I2P (.b32.i2p) endpoint.
+ * Returns true if the string representation of the address contains ".i2p".
+ */
+bool IsI2PAddr(const CAddress& addr)
+{
+    std::string addrStr = addr.ToStringIP();
+    return (addrStr.find(".i2p") != std::string::npos);
+}
+
+/**
+ * Check whether a CAddress refers to a Tor (.onion) endpoint.
+ */
+static bool IsOnionAddr(const CAddress& addr)
+{
+    std::string addrStr = addr.ToStringIP();
+    return (addrStr.find(".onion") != std::string::npos);
+}
+
+/**
+ * Cross-network address relay: when an 'addr' message is received from a
+ * peer on one anonymity network, this function bridges addresses belonging
+ * to the *other* network to the appropriate peers.
+ *
+ *   - .b32.i2p addresses received from any peer → relay to I2P-connected peers
+ *   - .onion addresses received from any peer    → relay to Tor-connected peers
+ *
+ * This breaks the isolation between Tor and I2P peer sets so that a Tor
+ * node can learn about I2P peers and vice versa.
+ */
+void RelayCrossNetworkAddr(const std::vector<CAddress>& vAddr)
+{
+    bool hasI2P = false;
+    bool hasOnion = false;
+    for (const CAddress& addr : vAddr) {
+        if (IsI2PAddr(addr))   hasI2P = true;
+        if (IsOnionAddr(addr)) hasOnion = true;
+    }
+    if (!hasI2P && !hasOnion)
+        return;
+
+    LOCK(cs_vNodes);
+    for (CNode* pnode : vNodes) {
+        if (pnode->fDisconnect)
+            continue;
+        std::string peerAddr = pnode->addr.ToStringIP();
+        bool peerIsI2P   = (peerAddr.find(".i2p")   != std::string::npos);
+        bool peerIsOnion = (peerAddr.find(".onion") != std::string::npos);
+
+        for (const CAddress& addr : vAddr) {
+            // Bridge I2P addresses to I2P peers
+            if (hasI2P && IsI2PAddr(addr) && peerIsI2P) {
+                pnode->PushAddress(addr);
+            }
+            // Bridge .onion addresses to Tor peers
+            if (hasOnion && IsOnionAddr(addr) && peerIsOnion) {
+                pnode->PushAddress(addr);
+            }
+            // Cross-bridge: also push I2P addresses to Tor peers and
+            // .onion addresses to I2P peers so each network learns about
+            // the other's peers.
+            if (hasI2P && IsI2PAddr(addr) && peerIsOnion) {
+                pnode->PushAddress(addr);
+            }
+            if (hasOnion && IsOnionAddr(addr) && peerIsI2P) {
+                pnode->PushAddress(addr);
+            }
+        }
+    }
+
+    if (fDebug && (hasI2P || hasOnion))
+        printf("RelayCrossNetworkAddr: bridged %s%s%s addresses across networks\n",
+               hasOnion ? ".onion " : "", hasI2P ? ".i2p " : "",
+               (hasOnion && hasI2P) ? "(both)" : "");
+}
+
 bool GetMyExternalIP2(const CService& addrConnect, const char* pszGet, const char* pszKeyword, CNetAddr& ipRet)
 {
     SOCKET hSocket;
@@ -494,11 +581,13 @@ CNode* FindNode(const CService& addr)
 
 CNode* ConnectNode(CAddress addrConnect, const char *pszDest)
 {
-    // TOR-NATIVE: Reject all non-.onion addresses
+    // TOR+I2P NATIVE: Reject all clearnet (non-.onion, non-.b32.i2p) addresses
     std::string addrStr = pszDest ? std::string(pszDest) : addrConnect.ToStringIP();
-    if (addrStr.find(".onion") == std::string::npos) {
+    bool isOnion = (addrStr.find(".onion") != std::string::npos);
+    bool isI2P = (addrStr.find(".i2p") != std::string::npos);
+    if (!isOnion && !isI2P) {
         if (fDebug)
-            printf("ConnectNode(): REJECTED non-onion address: %s (Tor-native mode)\n", addrStr.c_str());
+            printf("ConnectNode(): REJECTED clearnet address: %s (Tor/I2P native mode)\n", addrStr.c_str());
         return nullptr;
     }
 
@@ -516,7 +605,8 @@ CNode* ConnectNode(CAddress addrConnect, const char *pszDest)
     }
 
     if (fDebug) {
-         printf("ConnectNode(): pszDest: %s\n", pszDest);
+         printf("ConnectNode(): destination: %s\n",
+                pszDest ? pszDest : addrConnect.ToString().c_str());
     }
 
     /// debug print
@@ -561,9 +651,65 @@ CNode* ConnectNode(CAddress addrConnect, const char *pszDest)
     }
 }
 
+// Adopt a connected I2P SAM data socket (from the accept loop in i2p.cpp) as an
+// inbound peer. The socket arrives in blocking mode; switch it to non-blocking
+// to match the rest of the socket handler, then register the node.
+void AddI2PInboundNode(SOCKET hSocket, const CAddress& addr)
+{
+    if (hSocket == INVALID_SOCKET)
+        return;
+
+    if (CNode::IsBanned(addr)) {
+        printf("I2P inbound from %s dropped (banned)\n", addr.ToString().c_str());
+        closesocket(hSocket);
+        return;
+    }
+
+    // Honour the inbound connection limit.
+    int nInbound = 0;
+    {
+        LOCK(cs_vNodes);
+        for (CNode* pnode : vNodes)
+            if (pnode->fInbound)
+                nInbound++;
+    }
+    int nMaxInbound = GetArg("-maxconnections", 125) - MAX_OUTBOUND_CONNECTIONS;
+    if (nInbound >= nMaxInbound) {
+        printf("I2P inbound from %s dropped (too many inbound)\n", addr.ToString().c_str());
+        closesocket(hSocket);
+        return;
+    }
+
+#ifdef WIN32
+    u_long nOne = 1;
+    if (ioctlsocket(hSocket, FIONBIO, &nOne) == SOCKET_ERROR)
+        printf("AddI2PInboundNode() : ioctlsocket non-blocking setting failed, error %d\n", WSAGetLastError());
+#else
+    if (fcntl(hSocket, F_SETFL, O_NONBLOCK) == SOCKET_ERROR)
+        printf("AddI2PInboundNode() : fcntl non-blocking setting failed, error %d\n", errno);
+#endif
+
+    printf("accepted I2P connection %s\n", addr.ToString().c_str());
+    CNode* pnode = new CNode(hSocket, addr, "", true);
+    pnode->AddRef();
+    pnode->nTimeConnected = GetTime();
+    {
+        LOCK(cs_vNodes);
+        vNodes.push_back(pnode);
+    }
+}
+
 void CNode::CloseSocketDisconnect()
 {
     fDisconnect = true;
+    // Option C: track this disconnect for the reliability score. We increment
+    // BEFORE closing the socket so a flurry of disconnects from one peer is
+    // visible to the next sync manager tick (which iterates cs_vNodes).
+    ++nDisconnectCount;
+    nLastDisconnectTime = GetTime();
+    // Penalize the score by 25 per disconnect. Flapping peers (5+ in 5min) get
+    // an extra 50 penalty applied in the score recompute.
+    nReliabilityScore = std::max(0, nReliabilityScore - 25);
     if (hSocket != INVALID_SOCKET)
     {
         printf("disconnecting node %s\n", addrName.c_str());
@@ -581,6 +727,40 @@ void CNode::Cleanup()
 {
 }
 
+int CNode::RecomputeReliabilityScore()
+{
+    // Option C: compute reliability score from current counters.
+    //
+    // Base: 100
+    // -10 per connect failure (host unreachable on attempt)
+    // -25 per disconnect (also applied immediately in CloseSocketDisconnect,
+    //   but we re-apply here so a fresh CNode that started with a low score
+    //   can recover)
+    // +5 per block delivered, capped at +200
+    // -50 if the peer has flapped (5+ disconnects in the last 5 minutes)
+    //
+    // Floor: 0 (peer effectively banned from sync)
+    // Ceiling: 500
+    int score = 100;
+    score -= 10 * nConnectFailures;
+    score -= 25 * nDisconnectCount;
+    int deliveryBonus = std::min(200, 5 * nBlocksDelivered);
+    score += deliveryBonus;
+
+    if (nDisconnectCount >= 5) {
+        // Flapping detection: 5+ disconnects in the peer's lifetime.
+        // We can't easily check "last 5 min" without history, so we use
+        // total count as a proxy. A peer that connects/disconnects a lot
+        // is unreliable regardless of timing.
+        score -= 50;
+    }
+
+    if (score < 0) score = 0;
+    if (score > 500) score = 500;
+    nReliabilityScore = score;
+    return score;
+}
+
 
 void CNode::PushVersion()
 {
@@ -785,36 +965,96 @@ void SocketSendData(CNode *pnode)
     std::deque<CSerializeData>::iterator it = pnode->vSendMsg.begin();
 
     while (it != pnode->vSendMsg.end()) {
+#ifndef WIN32
+        // Coalesce up to MAX_IOV queued messages into a single syscall using
+        // scatter-gather I/O.  On Linux we use sendmsg() so we can pass
+        // MSG_NOSIGNAL | MSG_DONTWAIT; on other POSIX systems (e.g. BSD where
+        // SO_NOSIGPIPE is already set on the socket) we fall back to writev().
+        static const int MAX_IOV = 16;
+        struct iovec iov[MAX_IOV];
+        int iovcnt = 0;
+        std::deque<CSerializeData>::iterator batchEnd = it;
+
+        for (; batchEnd != pnode->vSendMsg.end() && iovcnt < MAX_IOV; ++batchEnd, ++iovcnt) {
+            const CSerializeData &data = *batchEnd;
+            size_t off = (batchEnd == it) ? pnode->nSendOffset : 0;
+            assert(data.size() > off);
+            iov[iovcnt].iov_base = const_cast<char*>(&data[off]);
+            iov[iovcnt].iov_len = data.size() - off;
+        }
+
+        if (iovcnt == 0)
+            break;
+
+        ssize_t nBytes;
+#ifdef MSG_NOSIGNAL
+        struct msghdr msg;
+        memset(&msg, 0, sizeof(msg));
+        msg.msg_iov = iov;
+        msg.msg_iovlen = iovcnt;
+        nBytes = sendmsg(pnode->hSocket, &msg, MSG_NOSIGNAL | MSG_DONTWAIT);
+#else
+        nBytes = writev(pnode->hSocket, iov, iovcnt);
+#endif
+        if (nBytes > 0) {
+            pnode->nLastSend = GetTime();
+            pnode->nSendBytes += nBytes;
+
+            // Consume nBytes across the coalesced messages
+            while (it != batchEnd && nBytes > 0) {
+                const CSerializeData &data = *it;
+                size_t remaining = data.size() - pnode->nSendOffset;
+                if ((size_t)nBytes >= remaining) {
+                    nBytes -= remaining;
+                    pnode->nSendSize -= data.size();
+                    pnode->nSendOffset = 0;
+                    ++it;
+                } else {
+                    pnode->nSendOffset += nBytes;
+                    nBytes = 0;
+                }
+            }
+            // Socket buffer full mid-batch — wait for next cycle
+            if (it != batchEnd)
+                break;
+        } else if (nBytes < 0) {
+            int nErr = WSAGetLastError();
+            if (nErr != WSAEWOULDBLOCK && nErr != WSAEMSGSIZE && nErr != WSAEINTR && nErr != WSAEINPROGRESS) {
+                printf("socket send error %d\n", nErr);
+                pnode->CloseSocketDisconnect();
+            }
+            break;
+        } else {
+            // nBytes == 0: peer closed
+            break;
+        }
+#else
+        // Windows: individual send() calls
         const CSerializeData &data = *it;
         assert(data.size() > pnode->nSendOffset);
         int nBytes = send(pnode->hSocket, &data[pnode->nSendOffset], data.size() - pnode->nSendOffset, MSG_NOSIGNAL | MSG_DONTWAIT);
         if (nBytes > 0) {
             pnode->nLastSend = GetTime();
             pnode->nSendOffset += nBytes;
-            
-            pnode->nSendBytes += nBytes;         
-            
+            pnode->nSendBytes += nBytes;
             if (pnode->nSendOffset == data.size()) {
                 pnode->nSendOffset = 0;
                 pnode->nSendSize -= data.size();
                 it++;
             } else {
-                // could not send full message; stop sending more
                 break;
             }
         } else {
             if (nBytes < 0) {
-                // error
                 int nErr = WSAGetLastError();
-                if (nErr != WSAEWOULDBLOCK && nErr != WSAEMSGSIZE && nErr != WSAEINTR && nErr != WSAEINPROGRESS)
-                {
+                if (nErr != WSAEWOULDBLOCK && nErr != WSAEMSGSIZE && nErr != WSAEINTR && nErr != WSAEINPROGRESS) {
                     printf("socket send error %d\n", nErr);
                     pnode->CloseSocketDisconnect();
                 }
             }
-            // couldn't send anything at all
             break;
         }
+#endif
     }
 
     if (it == pnode->vSendMsg.end()) {
@@ -1048,6 +1288,16 @@ void ThreadSocketHandler2(void* parg)
                             break;
                         }
                     }
+                    // Also check I2P seed addresses
+                    if (!fIsSeed) {
+                        static const char *(*strI2PSeedCheck)[1] = fTestNet ? strTestNetI2PSeed : strMainNetI2PSeed;
+                        for (unsigned int si = 0; strI2PSeedCheck[si][0] != nullptr; si++) {
+                            if (incomingAddr.find(strI2PSeedCheck[si][0]) != std::string::npos) {
+                                fIsSeed = true;
+                                break;
+                            }
+                        }
+                    }
                     if (fIsSeed && nInbound < nMaxInbound + 2) {
                         fAccept = true;
                         printf("accepted seed node %s (reserved slot)\n", addr.ToString().c_str());
@@ -1175,7 +1425,7 @@ void ThreadSocketHandler2(void* parg)
 
         if (fShutdown)
             return;
-        MilliSleep(10);
+        MilliSleep(IsInitialBlockDownload() ? 1 : 10);
     }
 }
 
@@ -1403,6 +1653,39 @@ void ThreadOnionSeed(void* parg)
     static const char *(*strOnionSeed)[1] = fTestNet ? strTestNetOnionSeed : strMainNetOnionSeed;
     int found = 0;
 
+    // Defense-in-depth (2026-06-22): Validate every hardcoded seed against the
+    // v3 onion checksum BEFORE we hand it to Tor. The btb6/gtb6 incident
+    // (4,842 "No more HSDir" errors over a 12h from-zero sync test) was caused
+    // by a single-character corruption that Tor rejected with a cryptic
+    // "ed25519 validation failed" warning. Catching it here gives the operator
+    // a clear, actionable error at startup with no wasted network/CPU.
+    // See references/onion-corruption-ci-defense.md (CI Layers 2-3) for the
+    // static-analysis side of this defense.
+    {
+        int nInvalid = 0;
+        int nTotal = 0;
+        std::string strFirstBad;
+        for (unsigned int si = 0; strOnionSeed[si][0] != nullptr; si++) {
+            nTotal++;
+            if (!CTorV3Service::ValidateOnionAddress(strOnionSeed[si][0])) {
+                if (strFirstBad.empty()) strFirstBad = strOnionSeed[si][0];
+                nInvalid++;
+            }
+        }
+        if (nInvalid > 0) {
+            std::string strErr = strprintf(
+                "ThreadOnionSeed() : %d of %d hardcoded .onion seed(s) failed v3 "
+                "checksum validation. First bad address: %s. "
+                "This is the btb6/gtb6 class of bug (see references/onion-corruption-ci-defense.md). "
+                "Fix src/onionseed.h before starting the daemon — Tor would "
+                "have wasted hours producing cryptic 'ed25519 validation failed' "
+                "warnings otherwise.",
+                nInvalid, nTotal, strFirstBad.c_str());
+            printf("ERROR: %s\n", strErr.c_str());
+            throw runtime_error(strErr);
+        }
+    }
+
     for (unsigned int seed_idx = 0; strOnionSeed[seed_idx][0] != nullptr; seed_idx++) {
         CNetAddr parsed;
         if (!parsed.SetSpecial(strOnionSeed[seed_idx][0]))
@@ -1423,6 +1706,31 @@ void ThreadOnionSeed(void* parg)
 
     printf("%d addresses from hardcoded .onion seeds (queued as OneShot)\n", found);
 
+    // Load hardcoded I2P (.b32.i2p) seeds for cross-network peer discovery.
+    // These are added to the address manager so that I2P-connected peers can
+    // be discovered. Unlike onion seeds, we don't queue them as OneShot
+    // connections here — they're connected via the normal outbound connector
+    // through the I2P SOCKS proxy.
+    {
+        static const char *(*strI2PSeed)[1] = fTestNet ? strTestNetI2PSeed : strMainNetI2PSeed;
+        int i2pFound = 0;
+        for (unsigned int si = 0; strI2PSeed[si][0] != nullptr; si++) {
+            CNetAddr parsed;
+            if (!parsed.SetSpecial(strI2PSeed[si][0])) {
+                printf("WARNING: ThreadOnionSeed() : invalid .b32.i2p seed: %s\n",
+                       strI2PSeed[si][0]);
+                continue;
+            }
+            int nOneDay = 24*3600;
+            CAddress addr = CAddress(CService(parsed, GetDefaultPort()));
+            addr.nTime = GetTime() - 3*nOneDay - GetRand(4*nOneDay);
+            addrman.Add(addr, parsed);
+            i2pFound++;
+        }
+        if (i2pFound > 0)
+            printf("%d addresses from hardcoded .b32.i2p seeds added to addrman\n", i2pFound);
+    }
+
     // Wait for Tor to establish circuits before attempting HTTPS seed fetch.
     // The hardcoded OneShot connections can race ahead meanwhile.
     printf("ThreadOnionSeed: waiting 20s for Tor circuits before HTTPS seed fetch...\n");
@@ -1431,7 +1739,7 @@ void ThreadOnionSeed(void* parg)
 
     // Fetch dynamic seeds with retry — up to 4 attempts with increasing backoff.
     // This is the primary discovery mechanism — seeds.cryptographic-triangles.org
-    {
+    if (!GetBoolArg("-noseedurl", false)) {
         bool ok = false;
         int delays[] = {0, 30, 60, 120};
         for (int attempt = 0; attempt < 4 && !ok && !fShutdown; attempt++) {
@@ -1499,7 +1807,8 @@ void ThreadOnionSeed(void* parg)
             else
                 printf("ThreadOnionSeed: low outbound peers (%d), re-seeding...\n", nOutbound);
 
-            ThreadHTTPSeedFetch2(nullptr);
+            if (!GetBoolArg("-noseedurl", false))
+                ThreadHTTPSeedFetch2(nullptr);
 
             // Re-queue hardcoded seeds for direct connection
             for (unsigned int seed_idx = 0; strOnionSeed[seed_idx][0] != nullptr; seed_idx++) {
@@ -1584,6 +1893,12 @@ bool ThreadHTTPSeedFetch2(void* parg)
         seedPath = seedHost.substr(slashPos);
         seedHost = seedHost.substr(0, slashPos);
     }
+    if (seedHost.empty() || seedHost.find_first_of("\r\n") != std::string::npos ||
+        seedPath.empty() || seedPath[0] != '/' ||
+        seedPath.find_first_of("\r\n") != std::string::npos) {
+        printf("HTTPS seed fetch: invalid -seedurl value\n");
+        return false;
+    }
 
     printf("Fetching seed list from https://%s%s (via Tor)...\n", seedHost.c_str(), seedPath.c_str());
 
@@ -1622,7 +1937,14 @@ bool ThreadHTTPSeedFetch2(void* parg)
         }
 
         // Set SNI hostname (required for Caddy/Let's Encrypt)
-        SSL_set_tlsext_host_name(ssl, seedHost.c_str());
+        if (SSL_set_tlsext_host_name(ssl, seedHost.c_str()) != 1 ||
+            SSL_set1_host(ssl, seedHost.c_str()) != 1) {
+            printf("HTTPS seed fetch: failed to configure TLS hostname verification\n");
+            SSL_free(ssl);
+            SSL_CTX_free(ctx);
+            closesocket(hSocket);
+            return false;
+        }
         SSL_set_fd(ssl, (int)hSocket);
 
         int ret = SSL_connect(ssl);
@@ -1637,6 +1959,15 @@ bool ThreadHTTPSeedFetch2(void* parg)
             closesocket(hSocket);
             return false;
         }
+        if (SSL_get_verify_result(ssl) != X509_V_OK) {
+            printf("HTTPS seed fetch: certificate verification failed for %s\n",
+                   seedHost.c_str());
+            SSL_shutdown(ssl);
+            SSL_free(ssl);
+            SSL_CTX_free(ctx);
+            closesocket(hSocket);
+            return false;
+        }
 
         printf("HTTPS seed fetch: TLS connection established to %s\n", seedHost.c_str());
 
@@ -1666,10 +1997,19 @@ bool ThreadHTTPSeedFetch2(void* parg)
         // Read response over TLS
         std::string response;
         char buf[4096];
+        static constexpr size_t MAX_SEED_RESPONSE_SIZE = 1024 * 1024;
         while (true) {
             int nBytes = SSL_read(ssl, buf, sizeof(buf));
             if (nBytes <= 0)
                 break;
+            if (response.size() + static_cast<size_t>(nBytes) > MAX_SEED_RESPONSE_SIZE) {
+                printf("HTTPS seed fetch: response exceeds 1 MiB limit\n");
+                SSL_shutdown(ssl);
+                SSL_free(ssl);
+                SSL_CTX_free(ctx);
+                closesocket(hSocket);
+                return false;
+            }
             response.append(buf, nBytes);
         }
 
@@ -1695,72 +2035,120 @@ bool ThreadHTTPSeedFetch2(void* parg)
 
         // Check status code
         std::string statusLine = response.substr(0, response.find("\r\n"));
-        if (statusLine.find("200") == std::string::npos) {
+        if (statusLine.size() < 12 || statusLine.compare(0, 7, "HTTP/1.") != 0 ||
+            statusLine.compare(9, 3, "200") != 0) {
             printf("HTTPS seed fetch: %s from %s\n", statusLine.c_str(), seedHost.c_str());
             return false;
         }
 
+        std::string headers = response.substr(0, headerEnd);
         std::string body = response.substr(headerEnd + 4);
 
-        // Parse one address per line: "address:port" or just "address"
-        int found = 0;
-        std::istringstream lines(body);
-        std::string line;
-        while (std::getline(lines, line))
+        // Some servers (e.g. Caddy / Let's Encrypt fronting the seed list) reply
+        // with Transfer-Encoding: chunked even on HTTP/1.1 + Connection: close. The
+        // body then carries hex chunk-size lines interleaved with the data; parsing
+        // it raw fuses a chunk marker onto an address and we lose most of the list
+        // (the classic "only 1 address" symptom). De-chunk first when present.
+        //
+        // v5.9.22 hardening: the parser is now strict and reports a distinct
+        // failure code for each kind of malformed framing. See DechunkResult in
+        // netbase.h and the unit tests in src/test/http_seed_tests.cpp.
         {
-            if (fShutdown)
-                return false;
-
-            // Trim whitespace and carriage returns
-            while (!line.empty() && (line.back() == '\r' || line.back() == ' ' || line.back() == '\t'))
-                line.pop_back();
-            while (!line.empty() && (line.front() == ' ' || line.front() == '\t'))
-                line.erase(line.begin());
-
-            if (line.empty() || line[0] == '#')
-                continue;
-
-            // Parse address:port
-            std::string addrStr = line;
-            int port = GetDefaultPort();
-
-            // For .onion addresses, the last colon before port is after ".onion"
-            size_t onionPos = addrStr.find(".onion:");
-            if (onionPos != std::string::npos) {
-                port = atoi(addrStr.substr(onionPos + 7).c_str());
-                addrStr = addrStr.substr(0, onionPos + 6); // keep ".onion"
-            } else if (addrStr.find(".onion") == std::string::npos) {
-                // Tor-native: skip non-.onion addresses
-                continue;
-            }
-
-            if (port <= 0 || port > 65535)
-                port = GetDefaultPort();
-
-            CNetAddr parsed;
-            bool resolved = parsed.SetSpecial(addrStr);
-            if (!resolved) {
-                std::vector<CNetAddr> vIP;
-                if (LookupHost(addrStr.c_str(), vIP, 1, false) && !vIP.empty()) {
-                    parsed = vIP[0];
-                    resolved = true;
+            std::string h = headers;
+            for (char& c : h) c = (char)tolower((unsigned char)c);
+            if (h.find("transfer-encoding:") != std::string::npos &&
+                h.find("chunked") != std::string::npos)
+            {
+                std::string decoded;
+                int rc = DechunkTransferEncoding(body, decoded);
+                if (rc != DECHUNK_OK) {
+                    const char* reason = "unknown";
+                    switch (rc) {
+                        case DECHUNK_EMPTY:               reason = "empty body"; break;
+                        case DECHUNK_NO_CHUNK_TERMINATOR: reason = "missing chunk terminator (CRLF)"; break;
+                        case DECHUNK_INVALID_HEX:         reason = "malformed chunk-size (not valid hex)"; break;
+                        case DECHUNK_OVERSIZE_CHUNK:      reason = "chunk size exceeds remaining input (truncated)"; break;
+                        case DECHUNK_MISSING_DATA_CRLF:   reason = "missing CRLF after chunk data"; break;
+                        default:                          reason = "unknown"; break;
+                    }
+                    printf("HTTPS seed fetch: malformed chunked transfer encoding (%s) from %s\n",
+                           reason, seedHost.c_str());
+                    return false;
                 }
-            }
-            if (resolved) {
-                CAddress addr(CService(parsed, port));
-                addr.nTime = GetTime() - 3*24*60*60; // 3 days ago
-                addrman.Add(addr, CNetAddr("https-seed", true));
-                // Queue the first 8 seeds for immediate direct connection
-                if (found < 8) {
-                    std::string oneShotAddr = addrStr + ":" + std::to_string(port);
-                    AddOneShot(oneShotAddr);
-                }
-                found++;
+                body.swap(decoded);
             }
         }
 
+        if (fDebug)
+            printf("HTTPS seed fetch: %d body bytes to parse\n", (int)body.size());
+
+        // Tolerant parse: accept one-per-line OR several addresses on one line
+        // (whitespace / comma / semicolon separated), and ignore inline '#' comments.
+        // v5.9.22: the splitting logic is now a pure function in netbase.cpp so
+        // we can unit-test every line format. The CNetAddr/CService/addrman
+        // validation stays here because it touches globals.
+        int found = 0;
+        int skipped = 0;
+
+        auto addSeed = [&](std::string addrStr) -> void {
+            while (!addrStr.empty() && (addrStr.back()=='\r' || addrStr.back()==' ' || addrStr.back()=='\t'))
+                addrStr.pop_back();
+            while (!addrStr.empty() && (addrStr.front()==' ' || addrStr.front()=='\t'))
+                addrStr.erase(addrStr.begin());
+            if (addrStr.empty())
+                return;
+
+            int port = GetDefaultPort();
+            size_t onionPos = addrStr.find(".onion:");
+            size_t i2pPos = addrStr.find(".i2p:");
+            if (onionPos != std::string::npos) {
+                port = atoi(addrStr.substr(onionPos + 7).c_str());
+                addrStr = addrStr.substr(0, onionPos + 6); // keep ".onion"
+            } else if (i2pPos != std::string::npos) {
+                port = atoi(addrStr.substr(i2pPos + 5).c_str());
+                // keep the ".i2p" suffix
+            } else if (addrStr.find(".onion") == std::string::npos &&
+                       addrStr.find(".i2p") == std::string::npos) {
+                return; // Tor/I2P-native: skip clearnet addresses
+            }
+            if (port <= 0 || port > 65535)
+                port = GetDefaultPort();
+
+            CService service(addrStr, port);
+            if (service.IsValid()) {
+                CAddress addr(service);
+                addr.nTime = GetTime() - 3*24*60*60; // 3 days ago
+                addrman.Add(addr, service);
+                printf("HTTPS seed: added %s:%d\n", addrStr.c_str(), port);
+                found++;
+            } else {
+                skipped++;
+            }
+        };
+
+        // Use the pure helper to split the body. If it returns nothing, that
+        // means the body was entirely comments / blank lines / whitespace —
+        // distinct failure mode worth logging separately from "no valid
+        // addresses after parsing".
+        std::vector<std::string> tokens = ParseSeedListBody(body);
+        if (tokens.empty()) {
+            printf("HTTPS seed fetch: parsed response contained zero valid addresses from %s\n", seedHost.c_str());
+            return false;
+        }
+
+        for (const std::string& tok : tokens)
+        {
+            if (fShutdown)
+                return false;
+            addSeed(tok);
+        }
+
         printf("%d addresses found from HTTPS seed list (%s)\n", found, seedHost.c_str());
-        return found > 0;
+        if (found == 0) {
+            printf("HTTPS seed fetch: parsed response contained zero valid addresses from %s\n", seedHost.c_str());
+            return false;
+        }
+        return true;
 
     } catch (std::exception& e) {
         printf("HTTPS seed fetch failed: %s\n", e.what());
@@ -1894,10 +2282,57 @@ void ThreadOpenConnections2(void* parg)
 
     // Initiate network connections
     int64_t nStart = GetTime();
+    int64_t nLastDiscoveryRound = 0;  // signed peer discovery: re-trigger getaddr+getseederlist+getwalletaddr
+    const int64_t DISCOVERY_COOLDOWN = 300; // 5min between rounds (peer count < threshold)
+    const int DISCOVERY_THRESHOLD = 4;       // if we have fewer than this many connected peers, re-trigger
     while (true)
     {
         ProcessOneShot();
 
+        // Signed peer discovery: when our connected-peer count drops, re-trigger
+        // the full signing + discovery round on every peer. Triangles already has
+        // getaddr / getseederlist / getwalletaddr in onion_v3.cpp — this just
+        // re-fires them periodically instead of only at startup.
+        int nConnectedOnion = 0;
+        int nSignedPeers = 0;
+        int64_t nNow = GetTime();
+        {
+            LOCK(cs_vNodes);
+            for (CNode* pnode : vNodes) {
+                if (!pnode->fInbound && pnode->fSuccessfullyConnected) {
+                    std::string ip = pnode->addr.ToStringIP();
+                    if (ip.find(".onion") != std::string::npos) {
+                        nConnectedOnion++;
+                        if (pnode->nSignedPeerBonus > 0) nSignedPeers++;
+                    }
+                }
+            }
+        }
+        if (nConnectedOnion < DISCOVERY_THRESHOLD &&
+            nNow - nLastDiscoveryRound > DISCOVERY_COOLDOWN)
+        {
+            nLastDiscoveryRound = nNow;
+            printf("SYNC-SIGN: low peer count (%d < %d), re-firing discovery round on all peers\n",
+                   nConnectedOnion, DISCOVERY_THRESHOLD);
+            LOCK(cs_vNodes);
+            for (CNode* pnode : vNodes) {
+                if (!pnode->fInbound && pnode->fSuccessfullyConnected) {
+                    std::string ip = pnode->addr.ToStringIP();
+                    if (ip.find(".onion") != std::string::npos &&
+                        nNow - pnode->nLastGetaddrTrigger > DISCOVERY_COOLDOWN)
+                    {
+                        pnode->nLastGetaddrTrigger = nNow;
+                        pnode->PushMessage("getaddr");
+                        pnode->PushMessage("getseederlist");
+                        // getwalletaddr is only sent on version handshake (main.cpp:3941);
+                        // we don't re-fire it here because it generates a new receiving
+                        // key on the peer each call, which is wasteful. Signed peers
+                        // are cached for 24h (onion_v3.cpp:2308) so they'll be reused.
+                    }
+                }
+            }
+        }
+
         vnThreadsRunning[THREAD_OPENCONNECTIONS]--;
         MilliSleep(500);
         vnThreadsRunning[THREAD_OPENCONNECTIONS]++;
@@ -2386,8 +2821,25 @@ void StartNode(void* parg)
     // Make this thread recognisable as the startup thread
     RenameThread("Triangles-start");
 
+    // Configurable outbound connections via -maxoutboundconnections (default 8, range 4-32)
+    MAX_OUTBOUND_CONNECTIONS = GetArg("-maxoutboundconnections", 8);
+    if (MAX_OUTBOUND_CONNECTIONS < 4)  MAX_OUTBOUND_CONNECTIONS = 4;
+    if (MAX_OUTBOUND_CONNECTIONS > 32) MAX_OUTBOUND_CONNECTIONS = 32;
+    printf("Configured max outbound connections: %d (from -maxoutboundconnections)\n", MAX_OUTBOUND_CONNECTIONS);
+
+    // If a canonical UTXO snapshot file is already present at startup,
+    // advertise NODE_SNAPSHOT to peers BEFORE the first outbound connection.
+    // EnsureLocalSnapshot() also sets this flag post-IBD, but at that point
+    // already-connected peers have already cached our version message and
+    // won't re-read our service bits — so for the "place canonical file in
+    // datadir before launch" operator workflow this pre-handshake OR is the
+    // load-bearing one.
+    if (!fClient) {
+        SnapshotNet::EnsureLocalSnapshot();
+    }
+
     if (semOutbound == nullptr) {
-        // initialize semaphore — use -maxoutbound if specified, else default
+        // initialize semaphore — use -maxoutboundconnections (set above), fall back to -maxoutbound
         int nMaxOutbound = (int)GetArg("-maxoutbound", MAX_OUTBOUND_CONNECTIONS);
         nMaxOutbound = min(nMaxOutbound, (int)GetArg("-maxconnections", 125));
         nMaxOutbound = max(nMaxOutbound, 1);  // at least 1 outbound
@@ -2439,6 +2891,10 @@ void StartNode(void* parg)
     if (!NewThread(ThreadOpenConnections, nullptr))
         printf("Error: NewThread(ThreadOpenConnections) failed\n");
 
+    // Start fork detector (post-IBD background monitor)
+    if (!NewThread(ThreadForkDetector, nullptr))
+        printf("Error: NewThread(ThreadForkDetector) failed\n");
+
     // Process messages
     if (!NewThread(ThreadMessageHandler, nullptr))
         printf("Error: NewThread(ThreadMessageHandler) failed\n");
@@ -2573,3 +3029,29 @@ void RelayTransaction(const CTransaction& tx, const uint256& hash, const CDataSt
 
     RelayInventory(inv);
 }
+
+// ---------------------------------------------------------------------------
+// BIP152 Compact Block relay — net-layer integration
+// ---------------------------------------------------------------------------
+
+/** Advertise a new block to all connected peers.
+ *
+ *  For peers that have negotiated compact block relay (fSendCmpct), the
+ *  inventory is sent as MSG_CMPCT_BLOCK so they know to request the compact
+ *  form.  For legacy peers, standard MSG_BLOCK inventory is sent.
+ *
+ *  The actual compact block construction and sending happens in main.cpp
+ *  (SendCompactBlock / ProcessCompactBlock).  This function only handles
+ *  the inventory advertisement at the net layer.
+ */
+void RelayBlockInventory(const uint256& hash)
+{
+    LOCK(cs_vNodes);
+    for (CNode* pnode : vNodes)
+    {
+        // Use MSG_CMPCT_BLOCK for peers that support compact relay,
+        // MSG_BLOCK for legacy peers.
+        int nType = pnode->fSendCmpct ? MSG_CMPCT_BLOCK : MSG_BLOCK;
+        pnode->PushInventory(CInv(nType, hash));
+    }
+}

src/net.h

@@ -21,7 +21,9 @@
 class CNode;
 class CBlockIndex;
 bool IsInitialBlockDownload();
+void ThreadForkDetector(void*);
 extern int nBestHeight;
+extern int nForkAlertCount;
 
 
 
@@ -35,6 +37,8 @@ void AddressCurrentlyConnected(const CService& addr);
 CNode* FindNode(const CNetAddr& ip);
 CNode* FindNode(const CService& ip);
 CNode* ConnectNode(CAddress addrConnect, const char *strDest = nullptr);
+// Adopt a connected I2P SAM data socket as an inbound peer (called from i2p.cpp).
+void AddI2PInboundNode(SOCKET hSocket, const CAddress& addr);
 void MapPort();
 unsigned short GetListenPort();
 bool BindListenPort(const CService &bindAddr, std::string& strError=REF(std::string()));
@@ -261,6 +265,15 @@ public:
     int nBestKnownHeight;        // highest block height known to this peer (updated from inv/block msgs)
     int nIncompatibleGetblocks;  // count of getblocks with no common blocks (fork detection)
 
+    // Option C: peer reliability scoring. Higher = more reliable.
+    // Starts at 100 (neutral), grows with successful block delivery, shrinks with
+    // disconnects and unreachable-on-connect. Used by sync manager to prefer
+    // reliable peers for header/block requests and to demote flaky ones.
+    int nReliabilityScore = 100;
+    int nDisconnectCount = 0;     // disconnects since startup
+    int nConnectFailures = 0;     // host-unreachable on connect attempts
+    int64_t nLastDisconnectTime = 0; // for flapping detection (many disconnects in short window)
+
     // BIP 31 ping/pong latency tracking
     uint64_t nPingNonceSent;     // nonce of last ping sent (0 = no outstanding ping)
     int64_t nPingUsecStart;      // microsecond timestamp when last ping was sent
@@ -271,6 +284,8 @@ public:
     std::vector<CAddress> vAddrToSend;
     mruset<CAddress> setAddrKnown;
     bool fGetAddr;
+    int64_t nLastGetaddrTrigger; // last time we sent this peer a discovery round (getaddr+getseederlist+getwalletaddr)
+    int nSignedPeerBonus;       // +N reputation when peer completed walletaddr handshake (signed identity)
     std::set<uint256> setKnown;
     uint256 hashCheckpointKnown; // triangles: known sent sync-checkpoint
 
@@ -325,6 +340,8 @@ public:
         nPingUsecTime = 0;
         nPingRetryCount = 0;
         fGetAddr = false;
+        nLastGetaddrTrigger = 0;
+        nSignedPeerBonus = 0;
         nMisbehavior = 0;
         hashCheckpointKnown = 0;
         setInventoryKnown.max_size(SendBufferSize() / 1000);
@@ -549,6 +566,10 @@ public:
     void CancelSubscribe(unsigned int nChannel);
     void CloseSocketDisconnect();
     void Cleanup();
+    // Option C: recompute reliability score from current counters.
+    // Call this periodically (e.g. in sync manager tick) to apply the
+    // flapping penalty (5+ disconnects in 5min = extra 50 penalty).
+    int RecomputeReliabilityScore();
 
 
     // Denial-of-service detection/prevention

src/netbase.cpp

@@ -10,8 +10,15 @@
 
 #ifndef WIN32
 #include <sys/fcntl.h>
+#include <netinet/tcp.h>
 #endif
 
+#include <cstdlib>
+#include <cctype>
+#include <cerrno>
+#include <limits>
+#include <sstream>
+
 #include "strlcpy.h"
 
 using namespace std;
@@ -21,6 +28,13 @@ static proxyType proxyInfo[NET_MAX];
 static proxyType nameproxyInfo;
 static CCriticalSection cs_proxyInfos;
 int nConnectTimeout = 5000;
+// Bound for the SOCKS5 negotiation over Tor (ms). The recv() calls in Socks5()
+// wait for Tor to build a circuit and fetch the v3 hidden-service descriptor for
+// the target .onion; with no timeout a dead/slow onion blocks the connecting
+// thread (holding an outbound slot) until Tor's own ~120s SocksTimeout fires.
+// Configurable via -torconnecttimeout. Default 60s: long enough for a healthy
+// onion to answer, short enough that bad peers don't starve a from-zero node.
+int nSocksNegotiationTimeout = 60000;
 bool fNameLookup = false;
 
 static const unsigned char pchIPv4[12] = { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0xff, 0xff };
@@ -223,6 +237,24 @@ bool static Socks5(string strDest, int port, SOCKET& hSocket)
         closesocket(hSocket);
         return error("Hostname too long");
     }
+
+    // Bound the blocking SOCKS5 handshake so a slow/dead .onion can't stall this
+    // thread (and hold an outbound connection slot) waiting on Tor. A timeout makes
+    // the recv() below return < expected, which the existing checks treat as a
+    // clean failure so the connector moves on to the next peer.
+    {
+#ifdef WIN32
+        DWORD tv = (DWORD)nSocksNegotiationTimeout;
+        setsockopt(hSocket, SOL_SOCKET, SO_RCVTIMEO, (const char*)&tv, sizeof(tv));
+        setsockopt(hSocket, SOL_SOCKET, SO_SNDTIMEO, (const char*)&tv, sizeof(tv));
+#else
+        struct timeval tv;
+        tv.tv_sec  = nSocksNegotiationTimeout / 1000;
+        tv.tv_usec = (nSocksNegotiationTimeout % 1000) * 1000;
+        setsockopt(hSocket, SOL_SOCKET, SO_RCVTIMEO, (const void*)&tv, sizeof(tv));
+        setsockopt(hSocket, SOL_SOCKET, SO_SNDTIMEO, (const void*)&tv, sizeof(tv));
+#endif
+    }
     char pszSocks5Init[] = "\5\1\0";
     if (fDebug)
     {
@@ -426,6 +458,19 @@ bool static ConnectSocketDirectly(const CService &addrConnect, SOCKET& hSocketRe
         }
     }
 
+    // TCP_NODELAY: disable Nagle's algorithm for low-latency P2P messaging.
+    // SO_KEEPALIVE: detect dead connections faster (important for Tor/I2P
+    // tunnels that can silently drop without RST/FIN).
+    {
+        int one = 1;
+#ifdef WIN32
+        setsockopt(hSocket, IPPROTO_TCP, TCP_NODELAY, (char*)&one, sizeof(one));
+#else
+        setsockopt(hSocket, IPPROTO_TCP, TCP_NODELAY, &one, sizeof(one));
+#endif
+        setsockopt(hSocket, SOL_SOCKET, SO_KEEPALIVE, (char*)&one, sizeof(one));
+    }
+
     // this isn't even strictly necessary
     // CNode::ConnectNode immediately turns the socket back to non-blocking
     // but we'll turn it back to blocking just in case
@@ -560,6 +605,33 @@ bool ConnectSocketByName(CService &addr, SOCKET& hSocketRet, const char *pszDest
 
     SOCKET hSocket = INVALID_SOCKET;
 
+    // I2P routing: .b32.i2p destinations go through i2pd's SOCKS proxy, not
+    // the Tor name proxy. This is the key routing decision for dual-network
+    // anonymity — Tor handles .onion, i2pd handles .b32.i2p.
+    bool isI2PDest = (strDest.size() > 7 &&
+                      strDest.substr(strDest.size() - 7, 7) == ".b32.i2p");
+
+    if (isI2PDest) {
+        // Route through the I2P SOCKS proxy
+        proxyType i2pProxy;
+        if (GetProxy(NET_I2P, i2pProxy)) {
+            addr = CService("0.0.0.0:0");
+            printf("ConnectSocketByName(): routing .b32.i2p via I2P SOCKS proxy\n");
+            if (!ConnectSocketDirectly(i2pProxy.first, hSocket, nTimeout))
+                return false;
+            // i2pd's SOCKS proxy accepts .b32.i2p domain names via SOCKS5 ATYP=domain
+            if (!Socks5(strDest, port, hSocket)) {
+                printf("ConnectSocketByName(): I2P SOCKS5 handshake failed\n");
+                return false;
+            }
+            printf("ConnectSocketByName(): connected via I2P SOCKS5\n");
+            hSocketRet = hSocket;
+            return true;
+        }
+        // No I2P proxy configured — fall through to nameproxy (will likely fail)
+        printf("ConnectSocketByName(): WARNING - .b32.i2p dest but no I2P proxy set\n");
+    }
+
     proxyType nameproxy;
     GetNameProxy(nameproxy);
 
@@ -600,6 +672,7 @@ void CNetAddr::Init()
     memset(ip, 0, sizeof(ip));
     memset(tor_v3_pubkey, 0, sizeof(tor_v3_pubkey));
     m_is_tor_v3 = false;
+    m_is_i2p = false;
 }
 
 void CNetAddr::SetIP(const CNetAddr& ipIn)
@@ -607,6 +680,7 @@ void CNetAddr::SetIP(const CNetAddr& ipIn)
     memcpy(ip, ipIn.ip, sizeof(ip));
     memcpy(tor_v3_pubkey, ipIn.tor_v3_pubkey, sizeof(tor_v3_pubkey));
     m_is_tor_v3 = ipIn.m_is_tor_v3;
+    m_is_i2p = ipIn.m_is_i2p;
 }
 
 static const unsigned char pchOnionCat[] = {0xFD,0x87,0xD8,0x7E,0xEB,0x43};
@@ -641,13 +715,41 @@ bool CNetAddr::SetSpecial(const std::string &strName)
         m_is_tor_v3 = false;
         return true;
     }
-    if (strName.size()>11 && strName.substr(strName.size() - 11, 11) == ".oc.b32.i2p") {
-        std::vector<unsigned char> vchAddr = DecodeBase32(strName.substr(0, strName.size() - 11).c_str());
-        if (vchAddr.size() != 16-sizeof(pchGarliCat))
+    // Standard I2P b32 address: <52 base32 chars>.b32.i2p
+    // (SHA-256 hash of destination key, base32-encoded)
+    if (strName.size()>7 && strName.substr(strName.size() - 7, 7) == ".b32.i2p") {
+        std::string b32Part = strName.substr(0, strName.size() - 7);
+        std::vector<unsigned char> vchAddr = DecodeBase32(b32Part.c_str());
+        if (vchAddr.size() == 32) {
+            // Standard 32-byte I2P destination hash
+            memcpy(ip, pchGarliCat, sizeof(pchGarliCat));
+            // Store as many bytes as fit (16 - prefix_size)
+            for (unsigned int i = 0; i < 16 - sizeof(pchGarliCat) && i < vchAddr.size(); i++)
+                ip[i + sizeof(pchGarliCat)] = vchAddr[i];
+            return true;
+        }
+        // Also handle the legacy .oc.b32.i2p format (10 bytes)
+        if (vchAddr.size() == 16 - sizeof(pchGarliCat)) {
+            memcpy(ip, pchGarliCat, sizeof(pchGarliCat));
+            for (unsigned int i = 0; i < 16 - sizeof(pchGarliCat); i++)
+                ip[i + sizeof(pchGarliCat)] = vchAddr[i];
+            return true;
+        }
+    }
+    // Modern I2P base32 address: 52 base32 chars = SHA-256(destination) (32 bytes)
+    // rendered as "<b32>.b32.i2p". Store the hash and flag this as an I2P address.
+    if (strName.size()>8 && strName.substr(strName.size() - 8, 8) == ".b32.i2p") {
+        std::string addrPart = strName.substr(0, strName.size() - 8);
+        std::vector<unsigned char> vchAddr = DecodeBase32(addrPart.c_str());
+        if (vchAddr.size() != 32)
             return false;
-        memcpy(ip, pchOnionCat, sizeof(pchGarliCat));
-        for (unsigned int i=0; i<16-sizeof(pchGarliCat); i++)
-            ip[i + sizeof(pchGarliCat)] = vchAddr[i];
+        // Keep the GarliCat prefix in ip[] so legacy reachability checks that
+        // look for unique-local space still treat this as a routable overlay.
+        memcpy(ip, pchGarliCat, sizeof(pchGarliCat));
+        memset(ip + sizeof(pchGarliCat), 0, 16 - sizeof(pchGarliCat));
+        memcpy(tor_v3_pubkey, vchAddr.data(), 32);
+        m_is_i2p = true;
+        m_is_tor_v3 = false;
         return true;
     }
     return false;
@@ -772,7 +874,7 @@ bool CNetAddr::IsTorV3() const
 
 bool CNetAddr::IsI2P() const
 {
-    return (memcmp(ip, pchGarliCat, sizeof(pchGarliCat)) == 0);
+    return m_is_i2p || (memcmp(ip, pchGarliCat, sizeof(pchGarliCat)) == 0);
 }
 
 bool CNetAddr::IsLocal() const
@@ -878,8 +980,15 @@ std::string CNetAddr::ToStringIP() const
     }
     if (IsTor())
         return EncodeBase32(&ip[6], 10) + ".onion";
+    if (m_is_i2p) {
+        // Modern I2P: base32 of the 32-byte destination hash, unpadded.
+        std::string b32 = EncodeBase32(tor_v3_pubkey, 32);
+        while (!b32.empty() && b32[b32.size() - 1] == '=')
+            b32.erase(b32.size() - 1);
+        return b32 + ".b32.i2p";
+    }
     if (IsI2P())
-        return EncodeBase32(&ip[6], 10) + ".oc.b32.i2p";
+        return EncodeBase32(&ip[6], 10) + ".b32.i2p";
     CService serv(*this, 0);
 #ifdef USE_IPV6
     struct sockaddr_storage sockaddr;
@@ -911,12 +1020,14 @@ bool operator==(const CNetAddr& a, const CNetAddr& b)
 {
     if (a.m_is_tor_v3 || b.m_is_tor_v3)
         return a.m_is_tor_v3 == b.m_is_tor_v3 && memcmp(a.tor_v3_pubkey, b.tor_v3_pubkey, 32) == 0;
+    if (a.m_is_i2p || b.m_is_i2p)
+        return a.m_is_i2p == b.m_is_i2p && memcmp(a.tor_v3_pubkey, b.tor_v3_pubkey, 32) == 0;
     return (memcmp(a.ip, b.ip, 16) == 0);
 }
 
 bool operator!=(const CNetAddr& a, const CNetAddr& b)
 {
-    return (memcmp(a.ip, b.ip, 16) != 0);
+    return !(a == b);
 }
 
 bool operator<(const CNetAddr& a, const CNetAddr& b)
@@ -925,6 +1036,10 @@ bool operator<(const CNetAddr& a, const CNetAddr& b)
         return !a.m_is_tor_v3; // non-v3 sorts before v3
     if (a.m_is_tor_v3)
         return memcmp(a.tor_v3_pubkey, b.tor_v3_pubkey, 32) < 0;
+    if (a.m_is_i2p != b.m_is_i2p)
+        return !a.m_is_i2p; // non-i2p sorts before i2p
+    if (a.m_is_i2p)
+        return memcmp(a.tor_v3_pubkey, b.tor_v3_pubkey, 32) < 0;
     return (memcmp(a.ip, b.ip, 16) < 0);
 }
 
@@ -948,6 +1063,17 @@ bool CNetAddr::GetIn6Addr(struct in6_addr* pipv6Addr) const
 // no two connections will be attempted to addresses with the same group
 std::vector<unsigned char> CNetAddr::GetGroup() const
 {
+    // Modern I2P addresses keep their identifying bytes in the 32-byte
+    // destination-hash field (ip[] only holds the overlay prefix), so derive
+    // the group from the hash to keep peers in distinct groups.
+    if (m_is_i2p) {
+        std::vector<unsigned char> vch;
+        vch.push_back(NET_I2P);
+        vch.push_back(tor_v3_pubkey[0]);
+        vch.push_back(tor_v3_pubkey[1]);
+        return vch;
+    }
+
     std::vector<unsigned char> vchRet;
     int nClass = NET_IPV6;
     int nStartByte = 0;
@@ -1022,7 +1148,7 @@ std::vector<unsigned char> CNetAddr::GetGroup() const
 uint64_t CNetAddr::GetHash() const
 {
     uint256 hash;
-    if (m_is_tor_v3)
+    if (m_is_tor_v3 || m_is_i2p)
         hash = Hash(&tor_v3_pubkey[0], &tor_v3_pubkey[32]);
     else
         hash = Hash(&ip[0], &ip[16]);
@@ -1287,3 +1413,151 @@ void CService::SetPort(unsigned short portIn)
 {
     port = portIn;
 }
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// v5.9.22 hardening: pure helper functions for the HTTPS seed-list path.
+// See netbase.h for the contract. These are intentionally free of SSL/Tor
+// dependencies so they can be unit-tested in isolation.
+// ═══════════════════════════════════════════════════════════════════════════════
+
+bool IsValidSocksNegotiationTimeout(int nMs)
+{
+    // Range bounds match the documented -torconnecttimeout contract. 5000ms
+    // is the lower edge that still tolerates a slow SOCKS handshake over a
+    // congested link; 180000ms (3 min) is the upper edge to prevent a stuck
+    // thread from holding an outbound connection slot indefinitely. These
+    // constants are duplicated in src/init.cpp's HelpMessage text and the
+    // test suite — keep all three in sync.
+    return nMs >= 5000 && nMs <= 180000;
+}
+
+int DechunkTransferEncoding(const std::string& body, std::string& decoded)
+{
+    decoded.clear();
+    if (body.empty())
+        return DECHUNK_EMPTY;
+
+    // HTTP chunked framing requires every chunk-size line to be terminated
+    // by CRLF. We walk the body one chunk at a time and validate each piece.
+    // The previous implementation silently dropped malformed chunks and
+    // treated them as the last-chunk marker, which lost the entire seed list
+    // for any non-conforming server. This version returns an explicit error
+    // code for each failure mode.
+    size_t pos = 0;
+    const size_t n = body.size();
+    bool sawLastChunk = false;
+
+    while (pos < n) {
+        // Find end of chunk-size line. Required: CRLF.
+        size_t eol = body.find("\r\n", pos);
+        if (eol == std::string::npos)
+            return DECHUNK_NO_CHUNK_TERMINATOR;
+
+        std::string sizeLine = body.substr(pos, eol - pos);
+        pos = eol + 2; // consume CRLF
+
+        // Strip chunk extensions per RFC 7230 §4.1.1: ";name[=value]" after
+        // the hex size. Extensions are part of the framing protocol, not
+        // data, so we drop them here.
+        size_t semi = sizeLine.find(';');
+        std::string hexSize = (semi == std::string::npos) ? sizeLine : sizeLine.substr(0, semi);
+
+        // Strict hex validation: every character must be [0-9A-Fa-f]. Empty
+        // size lines (e.g. a stray CRLF) are rejected as malformed, not
+        // silently treated as 0. strtoul alone would also accept leading
+        // whitespace, '+', and '-' which we don't want.
+        if (hexSize.empty())
+            return DECHUNK_INVALID_HEX;
+        for (size_t i = 0; i < hexSize.size(); ++i) {
+            if (!isxdigit(static_cast<unsigned char>(hexSize[i])))
+                return DECHUNK_INVALID_HEX;
+        }
+
+        // strtoul returns ULONG_MAX on overflow. We also need to guard
+        // against chunks larger than the remaining input, which the old
+        // code clamped silently. Use strtoull so we can detect overflow
+        // without truncation surprises on 32-bit builds.
+        errno = 0;
+        char* endp = nullptr;
+        unsigned long long chunkSize = strtoull(hexSize.c_str(), &endp, 16);
+        if (errno == ERANGE || chunkSize > std::numeric_limits<size_t>::max())
+            return DECHUNK_INVALID_HEX;
+        if (endp == hexSize.c_str())
+            return DECHUNK_INVALID_HEX;
+
+        if (chunkSize == 0) {
+            // Last-chunk: payload is empty, trailer part (which we ignore)
+            // follows and is terminated by a final CRLF on its own line.
+            sawLastChunk = true;
+            break;
+        }
+
+        // Bounds check before reading the chunk data. Catching this
+        // explicitly (rather than clamping) is what lets callers
+        // distinguish "truncated network read" from "server sent us junk".
+        if (chunkSize > n - pos)
+            return DECHUNK_OVERSIZE_CHUNK;
+
+        decoded.append(body, pos, static_cast<size_t>(chunkSize));
+        pos += static_cast<size_t>(chunkSize);
+
+        // Per RFC 7230 each chunk's data must be followed by a CRLF. We
+        // tolerate the final chunk missing its trailing CRLF (some clients
+        // do this when the connection is being closed anyway), but for any
+        // non-final chunk a missing CRLF is a hard framing error.
+        if (pos + 1 < n && body[pos] == '\r' && body[pos + 1] == '\n') {
+            pos += 2;
+        } else if (pos >= n) {
+            // End of input immediately after chunk data — no CRLF, but
+            // nothing left to misframe. Reject to be strict.
+            return DECHUNK_MISSING_DATA_CRLF;
+        } else {
+            return DECHUNK_MISSING_DATA_CRLF;
+        }
+    }
+
+    if (!sawLastChunk) {
+        // Body ended without a last-chunk marker. Treat as malformed
+        // rather than accepting a truncated body.
+        return DECHUNK_NO_CHUNK_TERMINATOR;
+    }
+
+    return DECHUNK_OK;
+}
+
+std::vector<std::string> ParseSeedListBody(const std::string& body)
+{
+    std::vector<std::string> out;
+    std::istringstream lines(body);
+    std::string line;
+    while (std::getline(lines, line)) {
+        // Strip inline '#' comments. Per common seed-list convention, the
+        // first '#' to end-of-line is comment.
+        size_t hashPos = line.find('#');
+        if (hashPos != std::string::npos)
+            line = line.substr(0, hashPos);
+
+        // Split on whitespace, comma, or semicolon so multiple addresses
+        // on one line are all captured. CR/LF are already consumed by
+        // std::getline but a trailing CR (LF-only line endings) is trimmed
+        // implicitly by skipping it as a separator below.
+        size_t start = 0;
+        while (start <= line.size()) {
+            size_t sep = line.find_first_of(" \t,;", start);
+            std::string tok = (sep == std::string::npos)
+                ? line.substr(start)
+                : line.substr(start, sep - start);
+            // Trim CR and any leftover whitespace from the token. The
+            // 'sep' loop above eats spaces/tabs but a bare CR survives.
+            while (!tok.empty() && (tok.back() == '\r' || tok.back() == ' ' || tok.back() == '\t'))
+                tok.pop_back();
+            while (!tok.empty() && (tok.front() == ' ' || tok.front() == '\t'))
+                tok.erase(tok.begin());
+            if (!tok.empty())
+                out.push_back(tok);
+            if (sep == std::string::npos) break;
+            start = sep + 1;
+        }
+    }
+    return out;
+}

src/netbase.h

@@ -29,15 +29,89 @@ enum Network
 };
 
 extern int nConnectTimeout;
+extern int nSocksNegotiationTimeout;
 extern bool fNameLookup;
 
+// ═══════════════════════════════════════════════════════════════════════════════
+// v5.9.22 hardening: pure helper functions for the HTTPS seed-list path.
+// Extracted from net.cpp ThreadHTTPSeedFetch2 so they can be unit-tested
+// without the SSL/Tor network stack. All functions are side-effect free and
+// operate on std::string/std::vector<std::string> only.
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Result of dechunking an HTTP/1.1 chunked body. The daemon used to silently
+ * treat malformed framing as a zero-length chunk, which dropped the entire
+ * seed list. This enum lets the caller distinguish each failure mode and
+ * surface it in logs.
+ */
+enum DechunkResult {
+    DECHUNK_OK = 0,              // success
+    DECHUNK_EMPTY,               // body is empty
+    DECHUNK_NO_CHUNK_TERMINATOR, // missing CRLF after a chunk-size line
+    DECHUNK_INVALID_HEX,         // chunk-size line is not valid hex
+    DECHUNK_OVERSIZE_CHUNK,      // declared chunk size exceeds remaining input
+    DECHUNK_MISSING_DATA_CRLF,   // CRLF missing after a chunk's data
+};
+
+/**
+ * Decode an HTTP/1.1 Transfer-Encoding: chunked body.
+ *
+ *   chunked-body  = *chunk last-chunk trailer-part CRLF
+ *   chunk         = chunk-size [ chunk-ext ] CRLF chunk-data CRLF
+ *   chunk-size    = 1*HEXDIG
+ *   last-chunk    = 1*("0") [ chunk-ext ] CRLF
+ *   chunk-ext     = *( ";" chunk-ext-name [ "=" chunk-ext-val ] )
+ *
+ * @param[in]  body     the raw body bytes after the header terminator
+ * @param[out] decoded  the dechunked payload on success
+ * @return status code (DECHUNK_OK or one of the failure modes)
+ *
+ * The implementation is intentionally strict: a malformed hex digit, a
+ * missing CRLF, or a chunk whose declared size is larger than the remaining
+ * input all return an explicit error code rather than silently clamping.
+ * Chunk extensions ("a;foo=bar") are preserved (stripped from the size
+ * line) so legitimate servers that attach metadata to chunks are still
+ * accepted.
+ */
+int DechunkTransferEncoding(const std::string& body, std::string& decoded);
+
+/**
+ * Parse a tolerant HTTPS seed-list body into individual host entries.
+ *
+ * Accepted per line:
+ *   - one or more addresses separated by whitespace, commas, or semicolons
+ *   - inline "#" comments (everything after '#' is dropped)
+ *   - blank lines
+ *   - CRLF or LF line endings
+ *
+ * Each returned entry is the address string (e.g. "abcd...onion:24112" or
+ * "abcd...onion"). Empty/whitespace-only entries are omitted. The result is
+ * a list of candidate strings suitable for CNetAddr/CService validation
+ * downstream.
+ */
+std::vector<std::string> ParseSeedListBody(const std::string& body);
+
+/**
+ * Validate the -torconnecttimeout / nSocksNegotiationTimeout value.
+ *
+ * Accepts 5000..180000 ms inclusive. Returns true for in-range, false for
+ * out-of-range. This is the central policy so callers and tests stay in
+ * sync; do not duplicate the literal numbers elsewhere.
+ */
+bool IsValidSocksNegotiationTimeout(int nMs);
+
 /** IP address (IPv6, or IPv4 using mapped IPv6 range (::FFFF:0:0/96)) */
 class CNetAddr
 {
     protected:
         unsigned char ip[16]; // in network byte order
-        unsigned char tor_v3_pubkey[32]; // Ed25519 public key for Tor v3 onion addresses
+        // For Tor v3 this holds the 32-byte Ed25519 public key. When m_is_i2p is
+        // set it instead holds the 32-byte SHA-256 of the I2P destination (the
+        // value rendered as the ".b32.i2p" address). A CNetAddr is never both.
+        unsigned char tor_v3_pubkey[32];
         bool m_is_tor_v3;
+        bool m_is_i2p;
 
     public:
         CNetAddr();
@@ -90,6 +164,7 @@ class CNetAddr
              READWRITE(FLATDATA(ip));
              READWRITE(FLATDATA(tor_v3_pubkey));
              READWRITE(m_is_tor_v3);
+             READWRITE(m_is_i2p);
             )
 };
 
@@ -133,6 +208,7 @@ class CService : public CNetAddr
              READWRITE(FLATDATA(ip));
              READWRITE(FLATDATA(tor_v3_pubkey));
              READWRITE(m_is_tor_v3);
+             READWRITE(m_is_i2p);
              unsigned short portN = htons(port);
              READWRITE(portN);
              if (fRead)