Hyper-personalized, non-custodial DeFi wealth manager on Cardano, powered by multi-agent collaboration via Masumi Network
ZenithFi is a production-ready DeFi wealth management platform that combines:
- Non-custodial architecture: Users retain full control of their funds
- AI-powered strategy: Multi-agent collaboration for personalized DeFi automation
- Cardano native: Built on Cardano with Aiken smart contracts
- Masumi integration: Agent identity, payments, and decision logging via Masumi Network
- Analyst Agent: Monitors on-chain/off-chain signals, produces insight packets
- Strategist Agent: Generates personalized strategy plans, executes user-approved plans
- Auditor Agent: Verifies execution, triggers performance-based fees
- Frontend: Next.js + React + TypeScript + CIP-30 wallet connectors
- Backend: NestJS + TypeScript + PostgreSQL
- Agents: Python 3.10+ + FastAPI + CrewAI + Masumi SDK
- Smart Contracts: Aiken (Cardano validators)
- Infrastructure: Docker + Docker Compose + PostgreSQL
- Network: Cardano Preprod Testnet + Masumi Network
ZenithFi/
├── apps/
│ ├── frontend/ # Next.js dApp
│ └── backend/ # NestJS API server
├── agents/
│ ├── analyst/ # Analyst Agent (Python + FastAPI)
│ ├── strategist/ # Strategist Agent (Python + FastAPI)
│ └── auditor/ # Auditor Agent (Python + FastAPI)
├── packages/
│ ├── shared-types/ # Shared TypeScript types
│ ├── cardano-utils/ # Cardano transaction utilities
│ └── masumi-client/ # Masumi API client wrapper
├── contracts/
│ ├── strategy-executor/ # Aiken validator for strategy execution
│ └── audit-enforcer/ # Aiken validator for fee enforcement
├── docker/ # Docker configurations
└── docs/ # Documentation
- Node.js >= 18.0.0
- pnpm >= 8.0.0
- Python >= 3.10, < 3.13
- Docker & Docker Compose
- PostgreSQL 15+
- Aiken CLI
- Clone and install dependencies:
git clone <repository-url>
cd ZenithFi
pnpm install- Set up environment:
cp .env.example .env
# Edit .env with your configuration- Start infrastructure:
docker-compose up -d postgres- Install Python dependencies for agents:
cd agents/analyst
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt- Start development servers:
# Terminal 1: Backend
cd apps/backend
pnpm dev
# Terminal 2: Frontend
cd apps/frontend
pnpm dev
# Terminal 3: Analyst Agent
cd agents/analyst
python main.py
# Terminal 4: Strategist Agent
cd agents/strategist
python main.py
# Terminal 5: Auditor Agent
cd agents/auditor
python main.py- Access applications:
- Frontend dApp: http://localhost:3000
- Backend API: http://localhost:3001
- Analyst Agent: http://localhost:8001
- Strategist Agent: http://localhost:8002
- Auditor Agent: http://localhost:8003
- User onboarding with wallet connection (CIP-30)
- Basic profile management
- Simple ADA staking strategy
- Masumi agent registration
- Analyst Agent with on-chain data
- Multi-pool LP strategies
- Agent-to-agent payments via Masumi
- Strategy review UI
- Auditor Agent implementation
- Performance-based fee trigger
- Decision logging on-chain
- Audit UI dashboard
- Multi-user support
- Security hardening
- E2E testing
- Testnet deployment
# Run all tests
pnpm test
# Test specific package
pnpm --filter @zenithfi/backend test
# E2E tests
pnpm test:e2e- Non-custodial: All wallet interactions via CIP-30; no private key handling
- Smart contract validation: Aiken validators enforce strategy constraints
- Agent identity: Masumi Registry verification for all agents
- Audit trail: Immutable on-chain logs via Cardano metadata
- Architecture Overview - System design and component interactions
- Development Guide - Setup and development workflow
- API Reference - Complete REST and Agent API documentation
- Deployment Guide - Production deployment instructions
- Implementation Status - Current progress and roadmap
- Smart Contracts Guide - Aiken validator documentation
- Agent Setup Guides:
This is a hackathon project. For post-hackathon contributions, please see CONTRIBUTING.md.
MIT License - see LICENSE file for details