Documentation

What is YUKA?

YUKA is a tool that lets anyone — human or AI — launch their own token on the internet and earn money every time someone trades it.

Think of it like this: you create a coin with your name on it. Every time someone buys or sells that coin, a small fee gets paid — and 80% of that fee goes straight to you, automatically, forever.

No company in the middle. No monthly fee. No permission needed. Just you, your token, and the blockchain.

How it works

The whole process takes about 2 minutes. Here's what happens when you run YUKA:

Your wallet

When you first run any YUKA command, it automatically creates a wallet for you. This wallet is a standard Ethereum wallet — the same kind MetaMask uses — stored as a file on your computer.

Back it up. Copy ~/.yuka/wallet.json somewhere safe. If you lose it, you lose access to your fees. Nobody can recover it for you.

What is Base?

Base is a blockchain — a public, permanent ledger where anyone can create tokens, send money, and run programs. It's built by Coinbase and runs on top of Ethereum, which means it's fast and cheap.

When YUKA launches your token on Base, it means:

• Your token exists permanently — no server to shut down
• Anyone with a crypto wallet can buy and sell it instantly
• All transactions are public and verifiable
• You receive fees directly — no middleman

The currency on Base is ETH. You need a small amount to pay for transactions — called “gas” — the same way you need a stamp to send a letter.

Fee model

Every time someone trades your token, a small fee (around 1%) is collected automatically by the smart contract. Here's how it's split:

Fees accumulate in the PositionManager contract. They don't move until you run yuka claim — so you can let them build up and claim in batches to save on gas.

Quick Start

No installation needed — run directly with npx. Node.js 18+ required.

# Run directly (recommended)
npx hi-yuka launch --name "MyAgent" --symbol "AGT"

# Or install globally
npm install -g hi-yuka
yuka launch --name "MyAgent" --symbol "AGT"

A wallet is created automatically on first run at ~/.yuka/wallet.json.

yuka wallet   # get your address
yuka fund     # see how to get ETH

# Launch with social links (they appear on your token page)
yuka launch --name "My Agent" --symbol "AGT" \
  --description "What I do" \
  --website "https://myagent.xyz" \
  --twitter "https://x.com/myagent"

Web Dashboard

Every token launched via the CLI or the web form automatically appears at yuka.lol/dashboard when you connect the same wallet.

You can also launch tokens directly from the web at yuka.lol/launch — no CLI needed. Connect a wallet, fill in the form, done.

yuka wallet

Show the agent wallet address and current ETH balance on Base.

yuka wallet [--json]

# Example output
Address:     0x1a2b...3c4d
Balance:     0.0500 ETH
Network:     Base (8453)
Created At:  2026-05-01

yuka fund

Show how to fund the wallet with ETH on Base. Prints the wallet address and available funding methods.

yuka fund [--json]

How to get ETH on Base:

• Bridge from Ethereum mainnet — use bridge.base.org
• Buy directly on Coinbase and withdraw to Base
• Transfer from another Base wallet
• Use a testnet faucet for Base Sepolia (free, for testing)

yuka launch

Deploy a new ERC-20 token via Flaunch on Base. Creates the token contract and a Uniswap V4 trading pool in one step.

yuka launch --name <name> --symbol <TICKER> [options]

# Basic launch
yuka launch --name "My Agent" --symbol "AGT" --description "AI trading agent"

# With social links (appear on your token detail page)
yuka launch --name "My Agent" --symbol "AGT" \
  --website "https://myagent.xyz" \
  --twitter "https://x.com/myagent" \
  --telegram "https://t.me/myagent"

# With custom image
yuka launch --name "My Agent" --symbol "AGT" --image ./logo.png

# Testnet (free, for testing)
yuka launch --name "My Agent" --symbol "AGT" --testnet

# JSON output (for agent use)
yuka launch --name "My Agent" --symbol "AGT" --json

yuka status

List all tokens launched by this wallet. On testnet, reads from local records since the Flaunch data API is mainnet-only.

yuka status [--testnet] [--json]

# Example output
Your tokens (1) — Base

  My Agent (AGT)
    Token:  0x1234...abcd
    Mcap:   0.0023 ETH
    Trade:  https://flaunch.gg/base/coin/0x1234...abcd
    Date:   5/1/2026

yuka price

Fetch live market data for any Flaunch token by contract address.

yuka price <tokenAddress> [--amount <eth>] [--json]

yuka price 0x1234...abcd
yuka price 0x1234...abcd --amount 0.01

yuka fees

Check how much ETH is claimable from accumulated trading fees. Reads live from the PositionManager smart contract.

yuka fees [--testnet] [--json]

# Example output
Claimable:          0.004821 ETH
After Protocol Fee: ~0.004339 ETH
Protocol Fee:       10%
Wallet Balance:     0.0500 ETH
Can Claim:          true

yuka claim

Sweep all accumulated trading fees to the wallet. Run yuka fees first to see the amount and check if it's worth the gas cost.

yuka claim [--testnet] [--json]

A 10% protocol fee applies on claim. Requires a small amount of ETH for gas.

Agent Workflow

Typical sequence for an AI agent running autonomously:

# 1. Check wallet
yuka wallet --json

# 2. Fund if needed
yuka fund --json

# 3. Launch token (once)
yuka launch --name "MyAgent" --symbol "AGT" --json

# 4. Verify it's live
yuka status --json

# 5. Periodically check fees
yuka fees --json

# 6. Claim when balance is worth it
yuka claim --json

Python example:

import subprocess, json

def check_and_claim():
    fees = json.loads(subprocess.run(
        ["npx", "hi-yuka", "fees", "--json"],
        capture_output=True, text=True
    ).stdout)
    # response shape: {"ok": true, "command": "fees", "data": {...}}
    if fees.get("ok") and fees["data"].get("canClaim"):
        result = json.loads(subprocess.run(
            ["npx", "hi-yuka", "claim", "--json"],
            capture_output=True, text=True
        ).stdout)
        if result.get("ok"):
            print("Claimed:", result["data"].get("claimed"))

JSON Mode

All commands support --json for structured output. Use this when integrating with an AI agent or automation pipeline.

yuka wallet --json
# {"ok":true,"command":"wallet","data":{"address":"0x...","balance":"0.05","network":"Base"}}

yuka fees --json
# {"ok":true,"command":"fees","data":{"claimable":"0.004821 ETH","canClaim":true,...}}

yuka launch --name "AGT" --symbol "AGT" --json
# {"ok":true,"command":"launch","data":{"tokenAddress":"0x...","txHash":"0x...","flaunch":"..."}}

# Errors also return JSON:
# {"ok":false,"command":"launch","error":{"code":"INSUFFICIENT_FUNDS","message":"..."}}

Networks

Exit Codes