System, not just files

On-chain architecture graph

Each box is a module grouping one or more contracts. Columns encode lifecycle; rows encode the rail the module belongs to. Hover a module to see how the system is wired.

7 modules 3 main flows Full-screen, no libs

Module / rail

Signals & anchors

Reputation & stake

Assets & rights

Governance & enforcement

Indexes & signals

Signals & Indexes module

• DocsHashRegistry
• IndexHashRegistry
• IndexParams

Anchors and parameterisation for all paradox indexes.

Reputation & contributors

Reputation & Contributors module

• ContributorRegistry
• ParadoxStaking

Who you are, what you staked, and how much your vote should matter.

Assets & NFTs

Assets & Rights module

• ParadoxNFT
• ParadoxToken
• Warrants

The paradox assets on-chain and the warrants that grant rights.

Governance core

Governance Core module

• GovernanceToken
• ParadoxVotes
• DAOGovernor
• ParadoxTimelock

Who votes, how proposals pass, and which modules the timelock can mutate.

Oracles & ZK

ZK & Signals bridge

• ZKAdapters

Brings ZK-proven signals into the index layer.

Oracle bridge module

• ParadoxOracleBridge

Connects external verdicts and feeds into governance & disputes.

Safety & disputes

Disputes module

• DisputeResolution

Where paradoxes get frozen, unwound or disputed based on facts.

Legacy & mocks

Legacy & Test module

• LegacyGovernanceToken
• ParadoxVotes v1 / GovernanceRules
• MockDocsRegistry
• MockWarrants

Contracts that used to simulate or govern the system but are no longer on the live surface.

Asset lifecycle

Signals & Indexes→ Assets & Rights→ Governance Core

Governance pipeline

Warrants→ GovernanceToken & ParadoxVotes→ DAOGovernor→ ParadoxTimelock→ Mutable modules

Dispute pipeline

Signals & Indexes+ Reputation+ Oracles & ZK→ Disputes module→ Assets & Rights