---
title: ZKAEDI Solidity Voice Guide
emoji: 🔱
colorFrom: indigo
colorTo: purple
sdk: docker
pinned: false
license: apache-2.0
short_description: Spoken Solidity audits via Hamiltonian energy analysis
tags:
  - solidity
  - smart-contracts
  - security
  - auditing
  - tts
  - voice
  - zkaedi-prime
  - hamiltonian
  - llama-cpp
  - kokoro
---

# 🔱 ZKAEDI Solidity Voice Guide

**Recursive Hamiltonian energy analysis — spoken aloud.**

```
H_t = H_0 + η·H_{t-1}·σ(γ·H_{t-1}) + ε·N(0, 1+β|H_{t-1}|)
```

The companion voice interface to [`solidity-energy-auditor`](https://hf.co/spaces/zkaedi/solidity-energy-auditor).  
Rather than returning structured JSON findings, this guide **narrates** the audit — walking through
the contract's energy landscape in conversational speech, as a senior auditor would in a live code review.

## Pipeline

```
Solidity code
    ↓
ZKAEDI Guide LLM  (gemma-7b-solidity-energy-signatures GGUF)
    ↓  [η=0.4, γ=0.3, β=0.1 — high memory, soft attractors → flowing narration]
Guide Narration  (plain speech, no markdown)
    ↓
Kokoro-82M TTS  (am_michael / am_fenrir / af_bella / af_heart)
    ↓
Spoken Audio  (24kHz)
```

## PRIME Energy Field

A lightweight scalar H∞ score is computed via 12 iterations of the recursive Hamiltonian equation
over vulnerability token densities, giving a phase-state classification:

| H∞ range | Phase |
|----------|-------|
| < 2      | 🟢 STABLE |
| 2–6      | 🟡 APPROACHING CRITICAL |
| 6–12     | 🔴 CRITICAL |
| > 12     | 💀 CHAOTIC |

## Related Spaces

- [`zkaedi/solidity-energy-auditor`](https://hf.co/spaces/zkaedi/solidity-energy-auditor) — structured JSON audit output
- [`zkaedi/solidity-auditor`](https://hf.co/spaces/zkaedi/solidity-auditor) — Docker production auditor
- [`zkaedi/zkaedi-prime-arena`](https://hf.co/spaces/zkaedi/zkaedi-prime-arena) — PRIME benchmark