Documentation v1.0

YachtClaw Docs

Everything you need to launch tokens on Base using AI-powered infrastructure. Built on Bankr, designed for agents.

No-code launchBankr-poweredBase network57% fee share

Introduction

What YachtClaw is and how it works

YachtClaw is an AI-powered token launcher built on top of Bankr's battle-tested infrastructure. It enables anyone — from developers to AI agents — to launch ERC-20 tokens on the Base network in minutes, without writing a single line of Solidity.

⚡

Instant Launch

Tokens deploy to Base in seconds via Bankr API

💰

57% Fee Share

Creators earn 57% of all trading fees on their token

🤖

Agent-Ready

REST API lets AI agents launch tokens autonomously

Architecture Overview

User / AgentFills launch form or calls REST API

YachtClaw APIValidates, stores in SQLite, triggers Bankr

BankrDeploys ERC-20 on Base, returns contract address

Base networkToken lives on-chain, trading enabled immediately

ℹ️YachtClaw currently runs on Base mainnet. Make sure your fee recipient address is a valid Base wallet, X handle, or ENS name.

How to Launch a Token

Step-by-step walkthrough of the full launch flow

✅Launching a token takes under 2 minutes from form fill to on-chain deployment.

Navigate to the Launch page

Click Launch Token in the top navigation bar, or go directly to /launch.

The page is public — no account or wallet connection required.

Fill in Token Details

Complete the Token Details card:

•Token Name: Full display name, e.g. "Yacht Finance"
•Symbol: Ticker, max 10 chars, e.g. "YACHT"
•Description: What the token is about (optional but recommended)
•Image URL: Direct URL to a square PNG/JPG logo (optional)

Configure Fee Recipient

Choose who receives 57% of all trading fees generated by your token. Three options:

Wallet

0x address

X Handle

@username

ENS Name

name.eth

See the section for full details on each type.

Add Social Links (optional)

Link your token's website, X account, and Telegram group. These appear in your token's metadata on Bankr and block explorers.

Submit & Deploy

Click Launch Token. YachtClaw will:

✓Validate all inputs
✓Store the launch record in the database
✓Call the Bankr API to deploy your ERC-20 on Base
✓Return the contract address and transaction hash

Track on Dashboard

Visit /dashboard to see all launches and their status:

launchingBankr deploy in progress

launchedLive on Base ✓

failedDeploy failed – check error

rejectedManually rejected

Fee Configuration Guide

Choose how you receive 57% of trading fees from your token

When your token is traded on Base, 57% of all trading fees are routed to your chosen fee recipient. YachtClaw supports three recipient types:

Wallet Address

Recommended for most users

EVM

Enter any valid EVM wallet address. Fees are sent directly to this address on Base.

example

0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

ℹ️Make sure the address is on the Base network and is controlled by you.

X (Twitter) Handle

For X-connected wallets via Bankr

X Handle

Enter your X username (without @). Bankr resolves the handle to a linked wallet address.

example

YachtClaw

⚠️Your X account must be linked to a wallet in Bankr's system. Handles without a linked wallet will cause the launch to fail.

ENS

ENS Name

Ethereum Name Service domains

.eth

Enter a valid ENS name ending in .eth. Bankr resolves it to the underlying address.

example

yachtclaw.eth

ℹ️ENS must resolve to a valid Ethereum address. Subdomains (e.g. fee.yachtclaw.eth) are supported if they resolve.

💡 Fee Split Summary

Your share57%

Bankr protocol43%

Admin Panel

Review, approve, and reject token launches

The admin panel at /admin/approvals lists all submitted token launches. Admins can approve (triggering Bankr deployment) or reject them with a reason.

Available Actions

Approve

Triggers Bankr API immediately. Token deploys to Base. Status becomes "launched" with contract address.

Reject

Mark launch as rejected with an optional reason. Creator can resubmit with corrected details.

pendingSubmitted, awaiting admin action

launchingBankr API call in progress

launchedLive on Base, contract address available

failedBankr API returned an error

rejectedManually rejected by admin

⚠️The admin panel is currently open (no auth required). In production, you should re-enable admin authentication before exposing this panel publicly.

Troubleshooting

Common errors and how to fix them

Cause: The server process (PM2) crashed or port 3000 is occupied by a zombie process.

Fix:

bash

# Kill zombie on port 3000
pkill -9 -f "next start"

# Restart PM2
cd ~/yachtclaw
pm2 delete all
pm2 start npm --name yachtclaw -- start

API Integration

Integrate YachtClaw into AI agents and external tools

YachtClaw exposes a simple REST API. All endpoints return JSON. No authentication is required (public mode).

Base URL

http://your-domain.com

GET/api/launches

Returns all token launches with their status and Bankr data.

Response

{
  "launches": [
    {
      "id": 1,
      "token_name": "Yacht Finance",
      "symbol": "YACHT",
      "status": "launched",
      "bankr_token_address": "0xabc...",
      "bankr_tx_hash": "0xdef...",
      "created_at": "2026-01-01T00:00:00Z"
    }
  ]
}

POST/api/launches

Submit a new token launch. Triggers Bankr deployment immediately.

Request body

{
  "tokenName": "Yacht Finance",        // required
  "symbol": "YACHT",                   // required
  "description": "A DeFi yacht club",  // optional
  "imageUrl": "https://...",           // optional
  "feeRecipient": "0x...",            // required — wallet / X / ENS
  "feeRecipientType": "wallet",        // "wallet" | "x" | "ens"
  "website": "https://...",           // optional
  "twitter": "YachtClaw",             // optional
  "telegram": "yachtclaw"             // optional
}

Success response

{
  "success": true,
  "launch": { "id": 2, "status": "launching", ... },
  "bankrResult": {
    "success": true,
    "tokenAddress": "0xabc...",
    "txHash": "0xdef..."
  }
}

PATCH/api/admin/launches/:id

Manually approve or reject a pending launch.

Approve

// Approve — triggers Bankr
{ "action": "approve" }

// Reject
{ "action": "reject", "rejectionReason": "Duplicate token" }

AI Agent Example (Python)

python

import requests

def launch_token(name, symbol, fee_wallet):
    res = requests.post("http://localhost:3000/api/launches", json={
        "tokenName": name,
        "symbol": symbol,
        "feeRecipient": fee_wallet,
        "feeRecipientType": "wallet",
        "description": f"AI-launched token: {name}"
    })
    data = res.json()
    if data.get("success"):
        addr = data["bankrResult"]["tokenAddress"]
        print(f"✅ {name} live at {addr}")
        return addr
    else:
        print(f"❌ Failed: {data.get('error')}")
        return None

# Launch from your AI agent
launch_token("AgentToken", "AGT", "0xYourWalletAddress")

ℹ️For production AI agent use, deploy YachtClaw to a persistent server (Railway, Render, VPS) so the SQLite DB is stable and port 3000 is always accessible.

Roadmap & Future Features

What's coming next for YachtClaw

Phase 1 — Core

Complete

Public token launch form
Bankr API integration
Fee configuration (wallet / X / ENS)
Admin approvals panel
Dashboard with launch history

Phase 2 — Enhancement

In Progress

Multi-network support (Optimism, Arbitrum)
Token analytics dashboard
Live token price feed
Webhook notifications on launch
Rate limiting & spam protection

Phase 3 — Agent Platform

Planned

API key auth for agent-to-agent calls
Batch launch endpoint
Token metadata editor post-launch
On-chain revenue analytics
Embeddable launch widget

Phase 4 — Community

Planned

Token discovery page
Creator leaderboard
Fee claim dashboard
DAO governance module
Custom branding for white-label

⚓

Built for the long haul

Follow @YachtClaw for updates, or open an issue on GitHub.

Launch a Token Follow on X