Call Workflow
Click items to navigate. Pan and zoom to explore.
The Big Picture
Each subnet's Alpha token can have its own symbol (like TAO, but for the subnet). This is purely cosmetic but matters for branding. update_symbol changes this identifier so your subnet's token shows the right ticker in wallets, explorers, and exchanges.
Why This Matters
Token symbols are recognizable shorthand. 'BTC' means Bitcoin, 'ETH' means Ethereum. Your subnet's symbol helps people identify and talk about your token. Choose something memorable and unique.
Example Scenario
Your subnet's Alpha was created with symbol 'ALPHA'. You want it to be 'IMGN' for ImageNet. Call update_symbol(netuid=23, symbol='IMGN'). Now explorers show 'IMGN' instead of 'ALPHA' for your subnet's token.
Common Questions
- Are there restrictions on symbols?
- Typically: uppercase letters, 3-5 characters, can't duplicate existing major tokens. Check network rules for exact requirements.
- Does changing symbol affect the token itself?
- No - it's purely cosmetic. The token, balances, and functionality are unchanged. Only the display name changes.
- How often can I change the symbol?
- Usually no limit, but frequent changes confuse users. Pick a good symbol and stick with it. Only change for good reasons (typo, rebrand).
Use Cases
- Rebrand subnet with new token symbol
- Correct a typo in original symbol
- Align symbol with marketing or identity changes
- Differentiate subnet's Alpha from others
From Chain Metadata
Updates the symbol for a subnet.
Input Parameters
Permissions
Permission data inferred from metadata. May be incomplete.
Requirements
- Caller is subnet owner or admin
- Valid symbol format (typically 3-5 uppercase letters)
Effects
Events Emitted
Storage Modified
Postconditions
- Symbol updated
- New symbol appears in explorers and UIs
Side Effects
- UIs display new symbol
- May affect token identification in exchanges/wallets
Code Examples
import { ApiPromise, WsProvider } from "@polkadot/api";
import { stringCamelCase } from "@polkadot/util";
const provider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
const api = await ApiPromise.create({ provider });
// Build update_symbol call
const netuid = 1;
const symbol = 0;
const call = api.tx[stringCamelCase("SubtensorModule")][stringCamelCase("update_symbol")](
netuid,
symbol
);Runtime Info
View Source- Pallet Index
- 7
- Call Index
- 112
- First Version
- v290
- Current Version
- v393