Transactions

set-subnet-identity

Publish identity metadata for a subnet (signer must be the subnet owner).

Stores the subnet's public profile — name, links, contact, logo — so explorers and participants can identify it. Owner-only: the signing coldkey must own the subnet. Everything submitted is public and permanent history on chain. Calling again overwrites the whole record (empty fields clear their previous values); the chain enforces length limits on each field. Purely cosmetic — for the token ticker use update_symbol, and for economics use set_hyperparameter.

Signer	Pallet	Wraps
`coldkey`	SubtensorModule	`SubtensorModule.set_subnet_identity`

Parameters

Parameter	Type	Required	Description
`netuid`	integer	yes	Subnet the identity is for; the signer must be its owner.
`subnet_name`	string	yes	Display name shown for the subnet.
`github_repo`	string	no	GitHub repository URL for the subnet's code.
`subnet_contact`	string	no	Contact address for the subnet operators.
`subnet_url`	string	no	Website for the subnet.
`discord`	string	no	Discord handle or server invite.
`description`	string	no	Short free-text description of what the subnet does.
`logo_url`	string	no	Logo image URL for the subnet.
`additional`	string	no	Any extra free-text information to publish.

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-subnet-identity \
  --netuid <int> \
  --subnet-name <value> --dry-run
btcli tx set-subnet-identity \
  --netuid <int> \
  --subnet-name <value> -w my_coldkey

Python

import bittensor as sub
from bittensor.wallet import Wallet

wallet = Wallet(name="my_coldkey", hotkey="my_hotkey")
intent = sub.SetSubnetIdentity(netuid=1, subnet_name="...")

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_subnet_identity", {...}, wallet)