@deepliquidity/sdk

TypeScript client for DEEP on Solana: the deep-curve launchpad (bonding curves) and DeepSwap (the deep-amm constant-product AMM that graduated tokens move to). PDAs, instruction builders, account and event decoders, integer quotes that match the programs exactly, and the programs' Anchor IDLs.

Status. The programs run on mainnet and devnet, at the same program ids. Nothing in this package sends transactions by itself.

The full integration guide (account layouts with offsets, events, fee maths, error codes, compute budgets, differences from pump.fun and Raydium CPMM) is the integration guide and the "Integrate" section of the DEEP docs.

Install

npm install @deepliquidity/sdk @deepliquidity/curve-math @solana/web3.js

ESM only, with TypeScript declarations. Works in Node ≥ 22 and in browser bundles: the package imports Buffer from the buffer package and never relies on a global Buffer.

Program ids

import { DEEP_CURVE_PROGRAM_ID, DEEP_AMM_PROGRAM_ID } from "@deepliquidity/sdk";
// deep-curve 7czURwVLkQpcF1HVhhZU5GGzvPA8YniogZY1BhZHCDtA (mainnet and devnet)
// deep-amm   HCrCy6bzHhZ1b6bXwQAucEFkKXyzYMh3hgAR8UPrYSEP (mainnet and devnet)

Quick start: quote and build a curve buy

import { quoteBuyV1 } from "@deepliquidity/curve-math";
import { applySlippage, buyIx, curveFees, curvePda, decodeBondingCurve } from "@deepliquidity/sdk";
import { ComputeBudgetProgram, Connection, PublicKey, Transaction } from "@solana/web3.js";

const conn = new Connection("https://api.devnet.solana.com", "confirmed");
const mint = new PublicKey("<mint>");
const user = new PublicKey("<wallet>");

const curve = decodeBondingCurve((await conn.getAccountInfo(curvePda(mint)))!.data);
// the token's own terms: DEEP's buy and sell rate, its reward rate and reward model
const fees = curveFees(curve);
const q = quoteBuyV1(curve.state, 100_000_000n, fees); // 0.1 SOL in, fees included
const tx = new Transaction().add(
  ComputeBudgetProgram.setComputeUnitLimit({ units: 80_000 }),
  buyIx({
    user,
    mint,
    amount: 100_000_000n,
    minOut: applySlippage(q.tokensOut, 100), // 1% slippage floor
    deadline: BigInt(Math.floor(Date.now() / 1000) + 60),
  }),
);
// sign with the user's wallet and send

Charging your own fee

DEEP has no on-chain referral share. To charge an app fee, add a SOL transfer to your own wallet in the same transaction as the trade: quoteBuyWithIntegratorFee / quoteSellWithIntegratorFee give the amounts and breakdown, integratorFeeIx builds the transfer (0–10%, rounded up). Show the fee to the user; DEEP's own fees still apply. See the integration guide, "Charging your own fee".

Quick start: swap on a DeepSwap pool

import {
  cpmmDirection,
  cpmmReserves,
  cpmmSwapBaseInputIx,
  decodeCpmmAmmConfig,
  decodeCpmmPoolState,
  DEEP_AMM_PROGRAM_ID,
  graduationPoolPda,
  NATIVE_MINT,
  quoteCpmmSwapBaseInput,
} from "@deepliquidity/sdk";

const poolId = graduationPoolPda(mint); // the pool a token graduated into
const pool = decodeCpmmPoolState((await conn.getAccountInfo(poolId))!.data);
const amm = decodeCpmmAmmConfig((await conn.getAccountInfo(pool.ammConfig))!.data);
const bal = async (k: PublicKey) => BigInt((await conn.getTokenAccountBalance(k)).value.amount);
const [r0, r1] = cpmmReserves(pool, await bal(pool.token0Vault), await bal(pool.token1Vault));
const { zeroForOne, creatorFeeOnInput } = cpmmDirection(pool, NATIVE_MINT);
const q = quoteCpmmSwapBaseInput({
  amountIn: 10_000_000n,
  inputReserve: zeroForOne ? r0 : r1,
  outputReserve: zeroForOne ? r1 : r0,
  config: amm,
  creatorFeeEnabled: pool.enableCreatorFee,
  creatorFeeOnInput,
});
const ix = cpmmSwapBaseInputIx({
  programId: DEEP_AMM_PROGRAM_ID,
  payer: user,
  poolId,
  pool,
  inputMint: NATIVE_MINT,
  amountIn: 10_000_000n,
  minimumAmountOut: (q.amountOut * 99n) / 100n,
}); // wrap SOL into the user's WSOL account first; see examples/deepswap-swap.ts

Events

import { parseEventsFromLogs, parseFeeEventsFromLogs, parseAmmSwapEvents } from "@deepliquidity/sdk";

conn.onLogs(DEEP_CURVE_PROGRAM_ID, (l) => {
  for (const { event } of parseEventsFromLogs(l.logs)) console.log(event.name, event);
});
conn.onLogs(DEEP_AMM_PROGRAM_ID, (l) => console.log(parseAmmSwapEvents(l.logs)));

parseEventsFromLogs only accepts Program data: lines emitted by the program itself (it tracks the invoke stack), so another program cannot spoof DEEP events.

IDLs

import curveIdl from "@deepliquidity/sdk/idl/deep_curve.json" with { type: "json" };
import ammIdl from "@deepliquidity/sdk/idl/deep_amm.json" with { type: "json" };

Anchor IDL spec 0.1.0. The SDK's decoders are tested field by field against these files, and the files against the live devnet accounts.

Examples

examples/ builds real transactions and simulates them on devnet (sigVerify: false): nothing is signed or sent, and no keypair is ever read. Pass --payer <public key> to choose whose account the simulation runs as.

npx tsx examples/read-curve.ts --rpc https://api.devnet.solana.com

Licence

MIT AND Apache-2.0: the cp-swap ports listed in NOTICE are Apache-2.0 (LICENSE-APACHE), everything else is MIT (LICENSE).

Links

Website and app · Docs · Integration guide · GitHub · Blog · Status · X · Telegram