From 99a1ed596c718e6beea8db923e40ddad6dbfa01c Mon Sep 17 00:00:00 2001 From: Anton Sauchyk Date: Tue, 17 Nov 2026 15:30:06 +0100 Subject: [PATCH] docs: require pumpfun-cli 0.3.1 and fix the balance checks 0.3.1 restores the tokens listings. wallet balance shows SOL only, so the pre-trade checks point to wallet tokens for other quote assets. --- README.md | 7 +++---- SKILL.md | 10 +++++----- references/SAFETY.md | 2 +- scripts/check-prereqs.sh | 4 ++-- 4 files changed, 11 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index e417389..ba224e7 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ An agent skill for trading on **pump.fun** and on **letsbonk.fun**, **StonkFun** and every other launchpad on Raydium LaunchLab, through [pumpfun-cli](https://github.com/chainstacklabs/pumpfun-cli). It gives your AI agent what it needs to buy and sell on the bonding curve and in PumpSwap and Raydium CPMM pools, launch pump.fun coins, and manage a wallet, with dry runs and safety checks before real funds move. -Works with any agent that supports the [Agent Skills](https://agentskills.io/home) standard: [OpenClaw](https://github.com/openclaw/openclaw), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.com), [Codex](https://openai.com/index/codex/) and others. +Works with any agent that supports the [Agent Skills](https://agentskills.io/home) standard: [OpenClaw](https://github.com/openclaw/openclaw), [Claude Code](https://code.claude.com/docs), [Cursor](https://cursor.com), [Codex](https://openai.com/index/codex/) and others. > **Also by Chainstack** > - [**pumpfun-cli**](https://github.com/chainstacklabs/pumpfun-cli) — the command-line tool this skill drives; usable on its own by humans and scripts. @@ -33,7 +33,7 @@ Works with any agent that supports the [Agent Skills](https://agentskills.io/hom ### 1. Prerequisites - [uv](https://docs.astral.sh/uv/getting-started/installation/) — it handles Python, no separate install needed -- pumpfun-cli **0.3 or later**: +- pumpfun-cli **0.3.1 or later**: ```bash uv tool install git+https://github.com/chainstacklabs/pumpfun-cli.git @@ -71,12 +71,11 @@ Set `PUMPFUN_PASSWORD` in the agent's environment so it can trade without a pass | Trading | Buy and sell on pump.fun and LaunchLab curves, and in PumpSwap and Raydium CPMM pools once a coin graduates; the CLI routes each trade and reports the `venue` | | Quote assets | Coins priced in SOL, USDC, tokenized stocks and other tokens, with Token-2022 transfer fees counted | | Launch | Launch a pump.fun coin from a hosted metadata URI, with an opening buy in the same transaction | +| Discovery | Browse pump.fun's trending, new and graduating coins, and search by name or ticker | | Fees and rewards | Collect creator fees, claim cashback, trigger a pump.fun migration | | Wallet | Create, import, export, balances, transfers, closing empty token accounts | | Safety | Dry runs first, slippage and priority-fee guidance, the CLI's error messages and what to do about each | -Token discovery (`pumpfun tokens`) uses pump.fun's frontend API, which currently refuses non-browser clients ([pumpfun-cli#33](https://github.com/chainstacklabs/pumpfun-cli/issues/33)); until that is fixed, the agent asks for the mint. - ## Structure ``` diff --git a/SKILL.md b/SKILL.md index 9e7feea..c2e6b06 100644 --- a/SKILL.md +++ b/SKILL.md @@ -8,10 +8,10 @@ description: > covers pump.fun token launch, migration, wallet management, and token discovery. Use when the user wants to trade, swap, buy, sell, launch, or manage pump.fun, letsbonk.fun or StonkFun tokens. -compatibility: "Requires uv and pumpfun-cli 0.3 or later (install via uv from github.com/chainstacklabs/pumpfun-cli)" +compatibility: "Requires uv and pumpfun-cli 0.3.1 or later (install via uv from github.com/chainstacklabs/pumpfun-cli)" metadata: author: chainstacklabs - version: "0.3" + version: "0.3.1" category: crypto-trading requires: bins: ["uv", "pumpfun"] @@ -35,7 +35,7 @@ uv tool install git+https://github.com/chainstacklabs/pumpfun-cli.git uv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git ``` -This installs `pumpfun` globally — available from any directory. `pumpfun --version` should report 0.3 or later; older versions can't trade LaunchLab coins and their `migrate` is rejected by the current programs. +This installs `pumpfun` globally — available from any directory. `pumpfun --version` should report 0.3.1 or later; with 0.3.0 pump.fun refuses the `tokens` listings, and older versions can't trade LaunchLab coins and their `migrate` is rejected by the current programs. ## Pre-Trade Checklist @@ -43,7 +43,7 @@ Before any trade, verify: 1. **Wallet exists**: `pumpfun wallet show` — confirms keystore is set up 2. **RPC configured**: `pumpfun config set rpc `, or `PUMPFUN_RPC` env var, or `--rpc` flag -3. **Balance sufficient**: `pumpfun wallet balance` — SOL for fees, plus the coin's quote asset for the spend +3. **Balance sufficient**: `pumpfun wallet balance` shows SOL, needed for fees and for the spend on a SOL coin; for a coin priced in another asset, `pumpfun wallet tokens` shows that asset's balance 4. **Token status**: `pumpfun info ` — which venue the coin trades on (`venue`), whether it has graduated, and which quote asset it is priced in (`quote_symbol`) ## Smart Routing @@ -184,7 +184,7 @@ These apply to ALL commands: | "CPMM pool is not open yet" | The LaunchLab curve is complete, Raydium hasn't opened the pool | Wait and retry | | "graduated to Raydium AMM v4" | The LaunchLab coin migrated somewhere this CLI can't trade | Don't trade it with this CLI | | "getProgramAccounts" | The RPC won't search LaunchLab pools for a coin priced in something other than SOL | Use an RPC that serves `getProgramAccounts` | -| "pump.fun API returned HTTP 403" from `tokens` | pump.fun's listing API is refusing non-browser clients | Listings are unavailable; ask the user for the mint | +| "pump.fun API returned HTTP 403" from `tokens` | pump.fun's listing API refused the request; it is unofficial and changes without notice | Upgrade the CLI if `pumpfun --version` is below 0.3.1; otherwise listings are unavailable, ask the user for the mint | ## Full Command Reference diff --git a/references/SAFETY.md b/references/SAFETY.md index dc8aedf..4418475 100644 --- a/references/SAFETY.md +++ b/references/SAFETY.md @@ -4,7 +4,7 @@ 1. **Dry-run first** — always simulate with `--dry-run` before committing funds 2. **Check token info** — run `pumpfun info ` to understand current price, reserves, and graduation status -3. **Verify balance** — `pumpfun wallet balance` to confirm you can cover the trade (in the coin's quote asset) + transaction fees in SOL +3. **Verify balance** — confirm you can cover the trade in the coin's quote asset plus transaction fees in SOL: `pumpfun wallet balance` shows SOL, `pumpfun wallet tokens` shows any other quote asset 4. **Know the routing** — bonding curve tokens and graduated AMM tokens behave differently, and `venue` says which one a trade used ## Slippage Management diff --git a/scripts/check-prereqs.sh b/scripts/check-prereqs.sh index de7acad..3b2f9df 100755 --- a/scripts/check-prereqs.sh +++ b/scripts/check-prereqs.sh @@ -10,10 +10,10 @@ if ! command -v pumpfun &>/dev/null && ! uv run pumpfun --version &>/dev/null 2> errors=$((errors + 1)) else version=$( (pumpfun --version 2>/dev/null || uv run pumpfun --version 2>/dev/null) | awk '{print $NF}') - if [ "$(printf '%s\n' 0.3.0 "$version" | sort -V | head -1)" = "0.3.0" ]; then + if [ "$(printf '%s\n' 0.3.1 "$version" | sort -V | head -1)" = "0.3.1" ]; then echo "OK: pumpfun CLI $version available" else - echo "ERROR: pumpfun CLI $version is older than 0.3. Upgrade: uv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git" + echo "ERROR: pumpfun CLI $version is older than 0.3.1. Upgrade: uv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git" errors=$((errors + 1)) fi fi