TrueRepublic / PNYX

---

🌍 Vision

TrueRepublic is a platform for direct democracy and digital self-determination.
The token PNYX enables governance, treasury mechanisms and a decentralized DEX.

---

📂 Repository Structure & Status

TrueRepublic/
 ├── blockchain/        ✅  Cosmos SDK chain (modules: truedemocracy, dex, treasury)
 ├── contracts/         ✅  CosmWasm smart contracts (governance)
 ├── web-wallet/        ✅  React web wallet (Keplr integration)
 ├── mobile-wallet/     🔵  React Native mobile wallet (basic version; features pending)
 ├── docs/              ✅  White Papers, API, DEX, Install guides
 ├── scripts/           🔵  DevOps & deployment (planned)
 ├── tests/             🔴  Unit & E2E tests largely missing
 └── .github/
     ├── ISSUE_TEMPLATE ✅  available
     └── workflows/     🔵  CI/CD workflows added (security scans pending)
📑 Documentation
Structured White Paper (Markdown)

TrueRepublic Native White Paper (PDF)

Security Policy

CI/CD Security Guide

API & DEX docs (skeletons):

API.md 🔵

DEX.md 🔵

🛠️ Build & Development
Blockchain (Cosmos SDK)
bash
Code kopieren
cd blockchain
go mod tidy
go build ./...
go test ./... -race -cover
Contracts (CosmWasm)
bash
Code kopieren
cd contracts
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test --all
Web Wallet (React)
bash
Code kopieren
cd web-wallet
npm ci
npm test
npm run build
Mobile Wallet (React Native)
bash
Code kopieren
cd mobile-wallet
npm ci
npm test
🚀 Improvements & To-dos
Blockchain: add more unit tests per module (happy & error paths)

Contracts: modularization, strict clippy enforcement

Wallets: more mock & E2E tests (Jest, Detox)

CI/CD: add security scans (Trivy/Grype), SBOM generation

Docs: complete API/DEX documentation

📌 Current Status
✅ White Papers (Markdown + PDF) and structured README in place

🔵 CI/CD workflows prepared but not all enabled

🔴 Tests & security checks still missing