# cryptoscan-pro/pumpfun-sdk architecture

> Architecture diagram of the GitHub repository cryptoscan-pro/pumpfun-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cryptoscan-pro/pumpfun-sdk
- Repository: https://github.com/cryptoscan-pro/pumpfun-sdk

## Overview

This is a TypeScript Pump.fun/Solana trading SDK. Applications configure and invoke PumpApi for swaps, transfers, and live coin discovery; transaction methods delegate to trading services, while discovery consumes Pump.fun WebSocket events. The README also documents bumping and combined transfer-buy/sell capabilities. The sampled PumpApi implementation does not show those methods, so they are included as documented capabilities without inferred internal links. Type contracts are represented separately; no persistent store is evident.

Main entry points: [`lib/PumpApi.ts`](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts) (PumpApi)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_trading["Trading operations"]
  node_api["PumpApi<br/>[PumpApi.ts]"]
  node_buy["Buy<br/>[PumpApi.ts]"]
  node_sell["Sell<br/>[PumpApi.ts]"]
  node_transfer["Transfer<br/>[PumpApi.ts]"]
  node_bump["Bump trading<br/>[PumpApi.ts]"]
  node_transfer_buy_sell["Combined transfers<br/>[PumpApi.ts]"]
end

subgraph group_discovery["Live discovery"]
  node_socket_listener["Pump.fun listener<br/>[PumpApi.ts]"]
  node_mint_watch["Mint watcher<br/>[PumpApi.ts]"]
  node_bump_watch["Bump watcher<br/>[PumpApi.ts]"]
  node_transaction_watch["Transaction listener<br/>[PumpApi.ts]"]
end

subgraph group_contracts["API contracts"]
  node_buy_params["Buy parameters<br/>[BuyParams.ts]"]
  node_sell_params["Sell parameters<br/>[SellParams.ts]"]
  node_transfer_params["Transfer parameters<br/>[TransferParams.ts]"]
  node_api_params["SDK configuration<br/>[PumpApiParams.ts]"]
  node_coin_model["Coin data model<br/>[PumpCoin.ts]"]
end

subgraph group_integrations["External services"]
  node_swap_service["Swap service"]
  node_scanner_service["Rate scanner"]
  node_wallet_service["Wallet balance"]
  node_solana["Solana RPC"]
  node_pumpfun_socket["Pump.fun WebSocket"]
end

node_app(("Client application"))

node_app -->|"calls SDK"| node_api
node_api -->|"invokes"| node_buy
node_api -->|"invokes"| node_sell
node_api -->|"invokes"| node_transfer
node_api -->|"starts listeners"| node_socket_listener
node_buy -->|"submits swap"| node_swap_service
node_sell -->|"reads balance"| node_wallet_service
node_sell -->|"gets rate"| node_scanner_service
node_sell -->|"submits swap"| node_swap_service
node_transfer -->|"reads balance"| node_wallet_service
node_transfer -->|"gets rate"| node_scanner_service
node_transfer -->|"submits transfer"| node_swap_service
node_buy -->|"uses connection"| node_solana
node_sell -->|"uses connection"| node_solana
node_transfer -->|"uses connection"| node_solana
node_socket_listener -->|"opens socket"| node_pumpfun_socket
node_socket_listener -->|"filters mints"| node_mint_watch
node_socket_listener -->|"filters bumps"| node_bump_watch
node_app -->|"requests listening"| node_transaction_watch
node_app -->|"requests bump"| node_bump
node_app -->|"requests combined trade"| node_transfer_buy_sell
node_app -->|"watches or waits"| node_mint_watch
node_app -->|"watches coin"| node_bump_watch

click node_api "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_buy "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_sell "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_transfer "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_bump "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_transfer_buy_sell "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_socket_listener "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_mint_watch "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_bump_watch "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_transaction_watch "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts"
click node_buy_params "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/BuyParams.ts"
click node_sell_params "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/SellParams.ts"
click node_transfer_params "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/TransferParams.ts"
click node_api_params "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/PumpApiParams.ts"
click node_coin_model "https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/PumpCoin.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_buy,node_sell,node_transfer,node_bump,node_transfer_buy_sell,node_app toneBlue
class node_socket_listener,node_mint_watch,node_bump_watch,node_transaction_watch toneAmber
class node_buy_params,node_sell_params,node_transfer_params,node_api_params,node_coin_model toneMint
class node_swap_service,node_scanner_service,node_wallet_service,node_solana,node_pumpfun_socket toneRose
```

## Components

### Trading operations

- [PumpApi](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Buy](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Sell](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Transfer](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Bump trading](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Combined transfers](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`

### Live discovery

- [Pump.fun listener](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Mint watcher](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Bump watcher](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`
- [Transaction listener](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/PumpApi.ts): `lib/PumpApi.ts`

### API contracts

- [Buy parameters](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/BuyParams.ts): `lib/types/BuyParams.ts`
- [Sell parameters](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/SellParams.ts): `lib/types/SellParams.ts`
- [Transfer parameters](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/TransferParams.ts): `lib/types/TransferParams.ts`
- [SDK configuration](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/PumpApiParams.ts): `lib/types/PumpApiParams.ts`
- [Coin data model](https://github.com/cryptoscan-pro/pumpfun-sdk/blob/main/lib/types/PumpCoin.ts): `lib/types/PumpCoin.ts`

### External services

- **Swap service**
- **Rate scanner**
- **Wallet balance**
- **Solana RPC**
- **Pump.fun WebSocket**

### Other components

- **Client application**

## Connections

- Client application → PumpApi: calls SDK (evidence: `README.md`)
- PumpApi → Buy: invokes (evidence: `lib/PumpApi.ts`)
- PumpApi → Sell: invokes (evidence: `lib/PumpApi.ts`)
- PumpApi → Transfer: invokes (evidence: `lib/PumpApi.ts`)
- PumpApi → Pump.fun listener: starts listeners (evidence: `lib/PumpApi.ts`)
- Buy → Swap service: submits swap (evidence: `lib/PumpApi.ts`)
- Sell → Wallet balance: reads balance (evidence: `lib/PumpApi.ts`)
- Sell → Rate scanner: gets rate (evidence: `lib/PumpApi.ts`)
- Sell → Swap service: submits swap (evidence: `lib/PumpApi.ts`)
- Transfer → Wallet balance: reads balance (evidence: `lib/PumpApi.ts`)
- Transfer → Rate scanner: gets rate (evidence: `lib/PumpApi.ts`)
- Transfer → Swap service: submits transfer (evidence: `lib/PumpApi.ts`)
- Buy → Solana RPC: uses connection (evidence: `lib/PumpApi.ts`)
- Sell → Solana RPC: uses connection (evidence: `lib/PumpApi.ts`)
- Transfer → Solana RPC: uses connection (evidence: `lib/PumpApi.ts`)
- Pump.fun listener → Pump.fun WebSocket: opens socket (evidence: `lib/PumpApi.ts`)
- Pump.fun listener → Mint watcher: filters mints (evidence: `lib/PumpApi.ts`)
- Pump.fun listener → Bump watcher: filters bumps (evidence: `lib/PumpApi.ts`)
- Client application → Transaction listener: requests listening (evidence: `README.md`)
- Client application → Bump trading: requests bump (evidence: `README.md`)
- Client application → Combined transfers: requests combined trade (evidence: `README.md`)
- Client application → Mint watcher: watches or waits (evidence: `README.md`)
- Client application → Bump watcher: watches coin (evidence: `README.md`)
