SuperAPI AI 工具集

tres-data-collection-commit

数据与分析

查看项目

更新于 10-15 19:56

技能介绍

用途:该技能是 Tres Finance 客户入驻流程的第二步,用于对已入驻的钱包触发链上数据采集(Commit),让平台拉取链上状态。第一步为上传钱包(tres-wallets-upload),第三步为余额校验(tres-asset-balance-validation)。

主要能力:支持两种采集模式——全量数据采集(收集完整交易历史与当前余额,较慢)和仅余额(只收集当前资产余额,不采集交易,较快);可选择对全部钱包或指定钱包执行。通过 TRES MCP 的 execute 工具调用 triggerCommit 变更,返回 status、message 和 commitId。

使用方式:预先连接 TRES MCP 并确保已认证(get_viewer 返回 orgName),且至少已入驻一个钱包。流程为:确认认证;询问采集模式并映射到 GraphQL 参数 balancesOnly(全量 false,仅余额 true);询问钱包范围,全部则 internalAccountIds 为 null,指定则先用 internalAccount 查询列出钱包并以编号纯文本呈现,将用户回复解析为 id;展示确认摘要并等待肯定回复;执行 mutation TriggerCommit,变量键须为 camelCase;最后报告结果并提示下一步为余额校验(不自动触发)。用户明确要求日期范围时可传入 ISO 8601 UTC 的 fromDate/toDate。

适用场景:首次入驻或历史回填、仅需余额快照、新加钱包后同步、刷新 Tres 数据等。

限制:commit 为异步任务,triggerCommit 入队后不阻塞等待完成;仅余额模式仍会更新每钱包的余额快照,只是跳过交易摄取;无钱包时 totalCount 为 0,需先上传钱包;可能出现部分钱包成功、部分失败,详细诊断在 TRES UI 的 Data Collection 日志;重复提交安全,Tres 按链上标识去重;取消运行中的 commit 不在本技能范围内,但存在 killCommits。若 get_viewer 失败、无钱包或用户提供的名称无法解析,应提示或请求澄清而非猜测。