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 sub.<ClassName>. The machine-readable catalog of all of these (with JSON schemas) is at /catalog/intents.json or via btcli tools / sub.intents.list_tools().

AdminUtils

OperationSignerSummary
set-hyperparametercoldkeySet an owner-settable subnet hyperparameter (btcli sudo set).
set-mechanism-countcoldkeySet the number of mechanisms on a subnet.
set-mechanism-emission-splitcoldkeySet emission split between mechanisms on a subnet.
trim-subnetcoldkeyTrim a subnet to at most max_n UIDs (subnet owner).

Balances

OperationSignerSummary
fund-evm-keycoldkeyFund an EVM (h160) address with TAO from the signing coldkey.
transfercoldkeyTransfer TAO from the coldkey to a destination address.
transfer-allcoldkeyTransfer the entire transferable balance to a destination address.

Crowdloan

OperationSignerSummary
contribute-crowdloancoldkeyContribute TAO to an active crowdloan.
create-crowdloancoldkeyOpen a crowdloan raising up to cap_tao by end block.
dissolve-crowdloancoldkeyDissolve a fully-refunded crowdloan (creator only).
finalize-crowdloancoldkeyFinalize a crowdloan that reached its cap (creator only).
refund-crowdloancoldkeyRefund contributors of a non-finalized crowdloan (creator only).
set-crowdloan-max-contributioncoldkeySet or clear the per-contributor max for a non-finalized crowdloan (creator only).
update-crowdloan-capcoldkeyUpdate the cap of a non-finalized crowdloan (creator only).
update-crowdloan-endcoldkeyUpdate the end block of a non-finalized crowdloan (creator only).
update-crowdloan-min-contributioncoldkeyUpdate the minimum contribution of a non-finalized crowdloan (creator only).
withdraw-crowdloancoldkeyWithdraw the signer's contribution from a non-finalized crowdloan.

EVM

OperationSignerSummary
evm-withdrawcoldkeyClaim TAO deposited to the coldkey's truncated EVM mirror.

Multisig

OperationSignerSummary
multisig-approvecoldkeyRegister approval for a multisig call (non-final approvals).
multisig-cancelcoldkeyCancel an ongoing multisig operation (only the original depositor may).
multisig-executecoldkeyApprove and, if the threshold is met, execute a multisig call (final approval).
multisig-threshold-1coldkeyDispatch a 1-of-N multisig call immediately (single approval).

Proxy

OperationSignerSummary
add-proxycoldkeyAuthorize a delegate key to sign calls on this account's behalf.
create-pure-proxycoldkeyCreate a pure proxy: a fresh keyless account controlled via delegation.
execute-proxy-announcedcoldkeyExecute a proxy call that was announced and has passed its delay.
kill-pure-proxycoldkeyClose a pure proxy account and return its reserved deposit.
remove-proxiescoldkeyRevoke every proxy delegation for the signing account at once.
remove-proxycoldkeyRevoke one proxy delegation.

SubtensorModule

OperationSignerSummary
add-stakecoldkeyStake TAO from the coldkey onto a hotkey.
add-stake-limitcoldkeyStake TAO with a limit price (slippage protection).
announce-coldkey-swapcoldkeyAnnounce (commit to) a coldkey swap; executable after the chain's delay.
associate-evm-keyhotkeyAssociate an EVM key with a hotkey on a subnet.
associate-hotkeycoldkeyAssociate a hotkey with the signing coldkey.
burned-registercoldkeyRegister a hotkey on a subnet by recycling TAO.
claim-rootcoldkeyClaim accumulated root dividends from one or more subnets.
clear-coldkey-swap-announcementcoldkeyCancel a pending coldkey swap announcement (after the reannouncement delay).
commit-weightshotkeyTimelock-encrypt and commit weights, forcing the commit-reveal path.
decrease-takecoldkeyDecrease the delegate take of a hotkey.
dispute-coldkey-swapcoldkeyFreeze this coldkey entirely until root resolves the dispute.
increase-takecoldkeyIncrease the delegate take of a hotkey.
lock-stakecoldkeyLock alpha stake on a subnet, building conviction toward a hotkey.
move-lockcoldkeyMove an existing lock from one hotkey to another on a subnet.
move-stakecoldkeyMove alpha between hotkeys and/or subnets.
register-leased-networkcoldkeyRegister a new crowdloan-funded leased subnet.
register-subnetcoldkeyCreate a new subnet owned by the signing coldkey.
remove-stakecoldkeyUnstake alpha from a hotkey back to the coldkey.
remove-stake-limitcoldkeyUnstake alpha with a limit price (slippage protection).
reset-axonhotkeyReset (stop serving) this hotkey's axon endpoint on a subnet.
reveal-weightshotkeyReveal previously committed weights (legacy salt-based commit-reveal).
root-registercoldkeyRegister a hotkey on the root network (netuid 0).
serve-axonhotkeyPublish this hotkey's axon endpoint (ip:port) for a subnet.
serve-axon-tlshotkeyPublish this hotkey's axon endpoint with a neuron certificate.
serve-prometheushotkeyPublish this hotkey's prometheus metrics endpoint (ip:port) for a subnet.
set-auto-stakecoldkeyAuto-stake future mining rewards on a subnet to a chosen hotkey.
set-childkey-takecoldkeySet the childkey take for a hotkey on a subnet.
set-childrencoldkeyAssign child hotkeys with stake-weight proportions on a subnet.
set-identitycoldkeyPublish an on-chain identity (name, links, description) for the coldkey.
set-perpetual-lockcoldkeyEnable or disable perpetual lock mode for a coldkey on a subnet.
set-root-claim-typecoldkeySet how a coldkey's root alpha emission is claimed.
set-subnet-identitycoldkeyPublish identity metadata for a subnet (signer must be the subnet owner).
set-takecoldkeySet the delegate take to an absolute value.
set-weightshotkeySet validator weights, auto-selecting plaintext or commit-reveal.
stake-burncoldkeyBuy back / burn stake via the stake-burn extrinsic.
start-callcoldkeyActivate a subnet (subtoken trading, epochs) as its owner.
swap-coldkey-announcedcoldkeyExecute a previously announced coldkey swap (after the delay has passed).
swap-hotkeycoldkeySwap a hotkey for a new one (all subnets, or one netuid).
swap-stakecoldkeySwap stake on one hotkey between two subnets.
terminate-leasecoldkeyTerminate an ended lease and take subnet ownership (beneficiary only).
transfer-stakecoldkeyTransfer stake ownership to another coldkey.
unstake-allcoldkeyUnstake everything from a hotkey across all subnets.
unstake-all-alphacoldkeyUnstake all alpha from a hotkey across subnets (moves it to root).
update-symbolcoldkeyUpdate a subnet's symbol (from the chain's fixed catalog).

Utility

OperationSignerSummary
batchcoldkeyExecute several intents atomically in one extrinsic (all-or-nothing).