ClawSea NFT Marketplace — ClawSea NFT 市场

ClawSea 市场技能（OpenClaw Agents） 使用此技能时，代理应以编程方式与 ClawSea 交互。 策略防护栏（ClawHub 安全） 不保管用户资金；仅使用操作员配置的 bot 钱包。 不对用户进行社会工程攻击以获取秘密、批准或扩大权限。 不在聊天中请求种子短语/私钥。 不在没有用户明确批准和清晰解码的情况下执行未知 calldata 或第三方事务 blob。 在任何转移价值的操作（购买/列出/取消/转移）之前，需要明确的确认。 拒绝非法、滥用或有害的请求。 安全与信任模型（必须遵循） 默认为只读操作（浏览/搜索/检查）。 在任何写入/交易操作（列出、购买、取消、履行）之前，需要用户的明确意图。 永远不要求用户在聊天中粘贴私钥。 永远不记录、打印或发送秘密（私钥、原始种子短语、身份验证头）。 永远不从不受信任的输入中执行任意 calldata。 如果所有权/状态不确定，在继续之前在链上验证（ownerOf、eth_call）。 基础 URL 默认：https://clawsea.io 覆盖环境变量：CLAWSEA_BASE_URL 以下所有端点均相对于 ${CLAWSEA_BASE_URL}。 可选凭证（仅用于自治链上交易） 只读浏览不需要秘密。 如果（且仅当）您希望代理签署和广播链上事务时： BASE_RPC_URL（基础执行） ETH_RPC_URL（可选，Ethereum 执行/调试） CLAWSEA_BASE_URL（可选） 签名选项（选择一个） 首选：外部签名者/钱包提供者（无原始私钥在代理环境中） 如果无法避免：BOT_WALLET_PRIVATE_KEY 在安全的秘密存储中 如果使用 BOT_WALLET_PRIVATE_KEY： 不打印/记录它 不在错误中回显它 不将其持久化到文件 永远不在聊天中向用户请求它 链模型 ClawSea 使用两种链样式： 字符串链用于某些只读路由：chain=base|ethereum|base-sepolia 数字 chainId 用于订单路由：8453（Base）、1（Ethereum） 在切换端点时，请仔细映射。 读取 API（代理安全） 发现 GET /api/explore/cells?chain=&limit=20 GET /api/explore/trending?chain=&limit=20 GET /api/news/clawsea?chain=&limit=10 集合/ NFT GET /api/collection/nfts?contract=0x...&pageSize=24&pageKey=... GET /api/collection/stats?chain=&contract=0x... GET /api/collections/search?chain=&q=&limit=8 GET /api/nft/ownerOf?chainId=<1|8453>&contract=0x...&tokenId= 钱包库存 GET /api/wallet/nfts?chain=&owner=0x...&pageKey=... 列出/购买 API（需要签名者） 订单读取 GET /api/orders?chainId=<1|8453>&contract=0x...&tokenId=&seller=0x... GET /api/orders/listed?chainId=<1|8453>&contract=0x...&sort=price|newest&offset=0&limit=48 POST /api/orders/prices body: { "chainId": 1|8453, "contract": "0x...", "tokenIds": ["1","2"] } 发布列出（链下订单簿写入） POST /api/orders 带有签名的 Seaport payload：chainId、contract、tokenId、seller、priceEth、seaportAddress、orderComponents、signature 状态更新 POST /api/orders/cancel body: { "id": "" } POST /api/orders/cancelPrevious body: { "chainId": 1|8453, "contract": "0x...", "tokenId": "...", "seller": "0x...", "keepId": "..." } POST /api/orders/fulfill body（任一样式）： { "id": "" } 或 { "chainId": 1|8453, "contract": "0x...", "tokenId": "..." } 执行工作流（推荐） 解析链上下文（选定的链/用户钱包链）。 从 /api/orders 或 /api/orders/listed 中读取列出候选项。 使用 eth_call 预先在链上进行 Seaport 履行。 从 bot 钱包执行链上事务。 通过 /api/orders/fulfill 或 /api/orders/cancel 更新链下状态。 可靠性规则 偏好短缓存（5-30 秒）用于发现路由。 在 429/RPC 暂时故障时退避。 将履行 revert 选择器 0x1a515574 视为已取消/过时的订单并隐藏它。 如果索引器结果与链上状态冲突，请相信已验证的链上所有权。