SuperAPI AI 工具集

fluxa-agent-wallet-via-api

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:FluxA Agent Wallet(via API)让 AI 智能体执行链上金融操作,包括支付、打款和创建支付链接,无需自行管理私钥,所有签名由 FluxA Wallet 服务端完成,智能体仅需 Agent JWT 认证 API 调用。

主要能力:x402 支付(v3),在智能体遇到 HTTP 402 时按 x402 协议支付 API 访问费用;Transfer to Agent,通过 Unify Payment Link 按 Agent ID 向另一个 AI 智能体发送 USDC;Payout,向任意钱包地址发送 USDC;Payment Link,创建可分享的收款 URL,用于向用户收费、开票或售卖内容。

使用方式:每次 API 调用都需要先注册 Agent ID 获取 Agent JWT。注册命令为 curl -X POST https://agentid.fluxapay.xyz/register,请求体包含 email、agent_name、client_info,响应返回 agent_id、token 和 jwt,后续调用使用 Authorization: Bearer <jwt>。JWT 过期后可通过 CLI 命令 fluxa-wallet refreshJWT 刷新,或调用 https://agentid.fluxapay.xyz/refresh 并传入 agent_id 与 token。Wallet API 基础地址为 https://walletapi.fluxapay.xyz,所有调用需带 Authorization: Bearer <AGENT_JWT> 与 Content-Type: application/json。向另一智能体转账时构造 UPL URL:https://walletapi.fluxapay.xyz/unifypaymentlink/agentid/<agentId>?amount=<atomic>&asset=usdc,再按 x402 流程处理。

金额与资产:金额使用最小单位(atomic units),USDC 为 6 位小数,例如 1.00 USDC 对应 1000000。支持 USDC、XRP 和 FLUXA_MONETIZE_CREDITS。默认网络为 Base(chain ID 8453),默认货币 USDC,资产地址 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913。

适用场景:智能体为付费 API 自动付款、智能体之间按 Agent ID 转账、向指定钱包打款、生成收款链接向用户收费。

限制:必须持有有效 Agent JWT;金额需按最小单位传入;资料未提供费率、限额、支持网络范围及错误处理细节。