## Problem
Frontend was showing 'connecting network' message on production (pezkuwichain.io) because:
1. WebSocket endpoint was hardcoded to localhost in App.tsx
2. DEFAULT_ENDPOINT in polkadot.ts was not reading environment variables
## Solution
### shared/blockchain/polkadot.ts
- Added getWebSocketEndpoint() function to read VITE_NETWORK and corresponding VITE_WS_ENDPOINT_* env vars
- Changed DEFAULT_ENDPOINT from hardcoded value to call getWebSocketEndpoint()
- Now correctly uses wss://ws.pezkuwichain.io in production
### web/src/App.tsx
- Removed hardcoded endpoint="ws://127.0.0.1:9944" prop from PolkadotProvider
- Now uses DEFAULT_ENDPOINT which reads from environment
### web/vite.config.ts
- Minor formatting improvements (no functional changes)
### CLAUDE_README_KRITIK.md (New file)
- Critical documentation for future Claude instances
- Documents VPS validator setup, bootnode configuration
- Strict warnings not to modify working blockchain
- Troubleshooting commands and procedures
- Frontend deployment steps
## Result
- Production site now correctly connects to wss://ws.pezkuwichain.io
- Environment-based configuration working as expected
- Local dev still uses ws://127.0.0.1:9944
## Files Changed
- shared/blockchain/polkadot.ts: Dynamic endpoint selection
- web/src/App.tsx: Remove hardcoded endpoint
- CLAUDE_README_KRITIK.md: Critical documentation (new)
Centralized common code into shared/ folder to eliminate duplication and
improve maintainability across all three frontend projects (web, mobile,
pezkuwi-sdk-ui).
Changes:
- Added token types and constants to shared/types/tokens.ts
- TokenInfo, PoolInfo, SwapQuote, and other DEX types
- KNOWN_TOKENS with HEZ, PEZ, wUSDT definitions
- Token logos (🟡🟣💵)
- Added Kurdistan color palette to shared/constants/
- Kesk, Sor, Zer, Spî, Reş color definitions
- Added TOKEN_DISPLAY_SYMBOLS mapping (USDT vs wUSDT)
- Updated blockchain configuration in shared/blockchain/polkadot.ts
- Added beta testnet endpoint (wss://beta-rpc.pezkuwi.art)
- Defined DEFAULT_ENDPOINT constant
- Moved i18n to shared/i18n/
- Centralized translation files for 6 languages (EN, TR, KMR, CKB, AR, FA)
- Added LANGUAGES configuration with RTL support
- Created isRTL() helper function
- Updated web and mobile to import from shared
- web/src/types/dex.ts now re-exports from shared
- web/src/contexts/PolkadotContext.tsx uses DEFAULT_ENDPOINT
- mobile/src/i18n/index.ts uses shared translations
- mobile/src/contexts/PolkadotContext.tsx uses DEFAULT_ENDPOINT
- Updated shared/README.md with comprehensive documentation
This architecture reduces code duplication and ensures consistency across
all frontend projects.
Restructured the project to support multiple frontend applications:
- Move web app to web/ directory
- Create pezkuwi-sdk-ui/ for Polkadot SDK clone (planned)
- Create mobile/ directory for mobile app development
- Add shared/ directory with common utilities, types, and blockchain code
- Update README.md with comprehensive documentation
- Remove obsolete DKSweb/ directory
This monorepo structure enables better code sharing and organized
development across web, mobile, and SDK UI projects.
pezkuwichain
Claude