bittensor-drand
Rust-backed Python library for generating timelock-encrypted weight commitments for Bittensor's commit-reveal mechanism using drand randomness.
Decision gist · record as of 2026-08-14
Yes, with caution. The library is feature-complete and carries no known vulnerabilities, with permissive MIT licensing and broad Python version support (3.10–3.14). However, the repository is archived and marked abandoned, meaning no active maintenance or bug fixes should be expected. Install only if you are committed to maintaining a local fork or can tolerate lack of upstream support. For active Bittensor development, prefer using the high-level SDK integration rather than direct library calls.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires bittensor>=11.0.0 to fetch epoch schedule state; version 2.0.0 is a breaking change from prior API.
- Medium install friction: compiled wheels provided for Python 3.10–3.14 across macOS and Linux architectures.
- Repository is archived and marked abandoned as of the latest commit, signaling no active maintenance despite recent release activity.
License · maintenance · safety
permissive license (permissive) — Licensed under MIT (permissive), imposing no restrictions on commercial or proprietary use.
last release 2026-06-18 (57 days) · last repo commit 2026-07-10 · 6 stars · archived
0 known vulnerabilities (OSV.dev, 2026-08-14) · 281,482 downloads/mo, #8,095 on PyPI
Alternatives
Verify before relying
pip install bittensor-drand
from bittensor_drand import get_encrypted_commit_v2
commit_bytes, reveal_round = get_encrypted_commit_v2(
uids=[1, 3],
weights=[100, 200],
version_key=843000,
last_epoch_block=schedule.last_epoch_block,
pending_epoch_at=schedule.pending_epoch_at,
subnet_epoch_index=schedule.subnet_epoch_index,
tempo=schedule.tempo,
blocks_since_last_step=schedule.blocks_since_last_step,
current_block=current_block,
subnet_reveal_period_epochs=reveal_period,
block_time=12.0,
hotkey=wallet.hotkey.public_key,
)- Whether the archived repository status reflects planned sunsetting or temporary maintenance pause.
- Current stability and bug-fix responsiveness given abandoned maintenance status.
- Real-world performance characteristics for large-scale weight commitments.
What it is and what it does
bittensor-drand is a Rust-backed Python library that encrypts weight commitments for Bittensor's commit-reveal mechanism using drand (distributed randomness) as a timelock. Version 2.0 replaces the prior modulo-based epoch math with a stateful epoch counter model, requiring epoch schedule state from the chain rather than manual tempo and block calculations. The library also provides general-purpose timelock encryption for arbitrary binary data and post-quantum ML-KEM-768 key encapsulation.
The package is designed for two use patterns: high-level integration via the Bittensor SDK (which handles epoch plumbing internally), or direct lower-level calls for custom clients and tooling. It includes functions to encrypt data for a specified number of blocks into the future, encrypt for a specific drand round, and decrypt with either auto-fetched or pre-supplied drand signatures. The Rust core ensures performance-critical encryption and decryption operations run efficiently.
Use it for
- Encrypt validator weights in Bittensor subnets using commit-reveal to prevent gaming before the reveal epoch.
- Build custom miners or tooling that need direct control over weight commitment encryption without SDK overhead.
- Timelock-encrypt arbitrary secrets to be revealed after a specified number of blockchain blocks.
- Implement post-quantum key encapsulation for NextKey rotation using ML-KEM-768.
- Batch-decrypt multiple ciphertexts for the same drand round by fetching the signature once.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with caution.
The library is feature-complete and carries no known vulnerabilities, with permissive MIT licensing and broad Python version support (3.10–3.14). However, the repository is archived and marked abandoned, meaning no active maintenance or bug fixes should be expected. Install only if you are committed to maintaining a local fork or can tolerate lack of upstream support. For active Bittensor development, prefer using the high-level SDK integration rather than direct library calls.
Install
bittensor-drand on PyPI
Before you install
Medium install friction: compiled wheels provided for Python 3.10–3.14 across macOS and Linux architectures. Repository is archived and marked abandoned as of the latest commit, signaling no active maintenance despite recent release activity.
Requires bittensor>=11.0.0 to fetch epoch schedule state; version 2.0.0 is a breaking change from prior API.
License in practice
Licensed under MIT (permissive), imposing no restrictions on commercial or proprietary use.
Quickstart
pip install bittensor-drand
from bittensor_drand import get_encrypted_commit_v2
commit_bytes, reveal_round = get_encrypted_commit_v2(
uids=[1, 3],
weights=[100, 200],
version_key=843000,
last_epoch_block=schedule.last_epoch_block,
pending_epoch_at=schedule.pending_epoch_at,
subnet_epoch_index=schedule.subnet_epoch_index,
tempo=schedule.tempo,
blocks_since_last_step=schedule.blocks_since_last_step,
current_block=current_block,
subnet_reveal_period_epochs=reveal_period,
block_time=12.0,
hotkey=wallet.hotkey.public_key,
)
Verify before relying
- Whether the archived repository status reflects planned sunsetting or temporary maintenance pause.
- Current stability and bug-fix responsiveness given abandoned maintenance status.
- Real-world performance characteristics for large-scale weight commitments.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Abandoned 57 days since the last release |
| Last repo commit | repository archived |
| First released | |
| Downloads | 281,482 / month, #8,095 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/EngineeringTopic :: Scientific/Engineering :: Artificial IntelligenceTopic :: Scientific/Engineering :: MathematicsTopic :: Software DevelopmentTopic :: Software Development :: Build ToolsTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python Modules |
Evidence: bittensor_drand-2.0.0-cp310-cp310-macosx_10_12_x86_64.whl; bittensor_drand-2.0.0-cp310-cp310-macosx_11_0_arm64.whl; bittensor_drand-2.0.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; bittensor_drand-2.0.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl; bittensor_drand-2.0.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; bittensor_drand-2.0.0-cp311-cp311-macosx_10_12_x86_64.whl; bittensor_drand-2.0.0-cp311-cp311-macosx_11_0_arm64.whl; bittensor_drand-2.0.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; bittensor_drand-2.0.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl; bittensor_drand-2.0.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; bittensor_drand-2.0.0-cp312-cp312-macosx_10_12_x86_64.whl; bittensor_drand-2.0.0-cp312-cp312-macosx_11_0_arm64.whl; bittensor_drand-2.0.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; bittensor_drand-2.0.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl; bittensor_drand-2.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; bittensor_drand-2.0.0-cp313-cp313-macosx_10_12_x86_64.whl; bittensor_drand-2.0.0-cp313-cp313-macosx_11_0_arm64.whl; bittensor_drand-2.0.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; bittensor_drand-2.0.0-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl; bittensor_drand-2.0.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “timelock encryption drand”
- bittensor-drandProvides timelock encryption for Bittensor commit-reveal weight…
- pyragepyrage provides Python bindings to the Rust implementation of age,…
- eciespyEncrypts and decrypts data using Elliptic Curve Integrated Encryption…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also bittensor · bittensor-wallet · bittensor-cli · pyrage · chia-rs · py-sr25519-bindings · py-ed25519-zebra-bindings · smoldot-light · tenseal · twofish