Release/9.9.0

.github/workflows/changelog-checker.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: tj-actions/changed-files@v42
+      - uses: tj-actions/changed-files@v46
         id: changed
       - name: Ensure CHANGELOG.md updated
         if: contains(steps.changed.outputs.all_changed_files, 'CHANGELOG.md') == false

.github/workflows/flake8-and-mypy.yml

@@ -42,7 +42,8 @@ jobs:
           python -m venv venv
           source venv/bin/activate
           python -m pip install --upgrade pip
-          python -m pip install uv
+          # needed for Python 3.9 compatibility
+          python -m pip install uv>=0.8.8
           python -m uv sync --extra dev --active
 
       - name: Flake8

.github/workflows/nightly-e2e-tests-subtensor-main.yml

@@ -76,23 +76,29 @@ jobs:
         with:
           name: subtensor-localnet-devnet-ready
           path: subtensor-localnet-devnet-ready.tar
+
   # Determine the day for non-fast-blocks run
-  check-if-saturday:
+  check-if-non-fast-blocks-run:
     runs-on: ubuntu-latest
     outputs:
-      is-saturday: ${{ steps.check.outputs.is-saturday }}
+      non-fast-blocks-run: ${{ steps.check.outputs.non-fast-blocks-run }}
     steps:
       - id: check
         run: |
-          day=$(date -u +%u)
-          echo "Today is weekday $day"
-          if [ "$day" -ne 6 ]; then
-            echo "⏭️ Skipping: not Saturday"
-            echo "is-saturday=false" >> "$GITHUB_OUTPUT"
-            exit 0
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "🔁 Manual trigger detected. Forcing non-fast-blocks-run=true"
+            echo "non-fast-blocks-run=true" >> "$GITHUB_OUTPUT"
+          else
+            day=$(date -u +%u)
+            echo "Today is weekday $day"
+            if [ "$day" -ne 6 ]; then
+              echo "⏭️ Skipping: not Saturday"
+              echo "non-fast-blocks-run=false" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+            echo "✅ It is Saturday"
+            echo "non-fast-blocks-run=true" >> "$GITHUB_OUTPUT"
           fi
-          echo "is-saturday=true"
-          echo "is-saturday=true" >> "$GITHUB_OUTPUT"
 
   # Daily run of fast-blocks tests from `bittensor:master` based on `subtensor:main docker` image
   run-fast-blocks-e2e-test-master:
@@ -102,6 +108,9 @@ jobs:
       - pull-docker-images
     runs-on: ubuntu-latest
     timeout-minutes: 25
+    outputs:
+      failed: ${{ steps.test-failed.outputs.failed }}
+
     strategy:
       fail-fast: false  # Allow other matrix jobs to run even if this job fails
       max-parallel: 32  # Set the maximum number of parallel jobs (same as we have cores in ubuntu-latest runner)
@@ -136,22 +145,27 @@ jobs:
         run: docker load -i subtensor-localnet-main.tar
 
       - name: Run tests with retry
+        id: test-failed
         env:
           FAST_BLOCKS: "1"
           LOCALNET_IMAGE_NAME: "ghcr.io/opentensor/subtensor-localnet:main"
         run: |
           set +e
           for i in 1 2 3; do
-            echo "🔁 Attempt $i: Running tests"
+            echo "::group::🔁 Test attempt $i"
             uv run pytest ${{ matrix.test-file }} -s
             status=$?
             if [ $status -eq 0 ]; then
               echo "✅ Tests passed on attempt $i"
+              echo "::endgroup::"
+              echo "failed=false" >> "$GITHUB_OUTPUT"
               break
             else
               echo "❌ Tests failed on attempt $i"
+              echo "::endgroup::"
               if [ $i -eq 3 ]; then
                 echo "Tests failed after 3 attempts"
+                echo "failed=true" >> "$GITHUB_OUTPUT"
                 exit 1
               fi
               echo "Retrying..."
@@ -167,6 +181,9 @@ jobs:
       - pull-docker-images
     runs-on: ubuntu-latest
     timeout-minutes: 25
+    outputs:
+      failed: ${{ steps.test-failed.outputs.failed }}
+
     strategy:
       fail-fast: false  # Allow other matrix jobs to run even if this job fails
       max-parallel: 32  # Set the maximum number of parallel jobs (same as we have cores in ubuntu-latest runner)
@@ -201,22 +218,27 @@ jobs:
         run: docker load -i subtensor-localnet-devnet-ready.tar
 
       - name: Run tests with retry
+        id: test-failed
         env:
           FAST_BLOCKS: "1"
           LOCALNET_IMAGE_NAME: "ghcr.io/opentensor/subtensor-localnet:devnet-ready"
         run: |
           set +e
           for i in 1 2 3; do
-            echo "🔁 Attempt $i: Running tests"
+            echo "::group::🔁 Test attempt $i"
             uv run pytest ${{ matrix.test-file }} -s
             status=$?
             if [ $status -eq 0 ]; then
               echo "✅ Tests passed on attempt $i"
+              echo "::endgroup::"
+              echo "failed=false" >> "$GITHUB_OUTPUT"
               break
             else
               echo "❌ Tests failed on attempt $i"
+              echo "::endgroup::"
               if [ $i -eq 3 ]; then
                 echo "Tests failed after 3 attempts"
+                echo "failed=true" >> "$GITHUB_OUTPUT"
                 exit 1
               fi
               echo "Retrying..."
@@ -226,14 +248,16 @@ jobs:
 
   # Saturday run of non-fast-blocks tests from `bittensor:master` based on `subtensor:main` docker image
   run-non-fast-blocks-e2e-test-master:
-    if: needs.check-if-saturday.outputs.is-saturday == 'true'
+    if: needs.check-if-non-fast-blocks-run.outputs.non-fast-blocks-run == 'true'
     name: "NFB master: ${{ matrix.test-file }} / Python ${{ matrix.python-version }}"
     needs:
-      - check-if-saturday
+      - check-if-non-fast-blocks-run
       - find-tests
       - pull-docker-images
     runs-on: ubuntu-latest
     timeout-minutes: 1440
+    outputs:
+      failed: ${{ steps.test-failed.outputs.failed }}
 
     strategy:
       fail-fast: false  # Allow other matrix jobs to run even if this job fails
@@ -270,22 +294,27 @@ jobs:
         run: docker load -i subtensor-localnet-main.tar
 
       - name: Run patched E2E tests
+        id: test-failed
         env:
           FAST_BLOCKS: "0"
           LOCALNET_IMAGE_NAME: "ghcr.io/opentensor/subtensor-localnet:main"
         run: |
           set +e
           for i in 1 2 3; do
-            echo "🔁 Attempt $i: Running tests"
+            echo "::group::🔁 Test attempt $i"
             uv run pytest ${{ matrix.test-file }} -s
             status=$?
             if [ $status -eq 0 ]; then
               echo "✅ Tests passed on attempt $i"
+              echo "::endgroup::"
+              echo "failed=false" >> "$GITHUB_OUTPUT"
               break
             else
               echo "❌ Tests failed on attempt $i"
+              echo "::endgroup::"
               if [ $i -eq 3 ]; then
                 echo "Tests failed after 3 attempts"
+                echo "failed=true" >> "$GITHUB_OUTPUT"
                 exit 1
               fi
               echo "Retrying..."
@@ -295,14 +324,16 @@ jobs:
 
   # Saturday run of non-fast-blocks tests from `bittensor:staging` based on `subtensor:devnet-ready` docker image
   run-non-fast-blocks-e2e-test-staging:
-    if: needs.check-if-saturday.outputs.is-saturday == 'true'
+    if: needs.check-if-non-fast-blocks-run.outputs.non-fast-blocks-run == 'true'
     name: "NFB staging: ${{ matrix.test-file }} / Python ${{ matrix.python-version }}"
     needs:
-      - check-if-saturday
+      - check-if-non-fast-blocks-run
       - find-tests
       - pull-docker-images
     runs-on: ubuntu-latest
     timeout-minutes: 1440
+    outputs:
+      failed: ${{ steps.test-failed.outputs.failed }}
 
     strategy:
       fail-fast: false  # Allow other matrix jobs to run even if this job fails
@@ -339,25 +370,50 @@ jobs:
         run: docker load -i subtensor-localnet-devnet-ready.tar
 
       - name: Run patched E2E tests
+        id: test-failed
         env:
           FAST_BLOCKS: "0"
           LOCALNET_IMAGE_NAME: "ghcr.io/opentensor/subtensor-localnet:devnet-ready"
         run: |
           set +e
           for i in 1 2 3; do
-            echo "🔁 Attempt $i: Running tests"
+            echo "::group::🔁 Test attempt $i"
             uv run pytest ${{ matrix.test-file }} -s
             status=$?
             if [ $status -eq 0 ]; then
               echo "✅ Tests passed on attempt $i"
+              echo "::endgroup::"
+              echo "failed=false" >> "$GITHUB_OUTPUT"
               break
             else
               echo "❌ Tests failed on attempt $i"
+              echo "::endgroup::"
               if [ $i -eq 3 ]; then
                 echo "Tests failed after 3 attempts"
+                echo "failed=true" >> "$GITHUB_OUTPUT"
                 exit 1
               fi
               echo "Retrying..."
               sleep 5
             fi
           done
+
+  # Send centralized Discord failure notification
+  notify-on-failure:
+    needs:
+      - run-fast-blocks-e2e-test-master
+      - run-fast-blocks-e2e-test-staging
+      - run-non-fast-blocks-e2e-test-master
+      - run-non-fast-blocks-e2e-test-staging
+    if: |
+      needs.run-fast-blocks-e2e-test-master.outputs.failed == 'true' ||
+      needs.run-fast-blocks-e2e-test-staging.outputs.failed == 'true' ||
+      needs.run-non-fast-blocks-e2e-test-master.outputs.failed == 'true' ||
+      needs.run-non-fast-blocks-e2e-test-staging.outputs.failed == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Send centralized Discord failure notification
+        run: |
+          curl -X POST -H "Content-Type: application/json" \
+            -d "{\"username\": \"Nightly CI\", \"content\": \"❌ Nightly E2E tests failed. Check run: <${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}>\"}" \
+            "${{ secrets.NIGHTLY_WEBHOOK_URL }}"

.github/workflows/unit-and-integration-tests.yml

@@ -39,7 +39,8 @@ jobs:
           python -m venv venv
           source venv/bin/activate
           python -m pip install --upgrade pip
-          python -m pip install uv
+          # needed for Python 3.9 compatibility
+          python -m pip install uv>=0.8.8
           python -m uv sync --extra dev --active
 
       - name: Unit tests

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 9.9.0 /2025-08-11
+
+## What's Changed
+* Fix crv3 tests after devnet-ready get `CRV3WeightCommitsV2` by @basfroman in https://github.com/opentensor/bittensor/pull/2978
+* Add webhook for failed nightly tests by @basfroman in https://github.com/opentensor/bittensor/pull/2987
+* Fix liquidity test (non-fast-blocks node) by @basfroman in https://github.com/opentensor/bittensor/pull/2988
+* improve nightly logic by @basfroman in https://github.com/opentensor/bittensor/pull/2989
+* improve nightly 2 by @basfroman in https://github.com/opentensor/bittensor/pull/2990
+* Add `get_stake_weight` methods by @basfroman in https://github.com/opentensor/bittensor/pull/2985
+* Handles both exceptions for Swap pallet fetching by @thewhaleking in https://github.com/opentensor/bittensor/pull/2991
+* chore: fix typo by @socialsister in https://github.com/opentensor/bittensor/pull/2969
+* optimisations mostly related to liquidity_list by @thewhaleking in https://github.com/opentensor/bittensor/pull/2980
+* Transfers improvements by @thewhaleking in https://github.com/opentensor/bittensor/pull/2993
+* Remove ownership check in `transfer_stake_extrinsic` and `swap_stake_extrinsic` by @basfroman in https://github.com/opentensor/bittensor/pull/2996
+* Missed await by @thewhaleking in https://github.com/opentensor/bittensor/pull/3002
+* chore: fix typo by @lechpzn in https://github.com/opentensor/bittensor/pull/3001
+* Adds note for installing on macOS by @thewhaleking in https://github.com/opentensor/bittensor/pull/3004
+* Bump bittensor-wallet version by @thewhaleking in https://github.com/opentensor/bittensor/pull/3005
+* Format Error with string docs by @thewhaleking in https://github.com/opentensor/bittensor/pull/3006
+* `LoggingMachine` initialization updated to explicitly call both parent constructors by @basfroman in https://github.com/opentensor/bittensor/pull/3008
+* Fixed `moving_price` conversion from `I96F32` to float by @mcjkula in https://github.com/opentensor/bittensor/pull/3010
+* Add new CRv4 logic by @basfroman in https://github.com/opentensor/bittensor/pull/2999
+* UV Fix by @thewhaleking in https://github.com/opentensor/bittensor/pull/3011
+
+## New Contributors
+* @socialsister made their first contribution in https://github.com/opentensor/bittensor/pull/2969
+* @lechpzn made their first contribution in https://github.com/opentensor/bittensor/pull/3001
+* @mcjkula made their first contribution in https://github.com/opentensor/bittensor/pull/3010
+
+**Full Changelog**: https://github.com/opentensor/bittensor/compare/v9.8.3...v9.9.0
+
 ## 9.8.3 /2025-07-18
 * improve make file by @basfroman in https://github.com/opentensor/bittensor/pull/2965
 * Move all workflows from `app.circleci.com` to `GH actions` by @basfroman in https://github.com/opentensor/bittensor/pull/2970

README.md

@@ -94,6 +94,14 @@ python3 -m pip install --upgrade bittensor
 
 ## Install on macOS and Linux
 
+### Note for macOS users
+The macOS preinstalled CPython installation is compiled with LibreSSL instead of OpenSSL. There are a number
+of issues with LibreSSL, and as such is not fully supported by the libraries used by bittensor. Thus we highly recommend, if 
+you are using a Mac, to first install Python from [Homebrew](https://brew.sh/). Additionally, the Rust FFI bindings 
+[if installing from precompiled wheels (default)] require the Homebrew-installed OpenSSL pacakge. If you choose to use
+the preinstalled Python version from macOS, things may not work completely.
+
+### Installation
 You can install Bittensor SDK on your local machine in either of the following ways. **Make sure you verify your installation after you install**:
 - [Install using a Bash command](#install-using-a-bash-command).
 - [Install using `pip3 install`](#install-using-pip3-install)
@@ -158,6 +166,13 @@ You can install using any of the below options:
   1. Install `cubit` first. See the [Install](https://github.com/opentensor/cubit?tab=readme-ov-file#install) section. **Only Python 3.9 and 3.10 versions are supported**. 
   2. Then install SDK with `pip install bittensor`.
 
+
+### Troubleshooting
+#### SSL: CERTIFICATE_VERIFY_FAILED
+
+If you are encountering a `[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate` 
+error, use the command `python -m bittensor certifi` which will update your local SSL certificates.
+
 ---
 
 ## Install on Windows