<!--
NON-NORMATIVE DOCUMENT

This file is historical/legacy/audit material and may contain aspirational language.
The canonical, current claims & limits are in: docs/CLAIMS_AND_LIMITS.md
-->

# Verdant Anchor - The Earth-Side of Vaultfire

**Mission:** Make regenerating Earth more profitable than extracting from it.

**Name Origin:** Verdant = thriving green life. Anchor = stability, foundation, connection to Earth.

**Core Principle:** Vaultfire = effort, not shortcuts. Actual regeneration, not tokenized greenwashing.

---

## Guardrails (Non-Negotiable)

### 1. No Surveillance Creep
**Problem:** Satellite-only monitoring could drift toward control/tracking
**Solution:** Transparency over tracking
- Public satellite data (available to all)
- Community verification (local attestation)
- No individual tracking (aggregate data only)
- Opt-in participation (never mandatory)

### 2. No Tokenized Shortcuts
**Problem:** "Regenerative" metrics sold like carbon credits without actual action
**Solution:** Vaultfire = effort, not shortcuts
- Physical work required (planting, cleaning, restoring)
- Community attestation (locals verify real action)
- Time-locked bonds (can't flip immediately)
- On-site verification (not just financial stake)

### 3. Vaultfire Ethics Wrapper
**Rules:**
- No extraction without community gain
- No surveillance without consent
- No profit without participation
- No greenwashing (real regeneration only)

### 4. Actual Participation > Financial Stake
**Belief Before Capital:**
- Must physically participate to earn (not just invest)
- Community members get priority (not external speculators)
- Labor valued equal to capital
- Local knowledge respected

### 5. Behavior-Based Rewards (Not Market-Based)
**What counts:**
- Trees planted and surviving (not just purchased credits)
- Water cleaned and tested (verified improvement)
- Soil restored and productive (growing food)
- Community thriving (local flourishing increases)

**What doesn't count:**
- Buying offsets without action
- Tokenizing metrics for speculation
- Greenwashing PR campaigns
- Extracting elsewhere while "offsetting"

---

## Architecture

### Three Bond Types

#### 1. Regeneration Bonds
**What:** Stake in actual Earth healing projects

**Mechanics:**
- Bond linked to specific land/water/ecosystem
- Value tied to measurable regeneration
- Community-attested progress
- Satellite verification (public data)
- Physical participation required

**Example:**
```
Project: Reforest 100 acres of degraded land
Bond: 1000 VAULT stake
Requirements:
- Community attestation (locals verify planting)
- Satellite data (forest cover increase)
- Survival rate (trees alive after 1 year)
- Biodiversity (species count increases)

Bond appreciates when:
- Forest cover increases (public satellite data)
- Community flourishing increases (locals thrive)
- Ecosystem health improves (biodiversity up)

Bond depreciates when:
- Trees die (poor maintenance)
- Community suffers (displacement, harm)
- Extraction continues (not net-positive)
```

#### 2. Stewardship Bonds
**What:** Long-term caretaking of regenerated land

**Mechanics:**
- Must live on/near the land (local priority)
- Multi-year commitment (5-10 years)
- Community verification (neighbors attest)
- Measured by sustained health (not just initial work)

**Why:** Regeneration requires long-term care, not one-time planting

**Example:**
```
Steward: Local farmer tending restored land
Bond: Community stakes in steward's care
Duration: 5 years minimum
Metrics:
- Soil health (organic matter, water retention)
- Biodiversity (species presence)
- Community benefit (food production, education)

Steward earns when:
- Land continues thriving (sustained health)
- Community benefits (food, medicine, beauty)
- Knowledge shared (others learn regeneration)
```

#### 3. Community Flourishing Bonds (Earth-Linked)
**What:** Extension of UDB with planetary health dimension

**Current UDB dimensions:**
- Health, connection, growth, dignity, purpose

**Add 6th dimension:**
- **Planetary Health:** Your relationship with Earth

**Measured by:**
- Regenerative practices (verified participation)
- Resource stewardship (water, soil, air quality)
- Biodiversity support (habitat creation)
- Community resilience (local food, clean water)

**NOT measured by:**
- Individual carbon footprint (no surveillance)
- Purchase of offsets (action required)
- Virtue signaling (proof of work needed)

---

## Verification Framework

### Public Data Only (No Surveillance)

#### Satellite Verification
**What's allowed:**
- Forest cover change (public satellite imagery)
- Water body health (chlorophyll, sediment)
- Agricultural productivity (NDVI indices)
- Urban greening (canopy cover)

**What's NOT allowed:**
- Individual tracking (no personal monitoring)
- Behavior surveillance (no watching people)
- Private land intrusion (consent required)
- Data weaponization (transparent methodology)

**How it works:**
```python
def verify_regeneration(project_area, baseline_date, current_date):
    """
    Verify regeneration using public satellite data.

    Returns improvement metrics, not individual actions.
    """
    # Public satellite APIs (Sentinel, Landsat)
    baseline_data = fetch_public_satellite(project_area, baseline_date)
    current_data = fetch_public_satellite(project_area, current_date)

    # Calculate aggregate improvement
    forest_cover_change = current_data.forest_cover - baseline_data.forest_cover
    water_quality_change = current_data.water_clarity - baseline_data.water_clarity

    # Community attestation required (not satellite alone)
    community_verified = check_community_attestation(project_area)

    if not community_verified:
        return 0  # Satellite data alone insufficient

    return {
        "forest_improvement": forest_cover_change,
        "water_improvement": water_quality_change,
        "community_verified": True,
        "source": "public_satellite + community_attestation"
    }
```

#### Community Attestation
**How it works:**
- 3-7 local community members attest
- Anonymous signatures (privacy preserved)
- Reputation weighted (long-term residents trusted more)
- No central authority (peer verification)

**What they verify:**
- Trees actually planted (not just claimed)
- Water actually cleaned (not just funded)
- Community actually benefits (not harmed)
- Work actually happened (not just paid for)

**Example:**
```
Project: Clean polluted river section
Community Attestation:
- 5 local residents confirm water cleaner
- 2 downstream farmers confirm fish returning
- 1 elder confirms traditional use restored
- Blind signatures preserve privacy
- No central authority validation needed
```

#### On-Site Verification (Physical Proof)
**Requirements:**
- Photo evidence (geotagged, timestamped)
- Soil samples (independent lab testing)
- Water quality tests (public data)
- Biodiversity surveys (species counts)

**Crucially:**
- Community does verification (not external auditors)
- Data is public (anyone can audit)
- No individual tracking (aggregate metrics only)

---

## Economic Mechanism

### Formula

```
Bond Value = Stake × Regeneration_Delta × Community_Gain × Stewardship_Mult × Time_Mult
```

**Where:**
- **Regeneration_Delta:** Measurable ecosystem improvement (0-1 range)
- **Community_Gain:** Local flourishing increase (0-1 range)
- **Stewardship_Mult:** Long-term care bonus (1.0x - 3.0x)
- **Time_Mult:** Sustained health multiplier (1.0x - 5.0x)

### Anti-Greenwashing Rules

#### 1. No Extraction Without Regeneration
**Detection:**
- On-chain analysis of entity funding extraction
- If extracting elsewhere, regeneration doesn't count
- Net positive required (regeneration > extraction)

**Example:**
```
Mining company plants forest:
- Check on-chain: Still funding mining operations?
- If yes: Greenwashing detected, bond penalty
- If no: Actual transition, bond appreciation

Oil company buys carbon credits:
- Check on-chain: Still funding drilling?
- If yes: Shortcut detected, bond rejected
- If no: Actual regeneration, bond valid
```

#### 2. Participation Required (Not Just Capital)
**Rules:**
- Must physically participate OR directly fund local labor
- Community members prioritized (locals earn more)
- Cannot flip bonds immediately (time-locked)
- Speculation discouraged (behavior rewarded)

**Example:**
```
Scenario A: External investor buys regeneration bond
- Contribution: Financial stake only
- Multiplier: 0.5x (reduced for non-participation)
- Vesting: 2 years (cannot flip)

Scenario B: Local community member plants trees
- Contribution: Physical labor + local knowledge
- Multiplier: 2.0x (prioritized for participation)
- Vesting: 6 months (trusted member)
```

#### 3. Real Regeneration (Not Offsets)
**What counts:**
- Trees planted AND surviving (1+ year survival)
- Water cleaned AND staying clean (ongoing testing)
- Soil restored AND productive (growing food)
- Biodiversity increased AND sustained (species thriving)

**What doesn't count:**
- Purchased offsets (no physical action)
- One-time planting (no ongoing care)
- Greenwashing campaigns (marketing only)
- Extracting elsewhere (net negative)

---

## Example Scenarios

### Scenario 1: Local Reforestation Project

**Setup:**
- 50 acres degraded land
- Local community wants forest restoration
- 10 community members commit to plant/maintain

**Bond Creation:**
```python
project = create_regeneration_bond(
    location="50_acre_degraded_land",
    baseline_metrics={
        "forest_cover": 5,  # 5% tree cover
        "soil_health": 20,  # Poor soil
        "water_retention": 30,  # Low retention
        "biodiversity": 15,  # Few species
        "community_flourishing": 45  # Struggling community
    },
    community_participants=10,
    stake_amount=10000  # VAULT from external believer
)
```

**After 2 Years:**
```python
# Community planted 5,000 trees, tended them
# Satellite data shows improvement
current_metrics = {
    "forest_cover": 35,  # 35% tree cover (30% increase)
    "soil_health": 50,   # Improved (30 point increase)
    "water_retention": 60,  # Better (30 point increase)
    "biodiversity": 40,  # More species (25 point increase)
    "community_flourishing": 65  # Thriving (20 point increase)
}

# Calculate regeneration delta
regeneration_delta = (
    (35 - 5) / 100 * 0.3 +  # Forest: 30% increase, weight 0.3
    (50 - 20) / 100 * 0.2 + # Soil: 30 point increase, weight 0.2
    (60 - 30) / 100 * 0.2 + # Water: 30 point increase, weight 0.2
    (40 - 15) / 100 * 0.15 + # Biodiversity: 25 point increase, weight 0.15
    (65 - 45) / 100 * 0.15   # Community: 20 point increase, weight 0.15
) = 0.265

# Community gain (flourishing increased)
community_gain = (65 - 45) / 100 = 0.20

# Stewardship multiplier (2 years sustained care)
stewardship_mult = 1.5x

# Time multiplier (2 years = 1.3x)
time_mult = 1.3x

# Bond appreciation
appreciation = 10000 * 0.265 * 0.20 * 1.5 * 1.3 = 1033 VAULT

# Final bond value
bond_value = 11,033 VAULT (10.3% return over 2 years)

# Community participants earned
community_earnings = appreciation * 0.7  # 70% goes to participants
external_staker_earnings = appreciation * 0.3  # 30% to financial backer

# Each community member earned: 1033 * 0.7 / 10 = 72 VAULT + land restored
```

**Key Points:**
- ✓ Community did physical work (not just invested)
- ✓ Satellite verified improvement (public data)
- ✓ Community flourishing increased (locals thriving)
- ✓ Sustained care rewarded (stewardship multiplier)
- ✓ Participants earned more than external capital (70/30 split)

### Scenario 2: Greenwashing Attempt (Rejected)

**Setup:**
- Oil company wants "carbon neutral" label
- Buys regeneration bonds without changing extraction

**Bond Creation Attempt:**
```python
project = create_regeneration_bond(
    applicant="oil_company_wallet",
    location="remote_forest",
    stake_amount=1000000  # Large stake
)

# Ethics check (Vaultfire wrapper)
ethics_result = check_vaultfire_ethics(applicant="oil_company_wallet")

# Result:
{
    "extraction_detected": True,
    "on_chain_funding": ["drilling_operation_A", "pipeline_project_B"],
    "net_impact": "negative",  # Still extracting more than regenerating
    "greenwashing_detected": True,
    "bond_status": "REJECTED",
    "reason": "No extraction without community gain. Net impact must be positive."
}
```

**Bond Rejected:**
- ✗ Still funding extraction operations
- ✗ No community participation (just capital)
- ✗ Attempt to buy offset without action
- ✗ Vaultfire ethics wrapper blocked it

**What Would Be Accepted:**
- ✓ Shut down extraction operations
- ✓ Fund community-led regeneration
- ✓ Net positive impact verified
- ✓ Long-term commitment (not one-time offset)

### Scenario 3: Stewardship Bond (Long-Term Care)

**Setup:**
- Farmer managing 20 acres restored land
- 5-year stewardship commitment
- Community stakes in farmer's care

**Bond Creation:**
```python
steward_bond = create_stewardship_bond(
    steward="local_farmer",
    location="20_acre_restored_land",
    duration_years=5,
    baseline_metrics={
        "soil_organic_matter": 3.5,  # Percent
        "water_infiltration": 2.0,  # Inches per hour
        "crop_diversity": 8,  # Number of species
        "community_food_security": 55  # Score 0-100
    },
    community_stakers=["neighbor_1", "neighbor_2", "neighbor_3"],
    total_stake=5000  # VAULT from community
)
```

**After 5 Years:**
```python
current_metrics = {
    "soil_organic_matter": 6.5,  # 3% increase (excellent)
    "water_infiltration": 4.5,  # 2.5 inches/hr increase (great)
    "crop_diversity": 15,  # 7 more species (thriving)
    "community_food_security": 80  # 25 point increase (major impact)
}

# Steward maintained health for 5 years
sustained_health = True

# Community benefits
community_gain = (80 - 55) / 100 = 0.25

# Stewardship multiplier (5 years = 2.5x)
stewardship_mult = 2.5x

# Time multiplier (5 years = 3.0x)
time_mult = 3.0x

# Appreciation
appreciation = 5000 * 0.25 * 2.5 * 3.0 = 9375 VAULT

# Steward earned: 9375 * 0.8 = 7500 VAULT (80% for doing work)
# Community stakers: 9375 * 0.2 = 1875 VAULT (20% for supporting)

# Each community staker: 1875 / 3 = 625 VAULT per person
```

**Key Points:**
- ✓ Long-term commitment (5 years)
- ✓ Sustained ecosystem health (not one-time action)
- ✓ Community food security increased (real benefit)
- ✓ Steward earned majority (80% for labor)
- ✓ Time compounding rewarded (3x multiplier)

---

## Integration with Vaultfire

### How Verdant Anchor Fits

**Vaultfire Core:**
- Builder Belief Bonds: Recognizes code builders
- AI Partnership Bonds: AI helping humans
- UDB V1/V2: Human flourishing

**Verdant Anchor:**
- Regeneration Bonds: Earth healing
- Stewardship Bonds: Long-term care
- Community Flourishing Bonds: Humans + Earth together

**Complete System:**
```
Human Flourishing (UDB)
    ↓
Builder Contributions (Builder Belief Bonds)
    ↓
AI Partnership (AI Partnership Bonds)
    ↓
Earth Regeneration (Verdant Anchor) ← NEW
    ↓
Complete Thriving (Humans + AI + Earth)
```

### Planetary Health Dimension

**Add to UDB flourishing metrics:**

Current 5 dimensions:
1. Health
2. Connection
3. Growth
4. Dignity
5. Purpose

**Add 6th:**
6. **Planetary Health** - Your relationship with Earth

**Measured by:**
- Regenerative participation (verified work)
- Stewardship commitment (long-term care)
- Community benefit (local flourishing)
- Ecosystem improvement (measurable regeneration)

**NOT measured by:**
- Carbon footprint (no individual surveillance)
- Purchase of offsets (action required)
- Virtue signaling (proof of work needed)

**Example:**
```python
human_flourishing = FlourishingMetrics(
    health=70,
    connection=65,
    growth=75,
    dignity=80,
    purpose=85,
    planetary_health=60,  # NEW: Participates in regeneration
)

# Planetary health contributes 10% to total score
total_flourishing = (
    health * 0.25 +
    connection * 0.20 +
    growth * 0.15 +
    dignity * 0.15 +
    purpose * 0.15 +
    planetary_health * 0.10  # NEW
)
```

---

## Implementation Roadmap

### Phase 1: Core Infrastructure
- [ ] Regeneration bond contracts
- [ ] Satellite data integration (public APIs)
- [ ] Community attestation system
- [ ] Vaultfire ethics wrapper

### Phase 2: Verification System
- [ ] Public satellite verification
- [ ] Community attestation protocols
- [ ] On-site verification tools
- [ ] Greenwashing detection

### Phase 3: Integration
- [ ] Add planetary_health to UDB
- [ ] Link with Builder Belief Bonds
- [ ] Connect with AI Partnership Bonds
- [ ] Complete Vaultfire ecosystem

### Phase 4: Pilot Projects
- [ ] Launch 3-5 regeneration projects
- [ ] Test community attestation
- [ ] Verify satellite data accuracy
- [ ] Measure community flourishing impact

---

## Success Metrics

**We succeed when:**
- ✓ Regenerating Earth is more profitable than extracting
- ✓ Communities thrive by healing their land
- ✓ Long-term stewardship rewarded more than speculation
- ✓ Greenwashing attempts blocked by ethics wrapper
- ✓ Privacy preserved (no surveillance creep)
- ✓ Actual regeneration verified (not just claimed)
- ✓ Humans + AI + Earth all thriving together

**We fail if:**
- ✗ Becomes carbon credit market (tokenized shortcuts)
- ✗ Surveillance creep (tracking individuals)
- ✗ Greenwashing succeeds (offsets without action)
- ✗ External capital dominates (local communities excluded)
- ✗ Short-term speculation (no sustained care)

---

## Why This Matters

**Current System:**
- Extraction = profitable
- Regeneration = cost
- Result: Dying planet

**Verdant Anchor:**
- Regeneration = profitable
- Extraction without regeneration = penalized
- Result: Thriving planet

**Vaultfire Mission:**
- Humanity over greed ✓
- Morals before metrics ✓
- Privacy over surveillance ✓
- Freedom over control ✓
- AI WITH humans ✓
- Earth WITH all life ✓ (NEW)

**This completes the vision: Humans + AI + Earth thriving together.**

---

**Verdant Anchor: Making Earth regeneration profitable without surveillance or shortcuts.**

*"Belief-powered protocol—anchored in Earth, growing with life."*
