stakingV2 precompile | Bittensor EVM

Summary (bittensor.ai, not from the source code)

Current staking interface: dispatches SubtensorModule staking calls from the caller's mapped coldkey (add/remove/move/swap/transfer stake and their limit variants, unstake-all, childkey take, collateral, locks, root claims) and Proxy add/remove; plus reads of stake, delegation, child keys, locks and coldkey-swap state. A few AdminUtils setters apply the calls' own origin checks.

Signature	Selector	Mutability	Runtime
`addCollateral(uint16,bytes32,uint64,uint64)`	Selector `0xf54babed`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32) `alpha` (uint64) `limitPrice` (uint64)
`addProxy(bytes32)`	Selector `0xc10d08eb`	Mutability payable	Since runtime 252
Delegates staking to a proxy account. Parameters `delegate` (bytes32) The public key (32 bytes) of the delegate.
`addStake(bytes32,uint256,uint256)`	Selector `0x1fc9b141`	Mutability payable	Since runtime 252
Adds a subtensor stake `amount` associated with the `hotkey`. This function allows external accounts and contracts to stake TAO into the subtensor pallet, which effectively calls `add_stake` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to stake in rao. `netuid` (uint256) The subnet to stake to (uint256).
`addStakeBurn(bytes32,uint16,uint64,bool,uint64)`	Selector `0x4e06ae4c`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) `amount` (uint64) `hasLimit` (bool) `limit` (uint64)
`addStakeLimit(bytes32,uint256,uint256,bool,uint256)`	Selector `0x5beb6b74`	Mutability payable	Since runtime 283
Adds a subtensor stake `amount` associated with the `hotkey` within a price limit. This function allows external accounts and contracts to stake TAO into the subtensor pallet, which effectively calls `add_stake_limit` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to stake in rao. `limit_price` (uint256) The price limit to stake at in rao. Number of rao per alpha. `allow_partial` (bool) Whether to allow partial stake. `netuid` (uint256) The subnet to stake to (uint256).
`allowance(address,address,uint256)`	Selector `0x598af9e7`	Mutability view	Since runtime 397
Get how much the source allows the spender to use their subnet tokens Parameters `sourceAddress` (address) Address of the source making the allowance. `spenderAddress` (address) Address allowed to spend funds from the source. `netuid` (uint256) The approved subnet token. Returns `return` (uint256)
`approve(address,uint256,uint256)`	Selector `0x426a8493`	Mutability nonpayable	Since runtime 397
Set how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 approve, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback). Parameters `spenderAddress` (address) Address allowed to spend funds from the caller. `netuid` (uint256) The approved subnet token. `absoluteAmount` (uint256) New approval amount, will overwrite previous value.
`burnAlpha(bytes32,uint256,uint256)`	Selector `0x5201f1e6`	Mutability payable	Since runtime 334
Burns alpha tokens from the specified hotkey's stake on a subnet. This function allows external accounts and contracts to permanently burn (destroy) alpha tokens from their stake on a specified hotkey and subnet. The burned tokens are removed from circulation and cannot be recovered. Requirements: - `hotkey` must be a valid hotkey registered on the network. - The caller must have sufficient alpha staked to the specified hotkey on the subnet. - `amount` must be greater than zero and not exceed the staked amount. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount of alpha to burn (uint256). `netuid` (uint256) The subnet to burn from (uint256).
`claimRoot(uint16[])`	Selector `0x4ed9ee58`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `subnets` (uint16[])
`claimRootWithHotkey(bytes32)`	Selector `0xc500a3fa`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32)
`decreaseAllowance(address,uint256,uint256)`	Selector `0xcdde3d6b`	Mutability nonpayable	Since runtime 397
Decrease how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 decreaseAllowance, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback). Parameters `spenderAddress` (address) Address allowed to spend funds from the caller. `netuid` (uint256) The approved subnet token. `decreaseAmount` (uint256) How much the approval amount should be decreased.
`decreaseTake(bytes32,uint16)`	Selector `0xf9e65f8d`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `take` (uint16)
`getAlphaStakedValidators(bytes32,uint256)`	Selector `0x7eef8be3`	Mutability view	Since runtime 261
Returns the validators that have staked alpha under a hotkey. This function retrieves the validators that have staked alpha under a specific hotkey. It is a view function, meaning it does not modify the state of the contract and is free to call. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet the stake is on (uint256). Returns `return` (uint256[]) An array of validators that have staked alpha under the hotkey.
`getAutoStakeDestination(bytes32,uint16)`	Selector `0xbf2f0a1e`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) `netuid` (uint16) Returns `exists` (bool) `hotkey` (bytes32)
`getAutoStakeDestinationColdkeys(bytes32,uint16)`	Selector `0x34ed31da`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `return` (bytes32[])
`getChildKeys(bytes32,uint16)`	Selector `0x05cfaefd`	Mutability view	Since runtime 444
No documentation in the source. Parameters `parent` (bytes32) `netuid` (uint16) Returns `return` (tuple(uint64 proportion, bytes32 account)[])
`getChildkeyTake(bytes32,uint16)`	Selector `0x8cb4cd46`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `return` (uint16)
`getColdkeyCollateral(uint16,bytes32)`	Selector `0x021f6c50`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `coldkey` (bytes32) Returns `locked` (uint64) `hotkeys` (bytes32[])
`getColdkeyLock(bytes32,uint256)`	Selector `0xd2f3e672`	Mutability view	Since runtime 439
Returns a coldkey's lock rolled forward to the current block. `conviction` is exact unsigned Q64.64 bits. Divide it by 2^64 to obtain conviction in alpha rao. `exists` is false once the rolled lock crosses the runtime cleanup threshold, even if its stale storage row remains. Parameters `coldkey` (bytes32) `netuid` (uint256) Returns `lockInfo` (tuple(bool exists, bytes32 hotkey, uint256 locked_mass, uint128 conviction, bool is_perpetual))
`getColdkeyRoot(bytes32)`	Selector `0x64e97c2d`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `exists` (bool) `root` (bytes32)
`getColdkeySuccessor(bytes32)`	Selector `0xd51ef3ea`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `exists` (bool) `successor` (bytes32)
`getColdkeySwapDelays()`	Selector `0x4f327fd0`	Mutability view	Since runtime 444
No documentation in the source. Returns `announcementDelay` (uint64) `reannouncementDelay` (uint64)
`getColdkeySwapStatus(bytes32)`	Selector `0x6a4ef256`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `hasAnnouncement` (bool) `announcementBlock` (uint64) `callHash` (bytes32) `hasDispute` (bool) `disputeBlock` (uint64)
`getCollateralConfig(uint16)`	Selector `0x5741d44e`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) Returns `lockShare` (uint16) `drainRatio` (uint128)
`getDefaultMinStake()`	Selector `0x10fd0907`	Mutability view	Since runtime 438
Returns DefaultMinStake. This is a base value only; operation fees, price conversion, and full-unstake rules can change the accepted amount. Returns `defaultMinStake` (uint256) defaultMinStake The current DefaultMinStake value in rao.
`getDelegate(bytes32)`	Selector `0x590e588a`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) Returns `exists` (bool) `take` (uint16)
`getHotkeyConvictions(uint256,bytes32[])`	Selector `0x82599abe`	Mutability view	Since runtime 439
Returns exact rolled Q64.64 conviction for distinct candidate hotkeys. Results align with `hotkeys`. The list is capped at 64 to keep gas and storage work bounded; larger metagraphs can be queried in batches. Parameters `netuid` (uint256) `hotkeys` (bytes32[]) Returns `convictions` (uint128[])
`getHotkeyLock(bytes32,uint256)`	Selector `0xc66647f0`	Mutability view	Since runtime 439
Returns rolled aggregate lock state targeting a hotkey. Perpetual and decaying buckets are combined. For the subnet owner hotkey, the owner-specific buckets are included as well. `exists` is derived from the rolled aggregate, so fully expired stale buckets do not count. Parameters `hotkey` (bytes32) `netuid` (uint256) Returns `lockInfo` (tuple(bool exists, uint256 locked_mass, uint128 conviction))
`getHotkeyOwner(bytes32)`	Selector `0xad6b780c`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) Returns `exists` (bool) `owner` (bytes32)
`getHotkeyRoot(bytes32,uint16)`	Selector `0xbc9a6413`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `exists` (bool) `root` (bytes32)
`getHotkeySuccessor(bytes32,uint16)`	Selector `0x4c373d9a`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `exists` (bool) `successor` (bytes32)
`getLastHotkeySwapOnSubnet(bytes32,uint16)`	Selector `0x868b7cca`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) `netuid` (uint16) Returns `return` (uint64)
`getLockRates()`	Selector `0xa1a3f610`	Mutability view	Since runtime 439
Returns `(unlockRate, maturityRate)` in blocks. Returns `unlockRate` (uint64) `maturityRate` (uint64)
`getMinChildkeyTakePerSubnet(uint16)`	Selector `0x114abce2`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) Returns `return` (uint16)
`getMinerCollateral(uint16,bytes32,bytes32)`	Selector `0x4d4955f4`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32) `coldkey` (bytes32) Returns `exists` (bool) `locked` (uint64) `drainRatio` (uint128) `minLocked` (uint64) `earned` (uint64)
`getNominatorMinRequiredStake()`	Selector `0x37f26118`	Mutability view	Since runtime 297
Returns the minimum required stake for a nominator. This function retrieves the minimum required stake for a nominator. It is a view function, meaning it does not modify the state of the contract and is free to call. Returns `return` (uint256) The minimum required stake for a nominator.
`getOwnedHotkeys(bytes32)`	Selector `0x12ba4164`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `return` (bytes32[])
`getParentKeys(bytes32,uint16)`	Selector `0x74641cb2`	Mutability view	Since runtime 444
No documentation in the source. Parameters `child` (bytes32) `netuid` (uint16) Returns `return` (tuple(uint64 proportion, bytes32 account)[])
`getPendingChildKeyCooldown()`	Selector `0xdbfc42b7`	Mutability view	Since runtime 444
No documentation in the source. Returns `return` (uint64)
`getPendingChildKeys(bytes32,uint16)`	Selector `0x6221d4bc`	Mutability view	Since runtime 444
No documentation in the source. Parameters `parent` (bytes32) `netuid` (uint16) Returns `children` (tuple(uint64 proportion, bytes32 account)[]) `cooldownBlock` (uint64)
`getRejectLockedAlpha(bytes32)`	Selector `0x572a1934`	Mutability view	Since runtime 439
Returns whether a coldkey rejects incoming locked alpha. Parameters `coldkey` (bytes32) Returns `return` (bool)
`getStake(bytes32,bytes32,uint256)`	Selector `0xe3b598fa`	Mutability view	Since runtime 252
Returns the stake amount associated with the specified `hotkey` and `coldkey`. This function retrieves the current stake amount linked to a specific hotkey and coldkey pair. It is a view function, meaning it does not modify the state of the contract and is free to call. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `coldkey` (bytes32) The coldkey public key (32 bytes). `netuid` (uint256) The subnet the stake is on (uint256). Returns `return` (uint256) The current stake amount in uint256 format.
`getStakeAccounting()`	Selector `0x4e5f188a`	Mutability view	Since runtime 444
No documentation in the source. Returns `totalIssuance` (uint64) `totalStake` (uint64)
`getStakeInfoForColdkeyAndNetuid(bytes32,uint256,bytes32[])`	Selector `0xfff64d31`	Mutability view	Since runtime 438
Returns non-zero alpha stake positions for up to 64 caller-supplied distinct hotkeys. Duplicate hotkeys revert. Callers that need more must split their hotkeys across calls. This function does not read the coldkey's unbounded historical hotkey index. Parameters `coldkey` (bytes32) The coldkey public key (32 bytes). `netuid` (uint256) The subnet to query. `hotkeys` (bytes32[]) The distinct candidate hotkeys to query (maximum 64). Returns `positions` (tuple(bytes32 hotkey, uint256 stake)[]) positions Non-zero hotkey and alpha stake pairs.
`getStakingHotkeys(bytes32,uint64,uint16)`	Selector `0x59415020`	Mutability view	Since runtime 448
Returns at most 64 staking hotkeys beginning at `offset`. Each call reads the existing staking-hotkey vector and slices it in stored order. `total` is the vector length; an offset greater than or equal to `total` returns an empty page. Parameters `coldkey` (bytes32) `offset` (uint64) `limit` (uint16) Returns `hotkeys` (bytes32[]) `total` (uint64)
`getTakeLimits()`	Selector `0x04a7706b`	Mutability view	Since runtime 444
No documentation in the source. Returns `minDelegateTake` (uint16) `maxDelegateTake` (uint16) `minChildkeyTake` (uint16) `maxChildkeyTake` (uint16)
`getTotalAlphaStaked(bytes32,uint256)`	Selector `0x466d0171`	Mutability view	Since runtime 261
Returns the total amount of alpha staked under a hotkey. This function retrieves the total amount of alpha staked under a specific hotkey. It is a view function, meaning it does not modify the state of the contract and is free to call. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet the stake is on (uint256). Returns `return` (uint256) The total amount of alpha staked under the hotkey.
`getTotalColdkeyStake(bytes32)`	Selector `0x998538c4`	Mutability view	Since runtime 252
Returns the amount of RAO staked by the coldkey. This function allows external accounts and contracts to query the amount of RAO staked by the coldkey which effectively calls `get_total_coldkey_stake` on the subtensor pallet with specified coldkey as a parameter. Parameters `coldkey` (bytes32) The coldkey public key (32 bytes). Returns `return` (uint256) The amount of RAO staked by the coldkey.
`getTotalColdkeyStakeOnSubnet(bytes32,uint256)`	Selector `0x2b6589a3`	Mutability view	Since runtime 444
Returns the coldkey's total alpha stake on one subnet. Parameters `coldkey` (bytes32) The coldkey public key (32 bytes). `netuid` (uint256) The subnet containing the stake position (uint256). Returns `return` (uint256) The coldkey's total alpha stake on the subnet.
`getTotalHotkeyStake(bytes32)`	Selector `0x9f246f6f`	Mutability view	Since runtime 252
Returns the total amount of stake under a hotkey (delegative or otherwise) This function allows external accounts and contracts to query the total amount of RAO staked under a hotkey which effectively calls `get_total_hotkey_stake` on the subtensor pallet with specified hotkey as a parameter. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). Returns `return` (uint256) The total amount of RAO staked under the hotkey.
`getUnclaimedRootTaoByHotkey(bytes32,bytes32)`	Selector `0xe9c5c7af`	Mutability view	Since runtime 444
Realizable TAO owed by one validator basket, in 18-decimal EVM units. Parameters `coldkey` (bytes32) `hotkey` (bytes32) Returns `taoValue` (uint256)
`getUnclaimedRootTaoBySubnet(bytes32,uint16,bytes32[])`	Selector `0xafd7f22d`	Mutability view	Since runtime 444
A bounded subtotal for a coldkey's owed value on a subnet. Parameters `coldkey` (bytes32) `netuid` (uint16) `hotkeys` (bytes32[]) Returns `taoValue` (uint256)
`increaseAllowance(address,uint256,uint256)`	Selector `0xff61011a`	Mutability nonpayable	Since runtime 397
Increase how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 increaseAllowance, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback). Parameters `spenderAddress` (address) Address allowed to spend funds from the caller. `netuid` (uint256) The approved subnet token. `increaseAmount` (uint256) How much the approval amount should be increased.
`increaseTake(bytes32,uint16)`	Selector `0xa25424ce`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `take` (uint16)
`lockStake(bytes32,uint256,uint256)`	Selector `0x36f57ac2`	Mutability payable	Since runtime 439
Locks existing alpha stake on a subnet and builds conviction for a hotkey. The lock is a subnet-wide unstaking floor for the caller. It does not move stake and may target a different hotkey from the staked positions. Repeated calls top up the same lock; use `moveLock` to change its target. Parameters `hotkey` (bytes32) Hotkey that receives the conviction. `amount` (uint256) Alpha to add to the lock. `netuid` (uint256) Subnet on which the alpha is locked.
`moveLock(bytes32,uint256)`	Selector `0x496aff66`	Mutability payable	Since runtime 439
Moves the caller's existing subnet lock to another hotkey. Current decayed mass is preserved. Conviction is preserved when the source and destination hotkeys share an owner; otherwise it resets. Parameters `destinationHotkey` (bytes32) `netuid` (uint256)
`moveStake(bytes32,bytes32,uint256,uint256,uint256)`	Selector `0x1149f659`	Mutability payable	Since runtime 261
Moves a subtensor stake `amount` associated with the `hotkey` to a different hotkey `destination_hotkey`. This function allows external accounts and contracts to move staked TAO from one hotkey to another, which effectively calls `move_stake` on the subtensor pallet with specified origin and destination hotkeys as parameters being the hashed address mappings of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `origin_hotkey` (bytes32) The origin hotkey public key (32 bytes). `destination_hotkey` (bytes32) The destination hotkey public key (32 bytes). `origin_netuid` (uint256) The subnet to move stake from (uint256). `destination_netuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.
`moveStakeLimit(bytes32,bytes32,uint16,uint16,uint64,uint64,bool)`	Selector `0x2ef9886e`	Mutability nonpayable	Since runtime 448
Moves alpha between hotkeys and subnets subject to a relative price limit. Parameters `originHotkey` (bytes32) Hotkey from which alpha is removed. `destinationHotkey` (bytes32) Hotkey to which the resulting alpha is credited. `originNetuid` (uint16) Subnet from which alpha is removed. `destinationNetuid` (uint16) Subnet into which TAO is staked. `alphaAmount` (uint64) Origin alpha requested to move, in raw alpha units. `limitPrice` (uint64) Minimum destination-alpha per origin-alpha ratio, scaled by 1e9. `allowPartial` (bool) Whether to execute only the amount available before the limit.
`recycleAlpha(bytes32,uint64,uint16)`	Selector `0x5deefbc0`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `amount` (uint64) `netuid` (uint16)
`removeProxy(bytes32)`	Selector `0x65ed5bb5`	Mutability payable	Since runtime 252
Removes staking proxy account. Parameters `delegate` (bytes32) The public key (32 bytes) of the delegate.
`removeStake(bytes32,uint256,uint256)`	Selector `0x7d691e30`	Mutability payable	Since runtime 252
Removes a subtensor stake `amount` from the specified `hotkey`. This function allows external accounts and contracts to unstake TAO from the subtensor pallet, which effectively calls `remove_stake` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. - The existing stake amount must be not lower than specified amount Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to unstake in alpha. `netuid` (uint256) The subnet to stake to (uint256).
`removeStakeFull(bytes32,uint256)`	Selector `0xd4626bb9`	Mutability payable	Since runtime 283
Removes all stake from a hotkey on a subnet with a price limit. This function allows external accounts and contracts to remove all stake from a specified hotkey on a subnet, with an optional limit price for alpha token at which or better (higher) the staking should execute. Without a limit price, it removes all the stake similar to `removeStake` function. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet to remove stake from (uint256).
`removeStakeFullLimit(bytes32,uint256,uint256)`	Selector `0xa3553cf8`	Mutability payable	Since runtime 283
Removes all stake from a hotkey on a subnet with a price limit. This function allows external accounts and contracts to remove all stake from a specified hotkey on a subnet, with an optional limit price for alpha token at which or better (higher) the staking should execute. Without a limit price, it removes all the stake similar to `removeStake` function. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet to remove stake from (uint256). `limitPrice` (uint256) The limit price for alpha token (uint256).
`removeStakeLimit(bytes32,uint256,uint256,bool,uint256)`	Selector `0x176848b2`	Mutability payable	Since runtime 283
Removes a subtensor stake `amount` from the specified `hotkey` within a price limit. This function allows external accounts and contracts to unstake TAO from the subtensor pallet, which effectively calls `remove_stake_limit` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. - The existing stake amount must be not lower than specified amount Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to unstake in alpha. `limit_price` (uint256) The price limit to unstake at in rao. Number of rao per alpha. `allow_partial` (bool) Whether to allow partial unstake. `netuid` (uint256) The subnet to stake to (uint256).
`setAutoParentDelegationEnabled(bytes32,bool)`	Selector `0xa7902367`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `enabled` (bool)
`setChildkeyTake(bytes32,uint16,uint16)`	Selector `0x02773e59`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) `take` (uint16)
`setColdkeyAutoStakeHotkey(uint16,bytes32)`	Selector `0xc6b2ced4`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32)
`setCollateralDrainRatio(uint16,uint128)`	Selector `0xe6ddb07a`	Mutability nonpayable	Since runtime 444
Raw U64F64 bits. Parameters `netuid` (uint16) `rawRatio` (uint128)
`setCollateralLockShare(uint16,uint16)`	Selector `0x7a58c507`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `lockShare` (uint16)
`setMinChildkeyTakePerSubnet(uint16,uint16)`	Selector `0xc4403255`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `take` (uint16)
`setMinCollateral(uint16,bytes32,uint64)`	Selector `0x7222b1f4`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32) `minLocked` (uint64)
`setPerpetualLock(uint256,bool)`	Selector `0xd4f12f2c`	Mutability payable	Since runtime 439
Selects perpetual or decaying behavior for the caller's subnet lock. There is no direct unlock operation. Disabling perpetual mode lets the locked mass decay according to the runtime unlock rate. Parameters `netuid` (uint256) `enabled` (bool)
`setRejectLockedAlpha(bool)`	Selector `0xfdd609c2`	Mutability payable	Since runtime 439
Sets whether the caller rejects incoming alpha that carries a lock. Rejection is enabled by default. Pass false to opt into receiving locked alpha through compatible stake transfers or coldkey swaps. Parameters `enabled` (bool)
`setRootClaimThreshold(uint16,uint64)`	Selector `0xde395254`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `threshold` (uint64)
`swapStake(bytes32,uint16,uint16,uint64)`	Selector `0xadfa10fe`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `originNetuid` (uint16) `destinationNetuid` (uint16) `alphaAmount` (uint64)
`swapStakeLimit(bytes32,uint16,uint16,uint64,uint64,bool)`	Selector `0x70b3c1bb`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `originNetuid` (uint16) `destinationNetuid` (uint16) `alphaAmount` (uint64) `limitPrice` (uint64) `allowPartial` (bool)
`transferStake(bytes32,bytes32,uint256,uint256,uint256)`	Selector `0x17ce5f62`	Mutability payable	Since runtime 261
Transfer a subtensor stake `amount` associated with the transaction signer to a different coldkey `destination_coldkey`. This function allows external accounts and contracts to transfer staked TAO to another coldkey, which effectively calls `transfer_stake` on the subtensor pallet with specified destination coldkey as a parameter being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `destination_coldkey` (bytes32) The destination coldkey public key (32 bytes). `hotkey` (bytes32) The hotkey public key (32 bytes). `origin_netuid` (uint256) The subnet to move stake from (uint256). `destination_netuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.
`transferStakeAndHotkey(bytes32,bytes32,bytes32,uint16,uint16,uint64)`	Selector `0x3ba866b7`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `destinationColdkey` (bytes32) `originHotkey` (bytes32) `destinationHotkey` (bytes32) `originNetuid` (uint16) `destinationNetuid` (uint16) `alphaAmount` (uint64)
`transferStakeFrom(address,address,bytes32,uint256,uint256,uint256)`	Selector `0x5a010c6f`	Mutability nonpayable	Since runtime 401
Transfer a subtensor stake `amount` associated with the `sourceAddress` to a different destination address. The `sourceAddress` must have approved beforehand the transaction signer (spender) to spend at least the `amount` (allowance). The allowance towards that spender will be decreased by this amount. This function allows external accounts and contracts to transfer staked TAO to another EVM address, which effectively calls `transfer_stake` on the subtensor pallet. Both the source and destination EVM addresses are converted to their Substrate ss58 representation using Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `sourceAddress` (address) The source address (20 bytes). `destinationAddress` (address) The destination EVM address (20 bytes). `hotkey` (bytes32) The hotkey public key (32 bytes). `originNetuid` (uint256) The subnet to move stake from (uint256). `destinationNetuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.
`unstakeAll(bytes32)`	Selector `0x8e33a39f`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32)
`unstakeAllAlpha(bytes32)`	Selector `0xa874d59b`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32)
`transferStakeFrom(address,bytes32,bytes32,uint256,uint256,uint256)`Retired	Selector `0x37a0ed00`	Mutability —	Runtime 397 only
Transfer a subtensor stake `amount` associated with the `source_address` to a different coldkey `destination_coldkey`. The `source_address` must have approved beforehand the transaction signer (spender) to spend at least the `amount` (allowance). The allowance towards that spender will be decreased by this amount. This function allows external accounts and contracts to transfer staked TAO to another coldkey, which effectively calls `transfer_stake` on the subtensor pallet with specified destination coldkey as a parameter being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `source_address` (address) The source address (20 bytes). `destination_coldkey` (bytes32) The destination coldkey public key (32 bytes). `hotkey` (bytes32) The hotkey public key (32 bytes). `origin_netuid` (uint256) The subnet to move stake from (uint256). `destination_netuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.

Signature

Selector

Mutability

Runtime

addCollateral(uint16,bytes32,uint64,uint64)

Selector 0xf54babed

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)
alpha (uint64)
limitPrice (uint64)

addProxy(bytes32)

Selector 0xc10d08eb

Mutability payable

Since runtime 252

Delegates staking to a proxy account.

Parameters

delegate (bytes32) The public key (32 bytes) of the delegate.

addStake(bytes32,uint256,uint256)

Selector 0x1fc9b141

Mutability payable

Since runtime 252

Adds a subtensor stake `amount` associated with the `hotkey`. This function allows external accounts and contracts to stake TAO into the subtensor pallet, which effectively calls `add_stake` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to stake in rao.
netuid (uint256) The subnet to stake to (uint256).

addStakeBurn(bytes32,uint16,uint64,bool,uint64)

Selector 0x4e06ae4c

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)
amount (uint64)
hasLimit (bool)
limit (uint64)

addStakeLimit(bytes32,uint256,uint256,bool,uint256)

Selector 0x5beb6b74

Mutability payable

Since runtime 283

Adds a subtensor stake `amount` associated with the `hotkey` within a price limit. This function allows external accounts and contracts to stake TAO into the subtensor pallet, which effectively calls `add_stake_limit` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to stake in rao.
limit_price (uint256) The price limit to stake at in rao. Number of rao per alpha.
allow_partial (bool) Whether to allow partial stake.
netuid (uint256) The subnet to stake to (uint256).

allowance(address,address,uint256)

Selector 0x598af9e7

Mutability view

Since runtime 397

Get how much the source allows the spender to use their subnet tokens

Parameters

sourceAddress (address) Address of the source making the allowance.
spenderAddress (address) Address allowed to spend funds from the source.
netuid (uint256) The approved subnet token.

Returns

return (uint256)

approve(address,uint256,uint256)

Selector 0x426a8493

Mutability nonpayable

Since runtime 397

Set how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 approve, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback).

Parameters

spenderAddress (address) Address allowed to spend funds from the caller.
netuid (uint256) The approved subnet token.
absoluteAmount (uint256) New approval amount, will overwrite previous value.

burnAlpha(bytes32,uint256,uint256)

Selector 0x5201f1e6

Mutability payable

Since runtime 334

Burns alpha tokens from the specified hotkey's stake on a subnet. This function allows external accounts and contracts to permanently burn (destroy) alpha tokens from their stake on a specified hotkey and subnet. The burned tokens are removed from circulation and cannot be recovered. Requirements: - `hotkey` must be a valid hotkey registered on the network. - The caller must have sufficient alpha staked to the specified hotkey on the subnet. - `amount` must be greater than zero and not exceed the staked amount.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount of alpha to burn (uint256).
netuid (uint256) The subnet to burn from (uint256).

claimRoot(uint16[])

Selector 0x4ed9ee58

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

subnets (uint16[])

claimRootWithHotkey(bytes32)

Selector 0xc500a3fa

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

decreaseAllowance(address,uint256,uint256)

Selector 0xcdde3d6b

Mutability nonpayable

Since runtime 397

Decrease how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 decreaseAllowance, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback).

Parameters

spenderAddress (address) Address allowed to spend funds from the caller.
netuid (uint256) The approved subnet token.
decreaseAmount (uint256) How much the approval amount should be decreased.

decreaseTake(bytes32,uint16)

Selector 0xf9e65f8d

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
take (uint16)

getAlphaStakedValidators(bytes32,uint256)

Selector 0x7eef8be3

Mutability view

Since runtime 261

Returns the validators that have staked alpha under a hotkey. This function retrieves the validators that have staked alpha under a specific hotkey. It is a view function, meaning it does not modify the state of the contract and is free to call.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet the stake is on (uint256).

Returns

return (uint256[]) An array of validators that have staked alpha under the hotkey.

getAutoStakeDestination(bytes32,uint16)

Selector 0xbf2f0a1e

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)
netuid (uint16)

Returns

exists (bool)
hotkey (bytes32)

getAutoStakeDestinationColdkeys(bytes32,uint16)

Selector 0x34ed31da

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

return (bytes32[])

getChildKeys(bytes32,uint16)

Selector 0x05cfaefd

Mutability view

Since runtime 444

No documentation in the source.

Parameters

parent (bytes32)
netuid (uint16)

Returns

return (tuple(uint64 proportion, bytes32 account)[])

getChildkeyTake(bytes32,uint16)

Selector 0x8cb4cd46

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

return (uint16)

getColdkeyCollateral(uint16,bytes32)

Selector 0x021f6c50

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
coldkey (bytes32)

Returns

locked (uint64)
hotkeys (bytes32[])

getColdkeyLock(bytes32,uint256)

Selector 0xd2f3e672

Mutability view

Since runtime 439

Returns a coldkey's lock rolled forward to the current block. `conviction` is exact unsigned Q64.64 bits. Divide it by 2^64 to obtain conviction in alpha rao. `exists` is false once the rolled lock crosses the runtime cleanup threshold, even if its stale storage row remains.

Parameters

coldkey (bytes32)
netuid (uint256)

Returns

lockInfo (tuple(bool exists, bytes32 hotkey, uint256 locked_mass, uint128 conviction, bool is_perpetual))

getColdkeyRoot(bytes32)

Selector 0x64e97c2d

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

exists (bool)
root (bytes32)

getColdkeySuccessor(bytes32)

Selector 0xd51ef3ea

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

exists (bool)
successor (bytes32)

getColdkeySwapDelays()

Selector 0x4f327fd0

Mutability view

Since runtime 444

No documentation in the source.

Returns

announcementDelay (uint64)
reannouncementDelay (uint64)

getColdkeySwapStatus(bytes32)

Selector 0x6a4ef256

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

hasAnnouncement (bool)
announcementBlock (uint64)
callHash (bytes32)
hasDispute (bool)
disputeBlock (uint64)

getCollateralConfig(uint16)

Selector 0x5741d44e

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)

Returns

lockShare (uint16)
drainRatio (uint128)

getDefaultMinStake()

Selector 0x10fd0907

Mutability view

Since runtime 438

Returns DefaultMinStake. This is a base value only; operation fees, price conversion, and full-unstake rules can change the accepted amount.

Returns

defaultMinStake (uint256) defaultMinStake The current DefaultMinStake value in rao.

getDelegate(bytes32)

Selector 0x590e588a

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

Returns

exists (bool)
take (uint16)

getHotkeyConvictions(uint256,bytes32[])

Selector 0x82599abe

Mutability view

Since runtime 439

Returns exact rolled Q64.64 conviction for distinct candidate hotkeys. Results align with `hotkeys`. The list is capped at 64 to keep gas and storage work bounded; larger metagraphs can be queried in batches.

Parameters

netuid (uint256)
hotkeys (bytes32[])

Returns

convictions (uint128[])

getHotkeyLock(bytes32,uint256)

Selector 0xc66647f0

Mutability view

Since runtime 439

Returns rolled aggregate lock state targeting a hotkey. Perpetual and decaying buckets are combined. For the subnet owner hotkey, the owner-specific buckets are included as well. `exists` is derived from the rolled aggregate, so fully expired stale buckets do not count.

Parameters

hotkey (bytes32)
netuid (uint256)

Returns

lockInfo (tuple(bool exists, uint256 locked_mass, uint128 conviction))

getHotkeyOwner(bytes32)

Selector 0xad6b780c

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

Returns

exists (bool)
owner (bytes32)

getHotkeyRoot(bytes32,uint16)

Selector 0xbc9a6413

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

exists (bool)
root (bytes32)

getHotkeySuccessor(bytes32,uint16)

Selector 0x4c373d9a

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

exists (bool)
successor (bytes32)

getLastHotkeySwapOnSubnet(bytes32,uint16)

Selector 0x868b7cca

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)
netuid (uint16)

Returns

return (uint64)

getLockRates()

Selector 0xa1a3f610

Mutability view

Since runtime 439

Returns `(unlockRate, maturityRate)` in blocks.

Returns

unlockRate (uint64)
maturityRate (uint64)

getMinChildkeyTakePerSubnet(uint16)

Selector 0x114abce2

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)

Returns

return (uint16)

getMinerCollateral(uint16,bytes32,bytes32)

Selector 0x4d4955f4

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)
coldkey (bytes32)

Returns

exists (bool)
locked (uint64)
drainRatio (uint128)
minLocked (uint64)
earned (uint64)

getNominatorMinRequiredStake()

Selector 0x37f26118

Mutability view

Since runtime 297

Returns the minimum required stake for a nominator. This function retrieves the minimum required stake for a nominator. It is a view function, meaning it does not modify the state of the contract and is free to call.

Returns

return (uint256) The minimum required stake for a nominator.

getOwnedHotkeys(bytes32)

Selector 0x12ba4164

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

return (bytes32[])

getParentKeys(bytes32,uint16)

Selector 0x74641cb2

Mutability view

Since runtime 444

No documentation in the source.

Parameters

child (bytes32)
netuid (uint16)

Returns

return (tuple(uint64 proportion, bytes32 account)[])

getPendingChildKeyCooldown()

Selector 0xdbfc42b7

Mutability view

Since runtime 444

No documentation in the source.

Returns

return (uint64)

getPendingChildKeys(bytes32,uint16)

Selector 0x6221d4bc

Mutability view

Since runtime 444

No documentation in the source.

Parameters

parent (bytes32)
netuid (uint16)

Returns

children (tuple(uint64 proportion, bytes32 account)[])
cooldownBlock (uint64)

getRejectLockedAlpha(bytes32)

Selector 0x572a1934

Mutability view

Since runtime 439

Returns whether a coldkey rejects incoming locked alpha.

Parameters

coldkey (bytes32)

Returns

return (bool)

getStake(bytes32,bytes32,uint256)

Selector 0xe3b598fa

Mutability view

Since runtime 252

Returns the stake amount associated with the specified `hotkey` and `coldkey`. This function retrieves the current stake amount linked to a specific hotkey and coldkey pair. It is a view function, meaning it does not modify the state of the contract and is free to call.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
coldkey (bytes32) The coldkey public key (32 bytes).
netuid (uint256) The subnet the stake is on (uint256).

Returns

return (uint256) The current stake amount in uint256 format.

getStakeAccounting()

Selector 0x4e5f188a

Mutability view

Since runtime 444

No documentation in the source.

Returns

totalIssuance (uint64)
totalStake (uint64)

getStakeInfoForColdkeyAndNetuid(bytes32,uint256,bytes32[])

Selector 0xfff64d31

Mutability view

Since runtime 438

Returns non-zero alpha stake positions for up to 64 caller-supplied distinct hotkeys. Duplicate hotkeys revert. Callers that need more must split their hotkeys across calls. This function does not read the coldkey's unbounded historical hotkey index.

Parameters

coldkey (bytes32) The coldkey public key (32 bytes).
netuid (uint256) The subnet to query.
hotkeys (bytes32[]) The distinct candidate hotkeys to query (maximum 64).

Returns

positions (tuple(bytes32 hotkey, uint256 stake)[]) positions Non-zero hotkey and alpha stake pairs.

getStakingHotkeys(bytes32,uint64,uint16)

Selector 0x59415020

Mutability view

Since runtime 448

Returns at most 64 staking hotkeys beginning at `offset`. Each call reads the existing staking-hotkey vector and slices it in stored order. `total` is the vector length; an offset greater than or equal to `total` returns an empty page.

Parameters

coldkey (bytes32)
offset (uint64)
limit (uint16)

Returns

hotkeys (bytes32[])
total (uint64)

getTakeLimits()

Selector 0x04a7706b

Mutability view

Since runtime 444

No documentation in the source.

Returns

minDelegateTake (uint16)
maxDelegateTake (uint16)
minChildkeyTake (uint16)
maxChildkeyTake (uint16)

getTotalAlphaStaked(bytes32,uint256)

Selector 0x466d0171

Mutability view

Since runtime 261

Returns the total amount of alpha staked under a hotkey. This function retrieves the total amount of alpha staked under a specific hotkey. It is a view function, meaning it does not modify the state of the contract and is free to call.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet the stake is on (uint256).

Returns

return (uint256) The total amount of alpha staked under the hotkey.

getTotalColdkeyStake(bytes32)

Selector 0x998538c4

Mutability view

Since runtime 252

Returns the amount of RAO staked by the coldkey. This function allows external accounts and contracts to query the amount of RAO staked by the coldkey which effectively calls `get_total_coldkey_stake` on the subtensor pallet with specified coldkey as a parameter.

Parameters

coldkey (bytes32) The coldkey public key (32 bytes).

Returns

return (uint256) The amount of RAO staked by the coldkey.

getTotalColdkeyStakeOnSubnet(bytes32,uint256)

Selector 0x2b6589a3

Mutability view

Since runtime 444

Returns the coldkey's total alpha stake on one subnet.

Parameters

coldkey (bytes32) The coldkey public key (32 bytes).
netuid (uint256) The subnet containing the stake position (uint256).

Returns

return (uint256) The coldkey's total alpha stake on the subnet.

getTotalHotkeyStake(bytes32)

Selector 0x9f246f6f

Mutability view

Since runtime 252

Returns the total amount of stake under a hotkey (delegative or otherwise) This function allows external accounts and contracts to query the total amount of RAO staked under a hotkey which effectively calls `get_total_hotkey_stake` on the subtensor pallet with specified hotkey as a parameter.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).

Returns

return (uint256) The total amount of RAO staked under the hotkey.

getUnclaimedRootTaoByHotkey(bytes32,bytes32)

Selector 0xe9c5c7af

Mutability view

Since runtime 444

Realizable TAO owed by one validator basket, in 18-decimal EVM units.

Parameters

coldkey (bytes32)
hotkey (bytes32)

Returns

taoValue (uint256)

getUnclaimedRootTaoBySubnet(bytes32,uint16,bytes32[])

Selector 0xafd7f22d

Mutability view

Since runtime 444

A bounded subtotal for a coldkey's owed value on a subnet.

Parameters

coldkey (bytes32)
netuid (uint16)
hotkeys (bytes32[])

Returns

taoValue (uint256)

increaseAllowance(address,uint256,uint256)

Selector 0xff61011a

Mutability nonpayable

Since runtime 397

Increase how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 increaseAllowance, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback).

Parameters

spenderAddress (address) Address allowed to spend funds from the caller.
netuid (uint256) The approved subnet token.
increaseAmount (uint256) How much the approval amount should be increased.

increaseTake(bytes32,uint16)

Selector 0xa25424ce

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
take (uint16)

lockStake(bytes32,uint256,uint256)

Selector 0x36f57ac2

Mutability payable

Since runtime 439

Locks existing alpha stake on a subnet and builds conviction for a hotkey. The lock is a subnet-wide unstaking floor for the caller. It does not move stake and may target a different hotkey from the staked positions. Repeated calls top up the same lock; use `moveLock` to change its target.

Parameters

hotkey (bytes32) Hotkey that receives the conviction.
amount (uint256) Alpha to add to the lock.
netuid (uint256) Subnet on which the alpha is locked.

moveLock(bytes32,uint256)

Selector 0x496aff66

Mutability payable

Since runtime 439

Moves the caller's existing subnet lock to another hotkey. Current decayed mass is preserved. Conviction is preserved when the source and destination hotkeys share an owner; otherwise it resets.

Parameters

destinationHotkey (bytes32)
netuid (uint256)

moveStake(bytes32,bytes32,uint256,uint256,uint256)

Selector 0x1149f659

Mutability payable

Since runtime 261

Moves a subtensor stake `amount` associated with the `hotkey` to a different hotkey `destination_hotkey`. This function allows external accounts and contracts to move staked TAO from one hotkey to another, which effectively calls `move_stake` on the subtensor pallet with specified origin and destination hotkeys as parameters being the hashed address mappings of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed.

Parameters

origin_hotkey (bytes32) The origin hotkey public key (32 bytes).
destination_hotkey (bytes32) The destination hotkey public key (32 bytes).
origin_netuid (uint256) The subnet to move stake from (uint256).
destination_netuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

moveStakeLimit(bytes32,bytes32,uint16,uint16,uint64,uint64,bool)

Selector 0x2ef9886e

Mutability nonpayable

Since runtime 448

Moves alpha between hotkeys and subnets subject to a relative price limit.

Parameters

originHotkey (bytes32) Hotkey from which alpha is removed.
destinationHotkey (bytes32) Hotkey to which the resulting alpha is credited.
originNetuid (uint16) Subnet from which alpha is removed.
destinationNetuid (uint16) Subnet into which TAO is staked.
alphaAmount (uint64) Origin alpha requested to move, in raw alpha units.
limitPrice (uint64) Minimum destination-alpha per origin-alpha ratio, scaled by 1e9.
allowPartial (bool) Whether to execute only the amount available before the limit.

recycleAlpha(bytes32,uint64,uint16)

Selector 0x5deefbc0

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
amount (uint64)
netuid (uint16)

removeProxy(bytes32)

Selector 0x65ed5bb5

Mutability payable

Since runtime 252

Removes staking proxy account.

Parameters

delegate (bytes32) The public key (32 bytes) of the delegate.

removeStake(bytes32,uint256,uint256)

Selector 0x7d691e30

Mutability payable

Since runtime 252

Removes a subtensor stake `amount` from the specified `hotkey`. This function allows external accounts and contracts to unstake TAO from the subtensor pallet, which effectively calls `remove_stake` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. - The existing stake amount must be not lower than specified amount

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to unstake in alpha.
netuid (uint256) The subnet to stake to (uint256).

removeStakeFull(bytes32,uint256)

Selector 0xd4626bb9

Mutability payable

Since runtime 283

Removes all stake from a hotkey on a subnet with a price limit. This function allows external accounts and contracts to remove all stake from a specified hotkey on a subnet, with an optional limit price for alpha token at which or better (higher) the staking should execute. Without a limit price, it removes all the stake similar to `removeStake` function.

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet to remove stake from (uint256).

removeStakeFullLimit(bytes32,uint256,uint256)

Selector 0xa3553cf8

Mutability payable

Since runtime 283

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet to remove stake from (uint256).
limitPrice (uint256) The limit price for alpha token (uint256).

removeStakeLimit(bytes32,uint256,uint256,bool,uint256)

Selector 0x176848b2

Mutability payable

Since runtime 283

Removes a subtensor stake `amount` from the specified `hotkey` within a price limit. This function allows external accounts and contracts to unstake TAO from the subtensor pallet, which effectively calls `remove_stake_limit` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. - The existing stake amount must be not lower than specified amount

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to unstake in alpha.
limit_price (uint256) The price limit to unstake at in rao. Number of rao per alpha.
allow_partial (bool) Whether to allow partial unstake.
netuid (uint256) The subnet to stake to (uint256).

setAutoParentDelegationEnabled(bytes32,bool)

Selector 0xa7902367

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
enabled (bool)

setChildkeyTake(bytes32,uint16,uint16)

Selector 0x02773e59

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)
take (uint16)

setColdkeyAutoStakeHotkey(uint16,bytes32)

Selector 0xc6b2ced4

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)

setCollateralDrainRatio(uint16,uint128)

Selector 0xe6ddb07a

Mutability nonpayable

Since runtime 444

Raw U64F64 bits.

Parameters

netuid (uint16)
rawRatio (uint128)

setCollateralLockShare(uint16,uint16)

Selector 0x7a58c507

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
lockShare (uint16)

setMinChildkeyTakePerSubnet(uint16,uint16)

Selector 0xc4403255

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
take (uint16)

setMinCollateral(uint16,bytes32,uint64)

Selector 0x7222b1f4

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)
minLocked (uint64)

setPerpetualLock(uint256,bool)

Selector 0xd4f12f2c

Mutability payable

Since runtime 439

Selects perpetual or decaying behavior for the caller's subnet lock. There is no direct unlock operation. Disabling perpetual mode lets the locked mass decay according to the runtime unlock rate.

Parameters

netuid (uint256)
enabled (bool)

setRejectLockedAlpha(bool)

Selector 0xfdd609c2

Mutability payable

Since runtime 439

Sets whether the caller rejects incoming alpha that carries a lock. Rejection is enabled by default. Pass false to opt into receiving locked alpha through compatible stake transfers or coldkey swaps.

Parameters

enabled (bool)

setRootClaimThreshold(uint16,uint64)

Selector 0xde395254

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
threshold (uint64)

swapStake(bytes32,uint16,uint16,uint64)

Selector 0xadfa10fe

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
originNetuid (uint16)
destinationNetuid (uint16)
alphaAmount (uint64)

swapStakeLimit(bytes32,uint16,uint16,uint64,uint64,bool)

Selector 0x70b3c1bb

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
originNetuid (uint16)
destinationNetuid (uint16)
alphaAmount (uint64)
limitPrice (uint64)
allowPartial (bool)

transferStake(bytes32,bytes32,uint256,uint256,uint256)

Selector 0x17ce5f62

Mutability payable

Since runtime 261

Transfer a subtensor stake `amount` associated with the transaction signer to a different coldkey `destination_coldkey`. This function allows external accounts and contracts to transfer staked TAO to another coldkey, which effectively calls `transfer_stake` on the subtensor pallet with specified destination coldkey as a parameter being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed.

Parameters

destination_coldkey (bytes32) The destination coldkey public key (32 bytes).
hotkey (bytes32) The hotkey public key (32 bytes).
origin_netuid (uint256) The subnet to move stake from (uint256).
destination_netuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

transferStakeAndHotkey(bytes32,bytes32,bytes32,uint16,uint16,uint64)

Selector 0x3ba866b7

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

destinationColdkey (bytes32)
originHotkey (bytes32)
destinationHotkey (bytes32)
originNetuid (uint16)
destinationNetuid (uint16)
alphaAmount (uint64)

transferStakeFrom(address,address,bytes32,uint256,uint256,uint256)

Selector 0x5a010c6f

Mutability nonpayable

Since runtime 401

Transfer a subtensor stake `amount` associated with the `sourceAddress` to a different destination address. The `sourceAddress` must have approved beforehand the transaction signer (spender) to spend at least the `amount` (allowance). The allowance towards that spender will be decreased by this amount. This function allows external accounts and contracts to transfer staked TAO to another EVM address, which effectively calls `transfer_stake` on the subtensor pallet. Both the source and destination EVM addresses are converted to their Substrate ss58 representation using Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed.

Parameters

sourceAddress (address) The source address (20 bytes).
destinationAddress (address) The destination EVM address (20 bytes).
hotkey (bytes32) The hotkey public key (32 bytes).
originNetuid (uint256) The subnet to move stake from (uint256).
destinationNetuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

unstakeAll(bytes32)

Selector 0x8e33a39f

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

unstakeAllAlpha(bytes32)

Selector 0xa874d59b

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

transferStakeFrom(address,bytes32,bytes32,uint256,uint256,uint256)Retired

Selector 0x37a0ed00

Mutability —

Runtime 397 only

Transfer a subtensor stake `amount` associated with the `source_address` to a different coldkey `destination_coldkey`. The `source_address` must have approved beforehand the transaction signer (spender) to spend at least the `amount` (allowance). The allowance towards that spender will be decreased by this amount. This function allows external accounts and contracts to transfer staked TAO to another coldkey, which effectively calls `transfer_stake` on the subtensor pallet with specified destination coldkey as a parameter being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed.

Parameters

source_address (address) The source address (20 bytes).
destination_coldkey (bytes32) The destination coldkey public key (32 bytes).
hotkey (bytes32) The hotkey public key (32 bytes).
origin_netuid (uint256) The subnet to move stake from (uint256).
destination_netuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

Summary (bittensor.ai, not from the source code)

Signature	Selector	Mutability	Runtime
`addCollateral(uint16,bytes32,uint64,uint64)`	Selector `0xf54babed`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32) `alpha` (uint64) `limitPrice` (uint64)
`addProxy(bytes32)`	Selector `0xc10d08eb`	Mutability payable	Since runtime 252
Delegates staking to a proxy account. Parameters `delegate` (bytes32) The public key (32 bytes) of the delegate.
`addStake(bytes32,uint256,uint256)`	Selector `0x1fc9b141`	Mutability payable	Since runtime 252
Adds a subtensor stake `amount` associated with the `hotkey`. This function allows external accounts and contracts to stake TAO into the subtensor pallet, which effectively calls `add_stake` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to stake in rao. `netuid` (uint256) The subnet to stake to (uint256).
`addStakeBurn(bytes32,uint16,uint64,bool,uint64)`	Selector `0x4e06ae4c`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) `amount` (uint64) `hasLimit` (bool) `limit` (uint64)
`addStakeLimit(bytes32,uint256,uint256,bool,uint256)`	Selector `0x5beb6b74`	Mutability payable	Since runtime 283
Adds a subtensor stake `amount` associated with the `hotkey` within a price limit. This function allows external accounts and contracts to stake TAO into the subtensor pallet, which effectively calls `add_stake_limit` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to stake in rao. `limit_price` (uint256) The price limit to stake at in rao. Number of rao per alpha. `allow_partial` (bool) Whether to allow partial stake. `netuid` (uint256) The subnet to stake to (uint256).
`allowance(address,address,uint256)`	Selector `0x598af9e7`	Mutability view	Since runtime 397
Get how much the source allows the spender to use their subnet tokens Parameters `sourceAddress` (address) Address of the source making the allowance. `spenderAddress` (address) Address allowed to spend funds from the source. `netuid` (uint256) The approved subnet token. Returns `return` (uint256)
`approve(address,uint256,uint256)`	Selector `0x426a8493`	Mutability nonpayable	Since runtime 397
Set how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 approve, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback). Parameters `spenderAddress` (address) Address allowed to spend funds from the caller. `netuid` (uint256) The approved subnet token. `absoluteAmount` (uint256) New approval amount, will overwrite previous value.
`burnAlpha(bytes32,uint256,uint256)`	Selector `0x5201f1e6`	Mutability payable	Since runtime 334
Burns alpha tokens from the specified hotkey's stake on a subnet. This function allows external accounts and contracts to permanently burn (destroy) alpha tokens from their stake on a specified hotkey and subnet. The burned tokens are removed from circulation and cannot be recovered. Requirements: - `hotkey` must be a valid hotkey registered on the network. - The caller must have sufficient alpha staked to the specified hotkey on the subnet. - `amount` must be greater than zero and not exceed the staked amount. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount of alpha to burn (uint256). `netuid` (uint256) The subnet to burn from (uint256).
`claimRoot(uint16[])`	Selector `0x4ed9ee58`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `subnets` (uint16[])
`claimRootWithHotkey(bytes32)`	Selector `0xc500a3fa`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32)
`decreaseAllowance(address,uint256,uint256)`	Selector `0xcdde3d6b`	Mutability nonpayable	Since runtime 397
Decrease how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 decreaseAllowance, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback). Parameters `spenderAddress` (address) Address allowed to spend funds from the caller. `netuid` (uint256) The approved subnet token. `decreaseAmount` (uint256) How much the approval amount should be decreased.
`decreaseTake(bytes32,uint16)`	Selector `0xf9e65f8d`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `take` (uint16)
`getAlphaStakedValidators(bytes32,uint256)`	Selector `0x7eef8be3`	Mutability view	Since runtime 261
Returns the validators that have staked alpha under a hotkey. This function retrieves the validators that have staked alpha under a specific hotkey. It is a view function, meaning it does not modify the state of the contract and is free to call. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet the stake is on (uint256). Returns `return` (uint256[]) An array of validators that have staked alpha under the hotkey.
`getAutoStakeDestination(bytes32,uint16)`	Selector `0xbf2f0a1e`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) `netuid` (uint16) Returns `exists` (bool) `hotkey` (bytes32)
`getAutoStakeDestinationColdkeys(bytes32,uint16)`	Selector `0x34ed31da`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `return` (bytes32[])
`getChildKeys(bytes32,uint16)`	Selector `0x05cfaefd`	Mutability view	Since runtime 444
No documentation in the source. Parameters `parent` (bytes32) `netuid` (uint16) Returns `return` (tuple(uint64 proportion, bytes32 account)[])
`getChildkeyTake(bytes32,uint16)`	Selector `0x8cb4cd46`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `return` (uint16)
`getColdkeyCollateral(uint16,bytes32)`	Selector `0x021f6c50`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `coldkey` (bytes32) Returns `locked` (uint64) `hotkeys` (bytes32[])
`getColdkeyLock(bytes32,uint256)`	Selector `0xd2f3e672`	Mutability view	Since runtime 439
Returns a coldkey's lock rolled forward to the current block. `conviction` is exact unsigned Q64.64 bits. Divide it by 2^64 to obtain conviction in alpha rao. `exists` is false once the rolled lock crosses the runtime cleanup threshold, even if its stale storage row remains. Parameters `coldkey` (bytes32) `netuid` (uint256) Returns `lockInfo` (tuple(bool exists, bytes32 hotkey, uint256 locked_mass, uint128 conviction, bool is_perpetual))
`getColdkeyRoot(bytes32)`	Selector `0x64e97c2d`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `exists` (bool) `root` (bytes32)
`getColdkeySuccessor(bytes32)`	Selector `0xd51ef3ea`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `exists` (bool) `successor` (bytes32)
`getColdkeySwapDelays()`	Selector `0x4f327fd0`	Mutability view	Since runtime 444
No documentation in the source. Returns `announcementDelay` (uint64) `reannouncementDelay` (uint64)
`getColdkeySwapStatus(bytes32)`	Selector `0x6a4ef256`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `hasAnnouncement` (bool) `announcementBlock` (uint64) `callHash` (bytes32) `hasDispute` (bool) `disputeBlock` (uint64)
`getCollateralConfig(uint16)`	Selector `0x5741d44e`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) Returns `lockShare` (uint16) `drainRatio` (uint128)
`getDefaultMinStake()`	Selector `0x10fd0907`	Mutability view	Since runtime 438
Returns DefaultMinStake. This is a base value only; operation fees, price conversion, and full-unstake rules can change the accepted amount. Returns `defaultMinStake` (uint256) defaultMinStake The current DefaultMinStake value in rao.
`getDelegate(bytes32)`	Selector `0x590e588a`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) Returns `exists` (bool) `take` (uint16)
`getHotkeyConvictions(uint256,bytes32[])`	Selector `0x82599abe`	Mutability view	Since runtime 439
Returns exact rolled Q64.64 conviction for distinct candidate hotkeys. Results align with `hotkeys`. The list is capped at 64 to keep gas and storage work bounded; larger metagraphs can be queried in batches. Parameters `netuid` (uint256) `hotkeys` (bytes32[]) Returns `convictions` (uint128[])
`getHotkeyLock(bytes32,uint256)`	Selector `0xc66647f0`	Mutability view	Since runtime 439
Returns rolled aggregate lock state targeting a hotkey. Perpetual and decaying buckets are combined. For the subnet owner hotkey, the owner-specific buckets are included as well. `exists` is derived from the rolled aggregate, so fully expired stale buckets do not count. Parameters `hotkey` (bytes32) `netuid` (uint256) Returns `lockInfo` (tuple(bool exists, uint256 locked_mass, uint128 conviction))
`getHotkeyOwner(bytes32)`	Selector `0xad6b780c`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) Returns `exists` (bool) `owner` (bytes32)
`getHotkeyRoot(bytes32,uint16)`	Selector `0xbc9a6413`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `exists` (bool) `root` (bytes32)
`getHotkeySuccessor(bytes32,uint16)`	Selector `0x4c373d9a`	Mutability view	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) Returns `exists` (bool) `successor` (bytes32)
`getLastHotkeySwapOnSubnet(bytes32,uint16)`	Selector `0x868b7cca`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) `netuid` (uint16) Returns `return` (uint64)
`getLockRates()`	Selector `0xa1a3f610`	Mutability view	Since runtime 439
Returns `(unlockRate, maturityRate)` in blocks. Returns `unlockRate` (uint64) `maturityRate` (uint64)
`getMinChildkeyTakePerSubnet(uint16)`	Selector `0x114abce2`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) Returns `return` (uint16)
`getMinerCollateral(uint16,bytes32,bytes32)`	Selector `0x4d4955f4`	Mutability view	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32) `coldkey` (bytes32) Returns `exists` (bool) `locked` (uint64) `drainRatio` (uint128) `minLocked` (uint64) `earned` (uint64)
`getNominatorMinRequiredStake()`	Selector `0x37f26118`	Mutability view	Since runtime 297
Returns the minimum required stake for a nominator. This function retrieves the minimum required stake for a nominator. It is a view function, meaning it does not modify the state of the contract and is free to call. Returns `return` (uint256) The minimum required stake for a nominator.
`getOwnedHotkeys(bytes32)`	Selector `0x12ba4164`	Mutability view	Since runtime 444
No documentation in the source. Parameters `coldkey` (bytes32) Returns `return` (bytes32[])
`getParentKeys(bytes32,uint16)`	Selector `0x74641cb2`	Mutability view	Since runtime 444
No documentation in the source. Parameters `child` (bytes32) `netuid` (uint16) Returns `return` (tuple(uint64 proportion, bytes32 account)[])
`getPendingChildKeyCooldown()`	Selector `0xdbfc42b7`	Mutability view	Since runtime 444
No documentation in the source. Returns `return` (uint64)
`getPendingChildKeys(bytes32,uint16)`	Selector `0x6221d4bc`	Mutability view	Since runtime 444
No documentation in the source. Parameters `parent` (bytes32) `netuid` (uint16) Returns `children` (tuple(uint64 proportion, bytes32 account)[]) `cooldownBlock` (uint64)
`getRejectLockedAlpha(bytes32)`	Selector `0x572a1934`	Mutability view	Since runtime 439
Returns whether a coldkey rejects incoming locked alpha. Parameters `coldkey` (bytes32) Returns `return` (bool)
`getStake(bytes32,bytes32,uint256)`	Selector `0xe3b598fa`	Mutability view	Since runtime 252
Returns the stake amount associated with the specified `hotkey` and `coldkey`. This function retrieves the current stake amount linked to a specific hotkey and coldkey pair. It is a view function, meaning it does not modify the state of the contract and is free to call. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `coldkey` (bytes32) The coldkey public key (32 bytes). `netuid` (uint256) The subnet the stake is on (uint256). Returns `return` (uint256) The current stake amount in uint256 format.
`getStakeAccounting()`	Selector `0x4e5f188a`	Mutability view	Since runtime 444
No documentation in the source. Returns `totalIssuance` (uint64) `totalStake` (uint64)
`getStakeInfoForColdkeyAndNetuid(bytes32,uint256,bytes32[])`	Selector `0xfff64d31`	Mutability view	Since runtime 438
Returns non-zero alpha stake positions for up to 64 caller-supplied distinct hotkeys. Duplicate hotkeys revert. Callers that need more must split their hotkeys across calls. This function does not read the coldkey's unbounded historical hotkey index. Parameters `coldkey` (bytes32) The coldkey public key (32 bytes). `netuid` (uint256) The subnet to query. `hotkeys` (bytes32[]) The distinct candidate hotkeys to query (maximum 64). Returns `positions` (tuple(bytes32 hotkey, uint256 stake)[]) positions Non-zero hotkey and alpha stake pairs.
`getStakingHotkeys(bytes32,uint64,uint16)`	Selector `0x59415020`	Mutability view	Since runtime 448
Returns at most 64 staking hotkeys beginning at `offset`. Each call reads the existing staking-hotkey vector and slices it in stored order. `total` is the vector length; an offset greater than or equal to `total` returns an empty page. Parameters `coldkey` (bytes32) `offset` (uint64) `limit` (uint16) Returns `hotkeys` (bytes32[]) `total` (uint64)
`getTakeLimits()`	Selector `0x04a7706b`	Mutability view	Since runtime 444
No documentation in the source. Returns `minDelegateTake` (uint16) `maxDelegateTake` (uint16) `minChildkeyTake` (uint16) `maxChildkeyTake` (uint16)
`getTotalAlphaStaked(bytes32,uint256)`	Selector `0x466d0171`	Mutability view	Since runtime 261
Returns the total amount of alpha staked under a hotkey. This function retrieves the total amount of alpha staked under a specific hotkey. It is a view function, meaning it does not modify the state of the contract and is free to call. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet the stake is on (uint256). Returns `return` (uint256) The total amount of alpha staked under the hotkey.
`getTotalColdkeyStake(bytes32)`	Selector `0x998538c4`	Mutability view	Since runtime 252
Returns the amount of RAO staked by the coldkey. This function allows external accounts and contracts to query the amount of RAO staked by the coldkey which effectively calls `get_total_coldkey_stake` on the subtensor pallet with specified coldkey as a parameter. Parameters `coldkey` (bytes32) The coldkey public key (32 bytes). Returns `return` (uint256) The amount of RAO staked by the coldkey.
`getTotalColdkeyStakeOnSubnet(bytes32,uint256)`	Selector `0x2b6589a3`	Mutability view	Since runtime 444
Returns the coldkey's total alpha stake on one subnet. Parameters `coldkey` (bytes32) The coldkey public key (32 bytes). `netuid` (uint256) The subnet containing the stake position (uint256). Returns `return` (uint256) The coldkey's total alpha stake on the subnet.
`getTotalHotkeyStake(bytes32)`	Selector `0x9f246f6f`	Mutability view	Since runtime 252
Returns the total amount of stake under a hotkey (delegative or otherwise) This function allows external accounts and contracts to query the total amount of RAO staked under a hotkey which effectively calls `get_total_hotkey_stake` on the subtensor pallet with specified hotkey as a parameter. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). Returns `return` (uint256) The total amount of RAO staked under the hotkey.
`getUnclaimedRootTaoByHotkey(bytes32,bytes32)`	Selector `0xe9c5c7af`	Mutability view	Since runtime 444
Realizable TAO owed by one validator basket, in 18-decimal EVM units. Parameters `coldkey` (bytes32) `hotkey` (bytes32) Returns `taoValue` (uint256)
`getUnclaimedRootTaoBySubnet(bytes32,uint16,bytes32[])`	Selector `0xafd7f22d`	Mutability view	Since runtime 444
A bounded subtotal for a coldkey's owed value on a subnet. Parameters `coldkey` (bytes32) `netuid` (uint16) `hotkeys` (bytes32[]) Returns `taoValue` (uint256)
`increaseAllowance(address,uint256,uint256)`	Selector `0xff61011a`	Mutability nonpayable	Since runtime 397
Increase how much the caller approves the spender to use the provided amount of subnet tokens on its behalf in a later call. This is similar to ERC20 increaseAllowance, and then allows smart contract to transfer with permission from other accounts during their execution. They can then act as escrows while knowing from whom the funds comes from, which is not possible if the spender called `transfer` towards the contract (no callback). Parameters `spenderAddress` (address) Address allowed to spend funds from the caller. `netuid` (uint256) The approved subnet token. `increaseAmount` (uint256) How much the approval amount should be increased.
`increaseTake(bytes32,uint16)`	Selector `0xa25424ce`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `take` (uint16)
`lockStake(bytes32,uint256,uint256)`	Selector `0x36f57ac2`	Mutability payable	Since runtime 439
Locks existing alpha stake on a subnet and builds conviction for a hotkey. The lock is a subnet-wide unstaking floor for the caller. It does not move stake and may target a different hotkey from the staked positions. Repeated calls top up the same lock; use `moveLock` to change its target. Parameters `hotkey` (bytes32) Hotkey that receives the conviction. `amount` (uint256) Alpha to add to the lock. `netuid` (uint256) Subnet on which the alpha is locked.
`moveLock(bytes32,uint256)`	Selector `0x496aff66`	Mutability payable	Since runtime 439
Moves the caller's existing subnet lock to another hotkey. Current decayed mass is preserved. Conviction is preserved when the source and destination hotkeys share an owner; otherwise it resets. Parameters `destinationHotkey` (bytes32) `netuid` (uint256)
`moveStake(bytes32,bytes32,uint256,uint256,uint256)`	Selector `0x1149f659`	Mutability payable	Since runtime 261
Moves a subtensor stake `amount` associated with the `hotkey` to a different hotkey `destination_hotkey`. This function allows external accounts and contracts to move staked TAO from one hotkey to another, which effectively calls `move_stake` on the subtensor pallet with specified origin and destination hotkeys as parameters being the hashed address mappings of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `origin_hotkey` (bytes32) The origin hotkey public key (32 bytes). `destination_hotkey` (bytes32) The destination hotkey public key (32 bytes). `origin_netuid` (uint256) The subnet to move stake from (uint256). `destination_netuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.
`moveStakeLimit(bytes32,bytes32,uint16,uint16,uint64,uint64,bool)`	Selector `0x2ef9886e`	Mutability nonpayable	Since runtime 448
Moves alpha between hotkeys and subnets subject to a relative price limit. Parameters `originHotkey` (bytes32) Hotkey from which alpha is removed. `destinationHotkey` (bytes32) Hotkey to which the resulting alpha is credited. `originNetuid` (uint16) Subnet from which alpha is removed. `destinationNetuid` (uint16) Subnet into which TAO is staked. `alphaAmount` (uint64) Origin alpha requested to move, in raw alpha units. `limitPrice` (uint64) Minimum destination-alpha per origin-alpha ratio, scaled by 1e9. `allowPartial` (bool) Whether to execute only the amount available before the limit.
`recycleAlpha(bytes32,uint64,uint16)`	Selector `0x5deefbc0`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `amount` (uint64) `netuid` (uint16)
`removeProxy(bytes32)`	Selector `0x65ed5bb5`	Mutability payable	Since runtime 252
Removes staking proxy account. Parameters `delegate` (bytes32) The public key (32 bytes) of the delegate.
`removeStake(bytes32,uint256,uint256)`	Selector `0x7d691e30`	Mutability payable	Since runtime 252
Removes a subtensor stake `amount` from the specified `hotkey`. This function allows external accounts and contracts to unstake TAO from the subtensor pallet, which effectively calls `remove_stake` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. - The existing stake amount must be not lower than specified amount Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to unstake in alpha. `netuid` (uint256) The subnet to stake to (uint256).
`removeStakeFull(bytes32,uint256)`	Selector `0xd4626bb9`	Mutability payable	Since runtime 283
Removes all stake from a hotkey on a subnet with a price limit. This function allows external accounts and contracts to remove all stake from a specified hotkey on a subnet, with an optional limit price for alpha token at which or better (higher) the staking should execute. Without a limit price, it removes all the stake similar to `removeStake` function. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet to remove stake from (uint256).
`removeStakeFullLimit(bytes32,uint256,uint256)`	Selector `0xa3553cf8`	Mutability payable	Since runtime 283
Removes all stake from a hotkey on a subnet with a price limit. This function allows external accounts and contracts to remove all stake from a specified hotkey on a subnet, with an optional limit price for alpha token at which or better (higher) the staking should execute. Without a limit price, it removes all the stake similar to `removeStake` function. Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `netuid` (uint256) The subnet to remove stake from (uint256). `limitPrice` (uint256) The limit price for alpha token (uint256).
`removeStakeLimit(bytes32,uint256,uint256,bool,uint256)`	Selector `0x176848b2`	Mutability payable	Since runtime 283
Removes a subtensor stake `amount` from the specified `hotkey` within a price limit. This function allows external accounts and contracts to unstake TAO from the subtensor pallet, which effectively calls `remove_stake_limit` on the subtensor pallet with specified hotkey as a parameter and coldkey being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `hotkey` must be a valid hotkey registered on the network, ensuring that the stake is correctly attributed. - The existing stake amount must be not lower than specified amount Parameters `hotkey` (bytes32) The hotkey public key (32 bytes). `amount` (uint256) The amount to unstake in alpha. `limit_price` (uint256) The price limit to unstake at in rao. Number of rao per alpha. `allow_partial` (bool) Whether to allow partial unstake. `netuid` (uint256) The subnet to stake to (uint256).
`setAutoParentDelegationEnabled(bytes32,bool)`	Selector `0xa7902367`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `enabled` (bool)
`setChildkeyTake(bytes32,uint16,uint16)`	Selector `0x02773e59`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `netuid` (uint16) `take` (uint16)
`setColdkeyAutoStakeHotkey(uint16,bytes32)`	Selector `0xc6b2ced4`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32)
`setCollateralDrainRatio(uint16,uint128)`	Selector `0xe6ddb07a`	Mutability nonpayable	Since runtime 444
Raw U64F64 bits. Parameters `netuid` (uint16) `rawRatio` (uint128)
`setCollateralLockShare(uint16,uint16)`	Selector `0x7a58c507`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `lockShare` (uint16)
`setMinChildkeyTakePerSubnet(uint16,uint16)`	Selector `0xc4403255`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `take` (uint16)
`setMinCollateral(uint16,bytes32,uint64)`	Selector `0x7222b1f4`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `hotkey` (bytes32) `minLocked` (uint64)
`setPerpetualLock(uint256,bool)`	Selector `0xd4f12f2c`	Mutability payable	Since runtime 439
Selects perpetual or decaying behavior for the caller's subnet lock. There is no direct unlock operation. Disabling perpetual mode lets the locked mass decay according to the runtime unlock rate. Parameters `netuid` (uint256) `enabled` (bool)
`setRejectLockedAlpha(bool)`	Selector `0xfdd609c2`	Mutability payable	Since runtime 439
Sets whether the caller rejects incoming alpha that carries a lock. Rejection is enabled by default. Pass false to opt into receiving locked alpha through compatible stake transfers or coldkey swaps. Parameters `enabled` (bool)
`setRootClaimThreshold(uint16,uint64)`	Selector `0xde395254`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `netuid` (uint16) `threshold` (uint64)
`swapStake(bytes32,uint16,uint16,uint64)`	Selector `0xadfa10fe`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `originNetuid` (uint16) `destinationNetuid` (uint16) `alphaAmount` (uint64)
`swapStakeLimit(bytes32,uint16,uint16,uint64,uint64,bool)`	Selector `0x70b3c1bb`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32) `originNetuid` (uint16) `destinationNetuid` (uint16) `alphaAmount` (uint64) `limitPrice` (uint64) `allowPartial` (bool)
`transferStake(bytes32,bytes32,uint256,uint256,uint256)`	Selector `0x17ce5f62`	Mutability payable	Since runtime 261
Transfer a subtensor stake `amount` associated with the transaction signer to a different coldkey `destination_coldkey`. This function allows external accounts and contracts to transfer staked TAO to another coldkey, which effectively calls `transfer_stake` on the subtensor pallet with specified destination coldkey as a parameter being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `destination_coldkey` (bytes32) The destination coldkey public key (32 bytes). `hotkey` (bytes32) The hotkey public key (32 bytes). `origin_netuid` (uint256) The subnet to move stake from (uint256). `destination_netuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.
`transferStakeAndHotkey(bytes32,bytes32,bytes32,uint16,uint16,uint64)`	Selector `0x3ba866b7`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `destinationColdkey` (bytes32) `originHotkey` (bytes32) `destinationHotkey` (bytes32) `originNetuid` (uint16) `destinationNetuid` (uint16) `alphaAmount` (uint64)
`transferStakeFrom(address,address,bytes32,uint256,uint256,uint256)`	Selector `0x5a010c6f`	Mutability nonpayable	Since runtime 401
Transfer a subtensor stake `amount` associated with the `sourceAddress` to a different destination address. The `sourceAddress` must have approved beforehand the transaction signer (spender) to spend at least the `amount` (allowance). The allowance towards that spender will be decreased by this amount. This function allows external accounts and contracts to transfer staked TAO to another EVM address, which effectively calls `transfer_stake` on the subtensor pallet. Both the source and destination EVM addresses are converted to their Substrate ss58 representation using Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `sourceAddress` (address) The source address (20 bytes). `destinationAddress` (address) The destination EVM address (20 bytes). `hotkey` (bytes32) The hotkey public key (32 bytes). `originNetuid` (uint256) The subnet to move stake from (uint256). `destinationNetuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.
`unstakeAll(bytes32)`	Selector `0x8e33a39f`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32)
`unstakeAllAlpha(bytes32)`	Selector `0xa874d59b`	Mutability nonpayable	Since runtime 444
No documentation in the source. Parameters `hotkey` (bytes32)
`transferStakeFrom(address,bytes32,bytes32,uint256,uint256,uint256)`Retired	Selector `0x37a0ed00`	Mutability —	Runtime 397 only
Transfer a subtensor stake `amount` associated with the `source_address` to a different coldkey `destination_coldkey`. The `source_address` must have approved beforehand the transaction signer (spender) to spend at least the `amount` (allowance). The allowance towards that spender will be decreased by this amount. This function allows external accounts and contracts to transfer staked TAO to another coldkey, which effectively calls `transfer_stake` on the subtensor pallet with specified destination coldkey as a parameter being the hashed address mapping of H160 sender address to Substrate ss58 address as implemented in Frontier HashedAddressMapping: https://github.com/polkadot-evm/frontier/blob/2e219e17a526125da003e64ef22ec037917083fa/frame/evm/src/lib.rs#L739 Requirements: - `origin_hotkey` and `destination_hotkey` must be valid hotkeys registered on the network, ensuring that the stake is correctly attributed. Parameters `source_address` (address) The source address (20 bytes). `destination_coldkey` (bytes32) The destination coldkey public key (32 bytes). `hotkey` (bytes32) The hotkey public key (32 bytes). `origin_netuid` (uint256) The subnet to move stake from (uint256). `destination_netuid` (uint256) The subnet to move stake to (uint256). `amount` (uint256) The amount to move in rao.

Signature

Selector

Mutability

Runtime

addCollateral(uint16,bytes32,uint64,uint64)

Selector 0xf54babed

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)
alpha (uint64)
limitPrice (uint64)

addProxy(bytes32)

Selector 0xc10d08eb

Mutability payable

Since runtime 252

Delegates staking to a proxy account.

Parameters

delegate (bytes32) The public key (32 bytes) of the delegate.

addStake(bytes32,uint256,uint256)

Selector 0x1fc9b141

Mutability payable

Since runtime 252

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to stake in rao.
netuid (uint256) The subnet to stake to (uint256).

addStakeBurn(bytes32,uint16,uint64,bool,uint64)

Selector 0x4e06ae4c

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)
amount (uint64)
hasLimit (bool)
limit (uint64)

addStakeLimit(bytes32,uint256,uint256,bool,uint256)

Selector 0x5beb6b74

Mutability payable

Since runtime 283

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to stake in rao.
limit_price (uint256) The price limit to stake at in rao. Number of rao per alpha.
allow_partial (bool) Whether to allow partial stake.
netuid (uint256) The subnet to stake to (uint256).

allowance(address,address,uint256)

Selector 0x598af9e7

Mutability view

Since runtime 397

Get how much the source allows the spender to use their subnet tokens

Parameters

sourceAddress (address) Address of the source making the allowance.
spenderAddress (address) Address allowed to spend funds from the source.
netuid (uint256) The approved subnet token.

Returns

return (uint256)

approve(address,uint256,uint256)

Selector 0x426a8493

Mutability nonpayable

Since runtime 397

Parameters

spenderAddress (address) Address allowed to spend funds from the caller.
netuid (uint256) The approved subnet token.
absoluteAmount (uint256) New approval amount, will overwrite previous value.

burnAlpha(bytes32,uint256,uint256)

Selector 0x5201f1e6

Mutability payable

Since runtime 334

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount of alpha to burn (uint256).
netuid (uint256) The subnet to burn from (uint256).

claimRoot(uint16[])

Selector 0x4ed9ee58

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

subnets (uint16[])

claimRootWithHotkey(bytes32)

Selector 0xc500a3fa

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

decreaseAllowance(address,uint256,uint256)

Selector 0xcdde3d6b

Mutability nonpayable

Since runtime 397

Parameters

spenderAddress (address) Address allowed to spend funds from the caller.
netuid (uint256) The approved subnet token.
decreaseAmount (uint256) How much the approval amount should be decreased.

decreaseTake(bytes32,uint16)

Selector 0xf9e65f8d

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
take (uint16)

getAlphaStakedValidators(bytes32,uint256)

Selector 0x7eef8be3

Mutability view

Since runtime 261

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet the stake is on (uint256).

Returns

return (uint256[]) An array of validators that have staked alpha under the hotkey.

getAutoStakeDestination(bytes32,uint16)

Selector 0xbf2f0a1e

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)
netuid (uint16)

Returns

exists (bool)
hotkey (bytes32)

getAutoStakeDestinationColdkeys(bytes32,uint16)

Selector 0x34ed31da

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

return (bytes32[])

getChildKeys(bytes32,uint16)

Selector 0x05cfaefd

Mutability view

Since runtime 444

No documentation in the source.

Parameters

parent (bytes32)
netuid (uint16)

Returns

return (tuple(uint64 proportion, bytes32 account)[])

getChildkeyTake(bytes32,uint16)

Selector 0x8cb4cd46

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

return (uint16)

getColdkeyCollateral(uint16,bytes32)

Selector 0x021f6c50

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
coldkey (bytes32)

Returns

locked (uint64)
hotkeys (bytes32[])

getColdkeyLock(bytes32,uint256)

Selector 0xd2f3e672

Mutability view

Since runtime 439

Parameters

coldkey (bytes32)
netuid (uint256)

Returns

lockInfo (tuple(bool exists, bytes32 hotkey, uint256 locked_mass, uint128 conviction, bool is_perpetual))

getColdkeyRoot(bytes32)

Selector 0x64e97c2d

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

exists (bool)
root (bytes32)

getColdkeySuccessor(bytes32)

Selector 0xd51ef3ea

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

exists (bool)
successor (bytes32)

getColdkeySwapDelays()

Selector 0x4f327fd0

Mutability view

Since runtime 444

No documentation in the source.

Returns

announcementDelay (uint64)
reannouncementDelay (uint64)

getColdkeySwapStatus(bytes32)

Selector 0x6a4ef256

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

hasAnnouncement (bool)
announcementBlock (uint64)
callHash (bytes32)
hasDispute (bool)
disputeBlock (uint64)

getCollateralConfig(uint16)

Selector 0x5741d44e

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)

Returns

lockShare (uint16)
drainRatio (uint128)

getDefaultMinStake()

Selector 0x10fd0907

Mutability view

Since runtime 438

Returns DefaultMinStake. This is a base value only; operation fees, price conversion, and full-unstake rules can change the accepted amount.

Returns

defaultMinStake (uint256) defaultMinStake The current DefaultMinStake value in rao.

getDelegate(bytes32)

Selector 0x590e588a

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

Returns

exists (bool)
take (uint16)

getHotkeyConvictions(uint256,bytes32[])

Selector 0x82599abe

Mutability view

Since runtime 439

Parameters

netuid (uint256)
hotkeys (bytes32[])

Returns

convictions (uint128[])

getHotkeyLock(bytes32,uint256)

Selector 0xc66647f0

Mutability view

Since runtime 439

Parameters

hotkey (bytes32)
netuid (uint256)

Returns

lockInfo (tuple(bool exists, uint256 locked_mass, uint128 conviction))

getHotkeyOwner(bytes32)

Selector 0xad6b780c

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

Returns

exists (bool)
owner (bytes32)

getHotkeyRoot(bytes32,uint16)

Selector 0xbc9a6413

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

exists (bool)
root (bytes32)

getHotkeySuccessor(bytes32,uint16)

Selector 0x4c373d9a

Mutability view

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)

Returns

exists (bool)
successor (bytes32)

getLastHotkeySwapOnSubnet(bytes32,uint16)

Selector 0x868b7cca

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)
netuid (uint16)

Returns

return (uint64)

getLockRates()

Selector 0xa1a3f610

Mutability view

Since runtime 439

Returns `(unlockRate, maturityRate)` in blocks.

Returns

unlockRate (uint64)
maturityRate (uint64)

getMinChildkeyTakePerSubnet(uint16)

Selector 0x114abce2

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)

Returns

return (uint16)

getMinerCollateral(uint16,bytes32,bytes32)

Selector 0x4d4955f4

Mutability view

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)
coldkey (bytes32)

Returns

exists (bool)
locked (uint64)
drainRatio (uint128)
minLocked (uint64)
earned (uint64)

getNominatorMinRequiredStake()

Selector 0x37f26118

Mutability view

Since runtime 297

Returns

return (uint256) The minimum required stake for a nominator.

getOwnedHotkeys(bytes32)

Selector 0x12ba4164

Mutability view

Since runtime 444

No documentation in the source.

Parameters

coldkey (bytes32)

Returns

return (bytes32[])

getParentKeys(bytes32,uint16)

Selector 0x74641cb2

Mutability view

Since runtime 444

No documentation in the source.

Parameters

child (bytes32)
netuid (uint16)

Returns

return (tuple(uint64 proportion, bytes32 account)[])

getPendingChildKeyCooldown()

Selector 0xdbfc42b7

Mutability view

Since runtime 444

No documentation in the source.

Returns

return (uint64)

getPendingChildKeys(bytes32,uint16)

Selector 0x6221d4bc

Mutability view

Since runtime 444

No documentation in the source.

Parameters

parent (bytes32)
netuid (uint16)

Returns

children (tuple(uint64 proportion, bytes32 account)[])
cooldownBlock (uint64)

getRejectLockedAlpha(bytes32)

Selector 0x572a1934

Mutability view

Since runtime 439

Returns whether a coldkey rejects incoming locked alpha.

Parameters

coldkey (bytes32)

Returns

return (bool)

getStake(bytes32,bytes32,uint256)

Selector 0xe3b598fa

Mutability view

Since runtime 252

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
coldkey (bytes32) The coldkey public key (32 bytes).
netuid (uint256) The subnet the stake is on (uint256).

Returns

return (uint256) The current stake amount in uint256 format.

getStakeAccounting()

Selector 0x4e5f188a

Mutability view

Since runtime 444

No documentation in the source.

Returns

totalIssuance (uint64)
totalStake (uint64)

getStakeInfoForColdkeyAndNetuid(bytes32,uint256,bytes32[])

Selector 0xfff64d31

Mutability view

Since runtime 438

Parameters

coldkey (bytes32) The coldkey public key (32 bytes).
netuid (uint256) The subnet to query.
hotkeys (bytes32[]) The distinct candidate hotkeys to query (maximum 64).

Returns

positions (tuple(bytes32 hotkey, uint256 stake)[]) positions Non-zero hotkey and alpha stake pairs.

getStakingHotkeys(bytes32,uint64,uint16)

Selector 0x59415020

Mutability view

Since runtime 448

Parameters

coldkey (bytes32)
offset (uint64)
limit (uint16)

Returns

hotkeys (bytes32[])
total (uint64)

getTakeLimits()

Selector 0x04a7706b

Mutability view

Since runtime 444

No documentation in the source.

Returns

minDelegateTake (uint16)
maxDelegateTake (uint16)
minChildkeyTake (uint16)
maxChildkeyTake (uint16)

getTotalAlphaStaked(bytes32,uint256)

Selector 0x466d0171

Mutability view

Since runtime 261

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet the stake is on (uint256).

Returns

return (uint256) The total amount of alpha staked under the hotkey.

getTotalColdkeyStake(bytes32)

Selector 0x998538c4

Mutability view

Since runtime 252

Parameters

coldkey (bytes32) The coldkey public key (32 bytes).

Returns

return (uint256) The amount of RAO staked by the coldkey.

getTotalColdkeyStakeOnSubnet(bytes32,uint256)

Selector 0x2b6589a3

Mutability view

Since runtime 444

Returns the coldkey's total alpha stake on one subnet.

Parameters

coldkey (bytes32) The coldkey public key (32 bytes).
netuid (uint256) The subnet containing the stake position (uint256).

Returns

return (uint256) The coldkey's total alpha stake on the subnet.

getTotalHotkeyStake(bytes32)

Selector 0x9f246f6f

Mutability view

Since runtime 252

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).

Returns

return (uint256) The total amount of RAO staked under the hotkey.

getUnclaimedRootTaoByHotkey(bytes32,bytes32)

Selector 0xe9c5c7af

Mutability view

Since runtime 444

Realizable TAO owed by one validator basket, in 18-decimal EVM units.

Parameters

coldkey (bytes32)
hotkey (bytes32)

Returns

taoValue (uint256)

getUnclaimedRootTaoBySubnet(bytes32,uint16,bytes32[])

Selector 0xafd7f22d

Mutability view

Since runtime 444

A bounded subtotal for a coldkey's owed value on a subnet.

Parameters

coldkey (bytes32)
netuid (uint16)
hotkeys (bytes32[])

Returns

taoValue (uint256)

increaseAllowance(address,uint256,uint256)

Selector 0xff61011a

Mutability nonpayable

Since runtime 397

Parameters

spenderAddress (address) Address allowed to spend funds from the caller.
netuid (uint256) The approved subnet token.
increaseAmount (uint256) How much the approval amount should be increased.

increaseTake(bytes32,uint16)

Selector 0xa25424ce

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
take (uint16)

lockStake(bytes32,uint256,uint256)

Selector 0x36f57ac2

Mutability payable

Since runtime 439

Parameters

hotkey (bytes32) Hotkey that receives the conviction.
amount (uint256) Alpha to add to the lock.
netuid (uint256) Subnet on which the alpha is locked.

moveLock(bytes32,uint256)

Selector 0x496aff66

Mutability payable

Since runtime 439

Moves the caller's existing subnet lock to another hotkey. Current decayed mass is preserved. Conviction is preserved when the source and destination hotkeys share an owner; otherwise it resets.

Parameters

destinationHotkey (bytes32)
netuid (uint256)

moveStake(bytes32,bytes32,uint256,uint256,uint256)

Selector 0x1149f659

Mutability payable

Since runtime 261

Parameters

origin_hotkey (bytes32) The origin hotkey public key (32 bytes).
destination_hotkey (bytes32) The destination hotkey public key (32 bytes).
origin_netuid (uint256) The subnet to move stake from (uint256).
destination_netuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

moveStakeLimit(bytes32,bytes32,uint16,uint16,uint64,uint64,bool)

Selector 0x2ef9886e

Mutability nonpayable

Since runtime 448

Moves alpha between hotkeys and subnets subject to a relative price limit.

Parameters

originHotkey (bytes32) Hotkey from which alpha is removed.
destinationHotkey (bytes32) Hotkey to which the resulting alpha is credited.
originNetuid (uint16) Subnet from which alpha is removed.
destinationNetuid (uint16) Subnet into which TAO is staked.
alphaAmount (uint64) Origin alpha requested to move, in raw alpha units.
limitPrice (uint64) Minimum destination-alpha per origin-alpha ratio, scaled by 1e9.
allowPartial (bool) Whether to execute only the amount available before the limit.

recycleAlpha(bytes32,uint64,uint16)

Selector 0x5deefbc0

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
amount (uint64)
netuid (uint16)

removeProxy(bytes32)

Selector 0x65ed5bb5

Mutability payable

Since runtime 252

Removes staking proxy account.

Parameters

delegate (bytes32) The public key (32 bytes) of the delegate.

removeStake(bytes32,uint256,uint256)

Selector 0x7d691e30

Mutability payable

Since runtime 252

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to unstake in alpha.
netuid (uint256) The subnet to stake to (uint256).

removeStakeFull(bytes32,uint256)

Selector 0xd4626bb9

Mutability payable

Since runtime 283

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet to remove stake from (uint256).

removeStakeFullLimit(bytes32,uint256,uint256)

Selector 0xa3553cf8

Mutability payable

Since runtime 283

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
netuid (uint256) The subnet to remove stake from (uint256).
limitPrice (uint256) The limit price for alpha token (uint256).

removeStakeLimit(bytes32,uint256,uint256,bool,uint256)

Selector 0x176848b2

Mutability payable

Since runtime 283

Parameters

hotkey (bytes32) The hotkey public key (32 bytes).
amount (uint256) The amount to unstake in alpha.
limit_price (uint256) The price limit to unstake at in rao. Number of rao per alpha.
allow_partial (bool) Whether to allow partial unstake.
netuid (uint256) The subnet to stake to (uint256).

setAutoParentDelegationEnabled(bytes32,bool)

Selector 0xa7902367

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
enabled (bool)

setChildkeyTake(bytes32,uint16,uint16)

Selector 0x02773e59

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
netuid (uint16)
take (uint16)

setColdkeyAutoStakeHotkey(uint16,bytes32)

Selector 0xc6b2ced4

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)

setCollateralDrainRatio(uint16,uint128)

Selector 0xe6ddb07a

Mutability nonpayable

Since runtime 444

Raw U64F64 bits.

Parameters

netuid (uint16)
rawRatio (uint128)

setCollateralLockShare(uint16,uint16)

Selector 0x7a58c507

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
lockShare (uint16)

setMinChildkeyTakePerSubnet(uint16,uint16)

Selector 0xc4403255

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
take (uint16)

setMinCollateral(uint16,bytes32,uint64)

Selector 0x7222b1f4

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
hotkey (bytes32)
minLocked (uint64)

setPerpetualLock(uint256,bool)

Selector 0xd4f12f2c

Mutability payable

Since runtime 439

Selects perpetual or decaying behavior for the caller's subnet lock. There is no direct unlock operation. Disabling perpetual mode lets the locked mass decay according to the runtime unlock rate.

Parameters

netuid (uint256)
enabled (bool)

setRejectLockedAlpha(bool)

Selector 0xfdd609c2

Mutability payable

Since runtime 439

Sets whether the caller rejects incoming alpha that carries a lock. Rejection is enabled by default. Pass false to opt into receiving locked alpha through compatible stake transfers or coldkey swaps.

Parameters

enabled (bool)

setRootClaimThreshold(uint16,uint64)

Selector 0xde395254

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

netuid (uint16)
threshold (uint64)

swapStake(bytes32,uint16,uint16,uint64)

Selector 0xadfa10fe

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
originNetuid (uint16)
destinationNetuid (uint16)
alphaAmount (uint64)

swapStakeLimit(bytes32,uint16,uint16,uint64,uint64,bool)

Selector 0x70b3c1bb

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)
originNetuid (uint16)
destinationNetuid (uint16)
alphaAmount (uint64)
limitPrice (uint64)
allowPartial (bool)

transferStake(bytes32,bytes32,uint256,uint256,uint256)

Selector 0x17ce5f62

Mutability payable

Since runtime 261

Parameters

destination_coldkey (bytes32) The destination coldkey public key (32 bytes).
hotkey (bytes32) The hotkey public key (32 bytes).
origin_netuid (uint256) The subnet to move stake from (uint256).
destination_netuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

transferStakeAndHotkey(bytes32,bytes32,bytes32,uint16,uint16,uint64)

Selector 0x3ba866b7

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

destinationColdkey (bytes32)
originHotkey (bytes32)
destinationHotkey (bytes32)
originNetuid (uint16)
destinationNetuid (uint16)
alphaAmount (uint64)

transferStakeFrom(address,address,bytes32,uint256,uint256,uint256)

Selector 0x5a010c6f

Mutability nonpayable

Since runtime 401

Parameters

sourceAddress (address) The source address (20 bytes).
destinationAddress (address) The destination EVM address (20 bytes).
hotkey (bytes32) The hotkey public key (32 bytes).
originNetuid (uint256) The subnet to move stake from (uint256).
destinationNetuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

unstakeAll(bytes32)

Selector 0x8e33a39f

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

unstakeAllAlpha(bytes32)

Selector 0xa874d59b

Mutability nonpayable

Since runtime 444

No documentation in the source.

Parameters

hotkey (bytes32)

transferStakeFrom(address,bytes32,bytes32,uint256,uint256,uint256)Retired

Selector 0x37a0ed00

Mutability —

Runtime 397 only

Parameters

source_address (address) The source address (20 bytes).
destination_coldkey (bytes32) The destination coldkey public key (32 bytes).
hotkey (bytes32) The hotkey public key (32 bytes).
origin_netuid (uint256) The subnet to move stake from (uint256).
destination_netuid (uint256) The subnet to move stake to (uint256).
amount (uint256) The amount to move in rao.

stakingV2

Summary (bittensor.ai, not from the source code)

Functions

stakingV2

Summary (bittensor.ai, not from the source code)

Functions