Exonomy & Exocracy - Functional Specification

Exonomy & Exocracy - Functional Specification.md

Exonomy/Exocracy Functional Specification
Version 0.1
Date: 2025-02-20

---

1. Introduction

1.1 Purpose

This document defines the decentralized architecture, workflows, and governance of Exonomy (voucher-based P2P exchange) and Exocracy (community-driven project management). It emphasizes trust, local economic resilience, and humanitarian impact through asset autonomy, selective replication, and unanimous governance.

1.2 Scope

• Exonomy: Peer-to-peer exchange of vouchers representing specific goods/services.
• Exocracy: Collaborative task management with hierarchical structures and community oversight.
• Key Innovations:
  • Voucher Primacy: Value anchored to tangible goods/services.
  • Selective Replication: Data propagates only to relevant peers.
  • Unanimous Consent: Critical actions require 100% community approval.

1.3 Definitions

Term	Definition
Exonomist	A user who mints, transfers, or redeems vouchers.
Exocrat	A user managing/contributing to projects.
Voucher	A cryptographically signed promise of a specific product/service.
Task	A unit of work within a project, linked to vouchers.

---

2. Core Architecture

2.1 System Layers

1. Data Layer:
   • Vouchers: JSON-LD/RDF documents with semantic metadata (author, value, currency, expiry).
   • Tasks: Hierarchical CRDTs with parent-child relationships and dynamic value inheritance.
   • Reputation: EXO-SCORE (voucher trust) and EXOCRAT-SCORE (project leadership).
2. Protocol Layer:
   • NextGraph: P2P replication engine using pub/sub topics and CRDT sync.
   • UCAN: Capability tokens for granular permissions.
   • IPFS: Decentralized storage for immutable evidence (e.g., project photos).
3. Application Layer:
   • Exonomy Wallet: Manages vouchers, wishlists, and social graphs.
   • Exocracy Dashboard: Facilitates task creation, crowdfunding, and governance.

2.2 Decentralized Identifiers (DIDs)

• Unique identifiers for users, communities, and assets (e.g., did:exo:task/bridge-repair).
• Stored in CRDT repositories for conflict-free merging.

---

3. Exonomy Mechanics

3.1 Voucher Lifecycle

1. Minting:
   • Users define voucher parameters (product, value, expiry).
2. Publication:
   • Vouchers publish to followers via selective replication.
3. Transfer:
   • Peer-to-peer exchanges require mutual UCAN authorization.
4. Redemption:
   • Only authors redeem vouchers; expired vouchers auto-revoke.

sequenceDiagram  
    participant Baker  
    participant Mechanic  
    participant NextGraph  
    Baker->>NextGraph: Mint voucher  
    NextGraph->>Baker: Confirmation  
    Baker->>Mechanic: Send UCAN token + voucher ID  
    Mechanic->>NextGraph: Request replication  
    NextGraph->>Mechanic: Replicate voucher CRDT  

Loading

3.2 Transactions

1. Barter:
   • Direct voucher-for-voucher exchange.
2. Cash Integration:
   • Stripe/PayPal processes payments, minting vouchers post-clearance.
   • 1% tax on cash transactions funds system development.

---

4. Exocracy Mechanics

4.1 Project Management

1. Task Hierarchy:
   • Parent tasks auto-sum child task values.
   • Example:

     Rebuild Dniepr Bridge (Parent)  
     ├─ Procure Steel (Subtask 1)  
     │  └─ Source 1000kg Beams (Subtask 1a)  
     └─ Hire Welders (Subtask 2)  
     

2. Crowdfunding:
   • Exonomists attach vouchers to tasks as compensation.
3. Crowdsourcing:
   • Workers bid with service vouchers to complete tasks.

4.2 Community Governance

1. Unanimous Consent:
   • Required for task completion, membership changes, or asset withdrawal.
2. Asset Freezing:
   • Only authors freeze/unfreeze assets.

graph TD  
    A[Member Initiates Freeze] --> B[Task/Voucher Marked exo:Frozen]  
    B --> C[Notifications Sent to Community]  
    C --> D[Dispute Resolution Process]  

Loading

---

5. Governance & Trust

5.1 Reputation System

1. EXO-SCORE:
   • Formula:

     EXO-SCORE = (Vouchers Redeemed by Others) × (Redemption Rate) + (Streak Bonus)  
     

2. EXOCRAT-SCORE:
   • Formula:

     EXOCRAT-SCORE = (Tasks Completed) × (Community Approval Rating)  
     

5.2 Dispute Resolution

1. Autonomous Control:
   • Authors exclusively freeze/unfreeze assets.
2. Transparency:
   • Freeze logs stored on IPFS with tamper-proof hashes.
3. Rage-Quit:
   • Authors withdraw vouchers without penalties.

---

6. Health Metrics (Ayurvedic Framework)

Dosha	Focus	Key Metrics
Vata	Movement	Transaction velocity, engagement agility.
Pitta	Strategy	Red/Black Ratio, qualitative impact.
Kapha	Stability	Redemption rates, lifetime contributions.

---

7. Humanitarian Implementation

1. Offline-First:
   • CRDTs sync via mesh networks in low-connectivity zones.
2. Crisis Prioritization:
   • Tasks tagged for urgent needs (e.g., disaster relief).

---

8. Economic Philosophy

1. Voucher Primacy:
   • Value tied to tangible goods/services, fostering local trust.
2. Local Anchoring:
   • Metrics penalize extractive practices and incentivize community retention.

---

9 References

• NextGraph, UCAN, JSON-LD, and IPFS specifications.