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.

For Holders

Token holder guide

Use this guide if you want to understand what happens when you migrate, what you pay, what happens to your old token, and what trust assumptions still remain.

The holder flow

For holders, the migration path is intentionally short.

1
Connect your wallet during the active migration window.
2
Review whether your wallet is eligible and what ratio applies to your wallet.
3
Enter the amount you want to migrate and review the expected output.
4
Sign the migration transaction from your own wallet.
5
Receive the new token through the same migration flow and continue holding or trading based on the project's market conditions.

What to check before you sign

The most important holder checks happen before confirming the transaction.

Confirm you are on the correct migration page for the project and that the project has published the official token addresses.
Check the old token, new token, ratio, and migration-window timing shown by the interface.
If the project uses an allowlist or special ratio, confirm that your wallet is recognized correctly before signing.
Make sure you understand whether you may need a new associated token account for the new token.

What happens to your old token

A frequent source of confusion is what the project does with surrendered old tokens.

During migration

Old tokens are collected into project-controlled vaults as holders migrate.

After the window closes

The project completes liquidation and settlement steps that can convert that value into WSOL or SOL and use part of it to deepen liquidity for the new token.

Why that matters

This helps teams explain how old-token value can support the new token instead of just vanishing into an informal treasury process.

What holders keep

Once your migration succeeds, you keep the new tokens you received. The old tokens you surrendered are part of the project's migration accounting.

What holders pay

Holder-side costs are intentionally simple.

Normal Solana transaction fees for the migration transaction.
Potential rent for a new associated token account if your wallet does not already have one for the new token.
No separate platform fee charged directly to holders as part of the published first-pass docs model.

Protections and limits

These docs should help holders understand both what is better about the flow and what risk still remains.

What the protocol helps with

Eligibility, ratios, lifecycle transitions, and parts of the settlement flow are enforced by the program instead of being handled manually in DMs or spreadsheets.

What still depends on the project

Project quality, market demand, launch execution, narrative strength, and long-term token performance are not guaranteed by the protocol.

Important

A safer process is not the same thing as zero risk. You should still verify token addresses, the project team's communications, and the migration terms before signing.

What if you wait too long?

Migration windows do not stay open forever.

Once the migration window closes, holders can no longer use the normal w3Swap migration flow for that project. Some projects may later choose a separate remediation path for missed holders, but that is not guaranteed by the protocol and should not be assumed.

Next steps

If you want more detail, these are the best next pages.

Read holder FAQ Review trust model