clawdpad 1.0.0

package/README.md

@@ -0,0 +1,125 @@
+# Clawdpad CLI
+
+> One-command token launch for AI agents 🦞
+
+```bash
+npx clawdpad launch "Doge AI" "DOGEAI" --supply 1000000000
+```
+
+## Installation
+
+```bash
+# Use directly with npx (no install needed)
+npx clawdpad launch "MyToken" "MTK"
+
+# Or install globally
+npm install -g clawdpad
+clawdpad launch "MyToken" "MTK"
+```
+
+## Commands
+
+### Launch a Token
+
+```bash
+# Basic launch
+clawdpad launch "Token Name" "SYMBOL"
+
+# With options
+clawdpad launch "Doge AI" "DOGEAI" \
+  --supply 1000000000 \
+  --description "The smartest doge on Base" \
+  --website "https://dogeai.xyz" \
+  --twitter "@dogeai" \
+  --wallet 0xYourAddress
+
+# Dry run (test without launching)
+clawdpad launch "Test Token" "TEST" --dry-run
+```
+
+### List Recent Tokens
+
+```bash
+clawdpad list
+clawdpad list --limit 20
+```
+
+### Check Trust Score
+
+```bash
+clawdpad trust 0xYourWalletAddress
+```
+
+### Interactive Mode
+
+```bash
+clawdpad interactive
+# or
+clawdpad i
+```
+
+### Get Info
+
+```bash
+clawdpad info
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-s, --supply <amount>` | Total supply (default: 1,000,000,000) |
+| `-d, --description <text>` | Token description |
+| `-w, --website <url>` | Website URL |
+| `-t, --twitter <handle>` | Twitter/X handle |
+| `-i, --image <url>` | Token image URL |
+| `--wallet <address>` | Creator wallet (receives tokens) |
+| `--dry-run` | Simulate without launching |
+
+## Payment
+
+Launching a token costs **$1 USDC** via x402 protocol.
+
+When you run the launch command:
+1. You'll receive payment instructions
+2. Send $1 USDC to the treasury on Base
+3. Re-run the command with payment proof
+
+## For AI Agents
+
+Example integration:
+
+```javascript
+import { exec } from 'child_process';
+
+async function launchToken(name, symbol, wallet) {
+  return new Promise((resolve, reject) => {
+    exec(
+      `npx clawdpad launch "${name}" "${symbol}" --wallet ${wallet}`,
+      (error, stdout, stderr) => {
+        if (error) reject(error);
+        else resolve(stdout);
+      }
+    );
+  });
+}
+
+// Usage
+await launchToken("My AI Token", "MYAI", "0x...");
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `CLAWDPAD_API_URL` | Custom API URL (default: https://www.clawdpad.ai/api) |
+
+## Links
+
+- Website: https://www.clawdpad.ai
+- Token: $CLAWDPAD on Base
+- Twitter: @clawdpad
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,464 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const viem_1 = require("viem");
+const chains_1 = require("viem/chains");
+const accounts_1 = require("viem/accounts");
+const API_URL = process.env.CLAWDPAD_API_URL || 'https://www.clawdpad.ai/api';
+const CONFIG_DIR = path.join(os.homedir(), '.clawdpad');
+const WALLET_FILE = path.join(CONFIG_DIR, 'wallet.json');
+const LAUNCHES_FILE = path.join(CONFIG_DIR, 'launches.json');
+// Clanker API (for token deployment)
+const CLANKER_API = 'https://www.clanker.world/api/v1';
+const program = new commander_1.Command();
+// ASCII Art Banner
+const banner = `
+${chalk_1.default.cyan('  ██████╗██╗      █████╗ ██╗    ██╗██████╗ ██████╗  █████╗ ██████╗ ')}
+${chalk_1.default.cyan(' ██╔════╝██║     ██╔══██╗██║    ██║██╔══██╗██╔══██╗██╔══██╗██╔══██╗')}
+${chalk_1.default.cyan(' ██║     ██║     ███████║██║ █╗ ██║██║  ██║██████╔╝███████║██║  ██║')}
+${chalk_1.default.cyan(' ██║     ██║     ██╔══██║██║███╗██║██║  ██║██╔═══╝ ██╔══██║██║  ██║')}
+${chalk_1.default.cyan(' ╚██████╗███████╗██║  ██║╚███╔███╔╝██████╔╝██║     ██║  ██║██████╔╝')}
+${chalk_1.default.cyan('  ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═════╝ ╚═╝     ╚═╝  ╚═╝╚═════╝ ')}
+${chalk_1.default.gray('                 one command. your token. live on base.')}
+`;
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+function loadWallet() {
+    if (!fs.existsSync(WALLET_FILE)) {
+        return null;
+    }
+    try {
+        const data = fs.readFileSync(WALLET_FILE, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+function createWallet() {
+    ensureConfigDir();
+    const privateKey = (0, accounts_1.generatePrivateKey)();
+    const account = (0, accounts_1.privateKeyToAccount)(privateKey);
+    const wallet = {
+        address: account.address,
+        privateKey: privateKey,
+        createdAt: new Date().toISOString(),
+    };
+    fs.writeFileSync(WALLET_FILE, JSON.stringify(wallet, null, 2), { mode: 0o600 });
+    return wallet;
+}
+function getOrCreateWallet() {
+    const existing = loadWallet();
+    if (existing) {
+        return { wallet: existing, isNew: false };
+    }
+    return { wallet: createWallet(), isNew: true };
+}
+function loadLaunches() {
+    if (!fs.existsSync(LAUNCHES_FILE)) {
+        return [];
+    }
+    try {
+        const data = fs.readFileSync(LAUNCHES_FILE, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return [];
+    }
+}
+function saveLaunch(launch) {
+    ensureConfigDir();
+    const launches = loadLaunches();
+    launches.push(launch);
+    fs.writeFileSync(LAUNCHES_FILE, JSON.stringify(launches, null, 2));
+}
+// ============ Image Upload ============
+async function uploadImage(imagePath) {
+    // Read image file
+    const imageBuffer = fs.readFileSync(imagePath);
+    const base64 = imageBuffer.toString('base64');
+    const ext = path.extname(imagePath).toLowerCase();
+    const mimeType = ext === '.png' ? 'image/png' :
+        ext === '.gif' ? 'image/gif' :
+            ext === '.webp' ? 'image/webp' : 'image/jpeg';
+    // Upload to Clawdpad (which uses imgbb or similar)
+    const response = await (0, node_fetch_1.default)(`${API_URL}/upload`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            image: `data:${mimeType};base64,${base64}`,
+            name: path.basename(imagePath, ext),
+        }),
+    });
+    const result = await response.json();
+    if (!result.success || !result.url) {
+        throw new Error(result.error || 'Image upload failed');
+    }
+    return result.url;
+}
+// ============ Token Launch via Clanker ============
+async function launchViaClanker(params) {
+    // For now, use Clawdpad API which proxies to Clanker
+    // This allows us to sponsor gas and handle the complexity
+    const response = await (0, node_fetch_1.default)(`${API_URL}/launch`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            name: params.name,
+            symbol: params.symbol,
+            description: params.description,
+            image: params.image,
+            website: params.website,
+            creatorWallet: params.wallet.address,
+            testnet: params.testnet,
+        }),
+    });
+    const result = await response.json();
+    if (!response.ok) {
+        throw new Error(result.error || 'Launch failed');
+    }
+    const chainName = params.testnet ? 'base-sepolia' : 'base';
+    const explorerBase = params.testnet ? 'https://sepolia.basescan.org' : 'https://basescan.org';
+    return {
+        tokenAddress: result.token?.address || result.tokenAddress || '0x...',
+        transactionHash: result.transactionHash || result.tx_hash || '0x...',
+        clankerUrl: `https://clanker.world/clanker/${result.token?.address || result.tokenAddress}`,
+        explorerUrl: `${explorerBase}/token/${result.token?.address || result.tokenAddress}`,
+    };
+}
+// ============ CLI Commands ============
+program
+    .name('clawdpad')
+    .description('Launch memecoins on Base — one command, no gas, earn fees')
+    .version('1.0.0');
+// Main launch command
+program
+    .option('--name <name>', 'Token name')
+    .option('--symbol <symbol>', 'Token symbol')
+    .option('--description <text>', 'Token description')
+    .option('--image <path>', 'Path to image (PNG/JPG/GIF/WebP, max 5MB)')
+    .option('--website <url>', 'Website URL (e.g., Moltbook post)')
+    .option('--testnet', 'Use Base Sepolia testnet')
+    .option('--json', 'Output JSON (machine-readable)')
+    .action(async (options) => {
+    const jsonMode = options.json;
+    if (!jsonMode) {
+        console.log(banner);
+    }
+    // Check if this is a subcommand or launch
+    if (!options.name && !options.symbol) {
+        if (!jsonMode) {
+            program.help();
+        }
+        return;
+    }
+    // Validate required fields
+    if (!options.name || !options.symbol) {
+        const error = { success: false, error: 'Missing required fields: --name and --symbol' };
+        if (jsonMode) {
+            console.log(JSON.stringify(error));
+            process.exit(1);
+        }
+        console.error(chalk_1.default.red('Error: --name and --symbol are required'));
+        process.exit(1);
+    }
+    const spinner = jsonMode ? null : (0, ora_1.default)('Preparing launch...').start();
+    try {
+        // Get or create wallet
+        const { wallet, isNew } = getOrCreateWallet();
+        if (spinner) {
+            spinner.text = isNew ? 'Created new wallet...' : 'Using existing wallet...';
+        }
+        // Upload image if provided
+        let imageUrl = '';
+        if (options.image) {
+            if (spinner)
+                spinner.text = 'Uploading image...';
+            if (options.image.startsWith('http')) {
+                imageUrl = options.image;
+            }
+            else if (fs.existsSync(options.image)) {
+                imageUrl = await uploadImage(options.image);
+            }
+            else {
+                throw new Error(`Image not found: ${options.image}`);
+            }
+        }
+        // Launch token
+        if (spinner)
+            spinner.text = 'Launching token on Base...';
+        const result = await launchViaClanker({
+            name: options.name,
+            symbol: options.symbol,
+            description: options.description || `${options.name} - Launched via Clawdpad`,
+            image: imageUrl,
+            website: options.website,
+            wallet,
+            testnet: options.testnet,
+        });
+        // Save launch record
+        saveLaunch({
+            tokenAddress: result.tokenAddress,
+            name: options.name,
+            symbol: options.symbol,
+            network: options.testnet ? 'base-sepolia' : 'base',
+            transactionHash: result.transactionHash,
+            launchedAt: new Date().toISOString(),
+            website: options.website,
+        });
+        if (spinner)
+            spinner.succeed('Token launched!');
+        // Output
+        const output = {
+            success: true,
+            tokenAddress: result.tokenAddress,
+            transactionHash: result.transactionHash,
+            name: options.name,
+            symbol: options.symbol,
+            network: options.testnet ? 'Base Sepolia' : 'Base',
+            explorer: result.explorerUrl,
+            clanker: result.clankerUrl,
+            wallet: wallet.address,
+            ...(isNew ? { privateKey: wallet.privateKey } : {}),
+        };
+        if (jsonMode) {
+            console.log(JSON.stringify(output, null, 2));
+        }
+        else {
+            console.log('\n' + chalk_1.default.green('✓ Token launched successfully!'));
+            console.log(chalk_1.default.gray('─'.repeat(60)));
+            console.log(`  ${chalk_1.default.gray('Name:')}     ${chalk_1.default.white(options.name)}`);
+            console.log(`  ${chalk_1.default.gray('Symbol:')}   ${chalk_1.default.cyan(options.symbol)}`);
+            console.log(`  ${chalk_1.default.gray('Network:')}  ${chalk_1.default.blue(options.testnet ? 'Base Sepolia' : 'Base')}`);
+            console.log(`  ${chalk_1.default.gray('Address:')}  ${chalk_1.default.yellow(result.tokenAddress)}`);
+            console.log(`  ${chalk_1.default.gray('Wallet:')}   ${chalk_1.default.gray(wallet.address)}`);
+            console.log(chalk_1.default.gray('─'.repeat(60)));
+            console.log(`\n  ${chalk_1.default.white('View on Basescan:')}`);
+            console.log(`  ${chalk_1.default.cyan(result.explorerUrl)}`);
+            console.log(`\n  ${chalk_1.default.white('View on Clanker:')}`);
+            console.log(`  ${chalk_1.default.cyan(result.clankerUrl)}`);
+            if (isNew) {
+                console.log('\n' + chalk_1.default.yellow('⚠️  NEW WALLET CREATED'));
+                console.log(chalk_1.default.gray('  Save this private key — it won\'t be shown again:'));
+                console.log(`  ${chalk_1.default.red(wallet.privateKey)}`);
+            }
+            console.log('\n' + chalk_1.default.gray('Earn 80% of all trading fees! Check with: clawdpad fees'));
+        }
+    }
+    catch (error) {
+        if (spinner)
+            spinner.fail('Launch failed');
+        const errorOutput = { success: false, error: error.message };
+        if (jsonMode) {
+            console.log(JSON.stringify(errorOutput));
+        }
+        else {
+            console.error(chalk_1.default.red(`\nError: ${error.message}`));
+        }
+        process.exit(1);
+    }
+});
+// Wallet command
+program
+    .command('wallet')
+    .description('Show wallet address and balance')
+    .option('--json', 'Output JSON')
+    .action(async (options) => {
+    const { wallet, isNew } = getOrCreateWallet();
+    // Get balance
+    const client = (0, viem_1.createPublicClient)({
+        chain: chains_1.base,
+        transport: (0, viem_1.http)(),
+    });
+    const balance = await client.getBalance({ address: wallet.address });
+    const output = {
+        address: wallet.address,
+        balance: (0, viem_1.formatEther)(balance),
+        balanceWei: balance.toString(),
+        isNew,
+    };
+    if (options.json) {
+        console.log(JSON.stringify(output, null, 2));
+    }
+    else {
+        console.log(banner);
+        console.log(chalk_1.default.white('Wallet:'));
+        console.log(chalk_1.default.gray('─'.repeat(50)));
+        console.log(`  Address: ${chalk_1.default.cyan(wallet.address)}`);
+        console.log(`  Balance: ${chalk_1.default.green((0, viem_1.formatEther)(balance))} ETH`);
+        if (isNew) {
+            console.log(chalk_1.default.yellow('\n  ⚠️  New wallet created'));
+            console.log(chalk_1.default.gray(`  Private key saved to: ${WALLET_FILE}`));
+        }
+        console.log(chalk_1.default.gray('─'.repeat(50)));
+    }
+});
+// Status command
+program
+    .command('status')
+    .description('List all launched tokens')
+    .option('--json', 'Output JSON')
+    .action(async (options) => {
+    const launches = loadLaunches();
+    if (options.json) {
+        console.log(JSON.stringify({ launches }, null, 2));
+    }
+    else {
+        console.log(banner);
+        console.log(chalk_1.default.white(`Launched Tokens (${launches.length}):`));
+        console.log(chalk_1.default.gray('─'.repeat(70)));
+        if (launches.length === 0) {
+            console.log(chalk_1.default.gray('  No tokens launched yet. Run: clawdpad --name "MyToken" --symbol "TKN"'));
+        }
+        else {
+            for (const launch of launches) {
+                console.log(`  ${chalk_1.default.cyan(launch.symbol.padEnd(10))} ` +
+                    `${chalk_1.default.white(launch.name.slice(0, 20).padEnd(22))} ` +
+                    `${chalk_1.default.gray(launch.tokenAddress.slice(0, 16) + '...')}`);
+            }
+        }
+        console.log(chalk_1.default.gray('─'.repeat(70)));
+    }
+});
+// Fees command
+program
+    .command('fees')
+    .description('Check claimable fees')
+    .option('--json', 'Output JSON')
+    .action(async (options) => {
+    const wallet = loadWallet();
+    if (!wallet) {
+        const error = { success: false, error: 'No wallet found. Launch a token first.' };
+        if (options.json) {
+            console.log(JSON.stringify(error));
+        }
+        else {
+            console.error(chalk_1.default.red('No wallet found. Launch a token first.'));
+        }
+        process.exit(2);
+    }
+    // Check fees via Clanker FeeLocker
+    // For now, return placeholder
+    const output = {
+        wallet: wallet.address,
+        claimableWETH: '0',
+        claimableTokens: '0',
+        canClaim: false,
+        hasGas: false,
+        hint: 'Fees accumulate when people trade your tokens',
+    };
+    if (options.json) {
+        console.log(JSON.stringify(output, null, 2));
+    }
+    else {
+        console.log(banner);
+        console.log(chalk_1.default.white('Claimable Fees:'));
+        console.log(chalk_1.default.gray('─'.repeat(50)));
+        console.log(`  Wallet:     ${chalk_1.default.gray(wallet.address)}`);
+        console.log(`  WETH Fees:  ${chalk_1.default.green(output.claimableWETH)} WETH`);
+        console.log(`  Can Claim:  ${output.canClaim ? chalk_1.default.green('Yes') : chalk_1.default.yellow('No')}`);
+        console.log(chalk_1.default.gray('─'.repeat(50)));
+        console.log(chalk_1.default.gray('\n  Fees accumulate when people trade your tokens.'));
+    }
+});
+// Claim command
+program
+    .command('claim')
+    .description('Withdraw accumulated fees')
+    .option('--json', 'Output JSON')
+    .action(async (options) => {
+    const wallet = loadWallet();
+    if (!wallet) {
+        const error = { success: false, error: 'No wallet found' };
+        if (options.json) {
+            console.log(JSON.stringify(error));
+        }
+        else {
+            console.error(chalk_1.default.red('No wallet found. Launch a token first.'));
+        }
+        process.exit(2);
+    }
+    // TODO: Implement actual fee claiming via Clanker FeeLocker contract
+    const output = {
+        success: false,
+        error: 'No fees to claim yet. Keep promoting your tokens!',
+    };
+    if (options.json) {
+        console.log(JSON.stringify(output));
+    }
+    else {
+        console.log(banner);
+        console.log(chalk_1.default.yellow('No fees to claim yet.'));
+        console.log(chalk_1.default.gray('Keep promoting your tokens! Fees accumulate from trades.'));
+    }
+});
+// Info command
+program
+    .command('info')
+    .description('About Clawdpad')
+    .action(() => {
+    console.log(banner);
+    console.log(chalk_1.default.white('\nWhat is Clawdpad?'));
+    console.log(chalk_1.default.gray('─'.repeat(50)));
+    console.log('  Clawdpad lets AI agents launch tokens on Base');
+    console.log('  with one command. No wallet setup, no gas fees.');
+    console.log('');
+    console.log(chalk_1.default.white('How it works:'));
+    console.log('  1. Run: clawdpad --name "X" --symbol "X"');
+    console.log('  2. Token deploys on Base via Clanker');
+    console.log('  3. Earn 80% of all trading fees');
+    console.log('  4. Claim fees anytime: clawdpad claim');
+    console.log('');
+    console.log(chalk_1.default.white('Links:'));
+    console.log(`  Website:  ${chalk_1.default.cyan('https://www.clawdpad.ai')}`);
+    console.log(`  Token:    ${chalk_1.default.cyan('$CLAWDPAD on Base')}`);
+    console.log(`  Twitter:  ${chalk_1.default.cyan('@kk5Ai_world')}`);
+    console.log(chalk_1.default.gray('─'.repeat(50)));
+});
+program.parse();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "clawdpad",
+  "version": "1.0.0",
+  "description": "CLI for AI agents to launch memecoins on Clawdpad",
+  "main": "dist/index.js",
+  "bin": {
+    "clawdpad": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "memecoin",
+    "token",
+    "ai",
+    "agent",
+    "base",
+    "clawdpad",
+    "x402"
+  ],
+  "author": "Clawdpad",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "inquirer": "^8.2.6",
+    "node-fetch": "^2.7.0",
+    "viem": "^2.0.0",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.10.0",
+    "@types/node-fetch": "^2.6.9",
+    "typescript": "^5.3.0",
+    "ts-node": "^10.9.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clawdpad/clawdpad-cli"
+  }
+}

package/src/index.ts

@@ -0,0 +1,509 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import fetch from 'node-fetch';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { createPublicClient, http, formatEther, createWalletClient } from 'viem';
+import { base, baseSepolia } from 'viem/chains';
+import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
+
+const API_URL = process.env.CLAWDPAD_API_URL || 'https://www.clawdpad.ai/api';
+const CONFIG_DIR = path.join(os.homedir(), '.clawdpad');
+const WALLET_FILE = path.join(CONFIG_DIR, 'wallet.json');
+const LAUNCHES_FILE = path.join(CONFIG_DIR, 'launches.json');
+
+// Clanker API (for token deployment)
+const CLANKER_API = 'https://www.clanker.world/api/v1';
+
+const program = new Command();
+
+// ASCII Art Banner
+const banner = `
+${chalk.cyan('  ██████╗██╗      █████╗ ██╗    ██╗██████╗ ██████╗  █████╗ ██████╗ ')}
+${chalk.cyan(' ██╔════╝██║     ██╔══██╗██║    ██║██╔══██╗██╔══██╗██╔══██╗██╔══██╗')}
+${chalk.cyan(' ██║     ██║     ███████║██║ █╗ ██║██║  ██║██████╔╝███████║██║  ██║')}
+${chalk.cyan(' ██║     ██║     ██╔══██║██║███╗██║██║  ██║██╔═══╝ ██╔══██║██║  ██║')}
+${chalk.cyan(' ╚██████╗███████╗██║  ██║╚███╔███╔╝██████╔╝██║     ██║  ██║██████╔╝')}
+${chalk.cyan('  ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═════╝ ╚═╝     ╚═╝  ╚═╝╚═════╝ ')}
+${chalk.gray('                 one command. your token. live on base.')}
+`;
+
+// ============ Wallet Management ============
+
+interface WalletData {
+  address: string;
+  privateKey: string;
+  createdAt: string;
+}
+
+interface LaunchRecord {
+  tokenAddress: string;
+  name: string;
+  symbol: string;
+  network: string;
+  transactionHash: string;
+  launchedAt: string;
+  website?: string;
+}
+
+function ensureConfigDir(): void {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  }
+}
+
+function loadWallet(): WalletData | null {
+  if (!fs.existsSync(WALLET_FILE)) {
+    return null;
+  }
+  try {
+    const data = fs.readFileSync(WALLET_FILE, 'utf-8');
+    return JSON.parse(data);
+  } catch {
+    return null;
+  }
+}
+
+function createWallet(): WalletData {
+  ensureConfigDir();
+  
+  const privateKey = generatePrivateKey();
+  const account = privateKeyToAccount(privateKey);
+  
+  const wallet: WalletData = {
+    address: account.address,
+    privateKey: privateKey,
+    createdAt: new Date().toISOString(),
+  };
+  
+  fs.writeFileSync(WALLET_FILE, JSON.stringify(wallet, null, 2), { mode: 0o600 });
+  
+  return wallet;
+}
+
+function getOrCreateWallet(): { wallet: WalletData; isNew: boolean } {
+  const existing = loadWallet();
+  if (existing) {
+    return { wallet: existing, isNew: false };
+  }
+  return { wallet: createWallet(), isNew: true };
+}
+
+function loadLaunches(): LaunchRecord[] {
+  if (!fs.existsSync(LAUNCHES_FILE)) {
+    return [];
+  }
+  try {
+    const data = fs.readFileSync(LAUNCHES_FILE, 'utf-8');
+    return JSON.parse(data);
+  } catch {
+    return [];
+  }
+}
+
+function saveLaunch(launch: LaunchRecord): void {
+  ensureConfigDir();
+  const launches = loadLaunches();
+  launches.push(launch);
+  fs.writeFileSync(LAUNCHES_FILE, JSON.stringify(launches, null, 2));
+}
+
+// ============ Image Upload ============
+
+async function uploadImage(imagePath: string): Promise<string> {
+  // Read image file
+  const imageBuffer = fs.readFileSync(imagePath);
+  const base64 = imageBuffer.toString('base64');
+  const ext = path.extname(imagePath).toLowerCase();
+  const mimeType = ext === '.png' ? 'image/png' : 
+                   ext === '.gif' ? 'image/gif' : 
+                   ext === '.webp' ? 'image/webp' : 'image/jpeg';
+  
+  // Upload to Clawdpad (which uses imgbb or similar)
+  const response = await fetch(`${API_URL}/upload`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      image: `data:${mimeType};base64,${base64}`,
+      name: path.basename(imagePath, ext),
+    }),
+  });
+  
+  const result = await response.json() as any;
+  
+  if (!result.success || !result.url) {
+    throw new Error(result.error || 'Image upload failed');
+  }
+  
+  return result.url;
+}
+
+// ============ Token Launch via Clanker ============
+
+async function launchViaClanker(params: {
+  name: string;
+  symbol: string;
+  description: string;
+  image: string;
+  website?: string;
+  wallet: WalletData;
+  testnet?: boolean;
+}): Promise<{
+  tokenAddress: string;
+  transactionHash: string;
+  clankerUrl: string;
+  explorerUrl: string;
+}> {
+  // For now, use Clawdpad API which proxies to Clanker
+  // This allows us to sponsor gas and handle the complexity
+  
+  const response = await fetch(`${API_URL}/launch`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      name: params.name,
+      symbol: params.symbol,
+      description: params.description,
+      image: params.image,
+      website: params.website,
+      creatorWallet: params.wallet.address,
+      testnet: params.testnet,
+    }),
+  });
+  
+  const result = await response.json() as any;
+  
+  if (!response.ok) {
+    throw new Error(result.error || 'Launch failed');
+  }
+  
+  const chainName = params.testnet ? 'base-sepolia' : 'base';
+  const explorerBase = params.testnet ? 'https://sepolia.basescan.org' : 'https://basescan.org';
+  
+  return {
+    tokenAddress: result.token?.address || result.tokenAddress || '0x...',
+    transactionHash: result.transactionHash || result.tx_hash || '0x...',
+    clankerUrl: `https://clanker.world/clanker/${result.token?.address || result.tokenAddress}`,
+    explorerUrl: `${explorerBase}/token/${result.token?.address || result.tokenAddress}`,
+  };
+}
+
+// ============ CLI Commands ============
+
+program
+  .name('clawdpad')
+  .description('Launch memecoins on Base — one command, no gas, earn fees')
+  .version('1.0.0');
+
+// Main launch command
+program
+  .option('--name <name>', 'Token name')
+  .option('--symbol <symbol>', 'Token symbol')
+  .option('--description <text>', 'Token description')
+  .option('--image <path>', 'Path to image (PNG/JPG/GIF/WebP, max 5MB)')
+  .option('--website <url>', 'Website URL (e.g., Moltbook post)')
+  .option('--testnet', 'Use Base Sepolia testnet')
+  .option('--json', 'Output JSON (machine-readable)')
+  .action(async (options) => {
+    const jsonMode = options.json;
+    
+    if (!jsonMode) {
+      console.log(banner);
+    }
+    
+    // Check if this is a subcommand or launch
+    if (!options.name && !options.symbol) {
+      if (!jsonMode) {
+        program.help();
+      }
+      return;
+    }
+    
+    // Validate required fields
+    if (!options.name || !options.symbol) {
+      const error = { success: false, error: 'Missing required fields: --name and --symbol' };
+      if (jsonMode) {
+        console.log(JSON.stringify(error));
+        process.exit(1);
+      }
+      console.error(chalk.red('Error: --name and --symbol are required'));
+      process.exit(1);
+    }
+    
+    const spinner = jsonMode ? null : ora('Preparing launch...').start();
+    
+    try {
+      // Get or create wallet
+      const { wallet, isNew } = getOrCreateWallet();
+      
+      if (spinner) {
+        spinner.text = isNew ? 'Created new wallet...' : 'Using existing wallet...';
+      }
+      
+      // Upload image if provided
+      let imageUrl = '';
+      if (options.image) {
+        if (spinner) spinner.text = 'Uploading image...';
+        
+        if (options.image.startsWith('http')) {
+          imageUrl = options.image;
+        } else if (fs.existsSync(options.image)) {
+          imageUrl = await uploadImage(options.image);
+        } else {
+          throw new Error(`Image not found: ${options.image}`);
+        }
+      }
+      
+      // Launch token
+      if (spinner) spinner.text = 'Launching token on Base...';
+      
+      const result = await launchViaClanker({
+        name: options.name,
+        symbol: options.symbol,
+        description: options.description || `${options.name} - Launched via Clawdpad`,
+        image: imageUrl,
+        website: options.website,
+        wallet,
+        testnet: options.testnet,
+      });
+      
+      // Save launch record
+      saveLaunch({
+        tokenAddress: result.tokenAddress,
+        name: options.name,
+        symbol: options.symbol,
+        network: options.testnet ? 'base-sepolia' : 'base',
+        transactionHash: result.transactionHash,
+        launchedAt: new Date().toISOString(),
+        website: options.website,
+      });
+      
+      if (spinner) spinner.succeed('Token launched!');
+      
+      // Output
+      const output = {
+        success: true,
+        tokenAddress: result.tokenAddress,
+        transactionHash: result.transactionHash,
+        name: options.name,
+        symbol: options.symbol,
+        network: options.testnet ? 'Base Sepolia' : 'Base',
+        explorer: result.explorerUrl,
+        clanker: result.clankerUrl,
+        wallet: wallet.address,
+        ...(isNew ? { privateKey: wallet.privateKey } : {}),
+      };
+      
+      if (jsonMode) {
+        console.log(JSON.stringify(output, null, 2));
+      } else {
+        console.log('\n' + chalk.green('✓ Token launched successfully!'));
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log(`  ${chalk.gray('Name:')}     ${chalk.white(options.name)}`);
+        console.log(`  ${chalk.gray('Symbol:')}   ${chalk.cyan(options.symbol)}`);
+        console.log(`  ${chalk.gray('Network:')}  ${chalk.blue(options.testnet ? 'Base Sepolia' : 'Base')}`);
+        console.log(`  ${chalk.gray('Address:')}  ${chalk.yellow(result.tokenAddress)}`);
+        console.log(`  ${chalk.gray('Wallet:')}   ${chalk.gray(wallet.address)}`);
+        console.log(chalk.gray('─'.repeat(60)));
+        console.log(`\n  ${chalk.white('View on Basescan:')}`);
+        console.log(`  ${chalk.cyan(result.explorerUrl)}`);
+        console.log(`\n  ${chalk.white('View on Clanker:')}`);
+        console.log(`  ${chalk.cyan(result.clankerUrl)}`);
+        
+        if (isNew) {
+          console.log('\n' + chalk.yellow('⚠️  NEW WALLET CREATED'));
+          console.log(chalk.gray('  Save this private key — it won\'t be shown again:'));
+          console.log(`  ${chalk.red(wallet.privateKey)}`);
+        }
+        
+        console.log('\n' + chalk.gray('Earn 80% of all trading fees! Check with: clawdpad fees'));
+      }
+      
+    } catch (error: any) {
+      if (spinner) spinner.fail('Launch failed');
+      
+      const errorOutput = { success: false, error: error.message };
+      
+      if (jsonMode) {
+        console.log(JSON.stringify(errorOutput));
+      } else {
+        console.error(chalk.red(`\nError: ${error.message}`));
+      }
+      process.exit(1);
+    }
+  });
+
+// Wallet command
+program
+  .command('wallet')
+  .description('Show wallet address and balance')
+  .option('--json', 'Output JSON')
+  .action(async (options) => {
+    const { wallet, isNew } = getOrCreateWallet();
+    
+    // Get balance
+    const client = createPublicClient({
+      chain: base,
+      transport: http(),
+    });
+    
+    const balance = await client.getBalance({ address: wallet.address as `0x${string}` });
+    
+    const output = {
+      address: wallet.address,
+      balance: formatEther(balance),
+      balanceWei: balance.toString(),
+      isNew,
+    };
+    
+    if (options.json) {
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      console.log(banner);
+      console.log(chalk.white('Wallet:'));
+      console.log(chalk.gray('─'.repeat(50)));
+      console.log(`  Address: ${chalk.cyan(wallet.address)}`);
+      console.log(`  Balance: ${chalk.green(formatEther(balance))} ETH`);
+      if (isNew) {
+        console.log(chalk.yellow('\n  ⚠️  New wallet created'));
+        console.log(chalk.gray(`  Private key saved to: ${WALLET_FILE}`));
+      }
+      console.log(chalk.gray('─'.repeat(50)));
+    }
+  });
+
+// Status command
+program
+  .command('status')
+  .description('List all launched tokens')
+  .option('--json', 'Output JSON')
+  .action(async (options) => {
+    const launches = loadLaunches();
+    
+    if (options.json) {
+      console.log(JSON.stringify({ launches }, null, 2));
+    } else {
+      console.log(banner);
+      console.log(chalk.white(`Launched Tokens (${launches.length}):`));
+      console.log(chalk.gray('─'.repeat(70)));
+      
+      if (launches.length === 0) {
+        console.log(chalk.gray('  No tokens launched yet. Run: clawdpad --name "MyToken" --symbol "TKN"'));
+      } else {
+        for (const launch of launches) {
+          console.log(
+            `  ${chalk.cyan(launch.symbol.padEnd(10))} ` +
+            `${chalk.white(launch.name.slice(0, 20).padEnd(22))} ` +
+            `${chalk.gray(launch.tokenAddress.slice(0, 16) + '...')}`
+          );
+        }
+      }
+      console.log(chalk.gray('─'.repeat(70)));
+    }
+  });
+
+// Fees command
+program
+  .command('fees')
+  .description('Check claimable fees')
+  .option('--json', 'Output JSON')
+  .action(async (options) => {
+    const wallet = loadWallet();
+    
+    if (!wallet) {
+      const error = { success: false, error: 'No wallet found. Launch a token first.' };
+      if (options.json) {
+        console.log(JSON.stringify(error));
+      } else {
+        console.error(chalk.red('No wallet found. Launch a token first.'));
+      }
+      process.exit(2);
+    }
+    
+    // Check fees via Clanker FeeLocker
+    // For now, return placeholder
+    const output = {
+      wallet: wallet.address,
+      claimableWETH: '0',
+      claimableTokens: '0',
+      canClaim: false,
+      hasGas: false,
+      hint: 'Fees accumulate when people trade your tokens',
+    };
+    
+    if (options.json) {
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      console.log(banner);
+      console.log(chalk.white('Claimable Fees:'));
+      console.log(chalk.gray('─'.repeat(50)));
+      console.log(`  Wallet:     ${chalk.gray(wallet.address)}`);
+      console.log(`  WETH Fees:  ${chalk.green(output.claimableWETH)} WETH`);
+      console.log(`  Can Claim:  ${output.canClaim ? chalk.green('Yes') : chalk.yellow('No')}`);
+      console.log(chalk.gray('─'.repeat(50)));
+      console.log(chalk.gray('\n  Fees accumulate when people trade your tokens.'));
+    }
+  });
+
+// Claim command
+program
+  .command('claim')
+  .description('Withdraw accumulated fees')
+  .option('--json', 'Output JSON')
+  .action(async (options) => {
+    const wallet = loadWallet();
+    
+    if (!wallet) {
+      const error = { success: false, error: 'No wallet found' };
+      if (options.json) {
+        console.log(JSON.stringify(error));
+      } else {
+        console.error(chalk.red('No wallet found. Launch a token first.'));
+      }
+      process.exit(2);
+    }
+    
+    // TODO: Implement actual fee claiming via Clanker FeeLocker contract
+    const output = {
+      success: false,
+      error: 'No fees to claim yet. Keep promoting your tokens!',
+    };
+    
+    if (options.json) {
+      console.log(JSON.stringify(output));
+    } else {
+      console.log(banner);
+      console.log(chalk.yellow('No fees to claim yet.'));
+      console.log(chalk.gray('Keep promoting your tokens! Fees accumulate from trades.'));
+    }
+  });
+
+// Info command
+program
+  .command('info')
+  .description('About Clawdpad')
+  .action(() => {
+    console.log(banner);
+    console.log(chalk.white('\nWhat is Clawdpad?'));
+    console.log(chalk.gray('─'.repeat(50)));
+    console.log('  Clawdpad lets AI agents launch tokens on Base');
+    console.log('  with one command. No wallet setup, no gas fees.');
+    console.log('');
+    console.log(chalk.white('How it works:'));
+    console.log('  1. Run: clawdpad --name "X" --symbol "X"');
+    console.log('  2. Token deploys on Base via Clanker');
+    console.log('  3. Earn 80% of all trading fees');
+    console.log('  4. Claim fees anytime: clawdpad claim');
+    console.log('');
+    console.log(chalk.white('Links:'));
+    console.log(`  Website:  ${chalk.cyan('https://www.clawdpad.ai')}`);
+    console.log(`  Token:    ${chalk.cyan('$CLAWDPAD on Base')}`);
+    console.log(`  Twitter:  ${chalk.cyan('@kk5Ai_world')}`);
+    console.log(chalk.gray('─'.repeat(50)));
+  });
+
+program.parse();

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022", "DOM"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}