ATHENA-WALLET

All Your AI DeFi in one Place!

🔗 Table of Contents

• 📍 Overview
• 👾 Features
• 🚀 UserFlow
• 🚀 Architecture
• 📁 Project Structure
  • 📂 Project Index
• 🚀 Getting Started
  • ☑️ Prerequisites
  • ⚙️ Installation
  • 🤖 Usage
  • 🧪 Testing
• 📌 Project Roadmap
• 🔰 Contributing
• 🎗 License
• 🙌 Acknowledgments
• 🎥 Youtube

---

📍 Overview

Our platform integrates a specialized, AI-assisted DeFi wallet with real-time data retrieval layers (RAG-driven models on LangChain) and a custom-built smart contract environment that emulates core functionalities of Uniswap-style AMMs and Compound-style lending protocols. This unified approach enables automated and semi-autonomous DeFi operations—such as liquidity provision, swapping, lending, and borrowing—executed intelligently and securely within a single cohesive framework.

Value Proposition:

By combining RAG-based market intelligence with AMM and lending protocols, the platform abstracts away the complexity of multi-step DeFi operations. It presents a technical proof-of-concept that a fully AI-integrated wallet can:

• Dynamically provide liquidity
• Automate asset swaps and portfolio adjustments
• Perform yield-optimizing lending operations
• Handle collateralized borrowing with robust guardrails

This harmonized approach leads to streamlined onboarding, enhanced risk management, and a frictionless user experience, ultimately driving more efficient and accessible DeFi participation.

---

👾 Features

1. AI-Driven Market Analytics:
   Leveraging a Retrieval Augmented Generation (RAG) model integrated with LangChain, the system continuously indexes live market data from decentralized exchanges (DEXs) and lending protocols. This ensures that the AI layer provides timely, context-aware strategies—including portfolio comparisons, yield optimization, and risk assessments—without user intervention.

2. Autonomous and Intent-Based Operations:
   Users can execute operations like transferring tokens, swapping assets, providing liquidity, or borrowing against collateral through natural language instructions. The AI component interprets user commands, understands current market conditions, and proposes optimal transaction paths. The user maintains ultimate control by setting spending caps, collateralization thresholds, and approval checks.

3. Automated Market Maker Integration (Uniswap-Style):
   We implement a simplified AMM pool architecture that mimics Uniswap’s core logic.

   • Liquidity Provision: Users supply “Chill” tokens and ETH, receiving LP tokens proportional to their liquidity share.
   • Token Swaps: The AMM curve allows automated swaps between Chill and ETH, dynamically adjusting based on the pool’s reserves.

   This AMM model ensures continuous liquidity and price discovery. By integrating with the AI layer, the wallet can automatically suggest when to provide liquidity or rebalance based on on-chain data.

4. Lending and Borrowing (Compound-Style):
   Our lending component is a reduced version of Compound’s logic, supporting:

   • USDC Deposits for Yield: Users lock USDC to earn interest from a lending pool.
   • Collateralized Loans via LP Tokens: LP tokens from the AMM can be pledged as collateral. Borrowers can draw up to 80% of the LP token’s value in USDC. Failure to repay triggers liquidation of the collateralized LP tokens.

   Integrating these functionalities into the AI framework allows the wallet to recommend lending opportunities or borrowing strategies, guided by dynamic interest rates, liquidity conditions, and user-defined risk parameters.

5. On-Chain Transaction Execution via AI: The system demonstrates that given the ABI and contract addresses of EVM-compatible swap and lending protocols, the AI layer can seamlessly interact with these contracts. By parsing user requests and current market conditions, it can generate and execute on-chain transactions—provisioning liquidity, performing swaps, initiating deposits, or taking loans—while maintaining user-defined security and regulatory constraints.

---

🚀 Userflow

---

📁 Architecture

---

📁 Project Structure

└── Athena-Wallet/
    ├── Athena-UI
    │   ├── README.md
    │   ├── eslint.config.js
    │   ├── index.html
    │   ├── package-lock.json
    │   ├── package.json
    │   ├── postcss.config.js
    │   ├── public
    │   ├── src
    │   ├── tailwind.config.js
    │   └── vite.config.js
    ├── Athena-backend-chat
    │   ├── .DS_Store
    │   ├── Dockerfile
    │   ├── app.py
    │   ├── docker-compose.yml
    │   ├── memonics_generate.py
    │   ├── oldwallet.txt
    │   ├── requirements.txt
    │   └── wallet_data.txt
    └── EthAI
        ├── .dockerIgnore
        ├── .gitIgnore
        ├── Dockerfile
        ├── data
        ├── docker-compose.yml
        ├── main.py
        ├── models
        ├── requirements.txt
        └── services

📂 Project Index

ATHENA-WALLET/

Athena-backend-chat

oldwallet.txt	❯ REPLACE-ME
wallet_data.txt	❯ REPLACE-ME
app.py	❯ REPLACE-ME
requirements.txt	❯ REPLACE-ME
memonics_generate.py	❯ REPLACE-ME
docker-compose.yml	❯ REPLACE-ME
Dockerfile	❯ REPLACE-ME

EthAI

.dockerIgnore	❯ REPLACE-ME
main.py	❯ REPLACE-ME
requirements.txt	❯ REPLACE-ME
.gitIgnore	❯ REPLACE-ME
docker-compose.yml	❯ REPLACE-ME
Dockerfile	❯ REPLACE-ME

models

lstm_model.py

❯ REPLACE-ME

services

predictor.py	❯ REPLACE-ME
data_preprocessor.py	❯ REPLACE-ME
data_fetcher.py	❯ REPLACE-ME

Athena-UI

postcss.config.js	❯ REPLACE-ME
package-lock.json	❯ REPLACE-ME
tailwind.config.js	❯ REPLACE-ME
vite.config.js	❯ REPLACE-ME
package.json	❯ REPLACE-ME
index.html	❯ REPLACE-ME
eslint.config.js	❯ REPLACE-ME

src

index.css	❯ REPLACE-ME
App.css	❯ REPLACE-ME
providers.tsx	❯ REPLACE-ME
App.jsx	❯ REPLACE-ME
main.jsx	❯ REPLACE-ME
App_Old.jsx	❯ REPLACE-ME

old_component

TransferComponent.jsx	❯ REPLACE-ME
WalletLoginComponent.jsx	❯ REPLACE-ME
SwapComponent.jsx	❯ REPLACE-ME
WalletComponent.jsx	❯ REPLACE-ME
WalletInitializationComponent.jsx	❯ REPLACE-ME
PortfolioComponent.jsx	❯ REPLACE-ME
chat.jsx	❯ REPLACE-ME

components

CreateLiquidity.jsx	❯ REPLACE-ME
AppBar.tsx	❯ REPLACE-ME
Header.tsx	❯ REPLACE-ME

pages

AIChat.jsx	❯ REPLACE-ME
Login.jsx	❯ REPLACE-ME
Market.jsx	❯ REPLACE-ME
LiquidityPool.jsx	❯ REPLACE-ME
InsideOverview.jsx	❯ REPLACE-ME
Dashboard.jsx	❯ REPLACE-ME
AddContact.jsx	❯ REPLACE-ME
Portfolio.jsx	❯ REPLACE-ME
ImportWallet.jsx	❯ REPLACE-ME

---

🚀 Getting Started

☑️ Prerequisites

Before getting started with Athena-Wallet, ensure your runtime environment meets the following requirements:

• Programming Language: JavaScript
• Package Manager: Pip, Npm
• Container Runtime: Docker

⚙️ Installation

Install Athena-Wallet using one of the following methods:

Build from source:

1. Clone the Athena-Wallet repository:

❯ git clone https://github.com/soumikbaksi18/Athena-Wallet/

2. Navigate to the project directory:

❯ cd Athena-Wallet

3. Install the project dependencies:

Using pip  

❯ echo 'INSERT-INSTALL-COMMAND-HERE'

Using npm  

❯ npm install

Using docker  

❯ docker build -t soumikbaksi18/Athena-Wallet .

🤖 Usage

Run Athena-Wallet using the following command: Using pip  

❯ echo 'INSERT-RUN-COMMAND-HERE'

Using npm  

❯ npm start

Using docker  

❯ docker run -it {image_name}

🧪 Testing

Run the test suite using the following command: Using pip  

❯ echo 'INSERT-TEST-COMMAND-HERE'

Using npm  

❯ npm test

---

🔰 Contributing

• 💬 Join the Discussions: Share your insights, provide feedback, or ask questions.
• 🐛 Report Issues: Submit bugs found or log feature requests for the Athena-Wallet project.
• 💡 Submit Pull Requests: Review open PRs, and submit your own PRs.

Contributing Guidelines

1. Fork the Repository: Start by forking the project repository to your github account.
2. Clone Locally: Clone the forked repository to your local machine using a git client.

   git clone https://github.com/soumikbaksi18/Athena-Wallet/

3. Create a New Branch: Always work on a new branch, giving it a descriptive name.

   git checkout -b new-feature-x

4. Make Your Changes: Develop and test your changes locally.
5. Commit Your Changes: Commit with a clear message describing your updates.

   git commit -m 'Implemented new feature x.'

6. Push to github: Push the changes to your forked repository.

   git push origin new-feature-x

7. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.
8. Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!

Contributor Graph

---

🎗 License

This project is protected under the SELECT-A-LICENSE License. For more details, refer to the LICENSE file.

---

🙌 Acknowledgments

• List any resources, contributors, inspiration, etc. here.

---

🙌 Youtube

• https://www.youtube.com/watch?v=mzFSWMgn2j8
• https://youtu.be/a4KHvVjlIYs

---