Files
pezkuwi-sdk/docs/TOKENS_AND_NETWORKS.md
T
Satoshi Qazi Muhammed d285d59108 sync: mirror deployed github repo (chains + sanitized bridge), keep GitLab CI
Make this monorepo's tracked tree identical to the deployed github repo
(github.com/pezkuwichain/pezkuwi-DKS): all RC/AH/People runtimes and framework
carry the mainnet fixes (incl. U128CurrencyToVote everywhere, so the staking
election stall cannot recur), and tools/usdt-bridge matches the current,
public-safe custody tooling (real config/deploy units gitignored, secret-file
locations and server IPs stripped, sanitized *.example templates committed).

Only exception to the mirror: GitLab-native CI is preserved (.gitlab-ci.yml and
.gitlab/), to be rebuilt to match the github CI pipeline in a follow-up.
2026-07-24 11:42:50 -07:00

2.3 KiB

PezkuwiChain — Token & Network Standard

This is the single source of truth for token symbols across PezkuwiChain networks. Any new chain-spec, runtime, or document must follow it.

Principle

A system teyrchain (Asset Hub, People, Coretime, Bridge Hub) does not have its own native token — it shares the relay chain's native token for fees and existential deposits. Its tokenSymbol therefore equals the relay's symbol (exactly as asset-hub-polkadot reports DOT, not a symbol of its own).

Mainnet — PezkuwiChain

Item Value
Relay native token HEZ
Decimals 12 (UNITS = 10^12)
System teyrchains (asset-hub / people / coretime / bridge-hub-pezkuwichain) HEZ (shared relay native)
Asset Hub governance token PEZ (a token/asset on Asset Hub — 5,000,000,000 supply; not the native fee token)
ss58Format 42 (generic; registering a dedicated prefix is tracked separately)

HEZ total issuance on the relay: 200,000,000. Genesis allocation constants are named HEZ_*. Where an amount is just a base-unit multiple in a non-native context (e.g. PEZ allocations on Asset Hub), use plain UNITS, not a token-named alias.

Testnets & dev networks

Network Symbol Notes
Zagros ZGR Primary public testnet
Dicle DCL Testnet
Versi VRS Staging/dev network
Paseo PAS Dev network

Testnet symbols are intentionally distinct from HEZ so that testnet tokens can never be confused with mainnet value — this is a deliberate safety property, not an inconsistency. Testnet system teyrchains share their own relay's symbol (e.g. the Zagros system teyrchains report ZGR).

Notes for maintainers

  • The token symbol is embedded in three runtime-level places, so changing it on a live network requires a coordinated runtime upgrade + chain-spec redeploy:
    1. build.rs → enable_metadata_hash("HEZ", 12) (drives the CheckMetadataHash extension used by hardware/offline signers).
    2. The Claims Prefix signed-payload (b"Pay HEZ to the Pezkuwichain account:").
    3. The chain-spec properties.tokenSymbol.
  • TYR was an earlier placeholder that had leaked into the mainnet runtimes/specs; it has been fully standardized to HEZ. Do not reintroduce it.