🚀 Sol Trade SDK for Node.js

A comprehensive TypeScript SDK for seamless Solana DEX trading

A high-performance TypeScript SDK for low-latency Solana DEX trading bots. Built for speed and efficiency, it enables seamless, high-throughput interaction with PumpFun, Pump AMM (PumpSwap), Bonk, Meteora DAMM v2, Raydium AMM v4, and Raydium CPMM for latency-critical trading strategies.

中文 | English | Website | Telegram | Discord

📋 Table of Contents

• ✨ Features
• 📦 Installation
• 🛠️ Usage Examples
  • 📋 Example Usage
  • ⚡ Trading Parameters
  • 📊 Usage Examples Summary Table
  • ⚙️ SWQoS Service Configuration
  • 🔧 Middleware System
  • 🔍 Address Lookup Tables
  • 🔍 Nonce Cache
• 💰 Cashback Support (PumpFun / PumpSwap)
• 🛡️ MEV Protection Services
• 📁 Project Structure
• 📄 License
• 💬 Contact
• ⚠️ Important Notes

---

📦 SDK Versions

This SDK is available in multiple languages:

Language	Repository	Description
Rust	sol-trade-sdk	Ultra-low latency with zero-copy optimization
Node.js	sol-trade-sdk-nodejs	TypeScript/JavaScript for Node.js
Python	sol-trade-sdk-python	Async/await native support
Go	sol-trade-sdk-golang	Concurrent-safe with goroutine support

✨ Features

1. PumpFun Trading: Support for buy and sell operations
2. PumpSwap Trading: Support for PumpSwap pool trading operations
3. Bonk Trading: Support for Bonk trading operations
4. Raydium CPMM Trading: Support for Raydium CPMM (Concentrated Pool Market Maker) trading operations
5. Raydium AMM V4 Trading: Support for Raydium AMM V4 (Automated Market Maker) trading operations
6. Meteora DAMM V2 Trading: Support for Meteora DAMM V2 (Dynamic AMM) trading operations
7. Multiple MEV Protection: Support for Jito, Nextblock, ZeroSlot, Temporal, Bloxroute, FlashBlock, BlockRazor, Node1, Astralane and other services
8. Concurrent Trading: Send transactions using multiple MEV services simultaneously; the fastest succeeds while others fail
9. Unified Trading Interface: Use unified trading protocol types for trading operations
10. Middleware System: Support for custom instruction middleware to modify, add, or remove instructions before transaction execution
11. Shared Infrastructure: Share expensive RPC and SWQoS clients across multiple wallets for reduced resource usage

📦 Installation

Direct Clone (Recommended)

Clone this project to your project directory:

cd your_project_root_directory
git clone https://github.com/0xfnzero/sol-trade-sdk-nodejs

Install dependencies and build:

cd sol-trade-sdk-nodejs
npm install
npm run build

Add to your package.json:

{
  "dependencies": {
    "sol-trade-sdk": "./sol-trade-sdk-nodejs"
  }
}

Use NPM

npm install sol-trade-sdk
# or
yarn add sol-trade-sdk
# or
pnpm add sol-trade-sdk

🛠️ Usage Examples

📋 Example Usage

1. Create TradingClient Instance

You can refer to Example: Create TradingClient Instance.

Method 1: Simple (single wallet)

import { TradingClient, TradeConfig, SwqosConfig, SwqosRegion } from 'sol-trade-sdk';

// Wallet
const payer = Keypair.fromSecretKey(/* your keypair */);

// RPC URL
const rpcUrl = "https://mainnet.helius-rpc.com/?api-key=xxxxxx";

// Multiple SWQoS services can be configured
const swqosConfigs: SwqosConfig[] = [
  { type: 'Default', rpcUrl },
  { type: 'Jito', uuid: "your_uuid", region: SwqosRegion.Frankfurt },
  { type: 'Bloxroute', apiToken: "your_api_token", region: SwqosRegion.Frankfurt },
  { type: 'Astralane', apiKey: "your_api_key", region: SwqosRegion.Frankfurt },
];

// Create TradeConfig instance
const tradeConfig = new TradeConfig(rpcUrl, swqosConfigs);

// Create TradingClient
const client = new TradingClient(payer, tradeConfig);

Method 2: Shared infrastructure (multiple wallets)

For multi-wallet scenarios, create the infrastructure once and share it across wallets. See Example: Shared Infrastructure.

import { TradingInfrastructure, InfrastructureConfig } from 'sol-trade-sdk';

// Create infrastructure once (expensive)
const infraConfig = new InfrastructureConfig(rpcUrl, swqosConfigs);
const infrastructure = new TradingInfrastructure(infraConfig);

// Create multiple clients sharing the same infrastructure (fast)
const client1 = TradingClient.fromInfrastructure(payer1, infrastructure);
const client2 = TradingClient.fromInfrastructure(payer2, infrastructure);

2. Configure Gas Fee Strategy

import { GasFeeStrategy } from 'sol-trade-sdk';

// Create GasFeeStrategy instance
const gasFeeStrategy = new GasFeeStrategy();
// Set global strategy
gasFeeStrategy.setGlobalFeeStrategy(150000, 150000, 500000, 500000, 0.001, 0.001);

3. Build Trading Parameters

import { TradeBuyParams, DexType, TradeTokenType, DexParamEnum } from 'sol-trade-sdk';

const buyParams: TradeBuyParams = {
  dexType: DexType.PumpSwap,
  inputTokenType: TradeTokenType.WSOL,
  mint: mintPubkey,
  inputTokenAmount: buySolAmount,
  slippageBasisPoints: 500,
  recentBlockhash: recentBlockhash,
  // Use DexParamEnum for type-safe protocol parameters
  extensionParams: { type: 'PumpSwap', params: pumpSwapParams },
  addressLookupTableAccount: null,
  waitTransactionConfirmed: true,
  createInputTokenAta: true,
  closeInputTokenAta: true,
  createMintAta: true,
  durableNonce: null,
  fixedOutputTokenAmount: null,
  gasFeeStrategy: gasFeeStrategy,
  simulate: false,
};

4. Execute Trading

const result = await client.buy(buyParams);
console.log(`Transaction signature: ${result.signature}`);

⚡ Trading Parameters

For comprehensive information about all trading parameters including TradeBuyParams and TradeSellParams, see the Trading Parameters documentation.

About ShredStream

When using shred to subscribe to events, due to the nature of shreds, you cannot get complete information about transaction events. Please ensure that the parameters your trading logic depends on are available in shreds when using them.

📊 Usage Examples Summary Table

Description	Run Command	Source Code
Create and configure TradingClient instance	npx ts-node examples/trading_client.ts	examples/trading_client.ts
Share infrastructure across multiple wallets	npx ts-node examples/shared_infrastructure.ts	examples/shared_infrastructure.ts
PumpFun token sniping trading	npx ts-node examples/pumpfun_sniper_trading.ts	examples/pumpfun_sniper_trading.ts
PumpFun token copy trading	npx ts-node examples/pumpfun_copy_trading.ts	examples/pumpfun_copy_trading.ts
PumpSwap trading operations	npx ts-node examples/pumpswap_trading.ts	examples/pumpswap_trading.ts
PumpSwap direct trading (via RPC)	npx ts-node examples/pumpswap_direct_trading.ts	examples/pumpswap_direct_trading.ts
Raydium CPMM trading operations	npx ts-node examples/raydium_cpmm_trading.ts	examples/raydium_cpmm_trading.ts
Raydium AMM V4 trading operations	npx ts-node examples/raydium_amm_v4_trading.ts	examples/raydium_amm_v4_trading.ts
Meteora DAMM V2 trading operations	npx ts-node examples/meteora_damm_v2_trading.ts	examples/meteora_damm_v2_trading.ts
Bonk token sniping trading	npx ts-node examples/bonk_sniper_trading.ts	examples/bonk_sniper_trading.ts
Bonk token copy trading	npx ts-node examples/bonk_copy_trading.ts	examples/bonk_copy_trading.ts
Custom instruction middleware example	npx ts-node examples/middleware_system.ts	examples/middleware_system.ts
Address lookup table example	npx ts-node examples/address_lookup.ts	examples/address_lookup.ts
Nonce cache (durable nonce) example	npx ts-node examples/nonce_cache.ts	examples/nonce_cache.ts
Wrap/unwrap SOL to/from WSOL example	npx ts-node examples/wsol_wrapper.ts	examples/wsol_wrapper.ts
Seed trading example	npx ts-node examples/seed_trading.ts	examples/seed_trading.ts
Gas fee strategy example	npx ts-node examples/gas_fee_strategy.ts	examples/gas_fee_strategy.ts
Hot path trading (zero-RPC)	npx ts-node examples/hot_path_trading.ts	examples/hot_path_trading.ts

⚙️ SWQoS Service Configuration

When configuring SWQoS services, note the different parameter requirements for each service:

• Jito: The first parameter is UUID (if no UUID, pass an empty string "")
• Other MEV services: The first parameter is the API Token

Custom URL Support

Each SWQoS service supports an optional custom URL parameter:

// Using custom URL
const jitoConfig: SwqosConfig = {
  type: 'Jito',
  uuid: "your_uuid",
  region: SwqosRegion.Frankfurt,
  customUrl: "https://custom-jito-endpoint.com"
};

// Using default regional endpoint
const bloxrouteConfig: SwqosConfig = {
  type: 'Bloxroute',
  apiToken: "your_api_token",
  region: SwqosRegion.NewYork
};

URL Priority Logic:

• If a custom URL is provided, it will be used instead of the regional endpoint
• If no custom URL is provided, the system will use the default endpoint for the specified region
• This allows for maximum flexibility while maintaining backward compatibility

When using multiple MEV services, you need to use Durable Nonce. You need to use the fetchNonceInfo function to get the latest nonce value, and use it as the durableNonce when trading.

---

🔧 Middleware System

The SDK provides a powerful middleware system that allows you to modify, add, or remove instructions before transaction execution. Middleware executes in the order they are added:

import { MiddlewareManager, ValidationMiddleware, TimerMiddleware } from 'sol-trade-sdk';

const manager = new MiddlewareManager()
  .addMiddleware(new FirstMiddleware())   // Executes first
  .addMiddleware(new SecondMiddleware())  // Executes second
  .addMiddleware(new ThirdMiddleware());  // Executes last

🔍 Address Lookup Tables

Address Lookup Tables (ALT) allow you to optimize transaction size and reduce fees by storing frequently used addresses in a compact table format.

import { fetchAddressLookupTableAccount, AddressLookupTableCache } from 'sol-trade-sdk';

// Fetch ALT from chain
const alt = await fetchAddressLookupTableAccount(rpc, altAddress);
console.log(`ALT contains ${alt.addresses.length} addresses`);

// Use cache for performance
const cache = new AddressLookupTableCache(rpc);
await cache.prefetch([altAddress1, altAddress2, altAddress3]);
const cached = cache.get(altAddress1);

🔍 Durable Nonce

Use Durable Nonce to implement transaction replay protection and optimize transaction processing.

import { fetchNonceInfo, NonceCache } from 'sol-trade-sdk';

// Fetch nonce info
const nonceInfo = await fetchNonceInfo(rpc, nonceAccount);

💰 Cashback Support (PumpFun / PumpSwap)

PumpFun and PumpSwap support cashback for eligible tokens: part of the trading fee can be returned to the user. The SDK must know whether the token has cashback enabled so that buy/sell instructions include the correct accounts.

• When params come from RPC: If you use PumpFunParams.fromMintByRpc or PumpSwapParams.fromPoolAddressByRpc, the SDK reads isCashbackCoin from chain—no extra step.
• When params come from event/parser: If you build params from trade events (e.g. sol-parser-sdk), you must pass the cashback flag into the SDK:
  • PumpFun: Set isCashbackCoin when building params from parsed events.
  • PumpSwap: Set isCashbackCoin field when constructing params manually.

🛡️ MEV Protection Services

You can apply for a key through the official website: Community Website

• Jito: High-performance block space
• ZeroSlot: Zero-latency transactions
• Temporal: Time-sensitive transactions
• Bloxroute: Blockchain network acceleration
• FlashBlock: High-speed transaction execution with API key authentication
• BlockRazor: High-speed transaction execution with API key authentication
• Node1: High-speed transaction execution with API key authentication
• Astralane: Blockchain network acceleration

📁 Project Structure

src/
├── common/           # Common functionality and tools
├── constants/        # Constant definitions
├── instruction/      # Instruction building
│   └── utils/        # Instruction utilities
├── swqos/            # MEV service clients
├── trading/          # Unified trading engine
│   ├── common/       # Common trading tools
│   ├── core/         # Core trading engine
│   ├── middleware/   # Middleware system
│   └── factory.ts    # Trading factory
├── utils/            # Utility functions
│   ├── calc/         # Amount calculation utilities
│   └── price/        # Price calculation utilities
└── index.ts          # Main library file

📄 License

MIT License

💬 Contact

• Official Website: https://fnzero.dev/
• Project Repository: https://github.com/0xfnzero/sol-trade-sdk-nodejs
• Telegram Group: https://t.me/fnzero_group
• Discord: https://discord.gg/vuazbGkqQE

⚠️ Important Notes

1. Test thoroughly before using on mainnet
2. Properly configure private keys and API tokens
3. Pay attention to slippage settings to avoid transaction failures
4. Monitor balances and transaction fees
5. Comply with relevant laws and regulations