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)
[](https://mantle.xyz)
[](#architecture)
[](#)
[](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, 区块链, 可视化界面, 向量检索, 异常检测, 智能合约审计, 网络流量审计, 逆向工具