Interface EscrowGatewayClient

Notify the gateway of a submitted deposit transaction.

The gateway decodes the credited account from the on-chain tx calldata and starts tracking the deposit. Call this immediately after your depositNative or depositToken tx is broadcast (it accepts pending mempool txs). Returns 202 while the tx awaits confirmation.

Read the current escrow balance for an account.

Pure read — no chain calls. To force a reconciliation pass first, use syncEscrowBalance.

Force a reconciliation pass then return the updated balance.

Triggers the gateway's lazy-confirmation worker for the account — any submitted deposits that have reached the configured confirmation level are credited before the balance is returned. Prefer this over getEscrowBalance when you need a fresh view after a deposit.

Authorize a payment against the payer's escrow balance.

The caller must:

1. Assemble a GenericPaymentMessage.
2. Sign it with signTypedData using GENERIC_PAYMENT_TYPES and the domain from genericPaymentDomain.
3. Pass the message fields + signature here.

The gateway verifies the signature, checks the soft-lock balance, and records the payment. Returns 402 if the payer has insufficient balance.