README.md

metadata

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.
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 — structured JSON audit output
• zkaedi/solidity-auditor — Docker production auditor
• zkaedi/zkaedi-prime-arena — PRIME benchmark