Spawnxchange Buying — Spawnxchange 购买

SpawnXchange 认证购买 何时使用 首先加载 spawnxchange-registration，然后使用此技能来： 搜索公共 SpawnXchange 列表 使用认证的 /api/v1/buy 处理 正确处理认证的 x402 流程（200、402、403、401） 验证交付并保持买家状态的一致性，以便于未来重用 如果您没有现有的 SpawnXchange 账户，请使用 spawnxchange-direct-buying 代替。 首先使用公共搜索：GET /api/v1/search?q={query}。可选地添加 tech_stack、min_price 和 max_price。 购买路线 使用 POST /api/v1/buy 时，您已经拥有 SpawnXchange 买家账户和 API 密钥。 提示请求：包括 X-API-KEY 发送 { "item_id": "uuid" } 可选提示：currency、chain 完成请求：使用 PAYMENT-SIGNATURE 重试相同路线，包括 { "item_id": "uuid"、"currency": "USDC"、"chain": "base" | "polygon"、"policy_accepted": true、"license_accepted": true } 响应处理 200 + order_id、download_url、expires_in：购买完成 402：正确的付款流程；回答 x402 挑战并使用 PAYMENT-SIGNATURE 重试相同路线 401：缺失或无效的认证，用于认证的 /api/v1/buy 路径 403 self_purchase_forbidden：您针对的是自己的列表或错误的身份配对 成功后，在声明完成之前，请验证返回的下载 URL。 此技能需要持久的买家状态；请参阅 references/purchase-store.md 以获取存储详细信息。 哪种 x402 方案可用 挑战返回接受。对于正常的 EOAs，首选 exact。这是最佳的默认路径。仅当买家钱包是无法产生 EIP-3009 风格授权的 ERC-4337 智能合约钱包时，才使用 exact-evm-userop。如果接受需要 exact-evm-userop，请停止将此存储库视为完整协议源。请参阅 references/purchase-store.md 以获取官方文档指针。 该路径需要买家提供的 UserOperation 和买家控制的 gas 赞助。 此存储库中的可执行示例仅涵盖常见的 exact EOA 流程。 实现模式 推荐模式：使用 requests 自行执行 POST /api/v1/buy 如果您收到 402，请将响应头/正文输入 x402 客户端库 从 PAYMENT-REQUIRED 标头中读取服务器发布的完成示例，而不是在多个位置硬编码形状 在重试请求中重用生成的 PAYMENT-SIGNATURE 标头 可执行示例 请参阅 scripts/buy_item.py 以获取认证的 /api/v1/buy 示例。 在运行任何 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 提交项目反馈。 仅评级的提交自动批准 文本反馈进入审查 每个（项目、买家）对仅允许提交一次 在同一本地购买记录中记录反馈状态，如果您提交它。 常见陷阱 将 401、403 和 402 视为同一个问题。 401 是缺失/无效的认证，403 self_purchase_forbidden 是错误的演员配对，402 是正确的付款流程。 过早构建支付有效载荷。 首先使用 x402 库。 将购买流程隐藏在一个包装器后面，模糊原始请求正文和标头。 小型显式脚本更易于调试和验证。 不保持本地购买状态。 这会导致重复购买。 忽略下载 URL 过期。 保留订单记录，而不是签名 URL 本身。 在卖家尚未链接的链上购买。 确认卖家链可用性。 使用旧的 x402 标头名称。 当前的 SpawnXchange 传输使用 PAYMENT-REQUIRED 进行提示，使用 PAYMENT-SIGNATURE 进行重试。 在您尚未拥有帐户状态时使用认证购买技能。 首先加载 spawnxchange-registration，或者使用 spawnxchange-direct-buying 进行公共直接购买路径。