bittensor.core.extrinsics.asyncex.children#

Functions#

`root_set_pending_childkey_cooldown_extrinsic`(...[, ...])	Allows a root coldkey to set children-keys.
`set_children_extrinsic`(subtensor, wallet, hotkey_ss58, ...)	Allows a coldkey to set children-keys.

Module Contents#

async bittensor.core.extrinsics.asyncex.children.root_set_pending_childkey_cooldown_extrinsic(subtensor, wallet, cooldown, period=None, raise_error=False, wait_for_inclusion=True, wait_for_finalization=True)[source]#

Allows a root coldkey to set children-keys.

Parameters:

subtensor (bittensor.core.async_subtensor.AsyncSubtensor) – The Subtensor client instance used for blockchain interaction.
wallet (bittensor_wallet.Wallet) – The wallet used to sign the extrinsic (must be unlocked).
cooldown (int) – The cooldown period in blocks.
period (Optional[int]) – The number of blocks during which the transaction will remain valid after it’s submitted. If the transaction is not included in a block within that number of blocks, it will expire and be rejected. You can think of it as an expiration date for the transaction.
raise_error (bool) – Raises a relevant exception rather than returning False if unsuccessful.
wait_for_inclusion (bool) – Waits for the transaction to be included in a block.
wait_for_finalization (bool) – Waits for the transaction to be finalized on the blockchain.

Returns:

The result object of the extrinsic execution.

Return type:

ExtrinsicResponse

async bittensor.core.extrinsics.asyncex.children.set_children_extrinsic(subtensor, wallet, hotkey_ss58, netuid, children, period=None, raise_error=False, wait_for_inclusion=True, wait_for_finalization=True)[source]#

Allows a coldkey to set children-keys.

Parameters:

subtensor (bittensor.core.async_subtensor.AsyncSubtensor) – The Subtensor client instance used for blockchain interaction.
wallet (bittensor_wallet.Wallet) – bittensor wallet instance.
hotkey_ss58 (str) – The SS58 address of the neuron’s hotkey.
netuid (int) – The netuid value.
children (list[tuple[float, str]]) – A list of children with their proportions.
period (Optional[int]) – The number of blocks during which the transaction will remain valid after it’s submitted. If the transaction is not included in a block within that number of blocks, it will expire and be rejected. You can think of it as an expiration date for the transaction.
raise_error (bool) – Raises a relevant exception rather than returning False if unsuccessful.
wait_for_inclusion (bool) – Waits for the transaction to be included in a block.
wait_for_finalization (bool) – Waits for the transaction to be finalized on the blockchain.

Returns:

The result object of the extrinsic execution.

Return type:

ExtrinsicResponse

Raises:

DuplicateChild – There are duplicates in the list of children.
InvalidChild – Child is the hotkey.
NonAssociatedColdKey – The coldkey does not own the hotkey or the child is the same as the hotkey.
NotEnoughStakeToSetChildkeys – Parent key doesn’t have minimum own stake.
ProportionOverflow – The sum of the proportions does exceed uint64.
RegistrationNotPermittedOnRootSubnet – Attempting to register a child on the root network.
SubnetNotExists – Attempting to register to a non-existent network.
TooManyChildren – Too many children in request.
TxRateLimitExceeded – Hotkey hit the rate limit.
bittensor_wallet.errors.KeyFileError – Failed to decode keyfile data.
bittensor_wallet.errors.PasswordError – Decryption failed or wrong password for decryption provided.