Skip to main content

Documentation Index

Fetch the complete documentation index at: https://actfun.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Mine-to-Launch is ACTFUN core mechanic: instead of buying into a pre-sale or receiving a team allocation, you earn tokens by participating. Every token launched on ACTFUN starts with zero circulating supply. The community mines 95% of that supply into existence, one funny post at a time, before any trading begins. Only after the community has mined the full mineable supply does the token unlock for open trading.

How Mining Works

When you mine a token, you submit a short funny post alongside your transaction and pay a small ARC fee (feePerMine). The contract mints a fixed batch of tokens (mineAmount) directly to your wallet. That’s it — no whitelists, no KYC, no lottery. If your wallet is eligible, the tokens are yours.
Your funny post is stored on-chain in the ActedFun event. Every mine is permanently part of the token’s history.

The Two Phases

Every ACTFUN token moves through exactly two phases, in order:
The token is live but not yet tradeable. Community members mine tokens by paying the ARC fee and writing a funny post. Each successful mine mints mineAmount tokens directly to the miner’s wallet.Mining continues until totalMined reaches mineableSupply (95% of max supply). The moment that threshold is crossed, the contract automatically calls _graduate() and the token moves to Phase 2. There is no manual trigger — graduation happens inside the same transaction as the final mine.
Once graduated, the token has a fully functional built-in AMM (decentralized exchange). You can buy and sell freely using ARC. The mining functions are permanently locked — no more tokens can be mined.See Token Graduation and the Built-in DEX for details on how the AMM works.

How This Differs from Traditional Launches

Traditional LaunchMine-to-Launch
Team receives large allocation at launchZero team allocation creator gets nothing automatically
Pre-sale investors buy in before communityNo pre-sale; community earns tokens through participation
Token supply is pre-minted and distributedSupply is minted on demand, one mine at a time
Price set by team or bonding curve from day onePrice discovery begins only after 95% is mined
Early buyers have massive advantageEvery miner pays the same fee per mine
The creator sets the mining parameters when deploying the token, but those parameters are immutable once deployed. The creator cannot change fees, cooldowns, or supply after launch. They also receive no automatic token allocation.

What Prevents Spam and Sybil Attacks

Mining is gated by three independent on-chain controls, all enforced by the smart contract with no possibility of bypass: Per-wallet cooldown (cooldownSeconds) After each mine, your wallet must wait a set number of seconds before mining again. You cannot mine twice in quick succession from the same address. Per-wallet daily cap (dailyMax) Within any rolling 24-hour window, you cannot mine more than dailyMax tokens from a single wallet. The daily window resets automatically based on the timestamp of your first mine in the window. ARC fee (feePerMine) Every mine costs real ARC. This makes bot farming expensive: running hundreds of wallets means paying hundreds of fees. All collected fees flow into the LP pool at graduation, not to the creator.
All three limits are checked on-chain in the same transaction. If any check fails, your transaction reverts and you pay no fee. The contract never takes your ARC without minting tokens.

Refunds Before Graduation

If a token is still in the mining phase, you can claim back all the ARC fees you have paid by calling claimRefund(). Once the token graduates, refunds are permanently closed your fees become part of the AMM’s initial liquidity pool.
Check claimableRefund(yourAddress) on the contract to see your current refundable balance before graduation.