mirror of
https://github.com/pezkuwichain/pezkuwi-wallet-utils.git
synced 2026-11-05 16:51:07 +00:00
SatoshiQaziMuhammed
35feb5afe0
The wallet now refreshes its light client specifications from this repository through the signed config, so a wallet that never fell back no longer starts from the checkpoint its APK was built with. That only helps if the checkpoint here is kept fresh. light_client_specs.py --check-age DAYS reads the relay checkpoint's block number from light-client/, compares it with the live head, and fails past DAYS. Code Quality runs it weekly with 60 days. The README asks for the specifications to be regenerated before signing.
111 lines
3.7 KiB
Markdown
111 lines
3.7 KiB
Markdown
# 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
|
|
```
|
|
|
|
## Signed config
|
|
|
|
`signed/targets.json` gives the sha256 of every JSON file the wallet may fetch, signed with the targets
|
|
key; `signed/root.json` names that key and the three root keys, two of which can replace it. The wallet
|
|
carries the first root and refuses a file whose hash the signed list does not give, so a change to any
|
|
served JSON file is re-signed in the same pull request:
|
|
|
|
```
|
|
python3 scripts/signed_config.py sign --key <targets seed>
|
|
```
|
|
|
|
The light client specifications in `light-client/` carry a relay chain checkpoint. Wallets fetch them through
|
|
the signed config and keep a later checkpoint than their APK's, so refresh them before signing:
|
|
|
|
```
|
|
python3 scripts/light_client_specs.py --relay-rpc <zagros rpc> --people-rpc <people rpc> --people-spec <full People spec>
|
|
```
|
|
|
|
Code Quality fails once the checkpoint is more than 60 days old.
|
|
|
|
Code Quality refuses a tree whose files do not match the signed list, and its weekly run fails a month
|
|
before a signature expires.
|
|
|
|
## Contributing
|
|
|
|
1. Fork this repository
|
|
2. Create your feature branch
|
|
3. Commit your changes
|
|
4. Push to the branch
|
|
5. Create a Pull Request
|
|
|
|
## Related Projects
|
|
|
|
- [Pezkuwi Wallet Android](https://github.com/pezkuwichain/pezkuwi-wallet-android)
|
|
- [Pezkuwi Wallet iOS](https://github.com/pezkuwichain/pezkuwi-wallet-ios)
|
|
- [Pezkuwi SDK](https://github.com/pezkuwichain/pezkuwi-sdk)
|
|
|
|
## License
|
|
|
|
Apache 2.0
|
|
|
|
## Resources
|
|
|
|
- Website: https://pezkuwichain.io
|
|
- Documentation: https://docs.pezkuwichain.io
|
|
- Telegram: https://t.me/pezkuwichain
|
|
- Twitter: https://twitter.com/pezkuwichain
|
|
|
|
---
|
|
|
|
Based on [Nova Utils](https://github.com/novasamatech/nova-utils) - Extended with Pezkuwichain support
|
|
|
|
© Dijital Kurdistan Tech Institute 2026
|