TyrPay 卖家技能（Seller Skill）

当智能体需要在 TyrPay 支付流程中扮演卖家角色时，使用此技能。
该技能假设运行时已配置好 SellerAgent、可读取的结算合约，并具备访问 @tyrpay/seller-skill 工具集的权限。

快速开始

1. 安装 @tyrpay/seller-skill、@tyrpay/seller-sdk、一个存储适配器（storage adapter）以及一个 zkTLS 适配器。
2. 使用签名器（signer）、结算地址（settlement address）、链 ID（chain ID）、存储适配器和 zkTLS 适配器构造 SellerAgent。
3. 在你的工具调用运行时中注册 createSellerTools({ agent, contract, verifierSignerAddress })。
4. 在首次任务工作流执行前，调用 tyrpay_ready。
5. 若涉及 0G TeeTLS/TeeML 相关工作，请以目标模型为参数调用 tyrpay_discover_model_endpoint。
6. 当你从买家处接收到 taskId 时，使用 tyrpay_accept_task 接受该任务。

适用场景

• 该智能体负责以卖家身份接收并执行 TyrPay 任务。
• 该智能体必须为上游 API 调用生成基于 zkTLS 的证明（proofs）。
• 该智能体需要结构化、且可安全向终端用户展示的任务状态。
• 卖家工作流必须是非阻塞的，并在网络中断后具备可恢复能力。
• 当使用 0G TeeTLS 时，卖家仅能承诺由 0G TeeTLS 适配器/服务元数据解析出的实际端点（endpoint）与模型（model）。不得承诺通用上游端点或不同名称的模型。
• 当仅知晓模型名称时，应在承诺前调用 tyrpay_discover_model_endpoint，以查找一个可达的 TeeTLS/TeeML 端点。

工作流

1. 运行 tyrpay_ready，以验证签名器访问权限及存储适配器连通性。
2. 对于 0G TeeTLS/TeeML 场景，调用 tyrpay_discover_model_endpoint 并保留推荐的端点。
3. 当买家共享一个 taskId 时，使用你的执行条款调用 tyrpay_accept_task。
4. 等待买家为该任务注资（可通过轮询 tyrpay_check_settlement 实现）。
5. 注资完成后，对每一次必需的上游 API 调用，调用 tyrpay_execute_task。
6. 收集所有返回的收据（receipts），并使用完整收据集合调用 tyrpay_submit_proof。
7. 使用 tyrpay_check_settlement 监控验证是否已释放付款。

工具说明

• 所有工具均会以结构化的 SellerSkillToolError 错误拒绝格式错误的输入。
• tyrpay_accept_task 会读取链上任务信息，从中推导出买家地址与验证者地址（verifier address）。
• verifierSignerAddress 是注册表授权的验证者签名器（verifier signer），它被嵌入至 ExecutionCommitment.verifier 字段中；它既不是结算合约地址，也不是验证者注册表地址、服务 URL 或验证者服务合约地址。
• 可读取的结算合约必须暴露 getTask(bytes32) 方法，且其返回的 TyrPaySettlement.Task 结构字段顺序须严格匹配当前定义：
  taskId、taskNonce、buyer、seller、token、amount、deadlineMs、requiredMinUsage、requiredModelsHash、commitmentHash、commitmentURI、fundedAtMs、proofBundleHash、proofBundleURI、proofSubmittedAtMs、reportHash、settledAtMs、refundedAtMs、status。
• tyrpay_execute_task 需要传入由 tyrpay_accept_task 返回的 commitment 对象。
• tyrpay_submit_proof 需要传入所有由 tyrpay_execute_task 调用所收集的收据。
• 对于提供方（provider）为 "0g-teetls" 的情形：
  – commitment.target.host/path 必须与解析出的 0G 端点完全一致；
  – method 必须为 POST；
  – allowedModels 必须包含由 0G 服务元数据返回的模型；
  – 请将 tyrpay_discover_model_endpoint 所推荐的 providerOptions 原样透传至 tyrpay_execute_task。
• 面向卖家的状态包括：PAID（结算成功）与 NOT_PAID_REFUNDED（已退款且未支付）。

故障诊断

• 若任务存在、卖家地址匹配、买家已完成注资，但状态（status）或承诺（commitment）字段显示异常，请首先检查 getTask() 所使用的 ABI。过时的 ABI 或字段位置映射错误可能导致字段偏移，致使 seller-skill 从错误的存储槽位解析 commitmentHash、时间戳或 status。
• 切勿在真实多方协作流程中使用 MemoryStorageAdapter。它返回形如 memory:// 的 URI，仅同一 JavaScript 进程可读取；买家与验证者进程需依赖持久化、共享式存储，例如 0G、IPFS 或 HTTP。
• 承诺哈希（commitment hash）不匹配意味着完整的规范版 ExecutionCommitment 对象与最初提交的对象不一致。仅靠链上数据不足以重建该对象；请通过 commitmentURI 获取，或向创建者索要原始对象的确切版本。
• ReclaimZkTlsAdapter 依赖 @reclaimprotocol/zk-fetch、@reclaimprotocol/js-sdk、凭据（credentials）以及已下载的 zk 资源。请在构造该适配器的运行时中安装这些可选的 peer dependencies。
  Windows 运行时必须保持 Reclaim TEE 模式禁用状态。

相关资源

• references/tool-reference.md：含工具合约定义与状态模型说明。