npm package: @hot-fun/hot-fun-ai
Description: Hot.fun AI skills for creating meme tokens on Solana
Latest version: 1.0.2

# hot-fun-ai

Hot.fun AI skills for creating meme tokens on **Solana**. Lets agents integrate with [hot.fun](https://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`](skills/hot-fun-integration/SKILL.md) (bilingual User Agreement & Security Notice). Claude-specific guidance lives in [`CLAUDE.md`](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)

```bash
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`:

```bash
# .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**

```bash
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](https://docs.openclaw.ai)-compatible plugin:

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

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

```json5
{
  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](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