@liquid-af/sdk 0.1.0

package/dist/accounts/liquid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid.d.ts","sourceRoot":"","sources":["../../src/accounts/liquid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC5C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY;;;;;;;;;;;;;;;;;GAKpB;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC5C,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;GAKpB;AAED;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACrD,UAAU,EAAE,UAAU,EACtB,mBAAmB,EAAE,SAAS,EAC9B,MAAM,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;GAIpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC5C,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;GASpB;AAED;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACrD,UAAU,EAAE,UAAU,EACtB,yBAAyB,EAAE,SAAS,EACpC,MAAM,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAIpB"}

package/dist/accounts/liquid.js

@@ -0,0 +1,66 @@
+import { getLiquidGlobalConfigPDA, getBondingCurvePDA, getStableBondingCurvePDA, } from "../pda/liquid.js";
+import { getLiquidProgram } from "../idl/index.js";
+/**
+ * Fetches the global configuration for the bonding curve program.
+ *
+ * @param connection - Solana RPC connection
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized global configuration account
+ */
+export async function fetchLiquidGlobalConfig(connection, config) {
+    const program = getLiquidProgram(connection, config);
+    const [pda] = getLiquidGlobalConfigPDA(config.liquidProgramId);
+    return program.account.globalConfiguration.fetch(pda);
+}
+/**
+ * Fetches a bonding curve account by mint address.
+ *
+ * @param connection - Solana RPC connection
+ * @param mint - Token mint address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized bonding curve account
+ */
+export async function fetchNativeBondingCurve(connection, mint, config) {
+    const program = getLiquidProgram(connection, config);
+    const [pda] = getBondingCurvePDA(mint, config.liquidProgramId);
+    return program.account.nativeBondingCurve.fetch(pda);
+}
+/**
+ * Fetches a bonding curve account by its PDA address directly.
+ *
+ * @param connection - Solana RPC connection
+ * @param bondingCurveAddress - The bonding curve PDA address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized bonding curve account
+ */
+export async function fetchNativeBondingCurveByAddress(connection, bondingCurveAddress, config) {
+    const program = getLiquidProgram(connection, config);
+    return program.account.nativeBondingCurve.fetch(bondingCurveAddress);
+}
+/**
+ * Fetches a token bonding curve account by mint and quote mint addresses.
+ *
+ * @param connection - Solana RPC connection
+ * @param mint - Token mint address (base token)
+ * @param quoteMint - Quote token mint address (e.g., USDC)
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized token bonding curve account
+ */
+export async function fetchStableBondingCurve(connection, mint, quoteMint, config) {
+    const program = getLiquidProgram(connection, config);
+    const [pda] = getStableBondingCurvePDA(mint, quoteMint, config.liquidProgramId);
+    return program.account.stableBondingCurve.fetch(pda);
+}
+/**
+ * Fetches a token bonding curve account by its PDA address directly.
+ *
+ * @param connection - Solana RPC connection
+ * @param stableBondingCurveAddress - The token bonding curve PDA address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized token bonding curve account
+ */
+export async function fetchStableBondingCurveByAddress(connection, stableBondingCurveAddress, config) {
+    const program = getLiquidProgram(connection, config);
+    return program.account.stableBondingCurve.fetch(stableBondingCurveAddress);
+}
+//# sourceMappingURL=liquid.js.map

package/dist/accounts/liquid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid.js","sourceRoot":"","sources":["../../src/accounts/liquid.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,UAAsB,EACtB,MAAoB;IAEpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,CAAC,GAAG,wBAAwB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,UAAsB,EACtB,IAAe,EACf,MAAoB;IAEpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACrD,UAAsB,EACtB,mBAA8B,EAC9B,MAAoB;IAEpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,UAAsB,EACtB,IAAe,EACf,SAAoB,EACpB,MAAoB;IAEpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,CAAC,GAAG,wBAAwB,CACrC,IAAI,EACJ,SAAS,EACT,MAAM,CAAC,eAAe,CACtB,CAAC;IACF,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACrD,UAAsB,EACtB,yBAAoC,EACpC,MAAoB;IAEpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC5E,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,621 @@
+import type { Connection, PublicKey, Transaction, TransactionInstruction } from "@solana/web3.js";
+import type BN from "bn.js";
+import { type LiquidConfig } from "./config.js";
+import type { BuyCurvePreview, SellCurvePreview, SwapPreview, FeeRecipient } from "./types.js";
+import { type BuildTransactionOptions } from "./transaction/builder.js";
+import { type RecipientVaultPair } from "./instructions/liquid-fees.js";
+import { type CurveAsyncOptions, type SwapPrefetchedState } from "./helpers/preview.js";
+export interface LiquidClientConfig {
+    connection: Connection;
+    config?: LiquidConfig;
+}
+/**
+ * Unified entry point for the Liquid protocol SDK.
+ *
+ * Holds a `Connection` and `LiquidConfig`, removing the need to pass them
+ * to every function call. Auto-resolves token programs and pool PDAs for
+ * AMM operations. All instruction-building methods return unsigned
+ * `TransactionInstruction`s — the caller is responsible for signing.
+ */
+export declare class LiquidClient {
+    readonly connection: Connection;
+    readonly config: LiquidConfig;
+    /**
+     * @param options - Client configuration with connection and optional protocol config
+     */
+    constructor({ connection, config }: LiquidClientConfig);
+    /** Builds a createCurve instruction for launching a new token on the bonding curve. */
+    buildCreateCurve(params: {
+        creator: PublicKey;
+        mint: PublicKey;
+        pythPriceFeed: PublicKey;
+        name: string;
+        symbol: string;
+        uri: string;
+    }): Promise<TransactionInstruction>;
+    /** Builds a buyOnCurve instruction. Requires the creator address and Pyth price feed. */
+    buildBuyOnCurve(params: {
+        user: PublicKey;
+        mint: PublicKey;
+        creator: PublicKey;
+        pythPriceFeed: PublicKey;
+        amountIn: BN;
+        minAmountOut: BN;
+        feeRecipient: PublicKey;
+        creatorReferralVault?: PublicKey | null;
+        traderReferralVault?: PublicKey | null;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Like `buildBuyOnCurve` but auto-fetches the bonding curve creator.
+     */
+    buildBuyOnCurveAutoResolve(params: {
+        user: PublicKey;
+        mint: PublicKey;
+        pythPriceFeed: PublicKey;
+        amountIn: BN;
+        minAmountOut: BN;
+        feeRecipient: PublicKey;
+        creatorReferralVault?: PublicKey | null;
+        traderReferralVault?: PublicKey | null;
+    }): Promise<TransactionInstruction>;
+    /** Builds a sellOnCurve instruction. Requires the creator address and Pyth price feed. */
+    buildSellOnCurve(params: {
+        user: PublicKey;
+        mint: PublicKey;
+        creator: PublicKey;
+        pythPriceFeed: PublicKey;
+        amountIn: BN;
+        minAmountOut: BN;
+        feeRecipient: PublicKey;
+        creatorReferralVault?: PublicKey | null;
+        traderReferralVault?: PublicKey | null;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Like `buildSellOnCurve` but auto-fetches the bonding curve creator.
+     */
+    buildSellOnCurveAutoResolve(params: {
+        user: PublicKey;
+        mint: PublicKey;
+        pythPriceFeed: PublicKey;
+        amountIn: BN;
+        minAmountOut: BN;
+        feeRecipient: PublicKey;
+        creatorReferralVault?: PublicKey | null;
+        traderReferralVault?: PublicKey | null;
+    }): Promise<TransactionInstruction>;
+    /** Builds a migrate instruction (bonding curve → AMM pool). Permissionless once the curve completes. */
+    buildMigrateNative(params: {
+        migrator: PublicKey;
+        mint: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds an initializeNativeReferralVault instruction (creates native SOL referral vault). */
+    buildInitializeNativeReferralVault(params: {
+        user: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a withdrawReferralRewards instruction. */
+    buildWithdrawReferralRewards(params: {
+        user: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds an executeBuybackNative instruction for native SOL curves. Permissionless; requires revoked fee config. */
+    buildExecuteBuybackNative(params: {
+        payer: PublicKey;
+        mint: PublicKey;
+        pythPriceFeed: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds an executeBuybackToken instruction for token-based curves. Permissionless; requires revoked fee config. */
+    buildExecuteBuybackToken(params: {
+        payer: PublicKey;
+        mint: PublicKey;
+        quoteMint: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Builds a create pool instruction. Auto-resolves token programs if not provided.
+     */
+    buildCreatePool(params: {
+        signer: PublicKey;
+        baseMint: PublicKey;
+        quoteMint?: PublicKey;
+        initAmountBase: BN;
+        initAmountQuote: BN;
+        baseTokenProgram?: PublicKey;
+        quoteTokenProgram?: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Builds a buy swap instruction (quote -> base).
+     * Auto-resolves token programs if not provided. Defaults quoteMint to WSOL.
+     */
+    buildSwapBuy(params: {
+        payer: PublicKey;
+        creator: PublicKey;
+        baseMint: PublicKey;
+        quoteMint?: PublicKey;
+        maxAmountIn: BN;
+        amountOut: BN;
+        feeRecipient: PublicKey;
+        baseTokenProgram?: PublicKey;
+        quoteTokenProgram?: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Builds a sell swap instruction (base -> quote).
+     * Auto-resolves token programs if not provided. Defaults quoteMint to WSOL.
+     */
+    buildSwapSell(params: {
+        payer: PublicKey;
+        creator: PublicKey;
+        baseMint: PublicKey;
+        quoteMint?: PublicKey;
+        amountIn: BN;
+        minimumAmountOut: BN;
+        feeRecipient: PublicKey;
+        baseTokenProgram?: PublicKey;
+        quoteTokenProgram?: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Builds a deposit (add liquidity) instruction.
+     * Auto-resolves pool PDAs, vaults, LP mint, and token programs.
+     * Defaults quoteMint to WSOL.
+     */
+    buildDeposit(params: {
+        owner: PublicKey;
+        baseMint: PublicKey;
+        quoteMint?: PublicKey;
+        lpTokenAmount: BN;
+        maximumBaseAmount: BN;
+        maximumQuoteAmount: BN;
+        baseTokenProgram?: PublicKey;
+        quoteTokenProgram?: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Builds a withdraw (remove liquidity) instruction.
+     * Auto-resolves pool PDAs, vaults, LP mint, and token programs.
+     * Defaults quoteMint to WSOL.
+     */
+    buildWithdraw(params: {
+        owner: PublicKey;
+        baseMint: PublicKey;
+        quoteMint?: PublicKey;
+        lpTokenAmount: BN;
+        minimumBaseAmount: BN;
+        minimumQuoteAmount: BN;
+        baseTokenProgram?: PublicKey;
+        quoteTokenProgram?: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /**
+     * Builds an executeBuyback instruction for an AMM pool.
+     * Auto-resolves token programs if not provided. Defaults quoteMint to WSOL.
+     */
+    buildSwapExecuteBuyback(params: {
+        payer: PublicKey;
+        baseMint: PublicKey;
+        quoteMint?: PublicKey;
+        baseTokenProgram?: PublicKey;
+        quoteTokenProgram?: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds an updateFeeConfig instruction. Cannot be called on revoked configs. */
+    buildUpdateFeeConfig(params: {
+        authority: PublicKey;
+        tokenMint: PublicKey;
+        recipients?: FeeRecipient[] | null;
+        newUpdateAuthority?: PublicKey | null;
+        /** Required when changing recipients to verify token fee vault is drained. */
+        quoteMint?: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a revokeFeeConfig instruction. Permanently sets fee mode to Revoked. Irreversible. */
+    buildRevokeFeeConfig(params: {
+        authority: PublicKey;
+        tokenMint: PublicKey;
+        quoteMint: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a permissionless distributeFees instruction (SOL fees). */
+    buildDistributeFees(params: {
+        payer: PublicKey;
+        tokenMint: PublicKey;
+        recipientVaults: PublicKey[];
+    }): Promise<TransactionInstruction>;
+    /** Builds a permissionless distributeTokenFees instruction (SPL token fees). */
+    buildDistributeTokenFees(params: {
+        payer: PublicKey;
+        tokenMint: PublicKey;
+        quoteMint: PublicKey;
+        recipientVaultPairs: RecipientVaultPair[];
+    }): Promise<TransactionInstruction>;
+    /** Builds a claimFees instruction. Recipient claims accumulated SOL from their vault PDA. */
+    buildClaimFees(params: {
+        recipient: PublicKey;
+        tokenMint: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a claimTokenFees instruction. Recipient claims accumulated tokens from their vault ATA. */
+    buildClaimTokenFees(params: {
+        recipient: PublicKey;
+        tokenMint: PublicKey;
+        quoteMint: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds an initializeUser instruction. Creates the user properties account. */
+    buildInitializeUser(params: {
+        user: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a setReferrer instruction. One-time operation — referrer cannot be changed. */
+    buildSetReferrer(params: {
+        user: PublicKey;
+        referrer: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a setCashbackMode instruction. Toggles between earning and spending mode. */
+    buildSetCashbackMode(params: {
+        user: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a transferAdmin instruction. Proposes admin transfer to a new pubkey (two-step). */
+    buildTransferAdmin(params: {
+        admin: PublicKey;
+        newAdmin: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds an acceptAdmin instruction. Completes a pending admin transfer. */
+    buildAcceptAdmin(params: {
+        newAdmin: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a cancelAdminTransfer instruction. Cancels a pending admin transfer. */
+    buildCancelAdminTransfer(params: {
+        authority: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a createDeal instruction. Admin creates an exclusive deal for a pubkey. */
+    buildCreateDeal(params: {
+        admin: PublicKey;
+        owner: PublicKey;
+        cashbackMultiplierBps: number;
+        payer: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds an updateDeal instruction. Admin updates a deal's cashback multiplier. */
+    buildUpdateDeal(params: {
+        admin: PublicKey;
+        dealOwner: PublicKey;
+        newCashbackMultiplierBps: number;
+    }): Promise<TransactionInstruction>;
+    /** Builds a closeDeal instruction. Admin closes/deletes a deal, returning rent. */
+    buildCloseDeal(params: {
+        admin: PublicKey;
+        dealOwner: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a redeemDeal instruction. User redeems their referrer's deal. */
+    buildRedeemDeal(params: {
+        user: PublicKey;
+        dealOwner: PublicKey;
+    }): Promise<TransactionInstruction>;
+    /** Builds a takeSnapshot instruction. Admin takes a snapshot of a user's volume. */
+    buildTakeSnapshot(params: {
+        admin: PublicKey;
+        user: PublicKey;
+        payer: PublicKey;
+        snapshotIndex: number;
+    }): Promise<TransactionInstruction>;
+    /** Builds an adminUpdateUser instruction. Admin updates a user's referrer/multiplier and takes a snapshot. */
+    buildAdminUpdateUser(params: {
+        admin: PublicKey;
+        user: PublicKey;
+        payer: PublicKey;
+        newReferrer: PublicKey | null;
+        newCashbackMultiplierBps: number | null;
+        snapshotIndex: number;
+    }): Promise<TransactionInstruction>;
+    /** Fetches the global configuration for the bonding curve program. */
+    fetchLiquidGlobalConfig(): Promise<{
+        adminAuthority: PublicKey;
+        initialVirtualReserveUsd: BN;
+        migrationMarketCapUsd: BN;
+        initialVirtualTokenReserves: BN;
+        initialRealTokenReserves: BN;
+        tokenTotalSupply: BN;
+        creatorFeeBasisPoints: number;
+        creatorReferralRewardBasisPoints: number;
+        traderReferralRewardBasisPoints: number;
+        protocolFeeBasisPoints: number;
+        feeRecipients: PublicKey[];
+        quoteMints: PublicKey[];
+        solUsdPriceFeed: PublicKey;
+        pendingAdmin: PublicKey | null;
+        bump: number;
+        paused: boolean;
+    }>;
+    /** Fetches a bonding curve account by token mint. */
+    fetchNativeBondingCurve(mint: PublicKey): Promise<{
+        creator: PublicKey;
+        tokenMint: PublicKey;
+        realTokenReserves: BN;
+        virtualTokenReserves: BN;
+        realSolReserves: BN;
+        tokenTotalSupply: BN;
+        initialVirtualReserveUsd: BN;
+        status: ({
+            complete?: undefined;
+            migrated?: undefined;
+        } & {
+            active: Record<string, never>;
+        }) | ({
+            active?: undefined;
+            migrated?: undefined;
+        } & {
+            complete: {
+                solPriceSnapshot: BN;
+            };
+        }) | ({
+            active?: undefined;
+            complete?: undefined;
+        } & {
+            migrated: Record<string, never>;
+        });
+        bump: number;
+    }>;
+    /** Fetches a bonding curve account by its PDA address directly. */
+    fetchNativeBondingCurveByAddress(address: PublicKey): Promise<{
+        creator: PublicKey;
+        tokenMint: PublicKey;
+        realTokenReserves: BN;
+        virtualTokenReserves: BN;
+        realSolReserves: BN;
+        tokenTotalSupply: BN;
+        initialVirtualReserveUsd: BN;
+        status: ({
+            complete?: undefined;
+            migrated?: undefined;
+        } & {
+            active: Record<string, never>;
+        }) | ({
+            active?: undefined;
+            migrated?: undefined;
+        } & {
+            complete: {
+                solPriceSnapshot: BN;
+            };
+        }) | ({
+            active?: undefined;
+            complete?: undefined;
+        } & {
+            migrated: Record<string, never>;
+        });
+        bump: number;
+    }>;
+    /** Fetches the AMM global configuration. */
+    fetchAmmConfig(): Promise<{
+        adminAuthority: PublicKey;
+        feeRecipients: PublicKey[];
+        quoteMints: PublicKey[];
+        feeTiers: {
+            rangeStartInclusive: BN;
+            rangeEndExclusive: BN;
+            lpFeeRate: number;
+            protocolFeeRate: number;
+            creatorFeeRate: number;
+        }[];
+        oraclePriceFeed: PublicKey;
+        pendingAdmin: PublicKey | null;
+        bump: number;
+        paused: boolean;
+    }>;
+    /** Fetches an AMM pool state by base and quote mint. */
+    fetchPoolState(baseMint: PublicKey, quoteMint?: PublicKey): Promise<{
+        baseVault: PublicKey;
+        quoteVault: PublicKey;
+        lpMint: PublicKey;
+        baseMint: PublicKey;
+        quoteMint: PublicKey;
+        baseTokenProgram: PublicKey;
+        quoteTokenProgram: PublicKey;
+        observationKey: PublicKey;
+        authBump: number;
+        lpMintDecimals: number;
+        baseDecimals: number;
+        quoteDecimals: number;
+        lpSupply: BN;
+        recentEpoch: BN;
+        creator: PublicKey;
+    }>;
+    /** Fetches a pool state by its PDA address directly. */
+    fetchPoolStateByAddress(address: PublicKey): Promise<{
+        baseVault: PublicKey;
+        quoteVault: PublicKey;
+        lpMint: PublicKey;
+        baseMint: PublicKey;
+        quoteMint: PublicKey;
+        baseTokenProgram: PublicKey;
+        quoteTokenProgram: PublicKey;
+        observationKey: PublicKey;
+        authBump: number;
+        lpMintDecimals: number;
+        baseDecimals: number;
+        quoteDecimals: number;
+        lpSupply: BN;
+        recentEpoch: BN;
+        creator: PublicKey;
+    }>;
+    /** Fetches the observation state (oracle data) for a pool. */
+    fetchObservationState(poolAddress: PublicKey): Promise<{
+        initialized: boolean;
+        observationIndex: number;
+        poolId: PublicKey;
+        observations: {
+            blockTimestamp: BN;
+            cumulativeBasePriceX32: BN;
+            cumulativeQuotePriceX32: BN;
+        }[];
+        lastUpdateTimestamp: BN;
+        padding: BN[];
+    }>;
+    /** Fetches the fee configuration for a token mint. */
+    fetchFeeConfig(tokenMint: PublicKey): Promise<{
+        creator: PublicKey;
+        tokenMint: PublicKey;
+        quoteMint: PublicKey;
+        feeMode: ({
+            revoked?: undefined;
+        } & {
+            recipients: Record<string, never>;
+        }) | ({
+            recipients?: undefined;
+        } & {
+            revoked: Record<string, never>;
+        });
+        recipientsCount: number;
+        recipients: {
+            pubkey: PublicKey;
+            basisPoints: number;
+            padding: number[];
+        }[];
+        updateAuthority: PublicKey;
+        bump: number;
+    }>;
+    /** Fetches a fee configuration by its PDA address directly. */
+    fetchFeeConfigByAddress(address: PublicKey): Promise<{
+        creator: PublicKey;
+        tokenMint: PublicKey;
+        quoteMint: PublicKey;
+        feeMode: ({
+            revoked?: undefined;
+        } & {
+            recipients: Record<string, never>;
+        }) | ({
+            recipients?: undefined;
+        } & {
+            revoked: Record<string, never>;
+        });
+        recipientsCount: number;
+        recipients: {
+            pubkey: PublicKey;
+            basisPoints: number;
+            padding: number[];
+        }[];
+        updateAuthority: PublicKey;
+        bump: number;
+    }>;
+    /** Fetches a user's properties (referrer, volumes, cashback state). */
+    fetchUserProperties(user: PublicKey): Promise<{
+        referrer: {
+            referrer: PublicKey;
+            deal: PublicKey | null;
+            cashbackMultiplierBps: number;
+        } | null;
+        totalSolVolume: BN;
+        totalTokenVolume: BN;
+        cashbackCredits: BN;
+        isSpending: boolean;
+        curveSolVolume: BN;
+        ammSolVolume: BN;
+        snapshotSolVolume: BN;
+        snapshotTokenVolume: BN;
+        snapshotCount: number;
+        latestSnapshot: PublicKey | null;
+    }>;
+    /** Fetches the token volume accumulator for a mint. */
+    fetchTokenVolume(mint: PublicKey): Promise<{
+        mint: PublicKey;
+        totalSolVolume: BN;
+        totalTokenVolume: BN;
+        curveSolVolume: BN;
+        ammSolVolume: BN;
+    }>;
+    /** Fetches the global curve volume accumulator. */
+    fetchGlobalCurveVolume(): Promise<{
+        totalSolVolume: BN;
+        totalTokenVolume: BN;
+    }>;
+    /** Fetches the global AMM volume accumulator. */
+    fetchGlobalAmmVolume(): Promise<{
+        totalSolVolume: BN;
+        totalTokenVolume: BN;
+    }>;
+    /** Fetches the cashback configuration. */
+    fetchCashbackConfig(): Promise<{
+        adminAuthority: PublicKey;
+        ranges: {
+            rangeStartInclusive: BN;
+            rangeEndExclusive: BN;
+            multiplierBasisPoints: number;
+        }[];
+        traderCashbackBasisPoints: number;
+        pendingAdmin: PublicKey | null;
+    }>;
+    /** Fetches a user snapshot by user and index. */
+    fetchUserSnapshot(user: PublicKey, index: number): Promise<{
+        user: PublicKey;
+        index: number;
+        prevSnapshot: PublicKey | null;
+        solVolume: BN;
+        tokenVolume: BN;
+        createdAt: BN;
+    }>;
+    /** Fetches a deal account by its owner. */
+    fetchDeal(owner: PublicKey): Promise<{
+        owner: PublicKey;
+        cashbackMultiplierBps: number;
+        redemptionCount: number;
+    }>;
+    /**
+     * Previews a buy on the bonding curve. Auto-fetches state from chain.
+     *
+     * @param mint - Token mint address
+     * @param amountInQuote - Quote token amount to spend (lamports for SOL, smallest unit for stables)
+     * @param options - Native (`{ solPriceUsd }`) or stable (`{ quoteMint }`) curve options
+     * @returns Buy preview with `tokensOut`, `fees`, `priceImpactBps`, `newReserves`, and `willComplete`
+     */
+    previewBuyOnCurve(mint: PublicKey, amountInQuote: BN, options: CurveAsyncOptions): Promise<BuyCurvePreview>;
+    /**
+     * Previews a sell on the bonding curve. Auto-fetches state from chain.
+     *
+     * @param mint - Token mint address
+     * @param amountInTokens - Token amount to sell (smallest unit, 6 decimals)
+     * @param options - Native (`{ solPriceUsd }`) or stable (`{ quoteMint }`) curve options
+     * @returns Sell preview with `quoteOut`, `quoteOutNet`, `fees`, `priceImpactBps`, and `newReserves`
+     */
+    previewSellOnCurve(mint: PublicKey, amountInTokens: BN, options: CurveAsyncOptions): Promise<SellCurvePreview>;
+    /** Previews a sell swap on the AMM (base → quote). Accepts optional pre-fetched state. */
+    previewSwapSell(baseMint: PublicKey, quoteMint: PublicKey, amountIn: BN, options?: {
+        prefetched?: SwapPrefetchedState;
+    }): Promise<SwapPreview>;
+    /** Previews a buy swap on the AMM (quote → base). Accepts optional pre-fetched state. */
+    previewSwapBuy(baseMint: PublicKey, quoteMint: PublicKey, amountOut: BN, options?: {
+        prefetched?: SwapPrefetchedState;
+    }): Promise<SwapPreview>;
+    /** Derives the bonding curve PDA for a token mint. */
+    getBondingCurvePDA(mint: PublicKey): [PublicKey, number];
+    /** Derives the SOL vault PDA for a bonding curve. */
+    getBondingCurveSolVaultPDA(bondingCurve: PublicKey): [PublicKey, number];
+    /** Derives the referral vault PDA. */
+    getReferralVaultPDA(referrer: PublicKey): [PublicKey, number];
+    /** Derives the buyback vault PDA for a bonding curve. */
+    getBuybackVaultPDA(bondingCurve: PublicKey): [PublicKey, number];
+    /** Derives the pool state PDA for a token pair. */
+    getPoolPDA(baseMint: PublicKey, quoteMint?: PublicKey): [PublicKey, number];
+    /** Derives the LP mint PDA for a pool. */
+    getPoolLpMintPDA(poolState: PublicKey): [PublicKey, number];
+    /** Derives the pool vault PDA for a specific token. */
+    getPoolVaultPDA(poolState: PublicKey, mint: PublicKey): [PublicKey, number];
+    /** Derives the observation state PDA (oracle data) for a pool. */
+    getObservationPDA(poolState: PublicKey): [PublicKey, number];
+    /** Derives the fee configuration PDA for a token mint. */
+    getFeeConfigPDA(tokenMint: PublicKey): [PublicKey, number];
+    /** Derives the fee vault PDA for a fee configuration. */
+    getFeeVaultPDA(feeConfig: PublicKey): [PublicKey, number];
+    /** Derives the recipient vault PDA for a specific recipient within a fee config. */
+    getRecipientVaultPDA(feeConfig: PublicKey, recipient: PublicKey): [PublicKey, number];
+    /** Derives the user properties PDA. */
+    getUserPropertiesPDA(user: PublicKey): [PublicKey, number];
+    /** Derives the token volume accumulator PDA. */
+    getTokenVolumePDA(mint: PublicKey): [PublicKey, number];
+    /** Derives the user snapshot PDA for a given user and index. */
+    getUserSnapshotPDA(user: PublicKey, index: number): [PublicKey, number];
+    /** Derives the deal PDA for a given owner. */
+    getDealPDA(owner: PublicKey): [PublicKey, number];
+    /** Derives all PDAs associated with a bonding curve token. */
+    getAllBondingCurvePDAs(mint: PublicKey, creator: PublicKey): import("./index.js").BondingCurvePDAs;
+    /** Derives all PDAs associated with an AMM pool. */
+    getAllPoolPDAs(baseMint: PublicKey, quoteMint?: PublicKey): import("./index.js").PoolPDAs;
+    /** Derives all PDAs needed for bonding curve to AMM migration. */
+    getMigrationPDAs(tokenMint: PublicKey): import("./index.js").MigrationPDAs;
+    /**
+     * Builds an unsigned Transaction from instructions, with optional compute
+     * budget. Fetches a recent blockhash. Caller is responsible for signing.
+     */
+    buildTransaction(instructions: TransactionInstruction[], options: BuildTransactionOptions): Promise<Transaction>;
+    /**
+     * Resolves the token program (SPL Token or Token-2022) for a mint.
+     */
+    resolveTokenProgram(mint: PublicKey): Promise<PublicKey>;
+}
+//# sourceMappingURL=client.d.ts.map