Corporate Actions

Learn how to execute dividends, coupon payments, balance adjustments, and voting rights for security tokens.

Corporate Actions for Equity Tokens

Dividend Distributions

Distribute earnings to equity token holders.

Accessing Dividends

1. Navigate to your equity token from the dashboard
2. Select Admin View (green)
3. Click on Corporate Actions tab
4. Select Dividends

Viewing All Dividends

The dividends table displays:

ID	Record Date	Execution Date	Dividend Amount	Snapshot
1	2024-12-20	2024-12-27	$5.00	View
2	2025-01-20	2025-01-27	$5.50	View

• ID: Unique dividend identifier
• Record Date: Snapshot date to determine eligible holders
• Execution Date: When dividend payment is distributed
• Dividend Amount: Amount per token
• Snapshot: View holders eligible for this dividend

Programming a New Dividend

1. Click "New Dividend" or "Add Dividend"
2. Fill in the dividend details:
   • Dividend Amount: Amount per token (e.g., 5.00)
   • Record Date: Select date using date picker
   • Execution Date: Select date using date picker (must be after record date)
3. Click "Create" or "Schedule Dividend"
4. Approve the transaction in your wallet

Important: The execution date must be after the record date.

Viewing Dividend Details

Click on a specific dividend to view:

• Dividend parameters (amount, dates)
• Total dividend amount to distribute
• List of eligible holders and their dividend amounts
• Payment status
• Dividend Amount Calculation (numerator, denominator, record date reached status)

Viewing Dividend Holders

Click "Snapshot" or "View Holders" to see:

• Account addresses of eligible holders
• Balance at record date
• Dividend amount each holder will receive
• Payment status
• Token balance at the time of the snapshot

Balance Adjustments (Stock Splits)

Adjust token balances for all holders (e.g., 2-for-1 stock split or 1-for-2 reverse split).

Accessing Balance Adjustments

1. Navigate to your equity token
2. Select Admin View (green)
3. Go to Corporate Actions → Balance Adjustments

Programming a Balance Adjustment

1. Click "New Balance Adjustment"
2. Fill in the details:
   • Execution Date: Select date using date picker
   • Factor: Adjustment multiplier
     • For 2:1 split, enter 2
     • For 1:2 reverse split, enter 0.5
3. Click "Schedule"
4. Approve the transaction

Example: If a holder has 100 tokens and you apply a factor of 2, they will have 200 tokens after execution.

⚠️ Important — Backend Balance Alignment: When a balance adjustment execution date is reached, the on-chain view methods (balanceOf) will immediately reflect the adjusted amounts. However, no event is emitted until the next on-chain operation (e.g., a transfer or issue) is executed for that account. During this window, backend systems that track balances exclusively via events may show balances that do not match on-chain state. Backend systems should periodically reconcile with on-chain view methods around scheduled execution dates.

Voting Rights

Program voting events for equity holders.

Accessing Voting Rights

1. Navigate to your equity token
2. Select Admin View (green)
3. Go to Corporate Actions → Voting Rights

Creating a Voting Event

1. Click "New Voting Event"
2. Fill in the details:
   • Name: Voting event name (e.g., "Annual Shareholder Meeting 2025")
   • Execution Date: Select voting date using date picker
3. Click "Create"
4. Approve the transaction

Viewing Voting Events

The voting rights table displays scheduled voting events with their execution dates.

---

Executing Coupon Payments

For bond tokens, execute periodic interest payments to bondholders.

Accessing Coupons

1. Navigate to your bond token from the dashboard
2. Select Admin View (green)
3. Click on Corporate Actions tab
4. Select Coupons

Viewing All Coupons

The coupons table displays:

ID	Record Date	Execution Date	Start Date	End Date	Coupon Rate	Snapshot
1	2024-12-15	2024-12-22	2024-09-15	2024-12-15	5.0%	View
2	2025-03-15	2025-03-22	2024-12-15	2025-03-15	5.0%	View

• ID: Unique coupon identifier
• Record Date: Snapshot date for eligible bondholders
• Execution Date: Payment distribution date
• Start Date: Beginning of the coupon accrual period
• End Date: End of the coupon accrual period
• Coupon Rate: Interest rate for the period
• Snapshot: View eligible bondholders

Note: The coupon period is calculated as the difference between start and end dates. This allows precise interest calculations based on actual accrual periods.

Programming a New Coupon

1. Click "New Coupon" or "Add Coupon"
2. Fill in the coupon details:
   • Coupon Rate: Interest rate (e.g., 5.0 for 5%)
   • Start Date: Beginning of the coupon accrual period
   • End Date: End of the coupon accrual period
   • Record Date: Snapshot date to determine eligible bondholders (typically same as end date)
   • Execution Date: When coupon payment is distributed (must be after record date)
3. Click "Create" or "Schedule Coupon"
4. Approve the transaction in your wallet

Important:

• The start date must be before the end date
• The execution date must be after the record date
• Coupon interest is calculated based on the period between start and end dates

Viewing Coupon Details

Click on a specific coupon to view:

• Coupon parameters (rate, start date, end date, record date, execution date)
• Coupon accrual period (calculated from start and end dates)
• Total coupon amount to distribute
• List of eligible bondholders and their coupon amounts
• Payment status
• Coupon Amount Calculation (numerator, denominator, record date reached status)

Viewing Coupon Holders

Click "Snapshot" or "View Holders" to see:

• Account addresses of eligible bondholders
• Bond balance at record date
• Coupon amount each holder will receive
• Payment status
• Token balance and decimals at the time of the snapshot

---

Payment Distribution

Corporate action payments can be distributed using:

• Direct Transfer: For small holder counts (< 100)
• Mass Payout Integration: For large holder counts (recommended for > 100 holders)
• Batch Processing: Automatic chunking for large distributions

For large-scale distributions, consider using the Mass Payout system.

Permissions Required

To execute corporate actions, you need:

• CORPORATE_ACTION_ROLE or ISSUER_ROLE for scheduling dividends, coupons, splits, and voting
• PAYMENT_PROCESSOR_ROLE for executing payments (if applicable)

See Roles and Permissions for more details.

Next Steps

• Mass Payout Documentation - Large-scale payment distribution
• Token Operations - Other token operations
• Roles and Permissions - Managing access control