**瑙勮寖婧愭枃浠?*锛氱敱 MetaRepo spec/ 鍚屾锛岃鍕跨洿鎺ョ紪杈戞湰椤点€?

DataLuminary 外接分析#

版本: v0.1-draft · 外项目: DataLuminary-Platform

1. 边界原则#

VibeAgent 负责：协议、合约、Swap/LP/ve 产品、轻量 API。
DataLuminary 负责：重数据分析、历史统计、套利研究、可视化 Dashboard。

2. 集成方式（v0.15+）#

2.1 API 代理（推荐）#

未配置时返回：

{
  "success": true,
  "data": {
    "source": "none",
    "dashboardUrl": "https://github.com/DataLuminary/DataLuminary-Platform"
  }
}

2.2 前端嵌入#

• web /dex/analytics：iframe 或新窗口打开 DataLuminary 预置 Dashboard
• 链 ID、Pool 地址通过 URL 参数传递（契约由两项目文档对齐）

2.3 数据回写（可选）#

DataLuminary 批处理结果可 webhook 至 VibeAgent（仅展示，非交易路径）：

POST /api/v1/dex/analytics/webhook（内网 + secret）

3. 环境变量#

DATALUMINARY_API_URL=https://api.dataluminary.example
DATALUMINARY_API_KEY=
DATALUMINARY_DASHBOARD_URL=

4. 安全#

• API Key 仅服务端；不进 web 前端
• 分析数据 不参与 Swap 报价路径（防 tampering）
• 交易签名始终客户端钱包

5. 版本协同#

MetaDEX 产品见 METADEX.md。