Distributing tokens
How tokens are distributed to investor wallets?
At the end of the primary market process, you deliver tokens to investor wallets.
You can handle this either on an ongoing basis (distributing tokens immediately after each investor completes all requirements) or in batch runs (distributing all investments together at the end of an offering period).
Prerequisites for distribution
Before initiating distribution, these conditions must be met:
Investments are in confirmed status
Selected wallets are verified
Investors remain verified
Investors are still included in the asset's whitelists
Both investors and wallets remain active
Distribution methods
You can trigger distributions using two approaches:
Individual distribution - Process investments one at a time. If one investment fails prerequisite checks, only that distribution fails while others can proceed.
Batch distribution - Process all confirmed investments for an asset together. If any single investment fails prerequisite checks, no distributions will execute.
Choose the method that best fits your business model and offering structure.
Distribution process
Distribution is asynchronous and follows this workflow:
Trigger distribution request - Investment moves to "in distribution" status
Wait for completion notification with one of two outcomes:
Success - Investment changes to "Distributed" status and tokens transfer to the investor wallet
Failure - You receive an error notification (e.g., wallet unreachable on-chain) and the investment moves to "distribution failed" status with failure details
Retry if needed - Make necessary adjustments and trigger distribution again if it failed
What's next?
🎉 Congratulations! 🎉 Once tokens are distributed to investor wallets, you enter the asset servicing phase. This involves fulfilling regulatory reporting requirements, managing payments to investors (redemptions, interest, dividends based on your asset type), and handling investor requests such as wallet recovery assistance.
Last updated