Skip to content

Home

Jump to bottom
M. Waiz Khan edited this page Oct 23, 2025 · 4 revisions

SmartMuv Wiki

Welcome to the SmartMuv GitHub Wiki — your guide to understanding, deploying, and integrating the SmartMuv platform.

Website: https://smartmuv.app

📘 Overview

SmartMuv is a Smart Contract Deep Storage Analysis Platform offering indexed on-chain contract data, slot-level insights, and AI-driven reasoning. It powers advanced tools for dApp owners, auditors, and researchers.

Key Components

  • Analyzer Engine → Performs static analysis, mapping key extraction, and proxy detection.

  • Storage Extractor → Fetches and decodes contract storage data.

  • Explorer UI → Provides visualization and querying tools for contracts.

  • AI Agent (Gemini + MCP) → Enables reasoning, explanations, and contextual storage insights.

  • APIs & Feeds → Provide structured access to indexed data and analytics.

⚙️ Setup & Deployment

Installation

Follow the Usage Guide for tool setup instructions.

SmartMuv Components

Component Description
Contract Indexer Automatically analyzes smart contracts source code, storage slot layout and extracts storage.
Explorer Frontend visualization platform with more than 1 million indexed smart contracts.
AI Agent The missing “blockchain intelligence layer” by SmartMuv.
Database Stores analysis results and storage data of 1 million plus smart cotnracts.

🔍 Indexing & Analysis

Pipeline Flow

Alchemy/Infura → Source Code Analyzer → SmartMuv Indexer → MongoDB → Explorer/AI Agent
  • Indexing on request via API or partner explorers.
  • 1M+ contracts indexed on Ethereum mainnet.

Stored Data Fields

  • Contract metadata
  • Slot layout
  • Storage data
  • Static analysis results

💾 APIs

Public Endpoints

Endpoint Description Format
GET /contract/{contract_address} Get summary data for contract cards JSON
/mcp/* MCP protocol endpoints for Google Cloud integration JSON

Private Endpoints

Endpoint Description
private Retrieves contract analysis results.
private Retrieves storage data results.
private Handles requests to get storage value against a given mapping key of a contract address and a mapping variable from the blockchain.
private` Start AI chat session
private Interact/chat with AI
private Get AI generated source code and storage data analytics report of a smart contract

🧠 AI Agent

  • Powered by Gemini API for reasoning and code explanations.
  • Queries source code, storage data and recent activity.
  • Integrates directly with MCP for cloud inference.

Example AI Query:

Input: Explain storage structure of proxy contract X.
Output: Contract X delegates calls to implementation Y. Storage slot 0 maps admin address...

🗄️ MCP Server

SmartMuv MCP server for AI agents is publicly available for testing at api.smartmuv.app/mcp

Here is the link to one of the use cases of our MCP server: https://claude.ai/share/e718bd8d-57d1-4d5d-a495-deda32d0a0bf

💻 Explorer Platform

Publicly available at explorer.smartmuv.app

Features

  • Contract search
  • Slot visualization
  • Storage data viewer
  • Proxy detection
  • Mapping Data Querying
  • AI Q&A for reasoning

Integration

SmartMuv Explorer data is being used in Etherscan and Blockscout as embedded Cards.

📎 Documentation Index

Clone this wiki locally