Send-AI

Your Complete Avalanche Ecosystem Navigator Powered by AI

Send-AI is a comprehensive Avalanche ecosystem explorer and cross-chain assistant that helps you discover subnets, manage AVAX staking, explore DeFi protocols, and bridge assets. Using natural language commands, Send-AI provides intelligent insights and optimization for all your Avalanche and cross-chain needs.

🎯 Vision

Make Avalanche ecosystem exploration and cross-chain DeFi as intuitive as having a conversation.

Key Features

• 🏔️ Avalanche Subnet Explorer: Discover gaming, DeFi, and enterprise subnets with validator analytics
• 🔥 AVAX Staking Assistant: Find optimal validators and calculate staking rewards
• 🌟 DeFi Protocol Navigator: Explore Trader Joe, BENQI, GMX, and other Avalanche protocols
• 🌉 Multi-Bridge Comparison: Compare Core Bridge, Stargate, and subnet bridges
• 📱 Conversational Interface: Ask "Find the best AVAX validators" in natural language
• ⚡ Real-time Data: Live subnet data, staking rates, and DeFi opportunities
• 🔗 Cross-Chain Support: Bridge assets from Ethereum and other major blockchains

Supported Operations

• Avalanche subnet discovery: Explore gaming, DeFi, and enterprise subnets with validator data
• AVAX staking management: Find validators, calculate rewards, manage delegations
• DeFi protocol exploration: Discover Trader Joe, BENQI, GMX, Vector Finance opportunities
• Bridge asset comparison: Compare Avalanche Bridge, Stargate, and subnet bridges
• Transaction tracking: Monitor Avalanche transactions with SnowTrace integration
• Portfolio balance checking: Multi-chain portfolio overview including Avalanche assets
• Cross-chain routing: Optimal paths for bridging assets to/from Avalanche

🚀 Quick Start

Prerequisites

• Node.js 18+ - Download here
• Package Manager - npm, pnpm, or yarn
• Multi-Chain Wallet - MetaMask or compatible wallet configured for Avalanche and other supported chains

Installation

1. Clone the repository

   git clone https://github.com/send-ai/send-ai.git
   cd send-ai

2. Install dependencies

   # Using pnpm (recommended)
   pnpm install
   
   # Or using npm
   npm install

3. Configure environment

   cp .env.example .env

   Update .env with your configuration:

   OPENROUTER_API_KEY=your_openrouter_api_key
   NEXT_PUBLIC_PROJECT_ID=your_walletconnect_project_id

4. Start development server

   # Using pnpm
   pnpm dev
   
   # Or using npm
   npm run dev

5. Access the application

   Open http://localhost:3000 in your browser

🏗️ Architecture

Tech Stack

Component	Technology	Purpose
Frontend	Next.js 14	React framework with App Router
Styling	Tailwind CSS	Utility-first CSS framework
UI Components	shadcn/ui	Radix UI + Tailwind components
Animations	Framer Motion	Smooth interactions and transitions
State Management	Zustand	Lightweight state management
Blockchain	Wagmi + Viem	Ethereum-compatible blockchain interactions
Wallet Connection	RainbowKit	Multi-wallet connection support
AI Integration	Vercel AI SDK	Language model interactions
Icons	Lucide React	Consistent icon library

Avalanche Integration

• Mainnet: Avalanche C-Chain (Chain ID: 43114)
• Testnet: Avalanche Fuji (Chain ID: 43113)
• RPC URLs:
  • Mainnet: https://api.avax.network/ext/bc/C/rpc
  • Testnet: https://api.avax-test.network/ext/bc/C/rpc
• Explorer: SnowTrace
• Native Token: AVAX
• Features: Subnets, Consensus Mechanisms, Cross-Subnet Communication, High Performance DeFi

🛠️ Development

Project Structure

send-ai/
├── src/
│   ├── app/                    # Next.js App Router pages
│   │   ├── (landing)/         # Landing page group
│   │   ├── api/               # API routes
│   │   ├── home/              # Main application
│   │   └── layout.tsx         # Root layout
│   ├── components/            # React components
│   │   ├── chat/              # Chat interface components
│   │   ├── landing/           # Landing page components
│   │   └── ui/                # Reusable UI components
│   ├── constants/             # Application constants
│   ├── hooks/                 # Custom React hooks
│   ├── lib/                   # Utility libraries
│   ├── providers/             # Context providers
│   └── utils/                 # Helper functions
├── public/                    # Static assets
└── docs/                      # Documentation

Available Scripts

# Development
pnpm dev          # Start development server
pnpm build        # Build for production
pnpm start        # Start production server
pnpm lint         # Run ESLint
pnpm type-check   # Run TypeScript check

Environment Configuration

Create a .env.local file with the following variables:

# AI Configuration
OPENROUTER_API_KEY=your_openrouter_api_key

# Wallet Configuration  
NEXT_PUBLIC_PROJECT_ID=your_walletconnect_project_id

# Optional: Local AI Model
OLLAMA_URL=http://localhost:11434  # If using Ollama locally

# Avalanche Configuration (Optional)
AVALANCHE_RPC=https://api.avax.network/ext/bc/C/rpc
SNOWTRACE_API_KEY=your_snowtrace_api_key

🔧 Configuration

AI Model Setup

The application supports multiple AI providers:

1. OpenRouter (Recommended)

   • Create account at OpenRouter
   • Get API key and add to .env
   • Currently using: moonshotai/kimi-k2:free

2. Ollama (Local, Optional)

   • Install Ollama
   • Pull a compatible model: ollama pull llama2
   • Update configuration in API routes

Wallet Configuration

1. MetaMask Setup

   • Install MetaMask extension
   • Add Avalanche networks manually or through ChainList

2. Avalanche Mainnet Details

   Network Name: Avalanche Network
   RPC URL: https://api.avax.network/ext/bc/C/rpc
   Chain ID: 43114
   Currency Symbol: AVAX
   Block Explorer: https://snowtrace.io
   

3. Avalanche Fuji Testnet Details

   Network Name: Avalanche Fuji Testnet
   RPC URL: https://api.avax-test.network/ext/bc/C/rpc
   Chain ID: 43113
   Currency Symbol: AVAX
   Block Explorer: https://testnet.snowtrace.io
   

🌐 Deployment

Vercel (Recommended)

1. Connect Repository

   npx vercel

2. Configure Environment Variables

   • Add all environment variables in Vercel dashboard
   • Ensure production API keys are properly set

3. Deploy

   vercel --prod

Other Platforms

The application can be deployed to any platform supporting Next.js:

• Netlify
• Railway
• Render
• DigitalOcean App Platform

🔐 Security

Best Practices

• Never commit private keys or sensitive data
• Use environment variables for all configuration
• Validate all user inputs before blockchain interactions
• Implement proper error handling for failed transactions
• Use confirmation dialogs for all financial operations

Audit Considerations

• Smart contract interactions are limited to well-established protocols
• All transactions require explicit user confirmation
• Private keys never leave the user's wallet
• Application follows Web3 security best practices

🤝 Contributing

Getting Started

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes and commit: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

Development Guidelines

• Code Style: Follow ESLint and Prettier configurations
• Commits: Use conventional commit messages
• Testing: Add tests for new features
• Documentation: Update relevant documentation

Areas for Contribution

• Additional Avalanche subnet integrations
• Enhanced DeFi protocol analysis
• Advanced staking reward calculations
• UI/UX improvements for subnet visualization
• Performance optimizations
• Mobile responsiveness
• Accessibility enhancements
• Internationalization (i18n)
• Cross-chain bridge integrations
• Transaction analytics features

📄 License

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

🔗 Resources

Official Links

• Avalanche: Official Website
• Avalanche Docs: Developer Documentation
• SnowTrace: Block Explorer

Developer Resources

• Avalanche SDK: Developer Integration
• Fuji Testnet Faucet: Get AVAX Tokens
• Trader Joe SDK: DeFi Integration
• BENQI Documentation: Liquid Staking

AI & Blockchain

• Vercel AI SDK: Documentation
• Wagmi: React Hooks for Ethereum
• Viem: TypeScript Interface for Ethereum

---

Built with ❤️ for the Avalanche ecosystem

Enabling seamless Avalanche exploration and cross-chain DeFi