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

51 lines
2.3 KiB
Markdown

# 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.