Pezkuwi SDK UI

A comprehensive web interface for interacting with the Pezkuwi blockchain network.

Features

• Blockchain Explorer - Browse blocks, transactions, and chain state
• Wallet Management - Create and manage accounts securely
• Staking Interface - Stake tokens and manage validators
• Governance - Participate in on-chain governance and voting
• Developer Tools - Extrinsics, RPC calls, and chain state queries
• Analytics - View network statistics and metrics

Quick Start

Prerequisites

• Node.js >= 18.14
• Yarn >= 4.0

Installation

# Clone the repository
git clone https://github.com/pezkuwichain/pezkuwi-sdk-ui.git
cd pezkuwi-sdk-ui

# Install dependencies
yarn install

# Start development server
yarn start

The application will be available at http://localhost:3000

Production Build

# Build web version
yarn build:www

# Build desktop application (Electron)
yarn build:release:electron

Hosted Version

Access the production version at https://pezkuwichain.app/sdk

Project Structure

pezkuwi-sdk-ui/
├── packages/
│   ├── apps/              # Main application entry point
│   ├── apps-config/       # Chain configurations and endpoints
│   ├── apps-electron/     # Desktop application (Electron)
│   ├── apps-routing/      # Application routing
│   ├── page-*/            # Individual page components
│   ├── react-api/         # React API hooks and context
│   ├── react-components/  # Reusable UI components
│   ├── react-hooks/       # Custom React hooks
│   ├── react-params/      # Parameter handling components
│   ├── react-query/       # Query components
│   └── react-signer/      # Transaction signing components
├── scripts/               # Build and utility scripts
└── docs/                  # Documentation

Configuration

Network Endpoints

Configure network endpoints in packages/apps-config/src/endpoints/production.ts:

{
  info: 'pezkuwi',
  providers: {
    Pezkuwi: 'wss://pezkuwichain.app:9944'
  }
}

Custom Chain Types

Add custom runtime types in packages/apps-config/src/api/spec/pezkuwi.ts

Branding

PEZ Token Logo

Kurdistan Color Palette

Color	Hex	Usage
Kesk (Green)	#00A94F	Primary actions, highlights
Sor (Red)	#EE2A35	Alerts, important actions
Zer (Gold)	#FFD700	Secondary accents
Spi (White)	#FFFFFF	Backgrounds

Scripts

Command	Description
yarn start	Start development server on port 3000
yarn build	Build for production
yarn build:www	Build web version
yarn build:electron	Build desktop application
yarn lint	Run ESLint
yarn test	Run test suite

Security

This application handles sensitive blockchain interactions. Please:

• Verify you're on the correct URL before signing transactions
• Keep private keys secure and never share them
• Use hardware wallets for significant amounts
• Report security issues to: security@pezkuwichain.app

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

Apache-2.0

Links

• Website: https://pezkuwichain.app
• Documentation: https://docs.pezkuwichain.app
• Issues: GitHub Issues