SuperAPI AI 工具集

return-funds

通用与其它

查看项目

更新于 10-15 20:10

技能介绍

用途:当操作者要求退款(如“send it back”“return the XNO”“refund”)时,按安全流程将 XNO 退回原发送方或指定地址。

主要能力:识别应退还的资金来源。若请求关联支付请求,调用 payment_request_refund(带请求 ID,execute: false)返回已接收区块的来源地址;否则调用 wallet_history 查看近期交易,找出发送来源。系统会判断退款目标是否明确:单一来源时列出来源地址与金额供确认;多来源时列出全部候选地址及各自金额,请操作者选择;无来源时告知“没有可退的入账交易”。

使用方式:确认目标后,调用 payment_request_refund(execute: true 并传入 confirmAddress)执行;若未关联支付请求,可直接使用 wallet_send。完成后报告发送哈希与更新后的余额。若操作者给出具体地址,先用 validate_address 校验地址,再确认金额后直接发送。

安全规则与限制:绝不猜测退款目标,存在任何歧义都必须向操作者确认;即使只有一个来源,发送前也要确认;展示完整地址不得缩写;支持部分退款;需检查额度限制,若受限需操作者通过 wallet_set_allowance 提高限额或确认后再进行;“return everything”需检查所有钱包账户余额并逐一列出后再确认。相关技能包括 request-payment、mcp-wallet、validate-address。