Skip to content

Instantly share code, notes, and snippets.

@exonomyapp
Created February 20, 2025 19:41
Show Gist options
  • Save exonomyapp/c0209d428da23553178392edd0095ec7 to your computer and use it in GitHub Desktop.
Save exonomyapp/c0209d428da23553178392edd0095ec7 to your computer and use it in GitHub Desktop.

Exonomy Vision / Scope Document

Table of Contents

  1. Introduction
  2. Core Principles
  3. Core Architecture & Data Structures
    • 3.1 Voucher Schema
    • 3.2 Task Schema
    • 3.3 Decentralized Storage
    • 3.4 P2P Protocol
  4. Exonomy Mechanics
    • 4.1 Voucher Lifecycle
    • 4.2 Transaction Flows
    • 4.3 Real-World Integration
  5. Exocracy Mechanics
    • 5.1 Project Management
    • 5.2 Community Dynamics
    • 5.3 Task Execution
  6. Governance & Trust
    • 6.1 Reputation System
    • 6.2 Dispute Resolution
    • 6.3 Consensus Mechanisms
  7. Selective Replication, Smart Contracts & Capability Tokens
    • 7.1 Selective Replication Model
    • 7.2 Smart Contracts for Voucher Transactions
    • 7.3 Capability Token Framework
  8. Health Metrics & Analytics
    • 8.1 Ayurvedic Triadic Framework
    • 8.2 Dashboards
  9. Humanitarian & Conflict Resilience
  10. Conclusion

1. Introduction

Exonomy and Exocracy form a decentralized economic and project management ecosystem where participants, called Exonomists, engage in voucher-based transactions to stimulate local economies without relying on traditional banking systems. This document outlines the full vision, scope, and technical details of every feature—both those existing and those planned—to ensure clarity for stakeholders, developers, and future contributors.


2. Core Principles

  1. Decentralized Trust: Transactions and relationships are governed by selective replication, verifiable reputation, and mutual consent rather than centralized oversight.
  2. Voucher-Driven Economy: Vouchers represent concrete products or services linked to real-world currencies (e.g., USD, EUR) and enable localized economic activity.
  3. Task-Oriented Project Management: Exocracy structures collaborative projects through hierarchical task breakdowns, ensuring that every aspect—from funding to execution—is transparently managed.
  4. Selective Replication: Data is only replicated to devices of transacting or following Exonomists, minimizing local storage requirements and safeguarding privacy.
  5. P2P Governance: Decision-making and dispute resolution occur through unanimous, decentralized mechanisms without central authorities.
  6. Integration with Fiat & Crypto: Payment processors like Stripe and PayPal enable fiat transactions tied to central bank currencies, ensuring legal and regulatory compliance.

3. Core Architecture & Data Structures

3.1 Voucher Schema

Vouchers are the economic instruments of Exonomy. Each voucher is defined as an RDF/JSON‑LD document with a globally unique identifier and properties such as:

  • Type: Product, Service, or Hybrid.
  • Currency & Amount: Explicitly linked to real-world currencies (e.g., using ISO 4217 codes) to ensure clear objective value.
  • Issuer & Redemption: The Exonomist who created the voucher and the business context where it is redeemable.
  • Expiry: A validity period that promotes liquidity and prevents stale transactions.

Reference: NextGraph CRDT and Semantic Web Docs :contentReference[oaicite:0]{index=0}

3.2 Task Schema

Tasks are organized hierarchically, allowing complex projects to be broken into manageable subtasks. Each task:

  • Binds to specific vouchers that fund its execution.
  • Inherits currency values dynamically from subtasks.
  • Is represented in a consistent RDF/JSON‑LD format for semantic querying via SPARQL.

3.3 Decentralized Storage

Exonomy uses NextGraph’s CRDT-backed, local-first repositories to store documents securely:

  • Encryption: Data is encrypted at rest (AES‑256‑GCM) and in transit using the Noise protocol.
  • Local Persistence: Each Exonomist’s data resides in a local repository, with selective replication ensuring only necessary data is shared.

3.4 P2P Protocol

The NextGraph P2P protocol ensures:

  • Selective Data Replication: Data is shared only with relevant peers.
  • Pub/Sub Overlays: Updates (such as new vouchers or task changes) are pushed to subscribers.
  • Conflict Resolution: CRDT merging ensures eventual consistency without centralized control.

4. Exonomy Mechanics

4.1 Voucher Lifecycle

The lifecycle of a voucher includes:

  • Minting: Creation of a voucher by an Exonomist, stored locally.
  • Transfer: Voucher data is included in a transaction when used as payment, triggering selective replication.
  • Redemption: Only the voucher’s issuer or designated parties can redeem it, ensuring accountability.
  • Revocation & Expiry: Unredeemed or invalid vouchers can be revoked, returning control to the issuer.

4.2 Transaction Flows

Exonomy supports various transaction types:

  • Voucher-for-Voucher Exchange: Barter transactions where vouchers are directly exchanged.
  • Fiat Integration: Payment via Stripe/PayPal that mints corresponding vouchers post-clearance.
  • Pending Approvals: Transactions remain pending until the voucher owner explicitly approves, ensuring controlled state transitions.

4.3 Real-World Integration

Exonomy integrates with external systems by:

  • Mapping Vouchers to Real-World Currencies: Vouchers reference central bank currencies (e.g., cbdc:USD) rather than invented tokens.
  • Regulatory Compliance: Metadata includes issuer details and jurisdiction, facilitating audits.
  • Third-Party Payment Processors: Seamlessly integrating fiat transactions without exposing full voucher details globally.

5. Exocracy Mechanics

5.1 Project Management

Exocracy’s project management module enables:

  • Hierarchical Task Delegation: Breaking down projects into tasks and subtasks with clear objectives.
  • Crowdfunding & Crowdsourcing: Exonomists propose vouchers to fund tasks or claim tasks based on their expertise.
  • Dependency Management: Ensuring that higher-level tasks aggregate the outcomes and values of their subtasks.

5.2 Community Dynamics

Exocracy fosters localized communities where:

  • Formation: Each task defines a temporary community of PMs, providers, and funders.
  • Unanimous Governance: All members of a task’s community must agree to key actions, such as task completion or voucher release.
  • Role-Based Capabilities: Differentiating responsibilities between project managers, providers, and crowdfunders.

5.3 Task Execution

Task execution is supported by:

  • Onboarding & Validation: Ensuring that participants meet eligibility criteria.
  • Progress Tracking: Submitting periodic updates and evidence to validate task progress.
  • Finalization: Releasing vouchers only upon unanimous approval and meeting predefined criteria.

6. Governance & Trust

6.1 Reputation System

A dual-layer reputation system tracks:

  • EXO-SCORE: Reflecting historical economic contributions and reliability.
  • EXOCRAT-SCORE: Evaluating leadership, governance, and project management performance.
  • Dynamic Adjustments: Real-time updates based on successful transactions and dispute outcomes.

6.2 Dispute Resolution

Dispute resolution is managed by:

  • Asset Freezing: Temporarily halting disputed transactions.
  • Community Arbitration: Employing a peer-selected jury to resolve conflicts through evidence-based decision-making.
  • Rage-Quit Mechanism: Allowing participants to exit a task while preserving their prior contributions.

6.3 Consensus Mechanisms

Decisions in Exonomy are reached via:

  • Unanimous Consent: Critical actions require 100% approval within the task community.
  • Threshold Signatures: Ensuring cryptographic validation of key decisions.
  • Optional Quadratic Voting: For weighted influence in broader community decisions.

7. Selective Replication, Smart Contracts & Capability Tokens

This new section integrates insights from your recent document and NextGraph’s guidelines to address key challenges in decentralized voucher systems.

7.1 Selective Replication Model

  • What It Is:
    Vouchers and transactions are not globally replicated. Instead, data is shared only with Exonomists directly involved in a transaction or those who follow another’s public feed.
  • Why It Matters:
    With millions of users and hundreds of vouchers per wallet, it is impractical and inefficient to replicate all data locally. Selective replication ensures privacy and scalability by only synchronizing pertinent information.
  • How It Works:
    • Local-First Repositories: Each Exonomist’s data is stored in a personal CRDT-backed repository ([NextGraph CRDT Docs :contentReference[oaicite:1]{index=1}]).
    • Decentralized Indexing & Bloom Filters: A lightweight index (using probabilistic data structures) summarizes public “for sale” voucher metadata without replicating full voucher details.
    • On-Demand Fetching: When an Exonomist searches or follows another, a SPARQL query (e.g., SELECT ?voucher WHERE { ?voucher exo:status exo:ForSale }) fetches only the relevant voucher data, which is then “pinned” locally until the user chooses to “unpin.”

7.2 Smart Contracts for Voucher Transactions

  • What They Are:
    Smart contracts in Exonomy are WASM-based finite state machines that automatically enforce the rules of voucher transactions, from sale to escrow to final approval.
  • Why They Are Essential:
    They automate critical processes such as holding vouchers in escrow until the seller’s approval, enforcing time-bound offers, requiring multi-signature approvals for high-value transactions, and managing dispute resolution—all without central authority.
  • How They Work:
    • State Transitions:
      A typical voucher sale contract might progress through the states: ListedPendingApprovedCompleted (or Revoked if canceled). For example, when a baker lists a voucher, it is stored locally as Listed. When a buyer requests to purchase, the contract moves it to Pending. The seller must then call an approve action to change the state to Completed, triggering replication of the voucher to the buyer’s repository.
    • Conditional Logic & Multi-Sig:
      For high-value transactions, the contract can require multiple cryptographic signatures from designated trustees before approving the transfer.
    • Integration with NextGraph:
      Smart contracts interact with NextGraph’s CRDT and Pub/Sub layers, ensuring that state changes are merged across peers. Example pseudocode (in Rust/WASM) demonstrates these transitions, and NextGraph’s documentation provides further details on contract deployment ([NextGraph Smart-Contract Docs :contentReference[oaicite:2]{index=2}]).

7.3 Capability Token Framework

  • What It Is:
    Capability tokens are cryptographically signed tokens (similar to UCAN tokens) that grant specific access rights to voucher data during transactions.
  • Why They Are Critical:
    They ensure that only the intended recipient (or follower) can access and replicate a voucher. This mechanism prevents unauthorized replication and protects the privacy of Exonomists.
  • How They Work:
    • Token Structure:
      Each token includes permissions (e.g., read or write access), the target resource URI (such as a specific voucher), an expiry date, and is signed by the issuer’s private key. For example, when a baker transfers a voucher to a mechanic, the transaction includes a token that grants the mechanic read access to that voucher, along with the necessary details (currency, amount, etc.).
    • Enforcement:
      NextGraph’s replication protocol checks the capability token before allowing data to be replicated to the recipient’s repository.
    • Real-World Currency Compliance:
      Tokens incorporate references to central bank currencies (e.g., using cbdc:USD) to ensure that vouchers are clearly defined and legally compliant.
    • Integration with Smart Contracts:
      When a transaction is initiated, the smart contract generates and verifies a capability token, ensuring that the voucher is only shared with authorized parties.

8. Health Metrics & Analytics

8.1 Ayurvedic Triadic Framework

Exonomy’s health is monitored through a layered framework:

  • Vata (Movement/Adaptability): Measures transaction velocity, user engagement, and responsiveness.
  • Pitta (Transformation/Strategy): Assesses trust levels (Red/Black Ratio), qualitative impact of transactions, and strategic allocation of resources.
  • Kapha (Stability/Reliability): Tracks redemption rates, cumulative contributions, and long-term data retention.

8.2 Dashboards

Dashboards provide a comprehensive view:

  • Individual Performance: Displays personal trust metrics and transaction history.
  • Community Health: Visualizes localized economic stability and task progress.
  • Systemic Resilience: Aggregates data to monitor the overall robustness of the decentralized network.

9. Humanitarian & Conflict Resilience

Exonomy and Exocracy are designed to function in adverse conditions:

  • Offline-First CRDT Sync: Ensures data consistency in low-connectivity or conflict zones.
  • Mesh Networking & Brokers: Maintain replication and communication even in disrupted environments.
  • Decentralized Oracles: Enable local validators to confirm transactions and support rapid post-conflict recovery efforts.

10. Conclusion

This document defines the full vision and scope of Exonomy and Exocracy. By integrating decentralized storage, selective replication, smart contracts, and a robust capability token framework (all built atop NextGraph’s CRDT and semantic web foundations), Exonomy provides a secure, scalable, and privacy-preserving ecosystem for local economic activity. Future iterations will continue to refine these features based on community feedback and real-world deployment experiences.


Last Updated: February 2025

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment