DBC TS SDK Getting Started

Learn how to install @meteora-ag/dynamic-bonding-curve-sdk, initialize the DBC client, read standard and transfer-hook pool state, quote swaps, and test the SDK.

This guide shows how to install and initialize @meteora-ag/dynamic-bonding-curve-sdk 2.0.0 or later. That package matches program 0.2.2, including Token 2022 transfer fees on the base and quote mints.

Before you begin, here are the main resources:

TypeScript SDK

SDK source, tests, IDLs, services, math helpers, and package metadata.

NPM Package

Published package for DBC TypeScript integrations.

Installation

Install the SDK and its Solana dependencies:

npm

npm install @meteora-ag/dynamic-bonding-curve-sdk @solana/web3.js @solana/spl-token bn.js

pnpm

pnpm install @meteora-ag/dynamic-bonding-curve-sdk @solana/web3.js @solana/spl-token bn.js

yarn

yarn add @meteora-ag/dynamic-bonding-curve-sdk @solana/web3.js @solana/spl-token bn.js

bun

bun add @meteora-ag/dynamic-bonding-curve-sdk @solana/web3.js @solana/spl-token bn.js

Initialization

Create a client from a Solana connection and commitment:

import { Connection } from "@solana/web3.js";
import { DynamicBondingCurveClient } from "@meteora-ag/dynamic-bonding-curve-sdk";

const connection = new Connection(process.env.RPC_URL!, "confirmed");
const client = new DynamicBondingCurveClient(connection, "confirmed");

commitment defaults to confirmed when you omit it. Curve, fee, and transfer-fee math is a separate import:

import { getSwapResult } from "@meteora-ag/dynamic-bonding-curve-sdk/math";

Program ID

The SDK defaults to the public DBC program ID on both mainnet and devnet:

dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN

Reference

SDK Examples

Explore full transaction flows, including pool initialization, swaps, liquidity, and more.

SDK Reference

Access the full method map, PDA helpers, and fee helpers for DBC.

Transfer Hooks

Build Token 2022 transfer-hook configs, pools, swaps, claims, and state reads.

Testing The SDK

The local package scripts use pnpm in the repository root and package scripts in packages/dynamic-bonding-curve.

cd packages/dynamic-bonding-curve
pnpm install
pnpm run build
pnpm run check-types
pnpm test

Some tests depend on local validator fixtures and deployed program artifacts. For application integrations, simulate transactions and test on devnet before mainnet.

Faucets

Devnet Faucet

Request test SOL for devnet integration testing.