Advanced Initial Coin Offerings (ICO)
Welcome to the Advanced Crowdsale Smart Contract user manual. An advanced whitelisted crowdsale with post-delivery options and payments with multiple tokens and Ether.
Features
Receive contributions in any ERC-20 token
Supporters can send contributions using any ERC-20 like USDT, WETH, WBTC, etc.
Option to restrict participation to whitelisted contributors only
Enable this option to restrict participation in the crowdsale to pre-approved (whitelisted) contributors only.
Supporters can send contributions using a GUI
Your supporters can use your ICO page to contribute using Metamask
Distribute tokens to supporters automatically during the crowdsale, or in batches at its finalization
Decide whether you want your users to receive the tokens automatically or at the end of the crowdsale.
Tokens can optionally be distributed directly to a UBE staking contract
Enable this option to automatically send tokens to a UBE staking contract for staking.
Receive the funds directly in your ETH wallet
Funds are automatically sent to your custom Ethereum address for every contribution
ERC-20 Token Distribution
You can define your own ERC-20 token for distribution
Allowance Crowdsale
ICO funds are pre-approved from your wallet
Opening and closing dates
Time lapse for the ICO to be open
Ability to finalize the crowdsale
Admins can manually finalize the ICO.
How to Use the Caramel Crowdsale Smart Contract
ICO Settings
ERC-20 / BEP-20 Token Address
It must be a valid ERC-20-compatible token; otherwise deployment and purchases will fail.
Wallet
Ethereum/EVM-compatible address that will receive the contributed funds.
Token distribution rate (per Ether)
How many sale tokens are delivered for each 1 Ether/native coin contributed.
Distribution Wallet
Address that holds the sale tokens and approves the allowance to the crowdsale.
Contributions limits for Ether
Optional Min/Max contribution limits. Available after the contract is deployed.
Advanced ICO Settings
ERC-20 Payment Tokens
After deployment you can add payment tokens. For each token specify its address, the token-to-sale-token rate, and optional contribution limits.
Whitelisted ICO
Enable to restrict participation to addresses you whitelist.
Timed
Enable to accept contributions only within a time window, then set Opening and Closing date/time.
Token Delivery Settings
Choose how tokens are delivered (e.g., post-sale delivery). Staking options become available after deployment.
Use the Smart Contract Wizard
If you are not sure what flavor or network is the best for you, use the WP Smart Contracts wizard
To deploy your Crowdfunding to any network do the following:
Login into your WordPress install.
Login into Metamask
Learn how to install MetamaskClick “ICO” - “Add new”
Fill in the token address.
This is the address of the token you want to sell. It has to be an ERC-20 / BEP-20 Token compatible address. Otherwise it will fail.
Fill in the Token distribution rate
The ratio of distribution per each coin contributed.
Fill in the Wallet
Ethereum address or EVM compatible wallet address to receive funds
Fill in the Distribution Wallet
Address holding the tokens, which has approved allowance to the crowdsale
Select the network
Expand All networks
In the bottom left section of the screen you can click on "Expand All" in the network section to see all blockchains available to deploy the selected flavor. Available networks vary from one flavor to another.
Filter networks
In the bottom section you can click on checkboxes to filter your networks results by mainnet, testnets, Ethereum Bitcoin, etc.
Switch to desired network
Click on "Switch" on the desired networks to add this network to your Metamask and switch to it
Approve the operations in Metamask
Deploy with the native token of the selected network
Deployment and gas fees are paid using the native coin of the selected network, meaning that if you chose Ethereum you will pay in Ether, if you chose Polygon you will pay in Matic, etc. You will see the price in the native coin and the estimated equivalent in US Dollars in the top left of the networks section.
Click on the green “Deploy” button.
Read carefully the terms and conditions
Basically you need to know what you are doing and to know that this actions is irreversible.
If you agree and you know what you are doing click on both checkboxes
Click “Yes, please proceed”
Click “Confirm” in Metamask and wait for your transaction to finish.
Then your post will be updated showing the new Smart Contract information.
Buy Tokens Setting up the ICO