mirror of
https://gitlab.com/pezkuwichain/pezkuwi-sdk.git
synced 2026-10-21 19:26:21 +00:00
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.
51 lines
2.3 KiB
Markdown
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.
|