This page covers how corporate-action mints handle holders whose address is frozen on the minted token. See Restricted holders for burn handling.
How mints skip frozen addresses
Token contracts revert any mint to a frozen address, which would fail the entire batch. At confirm (after elections and before queueing transactions), the platform therefore checks which remaining mint recipients have a full address freeze on the minted token.
This check applies to:
bonusIssueand forwardstockSplitcashDividend,distribution, andbondCouponwithpaymentKind: "in Kind" - Reverse
stockSplitround-up top-ups (fraction)Policy: "round Up To One" - Ratio-allotted
rightsIssueandrightsIssueclose share mints
Partial balance freezes do not trigger this check, and preview, quote, and approved plans still show the holder as remaining.
During execution, each frozen holder is skipped so all other holders mint normally. Skipped entries read state: "skipped" with skip if the wallet also has an active wallet restriction in the system, or skip otherwise. Restricted holders whose address is not frozen on the minted token mint normally. Burns and cash payouts are unaffected.
If every recipient is skipped and no holder remains, confirm and commit send nothing and keep the record's status:
- When any skipped holder is restricted, the route returns
409 TOKEN_(DALP-9590) withADDRESS_ RESTRICTION_ ACTIVE data.holderAddress(anddata.restrictionIdfor authorised callers). - Otherwise it returns
409 CORPORATE_(DALP-12049) naming the frozen holder.ACTION_ WRONG_ STATUS
spinOff and tradable rightsIssue mint onto a separate token and cannot be followed up. If any recipient is frozen on that new token, confirm refuses the entire action before queueing anything, using the same two 409 codes. Unfreeze the holder on the new token and confirm again.
After lifting restrictions or unfreezing addresses, raise a follow-up with the same terms (Continuing a partial run).
Follow-ups
A follow-up names the earlier action in followsUpOn and mints once to left-out holders using the original terms. Preview treats holders skipped with skipReason restricted or frozen as unsettled, and already applied or election-skipped holders as settled.
- One follow-up at a time: While another follow-up exists (unless it ended
abortedwith zero holders), create, preflight, and commit return409 CORPORATE_(ACTION_ FOLLOW_ UP_ UNKNOWN DALP-12069). Follow-ups must match the original action type (a rights close only follows up on the same rights issue's close). - Stock split: Must repeat direction, ratio,
fractionPolicy, and cash-in-lieu terms, and never adjusts the share reference price a second time once an earlier run in the chain updated it. - Rights close: A completed close with skipped share mints, unburned lapsed rights, or unpaid
cashOwedrefunds can be followed up once to settle only the remaining items. Following up on a fully settled close returnsrights-close-not-ready. - Console: Select Continue this action on a completed run with skipped holders (including in-kind payouts and rights closes) to raise the follow-up.