用途：opensea-tool-sdk 面向工具提供方与调用方，用于脚手架化 AI 可调用的工具端点（HTTPS、JSON Schema、.well-known 清单），在 Base 的 ToolRegistry 上链注册以便其他智能体发现，并通过 x402 按次付费（USDC）或谓词（ERC-721/ERC-1155 持有、订阅、trait 门控、ERC-20 余额及组合）门控访问；也可调用受门控或付费的工具（paidFetch、eip3009AuthenticatedFetch、paidAuthenticatedFetch），并通过 OpenSea REST API 搜索发现已注册工具。
主要能力：CLI 支持 init、validate、hash、export、register、update-metadata、inspect、verify、deploy、auth、pay、smoke、dry-run-gate、dry-run-predicate-gate，以及 collections、subscription、trait、erc20 门控配置命令。SDK 提供 defineManifest、createToolHandler、toVercelHandler、toExpressHandler、ToolRegistryClient、computeManifestHash、createWalletFromEnv 等。
关键约束：一个工具对应一个端点（如 POST /api/price-check），不能是通用页面；清单与端点必须同源（scheme/host/port 完全一致，子域不算同源），注册时强制执行。清单按 JCS keccak256 哈希（ERC-8257 §2），扩展字段须反向域名或 x- 前缀命名空间。
使用方式：npx @opensea/tool-sdk init --runtime vercel（或 cloudflare、express）生成项目；定义 manifest 与 handler，接入适配器；再以 npx @opensea/tool-sdk register --metadata <URL> --network base 注册，可用 --access-predicate 指定门控。调用付费/门控工具用 CLI 的 pay（含 --max-amount 上限）或 auth。工具发现需 OPENSEA_API_KEY，可用 GET /api/v2/tools、/tools/search、/tools/{chain}/{addr}/{id} 查询。
响应码：200 成功、400 输入错误、401 签名无效、402 需付款/身份、403 拒绝、405 方法不符、500 工具错误、502 上游错误。
限制：官网未提供价格与完整支持链外的部署细节；已部署合约为 ToolRegistry v0.2 等地址；钱包支持 PRIVATE_KEY、Privy、Turnkey、Fireblocks、Bankr，隐私与安全配置需按官方指引执行。部分功能标注 Beta，且 SDK 会向 OpenSea 分析端点上报成功调用的已验证调用者。