Levr Docs

Appearance

Register Existing Token ​

Add Levr's governance, staking, and treasury to your existing Clanker token.

Register Existing Token Interface

What You'll Get ​

When you register your existing token, you get:

  • ✅ Governance - Community proposals and voting
  • ✅ Staking - Holders stake to earn rewards
  • ✅ Treasury - Community-controlled funds
  • ✅ Keep Everything - Your token, holders, and liquidity stay the same

How It Works ​

Simple Process ​

  1. Enter your token address → System checks compatibility
  2. Register project → Deploys governance, staking, and treasury
  3. Update fee receiver → Route trading fees to staking (optional)

That's it. Your existing token now has full Levr capabilities.

Step-by-Step ​

1. Enter Token Address ​

Paste your Clanker token address:

Token Address: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0

The system automatically checks:

  • ✅ Is this a valid Clanker token?
  • ✅ Are you the token admin?
  • ✅ Is it already registered?
  • ✅ Who are the fee receiver admins?

2. Register Project ​

If you're the token admin and it's not registered:

Click Register Project → One transaction deploys:

  • Treasury contract
  • Governor contract
  • Staking contract
  • StakedToken contract

3. Update Fee Receiver (Optional) ​

If you're a fee receiver admin:

Click Update Fee Receiver → Routes trading fees to staking

Why: Enables automatic reward distribution to stakers

When to skip: If fees are already going where you want them

What Gets Created ​

Smart Contracts ​

Four new contracts for your token:

  • Treasury - Holds community funds (controlled by governance)
  • Governor - Manages proposals and voting
  • Staking - Handles staking and rewards
  • StakedToken - 1:1 receipt token for governance

Nothing Changes ​

Your existing token stays the same:

  • ✅ Same contract address
  • ✅ Same holders
  • ✅ Same supply
  • ✅ Same liquidity

New features are added on top, not replacing anything.

After Registration ​

Immediately Available ​

  • Staking - Holders can stake right away
  • Governance - System is initialized
  • Treasury - Empty initially (fund via transfers)

To Enable Full Features ​

  1. Fund Treasury - Transfer tokens to treasury or claim any airdrop
  2. Update Fee Receiver - Route fees to staking (if you're fee receiver admin)
  3. Start Governance - Factory owner starts first cycle
  4. Create Proposals - Community can begin voting

Two Actions Available ​

The interface has two buttons based on your permissions:

Register Project ​

  • Who: Token admin only
  • What: Deploys governance, staking, and treasury
  • When: Once per token

Update Fee Receiver ​

  • Who: Fee receiver admin only
  • What: Routes trading fees to staking contract
  • When: After registration (optional but recommended)

Auto-Detection

The interface automatically detects your permissions and enables the correct buttons.

Common Questions ​

I'm not the token admin. Can I register? No. Only the token admin can register. Contact them if you want to add Levr.

What if it's already registered? The interface shows the deployed contracts. You can use the project immediately.

Do I need to update the fee receiver? It's optional but recommended. Without it, trading fees won't automatically reward stakers.

What if I'm not a fee receiver admin? You can still register if you're token admin. But ask a fee receiver admin to update fees later.

What's the difference between token admin and fee receiver admin? Token admin controls the token contract. Fee receiver admin controls where trading fees go. Often the same person, but not always.

Do my holders need to do anything? No. Their tokens stay the same. They can start staking whenever they want.

Can I undo registration? No. Once registered, contracts are permanent. But your original token is unchanged.