mirror of
https://github.com/pezkuwichain/pezkuwi-wallet-utils.git
synced 2026-07-09 02:27:28 +00:00
pezkuwichain
2efab72f83
Root cause of the balances-test hang in pezkuwi-wallet-android (silent for over an hour, cancelled multiple times before finding this): every single chain_id in blocked-chains.json was stale - none matched anything in Nova's current chains.json (last_updated 2026-02-11, ~5 months of upstream chain-id drift since). The blacklist mechanism silently no-opped for all 6 entries, so none of the chains it was meant to exclude were actually excluded. With the blacklist ineffective, several chains with genuinely dead RPC endpoints (confirmed live 2026-07-08: 3DPass, Curio, Quartz, Subsocial - 502s, timeouts, SSL failures) stayed in the merged output. The Android app's ChainConnection/NodeAutobalancer has no backoff/circuit breaker for dead endpoints, so it retried them in an extremely tight loop (~1 attempt/second, 1500-1800+ attempts observed in a 25 minute window per chain) - burning resources indefinitely and starving the app's actual chain-sync/test work, which is what made the Android CI job hang for over an hour with zero progress. Fix: re-verified and corrected all chain_ids (matching by current name against live chains.json), added 3DPass/Curio/Subsocial which weren't blacklisted before, dropped entries for chains no longer present upstream at all (Passet Hub Testnet, Darwinia Crab, DeepBrain, Exosama - nothing to block, kept them as historical noise otherwise). Also added a stale-blacklist warning to sync_from_nova.py: it now tracks which blocked chain_ids actually matched something in Nova's current chains across all versions, and prints a warning listing any that didn't - so this exact silent drift is caught at sync time going forward instead of rotting unnoticed for another five months.
Pezkuwi Wallet Utils
Configuration repository for Pezkuwi Wallet - next generation mobile wallet for Pezkuwichain and the Polkadot ecosystem.
Overview
This repository contains chain configurations, staking metadata, dApp listings, and other utility files used by Pezkuwi Wallet applications.
Structure
pezkuwi-wallet-utils/
├── chains/ # Chain configurations for all supported networks
│ ├── pezkuwichain/ # Pezkuwichain (Relay + Asset Hub + People Chain)
│ ├── polkadot/ # Polkadot ecosystem chains
│ ├── kusama/ # Kusama ecosystem chains
│ └── ... # Other ecosystem chains
├── staking/ # Staking metadata (validators, pools, etc.)
├── dapps/ # DApp configurations and metadata
├── xcm/ # XCM (Cross-Chain Messaging) configurations
├── governance/ # Governance dApps and proposals
├── banners/ # Promotional banners and announcements
├── migrations/ # Chain migration configurations
├── assets/ # Asset metadata and icons
├── icons/ # Chain and network icons
└── global/ # Global configuration files
Native Tokens
| Token | Network | Description |
|---|---|---|
| HEZ | Pezkuwi Relay Chain | Native token for fees and staking |
| PEZ | Asset Hub | Governance token |
| USDT | Asset Hub | Tether USD stablecoin |
Supported Networks
Pezkuwichain Ecosystem
- Pezkuwi Relay Chain - Main relay chain with HEZ token
- Asset Hub - System teyrchain for assets (PEZ, USDT, wHEZ)
- People Chain - Identity and people management
Polkadot Ecosystem
Full support for Polkadot and all major parachains.
Kusama Ecosystem
Full support for Kusama and all major parachains.
Usage
These configurations are fetched by Pezkuwi Wallet at runtime from GitHub raw URLs:
https://raw.githubusercontent.com/pezkuwichain/pezkuwi-wallet-utils/master/chains/{network}/chains.json
Contributing
- Fork this repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
Related Projects
License
Apache 2.0
Resources
- Website: https://pezkuwichain.io
- Documentation: https://docs.pezkuwichain.io
- Telegram: https://t.me/kurdishmedya
- Twitter: https://x.com/bizinikiwi
Based on Nova Utils - Extended with Pezkuwichain support
© Dijital Kurdistan Tech Institute 2026