X Layer 上的 AI 链上资产管理终端 · AI onchain asset management terminal on X Layer OKX Build X「AI Season」黑客松参赛项目 · 已部署 X Layer 主网
财富燕巢是一套面向真实用户的 AI 资产管理产品：一群会协作的 AI 投资智能体（"燕群"）感知行情 → 生成配置 → 风控校验 → 经用户授权在 X Layer 主网执行真实 swap，所有关键动作与资产状态都写入链上、可被任何人验证。
下表直接对应评委打分项，每格给出本项目的可验证证据。
| # | 评分维度 | 本项目实现 | 证据位置 |
|---|---|---|---|
| 1 | OnchainOS / Uniswap 集成创新 | 真实接入 OnchainOS DEX 聚合（chainIndex=196），四燕执行智能体经 Agentic Wallet 广播真实 swap；Builder Code(ERC-8021) 焊接进每笔交易 dataSuffix 做归因 |
agents/src/onchainos/（REST 客户端 + 签名）、agents/src/agents/swalls/builder.ts、index.html 链上证明区 |
| 2 | X Layer 生态契合 | 链 ID 196；标的用 X Layer 原生 USDG / USDT；金库与身份凭证合约部署主网；Builder Code 归因契合 X Layer 激励模型 | contracts/（ERC-4626 金库 + WealthNestID）、下方「真实链上凭证」 |
| 3 | AI 交互体验 | 网页 demo 内「运行 AI 决策闭环」基于 X Layer 主网实时余额 + 金库再平衡次数动态生成四燕输出（非写死动画）；连钱包后可发起真实再平衡 | wealth-nest-demo/index.html runCommittee() |
| 4 | 产品完整度 | 着陆页 + 单文件 Demo + 后端多智能体 + 合约四层齐备；合规红线（不承诺收益）全程标注 | wealth-nest-demo/landing/、agents/、contracts/、本 README |
┌─────────────────────────── 用户端 (前端 Demo) ───────────────────────────┐
│ wealth-nest-demo/index.html (单文件，ethers v6 CDN) │
│ ├─ 钱包连接：OKX Wallet / 浏览器 EIP-1193 (无钱包→演示模式兜底) │
│ ├─ 链上读取：Vault TVL / 再平衡次数 / WealthNestID / USDG·USDT 余额 │
│ └─ AI 决策闭环(可视化)：气象→寻金→护巢→筑巢 四燕输出 │
└───────────────┬───────────────────────────────────┬───────────────────┘
│ 读取/展示 │ 授权后执行
▼ ▼
┌─────────────────────── agents/ (后端多智能体) ──────────────────────────┐
│ Necta 多智能体改造 · 四燕协作 │
│ 气象燕 sentinel → 感知行情/钱包状态 │
│ 寻金燕 curator → 决策配置 │
│ 护巢燕 guard → 风控阈值校验 │
│ 筑巢燕 executor → 经 OnchainOS Agentic Wallet 广播真实交易 │
│ 真实 LLM 闭环 + 链上回执验证（详见 agents/README.md） │
└───────────────┬───────────────────────────────────┬───────────────────┘
│ │
▼ 调用 ▼ 上链
┌─────────────────────── X Layer 主网 (chainId 196) ──────────────────────┐
│ ERC-4626 金库 Vault · AI 钱包 Agent Wallet │
│ WealthNestID (Soulbound) · OnchainOS DEX 聚合 (USDG/USDT swap) │
│ Builder Code (ERC-8021) 焊接进 tx dataSuffix → 链上归因 │
└────────────────────────────────────────────────────────────────────────┘
| 项 | 值 |
|---|---|
| 网络 | X Layer · Chain ID 196 |
| 金库 Vault (ERC-4626) | 0xC0070b5D…8630bB |
| AI 钱包 Agent Wallet | 0xa0c26b79…c20c4 |
| 真实 swap 交易 | 0x4561371a66534ef3479841d4ac470a6d898497db76fcdfd3d5a57e83b0fc6c48（USDT→USDG，OnchainOS DEX 聚合） |
| 链上身份凭证 WealthNestID | 0xd6F238d73c46db240271b0Ddf913cd27c42D168A |
| Builder Code (ERC-8021 归因) | mrp431ap0kg37rsn |
| 稳定币标的 | USDG 0x4ae46a509f6b1d9056937ba4500cb143933d2dc8 · USDT 0x779ded0c9e1022225f8e0630b35a9b54be713736 |
| X Layer 浏览器 | https://www.oklink.com/xlayer |
前端 Demo 的「链上透明证明」区块会实时读取上述合约；交易哈希可直接在 X Layer 浏览器核验。
- 产品着陆页：https://b20434bc888e4d65b44245ed0fdec5a6.sh4.agentos-app.net
- 交互 Demo（连钱包跑 AI 决策闭环）：https://f542a9d865424c62a9727b5502a373e7.sh1.agentos-app.net
- 前端：单文件 HTML + ethers v6（CDN），无构建依赖；OKX Wallet / EIP-1193 连接；链上数据实时读取
- AI 后端：TypeScript 多智能体（Necta 范式改造），LLM 决策闭环，OnchainOS REST 客户端
- 合约：Solidity / Hardhat，ERC-4626 金库 + Soulbound 身份凭证（WealthNestID）
- 链：X Layer（OKB 燃料，0 Gas 感，chainId 196）
# 1) 前端 Demo：直接用浏览器打开
open wealth-nest-demo/index.html
# 或部署到静态托管（CloudStudio / Vercel 等）
# 2) AI 后端多智能体（需 OnchainOS 三件套，见 .env.example，绝不入库）
cd agents && cp .env.example .env && npm install && npm run dev
# 3) 合约（本地验证 / 部署）
cd contracts && npm install && npx hardhat compile
⚠️ .env/.env.onchainos含密钥，已 gitignore，绝不入库（见.gitignore）。
本项目不承诺任何收益。页面中所有金融数字来自 X Layer 主网真实读取，含演示性叙事内容仅供参考；真实交易与资产状态以链上凭证为准。
.
├── wealth-nest-demo/ # 前端 Demo（单文件）+ 着陆页
│ ├── index.html # 主交互 Demo（钱包 / 链上读取 / AI 决策闭环）
│ └── landing/ # 产品着陆页
├── agents/ # AI 多智能体后端（四燕：气象/寻金/护巢/筑巢）
│ └── src/onchainos/ # OnchainOS DEX 聚合客户端 + 交易签名
├── contracts/ # Solidity 金库(ERC-4626) + WealthNestID(Soulbound)
├── SUBMISSION.md # 参赛提交材料汇总
└── README.md # 本文件