SymbolUpdated

Event Re-added v290 → v315, v320 → v326, v334 → v367, v372 → v377, v385 → current #103

Emitted when a subnet 's token symbol is updated.

Useful for: subnet ownersstakersanalyticswalletsdevelopers

The Big Picture

Each subnet has its own Alpha token represented in Liquid Alpha. The symbol is how that token is displayed - like 'α1' for subnet 1's Alpha or 'IMG' for an image generation subnet. Symbols help users identify and distinguish subnet tokens in wallets and dashboards.

Why This Matters

Clear symbols make portfolio management easier. Instead of 'Subnet 47 Alpha', you see 'IMGEN'. As a subnet owner, a good symbol is part of your branding. As a user, symbols help you quickly identify which subnet tokens you hold.

Example Scenario

You launch an image generation subnet and want the Alpha token called 'IMGEN'. You update the symbol from default to 'IMGEN'. SymbolUpdated fires. Now wallets and explorers show your token as IMGEN instead of generic 'Alpha-47'.

Common Questions

Is there a character limit for symbols?: Typically yes, like stock tickers. Check the valid symbol length in the runtime - usually 3-10 characters to keep displays clean.
Can symbols conflict with other subnets?: The chain may or may not enforce uniqueness. Even if duplicates are allowed, choose unique symbols to avoid user confusion.
Does changing the symbol affect the token?: No, it's purely cosmetic. The underlying token, balances, and economics are unchanged. Only the display name updates.

Use Cases

Brand your subnet's Alpha token with a unique symbol
Track subnet rebranding efforts
Display correct symbols in wallets and UIs
Build subnet token tracking tools

How to Use This Event

→ Track symbol changes for UI updates
→ Monitor subnet branding evolution
→ Build token display systems with correct symbols

From Chain Metadata

The symbol for a subnet has been updated.

Triggers

Emitted by

update_symbol

Preconditions

Caller is subnet owner or admin
Valid symbol provided

Effects

Storage Modified

TokenSymbol

Postconditions

Symbol storage updated

Side Effects

UIs display new symbol for subnet tokens

Event Data

#	Name	Type	Description
0	netuid	u16	Subnet/network identifier (0-65535)
1	symbol	Vec<u8> Vec	symbol (Vec<u8>)

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 });

// Subscribe to SymbolUpdated events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "SymbolUpdated"
    )
    .forEach(({ event }) => {
      console.log("SymbolUpdated:", event.data.toHuman());
    });
});

Version History

Version:

v290 block 5,947,548 2 args

v320 block 6,523,566 2 args

v334 block 6,811,690 2 args

v372 block 7,430,358 2 args

v385 block 7,782,670 2 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 103
First Version: v290
Current Version: v393

Back to SubtensorModule Events