ClankerPresaleEthToCreator

​

Features

• Price Discovery: Creators can set a min and a max ETH goal to raise. The starting price of the token goes up as more people buy into the presale.
• Optional Allowlists: Creators can opt to manage a merkle-root based allowlist with per-address overrides. See ClankerPresaleAllowlist for more details.
• Presale Tokens Lockup and Vesting: Presale tokens must be locked up for a minimum of 7 days post token creation, with optional vesting on top. This is to help ensure smooth post-launch market dynamics.

​

Fees

​

Creating a Presale

• presaleDuration: Maximum amount of time to run the presale for.
• maxEthGoal: Maximum amount of ETH to raise. If this number is hit, the presale stops accepting new bids and the token can be launched immediately.
• minEthGoal: Minimum ETH goal to hit for a presale to be considered successful. The token can be launched if this minimum is hit after the presale duration has passed or if the presale owner requests it.
• deploymentConfig: The token to deploy once a presale hits a success condition. This is a normal Clanker v4 deployment config with all features except the DevBuy fully accessible. The presale contract needs to be the last specified extension.
• presaleOwner: Address used to claim raised ETH and to manage the optional allowlist.
• lockupDuration: How long to lock up presale tokens for. Minimum 7-day lockup is required.
• vestingDuration (optional): How long to vest the presale tokens for. The vesting is linear and starts after the lockup period has ended. For example, if this is set to 10 days and the lockup duration is set to 10 days, on day 15 half of the supply would be claimable and on day 20 the token becomes fully claimable.
• allowlist (optional): Address of the allowlist module to use to manage the presale.
• allowlistInitializationData (optional): ABI-encoded data to pass to the allowlist module if it exists.

function startPresale(
    IClanker.DeploymentConfig memory deploymentConfig,
    uint256 minEthGoal,
    uint256 maxEthGoal,
    uint256 presaleDuration,
    address presaleOwner,
    uint256 lockupDuration,
    uint256 vestingDuration,
    address allowlist,
    bytes calldata allowlistInitializationData
) external onlyAdmin returns (uint256 presaleId);

​

Participating in the Presale

​

Buying into a Presale

function buyIntoPresale(uint256 presaleId) external payable;

function buyIntoPresaleWithProof(uint256 presaleId, bytes calldata proof) external payable;

​

Withdrawing from a Presale

function withdrawFromPresale(
    uint256 presaleId, 
    uint256 amount, 
    address recipient // address to receive the refunded ETH, can be the same as the msg.sender
) external;

​

Ending a Presale

function endPresale(uint256 presaleId, bytes32 salt) external;

1. The maxEthGoal is hit at any point.
2. The minEthGoal was hit and the presaleDuration has passed.
3. The minEthGoal is hit and the presale owner requests it to end early.

​

Claiming Tokens

​

Claiming Tokens

function claimTokens(uint256 presaleId) external;

​

Claiming ETH

// only callable by the presaleOwner
function claimEth(uint256 presaleId, address recipient) external;