Documentation
Public docs for project teams and token holders
Use the audience guides if you want the shortest path, or open the deeper reference pages for fees, how migration works, security, FAQ, and glossary.
FAQ
Frequently asked questions
This page collects the most common questions from project teams and token holders in one place.
For project teams
Questions most likely to come up in evaluation, budgeting, and migration planning.
Why use w3Swap instead of handling a migration manually?
w3Swap gives projects a structured on-chain migration flow with visible rules, holder-facing swap UX, liquidation and LP funding rules, and lockups that are easier to explain publicly than ad hoc forms or manual airdrops.
What fees do project teams pay?
Project fees currently include a 2 SOL flat platform fee per project, a 1% settlement fee on captured WSOL from liquidations, a 1 SOL fee for the first migration-window reset before activation, and 2 SOL for each later reset before activation. Projects also cover normal rent and transaction costs, and may see small artifact-upload or ALT-related costs depending on configuration.
Which costs are reclaimable?
Account rent is generally reclaimable when the project is finalized and subordinate accounts are closed. ALT costs are also intended to be reclaimable when the ALT is deactivated and closed. Platform fees and settlement fees are not reclaimable.
Can we restrict who migrates or assign different ratios?
Yes. Projects can enable an allowlist and can also enable per-wallet special ratios. Both use Merkle-based proofs so the holder proves eligibility at migration time rather than relying on an off-chain spreadsheet.
How much liquidation value must go back into LP?
The protocol enforces a minimum LP reinvestment threshold per project. At least 25% of liquidation proceeds must be added back into LP, and projects can choose a higher percentage for their own migration.
What happens to unclaimed new tokens after the migration?
They remain in project-controlled vaults until the lockup and finalization flow completes. After the lockup period, the project admin can reclaim remaining balances according to the protocol's normal finalization rules.
For token holders
Questions most likely to come up before or during the migration window.
What happens when I click migrate?
You sign a Solana transaction from your own wallet. If your wallet is eligible, your old tokens move into the migration vault and you receive the new tokens at the configured ratio in the same migration flow.
How do I know I am receiving the correct amount?
The migration screen shows the ratio before you sign. If the project uses a special per-wallet ratio or an allowlist, your wallet must provide the matching proof, and the program verifies that proof before the migration succeeds.
Is the migration atomic?
From a holder's perspective, the migration works like an atomic swap: old tokens go in and new tokens come out within the same wallet-signed migration flow. You do not send tokens into a blind off-chain queue and wait for a separate manual distribution.
What do holders pay?
Holders generally pay only Solana transaction fees. If your wallet needs a new associated token account for the new token, you may also pay the rent for that account.
What happens to my old token after I migrate?
Old tokens are collected into the project's vaults. After the migration window ends, the project completes liquidation and settlement steps that can convert that old-token value into WSOL and use part of it to deepen liquidity for the new token.
What risks still remain even with w3Swap?
w3Swap can make rules more transparent and automated, but it does not remove market risk, launch risk, liquidity risk, or project execution risk. Holders should still review the project terms, token addresses, and timing before signing.