Recovery-verified engineering baseline: v0.4.0 has green recovery, CI, and security evidence, but rollout gates remain open. It is not approved for production or real funds. Follow the rollout tracker and recovery epic #4.
PNYX Coin

Democracy, Reimagined

Blockchain governance with full-featured web client for direct democracy

Built on Cosmos SDK • Powered by PNYX Token • React Web Client • Open Source

Launch Web Client Documentation View on GitHub

Core Innovations

📊

Systemic Consensing

Move beyond binary voting with a -5 to +5 scale. Capture the intensity of preferences and find true consensus, not just majority rule.

🛡️

Proof-of-Domain

Anti-whale validator mechanism ensures network control stays with active community members, not wealthy investors.

🔐

ZKP Anonymous Voting

Groth16 membership architecture with chain-, proposal-, and rating-bound proofs plus persisted nullifier protection. Mock web proof submission is disabled; a compatible real prover and external cryptographic review are still required.

💰

VoteToEarn

Incentivize participation through economic rewards. Quality content costs PNYX, voting earns PNYX.

📜

Smart Contracts

CosmWasm integration with custom bindings lets smart contracts query governance state and interact with domain treasuries.

🔄

Integrated DEX

Merged PR #18 adds bank-backed custody, LP ownership, authority, and canonical burns. Merged PR #19 adds exact genesis reconciliation plus every-block supply, escrow, reserve, and LP invariants.

🌐

Self-Organizing Domains

Communities organize into domains with custom governance rules, treasuries, and autonomous moderation.

🏦

Domain Treasury Bridge

Dual accounting connects x/bank user wallets with domain treasuries. Deposit, withdraw, and manage community funds on-chain.

🌍

IBC Cross-Chain

Transfer PNYX across any IBC-enabled Cosmos chain via ICS-20. Connect to Cosmos Hub, Osmosis, and beyond.

🛠️

Developer Tooling

Complete toolkit for building on TrueRepublic: 4 CosmWasm contract examples, shared bindings, and testing utilities with 26 Rust tests.

📱

Web Client

React client with wallet management, governance browser, DEX trading, disabled ZKP preview, admin dashboard, and network explorer. Built with TypeScript, Vite, CosmJS, and TailwindCSS.

How It Works

1

Create Domain

Establish a governance space for your community with custom rules and treasury.

2

Invite Members

Admin verifies and invites legitimate members to join the domain.

3

Submit Proposals

Members post suggestions using PayToPut to ensure quality content.

4

Vote & Earn

Rate proposals from -5 to +5 and earn PNYX for participation.

Use Cases

🗳️ Proxy Parties

  • Direct democracy within political organizations
  • Transparent member will representation
  • Bottom-up policy decisions

🏢 DAOs & Communities

  • Corporate governance
  • Investment DAOs
  • Community decision-making

🎯 Organizations

  • NGO coordination
  • Social movements
  • Cooperative management
PNYX
21M
Max PNYX Supply
1,388
Recovery-Verified Tests
22%
Rollout Checklist
Green
CI & Security
v0.4.0
Recovery Baseline

Built With Modern Tech

Cosmos SDK v0.50 CometBFT CosmWasm IBC (ibc-go v8) Groth16 ZKP React 18 + TypeScript Vite 8.1 CosmJS 0.39 TailwindCSS 3.4 Go 1.26.5 Rust 1,388 recovery-verified tests

Road to Rollout

The recovered v0.4 foundation is ready for continued engineering, not for production. These are the remaining blocking workstreams before any public-network rollout.

22%

Full rollout checklist

13 of 59 tracked items complete. The total includes the final exit gates, which remain open.

25%

Seven-phase work

13 of 51 phase tasks complete before the final go/no-go gates.

86%

Phase 6: Operations

6 of 7 tasks complete; production topology and private live evidence remain.

Phase 1

Network & Recovery

  • Verified and merged: failure, restart, catch-up, partitions, delayed peers, state sync, backup/restore, export/import, and app-hash agreement
  • Verified and merged: compatible binary replacement and fail-before-open rollback
  • Verified and merged: validator-key custody, single-signer failover, authenticated rotation, permanent revocation, and deterministic network policy
  • Governance-controlled state migration and partially applied migration recovery
Phase 2

ZKP & Privacy

  • Compatible real Groth16 client prover
  • Frozen circuit, inputs, encodings, and artifacts
  • Reproducible ceremony and key provenance
  • Private, front-running-safe reward binding
  • Independent cryptographic and privacy review
Phase 3

IBC & Protocol

  • Two-chain relayer, timeout, and recovery tests
  • Upgrade behavior across persisted state
  • Resolve or remove unsupported protocol stubs
  • Publish the exact supported feature boundary
Phase 4

Canonical Client

  • Retire or migrate legacy web and mobile clients
  • Transaction history and IBC transfer UX
  • Real audited ZKP flow and wallet-key hardening
  • Accessibility, browser, and performance budgets
Phase 5

Quality & Security

  • Raise DEX, governance, and root critical coverage
  • Client-to-chain end-to-end release tests
  • Property, fuzz, invariant, replay, and race tests
  • External review with zero open critical/high findings
Phase 6

Operations

  • 6 of 7 complete: liveness/readiness, secret-safe structured JSON logs, private metrics, an immutable dashboard with eleven tested alerts plus recovery/testnet objectives and role ownership, a strict synthetic incident rehearsal, and bounded four-validator capacity evidence
  • Qualified: strict synthetic topology and abuse-control contract (GH-89)
  • Verified and merged: incident, halt, validator, key, backup, restore, upgrade, and rollback runbook contract (GH-93)
  • Verified and merged: 96-transaction sustained-load, disk/log/RSS, retention, restart, and ledger contract (GH-97)
  • Verified and merged: secret-free digest-bound deployment-evidence envelope and offline verifier (GH-101); live deployment remains open
  • Next: private production deployment and live operator evidence
  • Production sizing, multi-day soak, and private-environment capacity evidence remain exit work
Phase 7

Release & Staged Launch

  • Reproducible signed binaries and containers
  • Checksums, SBOM, provenance, and release notes
  • Frozen chain ID, genesis, validators, and allocations
  • Private testnet, then public testnet or canary
  • Release freeze and explicit go/no-go approval

Rollout gate

No public-network rollout until every phase has linked evidence, the tagged release CI is green, no critical/high finding remains, disaster recovery is repeatable, the real ZKP flow is audited, operations are observable, and signed release artifacts are reproducible.

Full Rollout Checklist Track GitHub Issue #29

Development Roadmap

📜

v0.3.0 — Historical milestone

ZKP architecture, multi-asset DEX, IBC and CosmWasm surfaces; current approval is governed by the v0.4 recovery audit.

Not a production approval
🔄

v0.4.0 — Recovery audit active

Implemented React client surface under security, dependency, and integration verification. Legacy web/mobile clients are not approved for real keys.

Track issue #4
🔄

v0.4.1 — Planned

Real ZKP (gnark-wasm), Transaction History, IBC Transfers UI

Next Up
📋

v0.5.0 — Planned

Native Mobile Apps (iOS/Android)

🎯

v1.0.0 — Production

External audit, Mainnet Launch

Ready to Get Started?

Join the movement for true grassroots democracy

Launch Web Client Developer Docs Watch Podcast