pump-solana-architecture

Derive and organize Solana PDAs and account layouts for Pump ecosystem programs.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/x402agent/NanoSolana --skill pump-solana-architecture-x402agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pump-solana-architecture
Source: https://github.com/x402agent/NanoSolana/tree/main/pump-fun-sdk-main/skills/pump-solana-architecture
Command: npx skills add https://github.com/x402agent/NanoSolana --skill pump-solana-architecture-x402agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design, derive, and manage Program Derived Addresses (PDAs) and account layouts across the Pump ecosystem's four Solana programs with cross-program invocation patterns.

Core Features & Use Cases

  • PDA categories: global singletons, per-token PDAs, per-user PDAs, and Mayhem PDAs, with cross-program coordination.
  • PDA derivation best practices: use findProgramAddressSync and avoid manual bumps.
  • Use Case: design and verify on-chain state layouts for Pump, PumpAMM, PumpFees, and Mayhem to ensure consistent inter-program interactions.

Quick Start

Run a quick PDA derivation example against a sample mint to see how global, per-token, and per-user PDAs are computed.

Frequently Asked Questions about pump-solana-architecture

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

FAQPage Schema
How do I derive Solana PDAs for Pump, PumpAMM, and PumpFees cross-program invocations?

To derive Solana PDAs for Pump, PumpAMM, and PumpFees cross-program invocations, apply findProgramAddressSync to generate global singletons, per-token, and per-user addresses with consistent state management.

What is the best way to structure on-chain account layouts for Solana multi-program architectures?

Structuring on-chain account layouts for Solana multi-program architectures requires organizing PDAs into structured category mappings for global, per-token, and per-user states to ensure consistent inter-program interactions.

How do cross-program invocations work with Mayhem PDAs in the Pump ecosystem?

Cross-program invocations with Mayhem PDAs in the Pump ecosystem work by applying PDA derivation best practices to coordinate state across Pump, PumpAMM, PumpFees, and Mayhem programs, ensuring precise address management.

Why should I use findProgramAddressSync instead of manual bumps for Solana PDA derivation?

You should use findProgramAddressSync instead of manual bumps for Solana PDA derivation because it enforces best practices, preventing address collisions and ensuring deterministic state access across cross-program invocations.

Can I use this PDA derivation approach for Solana global singleton and per-token accounts?

Yes, you can use this PDA derivation approach for Solana global singleton and per-token accounts, as it provides structured category mappings specifically designed to handle global, per-token, and per-user PDA states.

What are the limitations of manual PDA bumps in Pump ecosystem cross-program architectures?

Manual PDA bumps in Pump ecosystem cross-program architectures risk address mismatches and state inconsistencies, which is why enforcing findProgramAddressSync is necessary for reliable inter-program interactions across Pump and Mayhem.