CouncilNFT / MasterNFT Governance

The CouncilNFT and MasterNFT system defines the on-chain governance framework for the TRN platform. Together, they orchestrate proposal creation, veto logic, upgrade approval, and userwide voting—all while preserving the decentralized ethos and ensuring accountability through token-weighted and role-restricted processes.

---

⚙️ Governance Hierarchy Overview

scssCopyEdit                    ┌───────────────────┐
                    │    MasterNFT      │
                    │   (1 holder max)  │
                    └────────▲──────────┘
                             │
        ┌────────────────────┴─────────────────────┐
        │                                          │
┌───────────────┐                         ┌────────────────┐
│ CouncilNFT(s) │  (multi-seat council)  │   ProposalFactory │
└───────────────┘                         └────────────────┘
        │                                          │
        └──────────────┬───────────────────────────┘
                       ▼
              ┌────────────────┐
              │  Public Voters │  (1 TRN = 1 vote per proposal)
              └────────────────┘

---

🛡️ MasterNFT

The MasterNFT is the highest authority in the governance model.

Key Capabilities:

• Veto Power: Can override any Council-approved proposal before it reaches the public.

• Emergency Controls: Can trigger platform-level freeze or recovery mechanisms in critical scenarios.

• DAO Configuration: May adjust DAO-wide settings (e.g., fee splits, stability pool activation threshold, moderation policy toggles).

• Immutable Ownership: Meant to be held by a highly trusted multisig or governance contract.

Restrictions:

• Only one MasterNFT can exist at any time.

• It cannot create proposals directly—it can only veto, approve, or execute critical changes.

---

👥 CouncilNFT

The CouncilNFTs represent elected or appointed governance members. These holders act as the filtering layer between proposal creation and public execution.

Key Capabilities:

• Proposal Review: Can approve or reject proposals created through the ProposalFactory.

• Veto Check: If the Council passes a proposal, the MasterNFT has a brief window to veto it.

• DAO Settings Governance: Can vote on internal toggles such as:

  • StabilityVault activation threshold

  • Vault lock timers

  • Global parameter updates

Seat Flexibility:

• The DAO may configure the number of active CouncilNFTs.

• Voting thresholds may be fixed or dynamic based on participation.

---

🗳️ Public Voters

Once a proposal clears both CouncilNFT and MasterNFT review, it proceeds to the public voting stage.

• Eligibility: Any wallet may vote by spending 1 TRN per vote, per proposal.

• Voting Finality: Each TRN spent is non-refundable—users pay to vote.

• Vote Tallying: Winning proposals are executed automatically or scheduled for a future block, depending on type.

This ensures spam prevention and incentivizes only meaningful community participation.

---

🏗️ ProposalFactory

The ProposalFactory is the smart contract used to initiate new DAO proposals.

• Submission Rules: Anyone may create a proposal by paying a configurable fee (TBD or fixed).

• Proposal Types:

  • DAO config updates

  • Funding allocations

  • Feature upgrades

  • Moderation policy changes

• Routing: All proposals pass through this contract → Council → Master → Public.

---

🔐 Governance Safeguards

Mechanism	Description
MasterNFT Veto	Final stop before a bad proposal hits the chain
Council Vote Threshold	Requires quorum and majority approval before progression
TRN-Paid Voting	Prevents spam, sybil abuse, and incentivizes only committed voters
Immutable Voting Trails	All voting, proposal creation, and execution logs are stored on-chain
Burnable TRN	Votes cost real tokens—ensures economic weight backs each decision

---

🔄 Proposal Lifecycle

1. Create Proposal

   • Submitted via ProposalFactory

   • Fee may apply

2. Council Review

   • CouncilNFTs approve or reject

3. Master Review

   • Can veto; if not, proceeds

4. Public Vote

   • 1 TRN = 1 vote (non-refundable)

5. Execution

   • Passed proposals are executed on-chain

   • Vaults, splits, limits, and platform behavior can be modified

---

📋 Example Use Cases

Scenario	Proposal Type	Final Approval Path
Change Lotto rewards split	DAO Setting Update	Council → Master → Public
Increase max boost cycle	Platform Behavior Update	Council → Master → Public
Adjust AMM stability pool trigger	Economic Setting Update	Council → Master → Public
Flag abuse pattern for global ban	Moderation Policy Update	Council + Master only

---

🧠 Key Philosophies

• Simplicity: One TRN = one vote. No weight-staking or vote delegation required.

• Finality: Once a vote is cast, it's final and economically meaningful.

• Trust Layers: Multiple stages prevent bad actors from hijacking the platform.

• Auditability: All actions are traceable to wallet addresses and NFTs.

---

🔎 Suggested File References

• ProposalFactory.sol

• CouncilNFT.sol

• MasterNFT.sol

• GovernanceRouter.sol

• TRNVoteLedger.sol