dev-analyshd/trion-behavioral-oracle-mantle

GitHub: dev-analyshd/trion-behavioral-oracle-mantle

TRION 是一个基于 37 链行为指纹的多链行为预言机套件,通过实时异常检测、合约行为审计、RWA 风险监控和代理执行门为 Mantle Network 提供 DeFi 安全与交易智能。

Stars: 1 | Forks: 0

# TRION 行为预言机 — Mantle 智能套件 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Chain: Mantle](https://img.shields.io/badge/Chain-Mantle%205000-00b4d8.svg)](https://mantle.xyz) [![Chains Indexed: 37](https://img.shields.io/badge/Chains%20Indexed-37-6366f1.svg)](#architecture) [![Formulas: 84 live](https://img.shields.io/badge/Whitepaper%20Formulas-84%20LIVE-10b981.svg)](#) [![Hackathon: Mantle Turing Test 2026](https://img.shields.io/badge/Hackathon-Mantle%20Turing%20Test%202026-f97316.svg)](https://dorahacks.io/hackathon/mantleturingtesthackathon2026) ## 什么是 TRION TRION 是一个多链**行为真理预言机**。当 Chainlink、Pyth 和 Band 聚合 CEX 价格并以更快的速度交付它们——犹如用更快的管道输送同样被污染的水——TRION 则从每个实体在每条链上的实际行为记录中推导真理,剔除操纵,通过一致性进行加权,并受到流动性健康状况的约束。 **倒置的真理层级:** ``` Layer 4 Retail behavior (most manipulable) Layer 3 DeFi on-chain flows ↑ Layer 2 Oracles (band-aid) ↑ Layer 1 CEX prices (root problem) ↑ ───────────────────────────────────────────────── Layer 0 TRION behavioral ground truth ← we are here ``` 每一笔 Mantle 交易都会流经 TRION 的 Rust 索引器 (`trion-evm`, chain ID 5000),为每笔交易生成一个标准的 93 字节行为哈希:`entity(32) || event(1) || magnitude(8) || context(8) || timestamp(8) || chain_id(4) || block_hash(32)`。这些哈希在 FAISS 中积累(包含 11,000–15,000+ 个 128 维向量),从而实现了 CEX 价格推送无法提供的行为模式识别。 ## Mantle 图灵测试黑客松 2026 — 阶段 2:AI 觉醒 本代码库包含五个生产级别的赛道提交作品,每个作品都由一个统一的行为智能引擎驱动。 | # | 赛道 | 模块 | 核心能力 | |---|-------|--------|----------------| | 1 | AI 交易与策略 | `track-1-trading-signal-engine/` | BTV + MF → BUY/SELL/HOLD/AVOID + Kelly 比例 | | 2 | AI Alpha 与数据 | `track-2-alpha-sentinel/` | 实时 Telegram/Discord 异常警报 | | 3 | AI × RWA | `track-3-rwa-risk-monitor/` | USDY/mETH 风险等级 + 收益建议 | | 5 | AI DevTools | `track-5-devtools-auditor/` | 行为合约审计 CLI + Web UI | | 6 | 代理钱包与经济 | `track-6-agentic-execution-gate/` | ERC-8004 信誉 + Byreal Skill | ## 架构 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ Mantle DeFi: Merchant Moe · Agni Finance · Fluxion · USDY · mETH │ └──────────────────────────┬──────────────────────────────────────────┘ │ every transaction ┌──────────────────────────▼──────────────────────────────────────────┐ │ trion-evm Rust Indexer (Chain ID 5000) │ │ Per-tx canonical BH: entity||event||mag||ctx||ts||chain||blockhash │ │ → FAISS ANIMA (128-dim behavioral vectors, 15,000+ indexed) │ └──────────────────────────┬──────────────────────────────────────────┘ │ REST ┌──────────────────────────▼──────────────────────────────────────────┐ │ TRION Oracle API (Flask, port 5000) — 139 endpoints │ │ BTV · MF fingerprint · coherence · planes · agent safety │ │ /api/v1/signal /api/v1/security /api/v1/audit /api/v1/agent │ └────┬───────────┬─────────────┬───────────────┬────────────┬─────────┘ │ │ │ │ │ ▼ ▼ ▼ ▼ ▼ Track 1 Track 2 Track 3 Track 5 Track 6 Trading Alpha RWA Risk DevTools Agentic Signals Sentinel Monitor Auditor ExecutionGate Bot + CLI + Web Byreal Skill Dashboard ERC-8004 NFT │ │ │ └───────────────┴────────────┘ │ ┌───────────────▼──────────────────────────┐ │ On-chain: TRIONMantleExecutionGate.sol │ │ TRIONAgentReputation.sol (ERC-8004) │ │ Mantle Mainnet (Chain ID 5000) │ └──────────────────────────────────────────┘ ``` ## 已部署的合约 ### Mantle 主网 (Chain ID 5000) | 合约 | 地址 | 浏览器 | |----------|---------|----------| | TRIONMantleExecutionGate | `0xA85B49C73B5710d9ddB1CB5a94c52D0F33c4199b` | [查看](https://mantlescan.xyz/address/0xA85B49C73B5710d9ddB1CB5a94c52D0F33c4199b) | | TRIONAgentReputation (ERC-8004) | 通过 `scripts/deploy_reputation.js` 部署 | — | ### 0G Galileo 测试网 (Chain ID 16602) | 合约 | 地址 | |----------|---------| | TRIONOracleV3 | `0x0471B2BE25c2eBbAe7FAc17383F1692979F0A87C` | | TRIONExecutionGate | `0xDB5910Dc6CfD219D00F64be1F23DA0289901356d` | ## 快速开始 ### 前置条件 - TRION Oracle API 运行在 `localhost:5000`(参见 [trion-core](https://github.com/dev-analyshd/trion-core)) - Python 3.11+ 并带有 `uv` 或 `pip` - 用于 Track 6 的 Node.js 20+ ``` git clone https://github.com/dev-analyshd/trion-behavioral-oracle-mantle cd trion-behavioral-oracle-mantle cp .env.example .env # 使用你的 API keys 编辑 .env ``` ## Track 1 — AI 交易与策略 **为 Mantle DeFi 剔除操纵的价格信号。** TRION 的行为真实价值 (Behavioral True Value) 公式: ``` BTV = P_ref × Ω × (1 − MF_discount) × C_weight × NL_weight Where: Ω = tanh(chains/10) × D_eff (37-chain consensus weight) MF_discount = 2.5% + MF_score × 35% (manipulation stripped out) C_weight = 0.95 + 0.07 × C(t) (coherence weighting) NL_weight = 0.95 + 0.07 × NL (natural liquidity) ``` 信号逻辑:当 BTV < market × 0.95 且 MF 干净 且 C(t) ≥ 0.60 时,执行 **BUY**。 头寸规模:Kelly 比例 × 一致性 × (1 − MF_score)。 ``` cd track-1-trading-signal-engine pip install -r requirements.txt python trion_trading_signals.py --assets ETH,BTC,MNT --once python trion_trading_signals.py --run --interval 60 ``` ## Track 2 — AI Alpha 与数据 (Alpha Sentinel) **针对 Mantle DeFi 的实时行为异常检测。** 监控 Merchant Moe、Agni Finance、Fluxion、USDY、mETH —— 当 TRION 检测到以下情况时,会向 Telegram/Discord 触发警报: - 🔄 **WASH** — 循环资金流比率 > 0.60 且对手方 < 5 - 👥 **SYBIL** — 资金集中度异常 - ⚡ **MEV** — 三明治攻击 / 抢跑抽取率激增 - 📈 **PUMP** — 同步买入比率 > 0.85 - 📊 **FAKE_VOL** — 交易量熵低于基线 - 🏛️ **GOV_CAPTURE** — HHI > 2500 的治理集中度 ``` cd track-2-alpha-sentinel pip install -r requirements.txt # 配置警报(可选 — 若未设置则输出到 stdout) export TELEGRAM_BOT_TOKEN=your_token export TELEGRAM_CHAT_ID=your_chat_id export DISCORD_WEBHOOK_URL=your_webhook # 启动 sentinel bot python mantle_alpha_sentinel.py --threshold 0.35 --interval 30 # 启动 live dashboard(单独的终端) python dashboard.py # → http://localhost:5010 ``` **仪表盘预览:** 所有 Mantle 协议的实时 MF 分数表 + 警报历史。 ## Track 3 — AI × RWA **针对 USDY、mETH 和 Mantle RWA 资产的动态风险监控。** 风险分类: ``` SAFE — C(t) ≥ 0.70 | MF < 0.25 | NL > 0.70 → HOLD/ACCUMULATE ELEVATED — C(t) ≥ 0.55 or MF ≥ 0.25 → HEDGE (50% allocation) HIGH — C(t) < 0.45 or MF ≥ 0.50 → REDUCE (25% allocation) CRITICAL — MF ≥ 0.70 or coherence collapse → EXIT ``` 系统会追踪稳定币(USDY、USDT、USDC)相对于行为真实价值的锚定偏差。如果 `|BTV − $1.00| / $1.00 ≥ 2%` → 自动升级至 HIGH 等级。 ``` cd track-3-rwa-risk-monitor pip install -r requirements.txt python trion_rwa_risk_monitor.py --assets usdy,meth --once python trion_rwa_risk_monitor.py --run --interval 60 --report json ``` ## Track 5 — AI DevTools (行为合约审计器) **针对 Mantle 的行为合约审计 CLI + Web UI。** 与静态分析(Slither、MythX)不同,TRION 审计的是合约及其部署者在 37 条链上的*行为记录*: - 通过 TRION 的 Living Security CRISPR 库进行 **20 项漏洞扫描** - **8 种历史攻击模式匹配**:Harvest、Beanstalk、Mango、Jimbos、Euler、Curve、Ronin、Wormhole - **部署者跨链信誉** — 此部署者是否在其他链上参与过漏洞利用? - **风险等级** 输出:SAFE / LOW / MEDIUM / HIGH / CRITICAL ``` cd track-5-devtools-auditor pip install -r requirements.txt # CLI — 输出到终端 python mantle_contract_auditor.py 0x4515A45337F461A11Ff0FE8aBF3c606AE5dC00c9 # CLI — HTML 报告 python mantle_contract_auditor.py 0x... --format html --output report.html # Web UI python mantle_contract_auditor.py --serve --port 5011 # → http://localhost:5011 ``` ## Track 6 — 代理钱包与经济 **作为具备 ERC-8004 代理信誉的 Byreal Skill 的 TRION ExecutionGate。** Mantle 上的每一个 AI 代理动作在执行前,都会经过 TRION 的 5 重门行为安全流水线验证。代理的 ERC-8004 信誉评分会随着每次互动而更新。 **5 重门流水线:** 1. **一致性门 (Coherence Gate)** — C(t) ≥ 阈值(结构化静默检查) 2. **操纵门 (Manipulation Gate)** — MF_score < 区块阈值 3. **流动性门 (Liquidity Gate)** — 自然流动性 NL = LD·LO·LC·LS > 最低要求 4. **原型门 (Archetype Gate)** — 行为原型不在敌对名单中 5. **系统性风险门 (Systemic Risk Gate)** — SYSTEMIC_RISK 信号未激活 **信任等级(ERC-8004 扩展):** | 等级 | 分数 | 互动次数 | 权益 | |------|-------|-------------|---------| | BOOTSTRAP | 0–199 | 任意 | 标准限额 | | ACTIVE | 200–499 | ≥10 | 提高的交易限额 | | PRIME | 500–799 | ≥100 | 降低的 gas 费,优先权 | | APEX | 800+ | ≥500 | 最大信任,治理访问权限 | ``` cd track-6-agentic-execution-gate npm install # 运行 demos npm run demo:check npm run demo:reputation npm run demo:audit npm run demo:alerts # 或直接: node trion_byreal_skill.js check demo-agent-001 SWAP 0x4515... 10000 node trion_byreal_skill.js reputation 0xYourAgentAddress node trion_byreal_skill.js audit 0x4515A45337F461A11Ff0FE8aBF3c606AE5dC00c9 ``` **Byreal Skill 注册:** ``` import TRIONSkill from "./trion_byreal_skill.js"; // Register with Byreal Skills CLI const result = await TRIONSkill.invoke("trion.checkExecution", { agentId: "my-agent-001", actionType: "SWAP", entityId: "0x4515A45337F461A11Ff0FE8aBF3c606AE5dC00c9", valueUsd: 10000, }); ``` ## 共享客户端 SDK 所有 Track 均从 `shared/trion_client.py` 导入 —— 这是一个类型化、安全重试的 Python 客户端,适用于所有 139 个 TRION Oracle API 端点。 ``` from shared.trion_client import TRIONClient, MANTLE_PROTOCOLS client = TRIONClient(base_url="http://127.0.0.1:5000") # Five-plane behavioral coherence signal sig = client.signal("0x4515A45337F461A11Ff0FE8aBF3c606AE5dC00c9") # Manipulation fingerprint mf = client.mf_severity("0x4515A45337F461A11Ff0FE8aBF3c606AE5dC00c9") print(f"MF Score: {mf['mf_score']} Severity: {mf['severity']}") # Behavioral True Value btv = client.btv("ETH", "USD") # Agent safety validation (5-gate pipeline) result = client.agent_validate( agent_id="byreal-agent-001", action_type="SWAP", entity_id="0x4515A45337F461A11Ff0FE8aBF3c606AE5dC00c9", value_usd=10000, chain_id=5000, ) ``` ## 链覆盖范围:37 条链 TRION 通过 `trion-evm` 原生将 Mantle 索引为 14 条 EVM 链之一。这 37 条链的行为图谱提供了单链分析无法提供的跨链上下文: | 集群 | 链 | |---------|--------| | EVM 主网 | ETH · ARB · BASE · OP · BNB · POLYGON · AVALANCHE · **MANTLE** · LINEA · SCROLL · CELO · GNOSIS · HASHKEY · ZG | | EVM 测试网 | ARB Sepolia · ETH Sepolia · BASE Sepolia · OP Sepolia · HASHKEY Sepolia | | SVM | Solana | | Native VM | NEAR · TON · StarkNet · Polkadot | | Extended VM | Bitcoin · Cosmos · Kava · Injective · SEI · dYdX · Initia · Aptos · SUI · TRON · Pi · Movement · 0G | ## 五大行为平面 | 平面 | 符号 | 测量内容 | |-------|--------|-----------------| | 物理层 (Physical) | Φ | 链上熵、交易速度、MEV、流动性模式 | | 心智层 (Mental) | M | 预测准确度、Genesis 推理、估值一致性 | | 精神层 (Spiritual) | Σ | 验证者多样性加权的 BFT 共识质量 | | 意识层 (Conscious) | K | 治理参与度、质押加权的人类信号 | | 灵魂层 (ANIMA) | A | 显现前状态 — 链下叙事、情绪、意图 | **五平面一致性:** `C(t) = α·Φ + β·M + γ·Σ + δ·K + ε·A` 仅当 `C(t) ≥ Θ(t)` 时才发出信号。低于阈值时:**结构化静默** (Structured Silence,信号的有意义缺失)。 ## 为什么选择 TRION 而不是基于 LLM 的分析 | 能力 | LLM 摘要工具 | TRION | |-----------|----------------|-------| | 真理来源 | 链上文本 + 价格 | 基于单笔交易的行为哈希 | | 抗操纵性 | 低(反映 CEX 数据) | 原生支持(应用了 MF 折扣) | | 跨链上下文 | 单一链条 | 37 条链,同态映射 | | 结构化静默 | 否 | 是 — 信号的缺失是有意义的 | | 代理安全门 | 否 | 5 重门行为流水线 | | 密码学完整性 | 否 | 双链 SHA3 + PQC | | 历史攻击记忆 | 否 | CRISPR 库:8 种已知的 DeFi 攻击 | ## TRION 核心代码库 完整的 TRION 协议、139 个 API 端点、13 个 Rust crate、FAISS ANIMA 引擎以及全部 84 个白皮书公式位于: **[github.com/dev-analyshd/trion-core](https://github.com/dev-analyshd/trion-core)** ## 许可证 MIT — 这些知识属于每一个人。 **作者与创始人:** Hudu Yusuf (Analys) **黑客松:** Mantle 图灵测试黑客松 2026 — 阶段 2:AI 觉醒 **提交标签:** `#MantleAIHackathon`
标签:MITM代理, Rust, Web3, 区块链, 可视化界面, 向量检索, 异常检测, 智能合约审计, 网络流量审计, 逆向工具