bittensor.core.extrinsics.async_root

bittensor.core.extrinsics.async_root#

Functions#

get_limits(subtensor)

Retrieves the minimum allowed weights and maximum weight limit for the given subnet.

root_register_extrinsic(subtensor, wallet, netuid[, ...])

Registers the wallet to root network.

set_root_weights_extrinsic(subtensor, wallet, netuids, ...)

Sets the given weights and values on chain for wallet hotkey account.

Module Contents#

async bittensor.core.extrinsics.async_root.get_limits(subtensor)#

Retrieves the minimum allowed weights and maximum weight limit for the given subnet.

These values are fetched asynchronously using asyncio.gather to run both requests concurrently.

Parameters:

subtensor (AsyncSubtensor) – The AsyncSubtensor object used to interface with the network’s substrate node.

Returns:

A tuple containing:

  • min_allowed_weights (int): The minimum allowed weights.

  • max_weight_limit (float): The maximum weight limit, normalized to a float value.

Return type:

tuple[int, float]

async bittensor.core.extrinsics.async_root.root_register_extrinsic(subtensor, wallet, netuid, wait_for_inclusion=True, wait_for_finalization=True)#

Registers the wallet to root network.

Parameters:

  • subtensor (bittensor.core.async_subtensor.AsyncSubtensor) – The AsyncSubtensor object

  • wallet (bittensor_wallet.Wallet) – Bittensor wallet object.

  • netuid (int) – Subnet uid.

  • wait_for_inclusion (bool) – If set, waits for the extrinsic to enter a block before returning True, or returns False if the extrinsic fails to enter the block within the timeout.

  • wait_for_finalization (bool) – If set, waits for the extrinsic to be finalized on the chain before returning True, or returns False if the extrinsic fails to be finalized within the timeout.

Returns:

True if extrinsic was finalized or included in the block. If we did not wait for finalization/inclusion, the response is True.

Return type:

bool

async bittensor.core.extrinsics.async_root.set_root_weights_extrinsic(subtensor, wallet, netuids, weights, version_key=0, wait_for_inclusion=False, wait_for_finalization=False)#

Sets the given weights and values on chain for wallet hotkey account.

Parameters:

  • subtensor (bittensor.core.async_subtensor.AsyncSubtensor) – The AsyncSubtensor object

  • wallet (bittensor_wallet.Wallet) – Bittensor wallet object.

  • netuids (Union[NDArray[np.int64], list[int]]) – The netuid of the subnet to set weights for.

  • weights (Union[NDArray[np.float32], list[float]]) – Weights to set. These must be float s and must correspond to the passed netuid s.

  • version_key (int) – The version key of the validator.

  • wait_for_inclusion (bool) – If set, waits for the extrinsic to enter a block before returning True, or returns False if the extrinsic fails to enter the block within the timeout.

  • wait_for_finalization (bool) – If set, waits for the extrinsic to be finalized on the chain before returning True, or returns False if the extrinsic fails to be finalized within the timeout.

Returns:

True if extrinsic was finalized or included in the block. If we did not wait for finalization/inclusion, the response is True.

Return type:

bool

Contents