Anish-2005/Tracebound
GitHub: Anish-2005/Tracebound
一套结合 Solidity 智能合约与 Next.js 前端的 AI Agent 工作流追踪系统，提供链上不可篡改记录与链下可视化审计能力。
Stars: 0 | Forks: 0
# Tracebound ⚡
[](https://soliditylang.org/)
[](https://nextjs.org/)
[](https://hardhat.org/)
[](LICENSE)
Tracebound 在链上记录工作流意图，并提供高级 Web 仪表板用于端到端追踪可视化。它让调查、验证和审计 AI Agent 的每一个行为变得简单。
## 🌟 核心功能
* **不可篡改的来源追溯**：每一个工作流步骤都通过 `TraceboundLedger` 智能合约生成可验证的链上记录。
* **策略执行**：自动化策略 Agent 在执行前和执行期间验证意图合规性。
* **实时可视化**：高保真仪表板，用于展示执行时间线、Agent 分支和交易链接。
* **Agent 编排**：模块化 Agent 架构（Parser, Policy, Service, Auditor），用于完成复杂任务。
* **开发者优先**：包含 Hardhat 的完整本地开发环境和统一的 monorepo 结构。
## 🏗️ 高层架构
```
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
```
## 🚀 快速开始
### 前置条件
- Node.js (18+)
- npm / pnpm
- 一个本地以太坊节点 (Hardhat)
### 1. 准备工作
```
git clone
cd Tracebound
npm run install:all
```
### 2. 基础设施搭建
在单独的终端中执行：
```
# 终端 1：启动本地 blockchain
npm run node
# 终端 2：部署 contracts
npm run deploy:local
# 终端 3：启动 backend & frontend
npm run dev
### 4. Docker 部署（推荐）
You can launch the entire stack (Blockchain + Backend + Frontend) using Docker Compose:
```bash
docker-compose up --build
```
这确保了所有开发和生产阶段环境的一致性。
### 3. 环境配置
后端 `.env`（由部署脚本自动管理或手动配置）：
```
RPC_URL=http://127.0.0.1:8545
PRIVATE_KEY=0xac... (Hardhat Default)
CONTRACT_ADDRESS=0x5Fb... (From Deploy output)
```
## 🛠️ 技术栈
| 层级 | 技术 |
|---|---|
| **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 |
## 📖 开发者指南
- **Contracts**：位于 `backend/contracts`。使用 `TraceboundLedger` 进行审计日志记录，并包含自定义访问控制。
- **Agents**：位于 `backend/src/agents`。Agents 是纯函数，接收一个步骤和上下文，返回成功标志和输出。
- **Frontend**：位于 `frontend/src`。使用自定义 Hooks (`useWorkflow`) 与 Agent API 交互。
为下一代可验证 AI 精心打造。
标签：EVM, GNU通用公共许可证, Hardhat, IntentLedger, MITM代理, Node.js, SOC Prime, Solidity, Web3, 不可篡改, 人工智能安全, 以太坊, 前端仪表盘, 区块链, 合规性, 审计日志, 工作流追踪, 开发工具, 智能合约, 溯源, 策略验证, 网络调试, 自动化, 自动化攻击, 自动化攻击, 请求拦截