Hachimedes

中文文档 | English

"Give me a lever, and I can move Jupiter." - Archimedes (adapted)

A powerful Flash Loan interface for Jupiter Lend on Solana, enabling one-click leverage and deleverage operations.

🌐 Live Demo: https://hachimi.ramu.us

✨ Features

• 🚀 One-Click Leverage/Deleverage: Execute complex DeFi operations in a single transaction
• ⚡ Flash Loan Integration: Utilize Jupiter Lend's flash loan capabilities
• 🔄 Auto Swap: Automatically swap tokens via Jupiter Aggregator
• 🎯 Position Management: Easily manage your lending positions
• 🔍 NFT-based Position Discovery: Automatically find your positions (supports up to 100,000 position IDs)
• 📊 Real-time LTV Display: Monitor your loan-to-value ratio in real-time

🏦 Supported Vaults

• JLP/USDC (Vault 8)
• JLP/USDG (Vault 10)
• JLP/USDS (Vault 34) - Default

🔧 How It Works

Leverage

1. Flash Borrow USDS from Jupiter Lend
2. Swap USDS → JLP via Jupiter Aggregator
3. Deposit JLP as collateral + Borrow USDS
4. Repay Flash Loan

All in one atomic transaction!

Deleverage

1. Flash Borrow JLP from Jupiter Lend
2. Swap JLP → USDS via Jupiter Aggregator
3. Repay debt + Withdraw JLP collateral
4. Repay Flash Loan

All in one atomic transaction!

🛠 Tech Stack

• Framework: Next.js 14 + React
• Blockchain: Solana
• Wallet: Solana Wallet Adapter
• DeFi Protocol: Jupiter Lend SDK
• DEX Aggregator: Jupiter Swap API
• UI: Tailwind CSS + shadcn/ui
• Language: TypeScript

🚀 Quick Start

1. Clone the repository

git clone https://github.com/giraphant/Hachimedes.git
cd Hachimedes

2. Install dependencies

npm install

3. Configure environment variables

cp .env.local.example .env.local

Edit .env.local and add your RPC endpoint:

NEXT_PUBLIC_RPC_URL=https://api.mainnet-beta.solana.com
# Or use a paid RPC for better performance:
# NEXT_PUBLIC_RPC_URL=https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY

4. Run development server

npm run dev

5. Open in browser

http://localhost:28848

🔍 Position Discovery System

The app features an intelligent NFT-based position discovery system:

• Quick Search: Most positions found in < 1 second (0-1,000 range)
• Deep Search: Supports position IDs up to 100,000
• Batch Strategy: Searches in batches to maintain UI responsiveness
• Progress Feedback: Real-time loading indicators

Performance:

• 3-digit Position IDs (0-999): ~300ms
• 4-digit Position IDs (1000-9999): ~3s
• 5-digit Position IDs (10000-99999): ~20-30s

📜 Scripts

npm run dev     # Start development server (port 28848)
npm run build   # Build for production
npm run start   # Start production server (port 28848)
npm run lint    # Run ESLint

📚 Documentation

• Position NFT Discovery
• Position Search Optimization
• UX Loading Fix
• Vaults Added

🚨 Deployment

Coolify Deployment

1. Repository: https://github.com/giraphant/Hachimedes
2. Default Port: 28848
3. Environment Variables:

   NEXT_PUBLIC_RPC_URL=your_rpc_url
   NEXT_PUBLIC_NETWORK=mainnet-beta
   

4. Build Command: npm run build
5. Start Command: npm start

Reverse Proxy Configuration

If you're using Nginx or other reverse proxy, forward traffic to port 28848:

location / {
    proxy_pass http://localhost:28848;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

⚠️ Security

• ⚠️ This is experimental software. Use at your own risk.
• ⚠️ Always verify transactions before signing
• ⚠️ Never share your private keys or seed phrases
• ⚠️ Start with small amounts for testing

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT

🙏 Acknowledgments

• Jupiter - For the amazing DeFi protocols
• Solana - For the high-performance blockchain
• shadcn/ui - For the beautiful UI components

---

Built with ❤️ for the Solana DeFi community