Terminology around token/denomination/ticker/symbol/decimals

[lukaw3d]

No description provided.

[lukaw3d]

From slack:

• what are the correct terms for groups of these tokens: EUROe, TEST, ERC-20 EUROe (0x8A4826071983655805bF4f29828577Cd6b1aC0cB)?
• is EUROe: fees token?
• is TEST: consensus token?
• are [EUROe, TEST]: native tokens? native denominations? paratime tokens? paratime balances?
• is there a term non-fee tokens [TEST, [...]]?
• are [EUROe, ERC-20 EUROe]: both ERC-20 tokens? (i.e. is EUROe also ERC-20 internally?)

Jernej:

• EUROe and TEST are both exactly the same, they are sdk denominations; each of those can either be or not be a fee token. non-sdk denominations cannot be fee tokens.
• EUROe is also the native token inside the EVM (because EVM only supports a single native token). any sdk denomination can be a native token, but once set, it is not possible to change it without possibly breaking all smart contracts.
• ERC-20 EUROe I assume is just a deployed ERC-20 contract with the given name, nothing special.
• in the future it will be possible to map any sdk denomination to an ERC-20 as well (to special fixed addresses), but this is currently not the case.

[lukaw3d]

some code:

explorer/src/types/ticker.ts

Lines 4 to 14 in b45547a

	export const Ticker = {
	ROSE: 'ROSE',
	TEST: 'TEST',
	EUROe: 'EUROe',
	} as const
	export type NativeTokenInfo = {
	ticker: Ticker
	free?: boolean
	geckoId?: string
	}

explorer/src/config.ts

Lines 22 to 27 in b45547a

	/**
	* What are the tokens on this layer?
	* Note: native token must be the first on the list. Others are just incorrectly named "Native"
	* See terminology in https://github.com/oasisprotocol/oasis-sdk/blob/5bec25f/client-sdk/go/config/default.go#L109-L120
	*/
	tokens: [NativeTokenInfo, ...NativeTokenInfo[]]

explorer/src/app/pages/ParatimeDashboardPage/ParaTimeSnapshot.tsx

Lines 23 to 24 in b45547a

	const mainToken = tokens[0]
	const mainTicker = mainToken.ticker

explorer/src/app/components/Balance/hooks.ts

Line 53 in b45547a

const priceInfo = tokenPrices[balance.token_symbol as Ticker]

explorer/src/app/components/Balance/hooks.ts

Line 7 in b45547a

balances.some(balance => balance.token_decimals)

explorer/src/app/components/RoundedBalance/__tests__/index.test.tsx

Line 40 in b45547a

it('should render value with ROSE ticker symbol', () => {

explorer/src/app/utils/getRPCAccountBalances.ts

Line 37 in b45547a

token_symbol: oasis.misc.toStringUTF8(denomination) || getTokensForScope(scope)[0].ticker,