Release/9.5.0

.github/workflows/docker_release.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
     - name: Check out code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Install cosign
       uses: sigstore/cosign-installer@v3
@@ -48,4 +48,4 @@ jobs:
         DIGEST: ${{ steps.build.outputs.digest }}
         TAGS: ${{ steps.build.outputs.tags }}
       run: |
-        echo "${TAGS}" | xargs -I {} cosign sign --yes {}@${DIGEST}
+        echo "${TAGS}" | xargs -I {} cosign sign --yes {}@${DIGEST}

.github/workflows/e2e-subtensor-tests.yaml

@@ -12,6 +12,9 @@ on:
     branches: [master, development, staging]
     types: [ opened, synchronize, reopened, ready_for_review ]
 
+  schedule:
+    - cron: '0 9 * * *'  # Run every night at 2:00 PST
+
   workflow_dispatch:
     inputs:
       verbose:
@@ -40,7 +43,7 @@ jobs:
         run: |
           test_files=$(find tests/e2e_tests -name "test*.py" | jq -R -s -c 'split("\n") | map(select(. != ""))')
           # keep it here for future debug
-          # test_files=$(find tests/e2e_tests -type f -name "test*.py" | grep -E 'test_(incentive|commit_weights|set_weights)\.py$' | jq -R -s -c 'split("\n") | map(select(. != ""))')
+          # test_files=$(find tests/e2e_tests -type f -name "test*.py" | grep -E 'test_(hotkeys|staking)\.py$' | jq -R -s -c 'split("\n") | map(select(. != ""))')
           echo "test-files=$test_files" >> "$GITHUB_OUTPUT"
         shell: bash
 
@@ -63,8 +66,8 @@ jobs:
           path: subtensor-localnet.tar
 
   # Job to run tests in parallel
-  run-e2e-test:
-    name: ${{ matrix.test-file }} / Python ${{ matrix.python-version }}
+  run-fast-blocks-e2e-test:
+    name: "FB: ${{ matrix.test-file }} / Python ${{ matrix.python-version }}"
     needs:
       - find-tests
       - pull-docker-image
@@ -107,7 +110,80 @@ jobs:
       - name: Run tests with retry
         run: |
           set +e
-          for i in 1 2; do
+          for i in 1 2 3; do
+            echo "🔁 Attempt $i: Running tests"
+            uv run pytest ${{ matrix.test-file }} -s
+            status=$?
+            if [ $status -eq 0 ]; then
+              echo "✅ Tests passed on attempt $i"
+              break
+            else
+              echo "❌ Tests failed on attempt $i"
+              if [ $i -eq 3 ]; then
+                echo "Tests failed after 3 attempts"
+                exit 1
+              fi
+              echo "Retrying..."
+              sleep 5
+            fi
+          done
+
+
+  cron-run-non-fast-blocks-e2e-test:
+    if: github.event_name == 'schedule'
+    name: "NFB: ${{ matrix.test-file }} / Python ${{ matrix.python-version }}"
+    needs:
+      - find-tests
+      - pull-docker-image
+    runs-on: ubuntu-latest
+    timeout-minutes: 1440
+
+    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)
+      matrix:
+        os:
+          - ubuntu-latest
+        test-file: ${{ fromJson(needs.find-tests.outputs.test-files) }}
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Check if today is Saturday
+        run: |
+          day=$(date -u +%u)
+          echo "Today is weekday $day"
+          if [ "$day" -ne 6 ]; then
+            echo "⏭️ Skipping: not Saturday"
+            exit 78
+          fi
+      - name: Check-out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: install dependencies
+        run: uv sync --extra dev --dev
+
+      - name: Download Cached Docker Image
+        uses: actions/download-artifact@v4
+        with:
+          name: subtensor-localnet
+
+      - name: Load Docker Image
+        run: docker load -i subtensor-localnet.tar
+
+      - name: Run patched E2E tests
+        env:
+          FAST_BLOCKS: "0"
+        run: |
+          set +e
+          for i in 1 2 3; do
             echo "🔁 Attempt $i: Running tests"
             uv run pytest ${{ matrix.test-file }} -s
             status=$?
@@ -116,8 +192,8 @@ jobs:
               break
             else
               echo "❌ Tests failed on attempt $i"
-              if [ $i -eq 2 ]; then
-                echo "Tests failed after 2 attempts"
+              if [ $i -eq 3 ]; then
+                echo "Tests failed after 3 attempts"
                 exit 1
               fi
               echo "Retrying..."

.github/workflows/monitor_requirements_size_master.yml

@@ -0,0 +1,88 @@
+# This workflow measures the disk size of a virtual environment
+# after installing the Bittensor SDK across multiple Python versions.
+# It runs only when a new pull request targets the master branch,
+# and posts a comment with the results.
+name: Monitor SDK Requirements Size
+
+on:
+  pull_request:
+    types: [opened]
+    branches: [master]
+
+permissions:
+  pull-requests: write
+  contents: read
+
+jobs:
+  measure-venv:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    outputs:
+      py39: ${{ steps.set-output.outputs.py39 }}
+      py310: ${{ steps.set-output.outputs.py310 }}
+      py311: ${{ steps.set-output.outputs.py311 }}
+      py312: ${{ steps.set-output.outputs.py312 }}
+      py313: ${{ steps.set-output.outputs.py313 }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Create virtualenv and install
+        run: |
+          python -m venv venv
+          source venv/bin/activate
+          pip install --upgrade pip
+          pip install .
+
+      - name: Measure venv size
+        id: set-output
+        run: |
+          SIZE=$(du -sm venv | cut -f1)
+          VERSION=${{ matrix.python-version }}
+          echo "Detected size: $SIZE MB for Python $VERSION"
+          case "$VERSION" in
+            3.9)  echo "py39=$SIZE" >> $GITHUB_OUTPUT ;;
+            3.10) echo "py310=$SIZE" >> $GITHUB_OUTPUT ;;
+            3.11) echo "py311=$SIZE" >> $GITHUB_OUTPUT ;;
+            3.12) echo "py312=$SIZE" >> $GITHUB_OUTPUT ;;
+            3.13) echo "py313=$SIZE" >> $GITHUB_OUTPUT ;;
+          esac
+
+  comment-on-pr:
+    if: github.event_name == 'pull_request' && github.base_ref == 'master'
+    needs: measure-venv
+    runs-on: ubuntu-latest
+    steps:
+      - name: Post venv size summary to PR
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const sizes = {
+              "3.9": "${{ needs.measure-venv.outputs.py39 || 'N/A' }}",
+              "3.10": "${{ needs.measure-venv.outputs.py310 || 'N/A' }}",
+              "3.11": "${{ needs.measure-venv.outputs.py311 || 'N/A' }}",
+              "3.12": "${{ needs.measure-venv.outputs.py312 || 'N/A' }}",
+              "3.13": "${{ needs.measure-venv.outputs.py313 || 'N/A' }}",
+            };
+
+            const body = [
+              '**Bittensor SDK virtual environment sizes by Python version:**',
+              '',
+              '```'
+            ]
+              .concat(Object.entries(sizes).map(([v, s]) => `Python ${v}: ${s} MB`))
+              .concat(['```'])
+              .join('\n');
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body
+            });

.github/workflows/release.yml

@@ -13,7 +13,7 @@ jobs:
     name: Build Python distribution
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
 
     - name: Set up Python
       uses: actions/setup-python@v4
@@ -69,4 +69,4 @@ jobs:
       uses: pypa/gh-action-pypi-publish@release/v1
       with:
         verbose: true
-        print-hash: true
+        print-hash: true

CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 9.5.0 /2025-05-12
+
+## What's Changed
+* Release/9.4.0 by @ibraheem-abe in https://github.com/opentensor/bittensor/pull/2837
+* Update subnet units by @thewhaleking in https://github.com/opentensor/bittensor/pull/2838
+* Add `force_register_neuron` into MockSubtensor by @basfroman in https://github.com/opentensor/bittensor/pull/2839
+* Add `Monitor-Requirements-Size` workflow by @basfroman in https://github.com/opentensor/bittensor/pull/2842
+* Add `SelectiveMetagraph` interface into SDK by @basfroman in https://github.com/opentensor/bittensor/pull/2846
+* Update docs for unstake amount by @thewhaleking in https://github.com/opentensor/bittensor/pull/2845
+* Add one more attempt to e2e tests by @basfroman in https://github.com/opentensor/bittensor/pull/2849
+* Fix typos in test documentation and docstrings by @leopardracer in https://github.com/opentensor/bittensor/pull/2848
+* Add bittensor-drand==0.5.0 by @basfroman in https://github.com/opentensor/bittensor/pull/2835
+* Extend selective metagraph logic by @basfroman in https://github.com/opentensor/bittensor/pull/2852
+* fix: $BASH_ENV loading issue by @defitricks in https://github.com/opentensor/bittensor/pull/2851
+* Update github actions versions due to deprecation by @PixelPil0t1 in https://github.com/opentensor/bittensor/pull/2850
+* Add methods to Async/Subtensor class by @basfroman in https://github.com/opentensor/bittensor/pull/2854
+* Cleanup, refactoring, small fix, improvement by @basfroman in https://github.com/opentensor/bittensor/pull/2856
+* Add `period` argument to extrinsics calls by @basfroman in https://github.com/opentensor/bittensor/pull/2857
+* Add nightly run of e2e tests by @basfroman in https://github.com/opentensor/bittensor/pull/2858
+* `period=16` for fast blocks test by @basfroman in https://github.com/opentensor/bittensor/pull/2859
+* Fix some unittests warnings by @zyzniewski-reef in https://github.com/opentensor/bittensor/pull/2774
+* docs: fix typos in  `README.md` by @gap-editor in https://github.com/opentensor/bittensor/pull/2861
+* Introduce `SubtensorApi` interface for SDK by @basfroman in https://github.com/opentensor/bittensor/pull/2862
+* Adds `__all__` to easy_imports.py to get rid of all the #noqa stuff by @thewhaleking in https://github.com/opentensor/bittensor/pull/2863
+* `🥩s` to `staking` by @basfroman in https://github.com/opentensor/bittensor/pull/2864
+* Fix `get_next_epoch_start_block` by @basfroman in https://github.com/opentensor/bittensor/pull/2865
+* docs: fix dead link by @GarmashAlex in https://github.com/opentensor/bittensor/pull/2866
+* Add `non-fast-blocks` e2e tests each Saturday by @basfroman in https://github.com/opentensor/bittensor/pull/2860
+* Selective-metagraph -> MetagraphInfo by @basfroman in https://github.com/opentensor/bittensor/pull/2870
+* Improve e2e tests and fix bug in SubtensorApi by @basfroman in https://github.com/opentensor/bittensor/pull/2869
+
+## New Contributors
+* @defitricks made their first contribution in https://github.com/opentensor/bittensor/pull/2851
+* @PixelPil0t1 made their first contribution in https://github.com/opentensor/bittensor/pull/2850
+* @gap-editor made their first contribution in https://github.com/opentensor/bittensor/pull/2861
+* @GarmashAlex made their first contribution in https://github.com/opentensor/bittensor/pull/2866
+
+**Full Changelog**: https://github.com/opentensor/bittensor/compare/v9.4.0...v9.5.0
+
 ## 9.4.0 /2025-04-17
 
 ## What's Changed

README.md

@@ -234,23 +234,29 @@ pytest tests/unit_tests
 - using a compiler based on the substrait code
 - using an already built docker image (docker runner)
 
+#### Local environment variables:
+- `LOCALNET_SH_PATH` - path to `localnet.sh` script in cloned subtensor repository (for legacy runner);
+- `BUILD_BINARY` - (`=0` or `=1`) - used with `LOCALNET_SH_PATH` for build or not before start localnet node (for legacy runner);
+- `USE_DOCKER` - (`=0` or `=1`) - used if you want to use specific runner to run e2e tests (for docker runner);
+- `FAST_BLOCKS` - (`=0` or `=1`) - allows you to run a localnet node in fast or non-fast blocks mode (for both types of runers).
+
 #### Using `docker runner` (default for now):
 - E2E tests with docker image do not require preliminary compilation
 - are executed very quickly
 - require docker installed in OS
 
-Ho to use:
+How to use:
 ```bash
 pytest tests/e2e_tests
 ```
 
-#### TUsing `legacy runner`:
+#### Using `legacy runner`:
 - Will start compilation of the collected code in your subtensor repository
 - you must provide the `LOCALNET_SH_PATH` variable in the local environment with the path to the file `/scripts/localnet.sh` in the cloned repository within your OS
 - you can use the `BUILD_BINARY=0` variable, this will skip the copy step for each test.
 - you can use the `USE_DOCKER=0` variable, this will run tests using the "legacy runner", even if docker is installed in your OS
 
-#### Ho to use:
+#### How to use:
 Regular e2e tests run
 ```bash
 LOCALNET_SH_PATH=/path/to/your/localnet.sh pytest tests/e2e_tests