zkaedi/solidity-energy-auditor

⚡ ZKAEDI PRIME — Solidity Energy Auditor

Smart contract security auditing powered by Hamiltonian Energy Field Analysis.

Architecture

┌─────────────────┐         ┌──────────────────────┐
│   HF Space      │  POST   │   Google Colab (GPU)  │
│   (Gradio UI)   │ ──────► │   FastAPI + llama.cpp │
│                 │  ngrok  │   gemma-7b GGUF       │
│  Code Editor    │ ◄────── │   H100 / A100 / T4    │
│  Results Panel  │         │                      │
└─────────────────┘         └──────────────────────┘

Setup

1. 1.Run the Colab Backend Notebook to load the model on GPU
2. 2.Copy the ngrok URL from the notebook output
3. 3.Paste the URL into the Backend Connection field in this Space
4. 4.Start scanning contracts

Model

Uses `zkaedi/gemma-7b-solidity-energy-signatures` — a Gemma-7B model fine-tuned for Solidity vulnerability detection using energy signature methodology.

Methodology

Contracts are analyzed through the lens of Recursively Coupled Hamiltonian Dynamics:

• —Energy Topology Mapping: Vulnerabilities appear as energy wells in the contract's state space
• —Phase Transition Detection: Small input changes causing catastrophic state shifts
• —Lyapunov Stability Analysis: Measuring divergence in state variable interactions
• —Severity Classification: CRITICAL (H > 0.9), HIGH (0.7-0.9), MEDIUM (0.4-0.7), LOW (< 0.4)