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
- 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).
- 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
- 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.
- Select Review holders (or Review N holders on holder-book events) to compute per-holder allocations without signing.
- 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.
- 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.
- 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.
- 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).
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.
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 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.