核心用法
Breeze x402 Payment API是一个基于Solana的DeFi自动化技能，通过x402支付协议实现对Breeze策略协议的存取款操作。用户每笔API调用需支付小额USDC微支付作为访问费用，随后获得未签名的Solana交易供本地签名广播。
关键流程：
1. 环境准备：需Node.js、 funded Solana钱包（USDC+少量SOL作gas）
2. 安装依赖：使用@faremeter/*系列包处理x402支付封装与Solana交互
3. 初始化：通过wrap(fetch)创建支付封装fetch，自动处理402挑战-支付-重试流程
4. 核心操作：
- Balance查询：
GET /balance/{wallet}返回仓位、收益、APY - Deposit：
POST /deposit构建存款交易，需自行签名发送 - Withdraw：
POST /withdraw支持部分/全部提取，含WSOL解包选项
技术特点：采用x402协议（HTTP 402 Payment Required）实现API商业化，交易返回为base64编码的VersionedTransaction或legacy Transaction，需客户端完成最终签名。
显著优点
1. 无需托管私钥：API仅返回未签名交易，用户保持资产控制权
2. 微支付即服务：单次API调用成本极低，按需付费模式适合自动化策略
3. 收益策略即插即用：默认策略ID支持多种LST（JitoSOL/mSOL等）和稳定币收益池
4. 完善的错误处理：区分400/402/500级错误，提供清晰的重试指导
潜在缺点与局限性
1. 私钥暴露风险：需将WALLET_PRIVATE_KEY作为环境变量注入，虽文档强调安全规则，但仍属敏感操作
2. 依赖特定npm生态：--legacy-peer-deps标志和复杂的peer dependency关系增加维护成本
3. 主网唯一性：仅支持Solana mainnet-beta，无devnet测试环境
4. 交易确认责任：用户需自行处理交易签名、广播、确认全流程，失败场景需手动重试
5. 协议单点依赖：完全依赖Breeze协议存活性与x402服务端可用性
适合人群
- 已有Solana开发经验的量化交易者/DeFi自动化玩家
- 需要程序化管理收益仓位的机构或高净值个人
- 愿意承担自托管风险以换取非托管优势的进阶用户
- 不适合：新手用户、无法安全保管私钥的用户、追求一键式托管体验的用户
常规风险
| 风险类型 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 私钥泄露 | 环境变量/文件泄露导致资金被盗 | 使用硬件签名器替代（当前不支持）、严格.gitignore、临时env |
| 智能合约风险 | Breeze策略合约漏洞或Rug | 审计状态未明示，建议小额测试 |
| 交易失败 | 滑点、网络拥堵导致交易pending | 设置合理超时、监控链上状态 |
| x402支付累积 | 高频调用导致微支付成本上升 | 批处理请求、监控USDC消耗 |
| API服务中断 | Breeze服务端不可用 | 本地缓存关键数据、设置熔断机制 |