atomic docs
nirholas / atomic

atomic

Atomic pump.fun launch + fee collection + buy/transfer scripts using Jito bundles

v0.1.0SEE LICENSE IN LICENSETypeScript
npm install

What it does

Capabilities documented in this repository.

At a glance

See the full documentation for details.

Layout

See the full documentation for details.

Docs

See the full documentation for details.

Setup

See the full documentation for details.

Scripts

See the full documentation for details.

Typical launch flow

See the full documentation for details.

Get started

Install it, then run your first command.

npm install
CommandRuns
npm run testvitest run
npm run typechecktsc --noEmit

Read the full getting started guide

Examples

Taken directly from this repository's documentation.

█████╗ ████████╗ ██████╗ ███╗   ███╗██╗ ██████╗
  ██╔══██╗╚══██╔══╝██╔═══██╗████╗ ████║██║██╔════╝
  ███████║   ██║   ██║   ██║██╔████╔██║██║██║
  ██╔══██║   ██║   ██║   ██║██║╚██╔╝██║██║██║
  ██║  ██║   ██║   ╚██████╔╝██║ ╚═╝ ██║██║╚██████╗
  ╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝     ╚═╝╚═╝ ╚═════╝
       all-or-nothing pump.fun launching & fee collection
.
├── src/                       Runnable scripts (CommonJS, run via `node src/<name>.js`)
│   ├── fire-jito.js, collect-jito.js, …
│   └── lib/                   Shared TS helpers
│       ├── funding-source.ts  detectSeededByPump implementation
│       ├── programs.ts        Pump.fun program IDs + fee recipients
│       └── funding-source.test.ts
├── tools/                     Read-only CLI tools (run via tsx)
│   ├── check-pump-funding.ts  CLI wrapper around detectSeededByPump
│   ├── sanity-check.ts        Pre-flight env / keypair / balance check
│   ├── check-balances.ts      SOL + SPL / Token-2022 balances for a wallet
│   ├── check-bundle-status.ts Query a Jito bundle by UUID
│   ├── check-tip-accounts.ts  Diff live Jito tip accounts against the hardcoded list
│   └── analyze-holders.ts     Holder distribution, concentration, Gini
├── .env.example               Copy to `.env` and fill in
├── package.json               npm scripts cover every runnable file
└── tsconfig.json              Type-checks src/lib/ + tools/
npm install
cp .env.example .env
# fill in .env with your keys and target addresses

More examples

Reference