@liquid-af/sdk 0.1.0

package/dist/transaction/send.d.ts

@@ -0,0 +1,25 @@
+import type { Connection } from "@solana/web3.js";
+/**
+ * Confirms a transaction with the given signature and blockhash info.
+ *
+ * @param connection - Solana RPC connection
+ * @param signature - Transaction signature to confirm
+ * @param blockhash - Recent blockhash used in the transaction
+ * @param lastValidBlockHeight - Block height after which the transaction expires
+ * @returns The confirmed transaction signature
+ */
+export declare const confirmTx: (connection: Connection, signature: string, blockhash: string, lastValidBlockHeight: number) => Promise<string>;
+/**
+ * Executes an RPC call and confirms the transaction.
+ *
+ * Handles Anchor's legacy 30s confirmation timeout: if .rpc() throws a
+ * TransactionExpiredTimeoutError the transaction may still have landed.
+ * We extract the signature from the error and re-check status before
+ * propagating the failure.
+ *
+ * @param connection - Solana RPC connection
+ * @param rpcCall - Async function that sends the transaction and returns its signature
+ * @returns The confirmed transaction signature
+ */
+export declare const sendAndConfirm: (connection: Connection, rpcCall: () => Promise<string>) => Promise<string>;
+//# sourceMappingURL=send.d.ts.map

package/dist/transaction/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/transaction/send.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GACrB,YAAY,UAAU,EACtB,WAAW,MAAM,EACjB,WAAW,MAAM,EACjB,sBAAsB,MAAM,KAC1B,OAAO,CAAC,MAAM,CAMhB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAC1B,YAAY,UAAU,EACtB,SAAS,MAAM,OAAO,CAAC,MAAM,CAAC,KAC5B,OAAO,CAAC,MAAM,CAgChB,CAAC"}

package/dist/transaction/send.js

@@ -0,0 +1,52 @@
+/**
+ * Confirms a transaction with the given signature and blockhash info.
+ *
+ * @param connection - Solana RPC connection
+ * @param signature - Transaction signature to confirm
+ * @param blockhash - Recent blockhash used in the transaction
+ * @param lastValidBlockHeight - Block height after which the transaction expires
+ * @returns The confirmed transaction signature
+ */
+export const confirmTx = async (connection, signature, blockhash, lastValidBlockHeight) => {
+    await connection.confirmTransaction({ blockhash, lastValidBlockHeight, signature }, "confirmed");
+    return signature;
+};
+/**
+ * Executes an RPC call and confirms the transaction.
+ *
+ * Handles Anchor's legacy 30s confirmation timeout: if .rpc() throws a
+ * TransactionExpiredTimeoutError the transaction may still have landed.
+ * We extract the signature from the error and re-check status before
+ * propagating the failure.
+ *
+ * @param connection - Solana RPC connection
+ * @param rpcCall - Async function that sends the transaction and returns its signature
+ * @returns The confirmed transaction signature
+ */
+export const sendAndConfirm = async (connection, rpcCall) => {
+    try {
+        const signature = await rpcCall();
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+        await confirmTx(connection, signature, blockhash, lastValidBlockHeight);
+        return signature;
+    }
+    catch (err) {
+        if (err &&
+            typeof err === "object" &&
+            "signature" in err &&
+            typeof err.signature === "string") {
+            const sig = err.signature;
+            await new Promise((r) => setTimeout(r, 2000));
+            try {
+                const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+                await confirmTx(connection, sig, blockhash, lastValidBlockHeight);
+                return sig;
+            }
+            catch {
+                // Re-confirmation also failed - throw the original error
+            }
+        }
+        throw err;
+    }
+};
+//# sourceMappingURL=send.js.map

package/dist/transaction/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/transaction/send.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC7B,UAAsB,EACtB,SAAiB,EACjB,SAAiB,EACjB,oBAA4B,EACV,EAAE;IACpB,MAAM,UAAU,CAAC,kBAAkB,CAClC,EAAE,SAAS,EAAE,oBAAoB,EAAE,SAAS,EAAE,EAC9C,WAAW,CACX,CAAC;IACF,OAAO,SAAS,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAClC,UAAsB,EACtB,OAA8B,EACZ,EAAE;IACpB,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,MAAM,OAAO,EAAE,CAAC;QAClC,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GACxC,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;QACvC,MAAM,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;QACxE,OAAO,SAAS,CAAC;IAClB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,IACC,GAAG;YACH,OAAO,GAAG,KAAK,QAAQ;YACvB,WAAW,IAAI,GAAG;YAClB,OAAQ,GAA+B,CAAC,SAAS,KAAK,QAAQ,EAC7D,CAAC;YACF,MAAM,GAAG,GAAI,GAA+B,CAAC,SAAmB,CAAC;YACjE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9C,IAAI,CAAC;gBACJ,MAAM,EAAE,SAAS,EAAE,oBAAoB,EAAE,GACxC,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;gBACvC,MAAM,SAAS,CACd,UAAU,EACV,GAAG,EACH,SAAS,EACT,oBAAoB,CACpB,CAAC;gBACF,OAAO,GAAG,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACR,yDAAyD;YAC1D,CAAC;QACF,CAAC;QACD,MAAM,GAAG,CAAC;IACX,CAAC;AACF,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,311 @@
+import type { PublicKey } from "@solana/web3.js";
+import type BN from "bn.js";
+/** Curve status enum values */
+export declare const CurveStatus: {
+    readonly Active: "active";
+    readonly Complete: "complete";
+    readonly Migrated: "migrated";
+};
+export type CurveStatus = (typeof CurveStatus)[keyof typeof CurveStatus];
+/** Anchor-serialized curve status representation */
+export type CurveStatusAnchor = {
+    active: Record<string, never>;
+} | {
+    complete: {
+        solPriceSnapshot: BN;
+    };
+} | {
+    migrated: Record<string, never>;
+};
+/**
+ * Checks if an Anchor-serialized curve status matches an expected CurveStatus enum value.
+ *
+ * @param anchorStatus - The Anchor-serialized curve status to check
+ * @param expected - The expected CurveStatus enum value
+ * @returns True if the Anchor status matches the expected value
+ */
+export declare const curveStatusEquals: (anchorStatus: CurveStatusAnchor, expected: CurveStatus) => boolean;
+/** Fee mode enum values */
+export declare const FeeMode: {
+    readonly Recipients: "recipients";
+    readonly Revoked: "revoked";
+};
+export type FeeMode = (typeof FeeMode)[keyof typeof FeeMode];
+/** Anchor-serialized fee mode representation */
+export type FeeModeAnchor = {
+    recipients: Record<string, never>;
+} | {
+    revoked: Record<string, never>;
+};
+/**
+ * Converts a FeeMode enum value to its Anchor-compatible serialized format.
+ *
+ * @param mode - The fee mode to convert
+ * @returns Anchor-serialized fee mode object
+ */
+export declare const toAnchorFeeMode: (mode: FeeMode) => FeeModeAnchor;
+/**
+ * Checks if an Anchor-serialized fee mode matches an expected FeeMode enum value.
+ *
+ * @param anchorMode - The Anchor-serialized fee mode to check
+ * @param expected - The expected FeeMode enum value
+ * @returns True if the Anchor fee mode matches the expected value
+ */
+export declare const feeModeEquals: (anchorMode: FeeModeAnchor, expected: FeeMode) => boolean;
+/** Global configuration for the bonding curve program */
+export interface GlobalConfiguration {
+    adminAuthority: PublicKey;
+    initialVirtualTokenReserves: BN;
+    initialVirtualSolReserves: BN;
+    initialRealTokenReserves: BN;
+    tokenTotalSupply: BN;
+    traderCashbackBasisPoints: number;
+    creatorFeeBasisPoints: number;
+    creatorReferralRewardBasisPoints: number;
+    traderReferralRewardBasisPoints: number;
+    protocolFeeBasisPoints: number;
+    feeRecipients: PublicKey[];
+    quoteMints: PublicKey[];
+    paused: boolean;
+}
+/** Native bonding curve account state */
+export interface BondingCurveState {
+    creator: PublicKey;
+    tokenMint: PublicKey;
+    realTokenReserves: BN;
+    virtualTokenReserves: BN;
+    realSolReserves: BN;
+    virtualSolReserves: BN;
+    tokenTotalSupply: BN;
+    status: CurveStatusAnchor;
+    bump: number;
+}
+/** Market cap-based fee tier definition */
+export interface FeeTier {
+    rangeStartInclusive: BN;
+    rangeEndExclusive: BN;
+    lpFeeRate: number;
+    protocolFeeRate: number;
+    creatorFeeRate: number;
+}
+/** AMM global configuration */
+export interface AmmConfig {
+    adminAuthority: PublicKey;
+    feeRecipients: PublicKey[];
+    quoteMints: PublicKey[];
+    bump: number;
+    paused: boolean;
+    feeTiers: FeeTier[];
+    oraclePriceFeed: PublicKey;
+}
+/** AMM pool state account */
+export interface PoolState {
+    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;
+}
+/** Oracle observation entry */
+export interface Observation {
+    blockTimestamp: BN;
+    cumulativeBasePriceX32: BN;
+    cumulativeQuotePriceX32: BN;
+}
+/** Oracle observation state */
+export interface ObservationState {
+    initialized: boolean;
+    observationIndex: number;
+    poolId: PublicKey;
+    observations: Observation[];
+    lastUpdateTimestamp: BN;
+}
+/** Fee recipient with basis point allocation */
+export interface FeeRecipient {
+    pubkey: PublicKey;
+    basisPoints: number;
+}
+/** Unified fee configuration for a token */
+export interface UnifiedFeeConfiguration {
+    creator: PublicKey;
+    tokenMint: PublicKey;
+    feeMode: FeeModeAnchor;
+    recipientsCount: number;
+    recipients: FeeRecipient[];
+    updateAuthority: PublicKey;
+    locked: boolean;
+    bump: number;
+}
+/** Referrer information attached to a user */
+export interface ReferrerInfo {
+    referrer: PublicKey;
+    deal: PublicKey | null;
+    cashbackMultiplierBps: number;
+}
+/** User properties account */
+export interface UserProperties {
+    referrer: ReferrerInfo | null;
+    totalSolVolume: BN;
+    totalTokenVolume: BN;
+    cashbackCredits: BN;
+    isSpending: boolean;
+    curveSolVolume: BN;
+    ammSolVolume: BN;
+    snapshotSolVolume: BN;
+    snapshotTokenVolume: BN;
+    snapshotCount: number;
+    latestSnapshot: PublicKey | null;
+}
+/** User volume snapshot account */
+export interface UserSnapshot {
+    user: PublicKey;
+    index: number;
+    prevSnapshot: PublicKey | null;
+    solVolume: BN;
+    tokenVolume: BN;
+    createdAt: BN;
+}
+/** Exclusive deal for a referrer/influencer */
+export interface Deal {
+    owner: PublicKey;
+    cashbackMultiplierBps: number;
+    redemptionCount: number;
+}
+/** Arguments for admin_update_user instruction */
+export interface AdminUpdateUserArgs {
+    newReferrer: PublicKey | null;
+    newCashbackMultiplierBps: number | null;
+}
+/** Per-token volume accumulator */
+export interface TokenVolumeAccumulator {
+    mint: PublicKey;
+    totalSolVolume: BN;
+    totalTokenVolume: BN;
+    curveSolVolume: BN;
+    ammSolVolume: BN;
+}
+/** Global curve volume accumulator */
+export interface GlobalCurveVolume {
+    totalSolVolume: BN;
+    totalTokenVolume: BN;
+}
+/** Global AMM volume accumulator */
+export interface GlobalAmmVolume {
+    totalSolVolume: BN;
+    totalTokenVolume: BN;
+}
+/** Cashback range tier */
+export interface CashbackRange {
+    rangeStartInclusive: BN;
+    rangeEndExclusive: BN;
+    multiplierBasisPoints: number;
+}
+/** Cashback configuration */
+export interface CashbackConfiguration {
+    adminAuthority: PublicKey;
+    rangesCount: number;
+    ranges: CashbackRange[];
+    traderCashbackBasisPoints: number;
+}
+/** Fee breakdown from a trade */
+export interface FeeDistribution {
+    protocolFee: BN;
+    creatorFee: BN;
+    creatorReferralFee: BN;
+    traderReferralFee: BN;
+    totalFees: BN;
+}
+/** Buy calculation result for bonding curve */
+export interface BondingCurveBuyResult extends FeeDistribution {
+    tokensOut: BN;
+    newVirtualQuote: BN;
+    newVirtualToken: BN;
+    amountInNet: BN;
+}
+/** Sell calculation result for bonding curve */
+export interface BondingCurveSellResult extends FeeDistribution {
+    quoteOutGross: BN;
+    quoteOutNet: BN;
+    newVirtualQuote: BN;
+    newVirtualToken: BN;
+}
+/** AMM swap fees breakdown */
+export interface SwapFees {
+    lpFee: BN;
+    creatorFee: BN;
+    protocolFee: BN;
+    totalFees: BN;
+}
+/** AMM sell output calculation */
+export interface AmmSellOutput extends SwapFees {
+    quoteOut: BN;
+    quoteOutNet: BN;
+}
+/** AMM buy input calculation */
+export interface AmmBuyInput extends SwapFees {
+    quoteIn: BN;
+    quoteInGross: BN;
+}
+/** LP token to trading token conversion */
+export interface LpTokenAmounts {
+    baseAmount: BN;
+    quoteAmount: BN;
+}
+/** Fee distribution result for multi-recipient */
+export interface DistributionResult {
+    pubkey: PublicKey;
+    amount: number;
+}
+/** Convenience type aggregating pool state with derived addresses */
+export interface PoolInfo {
+    poolAddress: PublicKey;
+    poolState: PoolState;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseTokenProgram: PublicKey;
+    quoteTokenProgram: PublicKey;
+    baseVault: PublicKey;
+    quoteVault: PublicKey;
+    lpMint: PublicKey;
+    creator: PublicKey;
+}
+/** Preview result for buying on the bonding curve */
+export interface BuyCurvePreview {
+    tokensOut: BN;
+    fees: FeeDistribution;
+    priceImpactBps: number;
+    newReserves: {
+        virtualQuote: BN;
+        virtualToken: BN;
+    };
+    willComplete: boolean;
+}
+/** Preview result for selling on the bonding curve */
+export interface SellCurvePreview {
+    quoteOut: BN;
+    quoteOutNet: BN;
+    fees: FeeDistribution;
+    priceImpactBps: number;
+    newReserves: {
+        virtualQuote: BN;
+        virtualToken: BN;
+    };
+}
+/** Preview result for AMM swaps */
+export interface SwapPreview {
+    amountOut: BN;
+    amountOutNet: BN;
+    fees: SwapFees;
+    priceImpactBps: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,46 @@
+/** Curve status enum values */
+export const CurveStatus = {
+    Active: "active",
+    Complete: "complete",
+    Migrated: "migrated",
+};
+/**
+ * Checks if an Anchor-serialized curve status matches an expected CurveStatus enum value.
+ *
+ * @param anchorStatus - The Anchor-serialized curve status to check
+ * @param expected - The expected CurveStatus enum value
+ * @returns True if the Anchor status matches the expected value
+ */
+export const curveStatusEquals = (anchorStatus, expected) => {
+    return Object.keys(anchorStatus)[0] === expected;
+};
+/** Fee mode enum values */
+export const FeeMode = {
+    Recipients: "recipients",
+    Revoked: "revoked",
+};
+/**
+ * Converts a FeeMode enum value to its Anchor-compatible serialized format.
+ *
+ * @param mode - The fee mode to convert
+ * @returns Anchor-serialized fee mode object
+ */
+export const toAnchorFeeMode = (mode) => {
+    switch (mode) {
+        case FeeMode.Recipients:
+            return { recipients: {} };
+        case FeeMode.Revoked:
+            return { revoked: {} };
+    }
+};
+/**
+ * Checks if an Anchor-serialized fee mode matches an expected FeeMode enum value.
+ *
+ * @param anchorMode - The Anchor-serialized fee mode to check
+ * @param expected - The expected FeeMode enum value
+ * @returns True if the Anchor fee mode matches the expected value
+ */
+export const feeModeEquals = (anchorMode, expected) => {
+    return Object.keys(anchorMode)[0] === expected;
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,+BAA+B;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;CACX,CAAC;AAUX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,YAA+B,EAC/B,QAAqB,EACX,EAAE;IACZ,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;AAClD,CAAC,CAAC;AAEF,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;CACT,CAAC;AASX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAa,EAAiB,EAAE;IAC/D,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,OAAO,CAAC,UAAU;YACtB,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC3B,KAAK,OAAO,CAAC,OAAO;YACnB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC5B,UAAyB,EACzB,QAAiB,EACP,EAAE;IACZ,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;AAChD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,112 @@
+{
+	"name": "@liquid-af/sdk",
+	"version": "0.1.0",
+	"description": "TypeScript SDK for the Liquid DeFi protocol on Solana",
+	"type": "module",
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./pda": {
+			"types": "./dist/pda/index.d.ts",
+			"default": "./dist/pda/index.js"
+		},
+		"./math": {
+			"types": "./dist/math/index.d.ts",
+			"default": "./dist/math/index.js"
+		},
+		"./accounts": {
+			"types": "./dist/accounts/index.d.ts",
+			"default": "./dist/accounts/index.js"
+		},
+		"./instructions": {
+			"types": "./dist/instructions/index.d.ts",
+			"default": "./dist/instructions/index.js"
+		},
+		"./helpers": {
+			"types": "./dist/helpers/index.d.ts",
+			"default": "./dist/helpers/index.js"
+		},
+		"./events": {
+			"types": "./dist/events/index.d.ts",
+			"default": "./dist/events/index.js"
+		},
+		"./transaction": {
+			"types": "./dist/transaction/index.d.ts",
+			"default": "./dist/transaction/index.js"
+		},
+		"./client": {
+			"types": "./dist/client.d.ts",
+			"default": "./dist/client.js"
+		},
+		"./provider": {
+			"types": "./dist/provider.d.ts",
+			"default": "./dist/provider.js"
+		},
+		"./errors": {
+			"types": "./dist/errors.d.ts",
+			"default": "./dist/errors.js"
+		}
+	},
+	"keywords": [
+		"solana",
+		"defi",
+		"dex",
+		"amm",
+		"bonding-curve",
+		"token-launch",
+		"cpmm",
+		"swap",
+		"liquidity",
+		"typescript",
+		"sdk",
+		"web3",
+		"crypto"
+	],
+	"engines": {
+		"node": ">=18.0.0",
+		"npm": ">=8.0.0"
+	},
+	"sideEffects": false,
+	"files": [
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"build": "yarn copy-idl && tsc",
+		"copy-idl": "cp ../../target/idl/*.json src/idl/ && cp ../../target/types/*.ts src/idl/",
+		"clean": "rm -rf dist",
+		"prebuild": "yarn clean",
+		"prepack": "yarn build",
+		"prepublishOnly": "yarn test:build",
+		"test:build": "tsc --noEmit",
+		"version:patch": "npm version patch",
+		"version:minor": "npm version minor",
+		"version:major": "npm version major",
+		"docs": "typedoc",
+		"publish:test": "npm publish --dry-run",
+		"publish:prod": "npm publish"
+	},
+	"peerDependencies": {
+		"@coral-xyz/anchor": ">=0.30.0",
+		"@solana/spl-token": ">=0.4.0",
+		"@solana/web3.js": ">=1.70.0",
+		"bn.js": ">=5.0.0"
+	},
+	"devDependencies": {
+		"@coral-xyz/anchor": "^0.32.1",
+		"@solana/spl-token": "^0.4.14",
+		"@solana/web3.js": "^1.95.0",
+		"@types/bn.js": "^5.1.0",
+		"bn.js": "^5.2.1",
+		"typedoc": "^0.28.16",
+		"typescript": "^5.7.3"
+	},
+	"license": "ISC"
+}

package/src/accounts/index.ts

@@ -0,0 +1,26 @@
+export {
+	fetchLiquidGlobalConfig,
+	fetchNativeBondingCurve,
+	fetchNativeBondingCurveByAddress,
+	fetchStableBondingCurve,
+	fetchStableBondingCurveByAddress,
+} from "./liquid.js";
+
+export {
+	fetchAmmConfig,
+	fetchPoolState,
+	fetchPoolStateByAddress,
+	fetchObservationState,
+} from "./liquid-swap.js";
+
+export { fetchFeeConfig, fetchFeeConfigByAddress } from "./liquid-fees.js";
+
+export {
+	fetchUserProperties,
+	fetchTokenVolume,
+	fetchGlobalCurveVolume,
+	fetchGlobalAmmVolume,
+	fetchCashbackConfig,
+	fetchUserSnapshot,
+	fetchDeal,
+} from "./liquid-state.js";

package/src/accounts/liquid-fees.ts

@@ -0,0 +1,38 @@
+import type { Connection, PublicKey } from "@solana/web3.js";
+import type { LiquidConfig } from "../config.js";
+import { getFeeConfigPDA } from "../pda/liquid-fees.js";
+import { getLiquidFeesProgram } from "../idl/index.js";
+
+/**
+ * Fetches the fee configuration for a token mint.
+ *
+ * @param connection - Solana RPC connection
+ * @param tokenMint - Token mint address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized fee configuration account
+ */
+export async function fetchFeeConfig(
+	connection: Connection,
+	tokenMint: PublicKey,
+	config: LiquidConfig
+) {
+	const [pda] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+	return fetchFeeConfigByAddress(connection, pda, config);
+}
+
+/**
+ * Fetches the fee configuration by its PDA address directly.
+ *
+ * @param connection - Solana RPC connection
+ * @param feeConfigAddress - The fee configuration PDA address
+ * @param config - Liquid protocol configuration
+ * @returns The deserialized fee configuration account
+ */
+export async function fetchFeeConfigByAddress(
+	connection: Connection,
+	feeConfigAddress: PublicKey,
+	config: LiquidConfig
+) {
+	const program = getLiquidFeesProgram(connection, config);
+	return program.account.unifiedFeeConfiguration.fetch(feeConfigAddress);
+}