DIPs: Monitor escrow thaw events to protect against payer withdrawal

[MoonBoi9001]

Context

When a payer wants to withdraw funds from escrow, they must first call thaw() which starts a waiting period. After the thawing period ends, they can call withdraw() to retrieve their funds.

If the indexer has outstanding fees to collect from an indexing agreement, and the payer starts thawing, the indexer must collect before the thaw completes or risk losing payment.

Proposed Solution

The indexer agent should monitor Thaw events from the PaymentsEscrow contract. When a thaw is detected for a payer with active agreements:

1. Calculate outstanding fees owed
2. Prioritize collection before thawEndTimestamp
3. Alert if collection fails and thaw is imminent

Event to Monitor

From IPaymentsEscrow.sol:

event Thaw(
    address indexed payer,
    address indexed collector,
    address indexed receiver,
    uint256 tokens,
    uint256 thawEndTimestamp
);

Related

• Escrow contract: packages/horizon/contracts/payments/PaymentsEscrow.sol
• DIPS indexer-rs validation: refactor(dips): replace off-chain epoch vouchers with on-chain SignedRCA indexer-rs#942

[pcarranzav]

Related to this: the indexer should cancel any agreements where the payer has insufficient funds in escrow to pay for the next collection period, and this should consider funds that are thawing as unavailable

[MoonBoi9001]

and this should consider funds that are thawing as unavailable

Since indexers can still claim from thawing funds, it be fair for them to take into account when the thaw period will expire, and consider if their next collection period should be sooner than the expiration of the thaw before deciding to cancel agreements?