cybertarr-A/Lumina
GitHub: cybertarr-A/Lumina
一个通过 AI 辅助生成、编译、审计和部署 Solidity 智能合约的全栈 Web3 开发平台。
Stars: 0 | Forks: 0
# Lumina — 生产级智能合约生成平台
[](https://github.com/your-org/smartcontractgen/actions)
[](LICENSE)
一个全栈 Web3 平台，用于通过 AI 辅助生成、编译、审计和部署 Solidity 智能合约。
## 功能
- 🤖 **AI 合约生成** — Groq 驱动 (llama3-70b) 自然语言 → Solidity
- 📝 **Monaco 代码编辑器** — Solidity IntelliSense、语法高亮
- 🔒 **安全审计** — Slither 静态分析、风险评分、修复建议
- 🚀 **多链部署** — Ethereum、Polygon、BSC + 测试网
- 👛 **钱包集成** — MetaMask + RainbowKit + WalletConnect
- 📦 **合约模板** — ERC-20、ERC-721、ERC-1155、DAO、Staking、DeFi
- 📊 **可观测性** — Prometheus 指标、Grafana 仪表盘、Sentry
- 🐳 **Docker 优先** — 完整 Docker Compose + Kubernetes 清单
## 快速开始
### 前置条件
- Docker + Docker Compose
- Node.js 20+
- Python 3.11+
### 1. 克隆与配置
```
git clone https://github.com/your-org/smartcontractgen.git
cd smartcontractgen
# 复制并编辑环境变量
cp .env.example .env
# 使用 GROQ_API_KEY 和其他设置编辑 .env
```
### 2. 使用 Docker Compose 启动
```
cd infra/docker
docker compose up -d
# 服务：
# 前端： http://localhost:3000
# 后端： http://localhost:8000
# API 文档： http://localhost:8000/api/docs
# Prometheus: http://localhost:9090
# Grafana： http://localhost:3001 (admin / admin123)
```
### 3. 本地开发（不使用 Docker）
**后端：**
```
# 首先安装 PostgreSQL 和 Redis
cd backend
pip install -r requirements.txt
# 设置环境变量
export DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/smartcontract
export REDIS_URL=redis://localhost:6379/0
export SECRET_KEY=your-dev-secret-key
export AI_MOCK_MODE=true # No Groq key needed for dev
# 从 PROJECT ROOT 运行（不是从 backend/）
cd "/run/media/cyber/359a6e28-9bc2-4e2c-9ca1-d2e8b64fde6b/Smart contract generator"
uvicorn backend.main:app --reload --port 8000
```
**前端：**
```
cd frontend
npm install --legacy-peer-deps
cp .env.local.example .env.local # or create manually
npm run dev # http://localhost:3000
```
**Hardhat 本地区块链：**
```
npm install
npx hardhat node # Starts local EVM at http://localhost:8545
```
## 项目结构
```
├── backend/ # FastAPI microservices
│ ├── main.py # Application entry point
│ ├── config.py # Pydantic settings
│ ├── database.py # Async SQLAlchemy
│ ├── celery_worker.py # Background task queue
│ ├── models/ # ORM models + Pydantic schemas
│ ├── routes/ # API routers (auth, contracts, compile, audit, deploy)
│ ├── services/ # Business logic (AI, compiler, audit, blockchain)
│ └── utils/ # Security, logging utilities
│
├── frontend/ # Next.js 14 (App Router)
│ ├── app/ # Pages (landing, dashboard, builder, deploy, audit)
│ ├── components/ # UI, Editor, Wallet, Layout components
│ └── lib/ # API client, Wagmi config, Zustand stores
│
├── contracts/ # Solidity templates (Jinja2)
│ └── templates/ # ERC20, ERC721, ERC1155, DAO, Staking, DeFi
│
├── scripts/ # Hardhat deployment scripts
├── tests/ # Unit, integration, contract, e2e tests
└── infra/
├── docker/ # Dockerfiles + docker-compose.yml
├── k8s/ # Kubernetes manifests
├── monitoring/ # Prometheus + Grafana configs
└── .github/workflows/ # CI/CD pipeline
```
## API 参考
完整的 OpenAPI 文档可在 `/api/docs`（开发模式）中查看。
| 方法 | 端点 | 描述 |
|--------|----------|-------------|
| POST | `/api/v1/auth/register` | 注册用户 |
| POST | `/api/v1/auth/login` | 登录，获取 JWT |
| POST | `/api/v1/contracts/generate` | AI 合约生成 |
| POST | `/api/v1/compile/` | 编译 Solidity |
| POST | `/api/v1/audit/` | 运行安全审计 |
| POST | `/api/v1/deploy/` | 发起部署 |
| GET | `/api/v1/deploy/networks` | 列出支持的网络 |
| WS | `/ws/notifications/{user_id}` | 实时通知 |
## 支持的合约类型
| 类型 | 标准 | 功能 |
|------|----------|----------|
| ERC-20 | OpenZeppelin | Mintable、Burnable、Pausable、MaxSupply |
| ERC-721 | OpenZeppelin | URI Storage、EIP-2981 Royalties、Pausable |
| ERC-1155 | OpenZeppelin | Batch Mint、Per-token URI、Pausable |
| DAO | OpenZeppelin Governor | TimelockController、Voting、Quorum |
| Staking | 自定义 | Reward Rate、Lock Period、Emergency Withdraw |
| DeFi | 自定义 | 通过 AI 生成 |
## 支持的网络
| 网络 | Chain ID | 类型 |
|---------|----------|------|
| Ethereum 主网 | 1 | 生产环境 |
| Ethereum Sepolia | 11155111 | 测试网 |
| Polygon 主网 | 137 | 生产环境 |
| Polygon Mumbai | 80001 | 测试网 |
| BSC 主网 | 56 | 生产环境 |
| BSC 测试网 | 97 | 测试网 |
| 本地 (Hardhat) | 31337 | 开发环境 |
## 运行测试
```
# 后端单元 + 集成测试
cd backend && pytest tests/ -v --cov=backend
# 智能合约测试
npx hardhat test
# E2E 测试（需要运行应用程序）
cd tests/e2e && npx playwright test
```
## 安全
- 带刷新令牌轮换的 JWT 认证
- 基于 Redis 的令牌黑名单用于登出
- 速率限制（默认 100 请求/分钟）
- 输入验证和 Solidity 输出清理
- Slither 静态分析集成
- 私钥永不存储 — 仅客户端签名
## 许可证
MIT © 2025 Lumina
标签：AI编程, API集成, AV绕过, BSC, DAO, DeFi, DLL 劫持, Docker, ERC-1155, ERC-20, ERC-721, FastAPI, Grafana, Llama3, LLM, MetaMask, Monaco编辑器, Polygon, PostgreSQL, Python, RainbowKit, Redis, Sentry, Slither, Solidity, Unmanaged PE, WalletConnect, Web3, 云安全监控, 代码生成, 以太坊, 区块链, 去中心化金融, 可观测性, 合约审计, 合约模板, 多链部署, 大语言模型, 安全防御评估, 币安智能链, 搜索引擎查询, 无后门, 智能合约, 智能合约开发, 测试用例, 测试网, 渗透测试工具, 自定义请求头, 请求拦截, 质押, 逆向工具, 钱包连接, 静态分析