跳到主要内容

定时发布、取消与恢复

预约通过现有 estimate/quote/submit 流程实现。先检查 broadcaster_getStatus.scheduling.enabled;没有能力时明确提示不支持,不降级为即时发送。服务能力取决于实际部署。

发现限制并签入时间​

status 的 scheduling 返回 enabled,以及十进制字符串 maxDelaySeconds、defaultExecutionWindowSeconds、maxExecutionWindowSeconds、minDeadlineSlackSeconds。默认值分别为 604800、300、3600、120 秒;运营者可更改,应以服务返回的能力为准,不在客户端硬编码七天上限。

schedule 字段线格式含义
publishAfterUnix 秒十进制字符串最早开始广播时间
executeBeforeUnix 秒十进制字符串开始广播窗口的排他结束时间
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 具有不同用途,必须分别存储。