Clanker Skill

Deploy ERC20 tokens on Base using the Clanker protocol with built-in Uniswap V4 liquidity pools.

Setup

1. Configuration

Create a config file at ~/.clawdbot/skills/clanker/config.json:

{
  "mainnet": {
    "rpc_url": "https://1rpc.io/base",
    "private_key": "YOUR_PRIVATE_KEY"
  },
  "testnet": {
    "rpc_url": "https://sepolia.base.org",
    "private_key": "YOUR_TESTNET_PRIVATE_KEY"
  }
}

Security: Never commit your private key to version control. Use environment variables or a separate config file outside the repo.

2. Get Testnet ETH

For Base Sepolia testing, get free ETH from:

• https://cloud.base.org/faucet
• https://sepoliafaucet.com

• MetaMask or similar wallet installed
• Social login (GitHub, Twitter, etc.)
• Limited to 1-2 requests per day

3. Install Dependencies (for deployment)

For token deployment, install web3 Python package:

pip install web3

For read-only operations, only curl, jq, and python3 are required.

Usage

Deploy a Token (Mainnet)

clanker.sh deploy "My Token" MYT 0.1

Deploys an ERC20 token with 0.1 ETH initial liquidity on Uniswap V4.

Check Deployment Status

clanker.sh status <txhash>

Check if a deployment transaction was successful.

Get Token Info

clanker.sh info <token-address>

Returns token name, symbol, total supply, and other details.

Find Tokens by Deployer

clanker.sh get-token <deployer-address>

Find all tokens deployed by a specific address.

Deploy to Testnet (Sepolia)

clanker.sh testnet-deploy "Test Token" TST

Deploy to Base Sepolia testnet for testing.

Using Testnet Network

All commands support --network testnet flag:

# Check testnet status
clanker.sh status 0x1234... --network testnet

# Get testnet token info
clanker.sh info 0xabcd... --network testnet

# Find testnet tokens by deployer
clanker.sh get-token 0xdef0... --network testnet

Commands Reference

Examples

# Deploy a meme coin
./clanker.sh deploy "Base Dog" BDOG 0.05

# Check if deployment succeeded
./clanker.sh status 0x1234...5678

# Get info about a known token
./clanker.sh info 0xabcd...1234

# Find who deployed a token
./clanker.sh get-token 0xdef0...9876

# Test on Sepolia
./clanker.sh testnet-deploy "Test Meme" TMEME
./clanker.sh status 0xtxhash... --network testnet

Testing Guide

Step 1: Set Up Testnet Config

# Create config with testnet private key
cat > ~/.clawdbot/skills/clanker/config.json << 'EOF'
{
  "testnet": {
    "rpc_url": "https://sepolia.base.org",
    "private_key": "YOUR_TESTNET_PRIVATE_KEY"
  }
}
EOF

Step 2: Get Testnet ETH

• Visit https://cloud.base.org/faucet
• Connect your wallet (MetaMask)
• Request test ETH (0.001-0.01 ETH should be enough)

• https://sepoliafaucet.com
• https://faucet.paradigm.xyz

Step 3: Deploy a Test Token

# Deploy on testnet with 0.001 ETH initial liquidity
./clanker.sh testnet-deploy "Test Token" TST

Or with initial liquidity:

./clanker.sh deploy "Test Token" TST 0.001 --network testnet

Step 4: Verify Deployment

• Check transaction status:

./clanker.sh status <txhash> --network testnet

• Get token info:

./clanker.sh info <token-address> --network testnet

• View on explorer:
• Open https://sepolia.basescan.org/tx/\
• View token contract at https://sepolia.basescan.org/token/\

Troubleshooting

Transaction failed?

• Check if you have enough ETH for gas
• Verify the Clanker factory contract is available on Sepolia
• Check network connectivity

• Try alternative faucets
• Wait 24 hours between requests
• Check if wallet is connected correctly

• Ensure key doesn't have "0x" prefix (or remove it if present)
• Check config file syntax is valid JSON

Test Results

Read-Only Operations ✅

Deployment ⚠️

Security Best Practices

• Never commit private keys to version control
• Use separate keys for testnet and mainnet
• Test on Sepolia first before mainnet deployment
• Verify contract addresses on official Clanker documentation
• Start with small ETH amounts for initial liquidity
• Monitor deployed tokens for unusual activity

Resources

• Official Website: https://clanker.world
• Documentation: https://docs.clanker.world
• GitHub: https://github.com/clanker-world
• Base Mainnet Explorer: https://basescan.org
• Base Sepolia Explorer: https://sepolia.basescan.org

Notes

• All deployments create tokens with built-in Uniswap V4 LP
• Initial LP ETH is required for liquidity bootstrapping
• Testnet deployments are free (no real funds, requires testnet ETH)
• Deployment may fail if Clanker contract is not available
• Check network connectivity if operations timeout