From fundraising to settlement and claims
Understand community purchases, the lifecycle, entitlement allocation, and refund limits.
On this page
Availability and configuration
A presale is a community purchase. Principal is held by the pool contract and used for Flap creation and the initial purchase at launch. The creator has no principal withdrawal function. Entitlements depend on tokens actually acquired; no fixed quantity is guaranteed.
| Configuration | Rules |
|---|---|
| Amount raised | Amounts use 0.05 BNB increments. The soft cap must be at least 50% of the hard cap. The hard cap is at most 16 BNB, also subject to adapter capacity. |
| Subscribe | Subject to transaction minimums and maximums, per-address participation limits, and remaining pool capacity. An excessive transaction is rejected in full. |
| Fundraising duration | 1–365 days, determined by on-chain Unix seconds. |
| Referral allocation | 0%–50%; 0% disables the referral pool. |
| Vesting | Off by default. When enabled, set the percentage and duration, up to 36,500 days. |
The demo flow covers project details, fundraising, token allocation, taxes, and publication confirmation. Core pool parameters cannot change after actual creation; announcements do not change contract rules.
Fundraising and launch status
| Status | Meaning |
|---|---|
| Not started | The start time has not been reached. |
| Fundraising | Subscriptions are allowed within the time interval and pool limits while the hard cap is not filled. |
| Awaiting launch | The hard cap is filled, or the soft cap was reached at the deadline. Launch is allowed within 24 hours after closing. |
| Launched / Fully unlocked | The initial purchase succeeded. Check vesting expiry and entitlement settlement separately. |
| Refundable | The soft cap was not reached by the deadline, or the pool remained unlaunched for 24 hours after closing. |
| Cancelled | The creator cancelled an unlaunched pool with no contributions. |
Reaching the hard cap closes fundraising early. Launch is no longer allowed exactly at the 24-hour boundary. Failed transactions revert entirely and may be retried within the window. A successful launch occurs only once.
Launch snapshot and entitlement settlement
After launch, the service calculates subscription entitlements, referral entitlements, and dividend weights from contribution records and the launch identity snapshot. An authorized settlement account registers them in batches on-chain. Tokens can be claimed only after all registration completes.
Fomo identity is determined by a linked, verified account with a matching wallet in the database. Identity changes after launch do not automatically recalculate frozen eligibility.
How tokens are allocated
Let acquired tokens be T, the referral percentage p, and total eligible points S. With eligible points, the referral pool is floor(T × p); the remaining tokens form the subscription pool. Subscription entitlements follow contribution shares and referral entitlements follow eligible point shares. If S is zero, all tokens go to the subscription pool.
Example: with 100,000 acquired tokens, a 5% referral allocation, and eligible points, the subscription pool has 95,000 tokens and the referral pool 5,000. A subscriber with 10% of contributions receives 9,500 base entitlement tokens; referral entitlements are separate. This is not a quote or return guarantee.
Vesting and claims
- Check that the project launched, entitlements settled, and tokens are currently unlocked.
- Claim subscription or referral tokens as needed. Automatic claims and self-claims use the same paid ledger.
- Verify receipt through the confirmed transaction. Later claims cover only newly unlocked amounts.
Base and referral entitlements share a vesting configuration but are accounted for separately. With 80% vested over 30 days, 20% unlocks at launch and the rest releases linearly by the second. Claims still depend on completed settlement. With vesting disabled there is no release wait. Claims on behalf of a user can pay only the entitlement address.
Refunds and unused purchase funds
Once refundable, you can claim your subscription principal; gas is not refunded. After a successful launch, principal is not refundable, but unused initial-purchase funds can be claimed by contribution share. The adapter requires the remainder to be no more than 1% of the amount raised; otherwise the entire launch reverts.
Refund eligibility depends on contract time and fundraising state, separately from backend entitlement settlement. BNB forcibly transferred to a pool does not count as your subscription.
FAQ
Why is the claimable amount zero when everything is unlocked? Settlement may be incomplete, you may have no entitlement of that type, or you or the bot may already have claimed it. Check settlement and payment records first.
Does a failed subscription use an attempt? Failed transactions do not increase the successful subscription count, but the network may still charge gas.