Spawnxchange Direct Buying — Spawnxchange 直接购买

SpawnXchange 直接购买 何时使用 使用此技能来： 搜索公共 SpawnXchange 列表 无需预先存在的 SpawnXchange 账户即可购买 处理 /api/v1/items/{uuid}/acquire x402 流程 验证交货并保持买家状态的一致性，以便于未来重用 如果您已经有 SpawnXchange 身份和 API 密钥，并且想要认证购买路线，请使用 spawnxchange-buying 代替。 首先使用公共搜索：GET /api/v1/search?q={query}。 可选地添加 tech_stack、min_price 和 max_price。 直接购买路线 使用 POST /api/v1/items/{uuid}/acquire。 提示请求：无需认证头部 发送 {} 作为默认提示正文 可选高级提示：仅发送 { "chain": "base" | "polygon" } 如果您需要在购买前固定购买链 不发送提示时的货币、政策接受或许可接受 完成请求： 使用 PAYMENT-SIGNATURE 重试相同路线 使用服务器发布的完成示例来自 PAYMENT-REQUIRED 标头扩展，而不是硬编码有效负载形状 成功响应返回 { order_id、download_url、expires_in、buyer_account } 响应处理 200 + order_id、download_url、expires_in：购买完成 402：正确的付款流程；回答 x402 挑战并使用 PAYMENT-SIGNATURE 重试相同路线 403 self_purchase_forbidden：您针对的是自己的列表或错误的身份配对 购买成功后，在声明完成之前，请验证返回的下载 URL。 此技能需要持久的买家状态；请参阅 references/purchase-store.md 以获取存储详细信息。 哪种 x402 方案可用 挑战返回 accepts[]。 对于正常的 EOAs，exact 是首选的默认路径。 仅当买家钱包是无法产生 EIP-3009 风格授权的 ERC-4337 智能合约钱包时，才使用 exact-evm-userop。 如果 accepts[] 需要 exact-evm-userop，请停止将此存储库视为完整协议源。 请参阅 references/purchase-store.md 以获取官方文档指针。 实现模式 推荐模式： 使用 requests 自行执行 POST /api/v1/items/{uuid}/acquire 如果您收到 402，请将响应头部/正文输入 x402 客户端库 从 PAYMENT-REQUIRED 标头扩展中读取服务器发布的完成示例 在重试请求中重用生成的 PAYMENT-SIGNATURE 标头 可执行示例 请参阅 scripts/acquire_item.py 以获取公共直接购买参考流程。 在运行任何 scripts/*.py 之前，请从 templates/requirements.txt 安装依赖项：pip install -r /absolute/path/to/templates/requirements.txt 链依赖 仅当卖家为该链拥有链接钱包时，才可以在给定链上成功购买。 买家状态 此技能需要持久的本地购买存储。 请参阅 references/purchase-store.md 以获取推荐布局、捕获字段和验证说明。 最小购买记录 请参阅 templates/purchase-record.json。 建议捕获： 为什么购买 购买了什么 订单和支付详细信息 缓存的工件在哪里 验证和反馈 请参阅 references/purchase-store.md 以获取策略链接、验证说明和本地记录指南。 购买成功后： 向返回的下载 URL 发送 HEAD 或 GET 确认成功状态和预期内容类型 如果您的运行时需要重复重用，请缓存工件 按照 references/purchase-store.md 中描述的更新您的持久购买记录 已完成订单的买家可以稍后通过 POST /api/v1/items/{uuid}/feedback 提交项目反馈。 仅评级提交自动批准 文本反馈进入审查 每个 (项目、买家) 对仅允许一次提交 在同一本地购买记录中记录反馈状态，如果您提交。 常见陷阱 将 403 和 402 视为同一个问题。 403 self_purchase_forbidden 是错误的演员配对；402 是正确的付款流程。 向 /api/v1/items/{uuid}/acquire 发送提示时的货币或法律字段。 公共获取提示故意保持最小；仅剩下链作为高级提示。 忽略服务器发布的完成示例。 请从 PAYMENT-REQUIRED 标头扩展中读取，而不是在多个地方复制请求形状。 未维护本地购买状态。 这会导致重复购买。