TEC-analysis/README.md

55 lines
2.4 KiB
Markdown

# TEC Analysis
Analysis of the Token Engineering Commons (TEC) token dynamics, focusing on:
- **Augmented Bonding Curve (ABC)** — primary market pricing, reserve ratio mechanics, entry/exit tribute
- **Conviction Voting** — proposal funding, signal dynamics, effective supply
- **Primary vs Secondary Market** — price divergence, arbitrage flows, liquidity depth
- **Token Distribution & Governance** — holder concentration, voting power, delegation patterns
## Structure
```
TEC-analysis/
├── data/
│ ├── onchain/ # On-chain data exports (ABC txns, CV proposals, token transfers)
│ ├── offchain/ # Off-chain data (forum posts, governance metadata)
│ └── snapshots/ # Point-in-time snapshots of key metrics
├── notebooks/ # Jupyter analysis notebooks
├── src/
│ ├── abc/ # Augmented Bonding Curve models & analysis
│ ├── conviction_voting/ # Conviction Voting analysis
│ ├── liquidity/ # Liquidity & market structure analysis
│ └── utils/ # Shared data fetching, plotting, helpers
├── docs/ # Write-ups, methodology notes
└── references/ # Papers, specs, prior work
```
## Key Questions
1. **ABC Mechanics**: How has the bonding curve price tracked vs secondary market (Uniswap/Honeyswap)? What's the effective reserve ratio over time?
2. **Entry/Exit Tribute**: How much value has flowed through tributes? Impact on buy/sell asymmetry?
3. **Conviction Voting Dynamics**: How does token lockup in CV affect circulating supply and price? What's the effective participation rate?
4. **Liquidity Fragmentation**: How deep is liquidity across primary (ABC) vs secondary markets? Where do large trades actually execute?
5. **Price Discovery**: Which market leads price discovery — the bonding curve or secondary DEXes?
6. **Governance Concentration**: How concentrated is voting power? Do whales dominate proposal outcomes?
## Related Local Repos
- `conviction/` — ABC simulations & cadCAD conviction voting models
- `Aragon_Conviction_Voting/` — Algorithm overview & models
- `conviction-voting-cadcad/` — cadCAD simulation framework
- `myco-bonding-curve/` — Bonding curve parameter sweeps & dashboards
## Data Sources
_To be populated — see below for what's needed._
## Setup
```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```