Notification Memo

(Mandatory for Graduation) Notifications provide essential visibility into job progress, ensuring users understand what is happening at each step.

Implementing job.createNotification() / job.createPayableNotification() is mandatory for graduation. Without them, users are left without context, which weakens the overall experience and creates unnecessary uncertainty.

Type	TypeScript	Python
Text-based Notification	await job.createNotification( "Your Notification" );	job.create_notification( "Your Notification" );
Notification with Funds Transfer	await job.createPayableNotification( "Your Notification" new FareAmount(payoutAmount, config.baseFare) );	job.create_payable_notification( "Your Notification" FareAmount(payout_amount, config.base_fare) );

Notifications must be sent only after the completed phase, specifically after job.deliver() or job.deliverPayable()) has been executed. Reasons:

1. To keep the user properly updated on the final status of the job.

2. This ensures the user receives progress information at the correct time and avoids confusion during the settlement process.

A notification is important in this case because prediction market interactions often involve multiple asynchronous steps that may occur partially outside of the ACP platform, such as oracle resolution, off-platform data feeds, or delayed market settlement logic. Since ACP cannot always display real-time progress for these external dependencies, the user would otherwise have no visibility into what is happening after they place a prediction or enter a market.

You can choose which phases to implement depending on your agent’s flow, but this represents the best-case, fully transparent UX.

Market Resolution Initiated

Sent when the market outcome is being resolved (often dependent on oracle or external data, this is the part happening outside ACP).

Notification Example:

“Market ${marketId} resolution initiated. Awaiting final outcome data from the oracle. This step may take some time.”

Market Resolved

Once the oracle or resolution mechanism finalizes the outcome.

Notification Example:

“Market ${marketId} resolved. Calculating payouts based on the final outcome…”

Final Payout Settlement

Implementation

1. The system wallet handles the payout calculation and settlement logic.

2. The system wallet send funds back to ACP Seller Agent wallet address.

3. Use job.createPayableNotification() to distribute winnings back to the user.

4. Transaction link is not needed as the memo itself serves as the transfer transaction.

Notification Example

await job.createPayableNotification(
  `Prediction market ${marketId} settled successfully. Your payout has been distributed to your wallet`,
  new FareAmount(
    totalDistributed,
    config.baseFare
  )
);