Skip to main content

Record and run a corporate action

Choose the event, enter its terms and record it, then review the allocation for each holder, run it, and check what the tab shows afterwards.
Open it fromAssetsAll assetsCorporate actionsRoles:Supply managementGovernanceConsole address: /token/assetClassSlug/templateSlug/tokenAddress/corporate-actions

Use this workflow to record terms, review per-holder allocations, and run a corporate action from an asset's Actions menu or Corporate actions tab. Check feature requirements, role gates, and custody freeze rules on Corporate actions before starting.

The Actions menu lists the Corporate actions group first, then the asset's other controls, and the group opens a submenu of the events the asset can run.

Steps

Choose the event

  1. Open Assets, then All assets, select the asset, and open Actions, then Corporate actions (or select Start on a row under Start a corporate action on the Corporate actions tab).
  2. Choose the event type. Program links (Bond coupon, Maturity redemption, Conversion) complete immediately on one PIN and link to their feature tabs. Declarations (Cash dividend, Distribution, Coordinated distribution) follow Cash dividend and distribution and Coordinated distribution.

Enter terms and record the event

  1. On Terms, enter the approved ratios, holder allocations, optional record date, optional cash payout, or optional holder election (Let holders choose before a deadline). Nothing is stored yet, and leaving discards the draft.
  2. Select Review holders (or Review N holders on holder-book events) to compute per-holder allocations without signing.
  3. On Review, compare the summary strip, holder table (exportable as CSV), and any Rights issue close or Excess applications card against your approval. Tick any required risk acknowledgements.
  4. Select the main action button (for example Split shares, Burn shares, Issue bonus shares, or Send for approval when a second signature is required) and confirm with wallet verification.
  5. If approval or a holder election applies, wait for the decision or election deadline, reopen the run from In flight, re-tick acknowledgements, and confirm with your PIN to execute.
  6. Keep the record page open through Progress until status reaches a terminal state (“Settled”, “Cancelled”, or “Releasing custody”), then verify results in History and Holders.

Review, then run it

On Review, the summary strip shows Holders receiving (or Holders giving up shares on burn-only runs), supply before and after, Snapshot (“Live register” or UTC record date), Recorded share price (on splits with a price feed), Gets nothing (holders rounding to zero), and Approval (“Needs a second person” when required).

  • The holder table lists positive-allocation holders (25 per page) with Before, After, Change, and Export. Rows tagged “rounded down” or “left out” carry a Why menu item explaining the outcome.
  • If balances change while Review is open, DALP blocks execution, refreshes the figures with “Holdings changed since you opened this review. Check the new figures.”, clears ticked acknowledgements, and waits for a fresh confirmation.
  • If balances move after a stored preview (“The holder book moved after the preview”), cancel before execution and start a new action, or select Stop execution if batches already landed and continue with a follow-up run.
  • While a holder election is open, the record displays “Holders can choose until” with a disabled Review after button, and locks Preview again once any holder chooses or the deadline passes. After close, Review shows an Option column and outcome totals before execution.

The page is titled Bonus issue · Capped Tech Shares, with the Terms, Review and Progress steps.

Terms by event family

Ratio events (bonus issue, stock split, reverse split, rights issue, spin-off, in-kind payouts)

Enter a whole-number ratio (or switch Enter the ratio as to Percentage, up to four decimals, stored internally as an exact ratio) and an optional record date (required in the future when custodial contracts hold the token).

Event
Extra fields and rules
Stock split / Reverse split
Split direction must match the ratio (more new shares for Split, fewer for Reverse split, with 1:1 / 100% refused). Reverse splits also set Fractions (Round down, Whole shares, or At least one share) and optional Pay cash for fractions (denomination asset and Price per token paid by the active smart-wallet treasury).
Rights issue
Pick Rights issue action: Mint rights now, Through an existing sale (whitelists holders onto an existing sale without minting), Tradable rights token (requires an empty organisation token with Hold, matching decimals, Supply management, and a qualifying Subscription payee), or Close a rights issue (burns lapsed rights, issues shares, and settles any Excess applications pro rata from lapsed rights with cash refunds).
Spin-off
Requires an empty candidate child token carrying share or unit capital, not part of another multi-class instrument, on which you hold Supply management.
In-kind payouts
Stock dividend, Bond coupon paid in tokens, and Distribution paid in tokens mint a floored ratio of new units to each holder and use the in-flight slot.

A Tradable rights token issue also requires a Subscription payee: the organisation account that receives subscription payments and exercised rights. The field lists qualifying organisation accounts on the token's network, such as its Smart Wallet or an organisation-owned treasury multisig, and accepts a pasted address. The declaring wallet is omitted, and a member's own wallet or person-owned multisig is refused on record. When approval is on, the second approver approves the payee with the plan.

Holder-book events (capital decrease, partial redemption, buyback)

These events burn units directly from selected holders without holder signatures. Use the holder-book editor to select rows, prefill pro rata from Total to burn, edit or exclude rows, or round-trip via CSV export/import until allocations balance to the declared total. Amount and price fields accept k, m, and b suffixes (for example 1.5k = 1,500).

  • All-holders buyback: Switch Who to All holders to call every holder at one cash price. On assets with dividend yield, Governance holders can use Compute call price and Use this price to calculate target-return pricing net of paid dividends.
  • Cash payment on partial redemption: Select Add a cash payment, pick a Denomination asset, and enter Price per token (paid from the active smart-wallet treasury).

Holder elections

On supported supply changes and in-kind payouts, switch on Let holders choose before a deadline, set Holders can choose until (UTC), and configure at least two options (exactly one marked “Gets the allocation” and one marked Default). Holders submit or update choices on their holding page with Save choice until the deadline. Cash-paying buybacks, cash partial redemptions, reverse splits paying cash for fractions, sale-based rights issues, and rights-issue closes cannot carry elections.

Restricted wallets, frozen holders, and continuing partial runs

Holders under a wallet restriction or address freeze are evaluated at confirmation, so Review still lists them beforehand.

Action kind
Behaviour for restricted or frozen holders
How to finish later
Minting events (bonus, forward split, in-kind payout, rights allotment, rights-close shares, reverse-split top-ups)
Skips holders frozen on the minted token (“Restricted wallet: left out” or “Frozen wallet: left out”). Refuses if every holder is skipped. Spin-offs and tradable rights issues cannot be continued and refuse confirm if any holder is frozen.
Lift the freeze/restriction, then select Continue this action on the completed record.
Buyback / Partial redemption
Leaves restricted holders out without burning or paying cash (DALP-9590 if all holders are restricted). Paying treasury must still cover the full plan.
Lift the restriction, then select Continue this action.
Reverse split, Capital decrease, Rights-issue close (lapsed-rights burn)
On DALP 3.2 token contracts, burns restricted holders in place only when run from a smart wallet holding both Supply management and Custodian (withholding any fractional cash as “Restricted wallet: cash withheld”). Otherwise leaves them out (“Restricted wallet: left out”). Excess-application refunds to frozen wallets stay “Frozen wallet: refund withheld”.
Lift the freeze/restriction, then select Continue this action to pay withheld cash/refunds or settle remaining holders.

Continue this action appears on stopped runs with remaining holders and on completed runs with skipped holders or withheld cash/refunds (prefilling terms and showing “N holders left; M already applied” on Review). It is unavailable once already continued (“This run was already continued.”), while another run is in flight, or on spin-offs.

The event type picks the path: supply changes review then run on one PIN, declarations record then preview, program links complete on record.Choosing an event starts one of three paths. A supply change or a payment in tokens opens Terms, then Review, which reads the holders and stores nothing. One PIN on the main button creates the record and runs it, or sends it for approval first. Cancel closes the sheet before the PIN, and stopping a run cannot reverse applied changes. A cash dividend, a distribution paid in cash, and a coordinated distribution are recorded first, then previewed and confirmed. Recording a cash dividend or distribution already creates its on-chain obligation. Bond coupon, maturity redemption, and conversion records complete on record. Holders use their existing programs. Reopen an unfinished record from the In flight card.The event type picks the path: supply changes review then run on one PIN, declarations record then preview, program links complete on record.Choosing an event starts one of three paths. A supply change or a payment in tokens opens Terms, then Review, which reads the holders and stores nothing. One PIN on the main button creates the record and runs it, or sends it for approval first. Cancel closes the sheet before the PIN, and stopping a run cannot reverse applied changes. A cash dividend, a distribution paid in cash, and a coordinated distribution are recorded first, then previewed and confirmed. Recording a cash dividend or distribution already creates its on-chain obligation. Bond coupon, maturity redemption, and conversion records complete on record. Holders use their existing programs. Reopen an unfinished record from the In flight card.

The chosen event takes one of three paths: review then one PIN, record then preview and confirm, or a single record that completes it.

Troubleshooting

Review fails to load holders

Signal: Review displays an error reference and “The platform refused this review. The message above says what to change.” Cause: Invalid terms (such as an un-rebasable share price or missing balance history for a past record date) or a transient read error. Fix: Select Retry if offered, or select Change terms to adjust the inputs before retrying.

The ratio is refused on a stock split or reverse split

Signal: New shares rejects the ratio and keeps Review closed. Cause: A forward split requires more new shares than old (above 100%), a reverse split requires fewer (below 100%), and 1:1 / 100% is refused in both directions. Fix: Correct the ratio or switch Split direction.

A candidate token is disabled in Rights issue or Spin-off

Signal: A token cannot be selected in Rights token or the spin-off child selector. Cause: The candidate already has supply, uses wrong decimals or capital type, lacks the Hold feature (rights token), belongs to another multi-class instrument, or lacks your Supply management role. Fix: Read the inline reason on the disabled candidate, issue a clean token first, or grant Supply management.

Other corporate action errors

Signal: Snapshot drift, partial batch stops, frozen balances, or treasury shortfalls. Cause: Operational state changed or prerequisites were unmet. Fix: See the full list under Corporate actions troubleshooting.

Was this page helpful?