Skip to main content

Whitelist Tiers

Overview​

  • Presale owners can enable a tiered whitelist system during or after presale creation.
  • Multiple tiers can be created, each with its own list of whitelisted wallet addresses.
  • Each tier has a specific end time, defining when that tier's exclusive contribution period finishes.
  • Only wallets assigned to a specific tier can contribute while that tier is active.
  • After all tier periods end, the owner can optionally enable a public sale phase.

How Whitelist Tiers Work​

When setting up your presale, you have the option to enable a whitelist. If you want more granular control over contribution access, you can choose the Whitelist with Tier type.

Here's how to set it up:

  1. Enable Tiers: During presale creation or by editing the pool settings later, select the "Whitelist with Tier" option.

  2. Configure Tiers:

    • You must set up at least Tier 1 and define its End Time. During the period from the presale start until this end time, only wallets added to Tier 1 can contribute.
    • You can create additional tiers (Tier 2, Tier 3, etc.) by clicking the Add a Tier button.
    • For each subsequent tier you add, you must also set its End Time. Wallets added to Tier 2 can only contribute after Tier 1's end time and before Tier 2's end time (and so on for further tiers).

    Whitelist Tiers - Setting Up Tier End Times

  3. Add Wallets to Tiers:

    • Click Add users to whitelist.
    • Use the Select Tier dropdown to choose which tier (Tier 1, Tier 2, etc.) you want to add addresses to.
    • Enter the wallet addresses for that specific tier.

    Whitelist Tiers - Adding Users to a Specific Tier

  4. (Optional) Transition to Public Sale: Once the end time for the final configured whitelist tier has passed, the tiered whitelist mode effectively ends. At this point, you can choose to enable a Public Sale phase, allowing anyone (not just whitelisted users) to contribute until the presale hard cap is reached or the overall presale end time occurs.

Puclic after whilelist tier expired

Q&A​

  • Q1: What is the purpose of using Whitelist Tiers?
    • A: Tiers allow project owners to grant prioritized or exclusive contribution access to different groups of users at different times during the presale. For example, Tier 1 might be for early supporters or partners, while Tier 2 could be for community members who completed specific tasks.
  • Q2: Can a wallet be in multiple tiers?
    • A: The documentation doesn't explicitly state this, but typically, a wallet would be assigned to the earliest tier it qualifies for. Once assigned to Tier 1, it can contribute during Tier 1's timeframe. Whether it can also contribute during later tiers might depend on Pinksale's specific implementation, but its earliest access is defined by its assigned tier.
  • Q3: What happens if I set the end time for Tier 1 to be the same as the end time for Tier 2?
    • A: This configuration likely wouldn't make sense. Tier 2's contribution period starts only after Tier 1 ends. You should set sequential end times for each tier (Tier 1 ends first, then Tier 2, etc.).
  • Q4: Do I have to enable a Public Sale after the tiers end?
    • A: No, the text says you "can enable Public Sale type". This implies it's optional. If you don't enable it, the presale might simply conclude after the final tier's end time passes, depending on your overall presale settings.
  • Q5: Can I add or remove users from tiers after the presale starts?
    • A: While the document focuses on setup, typically whitelist management systems allow adding/removing addresses even after the start, though changes might only affect future contributions. Refer to Pinksale's specific pool management options for confirmation.

Troubleshooting​

  • Q: Users assigned to Tier 2 are complaining they couldn't contribute.
    • A: Double-check the End Time set for Tier 1. Tier 2 users can only contribute after Tier 1's exclusive period has finished. Also, ensure Tier 2's own End Time hasn't already passed. Verify their addresses were correctly added to the Tier 2 list.
  • Q: I can't find the "Whitelist with Tier" option.
    • A: Ensure you are looking in the correct section during presale creation or pool editing where whitelist settings are managed. It might be a sub-option under the main whitelist toggle.
  • Q: I added wallets but they don't seem to be assigned to the correct tier.
    • A: When adding users, make sure you explicitly use the Select Tier dropdown before inputting or uploading the list of addresses for that specific group.
  • Q: After the final tier ended, no one can contribute, even though I wanted a public phase.
    • A: You likely need to manually switch the pool settings from the tiered whitelist mode to "Public Sale" mode after the final tier's end time has passed. Check your pool management actions for this option.