Merge pull request #62 from opentensor/release/1.1.0

Release/1.1.0

Author: basfroman

.circleci/config.yml

@@ -47,7 +47,7 @@ jobs:
         uses: PyO3/[email protected]
         with:
           target: ${{ matrix.platform.target }}
-          args: --release --out dist --interpreter python3.9 python3.10 python3.11 python3.12 python3.13
+          args: --release --out dist --interpreter python3.10 python3.11 python3.12 python3.13 python3.14
           sccache: 'true'
           manylinux: auto
           before-script-linux: |
@@ -69,9 +69,9 @@ jobs:
     strategy:
       matrix:
         platform:
-          - runner: macos-13
+          - runner: macos-15-intel
             target: x86_64
-          - runner: macos-14
+          - runner: macos-latest
             target: aarch64
     steps:
       - uses: actions/checkout@v4
@@ -83,7 +83,7 @@ jobs:
         uses: PyO3/[email protected]
         with:
           target: ${{ matrix.platform.target }}
-          args: --release --out dist --interpreter python3.9 python3.10 python3.11 python3.12 python3.13
+          args: --release --out dist --interpreter python3.10 python3.11 python3.12 python3.13 python3
           sccache: 'true'
 
       - name: Upload wheels

.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: Test and Lint
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  ruff:
+    name: Ruff Linting
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.9.13'
+
+      - name: Install Ruff
+        run: pip install ruff
+
+      - name: Run Ruff
+        run: ruff check .
+
+  build-and-test:
+    name: Build and Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+      fail-fast: false
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Set Up Virtual Environment
+        run: |
+          python -m venv .venv
+          source .venv/bin/activate
+          python -m pip install --upgrade pip
+          python -m pip install '.[dev]'
+
+      - name: Create test results directory
+        run: mkdir -p test-results
+
+      - name: Run Tests
+        run: |
+          source .venv/bin/activate
+          pytest tests/
+        continue-on-error: false
+

.github/workflows/test-and-lint.yml

@@ -1,5 +1,20 @@
 # Changelog
 
+## v1.1.0 /2025-11-17
+
+## What's Changed
+* Add missing hotkey parameter to test functions by @Gimzou in https://github.com/opentensor/bittensor-drand/pull/48
+* Update release workflow by @basfroman in https://github.com/opentensor/bittensor-drand/pull/58
+* feat: add encrypt_at_round() for direct Drand round encryption by @ShubhamChndrvnshi in https://github.com/opentensor/bittensor-drand/pull/56
+* feat: add decrypt_with_signature() by @ShubhamChndrvnshi in https://github.com/opentensor/bittensor-drand/pull/59
+* Python 3.14 support, fix unit tests + move workflow to gh by @basfroman in https://github.com/opentensor/bittensor-drand/pull/60
+
+## New Contributors
+* @Gimzou made their first contribution in https://github.com/opentensor/bittensor-drand/pull/48
+* @ShubhamChndrvnshi made their first contribution in https://github.com/opentensor/bittensor-drand/pull/56
+
+**Full Changelog**: https://github.com/opentensor/bittensor-drand/compare/v1.0.1...v1.1.0
+
 ## v1.0.1 /2025-10-29
 * Updates PyO3 to handle py3.14 by @thewhaleking in https://github.com/opentensor/bittensor-drand/pull/52
 * Updates workflow to be able to use forks as well by @thewhaleking in https://github.com/opentensor/bittensor-drand/pull/51

CHANGELOG.MD

@@ -1,6 +1,6 @@
 [package]
 name = "bittensor-drand"
-version = "1.0.1"
+version = "1.1.0"
 edition = "2021"
 
 [lib]

Cargo.lock

@@ -4,7 +4,10 @@
     get_encrypted_commit as _get_encrypted_commit,
     get_encrypted_commitment as _get_encrypted_commitment,
     encrypt as _encrypt,
+    encrypt_at_round as _encrypt_at_round,
     decrypt as _decrypt,
+    decrypt_with_signature as _decrypt_with_signature,
+    get_signature_for_round as _get_signature_for_round,
     get_latest_round as _get_latest_round,
 )
 
@@ -93,6 +96,23 @@ def encrypt(
     return _encrypt(data, n_blocks, block_time)
 
 
+def encrypt_at_round(data: bytes, reveal_round: int) -> tuple[bytes, int]:
+    """Encrypts arbitrary binary data for a specific Drand reveal round.
+
+    Arguments:
+        data: The binary data to encrypt.
+        reveal_round: The specific Drand round number when decryption becomes possible.
+
+    Returns:
+        encrypted_data (bytes): Raw bytes of the encrypted data.
+        reveal_round (int): The Drand round number when data can be revealed (same as input).
+
+    Raises:
+        ValueError: If encryption fails.
+    """
+    return _encrypt_at_round(data, reveal_round)
+
+
 def decrypt(encrypted_data: bytes, no_errors: bool = True) -> Optional[bytes]:
     """Decrypts previously encrypted data if the reveal time has been reached.
 
@@ -110,6 +130,41 @@ def decrypt(encrypted_data: bytes, no_errors: bool = True) -> Optional[bytes]:
     return _decrypt(encrypted_data, no_errors)
 
 
+def decrypt_with_signature(encrypted_data: bytes, signature_hex: str) -> bytes:
+    """Decrypts data using a provided Drand signature.
+    This function is useful when decrypting multiple ciphertexts for the same round,
+    allowing you to fetch the signature once and reuse it, avoiding redundant API calls.
+
+    Arguments:
+        encrypted_data: The encrypted data to decrypt.
+        signature_hex: Hex-encoded Drand BLS signature for the reveal round.
+
+    Returns:
+        decrypted_data (bytes): The decrypted data.
+
+    Raises:
+        ValueError: If decryption fails or signature is invalid.
+    """
+    return _decrypt_with_signature(encrypted_data, signature_hex)
+
+
+def get_signature_for_round(reveal_round: int) -> str:
+    """Fetches the Drand signature for a specific round.
+    This is useful for batch decryption scenarios where you want to decrypt
+    multiple ciphertexts for the same round without making redundant API calls.
+
+    Arguments:
+        reveal_round: The Drand round number to fetch the signature for.
+
+    Returns:
+        signature_hex (str): Hex-encoded BLS signature for the round.
+
+    Raises:
+        ValueError: If the signature cannot be fetched or is not yet available.
+    """
+    return _get_signature_for_round(reveal_round)
+
+
 def get_latest_round() -> int:
     """Gets the latest revealed Drand round number.
 

Cargo.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bittensor-drand"
-version = "1.0.1"
+version = "1.1.0"
 description = ""
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -21,11 +21,11 @@ classifiers = [
         "Topic :: Software Development :: Build Tools",
         "License :: OSI Approved :: MIT License",
         "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
         "Topic :: Scientific/Engineering",
         "Topic :: Scientific/Engineering :: Mathematics",
         "Topic :: Scientific/Engineering :: Artificial Intelligence",
@@ -49,4 +49,4 @@ exclude = ["tests*"]
 dev = [
     "maturin==1.7.0",
     "pytest-asyncio==0.23.7"
-]
+]