This page covers how ratio corporate actions handle custodial contracts holding tokens for other owners. See Corporate actions for the create, preview, and confirm workflow.
Contracts that hold the token for their owners
Escrows (trading venue or custody gateway), token sales, XvP settlements, and airdrops hold units for their owners. Any ratio corporate action freezes and resizes them as Units a contract holds for its owners describes. The preview snapshot lists each contract under custodialSteps (contract, kind, index).
- Future record date required: Creating a ratio action with no record date or a past record date, or confirming after a new contract began holding the token, returns
409 CORPORATE_(ACTION_ CUSTODIAN_ FREEZE_ REQUIRED DALP-184677, not retryable). Abort if needed and recreate with a future record date. - Execution order: Confirm cancels resting venue orders, mints or burns each contract's units, then writes each custodial step (which lifts that contract's freeze in the same transaction). If a run stops between units and steps, contracts stay frozen until you confirm again.
- Abort rules: Abort lifts freezes only before any unit chunk or custodial step is sent. Once either begins, abort returns
CORPORATE_(ACTION_ RUN_ COMPLETED DALP-14072) and you must confirm again to complete the run. - Custody gateway zero-share rounding: A custody gateway withdrawal request rounded to zero shares ends as returned with reason
corporate-action(no receipts held or returned). Pending and claimable views reflect the new basis immediately.