AstroPad - Clanker Token Deployment Platform

A modern, user-friendly frontend for deploying and managing Clanker v4 tokens on Base blockchain with automatic token discovery and fee management.

Features

• Token Deployment Wizard: Step-by-step token creation with advanced configuration
• Automatic Token Discovery: Uses Alchemy API for fast and reliable token detection
• Fee Management: Automatic admin detection, fee checking, and claiming functionality
• Manual Token Management: Add tokens not automatically detected
• Cross-device Compatibility: Tokens synced across devices using blockchain data
• Modern UI: Clean, responsive interface with smooth animations

Environment Setup

Alchemy API Configuration

This application uses Alchemy API for efficient token discovery. You'll need to get an API key from Alchemy.

Local Development

1. Copy the example environment file:

cp .env.example .env

2. Add your Alchemy API key to .env:

ALCHEMY_API_KEY=your_alchemy_api_key_here

Netlify Deployment

1. In your Netlify dashboard, go to Site Settings → Environment Variables
2. Add a new environment variable:
   • Key: ALCHEMY_API_KEY
   • Value: Your Alchemy API key

Getting an Alchemy API Key

1. Visit dashboard.alchemy.com
2. Sign up for a free account
3. Create a new app:
   • Chain: Base
   • Network: Base Mainnet
4. Copy the API key from your app dashboard

Free Tier: Alchemy provides 300M compute units per month on their free tier, which is sufficient for most use cases.

Web3.Storage API Configuration

This application supports image uploads to IPFS via Pinata for token logos.

Local Development

Add your Pinata API key to .env:

PINATA_JWT=your_pinata_jwt_here
PINATA_GATEWAY=your_pinata_gateway_here

Netlify Deployment

1. In your Netlify dashboard, go to Site Settings → Environment Variables
2. Add new environment variables:
   • Key: PINATA_JWT
   • Value: Your Pinata JWT
   • Key: PINATA_GATEWAY
   • Value: Your Pinata gateway domain

Getting a Pinata JWT

1. Visit pinata.cloud
2. Sign up for a free account
3. Go to your account settings
4. Create a new JWT
5. Copy the JWT

Image Requirements:

• Format: JPG or PNG
• Aspect ratio: Square (1:1)
• File size: Maximum 1MB
• Automatically uploaded to IPFS

Installation

# Install dependencies
pnpm install

# Start development server
pnpm dev

Build & Deploy

# Build for production
pnpm build

# Preview production build
pnpm preview

Architecture

• Frontend: React + TypeScript + Vite
• Blockchain: Base network with Wagmi/Viem
• Token Discovery: Alchemy API with blockchain fallback
• Styling: Custom CSS with design system
• State Management: React hooks with localStorage persistence

API Endpoints

• /api/alchemy-tokens?wallet=<address> - Get deployed tokens for a wallet
• /api/check-fees?feeOwnerAddress=<address>&clankerTokenAddress=<address> - Check available fees

License

MIT