🔍 IAcine Smart Contract Analyzer | AI-Powered Ethereum Code Audit with RAG

📖 Introduction

IAcine Smart Contract Analyzer is a powerful AI tool that analyzes Ethereum smart contracts directly from their source code. Using RAG (Retrieval-Augmented Generation), OpenAI’s GPT, and a modern Streamlit interface, it generates clean summaries, functional insights, and answers to any question you ask — all based on the real Solidity code.

Whether you’re a blockchain developer, an auditor, or a business working with tokens and DeFi, this app turns code complexity into clarity. 🤖📜

---

🚀 Features

✔️ Etherscan Integration – Fetch smart contract code from any Ethereum address
✔️ CoinMarketCap-style Summaries – Auto-generate project descriptions
✔️ Feature Detection – Detects blacklist, pause, mint, burn, ownership, and upgradeability
✔️ Ask Anything with RAG – Get AI answers based on the actual Solidity code
✔️ PDF Report Export – Download a clean, structured audit-style report
✔️ Streamlit Web App – User-friendly, no-code frontend to interact with AI

---

🏗️ Technologies

• 🐍 Python 3.12 – App logic and backend
• 🧠 OpenAI GPT – Large Language Model for summaries and QA
• 🔍 LangChain + FAISS – Retrieval-Augmented Generation pipeline
• 🌐 Streamlit – Lightweight frontend framework
• 📂 Etherscan & CoinGecko API – For source code and market data
• 📄 FPDF – Exporting structured audit-style PDFs
• 🛡️ dotenv – Secure API key management

---

📦 Installation

=== 1️⃣ Clone the Repository

git clone https://github.com/Yacine-Mekideche/smart_contract_blockchain.git
cd smart_contract_blockchain

=== 2️⃣ Create a .env File

OPENAI_API_KEY=your_openai_api_key
ETHERSCAN_API_KEY=your_etherscan_api_key

=== 3️⃣ Set Up Your Environment

python -m venv venv
# Activate:
venv\Scripts\activate  # Windows
source venv/bin/activate  # macOS/Linux

=== 4️⃣ Install Dependencies

pip install -r requirements.txt

---

▶️ Running the App

Start the app with:

streamlit run app.py

Then open the Streamlit UI in your browser. You can:

• 🔍 Paste a smart contract address (e.g., 0xdAC17F958D2ee523a2206206994597C13D831ec7)
• 📄 Or upload a .sol file directly
• ✅ Get badges, summaries, and ask your own questions
• 📅 Export a PDF report

---

🎯 Demo

---

🧠 AI Architecture Overview

• Input → Ethereum address or uploaded Solidity file
• Source Code → Retrieved via Etherscan or Streamlit uploader
• RAG Pipeline → FAISS + LangChain + OpenAI
• Outputs:
  • Project Summary
  • Functional Badges
  • AI-Powered Q&A
  • PDF Report

---

📬 Contact Me

💡 Into AI + Blockchain? Let’s build the future together.

📩 Business inquiries: contact@iacine.tech

---

#SmartContracts #AI #Ethereum #RAG #LangChain #GPT #Solidity #Audit #Streamlit #OpenAI #DeFi #BlockchainSecurity #YacineTech #FreelanceAI #PythonProject