定时发布、取消与恢复
预约通过现有 estimate/quote/submit 流程实现。先检查 broadcaster_getStatus.scheduling.enabled;没有能力时明确提示不支持,不降级为即时发送。服务能力取决于实际部署。
发现限制并签入时间
status 的 scheduling 返回 enabled,以及十进制字符串 maxDelaySeconds、defaultExecutionWindowSeconds、maxExecutionWindowSeconds、minDeadlineSlackSeconds。默认值分别为 604800、300、3600、120 秒;运营者可更改,应以服务返回的能力为准,不在客户端硬编码七天上限。
| schedule 字段 | 线格式 | 含义 |
|---|---|---|
publishAfter | Unix 秒十进制字符串 | 最早开始广播时间 |
executeBefore | Unix 秒十进制字符串 | 开始广播窗口的排他结束时间 |
cancelTokenHash | 非零小写 0x bytes32 | 本地随机取消凭证的 Keccak256 |
将 schedule 同时传给 estimateQuote 和 getQuote。返回的 quote.schedule 使用独立 ScheduledQuote EIP-712 类型签名;提交仅从 quote 读取时间,不接受额外未签名 schedule。删除预约字段或修改时间会使签名失效。
以下是结构示意,不能直接发送;data、哈希和时间必须由匹配 SDK 及实际业务生成。使用匹配 SDK 构造完整请求,再由应用的用户确认流程发起报价与提交。
params: [{
data: SDK-generated canonical calldata,
schedule: {
publishAfter: future Unix seconds as a decimal string,
executeBefore: exclusive window end as a decimal string,
cancelTokenHash: Keccak256 of locally saved random 32-byte token
}
}]
报价接单有效期最多五分钟,并受价格与意图期限约束。已经接受的预约不因接单报价后来过期而取消,也不会延长链上授权。intent、实际资金授权和 Permit 必须覆盖 executeBefore 加上 advertised slack。
执行窗口不是上链保证
服务在 publishAfter 之前不执行发送,也不把未到期成员加入到期聚合。到期后重新核对余额、allowance、输入、根、模拟和所需 Provenance。暂时故障可在窗口内重试,拒绝不能当成允许,错过窗口产生 expired。
窗口约束开始广播,不保证区块打包时间。已取得发送权或已经广播的工作继续回执与最终性核对。预约过程中不允许擅自增加费用或修改收款方来促成发送。
取消凭证与竞态
SDK 本地生成并保存随机 32 字节 cancelToken,报价只携带其 Keccak256。提交前保存取消凭证、预约条款、服务作用域和完整冻结 body;取得响应后再保存服务返回的 durable id。
远程取消调用 broadcaster_cancelTransaction,params 为 [{id,cancelToken}]。取消凭证是授权秘密,不放入日志、公共状态或分析事件;仅持有 id 不能取消任务。
| 当前状态 | 能否取消 |
|---|---|
scheduled / preparing | 可以,前提是取消先于持久发送预留 |
queued / proving | 仅显式预约且未获得发送权、未分配冻结批次的任务 |
pending / submitted / uncertain | 不可取消,即使暂时没有交易哈希 |
cancelled | 同一正确凭证重复取消幂等 |
expired / rejected / confirmed / reverted | 不能重新取消或复活 |
取消与获得发送权竞争同一持久状态转换。只有取消已持久化才能向用户显示成功;较早的模拟或证明结果随后不能发送。取消成功只约束这个 Broadcaster,不撤销 Protocol 签名,也不能阻止其他持有者发送原交易。
恢复与错误
丢失 submit 响应且 id 未知时原样重放提交材料,取回服务 id,再查询或取消。单独 cancelToken 不够,不能根据本地哈希推算任务 ID。尚未提交的本地准备操作没有远程任务。
| 错误 | 处理 |
|---|---|
-32602 | 修正 malformed 参数 |
-32020 | 未知任务或凭证无效;服务故意不区分 |
-32021 | 太晚;继续观察原任务 |
-32022 | 无法确认取消持久化;保留输入并查询或重试 |
-32023 | 同一语义提交的预约条款冲突;恢复原任务 |
取消响应丢失或不确定时保持钱包预留。确认取消后还需核对规范链消费状态,再释放本地输入。重复提交不会重新激活 cancelled/expired 任务。钱包本地 operation ID、JSON-RPC id、Broadcaster durable id 具有不同用途,必须分别存储。