v1.1

Co-authored-by: JulesCrown <admin@noip.localhost>
Reviewed-on: http://gitea.loseyourip.com:4000/giteadmin/SoLUSH-3/pulls/16

tokenomics.md

@@ -1,163 +0,0 @@
-# Home of Dumplings / \$DPL Tokenomics
-
-## 1. Overview
-
-The Home of Dumplings protocol deploys AI agents that solve optimization problems for DeFi users and protocols, addressing tasks such as liquidity management and parameter tuning. The ecosystem operates through **Tasks** hosted on-chain and populations of solution programs evolved off-chain by the Optimizer Pool.
-
-**\$DPL** is the native token powering this ecosystem. Its primary roles include:
-
-1. **Payment**: Clients pay invocation or subscription fees in \$DPL.
-2. **Staking and Governance**: Token holders stake \$DPL to secure the protocol, join the optimizer pool or participate in governance.
-3. **Rewards**: Optimizer Pool nodes earn \$DPL for validated contributions to the evolution of programs.
-
----
-
-## 2. Token Supply and Distribution
-
-### Fixed Supply
-
-- **Total Supply**: \$DPL has a fixed supply (e.g., 100M tokens), minted at genesis.
-- **No Inflation**: No further token minting or emission beyond the initial allocation.
-
-### Allocation of Supply
-
-1. **Uniswap V3 Liquidity Pool**
-
-   - All of the supply is allocated to a Uniswap V3 liquidity pool over a wide price range.
-   - Multiple price ranges hold extra liquidity to ensure stable price discovery.
-
-2. **Team**
-
-   - A vesting contract purchases a small portion (e.g., 10-15%) of the cheapest tokens from the pool right after deployment and allocates them to the team.
-
-3. **Treasury**
-
-   - An NFT minting contract purchases a small portion (e.g., 5-10%) right after the vesting contract before other buyers come in. The tokens are packaged into nice-looking NFTs.
-   - These NFTs are sold on marketplaces like OpenSea, redeemable for tokens. The proceeds are transferred to the team multisig, forming the treasury.
-
----
-
-## 3. Revenue Model
-
-### Fee Structure
-
-1. **Invocation Fees**
-
-   - Charged for AI agents evolved with synthetic data.
-   - Paid in \$DPL or other currencies auto-converted into \$DPL and routed to the protocol reward pools.
-
-2. **Subscription Fees**
-
-   - Charged for AI agents evolved with synthetic data initially, but are continuously improved by backtesting with real data.
-   - Periodic payment in \$DPL or other currencies auto-converted into \$DPL and routed to the protocol reward pools.
-
-### Reward Allocation
-
-- A portion of the fees collected funds rewards for the Optimizer Pool nodes that contribute validated solutions to Tasks.
-- Governance determines the exact split between:
-  - Optimizer Pool rewards.
-  - Treasury for operational funding.
-  - Potential staking rewards.
-
----
-
-## 4. Staking
-
-### Types of Stakers
-
-1. **Council Node Stakers**
-
-   - Nodes in the Optimizer Pool stake \$DPL to become eligible for selection to the Council.
-   - Council members validate and vote on improved solutions to Tasks.
-   - **Slashing Mechanism**: If a Council member votes against the majority decision, they are penalized by slashing a portion of their staked tokens.
-
-2. **Investor Stakers**
-
-   - Investors stake \$DPL to earn a share of the protocol’s revenue.
-   - Revenue is comprised of invocation and subscription fees, a part is distributed as staking rewards.
-
-### Risk Backstop
-
-- Stakers collectively backstop potential risks associated with the AI agents.
-- If an AI agent malfunctions (e.g., outputs suboptimal or incorrect decisions due to flaws in the algorithm), affected users may be compensated via the staking pool, reducing the system’s reputational and financial risk.
-- Governance defines the conditions for such compensations, ensuring fairness and transparency.
-
----
-
-## 5. Governance
-
-Voting weight is proportional to the amount of \$DPL staked.
-
-### Governance Mechanics
-
-1. **Voting Rights**
-
-   - All stakers can participate in governance, regardless of whether they are nodes or investors.
-   - Proposals focus on:
-     - Adjusting fee parameters (e.g., invocation and subscription fees).
-     - Allocating Optimizer Pool rewards.
-     - Defining compensation rules for Risk Backstop events.
-
-2. **Council Randomness**
-
-   - Optimizer Pool nodes with staked \$DPL can be selected for the Council via a verifiable random selection process.
-   - The Council validates and votes on improved solutions to Tasks.
-
----
-
-## 6. NFT-Based Early Bird Mechanism
-
-1. **Purpose**
-
-   - Raise initial funding and incentivize early supporters.
-
-2. **Mechanics**
-
-   - NFTs represent the right to claim a specified quantity of \$DPL at a discounted rate.
-   - Sold on marketplaces like OpenSea.
-
-3. **Redemption**
-
-   - Upon redemption, the NFT is burned, and the holder receives their allocated \$DPL.
-   - Vesting or time locks may apply to align with protocol growth.
-
----
-
-## 7. Fee Usage and Distribution
-
-- **Optimizer Pool Rewards**: A fraction of collected fees funds rewards for Optimizer Pool nodes.
-- **Treasury**: Supports operations, development, and marketing initiatives.
-- **Stakers**: Receive a share of fees as staking rewards, subject to governance decisions.
-
----
-
-## 8. Launch and Go-to-Market Strategy
-
-### Initial Liquidity Deployment
-
-- Deploy a majority of \$DPL supply into Uniswap V3 pools.
-- Use multiple concentrated price ranges to establish liquidity depth and facilitate market stability.
-
-### Early Bird NFT Sale
-
-- Launch a curated NFT collection for discounted \$DPL rights.
-- Drive initial funding and engage early adopters.
-
-### Target Customers
-
-- Position DeFi protocols as key customers for SoLUSH’s optimization services.
-- Focus marketing on showcasing cost-saving and performance-enhancing use cases.
-
----
-
-## 9. Conclusion
-
-The \$DPL tokenomics framework is designed to:
-
-- Provide immediate utility through payment and staking mechanisms.
-- Incentivize Optimizer Pool participation via rewards for validated solutions.
-- Ensure sustainable growth through fixed supply, governance, and clear fee allocation.
-
-This structure ensures the long-term viability and scalability of the SoLUSH ecosystem, while fostering community involvement and alignment with protocol goals.
-
-

vision.md

@@ -1,8 +1,47 @@
-# SoLUSH: Running Intelligence On-Chain
+# Sovraigns: Intelligence Where LLMs Can't Reach
 
-In decentralized finance, systems often involve tasks such as determining optimal liquidity ranges for automated market makers, allocating staking rewards in a way that balances fairness and participation incentives, or dynamically adjusting collateralization ratios to minimize risks in lending protocols. These challenges are critical for ensuring the efficiency and stability of protocols, yet they are particularly difficult to address without centralization. Off-chain solutions often rely on external computation and centralized entities or oracles, introducing trust dependencies and undermining the decentralized ethos of blockchain systems.
+## The DeFi Intelligence Paradox
 
-Artificial intelligence is increasingly being explored in decentralized finance to enhance token ecosystems and liquidity management. This shift represents a practical application of AI tools aimed at addressing complex optimization problems directly within blockchain ecosystems. While large language models (LLMs) dominate discussions around AI innovation due to their general-purpose capabilities, they are poorly suited to the demands of decentralized adaptive systems. In contrast, **genetic algorithms** (GAs) offer a more natural and efficient fit for systems requiring iterative improvements, combining computational simplicity with adaptive behavior.
+Decentralized finance protocols are caught in an impossible dilemma. They desperately need sophisticated optimization to remain competitive - determining optimal liquidity ranges for automated market makers, dynamically adjusting collateralization ratios, allocating staking rewards efficiently. Yet the very nature of their decentralization prevents them from using modern AI solutions.
+
+**The paradox is stark:**
+1. **Protocols need intelligence** - Complex market dynamics and adversarial environments require adaptive, sophisticated algorithms
+2. **They can't trust centralized AI** - Using OpenAI APIs or centralized optimizers defeats the entire purpose of decentralization
+3. **They can't run AI on-chain** - Even simple neural networks would cost millions in gas fees
+
+This creates a fundamental barrier: **DeFi protocols need intelligence to compete, but using intelligence makes them centralized.**
+
+Current "solutions" like external oracles and trusted computation providers are just band-aids that reintroduce the very centralization DeFi was meant to eliminate. When a protocol relies on Chainlink for price feeds or Gauntlet for parameter optimization, they're trusting a centralized entity that could be compromised, censored, or simply fail.
+
+## Sovraigns: Bringing Intelligence On-Chain
+
+Sovraigns enables verifiable intelligence directly within blockchain systems through a breakthrough combination of **genetic algorithms**, **zero-knowledge proofs**, and **based rollups**.
+
+The key innovation: algorithms are evolved off-chain, registered on a sidechain after validation, and then executed with zero-knowledge proofs whenever protocols need optimization. The proofs are batched in a based rollup that inherits Ethereum's security, enabling trustless intelligence at scale.
+
+## The Market Opportunity
+
+The inefficiencies in DeFi represent a massive, growing market:
+
+| **DeFi Inefficiency** | **Annual Value Lost** | **Root Cause** |
+|---|---|---|
+| Uniswap V3 LP Losses | ~$400M | Suboptimal position management |
+| Lending Protocol Inefficiency | ~$300M | Conservative parameters |
+| MEV/Arbitrage Extraction | ~$800M | Predictable protocol behavior |
+| **Total Market** | **$1.5B+** | **Lack of intelligent optimization** |
+
+As DeFi grows and becomes more complex, this problem compounds. With DeFi TVL exceeding $50B and growing, the market for intelligent optimization could reach **$10B+ within 5 years**.
+
+### Current Solutions vs. Sovraigns
+
+| **Aspect** | **Current Solutions** | **Sovraigns** |
+|---|---|---|
+| **Trust Model** | Centralized (Gauntlet, Chaos Labs) | Trustless ZK proofs |
+| **Accessibility** | Enterprise contracts only | Permissionless for all protocols |
+| **Transparency** | Black box optimization | Fully auditable algorithms |
+| **Cost** | High consulting fees | Pay-per-optimization |
+| **Adaptability** | Manual updates | Continuous evolution |
+| **Security** | Single point of failure | Decentralized validation |
 
 ## **Introduction to Genetic Algorithms**
 
@@ -13,41 +52,121 @@ Genetic algorithms (GAs) are optimization techniques inspired by the process of
 - **Selection:** The process of choosing the best-performing solutions to carry forward.
 - **Crossover and Mutation:** Methods to combine and modify solutions, creating new ones that explore the problem space.
 
-Through repeated iterations, GAs converge toward optimal or near-optimal solutions, making them highly effective for solving complex, dynamic problems. GAs have recently gained momentum with the development of the [Push 3 language](http://faculty.hampshire.edu/lspector/push3-description.html) by Lee Spector. Push 3’s compact and efficient architecture shares similarities with stack-based virtual machine systems like the Ethereum Virtual Machine (EVM). Although not designed specifically for EVMs, Push 3’s simplicity and flexibility make it conceptually compatible with blockchain execution environments. Push 3 has achieved milestones such as evolving [programs for quantum computers](https://faculty.hampshire.edu/lspector/aqcp/) and supporting autoconstructive evolution. A Push 3 VM could facilitate the deployment of genetic algorithms in decentralized systems, leveraging Push 3’s support for expressive program evolution and adaptive behavior in tasks like resource optimization.
+Through repeated iterations, GAs converge toward optimal or near-optimal solutions, making them highly effective for solving complex, dynamic problems. The [Push 3 language](http://faculty.hampshire.edu/lspector/push3-description.html) by Lee Spector provides a particularly suitable foundation for genetic programming with its stack-based architecture and support for multiple typed stacks. Push 3 has demonstrated powerful capabilities including evolving [programs for quantum computers](https://faculty.hampshire.edu/lspector/aqcp/) and supporting autoconstructive evolution. Its design principles make it well-suited for implementation within zero-knowledge virtual machines, where its stack-based operations can be efficiently encoded as cryptographic constraints.
 
 ## On Agents
 
-An agent is defined as an entity capable of perceiving its environment, processing information, and taking autonomous actions to achieve specific objectives. LLMs can be structured into agents using frameworks that provide memory and feedback loops, but they do not fit on-chain and, at the same time, cannot securely manage secrets like private keys. Without either of these capabilities, LLM-based agents require external key management, increasing risks and undermining decentralized security principles. In contrast, genetic algorithms exhibit agentic characteristics by evolving their behavior over time to meet specific goals. When deployed on-chain within smart contracts, GAs can autonomously adapt to real-time inputs and optimize decisions, all while operating entirely within the secure and deterministic framework of blockchain systems.
+An agent is defined as an entity capable of perceiving its environment, processing information, and taking autonomous actions to achieve specific objectives. LLMs can be structured into agents using frameworks that provide memory and feedback loops, but they do not fit on-chain and, at the same time, cannot securely manage secrets like private keys. Without either of these capabilities, LLM-based agents require external key management, increasing risks and undermining decentralized security principles. In contrast, genetic algorithms exhibit agentic characteristics by evolving their behavior over time to meet specific goals. In the Sovraigns architecture, GAs execute off-chain with zero-knowledge proofs, enabling them to adapt to real-time inputs and optimize decisions while maintaining verifiable correctness and privacy.
 
 ---
 
 ## **Genetic Algorithms vs. LLMs for Decentralized Systems**
 
-1. **Efficiency and Feasibility for Blockchain Execution**
+| **Aspect** | **Large Language Models (LLMs)** | **Genetic Algorithms (GAs)** |
+|---|---|---|
+| **Computational Requirements** | Resource-intensive, requires GPUs and large memory | Lightweight, runs on standard hardware |
+| **Blockchain Compatibility** | Impractical for on-chain execution | Efficient for ZK-proof verification |
+| **Trust Model** | Requires external oracles and APIs | Fully verifiable with cryptographic proofs |
+| **Training/Evolution** | Centralized training on massive datasets | Distributed evolution across populations |
+| **Transparency** | Black box, opaque decision-making | Auditable fitness functions and evolution |
+| **Cost** | High inference costs, API fees | Low computational overhead |
+| **Adaptability** | Fixed after training, requires retraining | Continuous evolution to new conditions |
+| **Determinism** | Non-deterministic outputs | Deterministic with fixed random seeds |
+| **Privacy** | Data sent to external providers | Computation can be done privately |
 
-   - **LLMs are resource-intensive:** The computational complexity and size of LLMs make them impractical for direct execution in decentralized environments, where every operation incurs costs. Running even the simplest inference for an LLM would require off-chain computation and trust in external oracles, undermining decentralization.
-   - **GAs are lightweight:** Genetic algorithms, by design, are computationally efficient. Their iterative, population-based approach to optimization fits naturally into resource-constrained environments. This efficiency ensures GAs can evolve and execute entirely on-chain, preserving transparency and trustless execution.
+### Why Genetic Algorithms Win for DeFi
 
-2. **Evolution vs. Training**
-
-   - **GAs evolve in parallel:** Genetic algorithms enable evolutionary processes to run across distributed populations simultaneously. This parallelism contrasts with the centralized training required for deep neural networks, which demand synchronized computation and significant infrastructure. GAs’ decentralized nature aligns well with blockchain environments.
-
-   - **Deep neural networks require centralized training:** Neural networks demand substantial computational resources and centralized coordination to train effectively. 
-
-3. **Auditability of Evolution vs Training**
-
-   - **Training LLMs is opaque:** The progress of training deep neural networks is often difficult to evaluate and verify because testing its capabilities relies on secret data, which cannot be audited by external parties.
-   - **GAs offer transparent evolution:** Genetic algorithms allow the progress of evolution to be easily audited against a target fitness function. This process is fully observable and can be verified at each step with minimal effort.
+1. **Verifiability**: Every optimization can be proven correct with ZK proofs
+2. **Efficiency**: Orders of magnitude cheaper than LLM inference
+3. **Decentralization**: No dependency on centralized AI providers
+4. **Adaptability**: Algorithms evolve to match changing market conditions
+5. **Transparency**: Clear fitness functions align with protocol goals
 
 ---
 
-## **Theoretical Framework for Decentralized Algorithm Evolution**
+## **Theoretical Framework: Zero-Knowledge Intelligence on Based Rollups**
 
-A protocol providing agents as a service could leverage genetic algorithms to address complex problems within blockchain environments. Read through this [real-life usecase explaining the applicability of agents to DeFi](example.md). Central to such a system would be the development of a Push 3 Virtual Machine (VM), enabling efficient execution of genetic algorithms. An "Optimizer Pool", an network of nodes could collaboratively train and evolve these algorithms offchain. These nodes would compete to improve the fitness of the algorithms. Once an improvement, a measuruable better solution to the fitness function is found in off-chain computation, a node would submit it to be accepted into the population of solutions registered on chain, in exchange for a rewards payment by the protocol. The nodes of the optimizer pool would run under an incentivization model simira to proof-of-work systems.
+Sovraigns combines genetic programming with zero-knowledge proofs and based rollups to create the first truly decentralized intelligence layer for DeFi. The system leverages a custom Push 3 VM implementation in OpenVM for verifiable execution, with all coordination happening on a based rollup that inherits Ethereum's security.
 
-![Components](/components.png)
+### Architecture Overview
+
+The protocol operates across three layers:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                        ETHEREUM L1                              │
+│  • Final Settlement  • Proof Verification  • Protocol Updates   │
+└────────────────────────────┬───────────────────────────────────┘
+                             │ State Bridge
+┌────────────────────────────┴───────────────────────────────────┐
+│                      BASED ROLLUP (Sidechain)                  │
+│  • Task Registry    • Algorithm Storage    • Coordination      │
+│  • Reward Pools     • Version History      • Batch Requests    │
+└────────────────────────────┬───────────────────────────────────┘
+                             │ ZK Proofs
+┌────────────────────────────┴───────────────────────────────────┐
+│                     OFF-CHAIN COMPUTE                          │
+│  • Algorithm Evolution  • OpenVM Execution  • Proof Generation │
+│  • Council Validation   • Optimizer Competition                │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+| **Layer** | **Purpose** | **Key Components** |
+|---|---|---|
+| **Ethereum L1** | Final settlement and security | Smart contracts, State verification |
+| **Based Rollup** | Decentralized coordination | Task registry, Algorithm storage |
+| **Off-Chain** | Computation and evolution | OpenVM, Genetic algorithms, ZK proofs |
+
+### Based Rollup: Decentralized Coordination
+1. **Task Registration**: DeFi protocols register optimization tasks on the based rollup, including:
+   - Fitness functions (optimization goals)
+   - Evaluation parameters and constraints
+   - Reward pools for successful optimizations
+
+2. **Algorithm Registry**: The best algorithms for each task are registered on-chain after council validation
+   - Algorithm hashes stored on-chain for verification
+   - ZK proofs verify the exact algorithm (matching hash) was executed
+   - Version history maintained for auditability
+   - Permissionless access for all protocols
+
+3. **Execution Requests**: When protocols need optimization:
+   - Send request to based rollup with current data
+   - Request triggers off-chain execution
+   - Multiple requests batched for efficiency
+
+### Off-Chain: Evolution and Zero-Knowledge Execution
+1. **Algorithm Evolution**:
+   - Optimizers run genetic algorithms using standard Push 3 implementations
+   - Evolution happens on local high-performance infrastructure
+   - Best solutions submitted to council for validation
+   - No ZK proofs needed during evolution phase
+
+2. **Zero-Knowledge Proof Generation** (triggered by on-chain requests):
+   - Registered algorithms execute in OpenVM with request data
+   - OpenVM verifies the algorithm matches the on-chain hash
+   - STARK proofs generated via Plonky3
+   - Proofs include complete execution trace and results
+   - Multiple proofs batched into rollup blocks
+
+3. **Council Validation**: 
+   - Distributed validators verify algorithm improvements
+   - Consensus required before on-chain registration
+   - Ensures quality without centralized control
+
+### L1 Integration: Trustless Protocol Updates
+1. **State Bridge**: Based rollup posts state roots to Ethereum
+2. **Proof Verification**: Smart contracts verify STARK proofs
+3. **Action Execution**: DeFi protocols execute optimizations based on verified results
+
+### Key Components
+- **Registry (based rollup)**: Task and algorithm management with ZK verification
+- **OpenVM Runtime**: Custom Push 3 implementation for genetic programming
+- **Optimizers (off-chain)**: Compete to evolve better solutions
+- **Council (distributed)**: Validates algorithm quality before registration
+- **Proof Aggregator**: Batches multiple ZK proofs for efficient verification
+- **State Bridge**: Synchronizes rollup state with Ethereum L1
+
+This framework integrates off-chain computation with on-chain validation and deployment, ensuring scalable, transparent optimization. By decentralizing the process, it aligns incentives and fosters continuous improvement tailored to real-world DeFi needs. Ultimately, this system creates a foundation for scalable agent development, aligning with the broader concept of agents as a service, where users and protocols in DeFi can deploy and leverage optimized, evolving AI-agents tailored to specific tasks.
 
-To evaluate the effectiveness of distributed evolution, a "Council" mechanism needs to be created. This Council would consist of validators who execute the latest evolved algorithms and assess their performance against a predefined target fitness function. Validators would then cast votes on whether the new algorithms deliver measurable improvements. This transparent voting process ensures that only the most effective solutions are rewarded and integrated, fostering trust and collaboration across the Optimizer Pool. By aligning incentives with measurable progress, such a framework provides a reliable and decentralized method for advancing algorithmic evolution.
 
-Ultimately, this system creates a foundation for scalable agent development, aligning with the broader concept of agents as a service, where users and protocols in DeFi can deploy and leverage optimized, evolving algorithms tailored to specific tasks.