atomic-v2-migration

Guides migration of pump.fun code from V1 SOL-pool layout to V2 USDC-pool layout.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pump.fun's May 2026 V2 upgrade changed quote-mints from SOL to USDC, added new instruction discriminators and accounts, and altered event layouts, breaking downstream code in hard-to-diagnose ways. This Skill identifies which changes affect a given codebase and routes each symptom to the correct fix and reference document. ## Core Features & Use Cases - Impact Diagnosis: A decision table maps your code's behavior (event parsing, instruction building, quote-mint assumptions) to the specific V2 changes that affect it. - Symptom-to-Fix Lookup: Common failures like MissingAccount errors, mis-scaled amounts, and empty creator vaults are matched to their root causes and remedies. - Ordered Migration Plan: An eight-step migration sequence from bumping pump-sdk to regression-testing against V1/V2 fixtures. - Use Case: Your event decoder silently ignores new pump.fun launches after May 2026. Use this Skill to identify the hardcoded V1 discriminator as the cause and follow the linked reference to update your decoder tables. ## Quick Start Ask the assistant to diagnose why your pump.fun event parser stopped decoding new launches after the V2 USDC rollout and produce a migration plan.

Frequently Asked Questions about atomic-v2-migration

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

FAQPage Schema
How do I migrate pump.fun code from V1 to V2 USDC pools?▼

Bump pump-sdk to version 1.30 or later, update hardcoded discriminator tables, add quote-mint branching for USDC versus SOL decimals, and update event handlers for the new fields. Finish by regression-testing against V1, V2-SOL, and V2-USDC fixtures.

Why does my pump.fun buy transaction fail with MissingAccount?▼

The MissingAccount error occurs when pump-sdk versions below 1.30 omit newly required accounts such as BuybackFeeRecipient. Upgrading the SDK resolves it, or you can route buys through Jupiter to avoid SDK drift.

Why does my pump.fun event decoder return null for new launches?▼

Hardcoded V1 discriminator filters silently skip V2 events because V2 uses new instruction and event discriminators like createV2 and swapV2. Update your discriminator table using the canonical V1 and V2 reference.

Does the pump.fun V2 upgrade affect creator fee payouts?▼

Yes, V2 USDC-quoted coins pay creator fees in USDC to an associated token account rather than SOL to the vault. Downstream collectors and accounting code must recognize and sweep USDC ATAs.

When do I not need to migrate my pump.fun code to V2?▼

Migration is unnecessary if your code only audits wallet provenance, runs this repo's already-updated scripts, or manipulates raw Solana primitives below the pump.fun layer. Tooling that exclusively touches pre-May-2026 V1 coins can also defer.