Tracebound ⚡

Important

Tracebound is an industry-grade reference application for auditable, verifiable agentic workflows. It bridges the gap between autonomous AI agents and cryptographic accountability.

Tracebound records workflow intents on-chain while offering a premium web dashboard for end-to-end trace visualization. It makes it easy to investigate, verify, and audit every action taken by an AI agent.

🌟 Key Features

• Immutable Provenance: Every workflow step produces a verifiable on-chain record via the TraceboundLedger smart contract.
• Policy Enforcement: Automated policy agents validate intent compliance before and during execution.
• Real-time Visualization: High-fidelity dashboard for execution timelines, agent branching, and transaction links.
• Agent Orchestration: Modular agent architecture (Parser, Policy, Service, Auditor) for complex task completion.
• Developer First: Comprehensive local development environment with Hardhat and a unified monorepo structure.

🏗️ High-Level Architecture

graph TD
    User([User Intent]) --> UI[Next.js Dashboard]
    UI --> API[Backend Orchestrator]
    API --> AP[Intent Parser Agent]
    AP --> PV[Policy Validator Agent]
    PV --> EX[Execution Agent]
    EX --> BC[TraceboundLedger Contract]
    BC --> UI
    subgraph "On-Chain (EVM)"
    BC
    end
    subgraph "Off-Chain (Agents)"
    AP
    PV
    EX
    end

Loading

🚀 Quickstart

Prerequisites

• Node.js (18+)
• npm / pnpm
• A local Ethereum node (Hardhat)

1. Preparation

git clone <repo-url>
cd Tracebound
npm run install:all

2. Infrastructure Setup

In separate terminals:

# Terminal 1: Start local blockchain
npm run node

# Terminal 2: Deploy contracts
npm run deploy:local

# Terminal 3: Start backend & frontend
npm run dev
### 4. Docker Deployment (Recommended)
You can launch the entire stack (Blockchain + Backend + Frontend) using Docker Compose:
```bash
docker-compose up --build

This ensures a consistent environment across all development and production stages.

3. Environment Configuration

Backend .env (managed automatically by deploy script or manually):

RPC_URL=http://127.0.0.1:8545
PRIVATE_KEY=0xac... (Hardhat Default)
CONTRACT_ADDRESS=0x5Fb... (From Deploy output)

🛠️ Tech Stack

Layer	Technology
Frontend	Next.js 16, Tailwind CSS, Framer Motion, Lucide
Backend	Node.js, Express, Ethers.js
Trust	Solidity 0.8.20, Hardhat, OpenZeppelin
Logic	Agentic Workflow Engine

📖 Developer Guide

• Contracts: Located in backend/contracts. Uses TraceboundLedger for audit logging with custom access controls.
• Agents: Located in backend/src/agents. Agents are pure functions that take a step and context, returning a success flag and output.
• Frontend: Located in frontend/src. Uses custom hooks (useWorkflow) to interface with the agent API.

---

Built with precision for the next generation of verifiable AI.