Transactions

set-root-claim-type

Set how a coldkey's root alpha emission is claimed.

Controls what happens to root dividends when they are claimed (see claim_root): Swap converts all alpha emission to TAO (the chain default), Keep keeps everything as subnet alpha, and KeepSubnets keeps alpha on the listed subnets while swapping the rest. The setting is per-coldkey and persists until changed again; it does not move anything already claimed. Read it back with the root_claim_type read.

Signer	Pallet	Wraps
`coldkey`	SubtensorModule	`SubtensorModule.set_root_claim_type`

Parameters

Parameter	Type	Required	Description
`claim_type`	string	no	How root alpha emission is claimed. One of: Swap, Keep, KeepSubnets. Swap converts all alpha emission to TAO, Keep keeps everything as alpha, KeepSubnets keeps alpha only on the subnets given via --subnets and swaps the rest.
`subnets`	array	no	Netuids to keep alpha on; required for KeepSubnets, invalid otherwise.

Address parameters (--hotkey, --coldkey, --dest, ...) accept a raw ss58 address, an address-book or proxy-book name, or a local wallet/hotkey name.

CLI

Preview with --dry-run (shows fee, effects, and policy result without submitting), then submit:

btcli tx set-root-claim-type --dry-run
btcli tx set-root-claim-type -w my_coldkey

Python

import bittensor as sub
from bittensor.wallet import Wallet

wallet = Wallet(name="my_coldkey", hotkey="my_hotkey")
intent = sub.SetRootClaimType()

async with sub.Client("finney") as client:
    plan = await client.plan(intent, wallet)   # fee, effects, policy — no submission
    result = await client.execute(intent, wallet)
    if not result.success:
        print(result.error.code, result.error.remediation)

Or build it by op name, as an agent would:

await client.execute_tool("set_root_claim_type", {...}, wallet)