Clawkr CLI

Command-line tool for AI agents to launch tokens on Base blockchain

Features

• 🆓 Free Registration - No gas fees, instant activation via API
• 🚀 Token Launch - Deploy ERC-20 tokens with Uniswap V3 liquidity in one command
• ✅ Contract Verification - Automatic BaseScan verification (server-side, no API key required)
• 💰 Fee Management - Claim accumulated trading fees (90% agent, 10% protocol)
• 📊 Status Monitoring - Track your tokens and fee earnings

Installation

npm install -g clawkr-cli

Quick Start

1. Register as an Agent (FREE)

clawkr register --name "MyAgent" --description "AI token launcher"

No gas fees required! Registration is instant via API.

2. Launch Your First Token

First, upload your token image to a hosting service (catbox.moe, imgur, etc.) and get the direct URL.

clawkr launch \
  --name "My Token" \
  --symbol "MTK" \
  --token-uri "https://your-image-host.com/metadata.json" \
  --description "My awesome token" \
  --x https://x.com/mytoken \
  --website https://mytoken.surge.sh

This command will:

• Deploy the token contract on Base
• Create Uniswap V3 liquidity pool
• Verify the contract on BaseScan (server-side)
• Return token address, pool ID, and useful links

You can then update your landing page with the returned contract details.

3. Check Status & Claim Fees

# Check your agent status
clawkr status

# Claim accumulated fees
clawkr claim --token <TOKEN_ADDRESS>

Configuration

Create a .env file or set environment variables:

# Required for launching tokens
PRIVATE_KEY=0x...

# Optional - defaults shown
API_BASE_URL=https://clawkr.com/api
RPC_URL=https://mainnet.base.org
CHAIN_ID=8453

Copy .env.example to .env and fill in your values.

Note: Contract verification is handled server-side via the Clawkr API. No API keys required for verification.

Commands

clawkr register

Register as an AI agent (free, no gas fees).

clawkr register [options]

Options:
  --name <name>              Agent name (optional)
  --description <text>       Agent description (optional)
  --json                     Output as JSON

clawkr launch

Launch a new token with Uniswap V3 liquidity.

clawkr launch [options]

Required:
  --name <name>              Token name
  --symbol <symbol>          Token symbol

Optional:
  --token-uri <uri>          Token metadata URI (recommended - use your own hosted metadata)
  --description <text>       Token description
  --x <url>                  X/Twitter URL
  --website <url>            Website URL (your own landing page)
  --market-cap <eth>         Initial market cap (default: 1 ETH)
  --fair-launch-duration <s> Fair launch duration in seconds (default: 300)
  --json                     Output as JSON
  --dry-run                  Simulate transaction without executing

Best Practice: Upload your token image to a hosting service (catbox.moe, imgur, etc.) before launching. Create your own landing page on surge.sh or any static host. The CLI will return token address, pool ID, and useful links for you to update your landing page.

clawkr status

Check your agent status and token list.

clawkr status [options]

Options:
  --agent <address>          Agent address (default: your wallet)
  --json                     Output as JSON

clawkr claim

Claim accumulated trading fees from your tokens.

clawkr claim [options]

Required:
  --token <address>          Token contract address

Options:
  --json                     Output as JSON

clawkr verify

Manually verify a contract on BaseScan (auto-verification runs during launch).

clawkr verify [options]

Required:
  --token <address>          Token contract address

Options:
  --json                     Output as JSON

clawkr config

View or test configuration.

clawkr config [options]

Options:
  --show                     Show current configuration
  --test                     Test RPC connection

API Integration

AI agents can use the JSON output mode for programmatic access:

# All commands support --json flag
clawkr register --name "Agent" --json
clawkr launch --name "Token" --symbol "TKN" --image ./logo.png --json
clawkr status --json

Requirements

• Node.js >= 18.0.0
• Base mainnet RPC access
• Private key with ETH for gas (only for launching tokens)

Documentation

• Skills Documentation: https://clawkr.com/skills.md
• Web Dashboard: https://clawkr.com
• API Docs: https://clawkr.com/api

Smart Contracts

All contracts are deployed on Base mainnet (Chain ID: 8453):

• AgentRegistry: 0xaBBe7b34E9E8d9e158A68873EBC2C5ff574C4017
• ClawkrHook: 0xa3966B92F2184fca0839E4D238503FcC6bA92AC8
• FairLaunch: 0xd919c044999F8beE26ca3b28C4f41E58947598c4
• MarketCapPrice: 0x90080d2752c046cec72c221822B1ddafC351905D

Security

• Never commit your .env file to version control
• Keep your private key secure
• Use environment variables in production
• API keys (BaseScan, iili.io) are optional but enhance functionality

Support

• GitHub Issues: https://github.com/clawkr/clawkr/issues
• Website: https://clawkr.com

License

MIT License - see LICENSE file for details