Skip to main content

Create a Subscription

Overview​

This guide explains how to create a Subscription pool on Pinksale. Unlike standard presales or fair launches, the Subscription model uses an "overflow" method. Users commit funds (like BNB, ETH), and their final token allocation is based on their share of the total committed funds relative to the project's hard cap. Reading this will help you:

  • Understand the Subscription (overflow) model and how token allocation works using ratios.
  • Follow the step-by-step process to create a Subscription pool.
  • Know the specific parameters required: HardCap Tokens, SoftCap Tokens, HardCap Per User, Whitelist option, Liquidity, Refund Type, etc.
  • Understand important notes regarding fee exclusions and stablecoin usage.
  • Complete the process by adding project info and finalizing the pool creation.

How Subscription Pools Work (Overflow Method)​

In a Subscription pool:

  1. Users commit funds (e.g., BNB) during the sale period. They can commit more than the pool's hard cap (this is the "overflow").
  2. At the end, the total committed funds from all users are summed up.
  3. Each user's final allocation of the project token is calculated based on the ratio of their individual commitment compared to the total committed funds.
    • User's Token Allocation = (User's Committed Funds / Total Committed Funds) * Total Project Tokens Offered (HardCap Tokens)
  4. The corresponding cost for their allocated tokens is deducted from their committed funds based on the implied token rate.
  5. Users can then withdraw the remaining (unused) portion of their initially committed funds.

Example:

  • Subscription Pool Offers (HardCap Tokens): 1,000 Project Tokens
  • Implied Rate (for calculation): 1 Token = 0.1 BNB (meaning the target raise value is 100 BNB)
  • User A commits 100 BNB.
  • Total committed by all users: 1000 BNB (10x overflow).
  • User A's commitment ratio: 100 BNB / 1000 BNB = 0.1 or 10%.
  • User A's final token allocation: 10% of the 1,000 Project Tokens Offered = 100 Project Tokens.
  • Cost deducted from User A: 100 Project Tokens * 0.1 BNB/Token = 10 BNB.
  • User A withdraws remaining committed funds: 100 BNB (committed) - 10 BNB (deducted) = 90 BNB.

Note: If a Hard Cap per user exists and high commitment causes users to hit it, their excess allocation potential passes to other participants based on their commitment ratios.

Step 1: Verify Token​

  1. Connect Wallet: Ensure your wallet is connected to Pinksale on the correct network.
  2. Navigate: From the homepage, click "Launchpads" => "Create subscription". You will be redirected to: https://www.pinksale.finance/launchpad/create/subscription

Create A Subscription 1

  1. Token Address: Input your token address (or create a new token using Pinksale's tools).

Create A Subscription 2

  1. Raise Currency: Select the currency you want users to commit (e.g., BNB, ETH, MATIC, or a corresponding stablecoin).
  2. Fee Option: Choose a fee option for the pool creation.
  3. Confirm Creation (Initial Step): Your wallet (e.g., MetaMask) will ask for confirmation for this initial setup step, showing a fee. Click "Confirm".

Notes:

  • If your token has transfer fees, rewards, or max transaction limits, ensure it has a function to Exclude Fees, Dividends, Max Transaction Amount for the presale address.
  • Using stablecoins for raising funds typically works only with standard (non-taxed) tokens.

Step 2: Input Subscription Pool Info​

After verifying your token, define the parameters for your Subscription pool:

  1. Ensure all numerical inputs are positive numbers.
  2. HardCap Tokens: Enter the total amount of your project tokens you want to sell in this subscription pool. This defines the sale's hard cap in terms of your token.
  3. SoftCap Tokens: Enter the minimum amount of your project tokens that need to be allocated/sold for the pool to succeed. SoftCap must be greater than or equal to 51% of the HardCap Tokens.
  4. HardCap Token Per User: Enter the maximum amount of your project tokens that any single contributor can receive as their final allocation, regardless of how much they commit.
  5. Whitelist: Choose "Enable" if you want only whitelisted addresses to participate. You can typically manage the whitelist after pool creation.
  6. Router: Select the DEX router for liquidity (e.g., PancakeSwap).
  7. Liquidity percent (%): Enter the percentage of raised funds (calculated based on the actual funds deducted, up to the equivalent hard cap value) that should be automatically added to liquidity on the chosen DEX. Minimum 51%, maximum 100%.
  8. Refund Type: Choose how any unsold tokens (if the SoftCap is met but HardCap isn't fully allocated) are handled: typically "Refund" (returned to owner) or "Burn" (sent to dead address).
  9. Start time & End time: Set the period during which users can commit funds. Start time must be before end time.
  10. Liquidity lockup (days): Specify how long the DEX liquidity pool tokens will be locked (e.g., 365 days).

Create A Subscription 3

Step 3: Add Additional Info​

Provide details about your project for the subscription pool page:

  1. Logo URL and Website are required fields and cannot be blank.
  2. Logo URL must end with a supported image extension: .png, .jpg, .jpeg, or .gif. You can use Pinksale's AI Logo Generator feature if available/preferred.
  3. Fill in other relevant social media links (Github, Twitter, Telegram, etc.).
  4. Click "Next" after entering the information.

Create A Subscription 4

Step 4: Finish​

Review all your entered information carefully before submitting.

  1. Check all details on the summary page. Go back to previous steps if changes are needed.

Create A Subscription 5

  1. Click “Approve Spending Token” and confirm the transaction in your wallet (e.g., MetaMask). This allows Pinksale access to the tokens needed for the subscription sale. Ensure you have enough native currency for gas fees.

Create A Subscription 6

  1. After the approval is confirmed, click the final “Submit” button.
  2. Your wallet will prompt for a final confirmation for the pool creation transaction, showing the gas fee. Click “Confirm” if you agree.
  3. Your Subscription pool is now created!

Create A Subscription 7

Note: You can use Pink Lock to lock team tokens or other tokens and display this information via an editable tokenomic chart on your Subscription pool page.

(Link Analysis: Link for PinkLock points to a general Create Lock page. Link for Exclude Fees points to a general doc page. All other links/images appear structurally valid.)

Q&A (FAQs)​

  • Q1: What happens if the total committed funds are LESS than the equivalent value of the HardCap Tokens?

    • A: In this case, the pool still uses the overflow calculation. Each user gets tokens proportional to their commitment relative to the total committed amount. The price per token effectively remains the same as intended, but not all tokens offered (HardCap Tokens) might be sold if the pool didn't reach its full potential value. The outcome depends on whether the SoftCap Tokens amount was met.

  • Q2: How is the price per token determined for deducting funds?

    • A: The implicit price per token is determined by the parameters you set, essentially: (Equivalent Value of HardCap Tokens in Raise Currency) / (HardCap Tokens). For example, if you sell 1 Million tokens (HardCap Tokens) and aim to raise 100 BNB (implied hard cap value), the price is 0.0001 BNB per token. This rate is used to calculate how much BNB to deduct from each user's commitment based on their final token allocation.

  • Q3: Why is the SoftCap defined in Tokens, not the raise currency?

    • A: Because the final amount of raise currency collected can exceed the equivalent hard cap value due to the overflow mechanism. The success condition (SoftCap) is therefore based on ensuring a minimum amount of the offered project tokens are successfully allocated/sold.

  • Q4: When can users withdraw their unused committed funds?

    • A: After the project owner successfully finalizes the subscription pool (which happens after the sale ends and soft cap is met), users can typically visit the pool page, connect their wallet, and withdraw the portion of their committed funds that was not used to pay for their final token allocation.

Troubleshooting​

  • Q: My "Approve Spending Token" or "Submit" transaction fails.

    • A: Ensure you have sufficient native currency (BNB, ETH, etc.) for gas fees in your wallet. Check if your token contract requires fee exclusions for the presale address (Step 1 Notes) and if they have been set correctly. Network congestion or contract errors could also be factors; check the block explorer for error details.

  • Q: I set the HardCap Token Per User, but users seem to be allocated more?

    • A: The HardCap Token Per User limits the final allocation after the overflow calculation. Users can commit more funds initially, but their received token amount will be capped at this value if their proportional share exceeds it.

  • Q: Where do I set the price per token?

    • A: You don't directly set a fixed price per token like in a standard presale. The price is implicitly defined by the ratio of the HardCap Tokens you are selling and the intended total value you aim to represent with that amount (which influences the SoftCap calculation and the amount deducted from commitments). Focus on setting the HardCap Tokens and SoftCap Tokens appropriately.