[Guide] One-click IDO Dapp

One-click IDO Dapp #

The one-click IDO Dapp tool helps project owners deploy a token sale contract and generate a public IDO website automatically. After creation, users can connect their wallet, view sale progress, buy tokens, and claim tokens on the public page. Project owners can manage sale parameters, whitelist addresses, top up sale tokens, update the fund receiver, and transfer admin permission from the management page.

Join the Fatsale official community for support and feedback.

Recommended setup: desktop Google Chrome + MetaMask. Mobile users can also open the link from TokenPocket - Discover.

Tool Entry

Open One-click IDO Dapp

Use Cases #

Create an independent IDO, private sale, public sale, or community sale page
Let investors buy tokens directly from a project website
Accept native coins such as BNB / tBNB or supported stablecoins
Restrict early participation with a whitelist
Use instant delivery or scheduled claim
Withdraw unsold tokens and close the IDO after the sale

Supported Networks #

Network	Chain ID	Notes
BSC Mainnet	`56`	Production network for real launches
BSC Testnet	`97`	Test network for rehearsing the full flow

Before launching a real sale, run through the full flow on testnet: approval, creation, public purchase, claim, and management actions.

Before You Start #

Prepare the ERC20/BEP20 token address you want to sell.
Make sure the creator wallet has enough sale tokens and gas.
If the sale token has transfer tax, exclude the IDO Factory / IDO contract from tax. Otherwise the contract may receive fewer tokens than required.
Prepare the fund receiver address. Buyer payments go directly to this address.
Make sure your VIP website quota is sufficient.

Create an IDO #

Open the one-click IDO Dapp tool, connect your wallet, and log in.
Click create IDO.
Select a network, such as BSC Mainnet or BSC Testnet.
Enter the sale token address. The page reads token name, symbol, and decimals.
Select the payment token, such as native BNB / tBNB or a supported stablecoin.
Enter the fund receiver address.
Choose sale mode, delivery mode, sale time, whitelist setting, and token amount.
Fill in website settings: site name, project intro, banner, logo, social links, and extra information sections.
Review all parameters on the confirmation page.
Click deploy and follow wallet prompts for approval and creation.

The deployment may include two on-chain transactions:

Approval: allow the IDO Factory to transfer the required sale tokens from your wallet.
Creation: the Factory creates the IDO contract and transfers sale tokens into it in the same transaction.

After success, the system generates a public page URL such as ido-xxxx.fatsale.cc.

Sale Modes #

Share mode is suitable for fixed packages. Example:

Price per share: 0.1 BNB
Tokens per share: 10,000 TOKEN
Total shares: 100

Users buy by share count and receive a fixed number of sale tokens per share.

Quota Mode #

Quota mode is suitable for flexible payment amounts. Example:

Rate: 1 BNB = 100,000 TOKEN
Minimum purchase: 0.01 BNB
Maximum purchase: 1 BNB

When users enter a payment amount, the public page estimates the token amount based on the rate.

Delivery Modes #

Delivery	Description
Instant delivery	Tokens are sent to the buyer immediately after purchase
Scheduled claim	Purchase is recorded first; users claim after the claim time

Claim time and sale end time are separate. A project can allow claiming before the sale ends or only after the sale ends.

Website Settings #

During IDO creation, you can configure the public page:

Site name
Banner title and subtitle
Logo and banner image
Project introduction
Twitter, Telegram, Discord, website, and other social links
Extra information sections, such as roadmap, tokenomics, audit, or partners
Page language: Chinese or English

These settings can still be edited later from the management page.

Public IDO Page #

The public page reads IDO status directly from the contract and displays:

Status: not started, active, ended, paused, or closed
Progress, tokens sold, amount raised, and participant count
Sale token, payment token, price or rate
Start time, end time, and claim time
Whitelist status
Current wallet purchase amount and claimable amount
Buy, approve, and claim buttons

The page is responsive on desktop and mobile. Buy, approve, and claim buttons enter a loading state during transactions and refresh on-chain data after confirmation.

Manage an IDO #

The creator can enter the management page from My IDOs. Only the current admin can perform management actions.

Parameter Updates #

The admin can update:

Start time, end time, and claim time
Share mode price and tokens per share
Quota mode rate, minimum purchase, and maximum purchase
Whitelist switch
Website settings

Changing price parameters does not add sale tokens to the IDO contract. If the contract does not hold enough sale tokens after changes, users may fail to buy or claim. Use the top-up function when more sale tokens are needed.

Whitelist #

When whitelist is enabled, only whitelisted addresses can buy. Admins can add or remove addresses in batches.

Fund Receiver #

Buyer payments go directly to the fund receiver address. Admins can update this address from the management page. Always confirm the new address is correct and controlled by the project team.

Top Up Tokens #

Use top-up when sale parameters change, sale capacity increases, or the IDO contract does not hold enough sale tokens. Enter the token amount and confirm the wallet transaction.

Pause Sale #

Admins can pause or resume the sale. While paused, users cannot buy, but the public page still displays IDO status.

Transfer Admin #

Admins can transfer management permission to another address. After confirmation, only the new admin can manage the IDO.

Withdraw Unsold and Close #

If the IDO is not sold out, the admin can withdraw unsold sale tokens. This permanently closes the IDO. Buying, claiming, and admin updates will stop. Only use it when the IDO is no longer needed.

VIP Quota #

Creating an IDO public page consumes website creation quota. VIP plans display:

One-click Website Builder
One-click IDO Dapp
Total websites available

If quota is insufficient, the create page prompts you to activate or renew VIP.

FAQ #

Why is approval required before creation? The Factory transfers the required sale tokens into the new IDO contract during creation. Approval allows it to do this.
Where do buyer payments go? Payments go directly to the fund receiver address set by the project owner.
Does changing price automatically top up tokens? No. It only changes parameters. Use top-up if the contract needs more sale tokens.
Can parameters be changed after the IDO starts? Yes. Admins can update parameters before, during, or after the sale. Check the impact on buyers before changing anything.
Why did a purchase fail? Common reasons include paused sale, ended sale, whitelist restriction, amount below minimum or above maximum, insufficient sale tokens in the IDO contract, wrong wallet network, insufficient payment balance, or missing approval.
Can I reopen the IDO after withdrawing unsold tokens and closing it? No. The close action is permanent.