Transactions

Transactions

Every state-changing operation: one page per intent, generated from the SDK.

View as Markdown

Every mutation is an intent: preview it with plan / --dry-run, submit it with execute. Each CLI command below is btcli tx <name>; each Python class is bt.<ClassName>. The machine-readable catalog of all of these (with JSON schemas) is at /catalog/intents.json or via btcli tools / bt.intents.list_tools().

AdminUtils

OperationSignerOriginSummary
set-hyperparametercoldkeysubnet ownerSet an owner-settable subnet hyperparameter (btcli sudo set).
set-mechanism-countcoldkeysubnet ownerSet the number of mechanisms on a subnet.
set-subnet-emission-enabledcoldkeyroot (chain sudo)Enable or disable a subnet's pool-side TAO emission (root only).
trim-subnetcoldkeysubnet ownerTrim a subnet to at most max_n UIDs (subnet owner).

Balances

OperationSignerOriginSummary
fund-evm-keycoldkeysigned account (pallet role may apply)Fund an EVM (h160) address with TAO from the signing coldkey.
transfercoldkeysigned account (pallet role may apply)Transfer TAO from the coldkey to a destination address.
transfer-allcoldkeysigned account (pallet role may apply)Transfer the entire transferable balance to a destination address.

Crowdloan

OperationSignerOriginSummary
contribute-crowdloancoldkeysigned account (pallet role may apply)Contribute TAO to an active crowdloan.
create-crowdloancoldkeysigned account (pallet role may apply)Open a crowdloan raising up to cap_tao by end block.
dissolve-crowdloancoldkeysigned account (pallet role may apply)Dissolve a fully-refunded crowdloan (creator only).
finalize-crowdloancoldkeysigned account (pallet role may apply)Finalize a crowdloan that reached its cap (creator only).
refund-crowdloancoldkeysigned account (pallet role may apply)Refund contributors of a non-finalized crowdloan (creator only).
set-crowdloan-max-contributioncoldkeysigned account (pallet role may apply)Set or clear the per-contributor max for a non-finalized crowdloan (creator only).
update-crowdloan-capcoldkeysigned account (pallet role may apply)Update the cap of a non-finalized crowdloan (creator only).
update-crowdloan-endcoldkeysigned account (pallet role may apply)Update the end block of a non-finalized crowdloan (creator only).
update-crowdloan-min-contributioncoldkeysigned account (pallet role may apply)Update the minimum contribution of a non-finalized crowdloan (creator only).
withdraw-crowdloancoldkeysigned account (pallet role may apply)Withdraw the signer's contribution from a non-finalized crowdloan.

EVM

OperationSignerOriginSummary
evm-withdrawcoldkeysigned account (pallet role may apply)Claim TAO deposited to the coldkey's truncated EVM mirror.

Multisig

OperationSignerOriginSummary
multisig-approvecoldkeysigned account (pallet role may apply)Register approval for a multisig call (non-final approvals).
multisig-cancelcoldkeysigned account (pallet role may apply)Cancel an ongoing multisig operation (only the original depositor may).
multisig-executecoldkeysigned account (pallet role may apply)Approve and, if the threshold is met, execute a multisig call (final approval).
multisig-threshold-1coldkeysigned account (pallet role may apply)Dispatch a 1-of-N multisig call immediately (single approval).

Proxy

OperationSignerOriginSummary
add-proxycoldkeysigned account (pallet role may apply)Authorize a delegate key to sign calls on this account's behalf.
create-pure-proxycoldkeysigned account (pallet role may apply)Create a pure proxy: a fresh keyless account controlled via delegation.
execute-proxy-announcedcoldkeysigned account (pallet role may apply)Execute a proxy call that was announced and has passed its delay.
kill-pure-proxycoldkeysigned account (pallet role may apply)Close a pure proxy account and return its reserved deposit.
remove-proxiescoldkeysigned account (pallet role may apply)Revoke every proxy delegation for the signing account at once.
remove-proxycoldkeysigned account (pallet role may apply)Revoke one proxy delegation.

SubtensorModule

OperationSignerOriginSummary
add-collateralcoldkeysigned account (pallet role may apply)Lock additional miner collateral on your own hotkey.
add-stakecoldkeysigned account (pallet role may apply)Stake TAO from the coldkey onto a hotkey.
add-stake-limitcoldkeysigned account (pallet role may apply)Stake TAO with a limit price (slippage protection).
announce-coldkey-swapcoldkeysigned account (pallet role may apply)Announce (commit to) a coldkey swap; executable after the chain's delay.
associate-evm-keyhotkeysigned account (pallet role may apply)Associate an EVM key with a hotkey on a subnet.
associate-hotkeycoldkeysigned account (pallet role may apply)Associate a hotkey with the signing coldkey.
burned-registercoldkeysigned account (pallet role may apply)Register a hotkey on a subnet by paying the registration cost.
claim-rootcoldkeysigned account (pallet role may apply)Claim accumulated root dividends from one or more subnets.
clear-coldkey-swap-announcementcoldkeysigned account (pallet role may apply)Cancel a pending coldkey swap announcement (after the reannouncement delay).
commit-weightshotkeysigned account (pallet role may apply)Timelock-encrypt and commit weights, forcing the commit-reveal path.
decrease-takecoldkeysigned account (pallet role may apply)Decrease the delegate take of a hotkey.
dispute-coldkey-swapcoldkeysigned account (pallet role may apply)Freeze this coldkey entirely until root resolves the dispute.
increase-takecoldkeysigned account (pallet role may apply)Increase the delegate take of a hotkey.
lock-stakecoldkeysigned account (pallet role may apply)Lock alpha stake on a subnet, building conviction toward a hotkey.
move-lockcoldkeysigned account (pallet role may apply)Move an existing lock from one hotkey to another on a subnet.
move-stakecoldkeysigned account (pallet role may apply)Move alpha between hotkeys and/or subnets.
register-leased-networkcoldkeysigned account (pallet role may apply)Register a new crowdloan-funded leased subnet.
register-subnetcoldkeysigned account (pallet role may apply)Create a new subnet owned by the signing coldkey.
remove-stakecoldkeysigned account (pallet role may apply)Unstake alpha from a hotkey back to the coldkey.
remove-stake-limitcoldkeysigned account (pallet role may apply)Unstake alpha with a limit price (slippage protection).
reset-axonhotkeysigned account (pallet role may apply)Reset (stop serving) this hotkey's axon endpoint on a subnet.
reveal-weightshotkeysigned account (pallet role may apply)Reveal previously committed weights (legacy salt-based commit-reveal).
root-registercoldkeysigned account (pallet role may apply)Register a hotkey on the root network (netuid 0).
serve-axonhotkeysigned account (pallet role may apply)Publish this hotkey's axon endpoint (ip:port) for a subnet.
serve-axon-tlshotkeysigned account (pallet role may apply)Publish this hotkey's axon endpoint with a neuron certificate.
serve-prometheushotkeysigned account (pallet role may apply)Publish this hotkey's prometheus metrics endpoint (ip:port) for a subnet.
set-auto-stakecoldkeysigned account (pallet role may apply)Auto-stake future mining rewards on a subnet to a chosen hotkey.
set-childkey-takecoldkeysigned account (pallet role may apply)Set the childkey take for a hotkey on a subnet.
set-childrencoldkeysigned account (pallet role may apply)Assign child hotkeys with stake-weight proportions on a subnet.
set-identitycoldkeysigned account (pallet role may apply)Publish an on-chain identity (name, links, description) for the coldkey.
set-min-collateralcoldkeysigned account (pallet role may apply)Set the self-maintaining collateral floor for your hotkey on a subnet.
set-perpetual-lockcoldkeysigned account (pallet role may apply)Enable or disable perpetual lock mode for a coldkey on a subnet.
set-root-claim-typecoldkeysigned account (pallet role may apply)Set how a coldkey's root alpha emission is claimed.
set-subnet-identitycoldkeysubnet ownerPublish identity metadata for a subnet (signer must be the subnet owner).
set-takecoldkeysigned account (pallet role may apply)Set the delegate take to an absolute value.
set-weightshotkeysigned account (pallet role may apply)Set validator weights, auto-selecting plaintext or commit-reveal.
stake-burncoldkeysigned account (pallet role may apply)Buy back / burn stake via the stake-burn extrinsic.
start-callcoldkeysubnet ownerActivate a subnet (subtoken trading, epochs) as its owner.
swap-coldkey-announcedcoldkeysigned account (pallet role may apply)Execute a previously announced coldkey swap (after the delay has passed).
swap-hotkeycoldkeysigned account (pallet role may apply)Swap a hotkey for a new one (all subnets, or one netuid).
swap-stakecoldkeysigned account (pallet role may apply)Swap stake on one hotkey between two subnets.
terminate-leasecoldkeysigned account (pallet role may apply)Terminate an ended lease and take subnet ownership (beneficiary only).
transfer-stakecoldkeysigned account (pallet role may apply)Transfer stake ownership to another coldkey.
unstake-allcoldkeysigned account (pallet role may apply)Unstake everything from a hotkey across all subnets.
unstake-all-alphacoldkeysigned account (pallet role may apply)Unstake all alpha from a hotkey across subnets (moves it to root).
update-symbolcoldkeysubnet ownerUpdate a subnet's symbol (from the chain's fixed catalog).

Utility

OperationSignerOriginSummary
batchcoldkeysigned account (pallet role may apply)Execute several intents atomically in one extrinsic (all-or-nothing).