Skip to content

Mas-AI-Official/hackathon_demo

Repository files navigation

Daena Consensus Replay Studio

Daena Consensus Replay Studio

A polished static replay for autonomous DeFi security, council voting, and proof-backed execution.

Live Demo · Demo Video · Architecture · Local Development

What This Repository Is

This repository is the public replay layer for a Daena hackathon demo.

It does not expose the private runtime or live operational infrastructure. Instead, it ships a sanitized static experience that lets people inspect:

  • a Solidity security scan surface
  • multi-agent governance debate and voting
  • policy decisions and execution flow
  • bundled replay traces and a generated report

The app is designed to show how an autonomous AI employee can move from detection to decision with a visible audit trail.

What The Demo Proves

Daena is presented here as an autonomous security and consensus operator for high-trust workflows.

In this public replay, the system:

  1. reviews a DeFi vault-style contract surface
  2. flags security findings
  3. routes the case through a governance council
  4. finalizes a policy decision
  5. replays the entire chain in a static browser experience

The current artifact pack includes:

  • 121 bundled replay traces in public/demo_artifacts
  • a reference trace with 145 events
  • governance members such as risk_guard, compliance_guard, and ops_guard
  • a markdown security review rendered directly inside the UI

Architecture

flowchart LR
    A[Founder Panel] --> B[Workflow Orchestrator]
    B --> C[Security Scan Surface]
    B --> D[Agent Orchestrator]
    D --> E[Governance Council]
    E --> F[Policy Center]
    F --> G[Workflow Executor]
    G --> H[Replay Artifacts]
    H --> I[Consensus Replay Studio]
Loading

Core Layers

  • Replay Studio UI: React + Vite frontend for inspecting the run.
  • Trace Library: Static JSON artifacts loaded from public/demo_artifacts.
  • Security Surface: Monaco-based contract viewer for the simulated vault scan.
  • Governance View: Timeline, call graph, and vote stream for council review.
  • Proof Layer: Sanitized markdown report and replayable decision history.

Experience Map

The UI is intentionally split into three operator views:

  • Workflow Control Tower: run activation, pulse stepping, progress, and report access
  • Threat Surface: contract preview, path/inline switching, scan simulation, findings
  • Consensus Fabric: call graph, timeline, governance debate, and event log

That structure mirrors the architecture of the underlying system: inspect -> deliberate -> authorize -> execute -> verify.

Stack

  • React 18
  • TypeScript
  • Vite
  • Tailwind CSS v4
  • Monaco Editor
  • React Flow
  • GitHub Pages deployment via GitHub Actions

Repository Layout

.
|-- public/demo_artifacts/     # bundled replay traces + markdown report
|-- src/components/demo/       # main replay studio experience
|-- src/index.css              # visual system and motion styling
|-- .github/workflows/         # GitHub Pages deploy workflow
|-- vite.config.ts             # static-friendly Vite build config
`-- README.md

Local Development

npm install
npm run dev

Build for production:

npm run build

Deployment Notes

  • The app is configured as a static Vite build with base: './'.
  • The GitHub Actions workflow deploys dist/ to gh-pages.
  • 404.html is copied from index.html so the hash-routed app works on GitHub Pages.

Why The Public Version Looks Different From A Production System

This repository is optimized for demo clarity and safe public sharing:

  • secrets are not included
  • live backend services are not required
  • trace files are pre-generated
  • the report is shipped as a static artifact

That keeps the project easy to review on GitHub while still communicating the architecture and product direction.

License

This project is released under the MIT License.

About

Daena Defi Demo

Resources

License

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors