SuperAPI AI 工具集

intuition

智能体与模型

查看项目

更新于 10-15 07:46

技能介绍

用途

Intuition 是一个 Agent Skill,用于在与 Intuition Protocol 进行链上交互时,指导 AI 代理生成正确的交易。其说明中的 ABI、编码模式、地址和数值计算均声明已针对 V2 合约验证。

主要能力

该技能分为两条路径:

  • Path A:只读探索。用于搜索 atom、浏览 triple、分析图谱或发现持仓,无需钱包或链上设置。通过 GraphQL 端点查询,无需认证。
  • Path B:写入操作。用于创建 atom、triple、存入或赎回,需要已注资钱包和会话设置。

写入操作涵盖:创建 atom vault、创建 triple vault、向 vault 存入 $TRUST 并铸造份额、从 vault 赎回份额并取回 $TRUST、批量存入、批量赎回,以及为委托流程授予或撤销存入/赎回授权。

技能还提供自主模式策略、模拟门控、机器可读 JSON 输出契约,以及广播后的验证流程。

协议模型

  • Atoms 代表任意概念(人物、URL、地址、标签),通过将 URI 编码为 bytes 创建,每个 atom 具有确定性的 bytes32 ID 和 vault。富元数据需先将结构化数据固定到 IPFS,再编码 ipfs:// URI。
  • Triples 是连接三个术语的声明:(subject, predicate, object),常见情况连接三个 atom,任意位置也可复用已有 triple term_id 进行嵌套组合。每个 triple 有 vault 和自动的 counter-triple vault。
  • Vaults 为每个 atom 和 triple 提供支持。存入 $TRUST 会在 bonding curve 上铸造份额。向 triple 存入表示同意,向其 counter-triple 存入表示不同意。
  • 原生代币:$TRUST(主网)/ tTRUST(测试网),18 位小数。所有 msg.value 和 gas 以 TRUST 计价。

使用方式

首次调用时需选择网络:Intuition Mainnet(chain 1155)或 Intuition Testnet(chain 13579)。网络元数据(chain ID、RPC URL、GraphQL 端点、浏览器 URL、MultiVault 地址、viem chain 定义)位于 reference/network-config.md。

Path A 流程:从网络配置表获取 GraphQL 端点,加载 reference/graphql-queries.md 获取查询模式、过滤器、遍历和聚合方式,然后查询图谱。纯发现不需要 atomCost、tripleCost、defaultCurveId 或任何 cast call / readContract 设置。

Path B 流程:加载自主策略(无人值守执行时从 reference/autonomous-policy.md 加载并缓存 mode、limits、approvals、safety gates);运行会话设置(执行 reference/reading-state.md 中的前置查询,缓存 atomCost、tripleCost、defaultCurveId、$GRAPHQL);读取相关操作文件;执行前置查询;仅从可信意图生成 calldata 和 value;运行授权和模拟门控;输出机器可读 JSON;广播后验证。

输出契约:可执行写入输出一个未签名交易对象 {to, data, value, chainId};需要审批的写入输出审批请求对象;pinning 配置不可用或失败时输出 pin_failed 对象。顶层数值字段使用十进制字符串。

前置条件

  • 钱包基础设施:签名机制(钱包 MCP 工具、后端服务、带私钥的 cast)。该技能生成未签名交易参数,由基础设施负责签名和广播。
  • 已注资钱包:Intuition L3 上的 $TRUST(主网)或 tTRUST(测试网)。
  • RPC 访问:公共 Intuition RPC 端点,无需 API 密钥。
  • 结构化 atom 的 pinning 能力:由消费应用的可信服务器或 CLI 运行时拥有配置和凭据。推荐 @0xintuition/sdk 3.0.1 或更新版本配合 configureSdk({ pinApiKey }),或兼容的宿主提供适配器。技能不会获取、存储、打印密钥,也不会将其放入提示、计划、交易输出或浏览器代码中。

适用场景

  • 在 Intuition Protocol 上进行只读图谱探索与发现。
  • 创建 atom 和 triple 并存入 $TRUST 以表达经济信号。
  • 批量存入或赎回多个 vault。
  • 无人值守代理在策略驱动审批下执行链上写入。

限制

  • 该技能生成未签名交易参数,签名和广播由外部钱包基础设施处理。
  • 写入操作需要已注资钱包和会话设置。
  • 结构化 atom 写入需要 pinning 能力;未配置时输出 pin_failed 且不尝试请求、不要求用户粘贴密钥、不检查秘密文件、不输出交易数据。
  • 技能不捆绑可执行签名中间件,运行时强制需在签名器或执行器管道中实现。
  • L3 未被 Etherscan 索引,代理无法自动发现 ABI,需使用提供的 ABI 片段。
  • 主网与测试网数据特征不同:主网有真实 $TRUST 质押和活跃代理基础设施,测试网为测试代币、代理活动较少。
  • 关于收费、价格等具体数值,资料中仅提及 gas 费用约每笔 0.0001 TRUST,其余暂未提供。