Skip to main content

QsnLaunchpad

The QsnLaunchpad contract provides a fair token launch platform on QsnDEX. Projects can raise ETH through a structured sale with built-in liquidity provisioning, LP locking, and investor protections.

Launch Structure​

Each launch is configured with the following parameters:

  • Token -- The ERC20 token being sold.
  • Soft cap -- The minimum ETH raise required for the launch to succeed.
  • Hard cap -- The maximum ETH raise accepted.
  • Token allocation -- Total tokens allocated for sale and liquidity.
  • Duration -- The sale period length.
  • LP lock duration -- Minimum 30 days; the period during which generated LP tokens are locked.

How It Works​

1. Launch Creation​

The project owner creates a launch by depositing the sale tokens and configuring the parameters. A platform fee is charged at creation time.

2. Contribution Phase​

During the sale period, participants send ETH to the launch contract. Contributions are accepted until the hard cap is reached or the sale period ends.

3. Finalization​

If the soft cap is reached by the end of the sale:

  • A portion of raised ETH and tokens are paired and deposited as liquidity on QsnDEX via the Router at the 0.30% fee tier.
  • The generated LP tokens are locked in the contract for the specified lock duration (minimum 30 days).
  • Remaining ETH is sent to the project owner.
  • Participants can claim their purchased tokens.

4. Refund (Soft Cap Not Met)​

If the soft cap is not reached by the end of the sale period, all participants can claim a full refund of their ETH contributions. No tokens are distributed.

Platform Fees​

Fee TypeAmount
Creation fee0.05 ETH
Token fee2% of tokens allocated to the launch

The creation fee is paid in ETH when the launch is initialized. The token fee is deducted from the deposited token allocation.

Auto-Liquidity​

Upon successful finalization, the contract automatically:

  1. Pairs a portion of raised ETH with the launch token.
  2. Calls addLiquidityETH on the QsnRouter at the 0.30% fee tier.
  3. Locks the resulting LP tokens in the contract for the configured lock duration.

This ensures every successful launch has immediate trading liquidity on QsnDEX.

LP Lock​

LP tokens generated during finalization are locked for a minimum of 30 days. The project owner specifies the lock duration at launch creation, which must be at least 30 days. After the lock period expires, the project owner can withdraw the LP tokens.

Emergency Cancel​

If a launch has not been finalized within 7 days after the sale period ends, the contract owner can trigger an emergency cancellation. This enables refunds in cases where the project owner fails to finalize a successful launch.

Refund Mechanism​

Refunds are available in two scenarios:

  • Soft cap not met -- Participants claim refunds after the sale period ends.
  • Emergency cancel -- Participants claim refunds after admin cancellation.

In both cases, participants receive their full ETH contribution back. The refund process is pull-based: each participant must call the refund function individually.