Della - Agentic Consumer DeFi on Sonic Network

"If your grandma can do it, anyone can do it!" 🎯

An AI-powered DeFi platform that makes decentralized finance accessible to everyone through natural language interaction, gasless smart wallets, and cross-chain portfolio management powered by Orby.

🚀 What It Does

Della transforms complex DeFi operations into simple conversations:

🤖 AI Assistant: Natural language commands for all DeFi operations
⚡ Gasless Smart Wallets: ERC-4337 accounts powered by Pimlico
🔗 MetaMask Integration: Import existing wallets seamlessly
📊 Real-time DeFi Data: Live yield opportunities and protocol information
🔄 Batch Transactions: Multiple operations in a single gasless transaction
🌐 Cross-Chain Holdings: Unified portfolio view across all chains via Orby
💼 Portfolio Management: Automated DeFi strategies and yield farming
🌉 Cross-Chain Bridging: Seamless asset transfers between networks

✨ Key Features

Smart Wallet Management

Create new ERC-4337 smart wallets instantly
Import existing MetaMask wallets with private key
Gasless transactions on Sonic Network
Social recovery ready
Multi-wallet support with individual management

AI-Powered Commands

"Create a new wallet"
"Import my MetaMask wallet"
"Send 0.1 SONIC to 0x1234..."
"Check my balance"
"Show me yield opportunities"
"Batch send from wallet 1"
"Show my holdings across all chains"
"Create portfolio with $100"
"Bridge 0.5 ETH from Ethereum to Sonic"

Cross-Chain Portfolio Analysis

Orby Integration: Unified view of all your tokens across multiple chains
Real-time Holdings: Live token balances and USD values
Chain Distribution: See how your wealth is distributed across networks
Gas Optimization: Identify the best tokens for gas payments
Multi-chain Support: Ethereum, Sonic, Polygon, Arbitrum, Optimism, Base, BSC, and more

DeFi Integration

Real-time yield data from DeFiLlama
Protocol recommendations
TVL tracking
Top chains and protocols information
Automated portfolio strategies

Cross-Chain Bridging

Bridge assets between major networks
Support for Ethereum, Sonic, Polygon, and more
Optimized routing for best rates
Gas cost estimation

🛠️ Tech Stack

Frontend: React + TypeScript + Tailwind CSS
Backend: ElizaOS AI Framework
Blockchain: Sonic Network (Blaze Testnet) + Multi-chain support
Smart Accounts: ERC-4337 with Pimlico
DeFi Data: DeFiLlama API
Cross-Chain: Orby Protocol integration
AI: OpenAI/Anthropic integration
Portfolio Management: Automated DeFi strategies

🚀 Quick Start

Prerequisites

Node.js 18+ or Bun
MetaMask wallet (optional)
Orby API access (for cross-chain features)

Installation

# Clone the repository
git clone <your-repo-url>
cd Della

# Install dependencies
npm install
# or
bun install

# Set up environment variables
cp .env.example .env
# Add your API keys to .env

# Start development server
npm run dev
# or
bun run dev

Environment Variables

Create a .env file in the root directory with the following variables:

# AI Provider (choose one)
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
OPENROUTER_API_KEY=your_openrouter_key
OPENROUTER_SMALL_MODEL=mistralai/mistral-small-3.2-24b-instruct:free
OPENROUTER_LARGE_MODEL=mistralai/mistral-small-3.2-24b-instruct:free
OPENROUTER_IMAGE_MODEL=mistralai/mistral-small-3.2-24b-instruct:free

# Pimlico API (for gasless transactions)
PIMLICO_API_KEY=your_pimlico_api_key

# Orby Integration (for cross-chain features)
ORBY_PRIVATE_INSTANCE_URL=your_orby_private_instance_url

# Blockchain Configuration
PRIVATE_KEY=your_private_key_for_deployment
REPORT_GAS=true

# Optional: Discord/Telegram bots
DISCORD_API_TOKEN=your_discord_token
TELEGRAM_BOT_TOKEN=your_telegram_token

# Optional: Ignore bootstrap
IGNORE_BOOTSTRAP=false

Required API Keys

AI Provider: Choose one of OpenAI, Anthropic, or OpenRouter
Pimlico API: Get your API key from Pimlico
Orby API: Required for cross-chain features from Orby
Private Key: Your wallet private key for deployment (keep secure!)

📚 Documentation Flow

Getting Started

Setup: Follow the installation steps above
Configuration: Set up your .env file with required API keys
Deploy: Deploy smart contracts to Sonic Blaze Testnet
Test: Try the basic wallet creation and management features

Core Features

1. Smart Wallet Management

Create Wallet: Generate new ERC-4337 smart wallets
Import Wallet: Import existing MetaMask wallets
Gasless Transactions: Send tokens without gas fees
Batch Operations: Multiple transactions in one gasless call

2. Cross-Chain Portfolio Analysis

Unified View: See all tokens across all chains
Real-time Balances: Live updates of token values
Chain Distribution: Understand your portfolio allocation
Gas Optimization: Find best tokens for gas payments

3. DeFi Portfolio Management

Automated Strategies: Set-and-forget DeFi strategies
Yield Farming: Optimize for highest APY opportunities
Risk Management: Diversified portfolio allocation
Performance Tracking: Monitor your DeFi returns

4. Cross-Chain Bridging

Asset Transfers: Bridge tokens between networks
Optimized Routing: Best rates and lowest fees
Status Tracking: Monitor bridge transaction progress

Advanced Usage

Portfolio Management Commands

# Create a balanced portfolio
"Create portfolio with $100 SONIC"

# Check portfolio performance
"Show my portfolio performance"

# Rebalance portfolio
"Rebalance my portfolio now"

# Add new tokens
"Add wBTC to my portfolio"

Cross-Chain Operations

# View all holdings
"Show my holdings across all chains"

# Check specific chain
"Show my Ethereum holdings"

# Optimize gas payments
"Which tokens should I use for gas?"

Smart Wallet Operations

# Create new wallet
"Create a new smart wallet"

# Import existing wallet
"Import my MetaMask wallet"

# Send tokens
"Send 10 SONIC to 0x1234..."

# Batch transactions
"Send 5 SONIC to wallet 1 and 3 SONIC to wallet 2"

🎯 Usage Examples

Creating a Wallet

User: "I need a new wallet"
AI: ✅ Your new smart wallet has been created!
    📍 Smart Contract Address: 0x...
    🔑 EOA Address: 0x...
    🔐 Private Key: 0x...
    🌐 Network: Sonic Blaze Testnet

Cross-Chain Holdings Analysis

User: "Show my holdings across all chains"
AI: 💎 PORTFOLIO OVERVIEW (Orby-Powered)

    🔗 Wallet: 0xB240...909a
    💰 Total Value: $1,230.05
    🌐 Coverage: 9 chains • 9 tokens

    📊 CHAIN DISTRIBUTION
    🥇 Ethereum Sepolia $1,021.85 (83.1%)
    🥈 Optimism Sepolia $1,021.85 (83.1%)
    🥉 Arbitrum Sepolia $1,021.85 (83.1%)

    🪙 TOKEN BREAKDOWN
    │ ETH 0.0500 $993.30 • Holesky
    │ USDC <0.001 $28.55 • Ethereum Sepolia
    │ SONIC 0.1234 $123.86 • Sonic Blaze Testnet

Portfolio Management

User: "Create portfolio with $100"
AI: 🎯 Creating your DeFi portfolio...
    💰 Initial Investment: $100
    📊 Strategy: Balanced (Yield + Growth)
    🔄 Auto-rebalancing: Enabled
    📈 Expected APY: 8-15%

🧪 Testing

# Run all tests
npm test

# Component tests only
npm run test:component

# E2E tests only
npm run test:e2e

# Cypress tests
npm run cy:test

📁 Project Structure

src/
├── smart-account-plugin/     # ERC-4337 wallet management
│   ├── action.ts            # Wallet actions (create, import, send)
│   ├── holdingsActions.ts   # Cross-chain holdings analysis
│   ├── eoaActions.ts        # EOA wallet management
│   ├── service.ts           # Pimlico wallet service
│   └── provider.ts          # Blockchain interactions
├── portfolio-plugin/         # DeFi portfolio management
│   ├── service.ts           # Portfolio service
│   ├── actions/             # Portfolio actions
│   └── keeper/              # Automated strategies
├── bridge-plugin/            # Cross-chain bridging
│   ├── action.ts            # Bridge actions
│   ├── service.ts           # Bridge service
│   └── provider.ts          # Bridge providers
├── defillama-plugin/        # DeFi data integration
│   ├── action.ts            # DeFi data actions
│   ├── service.ts           # DeFiLlama service
│   └── provider.ts          # API interactions
├── frontend/                # React UI components
└── index.ts                 # Main entry point

🔧 Development

# Start development with hot-reloading
npm run dev

# Build for production
npm run build

# Type checking
npm run type-check

# Format code
npm run format

🌐 Network Information

Primary Network

Network: Sonic Blaze Testnet
Chain ID: 57054
RPC URL: https://rpc.blaze.soniclabs.com
Explorer: https://testnet.sonicscan.org
Faucet: https://testnet.soniclabs.com/account

Supported Networks (via Orby)

Ethereum: Mainnet, Sepolia, Goerli
Sonic: Mainnet, Blaze Testnet
Polygon: Mainnet, Mumbai, Amoy
Arbitrum: One, Goerli, Sepolia
Optimism: Mainnet, Goerli, Sepolia
Base: Mainnet, Goerli, Sepolia
BSC: Mainnet, Testnet
Holesky: Testnet
Sonic: Blaze Testnet

🚀 Advanced Features

Cross-Chain Holdings

Unified View: See all your tokens across all chains in one place
Real-time Updates: Live balance and value updates
Gas Optimization: Identify the best tokens for gas payments on each chain
Portfolio Analytics: Chain distribution and token breakdown

Portfolio Management

Automated Strategies: Set-and-forget DeFi strategies
Yield Farming: Optimize for highest APY opportunities
Risk Management: Diversified portfolio allocation
Performance Tracking: Monitor your DeFi returns

Smart Account Features

Gasless Transactions: No more gas fees for basic operations
Batch Transactions: Multiple operations in one transaction
Social Recovery: Secure wallet recovery options
Multi-signature: Enhanced security for large transactions

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Sonic Network for the blockchain infrastructure
Pimlico for gasless smart account technology
Orby Protocol for cross-chain portfolio unification
DeFiLlama for DeFi data
ElizaOS for the AI framework

Built with ❤️ for the Sonic Ecosystem

Making DeFi accessible to everyone! 👵💙

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
portfolio-manager		portfolio-manager
scripts		scripts
src		src
.env.example		.env.example
.gitignore		.gitignore
Della.png		Della.png
README.md		README.md
bun.lock		bun.lock
bunfig.toml		bunfig.toml
cypress.config.ts		cypress.config.ts
debug-orby-portfolio.ts		debug-orby-portfolio.ts
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
test-wallet-creation.js		test-wallet-creation.js
tsconfig.build.json		tsconfig.build.json
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts
vite.config.ts		vite.config.ts

Folders and files

Latest commit

History

Repository files navigation

Della - Agentic Consumer DeFi on Sonic Network

🚀 What It Does

✨ Key Features

Smart Wallet Management

AI-Powered Commands

Cross-Chain Portfolio Analysis

DeFi Integration

Cross-Chain Bridging

🛠️ Tech Stack

🚀 Quick Start

Prerequisites

Installation

Environment Variables

Required API Keys

📚 Documentation Flow

Getting Started

Core Features

1. Smart Wallet Management

2. Cross-Chain Portfolio Analysis

3. DeFi Portfolio Management

4. Cross-Chain Bridging

Advanced Usage

Portfolio Management Commands

Cross-Chain Operations

Smart Wallet Operations

🎯 Usage Examples

Creating a Wallet

Cross-Chain Holdings Analysis

Portfolio Management

🧪 Testing

📁 Project Structure

🔧 Development

🌐 Network Information

Primary Network

Supported Networks (via Orby)

🚀 Advanced Features

Cross-Chain Holdings

Portfolio Management

Smart Account Features

🤝 Contributing

📄 License

🙏 Acknowledgments

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages