Overview
What Corpact is, what it gives you, and where to start.
Tokenized stocks pay dividends by changing a multiplier on the mint. Holders end up with more stock-equivalent units, yet no transaction touches their account, so anything that follows transfers sees nothing. Corpact reads those changes, proves what each one was, and turns them into an audit-ready ledger behind one API.
Start here
Run real requests against the hosted API from your browser, with a read-only demo key.
Run the demoThe whole flow on a local Solana network with synthetic data, checked through the real API.
QuickstartPoint the worker at mainnet, sync a wallet, and read its dividends, splits and coverage.
API referenceGenerated from the same schemas the server validates against, so it cannot drift.
What you get
Cash dividends, withholding refunds, splits, stock dividends, spin-offs, rights and identity changes, each with the evidence it requires.
Classified from evidenceMatched to the issuer's own record on exact multipliers and activation time. Never from the size or label of a change.
Protected principalUnits that came from dividends stay separate from principal, and splits adjust the basis exactly.
Coverage on every numberA position is complete, partial or unsupported. Partial history never produces a yield claim.
Append-only journalAn issuer correction becomes a reversal plus a replacement. Nothing is ever edited.
Reconciled to the chainEvery replay matches the exact raw balance, optionally cross-checked against a second RPC provider.
How the pieces fit
| Component | What it does |
|---|---|
| Worker | Reads chain history and mint state, rebuilds the multiplier timeline, classifies changes and replays positions into Postgres |
| API | Serves portfolio, income, corporate actions, journal, yield and exports to API keys scoped by tenant |
@corpact/client | Typed TypeScript client generated from the same schemas as the API |
| Dashboard | A reference UI that calls the API through its own server |