Skip to content

omsant02/3SIPS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

3SIPS - Autonomous Defi Yield Engine

Autonomous Cross-Chain Investment Platform powered by AI

WhatsApp Image 2025-06-30 at 07 58 49_5f28c617

Features β€’ Architecture β€’ Quick Start β€’ Development

Avalanche Chainlink ElizaOS

🌟 Overview

3SIPS is the world's first autonomous AI agent that manages real cryptocurrency investments across multiple blockchains. Built on Avalanche with Chainlink Automation and ElizaOS, it creates Systematic Investment Plans (SIP) and autonomously optimizes portfolios through natural language interaction.

🎯 Use Cases

  • Automated Crypto SIPs: Set up systematic investment plans with AI management
  • Cross-Chain Yield Optimization: Maximize returns across Avalanche ecosystem
  • Emergency Fund Protection: AI-powered crisis management and fund security
  • Natural Language DeFi: Interact with complex protocols through simple chat

✨ Features

  • πŸ€– AI-Powered Management: Autonomous portfolio optimization and rebalancing
  • ⚑ Chainlink Automation: Recurring deposits without manual intervention
  • πŸŒ‰ Cross-Chain Intelligence: Smart fund distribution across Fuji, Echo, Dispatch
  • πŸ’¬ Natural Language Interface: Create SIPs and manage funds through conversation
  • πŸ›‘οΈ Emergency Protection: Automated security protocols and fund locking
  • πŸ“Š Real-Time Monitoring: Live portfolio tracking across all chains

πŸ— Architecture

User (Natural Language)
         ↓
    ElizaOS AI Agent
         ↓
   Chainlink Automation
         ↓
    Smart Contracts
         ↓
Multi-Chain Distribution (ICTT)

Multi-Chain Strategy

  • πŸ”οΈ Fuji Chain (30%): Liquidity hub and main SIP management
  • 🌊 Echo Chain (60%): High-yield farming
  • ⚑ Dispatch Chain (10%): Emergency protection and security

πŸš€ Technical Stack

  • AI Framework: ElizaOS for conversational AI and autonomous decisions
  • Automation: Chainlink Automation for scheduled deposits
  • Cross-Chain: Avalanche ICTT for seamless multi-chain transfers
  • Smart Contracts: Solidity deployed on Avalanche Fuji/Echo/Dispatch
  • Backend: TypeScript, Node.js, ethers.js
  • Frontend: React with Web3 integration

πŸš€ Quick Start

Prerequisites

Node.js >= v18.18
Bun package manager
MetaMask wallet
AVAX testnet tokens

Installation

# Clone the repository
git clone https://github.com/omsant02/3SIPS.git
cd 3SIPS

# Install dependencies
bun install

Environment Setup

# Copy environment template
cp .env.example .env

# Add your configuration
OPENAI_API_KEY=your_openai_key
AI_AGENT_PRIVATE_KEY=your_private_key
FUJI_HOME_CONTRACT=0xD3f07713bB0D4816E23Ec66C666E0e7721C3b337

Start the AI Agent

# Build the project
bun run build

# Start the agent
bun run start

Make Your First Investment

πŸ’¬ "Create a SIP plan with 20 tokens monthly for retirement"
πŸ€– "Creating your autonomous investment plan across 3 chains..."

πŸ›  Development

Local Setup

# Install dependencies
bun install

# Start development mode
bun run dev

# Run tests
bun test

Smart Contract Deployment

# Deploy to Fuji testnet
forge script script/Deploy.s.sol --rpc-url $FUJI_RPC_URL --broadcast

# Verify contracts
forge verify-contract $CONTRACT_ADDRESS src/ERC20TokenHome.sol:ERC20TokenHome

πŸ“‹ Environment Variables

# Essential Configuration
OPENAI_API_KEY=your_openai_api_key
AI_AGENT_PRIVATE_KEY=your_wallet_private_key
USER_WALLET_ADDRESS=demo_user_address

# Contract Addresses (Pre-deployed)
SIP_TOKEN_ADDRESS=0xa7E756116aC6b0819e0d7f7354C21417e1e0b2A7

FUJI_HOME_CONTRACT=0xD3f07713bB0D4816E23Ec66C666E0e7721C3b337

ECHO_REMOTE_CONTRACT=0xD3f07713bB0D4816E23Ec66C666E0e7721C3b337

DISPATCH_REMOTE_CONTRACT=0xa7E756116aC6b0819e0d7f7354C21417e1e0b2A7


# RPC Endpoints
FUJI_RPC_URL=https://api.avax-test.network/ext/bc/C/rpc
ECHO_RPC_URL=https://subnets.avax.network/echo/testnet/rpc
DISPATCH_RPC_URL=https://subnets.avax.network/dispatch/testnet/rpc

SIP image

Fuji image

ECHO image

DISPATCH image

πŸ’¬ Example Commands

Create Investment Plan

πŸ’¬ "Create a SIP plan with 50 tokens monthly for retirement"
πŸ€– "Perfect! Creating your retirement SIP with automated deposits..."

Check Portfolio Status

πŸ’¬ "Show me my portfolio status"
πŸ€– "Your portfolio: 150 SIP across 3 chains - Fuji: 45, Echo: 90, Dispatch: 15"

Cross-Chain Transfer

πŸ’¬ "Move 10 tokens from fuji to echo for better yields"
πŸ€– "Executing cross-chain transfer for yield optimization..."

Emergency Protection

πŸ’¬ "Emergency! Protect my funds!"
πŸ€– "Emergency protocols activated across all chains. Funds secured."

πŸ”— Live Integrations

Chainlink Automation

Contract Addresses

πŸ”οΈ Fuji Home:     0xD3f07713bB0D4816E23Ec66C666E0e7721C3b337
🌊 Echo Remote:    0xD3f07713bB0D4816E23Ec66C666E0e7721C3b337  
⚑ Dispatch Remote: 0xa7E756116aC6b0819e0d7f7354C21417e1e0b2A7
πŸͺ™ SIP Token:      0xa7E756116aC6b0819e0d7f7354C21417e1e0b2A7
πŸ€– AI Agent:       0x565A693cB0838e8ea2A8BBdb3b749893E7ED7f9d

🎯 How It Works

1. User Interaction

Users interact with the AI agent through natural language commands to create SIPs, check balances, or manage their portfolio.

2. AI Decision Making

The ElizaOS-powered agent analyzes market conditions and makes autonomous decisions about fund allocation and optimization strategies.

3. Automated Execution

Chainlink Automation triggers recurring deposits, while the AI executes cross-chain transfers using Avalanche ICTT for optimal yield.

4. Portfolio Optimization

Funds are distributed across three specialized chains:

  • Fuji: Stability and liquidity (30%)
  • Echo: High-yield farming (60%)
  • Dispatch: Emergency security (10%)

πŸ”’ Security Features

Smart Contract Security

  • Multi-signature controls and emergency pause mechanisms
  • Authorized agent system with cryptographic validation
  • Fund locking capabilities and automated security responses

AI Agent Security

  • Private key management with secure wallet integration
  • Transaction signing protocols and emergency override capabilities
  • Real-time threat detection and response

πŸ“Š Performance Metrics

  • ⚑ Transaction Speed: <30 seconds for cross-chain transfers
  • πŸ’° Yield Optimization: Up to 5.2% APY on Echo chain
  • πŸ›‘οΈ Security: 99.9% uptime with emergency protection
  • πŸ€– AI Response: <2 seconds for natural language processing

🌍 Supported Networks

Network Chain ID Purpose Contract
Avalanche Fuji 43113 Main Hub 0xD3f07713...
Avalanche Echo 173750 Yield Farming 0xD3f07713...
Avalanche Dispatch 779672 Emergency 0xa7E756116a...

πŸŽ‰ Try It Now!

Experience the future of autonomous investing:

  1. πŸ”— Connect: Link your wallet to the platform
  2. πŸ’¬ Chat: Create your SIP plan with natural language
  3. πŸ€– Relax: Watch AI optimize your investments 24/7
  4. πŸ’° Profit: Enjoy automated cross-chain yield optimization

The future of investment management is autonomous, cross-chain, and AI-powered. πŸš€


Built with ❀️ for the Chainlink Chromion Hackathon 2025

Made possible by: Avalanche β€’ Chainlink β€’ ElizaOS

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published