Skip to content

fix: align fee split to resolved 28/25/45/2 across spec docs #69

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ToknWrks wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix: align fee split to resolved 28/25/45/2 across spec docs #69

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions docs/economics/token-economics-synthesis.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ The $REGEN token is transitioning from an inflationary proof-of-stake model to a
│ ▼ │ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
│ │ BURN POOL │ │ VALIDATOR │ │ COMMUNITY │ │ AGENT │ │ │
│ │ (30%) │ │ FUND (40%)│ │ POOL (25%)│ │ INFRA (5%)│ │ │
│ │ (28%) │ │ FUND (25%)│ │ POOL (45%)│ │ INFRA (2%)│ │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │ │
│ │ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │ │
Expand Down Expand Up @@ -106,10 +106,10 @@ poa_transition:

### Fee Distribution

- **30%** → Burn Pool (supply reduction)
- **40%** → Validator Fund (fixed compensation)
- **25%** → Community Pool (governance-directed)
- **5%** → Agent Infrastructure Fund
- **28%** → Burn Pool (supply reduction)
- **25%** → Validator Fund (fixed compensation)
- **45%** → Community Pool (governance-directed)
- **2%** → Agent Infrastructure Fund

---

Expand All @@ -119,7 +119,7 @@ poa_transition:
agent_infrastructure:
funding_sources:
- community_pool_grants
- registry_fee_allocation (5% of fees)
- registry_fee_allocation (2% of fees)
- partner_contributions

sustainability_target:
Expand Down
18 changes: 12 additions & 6 deletions phase-2/2.6-economic-reboot-mechanisms.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -226,27 +226,33 @@ For each fee-generating transaction:

#### Distribution Parameters

> **NOTE**: The WG has discussed two distribution models. Both are documented here for transparency; the WG must resolve which to adopt.
> **RESOLVED**: OQ-M013-1 has been resolved. The WG adopted a compromise between Model A and Model B. See `docs/governance/open-questions-resolution.md` and `docs/governance/economic-reboot-proposals.md` for the rationale.
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

While you've marked OQ-M013-1 as resolved here, several related documents are out of sync. To improve clarity and ensure consistent state definitions across the repository, please update the following:

  • mechanisms/m013-value-based-fee-routing/SPEC.md: Update the v0 default fee split and resolve the open question.
  • docs/governance/open-questions-resolution.md and docs/governance/economic-reboot-proposals.md: Update the status from NEEDS_GOVERNANCE to resolved.

Maintaining a single source of truth for these transitions prevents implementation ambiguity and aligns with the project's documentation standards.

References
  1. To improve document clarity, co-locate all state definitions and transitions within the primary state machine documentation, including definitions for edge-case flows like escalations.


**Model A** (from token-economics-synthesis.md):
**Resolved Distribution (28/25/45/2):**
| Pool | Share | Purpose |
|------|-------|---------|
| Burn Pool | 28% | Supply reduction via M012 |
| Validator Fund | 25% | Fixed compensation for authority validators |
| Community Pool | 45% | Governance-directed spending via M015 |
| Agent Infrastructure | 2% | AI agent operational costs (governance-directed) |

**Model A** (from token-economics-synthesis.md — superseded):
| Pool | Share | Purpose |
|------|-------|---------|
| Burn Pool | 30% | Supply reduction via M012 |
| Validator Fund | 40% | Fixed compensation for authority validators |
| Community Pool | 25% | Governance-directed spending |
| Agent Infrastructure | 5% | AI agent operational costs |

**Model B** (from Gregory's Network Coordination Architecture, forum/19#67):
**Model B** (from Gregory's Network Coordination Architecture, forum/19#67 — superseded):
| Pool | Share | Purpose |
|------|-------|---------|
| Burn Pool | 25-35% | Supply reduction via M012 |
| Validator Fund | 15-25% | Authority validator compensation |
| Community Pool | 50-60% | Contributor distribution via M015 |
| Agent Infrastructure | (included in Community Pool) | Not separated |

> **Note**: These are coordinated ranges — any valid configuration must satisfy Share Sum Unity (sum = 1.0). Not all combinations within ranges are valid. Example valid configurations: {25%, 15%, 60%}, {30%, 20%, 50%}, {35%, 15%, 50%}.

> **OQ-M013-1**: Which distribution model should be adopted? Model A provides a dedicated Agent Infrastructure fund; Model B routes a larger share through governance. A hybrid approach could use Model A's structure with Model B's community-weighted emphasis.
> ~~**OQ-M013-1**~~: **RESOLVED** — Hybrid model adopted: 28% burn, 25% validators, 45% community pool, 2% agent infrastructure.

> **OQ-M013-5**: Should the Burn Pool exist at all, and if so, at what share?
>
Expand Down