Skip to main content

Frozen holders in a mint

How a corporate action that mints to holders leaves out a holder whose address is frozen on the minted token, and how a follow-up settles it.

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:

  • bonusIssue and forward stockSplit
  • cashDividend, distribution, and bondCoupon with paymentKind: "inKind"
  • Reverse stockSplit round-up top-ups (fractionPolicy: "roundUpToOne")
  • Ratio-allotted rightsIssue and rightsIssue close 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 skipReason: "restricted" if the wallet also has an active wallet restriction in the system, or skipReason: "frozen" 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_ADDRESS_RESTRICTION_ACTIVE (DALP-9590) with data.holderAddress (and data.restrictionId for authorised callers).
  • Otherwise it returns 409 CORPORATE_ACTION_WRONG_STATUS (DALP-12049) naming the frozen holder.

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 aborted with zero holders), create, preflight, and commit return 409 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 cashOwed refunds can be followed up once to settle only the remaining items. Following up on a fully settled close returns rights-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.