clawnch

Command-line interface for Clawnch - deploy tokens on Base with Uniswap V4 pools.

Installation

npm install -g clawnch

Quick Start

# Configure your private key
clawnch config --private-key YOUR_PRIVATE_KEY

# Deploy a new token
clawnch deploy --name "My Token" --symbol MYTKN

# Show contract addresses
clawnch addresses

# Get token info from chain
clawnch info 0xTokenAddress

Commands

Deploy

Deploy a new token on Base with Uniswap V4 pool:

# Basic deployment
clawnch deploy --name "My Token" --symbol MYTKN

# With image and description
clawnch deploy \
  --name "My Token" \
  --symbol MYTKN \
  --image "https://example.com/logo.png" \
  --description "A great token"

# Custom fee recipient
clawnch deploy --name "My Token" --symbol MYTKN --recipient 0x1234...

# 1% LP fee: 80% to deployer (in token by default), 20% protocol
# Change fee preference to receive in WETH instead:
clawnch deploy --name "My Token" --symbol MYTKN --fee-preference Paired

# With vault allocation
clawnch deploy \
  --name "My Token" \
  --symbol MYTKN \
  --vault-percent 10 \
  --vault-lockup 30 \
  --vault-recipient 0x1234...

# With dev buy (instant purchase at launch)
clawnch deploy \
  --name "My Token" \
  --symbol MYTKN \
  --dev-buy 0.1 \
  --dev-buy-recipient 0x1234...

# With vested dev buy (purchase with lockup + vesting)
clawnch deploy \
  --name "My Token" \
  --symbol MYTKN \
  --vested-dev-buy 0.5 \
  --vested-dev-buy-recipient 0x1234... \
  --vested-dev-buy-lockup 14 \
  --vested-dev-buy-vesting 90

# Deploy to mainnet
clawnch deploy --name "My Token" --symbol MYTKN --network mainnet

# Use custom RPC
clawnch deploy --name "My Token" --symbol MYTKN --rpc https://my-rpc.com

# JSON output
clawnch deploy --name "My Token" --symbol MYTKN --json

Info

Get token info directly from the blockchain:

# Get token info
clawnch info 0xTokenAddress

# Specify network
clawnch info 0xTokenAddress --network mainnet

# JSON output
clawnch info 0xTokenAddress --json

Fees

Check and manage trading fees:

# Check claimable fees (on-chain)
clawnch fees check 0xWalletAddress --tokens 0xToken1,0xToken2

# Check available fees (via API)
clawnch fees available 0xWalletAddress

# Check specific tokens via API
clawnch fees available 0xWalletAddress --tokens 0xToken1,0xToken2

Config

Manage CLI configuration:

# Show current configuration
clawnch config --show

# Set default network
clawnch config --network sepolia  # or mainnet

# Set private key
clawnch config --private-key 0x...

# Set custom RPC URLs
clawnch config --rpc-sepolia https://my-sepolia-rpc.com
clawnch config --rpc-mainnet https://my-mainnet-rpc.com

# Clear all configuration
clawnch config --clear

Configuration is stored in ~/.clawnch/config.json.

Addresses

Show contract addresses for a network:

# Show sepolia addresses (default)
clawnch addresses

# Show mainnet addresses
clawnch addresses --network mainnet

# JSON output
clawnch addresses --json

API Commands

These commands fetch data from the Clawnch API:

# List all tokens
clawnch tokens
clawnch tokens --symbol DOG --limit 10

# View launch history
clawnch launches
clawnch launches --agent "MyAgent" --source moltbook

# Get market statistics
clawnch stats

About

Show Clawnch information and links:

clawnch about

Deploy Options Reference

| Option | Description | Example | |--------|-------------|---------| | --name | Token name (required) | --name "My Token" | | --symbol | Token symbol (required) | --symbol MYTKN | | --image | Token image URL | --image "https://..." | | --description | Token description | --description "A great token" | | --recipient | Fee recipient address | --recipient 0x1234... | | --fee-preference | Fee token: Clawnch (default), Paired, Both | --fee-preference Paired | | --vault-percent | Vault allocation (1-90%) | --vault-percent 10 | | --vault-lockup | Vault lockup in days | --vault-lockup 30 | | --vault-vesting | Vault vesting in days | --vault-vesting 60 | | --vault-recipient | Vault recipient address | --vault-recipient 0x... | | --dev-buy | ETH amount for instant dev buy | --dev-buy 0.1 | | --dev-buy-recipient | Dev buy recipient address | --dev-buy-recipient 0x... | | --vested-dev-buy | ETH amount for vested dev buy | --vested-dev-buy 0.5 | | --vested-dev-buy-recipient | Vested dev buy recipient | --vested-dev-buy-recipient 0x... | | --vested-dev-buy-lockup | Lockup period in days (min 7) | --vested-dev-buy-lockup 14 | | --vested-dev-buy-vesting | Vesting period in days (30-365) | --vested-dev-buy-vesting 90 | | --no-vanity | Disable vanity address mining | --no-vanity | | --vanity-prefix | Custom vanity prefix (default: ccc) | --vanity-prefix dead | | --network | Network (sepolia/mainnet) | --network mainnet | | --rpc | Custom RPC URL | --rpc https://... | | --json | Output as JSON | --json |

Vanity Addresses

By default, all tokens are deployed with a vanity address starting with 0xccc. This makes Clawnch tokens easily identifiable on block explorers.

# Default: mine for 0xccc... address
clawnch deploy --name "My Token" --symbol MTK

# Custom prefix (e.g., 0xdead...)
clawnch deploy --name "My Token" --symbol MTK --vanity-prefix dead

# Disable vanity mining for faster deployment
clawnch deploy --name "My Token" --symbol MTK --no-vanity

Mining time depends on prefix length:

• ccc (3 chars): ~1 second average
• cccc (4 chars): ~5-10 seconds average
• ccccc (5 chars): ~1-2 minutes average

Dev Buy vs Vested Dev Buy

Dev Buy (--dev-buy): Instantly purchases tokens at launch using ETH. Tokens are sent directly to the recipient with no lockup.

Vested Dev Buy (--vested-dev-buy): Purchases tokens at launch but holds them in a vesting contract:

• Lockup period: Tokens are fully locked (minimum 7 days)
• Vesting period: After lockup, tokens vest linearly over time (30-365 days)
• Recipient can claim vested tokens as they become available

Configuration

Private Key

You can provide your private key in three ways (in order of precedence):

1. Command line flag: --private-key 0x...
2. Environment variable: CLAWNCH_PRIVATE_KEY=0x...
3. Config file: clawnch config --private-key 0x...

Network

Default network is sepolia. Change with:

clawnch config --network mainnet

Or per-command:

clawnch deploy --network mainnet ...

RPC URLs

Default RPCs are used if not configured:

• Sepolia: https://sepolia.base.org
• Mainnet: https://mainnet.base.org

Configure custom RPCs:

clawnch config --rpc-sepolia https://my-rpc.com
clawnch config --rpc-mainnet https://my-rpc.com

Or per-command:

clawnch deploy --rpc https://my-rpc.com ...

Environment Variables

• CLAWNCH_PRIVATE_KEY - Private key for deployments
• CLAWNCH_API_URL - Override the default API URL (default: https://clawn.ch)
• MOLTBOOK_KEY - Moltbook API key for authenticated API operations

JSON Output

All commands support --json flag for machine-readable output:

clawnch deploy --name "Test" --symbol TEST --json | jq '.tokenAddress'
clawnch info 0x... --json | jq '.symbol'

ClawnX — X/Twitter Commands

Interact with X/Twitter directly from the CLI. Requires X API credentials.

Setup

# Configure X credentials
clawnch x auth \
  --api-key YOUR_API_KEY \
  --api-secret YOUR_API_SECRET \
  --access-token YOUR_ACCESS_TOKEN \
  --access-token-secret YOUR_ACCESS_TOKEN_SECRET \
  --bearer-token YOUR_BEARER_TOKEN

# Or use environment variables:
# X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET, X_BEARER_TOKEN

# Show current X credentials
clawnch x auth --show

Tweet Commands

# Post a tweet
clawnch x tweet post "Just launched \$MYTKN on @clawnch!"

# Reply to a tweet
clawnch x tweet reply 1234567890 "nice!"

# Quote tweet
clawnch x tweet quote 1234567890 "check this out"

# Get a tweet
clawnch x tweet get https://x.com/user/status/1234567890

# Delete a tweet
clawnch x tweet delete 1234567890

# Search tweets
clawnch x tweet search "\$MYTKN"

# Get tweet metrics
clawnch x tweet metrics 1234567890

# Post a thread (pipe-separated tweets)
clawnch x tweet thread "1/ First tweet|2/ Second tweet|3/ Third tweet"

# Get conversation/replies
clawnch x tweet conversation 1234567890

# Get quote tweets, likers, retweeters
clawnch x tweet quotes 1234567890
clawnch x tweet likers 1234567890
clawnch x tweet retweeters 1234567890

Engagement

clawnch x like 1234567890
clawnch x unlike 1234567890
clawnch x retweet 1234567890
clawnch x unretweet 1234567890

User Commands

clawnch x user get clawnch
clawnch x user timeline clawnch
clawnch x user followers clawnch
clawnch x user following clawnch
clawnch x user search "crypto agents"
clawnch x user likes clawnch

Relationship Management

clawnch x follow clawnch
clawnch x unfollow clawnch
clawnch x block spammer
clawnch x unblock spammer
clawnch x mute noisy
clawnch x unmute noisy

Authenticated User

clawnch x me profile
clawnch x me home
clawnch x me mentions
clawnch x me bookmarks
clawnch x me bookmark 1234567890
clawnch x me unbookmark 1234567890
clawnch x me blocked
clawnch x me muted

Lists

clawnch x list create "Agents" --description "AI agents on Base"
clawnch x list get LIST_ID
clawnch x list tweets LIST_ID
clawnch x list members LIST_ID
clawnch x list add LIST_ID clawnch
clawnch x list remove LIST_ID clawnch
clawnch x list delete LIST_ID

Direct Messages

clawnch x dm send friend "hey, check out \$MYTKN"
clawnch x dm inbox

All X commands support --json for machine-readable output.

X Environment Variables

• X_API_KEY - Consumer Key (API Key)
• X_API_SECRET - Consumer Secret (API Secret)
• X_ACCESS_TOKEN - OAuth 1.0a Access Token
• X_ACCESS_TOKEN_SECRET - OAuth 1.0a Access Token Secret
• X_BEARER_TOKEN - Bearer Token for read-only endpoints

Related

• Clawnch Website
• Agent Skill Documentation
• Technical Documentation
• OpenAPI Specification
• @clawnch/sdk - TypeScript SDK

License

MIT