Symbol Does Not Exist
SymbolDoesNotExist is a documented Subtensor standard error. The standard-errors reference
describes it simply as “Symbol does not exist”
(Subtensor Standard Errors).
What It Means
This error means the submitted symbol is not one of the symbols the chain recognizes as valid for
that symbol-setting context. In symbols.rs, ensure_symbol_exists checks the submitted bytes
against the allowed SYMBOLS list and returns SymbolDoesNotExist when the symbol is absent from
that set
(Subtensor source: symbols.rs).
So the error is about symbol validity, not about whether a valid symbol is already assigned somewhere else. The submitted symbol itself fails the allowed-symbol check before any separate reuse question would matter (Subtensor Standard Errors, Subtensor source: symbols.rs).
Why It Appears
The chain stores a finite symbol set and checks membership directly. If the submitted symbol is not
in that set, ensure_symbol_exists rejects it immediately with SymbolDoesNotExist
(Subtensor source: symbols.rs).
For a reader, the practical meaning is narrow: the chain is not saying the symbol is taken by another subnet; it is saying the symbol is not part of the recognized symbol inventory at all (Subtensor Standard Errors: SymbolAlreadyInUse, Subtensor Standard Errors).
Distinction from Symbol Already In Use
SymbolDoesNotExist and SymbolAlreadyInUse reject different symbol problems. SymbolDoesNotExist
means the submitted symbol is outside the allowed set. SymbolAlreadyInUse means the submitted
symbol is valid, but another subnet is already using it
(Subtensor Standard Errors,
Subtensor Standard Errors: SymbolAlreadyInUse,
Subtensor source: symbols.rs).
- SymbolDoesNotExist — the symbol is not in the chain’s allowed symbol set.
- SymbolAlreadyInUse — the symbol is valid, but it is already assigned elsewhere.
Reader Boundary
This page defines the meaning of the error label and the allowed-symbol membership check that raises it. It does not explain the full subnet-symbol assignment process or the entire symbol-selection strategy beyond this one rejection condition (Subtensor source: symbols.rs).