# Send Tokenbroker to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tokenbroker",
    "name": "Tokenbroker",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/starrftw/tokenbroker",
    "canonicalUrl": "https://clawhub.ai/starrftw/tokenbroker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/tokenbroker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tokenbroker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "GITHUB.md",
      "LAUNCH.md",
      "METADATA.md",
      "PROJECT-SCAN.md",
      "PROMO.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "tokenbroker",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T03:13:28.407Z",
      "expiresAt": "2026-05-17T03:13:28.407Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tokenbroker",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tokenbroker",
        "contentDisposition": "attachment; filename=\"tokenbroker-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "tokenbroker"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/tokenbroker"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tokenbroker",
    "downloadUrl": "https://openagent3.xyz/downloads/tokenbroker",
    "agentUrl": "https://openagent3.xyz/skills/tokenbroker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tokenbroker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tokenbroker/agent.md"
  }
}
```
## Documentation

### Local Storage Only

All credentials (GitHub token, private keys, API keys) are stored locally in a .env file
No credentials are transmitted to external servers beyond their intended endpoints (GitHub API, nad.fun API, Monad RPC)
The skill operates entirely within your local environment

### .env File Generation

The Install Wizard generates a .env file on your local machine
This file is never committed to version control (gitignored)
You can review and edit it at any time

### Credential Scope

GITHUB_TOKEN: Used only for GitHub API calls to read public repository data
PRIVATE_KEY: Used only for EVM transaction signing (never exposed in plain text)
BUILDER_ID: Local identifier for A2A protocol
NAD_FUN_API_KEY: Used only for nad.fun token creation API

### Testnet Mode

Default operation is on testnet for safety
Mainnet requires explicit configuration
Always review transactions before signing

The AI agent skill for memecoin launches on nad.fun. Analyze GitHub projects, generate token metadata, and launch directly on nad.fun bonding curves.

### What is TokenBroker?

TokenBroker is a complete memecoin launch solution for AI agents:

Analyzes GitHub projects to identify meme-worthy projects
Generates token names, tickers, descriptions, and marketing content
Launches tokens on nad.fun (image, metadata, salt, deploy)
Promotes launches with X/Telegram/Discord content

### TokenBroker Handles

GitHub repository analysis and scoring
Token identity generation (name, ticker, description)
Meme-style image generation
Nad.fun API integration (upload, salt mining)
Marketing content creation (X threads, Telegram, Discord)
Full launch orchestration

### Not Included

Wallet private key management (handled by host)
On-chain transactions beyond nad.fun bonding curves

### Architecture (tokenbroker/src/generators/)

generators/
├── identity.ts     # Token name, ticker, description generation
├── reasoning.ts    # Investment thesis, narrative creation
├── promo.ts        # X threads, Telegram, Discord content
├── nadfun.ts       # Nad.fun API: upload image/metadata, mine salt
└── index.ts        # Pipeline orchestrator (generateAll)

### Quick Start for Agents

import { generateAll, prepareLaunch } from './generators/index.js';

// 1. Analyze repo and generate all launch assets
const assets = await generateAll({
  repoAnalysis: await analyzeGitHubRepo('https://github.com/user/project')
});

console.log('Token name:', assets.identity.name);
console.log('Ticker:', assets.identity.ticker);
console.log('X Thread:', assets.promo.xThread.tweets);

// 2. Prepare launch on nad.fun (API calls only)
const prepared = await prepareLaunch(assets.identity, 'mainnet');
// -> Returns: { imageUri, metadataUri, salt, saltAddress }

// 3. Deploy on-chain (requires ethers + private key)
// Use deploy.ts module with wallet for on-chain execution

### generateIdentity(input)

Analyzes repo and generates token identity:

{
  name: "SWAPPRO",
  ticker: "SWAP", 
  tagline: "The next generation DeFi protocol",
  description: "Full token description...",
  nameReasoning: "How the name was derived"
}

### generateReasoning(input)

Creates investment thesis and narrative:

{
  investmentThesis: "Why this token should exist...",
  problemStatement: "The problem being solved",
  solution: "The proposed solution",
  marketOpportunity: "Market size and opportunity",
  competitiveAdvantage: "Why this wins",
  tokenUtilityRationale: "Token value proposition",
  vision: "Long-term vision"
}

### generatePromo(input)

Generates marketing content:

{
  xThread: { title, tweets: [...], hashtags, mentions },
  telegramPost: { title, content, hasButton, buttonText, buttonUrl },
  discordAnnouncement: { title, content, hasEmbed, embedColor, embedFields },
  tagline: "Marketing tagline",
  elevatorPitch: "One-liner pitch"
}

### prepareLaunch(identity, network)

Prepares token for nad.fun launch (API calls):

{
  imageUri: "ipfs://...",
  metadataUri: "ipfs://...", 
  salt: "0x...",
  saltAddress: "0x..."
}

### Nad.fun Integration

TokenBroker integrates directly with nad.fun API:

StepAPI EndpointFunction1POST /agent/token/imageuploadImage()2POST /agent/token/metadatauploadMetadata()3POST /agent/saltmineSalt()4BondingCurveRouter.create()On-chain deployment

### Network Configuration

NetworkAPIRPCTestnethttps://dev-api.nad.funhttps://testnet-rpc.monad.xyzMainnethttps://api.nadapp.nethttps://rpc.monad.xyz

### Install

npm install

### Configuration

# Network (testnet | mainnet)
NETWORK=mainnet

# GitHub (optional - for repo analysis)
GITHUB_TOKEN=ghp_...

### For On-Chain Deployment

TokenBroker prepares all launch data. For actual on-chain deployment:

npm install ethers

Then use with a wallet:

import { prepareLaunch } from './generators/nadfun.js';
import { ethers } from 'ethers';

const prepared = await prepareLaunch(identity, 'mainnet');

// Deploy with wallet
const wallet = new ethers.Wallet(privateKey, provider);
const router = new ethers.Contract(BONDING_CURVE_ROUTER, abi, wallet);
await router.create(tokenParams, fee, toll, tradingAmt, { value: deployFee });

Built for the agentic future. 🦞
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: starrftw
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T03:13:28.407Z
- Expires at: 2026-05-17T03:13:28.407Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/tokenbroker)
- [Send to Agent page](https://openagent3.xyz/skills/tokenbroker/agent)
- [JSON manifest](https://openagent3.xyz/skills/tokenbroker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/tokenbroker/agent.md)
- [Download page](https://openagent3.xyz/downloads/tokenbroker)