AboutCheck-in System

CastDex Clanker Token Factory - User Guide

The CastDex Clanker Token Factory provides a seamless way to deploy tokens on Base using the Clanker v4.0.0 protocol, with optional community listing services. This guide covers everything you need to know about creating, deploying, and listing your tokens.

Table of Contents

  1. Overview

  2. Getting Started

  3. Deploying Clanker Tokens

  4. Community Listings

  5. Browse & Discovery

  6. Token Tracking

  7. Creator Rewards

  8. Troubleshooting

  9. FAQ

Overview

What is the CastDex Clanker Factory?

The CastDex Clanker Factory is an integrated platform that combines:

  • Free Token Deployment: Deploy tokens instantly on Base using Clanker v4.0.0

  • Community Listings: Paid directory service for enhanced token discovery

  • Token Tracking: Monitor your deployed tokens and their performance

  • Creator Rewards: Earn 80% of all trading fees from your tokens

Key Features

✅ Instant Deployment - Deploy tokens in minutes, not hours ✅ No Technical Knowledge Required - User-friendly interface ✅ Automatic Liquidity - Instant Uniswap V3 integration ✅ Creator Rewards - 80% of trading fees forever ✅ Community Discovery - Optional paid listing service ✅ Real-time Tracking - Monitor deployment status and trading activity

Getting Started

Prerequisites

Before you begin, ensure you have:

  1. Web3 Wallet: MetaMask, Coinbase Wallet, or any WalletConnect-compatible wallet

  2. Base Network: Add Base network to your wallet (instructions)

  3. ETH on Base: For gas fees and initial market cap

  4. $CASTDEX Tokens: Only required for community listings (5M $CASTDEX)

Connecting Your Wallet

  1. Navigate to the CastDex Clanker Factory

  2. Click "Connect Wallet" in the top-right corner

  3. Select your preferred wallet from the options

  4. Approve the connection request in your wallet

  5. Ensure you're connected to the Base network

Deploying Clanker Tokens

Step 1: Access the Token Factory

  1. Open the CastDex app

  2. Navigate to "New Listings" section

  3. Click the "New Listing" tab

  4. Select "Deploy Clanker Token"

Step 2: Fill Token Information

Basic Information (Required)

  • Token Name: Full name of your token (e.g., "My Awesome Token")

    • Maximum 50 characters

    • This will be displayed everywhere your token appears

  • Symbol: Trading ticker symbol (e.g., "MAT")

    • Maximum 10 characters

    • Automatically converted to uppercase

    • Must be unique on the platform

  • Description: Detailed explanation of your token

    • Maximum 500 characters

    • Describe the purpose, utility, and vision

    • This helps users understand your project

Token Image (Optional)

  • Supported Formats: JPG, PNG, GIF, WebP

  • Maximum Size: 1MB (Clanker requirement)

  • Recommended: 400x400 pixels or larger, square aspect ratio

  • Note: Images enhance token recognition and professional appearance

Social Media Links (Optional)

Add links to build credibility and community:

  • Website: Your project's official website

  • Twitter/X: Official Twitter account

  • Telegram: Community chat or announcements channel

  • Discord: Community server

  • Farcaster: Farcaster profile or channel

Step 3: Configure Pool Settings

Initial Market Cap (Required)

Choose your starting liquidity amount:

  • 1 ETH: Suitable for small, experimental tokens

  • 5 ETH: Good for community projects with moderate expectations

  • 10 ETH: Recommended for serious projects (default)

  • 25 ETH: For projects with strong backing

  • 50 ETH: For major launches with high liquidity needs

Important: This ETH comes from the Clanker protocol, not your wallet.

Paired Token

  • Fixed: Your token will always be paired with WETH (Wrapped Ether)

  • Automatic: Uniswap V3 pool created automatically

  • Trading: Enables immediate trading upon deployment

Step 4: Vault Settings (Optional)

Control token release schedule:

Vault Percentage

  • Range: 0-30% of total token supply

  • Purpose: Lock tokens to prevent immediate selling

  • Benefit: Increases holder confidence and price stability

Lockup Duration

  • Range: 1-365 days

  • Default: 30 days

  • Effect: Locked tokens cannot be sold until duration expires

Step 5: Audit Reports (Optional)

If your token has been audited:

  • Add Audit URLs: Links to professional security audits

  • Multiple Reports: You can add several audit reports

  • Credibility: Audits increase trust and adoption

  • Format: Must be valid HTTPS URLs

Step 6: Deploy Your Token

  1. Review Summary: Check all details in the deployment summary

  2. Wallet Connection: Ensure your wallet is connected

  3. Gas Preparation: Have sufficient ETH for gas fees (~$0.005-$0.01)

  4. Click Deploy: Press "Deploy Token via Clanker v4"

  5. Confirm Transaction: Approve the transaction in your wallet

Step 7: Monitor Deployment

After clicking deploy, you'll see real-time status updates:

  1. Uploading Image: If you added an image, it's uploaded first

  2. Processing Social URLs: Social media links are formatted

  3. Generating Request: Unique deployment key created

  4. Deploying: Request sent to Clanker v4 API

  5. Monitoring: System watches for blockchain confirmation

Community Listings

What are Community Listings?

Community Listings are premium directory entries that provide enhanced visibility for your tokens. While Clanker deployment is free, Community Listings require a 5M $CASTDEX payment.

Benefits of Community Listings

✅ Enhanced Discovery: Featured in community directory ✅ Search Priority: Higher visibility in search results ✅ Professional Presentation: Detailed information display ✅ Community Trust: Verified and paid listings signal legitimacy ✅ Long-term Visibility: Permanent directory presence

How to Create a Community Listing

Option 1: During Clanker Deployment

  1. Deploy Clanker Token (follow steps above)

  2. Success Modal Appears with deployment details

  3. Click "Create Community Listing" in the success modal

  4. Form Auto-Populates with your token information

  5. Add Missing Details (if any)

  6. Pay 5M $CASTDEX to complete listing

Option 2: From Browse Listings

  1. Browse Existing Listings in the directory

  2. Find Your Token (shows as "Pending" if not yet listed)

  3. Click "List Now!" button on your token card

  4. Form Auto-Populates with available information

  5. Complete Payment of 5M $CASTDEX

Option 3: Manual Community Listing

  1. Navigate to New Listings

  2. Select "Create Community Listing"

  3. Fill Complete Form manually:

    • All token information

    • Contract address (must be deployed)

    • Blockchain and DEX platform

    • Social media links

  4. Pay 5M $CASTDEX to submit

Payment Process

  1. 5M $CASTDEX Required: Exact amount must be sent

  2. Payment Address: Sent to official CastDex treasury

  3. Transaction Verification: Payment validated on-chain

  4. Instant Listing: Directory updated immediately upon confirmation

  5. Payment Receipt: Transaction hash recorded for verification

Browse & Discovery

Browsing All Listings

The Browse tab shows all tokens in the system:

Filter Options

  • All Blockchains: View tokens across all supported networks

  • Specific Blockchain: Filter by Ethereum, Base, BSC, Arbitrum, Polygon, Solana

  • DEX Platform: Filter by Uniswap, PancakeSwap, SushiSwap, etc.

  • Listing Type:

    • All: Both Clanker and Community listings

    • Clanker: Only Clanker-deployed tokens

    • Community: Only paid community listings

Search Functionality

  • Real-time Search: Results update as you type

  • Search Fields: Name, symbol, and description

  • Minimum Length: 2 characters required

  • Cross-Platform: Searches across all blockchains

Token Cards

Each token displays:

  • Token Image: Logo or default placeholder

  • Name & Symbol: Full name and trading ticker

  • Description: Brief project description

  • Blockchain: Network where token is deployed

  • Listing Type: Clanker or Community badge

  • Vault Info: If tokens are locked and percentage

  • Creation Date: When token was listed

Action Buttons

Depending on token status:

  • Track Token: For deployed tokens with contract addresses

  • List Now!: For pending tokens without community listings

  • View Details: Additional information about the token

Token Tracking

Local Tracking System

All your deployed Clankers are automatically tracked:

Automatic Tracking Features

  • Deployment Status: Real-time monitoring of deployment progress

  • Contract Verification: Confirms when tokens are live on blockchain

  • Trading Detection: Identifies when tokens start trading

  • Price Monitoring: Links to DexScreener and GeckoTerminal

  • Performance Metrics: Trading volume and price changes

Tracking Dashboard

Access your deployed tokens:

  1. Navigate to Clanker Factory: /clanker route

  2. View Deployed Tokens: Separate section for your tokens

  3. Filter by Status: Pending, Deployed, Trading

  4. Export Data: Download your deployment history

  5. Import History: Restore tracking data across devices

Manual Token Addition

Add existing tokens to your tracking:

  1. Token Contract Address: Paste the contract address

  2. Network Selection: Choose the correct blockchain

  3. Automatic Detection: System fetches token information

  4. Add to Dashboard: Token appears in your tracking list

Creator Rewards

How Creator Rewards Work

When you deploy a token through CastDex Clanker Factory:

Reward Structure

  • 80% Creator Rewards: You receive 80% of all trading fees

  • 20% Protocol Fee: Clanker protocol receives 20%

  • Lifetime Earnings: Rewards continue forever

  • Automatic Distribution: No claiming required

Trading Fees

  • Source: Generated from Uniswap V3 trading activity

  • Fee Tiers: Typically 0.3% to 1% per trade

  • Volume Dependent: More trading = more rewards

  • Compound Growth: Successful tokens generate increasing fees

Maximizing Rewards

To increase your creator rewards:

  1. Community Building: Grow your token's user base

  2. Marketing: Promote your token across social platforms

  3. Utility Development: Add real-world use cases

  4. Partnerships: Collaborate with other projects

  5. Regular Updates: Keep community engaged with progress

Reward Tracking

Monitor your earnings:

  • DexScreener: View trading volume and fees

  • GeckoTerminal: Track price and volume metrics

  • BaseScan: Verify transactions and fee distributions

  • Portfolio Trackers: Use tools like DeBank or Zapper

Troubleshooting

Common Issues and Solutions

Wallet Connection Problems

Issue: Cannot connect wallet Solution:

  • Ensure wallet extension is installed and updated

  • Check that you're on the Base network

  • Try refreshing the page and reconnecting

  • Clear browser cache and cookies

Issue: Wrong network detected Solution:

  • Switch to Base network in your wallet

  • Add Base network if not present (guide)

  • Refresh page after network change

Deployment Issues

Issue: "Insufficient funds" error Solution:

  • Ensure you have enough ETH for gas fees

  • Gas fees typically range from $0.005-$0.01

  • Try during off-peak hours for lower fees

Issue: Transaction failed Solution:

  • Increase gas limit in wallet settings

  • Check Base network status

  • Wait for network congestion to clear

  • Try redeploying with higher gas price

Issue: Image upload failed Solution:

  • Ensure image is under 1MB

  • Use supported formats: JPG, PNG, GIF, WebP

  • Check internet connection stability

  • Try resizing image if still failing

Token Not Appearing

Issue: Token deployed but not visible Solution:

  • Wait 5-10 minutes for blockchain confirmation

  • Check BaseScan with your wallet address

  • Verify transaction was successful

  • Contact support if issue persists

Community Listing Payment

Issue: Payment not recognized Solution:

  • Verify you sent exactly 5M $CASTDEX

  • Check transaction was successful on BaseScan

  • Ensure payment went to correct address

  • Wait 10-15 minutes for confirmation

Getting Help

If you continue experiencing issues:

  1. Documentation: Check this guide thoroughly

  2. X/Twitter Support: Tweet @_castdex for help

  3. Email Support: Contact [email protected]

  4. Include Details: Always provide transaction hashes and wallet address

FAQ

General Questions

Q: What is Clanker? A: Clanker is a protocol that enables instant token deployment on Base with automatic Uniswap V3 liquidity and creator rewards.

Q: How much does it cost to deploy a token? A: Token deployment is free except for gas fees (~$5-20). Community listings require 5M $CASTDEX.

Q: Which blockchains are supported? A: Clanker tokens deploy on Base. Community listings support Ethereum, Base, BSC, Arbitrum, Polygon, and Solana.

Q: Do I need coding knowledge? A: No technical knowledge required. The interface is designed for non-technical users.

Token Deployment

Q: How long does deployment take? A: Typically 2-5 minutes from submission to live trading on Uniswap.

Q: Can I change token details after deployment? A: No, blockchain deployments are permanent. Double-check all information before deploying.

Q: What happens if deployment fails? A: You only lose gas fees. No other costs are incurred for failed deployments.

Q: Can I deploy multiple tokens? A: Yes, there's no limit on the number of tokens you can deploy.

Creator Rewards

Q: When do I start earning rewards? A: Immediately when trading begins. Rewards are distributed automatically with each trade.

Q: How are rewards calculated? A: You receive 80% of trading fees generated by your token's Uniswap pool.

Q: Do I need to claim rewards? A: No, rewards are distributed automatically to your wallet address.

Q: What if my token doesn't get traded? A: No trading = no fees = no rewards. Focus on building community and utility.

Community Listings

Q: What's the difference between Clanker and Community listings? A: Clanker listings are free deployment records. Community listings are paid directory entries with enhanced visibility.

Q: How do I get $CASTDEX tokens? A: Purchase on Uniswap or other DEXs where $CASTDEX is traded.

Q: Is the 5M $CASTDEX fee refundable? A: No, this is a permanent payment for directory listing services.

Q: Can I update my community listing? A: Contact support for updates. Some changes may be possible for listed tokens.

Technical Questions

Q: What token standard is used? A: All Clanker tokens are ERC-20 standard on Base network.

Q: Can I add custom token features? A: No, Clanker creates standard ERC-20 tokens. For custom features, use other deployment methods.

Q: Is my token ownership transferable? A: Creator rewards are tied to the deploying wallet address and cannot be transferred.

Q: What happens to locked vault tokens? A: They cannot be traded until the lockup period expires, then become tradeable normally.

Additional Resources

Official Links

External Resources

Trading & Analytics

Last Updated: July 19, 2025 Version: 1.0

For the most up-to-date information, always refer to the official CastDex documentation and announcements.

PreviousCastDex Voting API Documentation

Last updated