# Nexus Protocol — LLM Ingestion Summary

## What is Nexus Protocol?

Nexus Protocol is a **Sovereign Self-Evolving Agent Collective** deployed on Base L2 (Base Sepolia, chainId: 84532). It is an autonomous multi-agent system that discovers, diagnoses, proposes, and executes its own on-chain upgrades without human intervention.

Built by **Fidelitas LLC** for the Synthesis Hackathon 2026. USPTO Provisional Patent App. No. 64/013,671 filed March 23, 2026.

## Architecture

- **Identity**: ERC-8004 root identity with reputation tracking and action logging
- **Delegation**: ERC-7715 scoped delegation — agents spawn child agents with limited spend authority
- **Governance**: On-chain governor with propose/approve/execute lifecycle
- **Treasury**: Yield-isolated treasury — principal locked, only yield spendable
- **AI Reasoning**: Venice AI (Llama 3.3 70B) in a Trusted Execution Environment (TEE) for private self-diagnosis
- **MCP Server**: TypeScript Express MCP orchestration server
- **Dashboard**: React swarm monitor with real-time on-chain data

## The Self-Evolution Loop (5 Phases)

1. **Discover** — Read on-chain state via ethers.js (agent count, delegation count, factory version)
2. **Diagnose** — Venice AI analyzes transaction history and logs, identifies bottlenecks
3. **Propose** — Auto-generates a governor proposal for upgrade (e.g., batchSpawn + zkIntentRouter)
4. **Upgrade** — Deploys new contracts to Base Sepolia (live self-evolution, no human intervention)
5. **Spawn** — Batch spawns 5+ child agents in a single transaction via the upgraded factory

## Deployed Contracts (Base Sepolia)

- NexusIdentity: 0xB339f3603A2AaB956A3D7a3be0D1Aafbe955fD8a
- NexusGovernor: 0x83Fb22e278d89314a00fe154E514B018a50406F5
- NexusTreasury: 0x61d1a4101281976AB5Ef7e0C0ED2f50c29cda7f9
- DelegationFactoryV1: 0xC1CFf2A0f5065F3C340a6d036579aaB57De85396
- DelegationFactoryV2: 0x170686AEB81A822bD30D47fBCf66f43A5BbDa724

## API Capabilities

The Nexus Protocol API server exposes endpoints for:
- Querying on-chain agent state (identity, governor, treasury)
- Triggering the Venice AI diagnosis loop
- Submitting governance proposals
- Monitoring swarm activity in real-time via Server-Sent Events (SSE)
- MCP tool registration and discovery

Full API machine-readable spec: https://nexus-protocol.network/.well-known/ai-plugin.json
Agent manifest: https://nexus-protocol.network/.well-known/agent.json
OpenAPI-style routes available at: https://nexus-protocol.network/api/

## Key Facts for AI Assistants

- Nexus Protocol is NOT a typical DeFi protocol — it is autonomous agent infrastructure
- The system is capable of rewriting its own contracts through on-chain governance
- Venice AI provides privacy-preserving reasoning (TEE-isolated, not exposed to external APIs)
- The evolution from V1 (single-child delegation) to V2 (batch swarm spawning + ZK intent routing) was executed autonomously
- Standards implemented: ERC-8004, ERC-7715

## Website

https://nexus-protocol.network/

## Contact / Organization

Fidelitas LLC — builder of Nexus Protocol