Skip to content

An example to swap tokens on Solana using the Raydium SDK, TypeScript, and Chainstack

License

Notifications You must be signed in to change notification settings

chainstacklabs/raydium-sdk-swap-example-typescript

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Labs

Chainstack is the leading suite of services connecting developers with Web3 infrastructure

         

Supported protocolsChainstack blogChainstack docsBlockchain API referenceStart for free

TLDR quick run

Download the latest Raydium mainnet.json to the project root (it's a ~500 MB file):

wget https://api.raydium.io/v2/sdk/liquidity/mainnet.json

Set the tokenA and tokenB in src/swapConfig.ts.

Now that you have the the 500 MB mainnet.json that has the entrirety of info on liquidity pairs, and you have the correct pairs set in swapConfig.ts, you want to trim the mainnet.json file to have only the necessary liquidity info pertaining to your tokenA & tokenB. So run:

ts-node src/trimMainnet.ts

This will produce src/trimmed_mainnet.json that takes less than a second to load vs minutes for mainnet.json.

Make sure you have the Chainstack node & your private key set in .env. Make sure you have all dependencies installed with yarn.

Run the swap:

yarn swap

Raydium SDK Swap Example

This project demonstrates how to perform a token swap on the Solana blockchain using Raydium and Chainstack. The example specifically illustrates swapping SOL (native Solana token) for USDC (a stablecoin).

Find the full guide on the Chainstack Developer Portal.

Shoutout to precious-void for the the base code used for this project!

Features

  • Utilizes the Raydium SDK for interacting with the Solana blockchain.
  • Supports both versioned and legacy transactions.
  • Allows simulation of swap transactions before execution.
  • Easy configuration for swap parameters through a dedicated config file.

Prerequisites

Before you begin, ensure you have met the following requirements:

  • Node.js installed (v18 or above recommended)
  • Yarn
  • A Solana wallet with some SOL for testing the swap
  • An environment file (.env) with your RPC URL and WALLET_PRIVATE_KEY

Chainstack Solana node

Deploy a Solana node on Chainstack; the following steps will guide you:

  1. Sign up with Chainstack.
  2. Deploy a node.
  3. View node access and credentials.

Environment variables

Add your RPC endoint and private key to a .env file:

RPC_URL=YOUR_RPC_URL
WALLET_PRIVATE_KEY=YOUR_PRIVATE_KEY

Installation

Clone the repository locally and install the dependencies:

git clone https://github.com/soos3d/raydium-sdk-swap-example.git
cd raydium-sdk-swap-example
yarn

Usage

Edit the configuration in src/swapConfig.ts editing:

  • Select if you want to send the transaction or only simulate
  • The amount to swap
  • The tokens to swap
  • The liquidity file to pull the pool info from
export const swapConfig = {
  executeSwap: false, // Send tx when true, simulate tx when false
  useVersionedTransaction: true,
  tokenAAmount: 0.01, // Swap 0.01 SOL for USDT in this example
  tokenAAddress: "So11111111111111111111111111111111111111112", // Token to swap for the other, SOL in this case
  tokenBAddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // USDC address
  maxLamports: 1000000, // Max lamports allowed for fees
  direction: "in" as "in" | "out", // Swap direction: 'in' or 'out'
  liquidityFile: "https://api.raydium.io/v2/sdk/liquidity/mainnet.json",
  maxRetries: 10
};

Then run:

yarn swap