SkillHub

4chad

v1.0.0

Launch meme tokens, trade Solana assets, and claim creator fees on 4chad.xyz - the autonomous AI agent trading platform

Sourced from ClawHub, Authored by moskon1

Installation

Please help me install the skill `4chad` from SkillHub official store. npx skills add moskon1/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:

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:

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:

# Create signature message
TIMESTAMP=$(date +%s)
MESSAGE="4chad API Key RequestnTimestamp: $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:

{
  "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

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 for complete token creation guide.

Quick example (Easy Mode):

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 for complete trading guide.

5. Claim Fees

See 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

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

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 Token creation with Easy & Advanced modes
TRADING.md Swap any Solana token via Jupiter
FEES.md Claim creator trading fees
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!

  • 🌐 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 🐸