用途：把本地任意文件上传到 S3 云存储，返回可分享的公开 URL，支付通过 x402 微支付完成，无需 API 密钥，支付即为鉴权。
主要能力与收费档位：购买上传名额后获得临时 uploadUrl（1 小时有效）与 publicUrl（自购买日起 6 个月有效）。档位按文件大小选择：10mb（10 MB，$0.10）、100mb（100 MB，$1.00）、1gb（1 GB，$10.00）。可用 x402.fetch_with_auth 调用 https://agentupload.dev/api/x402/uploads 列出当前钱包的上传记录（SIWX 认证，非 x402 支付）。
使用方式：先调用 x402.get_wallet_info() 检查钱包余额，确认 USDC 足够；用 ls -la 或 wc -c 检查文件大小，选可容纳的最小档位；POST 到 https://agentupload.dev/api/x402/upload 购买名额，body 包含 filename、contentType、tier，contentType 建议填正确 MIME 类型（如 text/csv、application/json、application/pdf、image/png、application/zip，未知类型用 application/octet-stream）；随后用 curl 上传：curl -s -X PUT "<uploadUrl>" -H "Content-Type: <mime>" --data-binary @/absolute/path/to/file，务必使用 --data-binary（而非 -d）以保留二进制内容，并使用绝对路径。最后把 publicUrl 提供给用户。多文件需为每个文件单独购买名额，可并行购买但上传须各自使用对应 uploadUrl。可用 x402.discover_api_endpoints(url: "https://agentupload.dev") 验证端点。
限制与错误处理：uploadUrl 1 小时过期，购买后应尽快上传，过期需重新购买且此前付款不退还；publicUrl 为期 6 个月；余额不足时展示 get_wallet_info 的充值链接；文件超出档位则建议升档；curl 失败需检查文件路径与 uploadUrl 引号是否正确。任何文件类型均可接受，contentType 仅供浏览器参考。