atomic-watch

Polls a pump.fun creator-fee vault and triggers atomic Jito-bundle collection when a SOL threshold is crossed.

15|2|Updated May 19, 2026
One-click install
npx skills add https://github.com/nirholas/atomic --skill atomic-watch-nirholas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atomic-watch
Source: https://github.com/nirholas/atomic/tree/main/skills/watch
Command: npx skills add https://github.com/nirholas/atomic --skill atomic-watch-nirholas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually running a collect script every time a pump.fun creator-fee vault fills up is tedious and error-prone, and collecting too early wastes Jito tips on small balances. This Skill deploys a long-running daemon that watches the vault and fires an atomic collect-and-drain transaction only when the balance crosses a configured threshold. ## Core Features & Use Cases - Threshold-based auto-collection: Polls the coin's coinCreatorVault PDA on a configurable interval and runs collect-jito.js only when the balance exceeds MIN_COLLECT_SOL. - Atomic drain via Jito bundles: Each collect bundles the fee claim and the transfer to a safe DESTINATION wallet, so a leaked creator key cannot be swept by a searcher mid-flow. - Deployment-ready daemon: Designed to run under Railway, Fly, systemd, PM2, or a screen session, with documented failure modes (RPC rate limits, stale tip accounts, duplicate instances) and fixes. - Use Case: A token creator deploys the watcher to Railway with MIN_COLLECT_SOL=0.05; every time trading fees accumulate past 0.05 SOL, the daemon automatically collects and drains them to a cold wallet without any manual intervention. ## Quick Start Set the required environment variables (RPC_URL, FUNDER_SECRET, CREATOR_PUBKEY, CREATOR_SECRET, MINT, DESTINATION, MIN_COLLECT_SOL) and ask the assistant to start the watch-collect daemon to auto-collect creator fees for your pump.fun coin.

Frequently Asked Questions about atomic-watch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically collect pump.fun creator fees?▼

Run the watch-collect.js daemon with your MINT, DESTINATION, and MIN_COLLECT_SOL environment variables set. It polls the creator-fee vault on a schedule and fires an atomic collect-and-drain transaction via a Jito bundle whenever the balance crosses your threshold.

How do I deploy a Solana collect bot on Railway?▼

Clone the repo into a Railway project, set all secret and config variables in Railway's Variables tab, and set the Start Command to node src/watch-collect.js. Logs will show a polling line every 30 seconds and a Solscan link after each successful collect.

Does the watcher need the creator private key to poll the vault?▼

No, polling only requires CREATOR_PUBKEY, so the creator secret can stay offline most of the time. The secret is loaded only at collect-fire time to sign the collect instruction, though a remote signer is the recommended long-term option.

Why does the watch-collect script exit after a few minutes?▼

Silent exits are usually caused by RPC rate limiting or network glitches, since any uncaught exception terminates the process. Use a paid RPC provider and a supervisor such as PM2, systemd, or Railway's restart policy to keep it running.

When should I use one-shot collect instead of the auto-collect daemon?▼

Use the one-shot collect skill when you want to drain the vault immediately a single time. The daemon is only worthwhile for ongoing fee collection where you want threshold-based, unattended operation; for a full drain of vault plus creator and funder wallets, use the consolidate skill.