Skip to main content

How to Unlock

Overview​

This guide explains how the designated owner can unlock tokens previously locked using Pinksale's PinkLock feature. This covers both simple time locks (unlocking the full amount after expiry) and vesting locks (claiming tokens as each cycle completes). Reading this will help you:

  • Understand the process for unlocking tokens from a simple time lock.
  • Understand how to claim tokens released through a vesting schedule.
  • Know where to find your locks and initiate the unlock/claim process.
  • Be aware of the serious implications of using the "Renounce Lock Ownership" function.
  • Find answers to common questions about unlocking and claiming.

Method 1: Unlock Tokens Without Vesting (Simple Time Lock)​

Once the lock duration you set has expired, the designated owner can withdraw the locked tokens.

  1. Connect Wallet: Ensure the wallet designated as the owner of the lock is connected to Pinksale on the correct network.

  2. Navigate to Token Locks: From the Pinksale homepage, go to "PinkLock" => "Token", or directly access: https://pinksale.finance/pinklock/token

  3. Find Your Lock: Click on the "My Lock" tab. Locate the specific lock entry you wish to unlock and click on "View".

    Finding Lock in My Locks Tab

  4. Unlock Tokens: If the lock period has expired, the "Unlock" button should be active. Click "Unlock".

    Unlock Button for Expired Lock

  5. Confirm Transaction: Your wallet (e.g., MetaMask) will ask for confirmation. It will show the network gas fee required for the withdrawal. Click “Confirm” to finish the process and receive the tokens in the designated owner wallet.

Method 2: Unlock/Claim Vested Tokens​

When each vesting cycle ends (either the TGE date or the end of a subsequent cycle), the designated owner can claim the portion of tokens that became available during that period.

  1. Connect & Navigate: Follow steps 1-3 from Method 1 above (Connect owner wallet, go to PinkLock -> Token -> My Lock -> View the specific vesting lock).

  2. Claim Vested Tokens: If tokens are available based on the vesting schedule (i.e., TGE or a cycle has completed), the "Unlock" button will be active. This button effectively functions as "Claim" for vesting locks. Click "Unlock".

    Unlock/Claim Button for Vesting Lock

  3. Confirm Transaction: Confirm the transaction in your wallet (e.g., MetaMask) and pay the gas fee to receive the currently claimable batch of vested tokens.

  • Accumulated Claims: If the owner doesn't claim tokens exactly when a cycle expires, they can do so at any later time. If multiple cycles have passed, clicking "Unlock" will withdraw the total accumulated amount available from all completed past cycles up to that point.

Renounce Lock Ownership (Use Extreme Caution!)​

There is an option on the lock details page to "Renounce Lock Ownership".

  • Action: Clicking this and confirming the transaction permanently transfers the ownership of that specific lock to a dead address (an address nobody controls, like 0x00...00dEaD).
  • Consequence: This means NO ONE (including the original owner) will EVER be able to unlock or claim ANY remaining tokens from that lock, even after the lock period or vesting schedule completes. The tokens become permanently inaccessible.
  • Warning: Only use this function if you fully understand its irreversible nature and intend for the locked tokens to be permanently removed from circulation after the lock is renounced. Pinksale accepts no liability for any loss resulting from this action.

Q&A (FAQs)​

  • Q1: Who can unlock the tokens?
    • A: Only the wallet address designated as the "owner" when the lock was created can initiate the unlock/claim transaction.
  • Q2: Do I have to unlock tokens exactly when the lock expires or a vesting cycle ends?
    • A: No. For simple locks, you can unlock anytime after the expiry date. For vesting, you can claim available tokens anytime after the relevant cycle completes. Unclaimed amounts from previous cycles accumulate and can be claimed together later.
  • Q3: Do I need to pay gas fees to unlock or claim?
    • A: Yes, every time you click "Unlock" and confirm in your wallet, it's a blockchain transaction that requires payment of network gas fees (in the chain's native currency like BNB, ETH, etc.).
  • Q4: What is the difference between unlocking a Token lock and an LP Token lock?
    • A: The process using PinkLock is identical. You navigate to either the "Token" or "Liquidity" section under PinkLock, find your lock in "My Locks", and click "Unlock" after expiry. The difference is simply what you are unlocking – either your project's native token or the LP tokens representing your share of the DEX liquidity pool.

Troubleshooting​

  • Q: The "Unlock" button is greyed out or not visible.
    • A: Ensure you are connected with the correct owner wallet address that was set when the lock was created. Double-check that the lock expiry date (for simple locks) or the TGE/cycle end date (for vesting) has actually passed (remember times are usually in UTC). Refresh the page. Make sure you are viewing the correct lock entry under "My Locks".
  • Q: I clicked "Unlock" and confirmed, but the transaction failed.
    • A: Ensure you have enough native currency (BNB, ETH, etc.) in the owner wallet to pay for the gas fees. Network congestion might cause temporary failures. Check the specific error message on the block explorer; sometimes interacting with lock contracts requires a slightly higher gas limit.
  • Q: I accidentally renounced ownership of a lock. Can I get the tokens back?
    • A: No. Renouncing ownership is irreversible. The tokens associated with that specific lock are permanently lost and cannot be recovered by anyone once ownership is sent to the dead address.