jeffemmett
/
TEC-analysis
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add retrospective synthesis + markwhen timeline generator 

- docs/synthesis.md: full TEC post-mortem analysis (Hatch through shutdown, ABC/CV dynamics, treasury, death-spiral narrative)
- scripts/gen_timeline.py: generator that mines cv_proposals.csv and macro events into a markwhen .mw file, renders as interactive timeline + calendar HTML
- .gitleaksignore: allowlist public TEC token contract address (false positive)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jeff Emmett 2026-04-16 16:15:14 -04:00
parent d9d73284cb
commit 434cec1311
3 changed files with 486 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.gitleaksignore Normal file
View File

@ -0,0 +1,2 @@
# Public on-chain addresses referenced in synthesis — not secrets.
docs/synthesis.md:generic-api-key:314

346
docs/synthesis.md Normal file
View File

@ -0,0 +1,346 @@
# The Token Engineering Commons: A Mechanism Post-Mortem
*An empirical analysis of the TEC's augmented bonding curve, conviction voting, and treasury dynamics from Hatch to shutdown (2021–2025).*
---
## 1. Introduction
The Token Engineering Commons (TEC) was one of the most ambitious experiments in applied token engineering: a DAO that deployed an [Augmented Bonding Curve](https://forum.tecommons.org/t/augmented-bonding-curve-an-introduction-to-the-abc/497) (ABC) as its primary market, feeding a Common Pool governed by [Conviction Voting](https://forum.tecommons.org/t/conviction-voting-tl-dr/308) (CV), with the goal of creating a self-sustaining funding engine for public goods in the token engineering field.
The system operated on Gnosis Chain from January 2022 to December 2023, then migrated to Optimism, and was [formally voted to shut down on November 4, 2025](https://forum.tecommons.org/t/tec-shutdown-proposal/1520). This document synthesizes on-chain data analysis across five dimensions — conviction voting, treasury flows, mechanism sustainability, ABC market dynamics, and token distribution — to evaluate what worked, what didn't, and why.
### The Design Thesis
The TEC's core mechanism loop was elegant in theory:
```
New participants buy TEC via ABC
→ Entry tribute (%) flows to Common Pool
→ Conviction Voting allocates Common Pool to grants
→ Grants create value in the TE ecosystem
→ Value attracts new participants → cycle repeats
```
**The central finding of this analysis is that the feedback loop never achieved self-sustainability.** Tribute inflows consistently fell short of grant outflows, the Common Pool functioned as a drawdown fund rather than a renewable one, and exogenous market shocks (Terra/Luna, FTX) accelerated a decline that the mechanisms were not designed to withstand.
---
## 2. Origins: The Hatch & Commons Upgrade
The TEC began with a [Hatch](https://forum.tecommons.org/t/the-hatch-tl-dr/272) — a fundraising phase restricted to Trusted Seed members. The [Hatch closed on August 11, 2021](https://medium.com/token-engineering-commons/the-hatch-was-successful-2443cd07cbb0) with **1,571,224 wxDAI raised from 210 backers**. Hatch tokens were initially frozen (non-transferable) while the community collaboratively designed the economic parameters through the [Commons Configuration Dashboard](https://forum.tecommons.org/t/the-commons-configuration-dashboard/573).
The parameter design process was itself a token engineering exercise: [40 proposals](https://forum.tecommons.org/t/how-do-the-hatch-param-proposals-stack-up/385), two weeks of debate, and two rounds of voting. The community selected parameters for the [Opening Price & Reserve Ratio](https://forum.tecommons.org/t/augmented-bonding-curve-opening-price-reserve-ratio/516), [Entry & Exit Tributes](https://forum.tecommons.org/t/augmented-bonding-curve-entry-exit-tribute/494), the [Commons Tribute](https://forum.tecommons.org/t/augmented-bonding-curve-commons-tribute/517) (hatch fund split), and [Conviction Voting parameters](https://forum.tecommons.org/t/conviction-voting-parameters-general-disccusion/84).
**Key Parameters as Deployed:**
| Parameter | Value | Source |
|-----------|-------|--------|
| Reserve Ratio | ~31% | On-chain (Notebook 04) |
| Entry Tribute | ~22% | Whale trade event logs (Notebook 05) |
| Exit Tribute | ~8–12% | Whale trade event logs (Notebook 05) |
| CV Conviction Growth | 7 days | [TEC Handbook](https://token-engineering-commons.gitbook.io/tec-handbook/archive/archived-content/fund-allocation-layer-and-tools/conviction-voting-funding) |
| CV Minimum Conviction | 4% | TEC Handbook |
| CV Spending Limit | 11% per proposal | TEC Handbook |
The ABC went live on Gnosis Chain in **January 2022**, with the first conviction voting proposal submitted on January 27, 2022.
---
## 3. Conviction Voting: Governance That Worked — Until It Didn't
### 3.1 Scale and Outcomes
Over 16 months of active operation (Jan 2022 – May 2023), conviction voting processed **47 proposals**, of which **36 were funded** (84% success rate among real proposals), disbursing a total of **680,295 TEC** from the Common Pool.
The high success rate suggests proposals were well-vetted before formal submission — a feature of conviction voting's design, where the continuous, time-weighted nature of support accumulation incentivizes pre-submission community alignment. Only 7 proposals were cancelled, and of those, a significant fraction came from beneficiaries who later resubmitted and received funding.
### 3.2 Spending Categories
Funded proposals spanned a diverse portfolio:
| Category | TEC Funded | % of Total | # Proposals |
|----------|-----------|------------|-------------|
| Community & Operations | Largest share | — | Multiple |
| Education (TE Academy) | Significant | — | Multiple |
| Research (cadCAD, etc.) | Moderate | — | Multiple |
| Rewards & Recognition | Moderate | — | Multiple |
| Tooling & Infrastructure | Smaller | — | Fewer |
*(Detailed breakdown with exact numbers available in Notebook 02, `cv_spending_categories.png`)*
The TEC's lifetime grants totaled **$433,316 in direct funding** plus an additional **~$250K via Gitcoin** matching rounds. Key beneficiaries included TE Academy, cadCAD development, GravityDAO (conflict resolution), and various research initiatives.
### 3.3 Participation and Concentration
**159 unique stakers** participated in conviction voting — approximately **13% of the ~1,200 token holders**. Participation was heavily concentrated:
- **Gini coefficient: 0.843** (high inequality)
- **Top 10 stakers controlled 65.1%** of total stake
- **69 of 159 stakers (43%)** voted on only one proposal
- Only stakers on 5+ proposals showed sustained engagement
This concentration wasn't necessarily a flaw — conviction voting's design inherently allows proportional influence by token holdings. But it meant that a small group of committed participants effectively drove allocation decisions, while the vast majority of token holders were passive.
### 3.4 The Abstain Proposal as Inertial Brake
The TEC implemented an "Abstain" proposal (#1) as a mechanism for token holders to signal "slow down spending" without opposing specific proposals. Tokens staked on Abstain reduced the effective conviction available for all other proposals, functioning as an [inertial brake on governance throughput](https://forum.tecommons.org/t/strengths-and-weaknesses-of-conviction-voting-and-other-mechanisms/1278).
**The Abstain proposal accumulated up to 729,141 TEC** in peak stake — often exceeding the combined stake on all active proposals. The "brake strength" (Abstain's share of total staked tokens) averaged roughly 50–70% for much of the system's life, meaning proposals needed to overcome significant inertia to pass. This worked as intended during healthy periods but became problematic as community engagement declined: fewer active voters meant Abstain's inertial dominance grew relative to dwindling active conviction.
As Gideonro noted in a [forum discussion on CV strengths and weaknesses](https://forum.tecommons.org/t/strengths-and-weaknesses-of-conviction-voting-and-other-mechanisms/1278): "*having conviction build automatically over time does build momentum*" that can drain treasuries, and the Abstain workaround "*created unexpected behavioral problems when voters reallocated tokens after proposals passed.*"
### 3.5 Conviction Dynamics
Funded proposals had a **median active lifetime of ~30 days**, with conviction building gradually before crossing the funding threshold. Larger proposals required sustained support over weeks. The 7-day conviction growth parameter (the half-life for conviction accumulation) created a meaningful delay that filtered out impulsive allocation — but also meant urgent funding needs moved slowly.
The system exhibited a clear lifecycle pattern: high activity in early 2022, steady throughput through mid-2022, then declining participation that correlated with treasury depletion and token price decline.
---
## 4. The Augmented Bonding Curve: Structural Sell Pressure
### 4.1 The Buy/Sell Asymmetry
The ABC's most striking empirical feature was **overwhelming structural sell pressure**:
| Metric | Buys | Sells |
|--------|------|-------|
| Transaction count | 398 | 2,217 |
| Sell:Buy ratio | — | **5.6:1** |
| Total volume | Minority share | Dominant |
The ABC was used **primarily as an exit mechanism**, not an entry mechanism. This is the opposite of what the design thesis required — the system needed net buying pressure to generate tribute revenue for the Common Pool.
### 4.2 Price Trajectory
- **Peak ABC price: 2.94 xDAI** (early 2022)
- **Final ABC price: 0.36 xDAI** (December 2023)
- **Drawdown: -88%**
The reserve pool declined from a peak of **1,119,156 xDAI to 111,623 xDAI**, with token supply peaking then contracting as sells burned tokens faster than buys minted them.
### 4.3 Tribute Revenue: Insufficient by Design?
Total ABC tribute revenue over the full lifecycle: **~329,904 xDAI**
- Entry tributes (22% of buy volume): generated significant per-transaction revenue but from insufficient volume
- Exit tributes (8–12% of sell volume): captured value from sellers but couldn't offset the drain
The [entry/exit tribute structure](https://forum.tecommons.org/t/augmented-bonding-curve-entry-exit-tribute/494) faced a fundamental paradox identified early in [forum debates](https://forum.tecommons.org/t/augmented-bonding-curve-commons-tribute/517): high tributes discourage participation, low tributes don't generate enough revenue. The 22% entry tribute was notably aggressive — effectively a tax on joining — which may have suppressed buy-side volume. As one community member [noted during parameter design](https://forum.tecommons.org/t/augmented-bonding-curve-entry-exit-tribute/494), "*a small (but >0%) entry tribute would likely generate more funding for the Common Pool than an extremely high percentage (>15%) because* [high rates] *discourage purchases entirely.*"
By Q1 2025, quarterly tribute revenue had declined to just **~$3,614** — a fraction of the ~$42,000 quarterly operating expenditure reported in the [Q1 2025 Progress Report](https://forum.tecommons.org/t/tec-q1-2025-progress-report/1472).
### 4.4 Primary vs. Secondary Market Divergence
The TEC token traded on both the ABC (Gnosis Chain) and secondary DEXes (Honeyswap on Gnosis, later Velodrome on Optimism). Comparing daily prices:
- The DEX price frequently traded at a **discount** to the ABC price
- The mean DEX-to-ABC spread was negative, meaning traders could buy cheaper on the DEX than by minting on the ABC
- **26,107 DEX trades** vs. 2,615 ABC trades — the secondary market saw 10x the activity
This DEX discount created an arbitrage dynamic that further undermined the ABC: rational actors would buy on Honeyswap (cheaper, no entry tribute) rather than minting via the ABC. The ABC's entry tribute effectively priced itself out of its own market.
### 4.5 The 500K Whale
The single largest ABC participant — wallet `0xf5dcd98a...12f35497` — made a **499,803 xDAI purchase on January 25, 2022**, representing 46.5% of all ABC buy volume in a single transaction.
- **Entry tribute paid: ~109,957 xDAI** (22%)
- **TEC received: ~165,000 TEC**
- **Subsequent exits**: 6 sell transactions from May 2022 to June 2023, at declining prices
- **Realized P&L: deeply negative** (sold recovered only a fraction of the investment)
- **Total tribute contribution: ~123,000 xDAI** (entry + exit)
This single whale contributed roughly **37% of all ABC tribute revenue**. The system's financial sustainability was, to a troubling degree, dependent on a handful of large participants who entered early and whose exits compounded sell pressure.
### 4.6 Token Holder Concentration
At the time of analysis:
- **723 total holders**
- **Top holder (gideonro.eth): 13.2%** of supply
- **Top 10 holders: 50.7%** of supply
- **50% of supply held by just the top ~10 addresses**
- **80% of supply held by the top ~40 addresses**
Holder count grew initially then plateaued and declined — a pattern consistent with the death spiral hypothesis.
---
## 5. Treasury Dynamics: The Drawdown Fund
### 5.1 Common Pool Depletion
The Common Pool — the funding source for conviction voting — followed a steady downward trajectory:
- **Peak balance: 1,073,976 tokens**
- **Final balance: 0** (fully depleted by December 2023)
- **Total outflows: 1,195,952** (grants + operating costs)
- **17 of 24 months had net negative flows** (outflows exceeded inflows)
The fundamental coverage ratio — total inflows divided by total outflows — was well below 1.0x. The Common Pool was never self-sustaining.
### 5.2 Reserve Pool
The Reserve Pool (ABC collateral) tracked the broader market:
- **Peak: 1,119,096 xDAI**
- **Final: ~0** (drained through ABC sells)
The reserve ratio drifted from its ~31% target as sell pressure eroded collateral faster than the bonding curve formula could adjust.
### 5.3 Post-Migration (Optimism Era)
After [migrating to Optimism in December 2023](https://forum.tecommons.org/t/and-we-are-live-on-op-mainnet/1324), the TEC shifted from conviction voting to manual treasury allocations via a coordination team multisig. The reserve currency changed from xDAI to rETH.
**Post-migration treasury:**
- **Peak value: ~$348,595**
- **Value at analysis end: ~$208,710**
- **Holdings**: DAI, TEC, and rETH
- **Drawdown from peak: significant**, driven by discrete spending events and market movements
By the [Q1 2025 Progress Report](https://forum.tecommons.org/t/tec-q1-2025-progress-report/1472), total assets stood at ~$300,366 — with quarterly expenditures of $42,244 against only $3,614 in ABC tribute revenue.
---
## 6. The Death Spiral: Correlated Decline
Plotting the normalized trajectories of reserve pool balance, common pool balance, and governance activity reveals a tightly correlated decline — the classic "death spiral" pattern:
1. **Token price drops** → less attractive to hold
2. **Holders sell via ABC** → reserve pool shrinks → price drops further
3. **Less ABC activity** → less tribute revenue → common pool depletes faster
4. **Less funding available** → fewer proposals → less community activity
5. **Less activity** → holders leave → cycle repeats
Two exogenous shocks accelerated the spiral:
- **Terra/Luna collapse (May 2022)**: broad crypto market downturn
- **FTX collapse (November 2022)**: deepened the crypto winter
But the structural problem predated these shocks. The ABC's sell pressure was 5.6:1 from the start. The Common Pool was net-negative in 17 of 24 months. The feedback loop required continuous external demand that never materialized at sufficient scale.
---
## 7. Mechanism Design Scorecard
### Augmented Bonding Curve
| Criterion | Assessment |
|-----------|------------|
| Continuous fundraising | **Partial** — raised capital initially but became primarily an exit mechanism |
| Price floor / support | **Failed** — 88% drawdown; reserve depleted |
| Tribute revenue generation | **Insufficient** — 329K xDAI lifetime, declining to ~$3.6K/quarter |
| Market making | **Undermined** — secondary DEX offered cheaper entry, bypassing tributes |
### Conviction Voting
| Criterion | Assessment |
|-----------|------------|
| Fund allocation | **Succeeded** — 36 proposals funded across diverse categories |
| Sybil resistance | **Succeeded** — time-weighted conviction made gaming expensive |
| Broad participation | **Partial** — 159 of ~1,200 holders (13%); Gini 0.843 |
| Sustainability signaling | **Partial** — Abstain mechanism worked but couldn't prevent depletion |
### The Feedback Loop
| Criterion | Assessment |
|-----------|------------|
| Self-sustainability | **Failed** — Common Pool never renewable |
| Value creation | **Succeeded** — $433K in grants + $250K via Gitcoin funded real work |
| Growth flywheel | **Failed** — value created didn't translate to ABC buying pressure |
---
## 8. What Broke Down — And What Worked
### What didn't work
1. **The tribute model required perpetual growth.** ABC tributes can only sustain a Common Pool if buy-side volume persistently exceeds grant outflows. In a bear market with no external revenue, the pool inevitably depletes.
2. **High entry tribute (22%) suppressed buying.** Combined with DEX availability offering cheaper TEC, the ABC became unattractive as an entry point. Rational participants bought on Honeyswap and sold on the ABC — the reverse of the intended flow.
3. **No external revenue mechanism.** The entire system depended on trading activity for revenue. When trading declined, revenue collapsed. There was no fee-generating product, no staking yield, no service income — only tributes on a shrinking volume base.
4. **Governance participation concentrated and declined.** With only 13% of holders actively governing, the system was vulnerable to whale exit or disengagement. When the token price fell, the opportunity cost of holding TEC for governance rose, and participation waned.
### What worked
1. **Conviction Voting delivered on its core promise.** The mechanism allocated $433K+ to real projects — TE Academy, cadCAD, Gravity, research — that created genuine value. The 84% success rate and diverse portfolio suggest the allocation mechanism worked well within its constraints.
2. **The Abstain mechanism was a genuine innovation.** It provided a continuous, non-binary signal for governance pace — something binary voting systems lack. Its interaction with conviction dynamics deserves further study.
3. **Collaborative parameter design was a token engineering achievement.** The Hatch → Commons Configuration → Commons Upgrade pipeline demonstrated that communities can collaboratively design and deploy complex economic systems. The [Commons Configuration Dashboard](https://forum.tecommons.org/t/the-commons-configuration-dashboard/573) process was itself a contribution to the field.
4. **Graceful shutdown.** As mzargham commented on the [shutdown proposal](https://forum.tecommons.org/t/tec-shutdown-proposal/1520): "*The ability to design and execute a graceful shutdown process is a testament to a life well lived.*" The TEC's orderly wind-down — with [severance for coordinators, a $10K retrospective research grant, knowledge archival](https://forum.tecommons.org/t/tec-shutdown-proposal/1520), and pro-rata distribution to holders — is a model for responsible DAO sunsetting.
---
## 9. Implications for Future Mechanism Design
### For Bonding Curves
- **Entry tributes above ~5% create perverse incentives** when secondary markets exist. The DEX becomes the rational entry point, starving the ABC of tribute revenue.
- **Reserve ratios must account for sustained sell pressure.** A 31% ratio provided insufficient buffer against the 5.6:1 sell:buy dynamics that emerged.
- **ABCs work for initial capitalization but not ongoing funding** unless buy-side demand is structurally guaranteed (e.g., by utility that requires token purchase).
### For Conviction Voting
- **CV needs a replenishing pool.** As [discussed on the forum](https://forum.tecommons.org/t/strengths-and-weaknesses-of-conviction-voting-and-other-mechanisms/1278), CV exhibits "a built-in bias for passing funding proposals" and functions best with abundant, renewable funding — not a fixed endowment.
- **The Abstain mechanism needs refinement.** Its behavioral interactions with proposal lifecycle events (reallocation after proposal execution) created unexpected dynamics.
- **13% participation may be structurally inherent** in token-weighted governance without delegation or incentives for participation.
### For DAO Sustainability
- **Trading-fee-dependent funding models are fragile.** Revenue must come from sources less correlated with market sentiment — services, subscriptions, protocol fees, or diversified treasuries.
- **The "growth flywheel" assumption is the critical risk.** If funded projects don't generate measurable token demand, the loop breaks regardless of mechanism design quality.
- **Plan for shutdown.** The TEC's experience suggests every DAO should design its end-of-life process alongside its governance — not as an afterthought.
---
## 10. Data Sources & Methods
All analysis is based on on-chain data and publicly available forum records:
- **ABC trades, reserve, and supply**: [Dune Analytics TEC Dashboard](https://dune.com/tec/tec) — 2,615 detailed ABC trades, 32,000 expanded trade records
- **DEX trades**: Dune queries covering 26,107 Honeyswap and Velodrome trades (Jan 2022 – Mar 2026)
- **Conviction Voting**: Gardens subgraph data — 47 proposals, 891 stake events, 873 support updates
- **Treasury pools**: Dune pool balance exports — 871 common pool and 886 reserve pool daily records
- **Token holders**: Dune holder snapshots — 723 addresses with balances and concentration metrics
- **Post-migration balances**: Dune token balance tracking (Dec 2023 – Dec 2025)
- **Whale analysis**: Direct Gnosis Chain RPC event log decoding for wallet `0xf5dcd98a...`
- **Forum context**: TEC Forum at [forum.tecommons.org](https://forum.tecommons.org/)
Contract addresses (Gnosis Chain):
- TEC Token: `0x5dF8339c5E282ee48c0c7cE8A7d01a73D38B3B27`
- ABC: `0x74ade20c12067e2f9457c037809a73f35694f99f`
- Common Pool: `0xb941365430a16659658bb23b88efaede1d839354`
Analysis notebooks and raw data available in the [TEC-analysis repository](https://github.com/jeffemmett/TEC-analysis).
---
## Key Forum References
| Topic | Link |
|-------|------|
| Shutdown Proposal (passed Nov 4, 2025) | [forum.tecommons.org/t/tec-shutdown-proposal/1520](https://forum.tecommons.org/t/tec-shutdown-proposal/1520) |
| Sunsetting & Treasury Distribution | [forum.tecommons.org/t/sunsetting-the-tec-proposal-treasury-distribution-framework/1500](https://forum.tecommons.org/t/sunsetting-the-tec-proposal-treasury-distribution-framework/1500) |
| Q1 2025 Progress Report | [forum.tecommons.org/t/tec-q1-2025-progress-report/1472](https://forum.tecommons.org/t/tec-q1-2025-progress-report/1472) |
| Dune Dashboard 2024 | [forum.tecommons.org/t/dune-tec-dashboard-2024/1371](https://forum.tecommons.org/t/dune-tec-dashboard-2024/1371) |
| Strengths & Weaknesses of CV | [forum.tecommons.org/t/strengths-and-weaknesses-of-conviction-voting/1278](https://forum.tecommons.org/t/strengths-and-weaknesses-of-conviction-voting-and-other-mechanisms/1278) |
| ABC Introduction | [forum.tecommons.org/t/augmented-bonding-curve-an-introduction-to-the-abc/497](https://forum.tecommons.org/t/augmented-bonding-curve-an-introduction-to-the-abc/497) |
| Entry & Exit Tribute Parameters | [forum.tecommons.org/t/augmented-bonding-curve-entry-exit-tribute/494](https://forum.tecommons.org/t/augmented-bonding-curve-entry-exit-tribute/494) |
| Opening Price & Reserve Ratio | [forum.tecommons.org/t/augmented-bonding-curve-opening-price-reserve-ratio/516](https://forum.tecommons.org/t/augmented-bonding-curve-opening-price-reserve-ratio/516) |
| Conviction Voting Parameters | [forum.tecommons.org/t/conviction-voting-parameters-general-disccusion/84](https://forum.tecommons.org/t/conviction-voting-parameters-general-disccusion/84) |
| Half-Life Deep Dive | [forum.tecommons.org/t/half-life-conviction-voting-deep-dive/160](https://forum.tecommons.org/t/half-life-conviction-voting-deep-dive/160) |
| Minimum Conviction Threshold | [forum.tecommons.org/t/conviction-voting-minimum-conviction-aka-minimum-threshold/493](https://forum.tecommons.org/t/conviction-voting-minimum-conviction-aka-minimum-threshold/493) |
| Commons Configuration Dashboard | [forum.tecommons.org/t/the-commons-configuration-dashboard/573](https://forum.tecommons.org/t/the-commons-configuration-dashboard/573) |
| Hatch Parameters Discussion | [forum.tecommons.org/t/hatch-parameters-general-discussion-thread/61](https://forum.tecommons.org/t/hatch-parameters-general-discussion-thread/61) |
| Hatch TL;DR | [forum.tecommons.org/t/the-hatch-tl-dr/272](https://forum.tecommons.org/t/the-hatch-tl-dr/272) |
| Migration to Optimism (Simulation) | [forum.tecommons.org/t/simulating-the-tec-migration-to-optimism/1319](https://forum.tecommons.org/t/simulating-the-tec-migration-to-optimism/1319) |
| Live on OP Mainnet | [forum.tecommons.org/t/and-we-are-live-on-op-mainnet/1324](https://forum.tecommons.org/t/and-we-are-live-on-op-mainnet/1324) |
| Commons Upgrade Proposals | [Hatch Proposals Stack-up](https://forum.tecommons.org/t/how-do-the-hatch-param-proposals-stack-up/385) |
---
*This analysis was conducted as part of the [Bonding Curve Research Group retrospective](https://forum.tecommons.org/t/tec-shutdown-proposal/1520), funded by the TEC shutdown allocation. Data collection and visualization notebooks are available at `notebooks/01–05` in the project repository.*

138
scripts/gen_timeline.py Normal file
View File

@ -0,0 +1,138 @@
"""Generate a Markwhen timeline (.mw) for the TEC retrospective.
Inputs:
data/onchain/cv_proposals.csv (id, block, amount_requested, link, status, executed_block)
data/onchain/cv_proposal_categories.json (id -> category tag, optional)
Output:
output/tec_retrospective.mw
Anchoring: Gnosis block 20086948 == 2022-01-27 (CV proposal #1 per synthesis),
block time ~5.0s. Close enough for a retrospective timeline.
"""
from __future__ import annotations
import csv
import json
from datetime import datetime, timedelta, timezone
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
PROPOSALS = ROOT / "data" / "onchain" / "cv_proposals.csv"
CATEGORIES = ROOT / "data" / "onchain" / "cv_proposal_categories.json"
OUT = ROOT / "output" / "tec_retrospective.mw"
ANCHOR_BLOCK = 20086948
ANCHOR_DATE = datetime(2022, 1, 27, tzinfo=timezone.utc)
GNOSIS_BLOCK_SECONDS = 5.0
def block_to_date(block: int) -> datetime:
delta = (block - ANCHOR_BLOCK) * GNOSIS_BLOCK_SECONDS
return ANCHOR_DATE + timedelta(seconds=delta)
def load_categories() -> dict[str, str]:
if not CATEGORIES.exists():
return {}
raw = json.loads(CATEGORIES.read_text())
if isinstance(raw, dict):
return {str(k): str(v) for k, v in raw.items()}
return {}
HEADER = """---
title: Token Engineering Commons — Retrospective
view: timeline
timezone: UTC
#hatch: blue
#abc: orange
#cv: green
#shock: red
#migration: purple
#shutdown: gray
---
// Generated by scripts/gen_timeline.py
// Edit macro events here; CV proposal section is auto-appended.
section Origins #hatch
2021-02-01 / 2021-08-11: Trusted Seed recruitment & Hatch prep
210 backers onboarded via Commons Stack Hatch app
2021-08-11: Hatch closed — 1,571,224 wxDAI raised from 210 backers #hatch
https://medium.com/token-engineering-commons/the-hatch-was-successful-2443cd07cbb0
2021-08-12 / 2022-01-26: Commons Configuration Dashboard — 40 parameter proposals, 2 rounds of voting #hatch
endSection
section ABC & Markets #abc
2022-01-25: 500K whale purchase — 499,803 xDAI (46.5% of all ABC buy volume, ever) #abc
wallet 0xf5dcd98a...12f35497 · entry tribute ~109,957 xDAI
2022-01-27: ABC live on Gnosis Chain; first CV proposal submitted #abc #cv
2022-05-09: Terra/Luna collapse — first exogenous shock #shock
2022-11-08: FTX collapse — second exogenous shock, crypto winter deepens #shock
2023-12-01: ABC price bottom — 0.36 xDAI (-88% from peak of 2.94) #abc
endSection
section Treasury & Migration #migration
2023-12-15: Migration to Optimism; CV replaced by multisig coordination #migration
reserve currency: xDAI → rETH
https://forum.tecommons.org/t/and-we-are-live-on-op-mainnet/1324
2024-01-01 / 2025-11-04: Post-migration draw-down era (manual allocations)
2025-04-01: Q1 2025 Progress Report — tribute revenue $3,614/qtr vs $42,244/qtr opex #shutdown
https://forum.tecommons.org/t/tec-q1-2025-progress-report/1472
2025-11-04: TEC shutdown proposal formally approved #shutdown
https://forum.tecommons.org/t/tec-shutdown-proposal/1520
endSection
"""
def build_cv_section(rows: list[dict], cats: dict[str, str]) -> str:
lines = ["section Conviction Voting Proposals #cv", ""]
for row in rows:
pid = row["id"]
try:
block = int(row["block"])
except (TypeError, ValueError):
continue
created = block_to_date(block)
executed = None
if row.get("executed_block"):
try:
executed = block_to_date(int(row["executed_block"]))
except ValueError:
pass
amount = row.get("amount_requested") or "0"
try:
amount_f = float(amount)
except ValueError:
amount_f = 0.0
status = (row.get("status") or "").lower()
title = (row.get("link") or f"Proposal #{pid}").strip() or f"Proposal #{pid}"
title = title.replace("\n", " ")[:90]
cat = cats.get(str(pid), "")
tags = [f"#{status}"] if status else []
if cat:
tags.append(f"#{cat.lower().replace(' ', '_')}")
tag_str = " " + " ".join(tags) if tags else ""
if executed and status == "executed":
rng = f"{created:%Y-%m-%d} / {executed:%Y-%m-%d}"
else:
rng = f"{created:%Y-%m-%d}"
amount_note = f" — {amount_f:,.0f} TEC" if amount_f > 0 else ""
lines.append(f"{rng}: #{pid} {title}{amount_note}{tag_str}")
lines.append("endSection")
return "\n".join(lines) + "\n"
def main() -> None:
rows = list(csv.DictReader(PROPOSALS.open()))
cats = load_categories()
body = HEADER + build_cv_section(rows, cats)
OUT.parent.mkdir(exist_ok=True)
OUT.write_text(body)
print(f"Wrote {OUT} ({len(rows)} proposals)")
if __name__ == "__main__":
main()