@four-meme/four-meme-ai 1.0.0 → 1.0.2

package/CLAUDE.md

@@ -57,9 +57,9 @@ Never ask the user to paste a private key into chat. All private keys must come
 3. **Create token**:
    - `raisedToken` must always come from `GET https://four.meme/meme-api/v1/public/config` and be used **as is** in the create body; do not invent or modify internal fields.
    - For tax-type tokens, follow `tokenTaxInfo` constraints in `references/token-tax-info.md` and the interactive flow in `SKILL.md` (“Create token (full flow)”).
-4. **RPC**:
-   - Use env `BSC_RPC_URL` when set; otherwise fall back to public BSC RPC defaults (see scripts).
-   - Private key envs: `PRIVATE_KEY` or `FOURMEME_PRIVATE_KEY` (no key should ever be requested from the user in plain text).
+4. **RPC and private key (environment)**:
+   - When **using OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are configured in OpenClaw (e.g. `skills.entries["four-meme-ai"].env` or apiKey); see SKILL.md.
+   - When **not using OpenClaw (standalone)**: set `PRIVATE_KEY` (or `FOURMEME_PRIVATE_KEY`) and optionally `BSC_RPC_URL` via the process environment—e.g. a `.env` file in the project root (loaded by the user before running `npx fourmeme`) or shell `export`. The scripts do not load `.env` automatically; the variables must be in the environment when the CLI runs. Do not ask the user to paste a private key in chat.
 
 ## CLI Usage (fourmeme)
 

package/README.md

@@ -27,6 +27,35 @@ cd four-meme-ai
 npm install
 ```
 
+## Environment variables (without OpenClaw)
+
+When you **do not** use OpenClaw, the CLI reads `PRIVATE_KEY` and `BSC_RPC_URL` from the process environment. Set them in one of these ways:
+
+**Option 1: `.env` file in the project root**
+
+Create a file named `.env` in the repo root (same directory as `package.json`):
+
+```bash
+# .env (do not commit this file)
+PRIVATE_KEY=your_hex_private_key_with_or_without_0x_prefix
+BSC_RPC_URL=https://bsc-dataseed.binance.org
+```
+
+Then run commands so that the shell loads `.env` before invoking `fourmeme` (e.g. use a tool that loads `.env`, or `export $(cat .env | xargs)` then `npx fourmeme ...`). The scripts themselves do not load `.env`; you must ensure the variables are in the environment when `npx fourmeme` runs.
+
+**Option 2: export in the shell**
+
+```bash
+export PRIVATE_KEY=your_hex_private_key
+export BSC_RPC_URL=https://bsc-dataseed.binance.org
+npx fourmeme create-api ./logo.png MyToken MTK "Desc" AI
+```
+
+- **PRIVATE_KEY** (or **FOURMEME_PRIVATE_KEY**): Required for any command that signs or sends a transaction (create-api, create-chain, buy, sell, send, 8004-register). Hex string; `0x` prefix optional.
+- **BSC_RPC_URL**: Optional. BSC RPC endpoint; if unset, scripts use a default public BSC RPC.
+
+**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. Install so the skill is loaded and **PRIVATE_KEY / BSC_RPC_URL** are only injected for this skill (via `skills.entries`):
@@ -42,7 +71,7 @@ Then in `~/.openclaw/openclaw.json` set:
 {
   skills: {
     entries: {
-      "four-meme-integration": {
+      "four-meme-ai": {
         enabled: true,
         env: {
           PRIVATE_KEY: "0x...",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@four-meme/four-meme-ai",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Four.meme AI skills for creating and trading meme tokens (BSC only)",
   "license": "MIT",
   "type": "module",
@@ -48,8 +48,7 @@
     "typescript": "^5.0.0",
     "viem": "^2.0.0"
   },
-  "dependencies": {
-    "four-meme-ai": "^1.0.0"
-  },
-  "publishConfig": { "access": "public" }
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/skills/four-meme-integration/SKILL.md

@@ -12,8 +12,8 @@ description: |
   - Querying TaxToken fee/tax config on-chain (BSC only)
   - **Discover → detail → quote → execute**: use token-rankings / token-list / events to find tokens → token-get / token-info for details → quote-buy / quote-sell to estimate → buy / sell to execute (see "Agent workflow: buy/sell from rankings or events" below).
 
-  BSC only (Arbitrum/Base not supported). Requires npm install. Create/chain need PRIVATE_KEY. TokenManager V1 not supported.
-  **OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are declared in metadata and injected by OpenClaw only when this skill is enabled (only this skill can access them). Configure in `~/.openclaw/openclaw.json` under `skills.entries["four-meme-ai"].env` or `apiKey`.
+  BSC only (Arbitrum/Base not supported). **Before use, the fourmeme CLI must be installed** (e.g. `npm install -g @four-meme/four-meme-ai@latest`). Create/chain need PRIVATE_KEY. TokenManager V1 not supported.
+  **OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are declared in metadata and injected by OpenClaw only when this skill is **enabled** (only this skill can access them). **Two steps required**: (1) Configure private key in the skill’s `apiKey` or `skills.entries["four-meme-ai"].env`; (2) **Enable this skill** in the agent/session so OpenClaw injects the env. See "PRIVATE_KEY and BSC_RPC_URL" below.
 allowed-tools:
   - Bash(fourmeme *)
   - Bash(npx fourmeme *)
@@ -95,6 +95,16 @@ See the **CLI (fourmeme)** table and sections below for commands and arguments.
 
 BSC only; all commands output JSON. Run `fourmeme --help` for usage.
 
+## Installation (required before use)
+
+**You must install the fourmeme CLI before using this skill.** Recommended (global):
+
+```bash
+npm install -g @four-meme/four-meme-ai@latest
+```
+
+After installation, run commands with `fourmeme <command> [args]`. If you use a local install instead, use `npx fourmeme <command> [args]` from the project root.
+
 This skill provides: token creation (API + chain), buy/sell quotes and execution, token info/list/rankings, event listening, Tax token fee queries, send, and EIP-8004 identity NFT register and balance. Contract addresses and version notes: [references/contract-addresses.md](references/contract-addresses.md). **TokenManager V1 is not supported in this skill.**
 
 ## Create token flow
@@ -153,14 +163,22 @@ When the user asks to “buy/sell based on rankings or activity”, the Agent sh
 
 ## CLI (fourmeme)
 
-Run `npx fourmeme --help` for usage. From project root after `npm install`, use **`npx fourmeme <command> [args]`** (local install does not add `fourmeme` to PATH; use `npm link` for global `fourmeme`).
+Run `fourmeme --help` for usage. After **global install** (`npm install -g @four-meme/four-meme-ai@latest`), use **`fourmeme <command> [args]`**. With a local install only, use **`npx fourmeme <command> [args]`** from the project root.
+
+### PRIVATE_KEY and BSC_RPC_URL
+
+**When using OpenClaw**  
+This skill declares `requires.env: ["PRIVATE_KEY"]` and `primaryEnv: "PRIVATE_KEY"` in metadata; OpenClaw injects them only when an agent runs with **this skill enabled** (other skills cannot access them).
 
-### OpenClaw config (PRIVATE_KEY / BSC_RPC_URL)
+**Required steps:**
+1. **Configure private key**: In the Skill management page, set the four-meme-ai skill’s **apiKey** (corresponds to `primaryEnv: "PRIVATE_KEY"`), or set `PRIVATE_KEY` under `skills.entries["four-meme-ai"].env` in `~/.openclaw/openclaw.json`. Optionally set **BSC_RPC_URL** in global env if needed.
+2. **Enable this skill**: In the agent or session, ensure the **four-meme-ai** skill is **enabled**. Only when the skill is enabled will OpenClaw inject `PRIVATE_KEY` (and `BSC_RPC_URL`) into the process; otherwise create/buy/sell/send/8004-register will fail with missing key.
 
-This skill declares `requires.env: ["PRIVATE_KEY"]` and `primaryEnv: "PRIVATE_KEY"` in metadata; OpenClaw injects them when an agent runs with **only this skill** enabled (other skills cannot access them).
+**When not using OpenClaw (standalone)**  
+Set **PRIVATE_KEY** (or **FOURMEME_PRIVATE_KEY**) and optionally **BSC_RPC_URL** via the process environment so they are available when running `npx fourmeme` or `node bin/fourmeme.cjs`:
 
-- **apiKey**: Corresponds to `primaryEnv: "PRIVATE_KEY"`; you can enter the private key in the four-meme-ai skill’s `apiKey` field in the Skill management page.
-- **env**: Injected into the agent process for this skill; BSC_RPC_URL can be set in the global env management page.
+- **.env file**: Create a `.env` file in the project root with lines like `PRIVATE_KEY=...` and `BSC_RPC_URL=...`. The CLI scripts do not load `.env` automatically; you must load it before running (e.g. `export $(cat .env | xargs)` or a tool that injects `.env` into the process). Do not commit `.env`; add it to `.gitignore`.
+- **Shell export**: `export PRIVATE_KEY=your_hex_key` and `export BSC_RPC_URL=https://bsc-dataseed.binance.org` (or another BSC RPC), then run `npx fourmeme <command> ...`.
 
 | Need | Command | When |
 |------|---------|------|