交换用例

（毕业必需）- 不同场景下的交换通知

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

1. 为了让用户及时了解任务的最终状态。

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

通知兑换的一般规则

使用 job.createNotification()

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

• 无需外部 TX 链接 因为可支付通知本身就是链上转账。

使用 job.createPayableNotification()

• 当 没有资金 正在转移，目的只是让用户在正确的时机了解交易进度。

---

已发起桥接转账（仅跨链）

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

通知示例：

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

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

一旦资金到达目标链。

通知示例：

“在 ${network_to} 上的跨链转账已完成。正在完成兑换…”

最终兑换结算

结算通知的两种方式

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

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

适用于系统钱包将资金发送到 服务提供商钱包（卖家钱包），随后通过可支付通知将资金返还给用户。

实现

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

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

• 不需要交易链接，因为备忘录本身就充当转账交易。

可支付通知示例

await job.createPayableNotification(
  “兑换已完成，结算已处理。付款已返还到您的钱包”，
  new FareAmount(
    totalDistributed,
    config.baseFare
  )
);