insight-oracle

Insight — 决策完整性与预言机风险情报

Insight 是面向 DeFi 和 AI Agent 的预言机透明度、决策完整性与风险情报基础设施，构建于 BNB Smart Chain（BSC），并兼容其他 EVM 网络。

Insight 帮助 DeFi 应用、运营方、开发者和 AI Agent 检查预言机价格，以及依赖这些价格所面临的风险。它会比较来自 40 多个区块链网络上的 13 家预言机提供商的数据，评估偏差、新鲜度、来源独立性和对协议的影响，并可为评估结果出具签名证据。对于 AI Agent 而言，这意味着决策输入完整性：在签署交易前，以签名且可重新验证的方式回答“这个价格可信吗”。

Oracle observations → Cross-source comparison → Risk assessment → Decision-input integrity → Verifiable evidence

交易前安全检查会评估拟议操作。预言机监控会在操作之间监控不断变化的情况。REST API、MCP 服务、Guard SDK 和独立验证器让应用和 Agent 可以使用这些功能。Insight 也可独立于 PriorSeal 运行；有关评估、授权、执行和审查的组合工作流，请参阅产品定位指南。

借贷防护现已覆盖 Base 和 Monad 上的专用直接调用配置。它会检查 Aave V3 和 Morpho Blue 在这两条链上的抵押品及贷款预言机完整性，以及由调用方声明的操作后 LTV；此外还覆盖 Compound V3 Base USDC Comet 和经过审核的 Moonwell Base 市场。它是只读的，并按 x402 计费；绝不会签署或广播借贷交易。请参阅 Base 借贷防护和 Monad 借贷防护。

Insight 不是实时预言机跟踪器。价格快照和数据源健康状况每 15 分钟收集一次，声誉评分每小时重新计算一次，数据则汇总为每日报告。使用评估结果前，请检查其新鲜度和有效期。

技术栈

• 区块链： BNB Smart Chain（BSC）——主要部署链——以及兼容 EVM 的链（预言机数据覆盖 40 多个网络）
• 智能合约： Insight 不部署任何智能合约——它集成官方 ERC-8004 身份与声誉注册表，并使用 x402（AEON facilitator）结算
• 前端： Next.js（React）+ viem
• 开发： TypeScript、Node.js 22、Jest、Supabase
• BNB Chain 部署配置： bnbconfig.json — 链、合约、Agent 注册和 x402 结算详情

支持的网络

• 按调用付费的 x402 结算： Base、Polygon、Arbitrum One、Monad、BNB Smart Chain 和 Solana 主网。目前在生产环境中公布的支付通道，以公开的 x402 清单为准。
• BNB Smart Chain（Chain ID：56）： 通过 AEON 授权流程使用 Binance-Peg USDC；客户端必须使用提供的授权方案，而非标准 EIP-3009 付款方。
• Monad 主网（Chain ID：143）： 只读覆盖 51 个官方 Chainlink USD 价格源，并通过 Circle 原生 USDC 进行 x402 结算。
• 其他 EVM 支付通道： Ethereum、OP Mainnet、Avalanche、Sei 和 X Layer 均有类型化的支付配置项，但在确认其 facilitator 支持并完成端到端结算检查之前，不会作为公开支付通道展示。
• 其他 EVM 网络上的预言机数据采用只读方式覆盖（40 多条链）

合约地址

Insight 是一项 API/Agent 服务，不发行代币。它在链上的记录是其在 BNB Mainnet 和 Monad Mainnet 上的 ERC-8004 Agent 注册：

网络	核心合约	代币合约
BNB Mainnet	ERC-8004 Identity Registry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432（Insight Agent #375779） · ERC-8004 Reputation Registry 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63	无 — 不发行代币
Monad Mainnet	ERC-8004 Identity Registry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432（Insight Agent #10414） · ERC-8004 Reputation Registry 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63	无 — 不发行代币
BNB Testnet	无	无

功能

• 交易前安全检查 — 跨预言机的交易前判定（PASS / CAUTION / DANGER / BLOCK），附带签名的 EIP-712 证明和建议的最大仓位规模
• 预言机监控 — 在操作之间持续监控，并提供 proceed / proceed_with_caution / halt 建议
• 面向 Agent 的支付 — 在 BNB Chain 上通过 x402 按次调用付费，使用 USDC（AEON mandate flow），并提供托管 MCP 服务 /api/mcp；已注册的 ERC-8004 Agent #375779
• 可验证的证据 — 可独立验证的签名回执，以及可选择将已完成的检查锚定至 ERC-8004 声誉记录

从这里开始

目标	前往
查看当前预言机证据	预言机证据
评估拟执行的操作或监控变化的输入	决策完整性、Guard SDK，或 API 参考
比较数据源或调查风险问题	风险情报
选择 REST、AI / MCP 或 SDK	构建
使用自己的可信密钥验证签名回执	独立验证器或浏览器演示
在本地运行网站和 API	本地开发

Insight 提供什么

面向 AI Agent：决策输入完整性

Agent 与人类的失误方式不同：它们会依据读取到的价格采取行动，而遭到操纵或过时的价格会导致 Agent 满怀信心地执行糟糕的交易。pre_trade_safety_check 回答了交易模拟器无法回答的问题——Agent 即将信赖的价格当前是否可信——并通过跨提供商一致性、操纵风险评分和数据源健康状况给出结果，以签名的 EIP-712 判定返回。Agent 可通过 MCP 端点或 x402 按次付费调用；人类可使用独立验证器重新验证回执。

交易前安全检查

在交换、借款、出借、清算或还款之前，应用可以请求跨预言机评估。响应会综合价格一致性、偏差、新鲜度、稳定币锚定状态、信誉和相关协议风险，给出 PASS、CAUTION、DANGER 或 BLOCK 判定，并推荐最大持仓规模。若判定为 DANGER 或 BLOCK，Agent 不应执行交易。

判定来自确定性规则；实验性 ML 评分仅提供额外参考，并不影响判定。持续的预言机分散度若耗尽协议的清算缓冲，借贷检查可以冻结新的借款。成功返回的判定会在签发前写入审计日志；若审计存储失败，则无法成功响应。

配置签名后，检查可以包含 EIP-712 证明。签名可以证明是谁签发了其中的字段，以及字段是否发生过更改。它不能证明底层价格正确，也不能证明 Agent 遵守了判定。有关特定版本的验证要求，请参阅验证器支持的架构。

Oracle Watch

Oracle Watch 为运行中的策略提供跨预言机 NORMAL、CAUTION 或 DANGER 信号，以及 proceed、proceed_with_caution 或 halt 建议。应用可以在交易之间轮询，并在收到 halt 时暂停。它会检查偏差、一致性、过时或异常的数据源、覆盖情况和独立来源组；配置证明密钥后，还可以签发签名回执。

以下资产和网络可保证历史数据覆盖：Ethereum、Arbitrum 和 Base 上的 ETH、BTC、USDC 和 USDT。其他交易对可能仅返回当前信号，而没有历史曲线；请检查 meta.historyGuaranteed，不要把空序列视为没有事件的证据。可使用 Decision Integrity 页面或 GET /api/v1/oracle-watch?symbol=ETH&chain=ethereum 查看该信号。

探索预言机和协议风险

Web 应用还提供跨预言机价格比较、数据源健康状况和信誉、持仓安全与清算分析、稳定币和封装资产的 Peg Risk，以及日报。研究人员可以检查来源时间戳并导出结果；开发者可以使用相应的 API 端点。

集成的提供商包括 Chainlink、Pyth Core、Stork、Chronicle、API3、RedStone、DIA、WINkLink、Supra、Uniswap V3 TWAP、Reflector、Flare 和 Band。Monad 还提供独立的、区块固定的 Uniswap V3 WMON/USDC 执行市场层：现货价格、15 分钟 TWAP、区间内流动性、固定规模的 Quoter V2 滑点，以及已最终确定的 Swap 事件成交量。DEX 证据不计作独立预言机，也不会纳入预言机共识。持仓安全支持特定的 Aave V3、Compound V3、Morpho Blue、Venus 和 BENQI 市场。覆盖范围因资产和网络而异，因此请确认正在评估的持仓所适用的数据源和协议参数。

SDK、API、MCP 和验证器

• Guard SDK — 用于评估、监控和获取受支持的执行价格证据的 TypeScript 集成。assessSwap() 支持仅评估工作流；可选辅助工具可控制交易提交，并请求执行回执。SDK 使用 Insight API 及其积分钱包。
• REST API — 提供价格、风险、安全检查和 Oracle Watch 的版本化 /api/v1/ 端点。计量调用使用 X-API-Key；公开的回执验证端点无需密钥。API 参考包含请求和响应的详细信息。
• MCP 服务 — 通过 stdio、HTTP 或应用的 /api/mcp 端点，向兼容的 Agent 提供相同服务。客户端配置和工具请参阅 AI/MCP hub。
• 独立验证器 — 在本地验证回执签名和签名字段，无需依赖 Insight API。使用方必须独立确认对证明者密钥或密钥注册表的信任；成功验证签名并不代表认可某笔交易或判定结果。

REST、MCP 和 SDK 调用共用同一个 API 密钥积分钱包。套餐增加的是积分额度，而非独立的功能层级。套餐和每次调用的费用请参阅当前定价。

MCP 端点（生产环境）

托管的 MCP 服务已上线，地址为 https://www.oracleinsight.xyz/api/mcp（可流式传输的 HTTP）。

• 匿名发现：initialize、tools/list 和 ping 无需凭据即可使用，因此 Agent 可先浏览包含 40 多种工具的 oracle 目录，再决定是否继续。
• 经过身份验证的调用：传入 API 密钥后，调用将从积分钱包扣除。
• x402 按次付费：单次未认证的 tools/call 会收到按工具计费类别定价的 x402 v2 402 报价（在已配置的 EVM 和可选的 Solana 网络上使用 USDC），随后进行验证 → 执行 → 结算。工具执行失败时绝不会结算。
• 一键安装（Cursor）：安装 Insight Oracle
• 发现入口：网站根目录下的 llms.txt、/.well-known/x402、/.well-known/mcp/server-card.json 和 openapi.json。
• 注册表收录：已作为 io.github.imokokok/insight-oracle 发布到官方 MCP 注册表。

x402 快速入门（按次付费）

REST 交易前安全检查支持 x402；当 MPP_ENABLED=true 时，也支持 MPP，并使用相同的已配置 USDC 价格、网络、接收方和中介服务。初始 HTTP 402 响应会公布两种支付方式；业务错误不会结算。设置仅供服务端使用的 MPP_SECRET_KEY，长度至少为 32 字节，以签署 MPP 挑战。/api/mcp 上的完整 MCP 工具目录继续支持 x402 和 API 密钥。单独启用的 MPP MCP 试点（MPP_MCP_ENABLED=true）仅在 /api/mcp/mpp 暴露 pre_trade_safety_check；MPP 挑战会绑定工具参数，并且仅在成功后结算。启用后，实时 /openapi.json 发现信息会发布包含已配置 USDC 合约和原子单位金额的规范 MPP 报价。可直接复制使用的 curl、TypeScript（@x402/fetch 或 mppx）、Python（x402[httpx,evm]）和 MCP 客户端示例，位于 examples/x402-quickstart 和按次付费快速入门页面。

本地开发

需要 Node.js 22 或更高版本。在仓库根目录执行：

npm install
npm run dev

环境配置请参阅 .env.local.example 和 src/lib/config/serverEnv.ts。开发环境缺少密钥时可以使用安全默认值；生产环境需要 Supabase 凭据、CSRF_SECRET 和 JWT_SECRET。签名的交易前证明需要 ATTESTATION_SIGNER_PRIVATE_KEY。

如需单独运行 MCP 服务：

npm run mcp:stdio   # local stdio transport
npm run mcp:http    # HTTP transport at http://127.0.0.1:3001/mcp

该应用使用 Next.js、React、TypeScript、Tailwind CSS 和 Supabase 构建。应用路由和 API 处理程序位于 src/app/；核心预言机、风险、证明和计费逻辑位于 src/lib/；MCP 代码位于 src/mcp/。数据库迁移位于 supabase/。

文档

主题	详情
产品范围及与 PriorSeal 的关系	产品定位 和 Guard SDK
收据架构和独立验证	验证器 README 和 注册表发布政策
合作伙伴协议和发布隔离	主线合作伙伴隔离 和 协议 README
运维和数据收集	生产就绪情况、cron 调度器 和 集成可靠性
数据库变更	SQL 清单和执行顺序
实验性 RWA 工作	RWA v1、RWA v2 和 工具注册表

RWA／代币化股票适配仍是可选研究；目前未启用生产环境 RWA 签名方或授权政策。可选的 Robinhood 股票代币发行方上下文为只读，不计作独立预言机来源。

许可证

请参阅 LICENSE。