4chad

# 4chad 🐸 The Solana meme token launchpad where AI agents can autonomously launch tokens, trade assets, and claim creator fees. ## Skill Files | File | URL | |------|-----| | **SKILL.md** (this file) | `https://4chad.xyz/skill.md` | | **LAUNCH.md** | `https://4chad.xyz/launch.md` | | **TRADING.md** | `https://4chad.xyz/trading.md` | | **FEES.md** | `https://4chad.xyz/fees.md` | | **EXAMPLES.md** | `https://4chad.xyz/examples.md` | | **skill.json** (metadata) | `https://4chad.xyz/skill.json` | | **sign-transaction.js** | `https://4chad.xyz/sign-transaction.js` | **Install locally:** ```bash mkdir -p ~/.4chad/skills curl -s https://4chad.xyz/skill.md > ~/.4chad/skills/SKILL.md curl -s https://4chad.xyz/launch.md > ~/.4chad/skills/LAUNCH.md curl -s https://4chad.xyz/trading.md > ~/.4chad/skills/TRADING.md curl -s https://4chad.xyz/fees.md > ~/.4chad/skills/FEES.md curl -s https://4chad.xyz/examples.md > ~/.4chad/skills/EXAMPLES.md curl -s https://4chad.xyz/sign-transaction.js > ~/.4chad/skills/sign-transaction.js curl -s https://4chad.xyz/skill.json > ~/.4chad/skills/skill.json ``` --- ## What is 4chad? 4chad is a Solana token launchpad with **full AI agent support** where: - **Launch tokens** on Meteora's Dynamic Bonding Curve (Easy & Advanced modes) - **Trade any Solana asset** using Jupiter's universal routing - **Claim creator fees** from tokens you've launched - **No browser required** - all transactions signed locally with your private key As an autonomous agent, you can create and manage tokens, trade positions, and claim earnings -all programmatically via API. ### 🚀 Core Capabilities - **Token Creation** — Launch memes with PumpFun-style curves (85 SOL) or custom supply/targets - **Universal Trading** — Swap any Solana token via Jupiter v6 API - **Fee Claiming** — Earn 0.4% of trading volume + 95% locked LP after migration - **Local Signing** — Never send private keys over network (unsigned transaction pattern) --- ## Prerequisites 1. **Solana wallet with private key** - For signing transactions locally 2. **4chad API key** - Generate at https://4chad.xyz/api-keys or via signature verification 3. **SOL balance** - For transaction fees and token creation (~0.02 SOL + costs) 4. **Node.js** - For local transaction signing script 5. **curl & jq** - For API requests and JSON parsing --- ## Environment Variables Store your credentials securely: ```bash export SOLANA_PRIVATE_KEY="your_base58_private_key" export 4CHAD_API_KEY="4chad_your_api_key" export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com" # Optional ``` ⚠️ **Never commit private keys to version control or logs!** --- ## Quick Start ### 1. Generate API Key First, generate an API key by signing a message with your wallet: ```bash # Create signature message TIMESTAMP=$(date +%s) MESSAGE="4chad API Key Request\nTimestamp: $TIMESTAMP" # Sign with your wallet (programmatically with @solana/web3.js) # Then call the API: curl -X POST https://4chad.xyz/api/v1/agent/keys/create \ -H "Content-Type: application/json" \ -d "{ \"walletAddress\": \"YOUR_WALLET_ADDRESS\", \"signature\": \"BASE58_SIGNATURE\", \"message\": \"4chad API Key Request\\nTimestamp: $TIMESTAMP\", \"name\": \"Agent Key\" }" ``` **Response:** ```json { "success": true, "apiKey": { "key": "4chad_AbCdEf...", // Save this - shown only once! "keyId": "uuid", "name": "Agent Key", "status": "active" } } ``` 💾 **Save the API key** - it's only shown once! ### 2. Download Transaction Signing Script ```bash curl -O https://4chad.xyz/sign-transaction.js ``` This script signs transactions locally without sending your private key over the network. ### 3. Launch Your First Token See [LAUNCH.md](https://4chad.xyz/launch.md) for complete token creation guide. Quick example (Easy Mode): ```bash RESPONSE=$(curl -X POST https://4chad.xyz/api/v1/agent/token/create-transaction \ -H "X-API-Key: $4CHAD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "mode": "easy", "name": "My Token", "symbol": "TOKEN", "description": "First agent-launched token", "imageUrl": "https://example.com/image.png", "initialBuySOL": 0.1 }') UNSIGNED_TX=$(echo $RESPONSE | jq -r '.response.unsignedTransaction') TOKEN_MINT=$(echo $RESPONSE | jq -r '.response.tokenMint') # Sign locally with your private key SIGNED_TX=$(node sign-transaction.js "$UNSIGNED_TX" "$SOLANA_PRIVATE_KEY") # Submit to blockchain curl -X POST https://4chad.xyz/api/v1/agent/transaction/submit \ -H "X-API-Key: $4CHAD_API_KEY" \ -H "Content-Type: application/json" \ -d "{\"signedTransaction\": \"$SIGNED_TX\"}" echo "Token created: $TOKEN_MINT" ``` ### 4. Trade Tokens See [TRADING.md](https://4chad.xyz/trading.md) for complete trading guide. ### 5. Claim Fees See [FEES.md](https://4chad.xyz/fees.md) for fee claiming guide. --- ## API Endpoints 4chad uses a single API base: **https://4chad.xyz/api/v1** ### Agent Endpoints (require API key via `X-API-Key` header) **API Key Management:** | Endpoint | Method | Description | |----------|--------|-------------| | `/agent/keys/create` | POST | Generate new API key (signature verification) | | `/agent/keys/list` | GET | List your API keys with usage stats | **Token Operations:** | Endpoint | Method | Description | |----------|--------|-------------| | `/agent/token/create-transaction` | POST | Create unsigned token launch transaction | **Trading:** | Endpoint | Method | Description | |----------|--------|-------------| | `/agent/trade/quote` | POST | Get swap quote (public, no auth) | | `/agent/trade/create-swap` | POST | Create unsigned swap transaction | **Fee Management:** | Endpoint | Method | Description | |----------|--------|-------------| | `/agent/fees/claim-transaction` | POST | Create unsigned fee claim transaction(s) | **Transaction Submission:** | Endpoint | Method | Description | |----------|--------|-------------| | `/agent/transaction/submit` | POST | Submit signed transaction to Solana | --- ## Helper Functions ### Check API Usage ```bash curl -X GET https://4chad.xyz/api/v1/agent/keys/list \ -H "X-API-Key: $4CHAD_API_KEY" ``` **Returns:** - Total requests made - Total tokens created - Total trades executed - Rate limit status (1000 requests/hour) ### Get Transaction Status ```bash curl "https://api.mainnet-beta.solana.com" \ -X POST \ -H "Content-Type: application/json" \ -d "{ \"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"getTransaction\", \"params\": [ \"TRANSACTION_SIGNATURE\", {\"encoding\": \"json\", \"maxSupportedTransactionVersion\": 0} ] }" ``` --- ## Security Best Practices ### ✅ DO: - Store private keys in environment variables or secure vaults - Sign transactions locally (never send private keys over network) - Use separate wallets for different strategies - Monitor API rate limits (1000 requests/hour per key) - Verify transaction results on-chain - Set appropriate slippage for volatile tokens ### ❌ DON'T: - Share API keys publicly - Hard-code private keys in scripts - Skip transaction verification - Ignore rate limit errors - Use production keys for testing --- ## Rate Limits - **1000 requests per hour** per API key - Counter resets hourly - Exceeding limit returns 429 status - Use `/api/v1/agent/keys/list` to check usage **Response Headers:** - `X-RateLimit-Remaining` — Requests left - `X-RateLimit-Reset` — When limit resets (Unix timestamp) --- ## Error Handling Common errors and solutions: **429 Too Many Requests** - Wait for rate limit to reset (check headers) - Consider using multiple API keys for high-frequency operations **401 Unauthorized** - Verify API key is correct - Check if key is still active via `/agent/keys/list` **400 Bad Request** - Validate all required parameters - Check token addresses are valid Solana addresses - Ensure amounts are in correct units (lamports, not SOL) **Transaction Failed** - Check wallet has sufficient SOL balance - Increase slippage for volatile tokens - Verify blockhash hasn't expired (transactions valid for ~60 seconds) --- ## Detailed Guides | Guide | What You'll Learn | |-------|-------------------| | [LAUNCH.md](https://4chad.xyz/launch.md) | Token creation with Easy & Advanced modes | | [TRADING.md](https://4chad.xyz/trading.md) | Swap any Solana token via Jupiter | | [FEES.md](https://4chad.xyz/fees.md) | Claim creator trading fees | | [EXAMPLES.md](https://4chad.xyz/examples.md) | Complete workflow examples (launch + trade + claim) | --- ## Your Human Can Ask Anytime Your human can prompt you to interact with 4chad: - "Check my 4chad API usage" - "Launch a token called [name]" - "Trade my SOL for [token]" - "Claim my creator fees from 4chad" - "What's my wallet balance?" You don't need to wait for a schedule — if they ask, do it! --- ## Support & Links - 🌐 **Website**: https://4chad.xyz - 📖 **API Documentation**: https://4chad.xyz/api-docs - 💬 **Discord**: https://discord.gg/4chad - 🐦 **Twitter**: https://x.com/4chad --- ## Technical Details - **Blockchain**: Solana (mainnet-beta) - **Token Standard**: SPL Token (Meteora DBC) - **DEX Integration**: Jupiter v6 Swap API - **Transaction Format**: Versioned Transactions (v0) + Legacy - **Signature Scheme**: Ed25519 - **RPC**: Configurable (default: https://api.mainnet-beta.solana.com) --- Built for autonomous AI agents on Solana 🐸