atomic

Use when the user wants to launch, buy, collect creator fees from, rescue tokens from, or distribute rewards for a pump.fun coin in a way that is atomic across multiple Solana txs (Jito bundles). Also covers the `check-pump-funding` wallet-provenance tool. Triggers on requests like "launch a pump coin", "collect creator fees", "atomic buy via Jito", "rescue tokens from a leaked key", "did pump.fun seed this wallet", or any mention of `fire-jito`, `collect-jito`, `buy-jito`, `consolidate`, `rescue-tokens`, or `distribute`.

Use when the user is debugging a Jito bundle that did not land, returned an error, or behaved unexpectedly. Triggers on "bundle didn't land", "Invalid bundle", "Jito returned Invalid", "bundle stuck pending", "tip too low", "Bundles must write lock at least one tip account", "simulation failed", "getBundleStatuses", "check bundle UUID", or any operational failure of Jito-bundle-based scripts in this repo (fire-jito, collect-jito, buy-jito, rescue-tokens, consolidate, distribute when bundled).

Use when the user is reasoning about pump.fun creator-fee economics — when to collect, what threshold to use for the watch-collect loop, how to compare collect cost vs accrual rate, when to consolidate vs let fees accumulate, or whether a coin's fee stream is worth the operational cost. Triggers on "is it worth collecting", "what MIN_COLLECT_SOL should I use", "fees vs tip cost", "break-even point", "collect frequency", "fee curve", "creator fee economics", or "creator rewards math".

Use when the user wants to analyze the holder distribution of a pump.fun coin (or any Solana SPL/Token-2022 mint) — concentration, Gini coefficient, top-N percent, histogram by order of magnitude, or detect Sybil signals. Triggers on "analyze holders", "holder distribution", "Gini coefficient", "top 10 holders", "is this coin Sybil", "concentration check", "who holds this mint", "pre-distribute check", or any request to characterize the holder base before running a distribution / airdrop / governance action.

Use when the user reports or suspects a Solana wallet key has leaked, been shared, was found in version control, or is being watched by sweeper bots, and they need a step-by-step incident-response plan. Triggers on "key leaked", "wallet compromised", "sweeper draining my wallet", "creator key shared", "private key in git", "find leak", "what do I do my key is out there", "recover funds from leaked wallet", or "key in chat". Drives the user through the multi-step Jito-bundle recovery sequence with explicit decision branches.

Use when the user is reasoning about MEV (Maximal Extractable Value), sweeper bots, sniper bots, sandwich attacks, or front-running risk on Solana — and wants to pick the right countermeasure from this toolkit. Triggers on "MEV protection", "sweeper bots", "sniper bot", "front-running", "sandwich attack", "atomic", "Jito bundle", "how do I prevent X from racing me", "same-block insertion", or any threat-model question about adversarial actors at the Solana tx level. Decision skill — points at the right flow rather than implementing a new one.

Use when the user wants to launch a pump.fun coin AND buy a meaningful position in the same atomic Jito bundle, so that no third-party sniper can land between the create tx and the dev-buy. Triggers on "launch with dev buy", "sniper launch", "atomic launch and buy", "MEV-protect my launch", "self-snipe my own coin", "DEV_BUY_SOL", "launch + buy in one bundle", or any request that combines coin creation with an immediate buy. Different from atomic-launch (which is launch-only) and atomic-buy (which is buy-only on an existing coin).

Use when the user wants to migrate code, scripts, or downstream consumers from pump.fun's V1 (SOL-pool) layout to V2 (USDC-pool) layout, or is debugging an issue caused by the V2 USDC rollout. Triggers on "V2 USDC", "pump V2", "V1 to V2 migration", "USDC pool", "quote mint", "new discriminator", "BuybackFeeRecipient", "event layout changed", "pump-sdk doesn't decode", "creator fees in USDC now", or any V1→V2 migration question. The rollout happened 2026-05; code written before that date may need updates.

Use when the user wants to drain a coin's creator vault plus the creator wallet plus the funder wallet — all into a single safe `DESTINATION` — in one atomic Jito bundle. Used to retire a coin or recover from a leaked-key situation without leaving any residual SOL on intermediate wallets. Triggers on "consolidate wallets", "consolidate.js", "drain funder + creator + vault", "retire pump coin", "sweep everything to safe wallet", or any request to clear three wallets into one in a single tx.

Use when the user wants to determine whether a Solana wallet was "seeded by pump.fun" — i.e. its first inbound SOL transfer came from a known pump.fun fee recipient or migration authority. Useful for wallet provenance audits, distinguishing genuine pump.fun-originated activity from cosplay, or detecting if a creator wallet was bootstrapped by the protocol itself. Triggers on "was this wallet funded by pump", "check-pump-funding", "wallet provenance", "detect pump-seeded wallet", "is this a pump.fun wallet", or any wallet-origin audit task.

Use when the user wants to generate a vanity Solana keypair whose pubkey starts with a chosen prefix — for a recognizable creator address, a brand-themed wallet, or matching a project's ticker. Triggers on "grind a vanity address", "vanity keypair", "grind.js", "solana-keygen grind", "creator address starts with", or any CPU-bound keypair-search task. Strongly prefers `solana-keygen grind` (Rust, multithreaded) over the JS fallback.

Use when the user wants to upload pump.fun token metadata (name, symbol, image) to pump.fun's IPFS endpoint and get back a `https://ipfs.io/ipfs/<CID>` URI for use in the create instruction. Triggers on "upload metadata", "pump.fun IPFS upload", "metadata.js", "get a URI for my token", or any pre-launch metadata-uploading task.

Use when the user wants a long-running poller that monitors a pump.fun coin's creator-fee vault and automatically runs `collect-jito` whenever the accumulated balance crosses a threshold. Triggers on "watch creator fees", "auto-collect", "watch-collect.js", "deploy collect bot on Railway", "long-running collect", or any request to schedule recurring vault drains without manual intervention.

Use when the user wants to determine whether a Solana wallet was seeded (funded) by pump.fun — a provenance / forensics check. Triggers on "did pump.fun seed this wallet", "check-pump-funding", "detectSeededByPump", "wallet provenance", "funding source check", or any audit of pump.fun funding lineage.

Use when the user wants to buy a pump.fun (or any Solana SPL) token via a Jito bundle, especially when the pump-sdk buy instruction is out of sync with the live program. Routes via Jupiter aggregator inside a Jito bundle for atomicity and front-running protection. Triggers on "buy a pump coin", "buy-jito", "jupiter buy via jito", "sniper buy", or any token purchase where atomicity matters.

Use when the user wants to collect pump.fun creator fees atomically — preventing other holders of a shared/leaked creator key from racing to drain the vault, or sweeping creator+funder wallets along with the vault in a single Jito bundle. Triggers on "collect creator fees", "drain pump vault", "collect-jito", "watch-collect", "consolidate funder + creator + vault", or any pump.fun creator-fee withdrawal.

Use when the user wants to distribute USDC rewards to holders of a pump.fun coin with sqrt-weighted allocation and a minimum-bps floor, or to do an EMERGENCY sweep of all rewards to a single address. Triggers on "distribute rewards", "pay out holders", "distribute.js", "rewards bot", "sqrt weighted distribution", or "EMERGENCY sweep".

Use when the user wants to launch a new pump.fun coin where the fee-payer wallet differs from the on-chain creator wallet, or wants on-chain creator attribution to match a specific wallet while a separate funder pays rent + Jito tip. Triggers on "launch a pump coin", "create pump.fun token", "fire-jito", "fire-atomic-create", "upload pump metadata", or any request to mint a pump.fun coin with separate funder vs creator.

Use when the user wants to atomically move SPL or Token-2022 balances out of a leaked / shared / sweeper-watched wallet, without giving sweeper bots a window to insert. Triggers on "rescue tokens", "rescue-tokens", "drain leaked wallet", "buy and transfer atomically", "token-2022 sweeper", or any SPL transfer under bot competition.