How to Run Investor Distributions On-Chain
How to Run Investor Distributions On-Chain
How to run investor distributions on-chain - calculating pro-rata shares, choosing push vs claim, handling the waterfall, and paying holders accurately and provably.
How to run investor distributions on-chain - calculating pro-rata shares, choosing push vs claim, handling the waterfall, and paying holders accurately and provably.
Paying your investors is a core operational job, and on-chain it can be accurate, fast, and provable - if you set it up right. Running distributions means calculating each holder's pro-rata share, applying the waterfall if the deal has one, and paying out in a way that scales and leaves an auditable trail. The main design choice is push versus claim. Here is how to run distributions that holders trust and you can reconcile.
Step 1: Calculate each holder's share
Start from a clean snapshot of who holds how much at the distribution record date. Because ownership is on-chain, you can read balances directly - no manual cap table to reconcile - and compute each holder's pro-rata share.
Apply the waterfall first if the deal has one: costs, debt, and preferred returns before common holders. Get the calculation right before any money moves.
Step 2: Choose push vs claim
| Push | Claim | |
|---|---|---|
| Who acts | Issuer sends to all | Holder withdraws |
| Gas cost | Issuer pays, scales with holders | Holder pays own claim |
| Best for | Smaller holder base | Many holders |
| Mechanism | Direct transfers | Often merkle-proof claim |
| Investor effort | None | Must claim |
Two models exist. Push sends each holder their share directly - simplest for investors, but gas costs scale with the number of holders and you pay them. Claim lets holders withdraw their share - cheaper for you at scale, and common via a merkle-proof distribution where holders claim against a published root.
For a small holder base, push is clean. For many holders, a claim-based merkle distribution is far more efficient. Pick based on your investor count and who bears the gas.
Step 3: Execute and verify
Fund the distribution in the payout asset (usually a stablecoin), run it, and verify: totals reconcile, each holder's amount matches their share, and the transactions succeeded. On-chain, this is all checkable.
Handle edge cases deliberately - holders who changed wallets, unclaimed amounts, rounding. Decide the policy up front rather than improvising mid-distribution.
Step 4: Record and communicate
Keep records of each distribution - record date, amounts, recipients, transaction hashes - for compliance and accounting. Then tell investors it happened and how to claim if claim-based.
Transparency here builds the trust that brings repeat investors. The investor sees this from the other side in how investors claim their returns - design your flow to match their expectations.
The mechanics in practice
Put numbers on the push-versus-claim choice. A push to 50 holders is a handful of transfers - trivial. A push to 5,000 is thousands of on-chain transfers, and at even a few cents of gas each plus failed-transfer handling, the cost and operational risk climb fast. That is why large distributions use the Merkle-claim pattern: you publish one Merkle root summarising every holder's entitlement (Uniswap's open-source MerkleDistributor is the reference implementation), and each holder claims against it, paying their own gas. For small, one-off payouts, a batching tool like Disperse is enough.
Settle in a stablecoin - USDC is the usual choice - so holders receive a stable amount, not a volatile token. Take the ownership snapshot from on-chain transfer events (a subgraph makes this clean) at a defined record date, and freeze it before you compute shares.
Two practitioner details matter. First, tax: depending on structure and investor type you may owe 1099 or K-1 reporting and sometimes withholding, so capture the data at distribution time, not at year-end. Second, decide an unclaimed-funds policy up front - a claim window, then a sweep back to treasury - because some holders never claim, and improvising that later erodes trust. And always reconcile the on-chain total against your treasury outflow before you call a distribution done.
Where to go next
- Next: go-to-market for a compliant offering.
- The investor's side: how investors claim their returns.
- Glossary: distribution waterfall.
Sources: token-standard specifications; platform documentation, as of 2026.
Frequently asked questions
How do I run investor distributions on-chain?
Take a snapshot of holders at the record date, apply the waterfall if the deal has one, and calculate each holder's pro-rata share. Choose a push model (you send to everyone) or a claim model (holders withdraw, often via a merkle proof), fund it in a stablecoin, execute, verify the totals reconcile, and record everything.
Should I push distributions or let holders claim?
It depends on your holder count and who bears gas. Push sends each holder their share directly - clean for a small base, but you pay gas that scales with holders. A claim model, often a merkle-proof distribution, is far more efficient for many holders because each holder pays their own claim's gas.
How do I make on-chain distributions auditable?
Calculate from an on-chain balance snapshot so there is no manual cap table to reconcile, verify that totals and each holder's amount match after paying, and record the record date, amounts, recipients, and transaction hashes. On-chain execution makes every step checkable, which supports both compliance and investor trust.
Educational content, not financial or legal advice. Tokenized assets carry risk; do your own research and consult a professional before investing.

Written by
Alex BerezhnykCo-founder, CTO · Co-founder & CTO, Unicorn Invest
Seasoned blockchain and web2 developer with entrepreneurship and investing experience, building Unicorn Invest's on-chain tokenization infrastructure.
Related Content
Cap Table & Transfer Agent for Security Tokens
Cap table and transfer agent for security tokens - how ownership is tracked on-chain, what a transfer agent does, and when a tokenized issuer needs one.
RWA Compliance Operations (Issuer's Playbook)
An issuer's playbook for RWA compliance operations - the KYC/AML, whitelisting, custody, cap-table, and reporting work that keeps a tokenized offering compliant.
Investor Whitelisting & Allow-List Management
How to manage investor whitelisting for a security token - adding and removing wallets, keeping the allow-list synced to KYC, and controlling secondary transfers.
how investors claim their returns
How to Tokenize an Asset: Step-by-Step
How to tokenize an asset step by step - structure the entity, pick an exemption, issue the security token, onboard investors, and run distributions. A 2026 guide.
Distribution Waterfall
Glossary definition
Test your knowledge
Evaluate your RWA & tokenisation skills with our quests.
Pass 80% of all quests (7 of 8) to unlock your RWA Certificate.
RWA Foundations
The core ideas behind real-world-asset tokenization - wallets, stablecoins, custody, and what a token actually represents.
8 questions · 24 pts
Investor Essentials
What an investor needs before buying tokenized assets - accreditation rules, and how safe tokenized Treasuries really are.
8 questions · 48 pts
Builder's Path
Structuring and compliance for issuers - 506(c) accreditation verification and choosing the right LLC for your SPV.
8 questions · 57 pts
Get new RWA guides by email
Occasional updates when we publish new lessons. No spam, unsubscribe anytime.