{"_id":"@claritydao/midnight-agora-contracts","_rev":"7-02b5dd17a1beb17a5c3f19a0bddf9434","name":"@claritydao/midnight-agora-contracts","dist-tags":{"latest":"2.1.0","next":"2.0.0"},"versions":{"0.1.0":{"name":"@claritydao/midnight-agora-contracts","version":"0.1.0","license":"Apache-2.0","_id":"@claritydao/midnight-agora-contracts@0.1.0","maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"dist":{"shasum":"62b5a1c14647598d73838c23c5811352511f1534","tarball":"https://registry.npmjs.org/@claritydao/midnight-agora-contracts/-/midnight-agora-contracts-0.1.0.tgz","fileCount":30,"integrity":"sha512-qXIkemw9uLFt8KRf55bvrPpSmTXgKdWx+HdXNJqSJ1Ra/72edEg+YUe7//O190K2UNWNPRzAQ0TP0iRSOhwxmw==","signatures":[{"sig":"MEUCIFsUryY9tmZGdPeMixiQ7i0O2HiAWU/jw4gt95MU6XBoAiEAi+M71NdxUYzptDAX9zcg6eWAv2LtC+VL/tDPFEjbzIU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":255089},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"2b5a6f135587cd4f5b4f983b67e9eb06e66a20d3","scripts":{"lint":"eslint src","test":"vitest run","build":"rm -rf dist && tsc --project tsconfig.build.json && cp -Rf ./src/managed ./dist/managed && cp ./src/contracts/DAO/Governor.compact ./dist","compact":"compactc src/contracts/DAO/Governor.compact src/managed/governor","typecheck":"tsc -p tsconfig.json --noEmit","test:compile":"npm run compact && vitest run","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"justinschreiner","email":"justin@clearcontracts.io"},"_npmVersion":"10.9.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","directories":{},"_nodeVersion":"23.3.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","fast-check":"^4.2.0","@vitest/coverage-v8":"3.2.4"},"_npmOperationalInternal":{"tmp":"tmp/midnight-agora-contracts_0.1.0_1768323707026_0.7342231566765505","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@claritydao/midnight-agora-contracts","version":"1.1.0","license":"Apache-2.0","_id":"@claritydao/midnight-agora-contracts@1.1.0","maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"dist":{"shasum":"c1b839b3ea5b46ab71641e6157d1337709559e4a","tarball":"https://registry.npmjs.org/@claritydao/midnight-agora-contracts/-/midnight-agora-contracts-1.1.0.tgz","fileCount":30,"integrity":"sha512-7rjvbVYsdVb4HDiPaHP3epzEdYBtz7mrAmrTFQ2X8vDT4kczupyWO+HBuZ9JUm1grECuBajdVEUhG99RQ/Hx3A==","signatures":[{"sig":"MEQCIAXpU2JIKdIMQluaGEmmeem71mRjo4ew2xeuz+LzkuUGAiBGq3GobSdfJvc4+kFjbXXIBD5eN3ZXmmBVoruOINoM9A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":255089},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"2b5a6f135587cd4f5b4f983b67e9eb06e66a20d3","scripts":{"lint":"eslint src","test":"vitest run","build":"rm -rf dist && tsc --project tsconfig.build.json && cp -Rf ./src/managed ./dist/managed && cp ./src/contracts/DAO/Governor.compact ./dist","compact":"compactc src/contracts/DAO/Governor.compact src/managed/governor","typecheck":"tsc -p tsconfig.json --noEmit","test:compile":"npm run compact && vitest run","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"justinschreiner","email":"justin@clearcontracts.io"},"_npmVersion":"10.9.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","directories":{},"_nodeVersion":"23.3.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","fast-check":"^4.2.0","@vitest/coverage-v8":"3.2.4"},"_npmOperationalInternal":{"tmp":"tmp/midnight-agora-contracts_1.1.0_1768341672823_0.08445066071075735","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@claritydao/midnight-agora-contracts","version":"1.1.1","license":"Apache-2.0","_id":"@claritydao/midnight-agora-contracts@1.1.1","maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"dist":{"shasum":"12618c622aa14069fff1c2d768fa3bbf5c5e8333","tarball":"https://registry.npmjs.org/@claritydao/midnight-agora-contracts/-/midnight-agora-contracts-1.1.1.tgz","fileCount":357,"integrity":"sha512-LdJ0Huoc8VwQBHY4fLdGsgiq7Ybax8C3ZX5SyuZ7MUjviXCb0x7Fr9KIlYGF3beFAmhGqaBto4gRhMFrb9hKkA==","signatures":[{"sig":"MEQCIF1HSb7KFNibv/REEkHK8HiFeLgk7CR+H7kqkPLz/QaUAiA+vhOu+TBEXrwJJfVtPbDqn8iDvOHV5LRW/J323nGbwg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":193006884},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"2b5a6f135587cd4f5b4f983b67e9eb06e66a20d3","scripts":{"lint":"eslint src","test":"vitest run","build":"rm -rf dist && tsc --project tsconfig.build.json && cp -Rf ./src/managed ./dist/managed && cp ./src/contracts/DAO/Governor.compact ./dist","compact":"compactc src/contracts/DAO/Governor.compact src/managed/governor","typecheck":"tsc -p tsconfig.json --noEmit","test:compile":"npm run compact && vitest run","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"justinschreiner","email":"justin@clearcontracts.io"},"_npmVersion":"10.9.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","directories":{},"_nodeVersion":"23.3.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","fast-check":"^4.2.0","@vitest/coverage-v8":"3.2.4"},"_npmOperationalInternal":{"tmp":"tmp/midnight-agora-contracts_1.1.1_1768342106845_0.2465652731327097","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@claritydao/midnight-agora-contracts","version":"1.2.0","license":"Apache-2.0","_id":"@claritydao/midnight-agora-contracts@1.2.0","maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"dist":{"shasum":"2987e89f04f9e761328fa2c8bcb4afa8a3edfb09","tarball":"https://registry.npmjs.org/@claritydao/midnight-agora-contracts/-/midnight-agora-contracts-1.2.0.tgz","fileCount":220,"integrity":"sha512-XCAplPNvfn7eE4UAuY9Z1Uw/iazDxatUrvbukmjAiY9JJlJ/kcMr4SMaRf9LttiqnNPPy9z+zUU9sY/cqeHjeA==","signatures":[{"sig":"MEQCIG3xDckS7f7qGAvXdykAKsCOIn6nHUzf505teU3UMRKkAiAsSwgPR+U7pis+EgHTrKmDSZ6Nm54B1FDKkwSYuqw3MQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92948004},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"e54b119f367289fb137245909efb14a3a2c9823b","scripts":{"lint":"eslint src","test":"vitest run","build":"npm run compact && rm -rf dist && tsc --project tsconfig.build.json && cp -Rf ./src/managed ./dist/managed && cp ./src/contracts/DAO/Governor.compact ./dist","compact":"node scripts/build-profiles.mjs","typecheck":"tsc -p tsconfig.json --noEmit","test:compile":"npm run compact && vitest run","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"justinschreiner","email":"justin@clearcontracts.io"},"_npmVersion":"11.15.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","directories":{},"_nodeVersion":"20.19.3","dependencies":{"@midnight-ntwrk/compact-js":"2.5.0","@midnight-ntwrk/compact-runtime":"0.16.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","fast-check":"^4.2.0","@vitest/coverage-v8":"3.2.4","@midnight-ntwrk/ledger-v8":"8.0.3","@midnight-ntwrk/midnight-js-network-id":"4.0.4"},"_npmOperationalInternal":{"tmp":"tmp/midnight-agora-contracts_1.2.0_1783350545461_0.3169969269280568","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@claritydao/midnight-agora-contracts","version":"1.3.0","license":"Apache-2.0","_id":"@claritydao/midnight-agora-contracts@1.3.0","maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"dist":{"shasum":"23e35cb789085786cc3aa373a6302d860491eccc","tarball":"https://registry.npmjs.org/@claritydao/midnight-agora-contracts/-/midnight-agora-contracts-1.3.0.tgz","fileCount":204,"integrity":"sha512-V3A9mk9SsACMNAFcmwkTsxLl9A+D1EgHneOuyonSQbqs9aHphxjJLaxTZRgbJrnaWRqKdD05lBKX0LaGY8Ytlg==","signatures":[{"sig":"MEQCIBfm5kBFBCN+Wvr9JsA9PDEOaqGfo83VC0S9YzxaZJWSAiAQT1+cN6t7/AkRsAmD++pWAru4Arqk5D9imHvuGvtaZA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":109021232},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"f21007fe4b42aaa567b7209143f5ab384e36ae5c","scripts":{"lint":"eslint src","test":"vitest run","build":"npm run compact && rm -rf dist && tsc --project tsconfig.build.json && cp -Rf ./src/managed ./dist/managed && cp ./src/contracts/DAO/Governor.compact ./dist","compact":"node scripts/build-profiles.mjs","typecheck":"tsc -p tsconfig.json --noEmit","test:compile":"npm run compact && vitest run","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"justinschreiner","email":"justin@clearcontracts.io"},"_npmVersion":"11.15.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","directories":{},"_nodeVersion":"20.19.3","dependencies":{"@midnight-ntwrk/compact-js":"2.5.1","@midnight-ntwrk/compact-runtime":"0.16.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^3.2.4","fast-check":"^4.2.0","@vitest/coverage-v8":"3.2.4","@midnight-ntwrk/ledger-v8":"8.1.0","@midnight-ntwrk/midnight-js-network-id":"4.1.1"},"_npmOperationalInternal":{"tmp":"tmp/midnight-agora-contracts_1.3.0_1787854696086_0.2792872227487526","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@claritydao/midnight-agora-contracts","version":"2.0.0","license":"Apache-2.0","_id":"@claritydao/midnight-agora-contracts@2.0.0","maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"dist":{"shasum":"7f9471633e4de0b8d8d614037549054aa6347373","tarball":"https://registry.npmjs.org/@claritydao/midnight-agora-contracts/-/midnight-agora-contracts-2.0.0.tgz","fileCount":188,"integrity":"sha512-TKgA/msoEggbeRqEXOcOZP72yh+x4/3tINo0j6uwnuUhloU0KBKiGbAC54KTQ98gIVOiEsDWVPKOIvl1Z17RGQ==","signatures":[{"sig":"MEYCIQDu3oepCulC2z48g/sEQOfLiOZUW5TVYP80dwz3zltFSgIhAOqD3sVR5DtjlEavETvmUlTWg7Ia+ByWbMNJKUbvBtvf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIAiV7WCf8uuA1tr9WqX51E4Yh0qyhkT8TVAPJ/0R9gLgAiBgxVJam52XArHvyAhO1U0kPnq38oeYxAdmlu1yDu/wJA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":105634469},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"caf00391e2b63ae9ff077684206ee64e5a0c0942","scripts":{"lint":"eslint src","test":"vitest run","build":"npm run compact && rm -rf dist && tsc --project tsconfig.build.json && cp -Rf ./src/managed ./dist/managed && cp ./src/contracts/DAO/Governor.compact ./dist","compact":"node scripts/build-profiles.mjs","typecheck":"tsc -p tsconfig.json --noEmit","test:compile":"npm run compact && vitest run","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"justinschreiner","email":"justin@clearcontracts.io"},"_npmVersion":"11.15.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","directories":{},"_nodeVersion":"20.19.3","dependencies":{"@midnight-ntwrk/compact-js":"2.5.1","@midnight-ntwrk/compact-runtime":"0.16.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^3.2.4","fast-check":"^4.2.0","@vitest/coverage-v8":"3.2.4","@midnight-ntwrk/ledger-v8":"8.1.0","@midnight-ntwrk/midnight-js-network-id":"4.1.1"},"_npmOperationalInternal":{"tmp":"tmp/midnight-agora-contracts_2.0.0_1789409085559_0.9180203392398962","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"_id":"@claritydao/midnight-agora-contracts@2.1.0","dist":{"shasum":"1780036931a15155a8519dffb00dfffcd0425bc5","tarball":"https://registry.npmjs.org/@claritydao/midnight-agora-contracts/-/midnight-agora-contracts-2.1.0.tgz","fileCount":188,"integrity":"sha512-Fx6nsCTrgZnrAKwK3/lbMJ+DsKk64USzZrEQW/B3AveoksYhXQzV8/Bqs21lucE+sDrrAYWWPUj4xbCdHvdhcg==","signatures":[{"sig":"MEQCIB53Ty3aqFIDkZkRxYC3xuD8DPd5MdmjimJZMtH+lGbNAiArqOtr5a232dBkSF8xqhLasMu7idFJzGTlYkLHx++1Lg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHhJvG45fW5yIcd35Qn/cqLQHcN8WBdg73N2ul3ehE6zAiB8U04NODYfS0PXNnzRecP5Q9VaAEwYR7YKKmetTyK7sw=="}],"unpackedSize":105624099},"main":"dist/index.js","name":"@claritydao/midnight-agora-contracts","type":"module","types":"./dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"8c8bd20fb49b75514f6ff51739cbaf9f38317eab","license":"Apache-2.0","scripts":{"lint":"eslint src","test":"vitest run","build":"npm run compact && rm -rf dist && tsc --project tsconfig.build.json && cp -Rf ./src/managed ./dist/managed && cp ./src/contracts/DAO/Governor.compact ./dist","compact":"node scripts/build-profiles.mjs","typecheck":"tsc -p tsconfig.json --noEmit","test:compile":"npm run compact && vitest run","test:coverage":"vitest run --coverage"},"version":"2.1.0","_npmUser":{"name":"justinschreiner","email":"justin@clearcontracts.io"},"_npmVersion":"11.15.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","directories":{},"maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"_nodeVersion":"20.19.3","dependencies":{"@midnight-ntwrk/compact-js":"2.5.1","@midnight-ntwrk/compact-runtime":"0.16.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","fast-check":"^4.2.0","@vitest/coverage-v8":"3.2.4","@midnight-ntwrk/ledger-v8":"8.1.0","@midnight-ntwrk/midnight-js-network-id":"4.1.1"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/midnight-agora-contracts_2.1.0_1789675964114_0.4767092239412962"}}},"time":{"created":"2026-01-13T17:01:46.882Z","modified":"2026-09-17T20:12:45.548Z","0.1.0":"2026-01-13T17:01:47.167Z","1.1.0":"2026-01-13T22:01:12.976Z","1.1.1":"2026-01-13T22:08:31.084Z","1.2.0":"2026-07-06T15:09:06.656Z","1.3.0":"2026-08-27T18:18:17.486Z","2.0.0":"2026-09-14T18:04:46.825Z","2.1.0":"2026-09-17T20:12:45.359Z"},"license":"Apache-2.0","description":"A comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions throu","maintainers":[{"name":"justinschreiner","email":"justin@clearcontracts.io"},{"name":"mikekeke","email":"mikhail@mlabs.city"},{"name":"t4ccer","email":"t4ccer@gmail.com"},{"name":"goldie-laux","email":"mlaux6@outlook.com"},{"name":"rmgaray","email":"ramiro@mlabs.city"}],"readme":"# Agora DAO - Smart Contracts\n\nA comprehensive decentralized autonomous organization (DAO) governance system implemented in Compact for the Midnight blockchain. This module contains all smart contracts that enable stakeholders to propose, vote on, and execute governance decisions through a decentralized, privacy-preserving, and trustless process.\n\n## 🏗️ Architecture\n\nThe Agora DAO system is built with a modular architecture, separating concerns across multiple Compact modules:\n\n### Contract Structure\n\n```\n/src\n├── contracts/\n│   ├── DAO/\n│   │   ├── Governor.compact        # Main governance coordinator\n│   │   ├── StakeModule.compact     # Stake management and delegation\n│   │   ├── ProposalModule.compact  # Proposal lifecycle and voting\n│   │   ├── EffectModule.compact    # Effect execution and processing\n│   │   └── TreasuryModule.compact  # Treasury management and controls\n│   ├── utils/\n│   │   ├── TypesModule.compact     # Shared data structures and enums\n│   │   ├── Utils.compact           # Common utility functions\n│   │   ├── Initializable.compact   # Initialization control pattern\n│   │   └── Pausable.compact        # Emergency pause functionality\n│   └── fungibleToken/\n│       └── FungibleToken.compact   # Token implementation\n├── test/\n│   ├── governance-simulator.ts     # Local testing simulator\n│   └── governor-contract.test.ts   # Comprehensive test suite\n└── witnesses.ts                    # Private state management\n```\n\n## 📋 Core Contracts\n\n> 📋 **Complete Technical Documentation**: See [Contract Documentation](../docs/CONTRACT_DOCUMENTATION.md) for detailed specifications of all smart contracts, circuits, and data structures.\n\n### 1. Governor Contract (`Governor.compact`)\n**Purpose**: Central orchestrator for all governance operations\n\n**Key Circuits:**\n- `createProposalWithEffect()` - Submit governance proposals with effects\n- `castVoteWithValidation()` - Cast votes with ZK proof verification\n- `finalizeProposalWithValidation()` - Finalize proposals after voting\n- `queueProposalWithValidation()` - Queue proposals for execution\n- `executeEffectWithValidation()` - Execute approved effects\n\n**State Management:**\n- `governorConfig` - Governance parameters and thresholds\n- `activeProposalCount` - Active proposal tracking\n- `queuedProposalCount` - Queued proposal tracking\n- `governorConfig` is updated only by successfully executed governance proposals.\n\n### 2. StakeModule Contract (`StakeModule.compact`)\n**Purpose**: Manages user stakes and voting power calculation\n\n**Key Circuits:**\n- `registerStakeWithValidation()` - Register user stakes\n- `withdrawStakeWithValidation()` - Withdraw stakes with validation\n- `delegateStakeWithValidation()` - Delegate voting power\n- `getStakeInfo()` - Query stake information\n- `hasProposalThreshold()` - Check proposal creation eligibility\n\n**State Management:**\n- `stakes` - Individual user stake records\n- `delegations` - Delegation mappings\n- `totalStakes` - Aggregate stake totals\n- `governanceConfig` - Staking parameters\n\n### 3. ProposalModule Contract (`ProposalModule.compact`)\n**Purpose**: Handles complete proposal lifecycle from creation to execution\n\n**Proposal States:**\n- **Active** → **Succeeded/Defeated** → **Queued** → **Executed**\n\n**Key Circuits:**\n- `createProposal()` - Create new governance proposals\n- `castVote()` - Record votes with double-vote prevention\n- `finalizeProposal()` - Calculate results and update status\n- `getProposal()` - Query proposal details and status\n\n**State Management:**\n- `proposals` - Proposal records with full lifecycle data\n- `voteRecords` - Individual vote records\n- `proposalCounter` - Unique proposal ID generation\n\n### 4. EffectModule Contract (`EffectModule.compact`)\n**Purpose**: Processes and executes governance effects\n\n**Effect Types:**\n- **MintToken**: Create new tokens for treasury\n- **Transfer**: Move tokens between accounts\n- **UpdateConfig**: Modify governance parameters\n\n**Key Circuits:**\n- `createEffect()` - Create executable effects\n- `executeEffect()` - Execute approved effects\n- `cancelEffect()` - Cancel pending effects\n- `batchExecuteEffects()` - Execute multiple effects\n\n### 5. TreasuryModule Contract (`TreasuryModule.compact`)\n**Purpose**: Manages DAO treasury operations and fund controls\n\n**Key Circuits:**\n- `depositToTreasury()` - Add funds to treasury\n- `withdrawFromTreasury()` - Remove funds with approval\n- `getTreasuryBalance()` - Query treasury balances\n- `transferTreasuryTokens()` - Internal treasury transfers\n\n**State Management:**\n- `treasuryBalances` - Multi-token balance tracking\n- `treasuryTransactions` - Complete transaction history\n- `treasuryStatistics` - Aggregate treasury metrics\n\n## 🔄 Governance Workflow\n\nThe complete governance process follows this workflow:\n\n```mermaid\nflowchart TD\n  A[Register Stake] --> B[Create Proposal]\n  B --> C[Voting Period]\n  C --> D[Finalize Proposal]\n  D --> E[Queue for Execution]\n  E --> F[Execute Effects]\n  F --> G[Update Treasury/Config]\n  \n  style A fill:#e1f5fe\n  style B fill:#f3e5f5\n  style C fill:#fff3e0\n  style D fill:#e8f5e8\n  style E fill:#fff8e1\n  style F fill:#fce4ec\n  style G fill:#f1f8e9\n```\n\n### Complete Governance Process\n\n1. **Stake Registration** (`registerStakeWithValidation`)\n   - Users register stake to gain voting power\n   - ZK proof validates stake ownership\n   - Minimum stake requirements enforced\n\n2. **Proposal Creation** (`createProposalWithEffect`)\n   - Users with sufficient stake create proposals\n   - Proposals linked to executable effects\n   - Timing parameters set (voting start/end)\n\n3. **Voting Period** (`castVoteWithValidation`)\n   - Community votes on active proposals\n   - Stake-weighted voting power\n   - Double-vote prevention enforced\n\n4. **Proposal Finalization** (`finalizeProposalWithValidation`)\n   - Vote tallying and result calculation\n   - Status transition (Succeeded/Defeated)\n   - Quorum and threshold validation\n\n5. **Execution Queue** (`queueProposalWithValidation`)\n   - Successful proposals queued for execution\n   - Execution delay enforced for security\n   - Admin approval mechanisms\n\n6. **Effect Execution** (`executeEffectWithValidation`)\n   - Approved effects executed with proofs\n   - Treasury operations performed\n   - Configuration updates applied\n\n7. **State Updates**\n   - Treasury balances updated\n   - Governance parameters modified\n   - Transaction history recorded\n\n## 🔐 Security Features\n\n> 📋 **Complete Security Documentation**: See [Contract Documentation](../docs/CONTRACT_DOCUMENTATION.md#security-model) for detailed security model and threat analysis.\n\n### Zero-Knowledge Proof Security\n- **ProofOfStake**: Validates stake ownership without revealing amounts\n- **ProofOfGovernorApproval**: Authorizes governance actions with privacy\n- **ProofOfEffectExecution**: Validates execution rights securely\n- **Nonce-based Replay Protection**: Prevents proof reuse attacks\n\n### Access Control Framework\n- **Stake-weighted Voting**: Voting power proportional to stake\n- **Proposal Thresholds**: Minimum stake required for proposal creation\n- **Admin Permissions**: Role-based access for critical operations\n- **Time-locked Execution**: Security delays before effect execution\n- **Emergency Controls**: Veto mechanisms for critical situations\n\n### Anti-Manipulation Safeguards\n- **Double-vote Prevention**: Cryptographic prevention of vote duplication\n- **Proposal Lifetime Limits**: Time bounds prevent stale proposals\n- **Quorum Requirements**: Minimum participation for valid decisions\n- **Voting Period Enforcement**: Strict timing for proposal phases\n- **Effect Validation**: Comprehensive validation before execution\n- **Treasury Protection**: Multi-layered spending controls\n\n## 📊 Key Features\n\n### Configurable Governance Parameters\n- **Voting Period**: `300s` (5 minutes for testing) - Duration for proposal voting\n- **Quorum Threshold**: `100,000` tokens - Minimum participation required\n- **Proposal Threshold**: `50,000` tokens - Minimum stake to create proposals\n- **Proposal Lifetime**: `86,400s` (1 day) - Maximum proposal validity\n- **Execution Delay**: `60s` (1 minute) - Security delay before execution\n- **Grace Period**: `300s` (5 minutes) - Window for effect execution\n- **Emergency Veto**: Community override with higher threshold\n\n### Effect Action Types\n- **MintToken** (`EffectActionType.MintToken`)\n  - Create new tokens for treasury or recipients\n  - Configurable amounts and recipients\n  - Treasury balance tracking\n  \n- **Transfer** (`EffectActionType.Transfer`)\n  - Move tokens between accounts\n  - Treasury to external transfers\n  - Multi-token support\n  \n- **UpdateConfig** (`EffectActionType.UpdateConfig`)\n  - Modify governance parameters\n  - Update thresholds and periods\n  - Admin permission changes\n\n### Advanced Treasury Features\n- **Multi-token Support**: Handle various token types\n- **Balance Tracking**: Real-time treasury monitoring\n- **Transaction History**: Complete audit trail\n- **Spending Controls**: Authorized withdrawal limits\n- **Emergency Freeze**: Pause capabilities for security\n- **Statistics Tracking**: Usage and performance metrics\n\n## 🧪 Testing & Validation\n\n> 📋 **Complete Test Documentation**: See [Test Scenarios and Results](../docs/TEST_SCENARIOS_AND_RESULTS.md) for comprehensive testing analysis and results.\n\n### Test Coverage\n- **Unit Tests**: 95.8% function coverage (137/143 functions)\n- **Integration Tests**: Real blockchain interaction testing\n- **Fuzz Testing**: Property-based testing with random inputs\n- **Edge Cases**: Boundary conditions and error scenarios\n\n### Test Results\n- **Total Tests**: 125 tests across unit and integration suites\n- **Success Rate**: 99.2% (124/125 tests passing)\n- **Execution Time**: ~47 minutes total (~45 min integration due to blockchain)\n- **Coverage**: 95.1% overall code coverage\n\n### Testing Infrastructure\n- **GovernanceSimulator**: Local contract testing without blockchain\n- **Integration Environment**: Real testnet interaction\n- **Automated Testing**: Continuous validation pipeline\n- **Performance Monitoring**: Load and stress testing\n\n## 🛠️ Implementation Notes\n\n### Compact Language Features\n- **Ledger State**: Persistent on-chain state storage\n- **Pure Circuits**: ZK-proof-enabled functions with validation\n- **Witness Functions**: Private input handling for proofs\n- **Structs and Enums**: Type-safe data structures\n- **Vector<N, T>**: Fixed-size array operations\n- **Map<K, V>**: Key-value state storage\n- **Assert Statements**: Validation and constraint enforcement\n\n### Architecture Principles\n- **Modularity**: Clear separation of concerns across contracts\n- **Composability**: Contracts work together seamlessly\n- **Type Safety**: Strict typing prevents runtime errors\n- **ZK-Native**: Built-in zero-knowledge proof integration\n- **Configurable**: Parameter-driven governance customization\n- **Upgradeable**: Admin-controlled configuration updates\n\n## 🚀 Usage Examples\n\n### Complete Governance Flow Example\n\n#### 1. Register Stake\n```compact\n// User registers stake to participate in governance\nregisterStakeWithValidation(\n  userId,\n  50000, // 50K tokens\n  ProofOfStake {\n    userId: userId,\n    amount: 50000,\n    nonce: randomNonce\n  }\n);\n```\n\n#### 2. Create Proposal with Effects\n```compact\n// Create proposal with multiple effects\nconst actions = Vector<10, EffectAction> {\n  EffectAction {\n    typ: EffectActionType.MintToken,\n    token: treasuryToken,\n    amount: 10000,\n    to: developmentFund,\n    configKey: emptyBytes,\n    configValue: emptyBytes\n  },\n  EffectAction {\n    typ: EffectActionType.Transfer,\n    token: treasuryToken,\n    amount: 5000,\n    to: marketingFund,\n    configKey: emptyBytes,\n    configValue: emptyBytes\n  }\n  // ... up to 10 actions\n};\n\nconst proposalId = createProposalWithEffect(\n  creatorUserId,\n  \"Treasury Allocation Q1\",\n  \"Allocate funds for development and marketing\",\n  actions,\n  ProofOfStake { userId: creatorUserId, amount: 50000, nonce: randomNonce },\n  currentTime, // voting start\n  currentTime + 300 // voting end (5 minutes)\n);\n```\n\n#### 3. Cast Votes\n```compact\n// Multiple users vote on the proposal\ncastVoteWithValidation(\n  proposalId,\n  voter1UserId,\n  VoteChoice.For,\n  ProofOfStake { userId: voter1UserId, amount: 75000, nonce: randomNonce }\n);\n\ncastVoteWithValidation(\n  proposalId,\n  voter2UserId,\n  VoteChoice.Against,\n  ProofOfStake { userId: voter2UserId, amount: 25000, nonce: randomNonce }\n);\n```\n\n#### 4. Execute Governance Pipeline\n```compact\n// After voting period ends, finalize proposal\nfinalizeProposalWithValidation(proposalId);\n\n// Queue for execution with delay\nqueueProposalWithValidation(proposalId);\n\n// Execute effects after delay period\nexecuteEffectWithValidation(\n  effectId,\n  ProofOfGovernorApproval {\n    proposalId: proposalId,\n    effectId: effectId,\n    approvalTime: currentTime,\n    nonce: randomNonce\n  }\n);\n```\n\n## 🔧 Development & Deployment\n\n### Build & Test Commands\n```bash\n# Install dependencies\nnpm install\n\n# Build contracts\nnpm run build\n\n# Run unit tests\nnpm test\n\n# Run unit tests with coverage\nnpm run test:coverage\n\n# Clean build artifacts\nnpm run clean\n```\n\n### Development Status\n\n✅ **Completed Components**:\n- [x] All core governance contracts (Governor, Stake, Proposal, Effect, Treasury)\n- [x] Comprehensive type system and utilities\n- [x] Zero-knowledge proof integration\n- [x] Complete test suite with 95.8% coverage\n- [x] Local testing simulator\n- [x] Integration test infrastructure\n- [x] CLI interface for contract interaction\n\n✅ **Quality Assurance**:\n- [x] Unit testing (95.8% function coverage)\n- [x] Integration testing (real blockchain interaction)\n- [x] Fuzz testing (property-based validation)\n- [x] Edge case testing (boundary conditions)\n- [x] Performance testing (load and stress tests)\n\n### Production Readiness\n- **Security**: ZK-proof validation, access controls, time locks\n- **Testing**: Comprehensive test suite with high coverage\n- **Documentation**: Complete technical and API documentation\n- **Performance**: Optimized for Midnight blockchain efficiency\n- **Monitoring**: Built-in metrics and audit trails\n\n## 📚 Documentation\n\n### Contract-Specific Documentation\n- **[Technical Specifications](../docs/CONTRACT_DOCUMENTATION.md)**: Detailed contract architecture\n- **[Test Results](../docs/TEST_SCENARIOS_AND_RESULTS.md)**: Comprehensive testing analysis\n- **[Module Details](../docs/MODULE_DOCUMENTATION.md)**: CLI and component documentation\n\n### Getting Started\n1. **Setup**: Install dependencies and build contracts\n2. **Testing**: Run unit and integration test suites\n3. **Deployment**: Use CLI for contract deployment\n4. **Interaction**: Use provided API for governance operations\n\n## 📄 License\n\nMIT License - see [LICENSE](../LICENSE) file for details.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Add comprehensive tests for new functionality\n4. Ensure all tests pass with high coverage\n5. Update documentation as needed\n6. Submit a pull request\n\n**Code Standards**: Follow established Compact patterns, maintain type safety, and ensure ZK-proof integration for all governance operations.\n","readmeFilename":"README.md"}