Pump.fun bundler CLI

TypeScript CLI for orchestrating Pump.fun token metadata, mint creation, multi-wallet bundle buys (via lookup tables + bundle relay), SOL routing across bundler wallets, and holder workflows. It wraps @solana/web3.js, Anchor, and a bundled Pump.fun IDL/SDK-style client.

Status & health check

| Check | Command | Notes | |--------|---------|--------| | Dependencies | npm install | Uses package-lock.json. | | Types | npm run typecheck | Requires settings.ts (see setup). | | CLI boot | printf "5\n" \| npm start | Should print the main menu then exit on option 5. |

Fix applied in this repo: layout/index.ts referenced three modules that were missing (createTokenBuy, presimulate, solDistribute). Implementations are now included so imports resolve and tsc succeeds.

Quick start

1. Install

npm install

Use Node.js 18+ (global Blob / fetch used for Pump.fun metadata upload).

2. Environment

Create a .env file in the project root (values must match what config.ts expects):

RPC_ENDPOINT=
RPC_WEBSOCKET_ENDPOINT=wss://your-websocket-endpoint.example
LILJITO_RPC_ENDPOINT=
JITO_FEE=0.0002
BLOCKENGINE_URL=frankfurt.mainnet.block-engine.jito.wtf
COMPUTE_UNIT_PRICE=6000000

You can align with the checked-in template .env.example.ts (same keys; rename/copy into .env).

3. Settings (wallets + token)

cp settings.example.ts settings.ts

Edit settings.ts:

• LP_wallet_* — creator wallet used for the on-chain create instruction.
• Bundler_provider_* — funds bundler wallets and pays Jito tip / LUT flows where applicable.
• token — metadata (name, symbol, description, socials, image path). After a successful launch, mintPk should hold the mint’s base58-encoded secret key (the tooling also writes wallets/mint_secret.bs58 during create).

settings.ts is gitignored — never commit real keys.

4. Token image

Place your artwork at the path set in token.image (default: ./src/image/2.jpg). A tiny placeholder JPEG ships under src/image/2.jpg so paths resolve out of the box.

5. Run

npm start

Scripts

| Script | Purpose | |--------|---------| | npm start / npm run dev | Interactive menu (ts-node index.ts). | | npm run close | Close address lookup table (closeLut.ts). | | npm run typecheck | tsc --noEmit (needs settings.ts). |

What the menu does

1. Token launch — Presimulate create metadata + create tx; Create token & bundle buy uploads metadata to Pump.fun IPFS, sends create, funds bundlers, builds an ALT, then submits buy txs via sendBundle (executor/lilJito.ts).
2. Token sell & buy — Bundler sells / rebuy flows using the Pump client.
3. Gather SOL — Sweep SOL (and token accounts where relevant) from bundlers; fund bundlers in batches (sol distribute).
4. Balances — Ins