PumpFun Transaction Tracker

Real-time PumpFun transaction tracker for Solana blockchain with buy/sell event detection. This package allows you to monitor and track trading activities on PumpFun protocol in real-time.

Installation

npm install pumpfun-transaction-tracker

Quick Start

Basic Usage

import { PumpFunTracker } from 'pumpfun-transaction-tracker';

const tracker = new PumpFunTracker({
  grpcUrl: 'your_grpc_url',
  xToken: 'your_api_token',
  targetMint: 'AdXvCyBs8cznqs6yrwF6NGA2VJj6p7VbBt2Pd62Kpump', // optional
});

// Start tracking
await tracker.start();

// Stop tracking
tracker.stop();

With Custom Event Handler

import { PumpFunTracker, PumpFunTransactionEvent } from 'pumpfun-transaction-tracker';

const tracker = new PumpFunTracker({
  grpcUrl: 'your_grpc_url',
  xToken: 'your_api_token',
  targetMint: 'AdXvCyBs8cznqs6yrwF6NGA2VJj6p7VbBt2Pd62Kpump',
  onTransaction: (event: PumpFunTransactionEvent, signature: string) => {
    console.log('New transaction:', {
      type: event.type,
      user: event.user,
      mint: event.mint,
      out_amount: event.out_amount,
      in_amount: event.in_amount,
      signature
    });
  }
});

await tracker.start();

Configuration

PumpFunTrackerConfig

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | grpcUrl | string | Yes | gRPC endpoint URL (e.g., from Shyft or Triton) | | xToken | string | Yes | API token for gRPC access | | targetMint | string | No | Filter transactions for specific token mint | | onTransaction | function | No | Custom callback for transaction events |

PumpFunTransactionEvent

interface PumpFunTransactionEvent {
  type: 'buy' | 'sell';
  user: string;        // User's public key
  mint: string;        // Token mint address
  out_amount: number;  // Amount received
  in_amount: number;   // Amount spent
}

Environment Variables

Create a .env file:

GRPC_URL=your_grpc_url
X_TOKEN=your_api_token
TARGET_MINT=AdXvCyBs8cznqs6yrwF6NGA2VJj6p7VbBt2Pd62Kpump

Features

• ✅ Real-time transaction monitoring
• ✅ Buy/sell event detection
• ✅ Token-specific filtering
• ✅ Formatted amount display
• ✅ Custom event handlers
• ✅ Automatic reconnection
• ✅ TypeScript support

Dependencies

• @triton-one/yellowstone-grpc - Solana gRPC client
• @solana/web3.js - Solana Web3 library
• @project-serum/anchor - Anchor framework
• @shyft-to/solana-transaction-parser - Transaction parsing

License

MIT

Related Links

• Shyft gRPC Docs
• PumpFun Protocol