bittensor.extrinsics.staking#

Module Contents#

Functions#

add_stake_extrinsic(subtensor, wallet[, hotkey_ss58, ...])

Adds the specified amount of stake to passed hotkey uid.

add_stake_multiple_extrinsic(subtensor, wallet, ...[, ...])

Adds stake to each hotkey_ss58 in the list, using each amount, from a common coldkey.

__do_add_stake_single(subtensor, wallet, hotkey_ss58, ...)

Executes a stake call to the chain using the wallet and amount specified.
bittensor.extrinsics.staking.add_stake_extrinsic(subtensor, wallet, hotkey_ss58=None, amount=None, wait_for_inclusion=True, wait_for_finalization=False, prompt=False)#

Adds the specified amount of stake to passed hotkey uid. :param wallet: Bittensor wallet object. :type wallet: bittensor.wallet :param hotkey_ss58: ss58 address of the hotkey account to stake to

defaults to the wallet’s hotkey.

Parameters:

  • amount (Union[Balance, float]) – Amount to stake as bittensor balance, or float interpreted as Tao.

  • 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.

  • prompt (bool) – If true, the call waits for confirmation from the user before proceeding.

  • subtensor (bittensor.subtensor) –

  • wallet (bittensor.wallet) –

  • hotkey_ss58 (Optional[str]) –

Returns:

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

Return type:

success (bool)

Raises:
bittensor.extrinsics.staking.add_stake_multiple_extrinsic(subtensor, wallet, hotkey_ss58s, amounts=None, wait_for_inclusion=True, wait_for_finalization=False, prompt=False)#

Adds stake to each hotkey_ss58 in the list, using each amount, from a common coldkey. :param wallet: Bittensor wallet object for the coldkey. :type wallet: bittensor.wallet :param hotkey_ss58s: List of hotkeys to stake to. :type hotkey_ss58s: List[str] :param amounts: List of amounts to stake. If None, stake all to the first hotkey. :type amounts: List[Union[Balance, float]] :param wait_for_inclusion: 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.

Parameters:

  • 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.

  • prompt (bool) – If true, the call waits for confirmation from the user before proceeding.

  • subtensor (bittensor.subtensor) –

  • wallet (bittensor.wallet) –

  • hotkey_ss58s (List[str]) –

  • amounts (List[Union[bittensor.utils.balance.Balance, float]]) –

  • wait_for_inclusion (bool) –

Returns:

flag is true if extrinsic was finalized or included in the block. flag is true if any wallet was staked. If we did not wait for finalization / inclusion, the response is true.

Return type:

success (bool)

bittensor.extrinsics.staking.__do_add_stake_single(subtensor, wallet, hotkey_ss58, amount, wait_for_inclusion=True, wait_for_finalization=False)#

Executes a stake call to the chain using the wallet and amount specified. :param wallet: Bittensor wallet object. :type wallet: bittensor.wallet :param hotkey_ss58: Hotkey to stake to. :type hotkey_ss58: str :param amount: Amount to stake as bittensor balance object. :type amount: bittensor.Balance :param wait_for_inclusion: 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.

Parameters:

  • 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.

  • prompt (bool) – If true, the call waits for confirmation from the user before proceeding.

  • subtensor (bittensor.subtensor) –

  • wallet (bittensor.wallet) –

  • hotkey_ss58 (str) –

  • amount (bittensor.Balance) –

  • wait_for_inclusion (bool) –

Returns:

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

Return type:

success (bool)

Raises: