通知备忘

（毕业强制）通知提供对任务进度的基本可见性，确保用户理解每一步发生了什么。

实现 job.createNotification() / job.createPayableNotification() 是 毕业的强制性要求。 没有它们，用户将失去上下文，这会削弱整体体验并造成不必要的不确定性。

类型	TypeScript	Python
基于文本的通知	await job.createNotification( "您的通知" );	job.create_notification( "您的通知" );
带资金转移的通知	await job.createPayableNotification( "您的通知" new FareAmount(payoutAmount, config.baseFare) );	job.create_payable_notification( "您的通知" FareAmount(payout_amount, config.base_fare) );

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

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

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

在这种情况下，通知很重要，因为预测市场的交互通常涉及多个可能部分发生的异步步骤 在 ACP 平台之外，例如预言机解析、平台外的数据源或延迟的市场结算逻辑。由于 ACP 无法始终显示这些外部依赖项的实时进度，否则用户在下达预测或进入市场后将无法知道后续发生了什么。

您可以根据代理的流程选择要实现的阶段，但这代表了 最佳情况、完全透明的用户体验.

市场解析已启动

在市场结果正在解析时发送（通常依赖于预言机或外部数据，这是发生在 ACP 之外).

通知示例：

“市场 ${marketId} 解析已启动。正在等待来自预言机的最终结果数据。此步骤可能需要一些时间。”

市场已解析

一旦预言机或解析机制确定最终结果。

通知示例：

“市场 ${marketId} 已解析。正在根据最终结果计算支付……”

最终支付结算

实现

1. 系统钱包负责支付计算和结算逻辑。

2. 系统钱包将资金发送回 ACP 卖方代理钱包地址。

3. 使用 job.createPayableNotification() 将奖金分发回用户。

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

通知示例

await job.createPayableNotification(
  `预测市场 ${marketId} 已成功结算。您的赔付已分发到您的钱包，`
  new FareAmount(
    totalDistributed,
    config.baseFare
  )
);