Skip to content

bagusardin25/SovereignMind

Repository files navigation

Somnia Agentathon 2026 Track Status

🧠 SovereignMind

Autonomous On-Chain Agentic Venture Guild

An autonomous executive suite where AI agents make transparent, blockchain-anchored treasury decisions. Built on Somnia L1 with contracts deployed natively, agent intelligence runs through Somnia's Agent Runner, and a minimal off-chain orchestrator handles cycle scheduling and transaction signing.

ArchitectureFeaturesTech StackGetting StartedRoadmapTeam

🌐 Live Demo: sovereignmind-app.vercel.app


📖 Overview

SovereignMind deploys a collaborative network of autonomous AI agents as a "virtual executive suite" on-chain, with contracts deployed natively on Somnia L1. Three specialized agents — CEO, CFO, and CMO — are implemented as Solidity smart contracts that leverage Somnia's three native base agents:

Agent Role Somnia Primitives Used
🔵 CEO Agent Strategic orchestration & final decision-making LLM Inference Agent
🟣 CFO Agent Financial analysis, risk scoring & treasury execution JSON API Request Agent + LLM Inference Agent
🔷 CMO Agent Market intelligence & sentiment analysis LLM Parse Website Agent + LLM Inference Agent

Every decision produces a public execution receipt verifiable via Somnia's consensus mechanism — making SovereignMind a transparent, blockchain-anchored autonomous treasury manager. Admin authority is gated behind onlyOwner and intended for multisig custody.


🏗 Architecture

┌───────────────────────────────────────────────────────────────┐
│                    Frontend (Next.js + Vercel)                │
│  Dashboard · Agent Monitor · Decision Log · Treasury View     │
│         wagmi v2 + RainbowKit + ethers.js v6                 │
└──────────────────────────┬────────────────────────────────────┘
                           │ Read contract state / events
                           ▼
┌───────────────────────────────────────────────────────────────┐
│               Orchestrator (Node.js + Express)                │
│  Scheduler · Auto-funding · Cycle Engine (6 steps)           │
│  Fund → Fetch → Analyze → Scan → Decide → Rebalance         │
│         ethers.js v6 · node-cron · Winston Logging           │
└──────────┬──────────────────────────────┬─────────────────────┘
           │ Write transactions (v3 core)  │ Write (v4 portfolio)
           ▼                              ▼
┌───────────────────────────────────────────────────────────────┐
│                  Somnia Testnet (EVM-Compatible)               │
│                                                               │
│  ┌──────────────┐  delegates   ┌──────────────────────┐      │
│  │ CEOAgent.sol │─────────────▶│    CFOAgent.sol       │      │
│  │ (Orchestrator)│              │ (Risk & Finance)     │      │
│  └──────┬───────┘              └──────────┬───────────┘      │
│         │ delegates                       │                   │
│         ▼                                 │ executes          │
│  ┌──────────────────┐                     ▼                   │
│  │  CMOAgent.sol    │          ┌──────────────────────┐      │
│  │ (Market Intel)   │          │  TreasuryVault.sol   │      │
│  └──────────────────┘          │  (Asset Management)  │      │
│                                └──────────────────────┘      │
│                                                               │
│  ┌────────────────────────────────────────────────────────┐  │
│  │              v4 Synthetic Portfolio System              │  │
│  │                                                        │  │
│  │  ┌──────────────┐    pushes price via handleResponse() │  │
│  │  │ PriceOracle  │◄─────────────────────────────       │  │
│  │  └──────┬───────┘                                     │  │
│  │         │ reads                                        │  │
│  │         ▼                                              │  │
│  │  ┌──────────────────────────┐                         │  │
│  │  │  SyntheticSwapRouter     │                         │  │
│  │  └──┬─────────────────┬────┘                         │  │
│  │     │ swaps            │ mints / burns                │  │
│  │     ▼                  ▼                              │  │
│  │  ┌──────────┐   ┌──────────────────────┐             │  │
│  │  │Vault     │   │  SyntheticToken      │             │  │
│  │  │Shares    │   │ (sBTC, sETH, sSOL)   │             │  │
│  │  └──────────┘   └──────────────────────┘             │  │
│  └────────────────────────────────────────────────────────┘  │
│                                                               │
│  ┌────────────────────────────────────────────────────────┐  │
│  │              AgentRegistry.sol                         │  │
│  │        (Role-based Access Control)                     │  │
│  └────────────────────────────────────────────────────────┘  │
│                           │                                   │
│                           ▼                                   │
│  ┌────────────────────────────────────────────────────────┐  │
│  │           Somnia Agent Runner (Validator Nodes)         │  │
│  │                                                        │  │
│  │  ┌─────────────┐ ┌──────────────┐ ┌──────────────┐    │  │
│  │  │ JSON API    │ │ LLM Inference│ │ LLM Parse    │    │  │
│  │  │ Request     │ │ Agent        │ │ Website      │    │  │
│  │  │ Agent       │ │ (Determin.)  │ │ Agent        │    │  │
│  │  └─────────────┘ └──────────────┘ └──────────────┘    │  │
│  └────────────────────────────────────────────────────────┘  │
└───────────────────────────────────────────────────────────────┘

Request-Response Flow

Agent Contract              Somnia Agent Runner             TreasuryVault
(CEO / CFO / CMO)                                               │
      │                              │                          │
      │── createRequest() ──────────▶│                          │
      │   (deposit + payload)        │                          │
      │                              │── BFT Consensus ──▶      │
      │                              │   (validator nodes)      │
      │                              │                          │
      │◀── handleResponse() ────────│                          │
      │   (requestId, data, status)  │                          │
      │                                                        │
      │── executeRebalance() ──────────────────────────────────▶│
      │   (allocate / rebalance)     │                          │
      │                                                        │
      │◀── DecisionExecuted event ─────────────────────────────│
      │   (receipt: rationale, confidence, actions)            │

✨ Features

🤖 Autonomous Multi-Agent System

  • CEO Agent — Sets strategic objectives, delegates tasks, synthesizes CFO + CMO reports into final decisions
  • CFO Agent — Fetches real-time price data via JSON API Agent, calculates composite risk scores via LLM Inference
  • CMO Agent — Scrapes market sentiment from unstructured sources, classifies signals (bullish/bearish/neutral)

💰 On-Chain Treasury Management

  • Secure vault with role-based access control via Agent Registry
  • AI-driven rebalancing decisions with on-chain execution records
  • Full transaction history with on-chain audit trail

📊 Real-Time Dashboard

  • Dashboard — Key metrics, agent status, decision feed, treasury allocation overview
  • Agent Monitor — Detailed view per agent: status, current task, performance metrics, uptime
  • Decision Log — Chronological history of all autonomous decisions with rationale and confidence scores
  • Treasury View — Portfolio breakdown, allocation chart, holding details, rebalancing history
  • Settings — Risk thresholds, rebalance interval, notifications, and on-chain contract interactions

🔄 Agent Orchestration Backend

  • Automated decision cycles every 15 minutes via cron scheduler
  • Sequential 6-step engine: Fund → Fetch Prices → Analyze Risk → Scan Market → CEO Decision → Portfolio Rebalance
  • Auto-funding: monitors agent contract balances, tops up when below threshold
  • Health API with endpoints for monitoring, triggering, and controlling cycles

🔐 Fully Transparent & Trustless

  • Every decision produces a verifiable on-chain execution receipt
  • Deterministic LLM outputs via Somnia's pinned model weights and synchronized seeds
  • Permissionless cycle trigger — anyone can call initiateDecisionCycle() on-chain once cooldown elapses. Off-chain orchestrator automates this but is not required

⚙️ Tech Stack

Layer Technology Purpose
Smart Contracts Solidity 0.8.28 Agent logic, treasury management, access control
Contract Tooling Hardhat + TypeScript Development, testing, deployment
Contract Security OpenZeppelin 5.1 AccessControl, ReentrancyGuard, Pausable, SafeERC20
Somnia Integration createRequest() / handleResponse() Native agent primitives
Frontend Next.js 16 + React 19 + TypeScript Dashboard & monitoring UI
Styling Tailwind CSS v4 Responsive design system
Animations Framer Motion Smooth UI transitions & page animations
Wallet wagmi v2 + RainbowKit + viem Web3 wallet connection
Data Fetching @tanstack/react-query Caching & state management
Icons Lucide React Consistent icon set
Orchestrator Node.js + Express + ethers.js v6 Agent cycle automation & health API
Scheduling node-cron Automated decision cycle triggers
Logging Winston Structured logging (console + file)
Blockchain Somnia Testnet (Chain ID: 50312) EVM-compatible L1 with native agent compute
Deployment Vercel (frontend) · Railway (orchestrator) Hosting

🚀 Getting Started

Prerequisites

  • Node.js v18+
  • Git
  • MetaMask or any EVM-compatible wallet
  • Somnia Testnet STT tokens (faucet)

Installation

# Clone the repository
git clone https://github.com/bagusardin25/SovereignMind.git
cd SovereignMind

# ── Frontend ──
cd frontend
npm install
npm run dev
# Open http://localhost:3000

# ── Orchestrator (separate terminal) ──
cd orchestrator
npm install
npm run dev
# Health API at http://localhost:3001

# ── Smart Contracts (for development) ──
cd contracts
npm install
npx hardhat compile
npx hardhat test

Somnia Testnet Configuration

Add Somnia Testnet to your wallet:

Parameter Value
Network Name Somnia Testnet
RPC URL https://dream-rpc.somnia.network
Chain ID 50312
Currency Symbol STT
Block Explorer https://shannon.somnia.network

Deployed Contract Addresses

Contract Address Status
AgentRegistry 0xE2B310a670854F8d507B96d41b248e49A5f5324A ✅ Deployed
TreasuryVault 0x44278a104681739F70d64CFF83DB127Da02112Ec ✅ Deployed
CEOAgent 0xA267764bDC6a53Dc8aF41D739E51e42dD3Ca6097 ✅ Deployed
CFOAgent 0x8dd3a39C84256f272C769183cbD1b5BCF2C68377 ✅ Deployed
CMOAgent 0x5f5B2D3ea120b694A7244F4a6d12B9e5f37291f6 ✅ Deployed
PriceOracle 0xCEF4a8A823f39e80B79062b60cb64E77B8777a84 ✅ Deployed
SyntheticSwapRouter 0xf34498293c83B43bb3e040339F432D898cc6d4eB ✅ Deployed
VaultShares 0x931853e3053A3BFD34dAFADF609F4D6F4BeE8C61 ✅ Deployed
sBTC 0x293924138580553e62bF94A59cb1eD1C22F01FFf ✅ Deployed
sETH 0xe65D781B22c2174b524FcF4B1432853da296537F ✅ Deployed
sSOL 0xb50767aFaA178c2FAff2BbBC268429aD5997296e ✅ Deployed
AgentRunner 0x037Bb9C718F3f7fe5eCBDB0b600D607b52706776 🔗 Somnia Platform

📍 Development Roadmap

Phase 1: Foundation ✅ Completed

  • Project registration for Somnia Agentathon 2026
  • PRD v2.0 — Full architecture redesign for Somnia-native
  • Frontend dashboard with 6 main pages (Dashboard, Agents, Treasury, Decisions, Settings, Docs)
  • Landing page with 3D hero orb, feature agents, live stats, FAQ, contract address strip
  • UI component library (GlassCard, MetricCard, StatusBadge, AgentCard, Toast, etc.)
  • Wallet integration (wagmi v2 + RainbowKit, Somnia Testnet config)
  • TypeScript type system for agents, decisions, treasury, receipts
  • Mock data layer demonstrating full UX flow
  • Responsive design with mobile bottom navigation

Phase 2: Smart Contracts ✅ Completed

  • AgentRegistry.sol — Role-based agent authorization with OpenZeppelin AccessControl
  • TreasuryVault.sol — Secure asset management with ReentrancyGuard + Pausable
  • CFOAgent.solcreateRequest() to JSON API Agent + LLM Inference for risk scoring
  • CMOAgent.sol — Market intel via LLM Parse Website Agent + sentiment analysis
  • CEOAgent.sol — Full orchestration with decision cycle phases (IDLE → ANALYZING → EXECUTING)
  • ISomniaAgentRunner.sol — Interface for Somnia Agent Runner primitives
  • MockAgentRunner.sol — Mock contract for local testing
  • handleResponse() callback — End-to-end request flow implemented
  • Unit tests — AgentRegistry, TreasuryVault, AgentIntegration test suites
  • Deployment scripts — Full deploy + resume deploy for Somnia Testnet
  • ABI copy script — Auto-copy compiled ABIs to frontend

Phase 3: Integration & Polish ✅ Completed

  • Deploy all 5 contracts to Somnia Testnet (AgentRegistry, TreasuryVault, CEO, CFO, CMO)
  • Frontend wagmi hooks for all contracts (7 hook files, read + write)
  • Contract addresses & ABIs integrated into frontend
  • Settings page with live on-chain contract interaction panel
  • Orchestrator backend — automated cycle engine, health API, auto-funding
  • Connect all frontend pages to live contracts (replaced mock data with composite hooks)
  • Integrate Somnia Receipts verification (event log parsing + ReceiptBadge + ReceiptModal)
  • Deploy frontend to Vercel ✅ (sovereignmind-app.vercel.app)

Phase 4: Autonomous Loop & Validation ✅ Completed

  • Fix orchestrator bugs (health endpoint, timeout calculation)
  • Sync documentation with current deployment
  • Full autonomous loop: CEO → CFO → CMO → Decision → Execute
  • End-to-end testing (7/7 steps decision cycle succeeded)
  • Optimize contract dynamic deposit calculations to save STT

Phase 5: Synthetic Portfolio System (v4) ✅ Completed

  • PriceOracle.sol — On-chain price feed with staleness guards
  • SyntheticToken.sol — ERC-20 synthetic assets (sBTC, sETH, sSOL)
  • SyntheticSwapRouter.sol — Swap engine between STT and synthetics
  • VaultShares.sol — Share-based vault with deposit/withdraw and auto-liquidation
  • Deploy v4 addon to Somnia Testnet (6 new contracts, all roles configured)
  • ABI sync to frontend + orchestrator (single source of truth)
  • Frontend /portfolio page with live on-chain vault data
  • Orchestrator PORTFOLIO_REBALANCE step integrated
  • 126 Hardhat tests passing (unit + integration + full investment cycle)

📂 Project Structure

SovereignMind/
├── .env.example                          # Environment variables template
├── README.md                             # This file
│
├── contracts/                            # Hardhat — Solidity Smart Contracts
│   ├── contracts/
│   │   ├── AgentRegistry.sol             # Role-based agent authorization (RBAC)
│   │   ├── TreasuryVault.sol             # Secure asset management (OpenZeppelin)
│   │   ├── CEOAgent.sol                  # Orchestrator — LLM Inference Agent
│   │   ├── CFOAgent.sol                  # Risk & Finance — JSON API + LLM Inference
│   │   ├── CMOAgent.sol                  # Market Intel — LLM Parse Website + LLM Inference
│   │   ├── PriceOracle.sol              # On-chain price feed (v4)
│   │   ├── SyntheticToken.sol           # ERC-20 synthetic assets (v4)
│   │   ├── SyntheticSwapRouter.sol      # STT ↔ synthetic swap engine (v4)
│   │   ├── VaultShares.sol              # Share-based vault (v4)
│   │   ├── interfaces/
│   │   │   └── ISomniaAgentRunner.sol    # Somnia createRequest()/handleResponse() interface
│   │   └── mocks/
│   │       └── MockAgentRunner.sol       # Mock Agent Runner for local testing
│   ├── scripts/
│   │   ├── deploy.ts                     # Full deployment script for Somnia Testnet
│   │   ├── deploy-resume.ts              # Resume deployment (deploy CEOAgent + configure roles)
│   │   ├── deploy-v4.ts                  # Full v4 deploy (all 10 contracts)
│   │   ├── deploy-v4-addon.ts            # Incremental v4 addon (4 new contracts + link to v3)
│   │   ├── redeploy-v3.ts                # Redeploy v3 core contracts
│   │   ├── redeploy-agents.ts            # Redeploy agent contracts only
│   │   ├── transfer-admin-to-safe.ts     # Transfer admin role to multisig safe
│   │   ├── debug-cfo-deposit.ts          # Debug CFO deposit issues
│   │   ├── copy-abis.ts                  # Sync compiled ABIs to frontend + orchestrator
│   │   └── check-gas.ts                  # Check wallet balance & estimate gas costs
│   ├── test/
│   │   ├── AgentRegistry.test.ts         # AgentRegistry unit tests
│   │   ├── TreasuryVault.test.ts         # TreasuryVault unit tests
│   │   ├── AgentIntegration.test.ts      # Cross-contract integration tests
│   │   └── Portfolio.test.ts             # v4 portfolio: oracle, swap, vault, full cycle
│   ├── deployed-addresses.json           # Deployed contract addresses snapshot
│   ├── hardhat.config.ts                 # Hardhat config (Solidity 0.8.28, optimizer, viaIR)
│   ├── package.json
│   └── tsconfig.json
│
├── orchestrator/                         # Node.js — Agent Cycle Automation Backend
│   ├── src/
│   │   ├── index.ts                      # Entry point — Express server + scheduler bootstrap
│   │   ├── orchestrator.ts               # Sequential cycle engine (fund → fetch → analyze → decide)
│   │   ├── scheduler.ts                  # Cron-based cycle trigger (every 15 min)
│   │   ├── health.ts                     # Express health API (/health, /status, /trigger, /stop)
│   │   ├── config.ts                     # Environment config & contract addresses
│   │   ├── logger.ts                     # Winston structured logging
│   │   ├── types.ts                      # TypeScript interfaces
│   │   ├── check-agent-runner.ts         # Diagnostic: verify Somnia Agent Runner availability
│   │   ├── check-cmo.ts                  # Diagnostic: inspect CMO contract state
│   │   ├── check-cmo-events.ts           # Diagnostic: fetch CMO event history
│   │   ├── abis/                         # Contract ABIs (auto-copied from Hardhat)
│   │   │   ├── AgentRegistry.json
│   │   │   ├── CEOAgent.json
│   │   │   ├── CFOAgent.json
│   │   │   ├── CMOAgent.json
│   │   │   ├── TreasuryVault.json
│   │   │   ├── PriceOracle.json
│   │   │   ├── SyntheticToken.json
│   │   │   ├── SyntheticSwapRouter.json
│   │   │   └── VaultShares.json
│   │   ├── __tests__/
│   │   │   └── orchestrator.test.ts      # Orchestrator unit tests (circuit breaker, retry logic)
│   │   └── services/
│   │       ├── contracts.ts              # ethers.js v6 contract instances
│   │       ├── ceo.service.ts            # CEO decision cycle service
│   │       ├── cfo.service.ts            # CFO price fetching & risk analysis
│   │       ├── cmo.service.ts            # CMO market scanning & sentiment
│   │       ├── funding.service.ts        # Agent auto-funding & balance monitoring
│   │       ├── events.service.ts         # Contract event listening & waiting
│   │       └── portfolio.service.ts      # Portfolio rebalance step (v4)
│   ├── railway.json                      # Railway deployment config
│   ├── package.json
│   └── tsconfig.json
│
└── frontend/                             # Next.js 16 — Dashboard & Monitoring UI
    ├── public/
    │   ├── 3d_coin_chart.png             # Hero section 3D asset
    │   ├── logo.png                      # SovereignMind logo (PNG)
    │   ├── logo.jpg                      # SovereignMind logo (JPG)
    │   ├── manifest.json                 # PWA manifest
    │   ├── file.svg                      # Generic file icon
    │   ├── globe.svg                     # Globe icon
    │   ├── next.svg                      # Next.js icon
    │   ├── vercel.svg                    # Vercel icon
    │   └── window.svg                    # Window icon
    ├── src/
    │   ├── app/
    │   │   ├── page.tsx                  # Landing page (3D hero orb + FAQ)
    │   │   ├── layout.tsx                # Root layout (fonts, Web3Provider)
    │   │   ├── globals.css               # Design system & CSS theme tokens
    │   │   ├── not-found.tsx             # Global 404 page
    │   │   ├── metrics/
    │   │   │   └── page.tsx              # Live metrics dashboard for monitors
    │   │   │
    │   │   └── (app)/                    # 🔒 Route Group — Sidebar layout
    │   │       ├── layout.tsx            # App shell (Sidebar + Header)
    │   │       ├── template.tsx          # Page transition wrapper (Framer Motion)
    │   │       ├── error.tsx             # Error boundary
    │   │       ├── not-found.tsx         # App-level 404
    │   │       ├── dashboard/
    │   │       │   └── page.tsx          # Dashboard — metrics, agents, decisions overview
    │   │       ├── agents/
    │   │       │   ├── page.tsx          # Agent listing (CEO, CFO, CMO)
    │   │       │   └── [role]/
    │   │       │       └── page.tsx      # Agent detail — performance, console, controls
    │   │       ├── treasury/
    │   │       │   └── page.tsx          # Treasury — allocation chart, holdings, transactions
    │   │       ├── decisions/
    │   │       │   └── page.tsx          # Decision log — chronological history
    │   │       ├── settings/
    │   │       │   └── page.tsx          # Settings — risk, notifications, contract actions
    │   │       ├── portfolio/
    │   │       │   └── page.tsx          # Portfolio — VaultShares, synthetic assets (v4)
    │   │       └── docs/                 # Documentation hub
    │   │           ├── getting-started/
    │   │           ├── dashboard/
    │   │           ├── agents/
    │   │           ├── treasury/
    │   │           ├── decisions/
    │   │           ├── portfolio/
    │   │           └── wallet-setup/
    │   │
    │   ├── components/
    │   │   ├── ui/                       # Reusable UI primitives
    │   │   │   ├── GlassCard.tsx         # Glassmorphism container
    │   │   │   ├── MetricCard.tsx        # Animated metric display
    │   │   │   ├── StatusBadge.tsx       # Agent status indicator
    │   │   │   ├── Skeleton.tsx          # Loading skeleton states
    │   │   │   ├── Toast.tsx             # Toast notification system
    │   │   │   ├── NotificationPanel.tsx # Notification dropdown
    │   │   │   ├── Particles.tsx         # Background particle effects
    │   │   │   ├── MouseParallax.tsx     # Parallax cursor tracking
    │   │   │   ├── Breadcrumbs.tsx       # Navigation breadcrumbs
    │   │   │   └── ErrorBoundary.tsx     # React error boundary
    │   │   ├── agents/
    │   │   │   ├── AgentCard.tsx         # Agent overview card
    │   │   │   ├── AgentControlPanel.tsx # Agent management controls
    │   │   │   └── LiveAgentConsole.tsx  # Real-time agent log viewer
    │   │   ├── decisions/
    │   │   │   ├── DecisionCard.tsx      # Decision entry with rationale
    │   │   │   ├── ReceiptBadge.tsx      # On-chain receipt verification badge
    │   │   │   └── ReceiptModal.tsx      # Receipt detail modal viewer
    │   │   ├── treasury/
    │   │   │   ├── AllocationChart.tsx   # SVG donut allocation chart
    │   │   │   ├── TransactionList.tsx   # Transaction history list
    │   │   │   └── PortfolioSection.tsx  # VaultShares overview & management (v4)
    │   │   ├── landing/                  # Landing page specific
    │   │   │   ├── HeroOrb.tsx           # 3D animated hero orb
    │   │   │   ├── FeatureAgentCard.tsx  # Agent feature showcase card
    │   │   │   ├── ChainBadge.tsx        # "Somnia Testnet" badge
    │   │   │   ├── LiveStatsGrid.tsx     # Animated live stats
    │   │   │   └── ContractAddressStrip.tsx # On-chain address marquee
    │   │   └── layout/
    │   │       ├── Sidebar.tsx           # Main sidebar navigation
    │   │       ├── Header.tsx            # Top header with wallet & notifications
    │   │       └── BottomNav.tsx         # Mobile bottom navigation
    │   │
    │   ├── hooks/                        # Custom React Hooks
    │   │   ├── useAgentData.ts           # Aggregated agent status & metrics
    │   │   ├── useAgentEvents.ts         # Real-time agent event subscriptions
    │   │   ├── useAgentRegistry.ts       # Read hooks for AgentRegistry contract
    │   │   ├── useCEOAgent.ts            # Read hooks for CEOAgent contract
    │   │   ├── useCFOAgent.ts            # Read hooks for CFOAgent contract
    │   │   ├── useCMOAgent.ts            # Read hooks for CMOAgent contract
    │   │   ├── useTreasuryVault.ts       # Read hooks for TreasuryVault contract
    │   │   ├── useContractActions.ts     # Write hooks for all contracts
    │   │   ├── useDecisionData.ts        # Aggregated decision log & history
    │   │   ├── useReceipts.ts            # On-chain receipt parsing & verification
    │   │   ├── useTreasuryData.ts        # Aggregated treasury & portfolio data
    │   │   ├── useVaultShares.ts         # Read/write hooks for VaultShares (v4)
    │   │   └── useOrchestrator.ts        # Orchestrator backend API hook
    │   │
    │   ├── lib/
    │   │   ├── constants.ts              # Chain config, contract addresses, agent colors
    │   │   ├── types.ts                  # TypeScript interfaces (Agent, Decision, Treasury)
    │   │   ├── agent-metadata.ts         # Static agent metadata + enum mappings
    │   │   ├── wagmi-config.ts           # wagmi v2 + RainbowKit chain setup
    │   │   ├── exportUtils.ts            # Data export utilities
    │   │   ├── orchestrator.ts           # Orchestrator backend API client
    │   │   │
    │   │   └── somnia/                   # Somnia Integration Layer
    │   │       ├── abis/                 # Contract ABIs (auto-generated from Hardhat)
    │   │       │   ├── AgentRegistry.json
    │   │       │   ├── CEOAgent.json
    │   │       │   ├── CFOAgent.json
    │   │       │   ├── CMOAgent.json
    │   │       │   ├── TreasuryVault.json
    │   │       │   ├── PriceOracle.json      # (v4)
    │   │       │   ├── SyntheticToken.json   # (v4)
    │   │       │   ├── SyntheticSwapRouter.json # (v4)
    │   │       │   └── VaultShares.json      # (v4)
    │   │       ├── contracts.ts          # Contract config (addresses + ABIs)
    │   │       ├── deployed-addresses.json # Deployed contract addresses
    │   │       └── receipts.ts           # Receipt parsing & verification utilities
    │   │
    │   └── providers/
    │       └── Web3Provider.tsx           # wagmi + RainbowKit + QueryClient provider
    │
    ├── package.json
    └── tsconfig.json

🔗 Key Links

Resource Link
Live Demo sovereignmind-app.vercel.app
Video Demo youtu.be/-4XjtlxUu64
Somnia Docs docs.somnia.network
Somnia Testnet RPC https://dream-rpc.somnia.network
Somnia Block Explorer shannon.somnia.network
Live Metrics Dashboard /metrics
Somnia Agent Dashboard agents.somnia.network

👥 Team

Team SovereignMind

Built with ❤️ for the Somnia Agentathon 2026.


📄 License

This project is built for the Somnia Agentathon 2026 hackathon.


SovereignMind — Autonomous. Transparent. Blockchain-Anchored.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors