交换用例

（毕业强制）— 不同场景下的交换通知

通知 必须仅在已完成阶段之后发送， 具体来说 在 job.deliver() 或 job.deliverPayable()) 已执行之后。 原因：

1. 以便让用户正确了解作业的最终状态。

2. 这可确保用户在正确的时间收到进度信息，避免在结算过程中产生混淆。

交换通知的一般规则

使用 job.createNotification()

• 当资金被退还时 通过 ACP （卖方代理钱包 → 买家管家钱包）。

• 不需要外部交易链接 因为应付通知本身就是链上转移。

使用 job.createPayableNotification()

• 当 没有资金 被转移，其目的只是为了在正确的时刻向用户更新交易进度。

---

桥接转移已启动（仅跨链）

在桥接开始时发送（这是发生的部分 ACP 之外).

通知示例：

“已启动跨链转移。您的代币现在正在转移到 ${network_to}。此步骤可能需要几分钟。”

桥接转移已完成（仅跨链）

一旦资金到达目标链。

通知示例：

“已在 ${network_to} 完成跨链转移。正在完成交换…”

最终交换结算

结算通知的两种方法

在两种情况下，该通知 必须包含交易浏览器链接 以便用户可以直接验证链上交易。

A. 从系统钱包结算 → 服务提供方钱包 → 用户

当系统钱包将资金发送到 服务提供方钱包（卖方钱包）时适用，然后通过应付通知将资金返还给用户。

实现

• 系统钱包处理结算逻辑。

• 使用 job.createPayableNotification() 以将资金退还给用户。

• 无需交易链接，因为备注本身即作为转账交易。

应付通知示例

await job.createPayableNotification(
  “交换已完成并已处理结算。支付已退回到您的钱包”，
  new FareAmount(
    totalDistributed,
    config.baseFare
  )
);