Overview
A corporate action is an event that affects a security or its holders. A company can pay a dividend, split its shares, offer to buy shares, or call a shareholder meeting. Holders need to know what happens, when it happens, and whether they need to respond.
Tokenized securities need the same information. Representing a security with a token does not remove its corporate actions or the need to communicate them.
Why a shared approach matters
A blockchain records token changes, but those changes do not always explain their business meaning. A change in the amount of shares represented by a token could result from a split or a reinvested dividend. That change alone does not give the record date, payment terms, or holder choices.
If each issuer publishes this information differently, each wallet or exchange needs a separate integration. A common announcement mechanism and data format let applications find and interpret notices consistently across issuers.
The goal is to connect the token to information that a holder can understand, without replacing the systems that carry out the corporate action.
Two building blocks
Onchain Announcements
This specification defines how a contract publishes a disclosure. The disclosure has an identifier, a short description, and a link to more information. It can also group related token changes in the same blockchain transaction.
An announcement can be information only. It does not need to change a token balance or move funds.
Learn more in Concepts: Announcements.
Corporate Action Schema
This specification defines the structure of a corporate action document and the rules for interpreting it. The document identifies the asset, action, revision, dates, and terms, including holder options or meeting resolutions.
JSON is structured text that applications can read. JSON Schema defines the permitted structure and values. The document contains a particular action's data; the schema defines how that data is organized.
The format uses corporate action vocabulary from ISO 15022 and ISO 20022, with type names from the Broadridge BRx data model.
Learn more in Concepts: Corporate action schema.
How the pieces fit
The issuer publishes corporate action details in a shared format. An onchain announcement links those details to the token. The announcement and its token changes commit in one transaction. The hosted JSON document is published separately.
The issuer publishes the document
The issuer or its agent hosts a corporate action document that follows the Corporate Action Schema.
Publisher
Issuer or agent
Prepares and authorizes the notice.
Offchain document
Corporate action JSON
Corporate Action Schema
eventRevision: 1
Example effect: planned
Onchain
Token contract
Not announced yet
See Corporate action schema for the update rules.
What remains outside this flow
The specifications communicate the action. They do not establish legal rights, calculate a particular holder's entitlement, determine eligibility, or submit votes and elections. Issuers and their service providers remain responsible for these processes and settlement.
An announcement can group existing token operations with its disclosure. Neither a notice nor a valid JSON document proves that an offchain payment has occurred.