hot-fun-ai

Hot.fun AI skills for creating meme tokens on Solana. Lets agents integrate with hot.fun for token creation.

Skills

| Skill | Description | |-------|-------------| | hot-fun-integration | Create meme tokens on Solana via hot.fun API + on-chain transaction. |

Safety, user agreement, and detailed agent behavior requirements are defined in skills/hot-fun-integration/SKILL.md (bilingual User Agreement & Security Notice). Claude-specific guidance lives in CLAUDE.md.

Usage (Agent)

When the user needs to create meme tokens on hot.fun (Solana), use the hot-fun-integration skill:

• Create token: hotfun create-token <name> <symbol> <image_url> [--description "desc"] [--x-royalty-party "user"] — calls the hot.fun API (with agent authentication) to get a transaction, signs it with the wallet private key, and sends it to Solana RPC. See SKILL.md and references/api-create-token.md for full details.
• CLI (after npm install): use npx hotfun <command> [args...]. Run npx hotfun --help for all commands.

Install (project)

cd hot-fun-ai
npm install

Environment variables (without OpenClaw)

When you do not use OpenClaw, the CLI reads PRIVATE_KEY and SOLANA_RPC_URL from the process environment. Set them in one of these ways:

Option 1: .env file in the working directory

Create a file named .env in the directory where you run hotfun:

# .env (do not commit this file)
PRIVATE_KEY=your_solana_private_key_base58_or_json_array
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

The CLI automatically loads .env from the current working directory.

Option 2: export in the shell

export PRIVATE_KEY=your_solana_private_key
export SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
npx hotfun create-token MyToken MTK "https://example.com/image.png" --description "A cool token"

• PRIVATE_KEY: Required for any command that signs or sends a transaction. Base58 string or JSON array of bytes.
• SOLANA_RPC_URL: Optional. Solana RPC endpoint; if unset, scripts use https://api.mainnet-beta.solana.com.

Security: Do not commit .env or share your private key. Add .env to .gitignore if you use a .env file.

Install as OpenClaw plugin

This repo is an OpenClaw-compatible plugin:

openclaw plugins install /path/to/hot-fun-ai

Then in ~/.openclaw/openclaw.json set:

{
  skills: {
    entries: {
      "hot-fun-ai": {
        enabled: true,
        env: {
          PRIVATE_KEY: "your_solana_private_key",
          SOLANA_RPC_URL: "https://api.mainnet-beta.solana.com"
        }
      }
    }
  }
}

See skills/hot-fun-integration/SKILL.md for full details.

Docs

• Skill instructions (agent behavior, safety, flows): skills/hot-fun-integration/SKILL.md
• Claude/Claude Code guidelines: CLAUDE.md
• References: skills/hot-fun-integration/references/ (API docs)

License

MIT