Corporate Actions

Overview

The Corporate Actions module mirrors all real-world stock events on-chain. Users’ token balances are always consistent with the latest corporate changes.

Supported Actions

Action	Description
Stock Split	1:2, 1:3 ratio adjustments with auto compensation
Reverse Split	2:1, 3:1 consolidations with fractional payouts
Dividend	Automatic distribution with tax and fee deduction
Ticker Change	Updates ticker and factory mapping
Delisting	Retires token and distributes compensation

User Flow

1. Operator triggers action (e.g., triggerDividend()).

2. User calls processCorporateActions() to apply changes.

3. Transfers remain paused until all actions are processed.

Transfer Restrictions

Tokens cannot be transferred if:

• Sender has unprocessed corporate actions

• Receiver has pending actions on the same token