@liquid-af/sdk 0.1.0

package/dist/instructions/liquid.js

@@ -0,0 +1,483 @@
+import { getAssociatedTokenAddressSync, TOKEN_PROGRAM_ID, } from "@solana/spl-token";
+import { WSOL_MINT } from "../config.js";
+import { getBondingCurvePDA, getBondingCurveTokenAccount, getStableBondingCurvePDA, } from "../pda/liquid.js";
+import { getUserPropertiesPDA, getTokenVolumePDA } from "../pda/liquid-state.js";
+import { getPoolPDA, getPoolLpMintPDA, getPoolVaultPDA, getObservationPDA, getSwapGlobalConfigPDA, getSwapAuthorityPDA, getSwapBuybackVaultPDA, } from "../pda/liquid-swap.js";
+import { getCachedLiquidProgram } from "./program-cache.js";
+import { fetchNativeBondingCurve, fetchStableBondingCurve, } from "../accounts/liquid.js";
+/**
+ * Builds a createNativeCurve instruction.
+ * The mint Keypair must be passed as a signer when sending the transaction.
+ * Atomically initializes the fee configuration via CPI to liquid-fees
+ * with the creator as the sole recipient (100%). Use `buildUpdateFeeConfig`
+ * to set custom recipients afterward.
+ *
+ * @param params - {@link BuildCreateNativeCurveParams}
+ * @returns Transaction instruction
+ */
+export function buildCreateNativeCurve(params) {
+    const { creator, mint, pythPriceFeed, name, symbol, uri, config } = params;
+    const program = getCachedLiquidProgram(config);
+    const bondingCurveTokenAccount = getBondingCurveTokenAccount(mint, config.liquidProgramId);
+    return program.methods
+        .createNativeCurve({
+        name,
+        symbol,
+        uri,
+    })
+        .accounts({
+        creator,
+        mint,
+        pythPriceFeed,
+        bondingCurveTokenAccount,
+    })
+        .instruction();
+}
+/**
+ * Builds a bumpNative instruction.
+ * Re-evaluates a native bonding curve's market cap against the current oracle price
+ * and marks it as complete if the threshold is exceeded. Permissionless.
+ *
+ * @param params - {@link BuildBumpNativeParams}
+ * @returns Transaction instruction
+ */
+export function buildBumpNative(params) {
+    const { mint, pythPriceFeed, config } = params;
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .bumpNative()
+        .accounts({
+        mint,
+        pythPriceFeed,
+    })
+        .instruction();
+}
+/**
+ * Builds a buyNative instruction.
+ * Requires the bonding curve creator and Pyth price feed to be known.
+ *
+ * @param params - {@link BuildBuyNativeParams}
+ * @returns Transaction instruction
+ */
+export function buildBuyNative(params) {
+    const { user, mint, creator, pythPriceFeed, amountIn, minAmountOut, feeRecipient, creatorReferralVault, traderReferralVault, config, } = params;
+    const program = getCachedLiquidProgram(config);
+    // Derive creator-related accounts that Anchor can't auto-resolve
+    const [creatorUserProperties] = getUserPropertiesPDA(creator, config.liquidStateProgramId);
+    return program.methods
+        .buyNative(amountIn, minAmountOut)
+        .accountsPartial({
+        user,
+        feeRecipient,
+        mint,
+        pythPriceFeed,
+        creatorUserProperties,
+        creatorReferralVault: creatorReferralVault ?? null,
+        traderReferralVault: traderReferralVault ?? null,
+        liquidState: {
+            user,
+            tokenMint: mint,
+        },
+    })
+        .instruction();
+}
+/**
+ * Builds a buyNative instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildBuyNative`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildBuyNativeParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildBuyNativeAutoResolve(connection, params) {
+    const curve = await fetchNativeBondingCurve(connection, params.mint, params.config);
+    return buildBuyNative({
+        ...params,
+        creator: curve.creator,
+        pythPriceFeed: params.pythPriceFeed,
+    });
+}
+/**
+ * Builds a sellNative instruction.
+ * Requires the bonding curve creator and Pyth price feed to be known.
+ *
+ * @param params - {@link BuildSellNativeParams}
+ * @returns Transaction instruction
+ */
+export function buildSellNative(params) {
+    const { user, mint, creator, pythPriceFeed, amountIn, minAmountOut, feeRecipient, creatorReferralVault, traderReferralVault, config, } = params;
+    const program = getCachedLiquidProgram(config);
+    // Derive creator-related accounts that Anchor can't auto-resolve
+    const [creatorUserProperties] = getUserPropertiesPDA(creator, config.liquidStateProgramId);
+    return program.methods
+        .sellNative(amountIn, minAmountOut)
+        .accountsPartial({
+        user,
+        feeRecipient,
+        mint,
+        pythPriceFeed,
+        creatorUserProperties,
+        creatorReferralVault: creatorReferralVault ?? null,
+        traderReferralVault: traderReferralVault ?? null,
+        liquidState: {
+            user,
+            tokenMint: mint,
+        },
+    })
+        .instruction();
+}
+/**
+ * Builds a sellNative instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildSellNative`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildSellNativeParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildSellNativeAutoResolve(connection, params) {
+    const curve = await fetchNativeBondingCurve(connection, params.mint, params.config);
+    return buildSellNative({
+        ...params,
+        creator: curve.creator,
+        pythPriceFeed: params.pythPriceFeed,
+    });
+}
+/**
+ * Builds a migrate instruction (bonding curve -> AMM pool).
+ * Permissionless — anyone can trigger migration once the curve is complete.
+ *
+ * @param params - {@link BuildMigrateNativeParams}
+ * @returns Transaction instruction
+ */
+export function buildMigrateNative(params) {
+    const { migrator, mint, config } = params;
+    const program = getCachedLiquidProgram(config);
+    // Derive AMM PDAs
+    const [bondingCurve] = getBondingCurvePDA(mint, config.liquidProgramId);
+    const [ammPoolState] = getPoolPDA(mint, WSOL_MINT, config.liquidSwapProgramId);
+    const [ammLpMint] = getPoolLpMintPDA(ammPoolState, config.liquidSwapProgramId);
+    const [ammBaseVault] = getPoolVaultPDA(ammPoolState, mint, config.liquidSwapProgramId);
+    const [ammQuoteVault] = getPoolVaultPDA(ammPoolState, WSOL_MINT, config.liquidSwapProgramId);
+    const [ammObservationState] = getObservationPDA(ammPoolState, config.liquidSwapProgramId);
+    const [ammGlobalConfig] = getSwapGlobalConfigPDA(config.liquidSwapProgramId);
+    const [ammAuthority] = getSwapAuthorityPDA(config.liquidSwapProgramId);
+    const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
+    const bondingCurveLpToken = getAssociatedTokenAddressSync(ammLpMint, bondingCurve, true, TOKEN_PROGRAM_ID);
+    const [ammBuybackVault] = getSwapBuybackVaultPDA(ammPoolState, WSOL_MINT, config.liquidSwapProgramId);
+    return program.methods
+        .migrate()
+        .accounts({
+        signer: migrator,
+        mint,
+        ammPoolState,
+        ammLpMint,
+        ammBaseVault,
+        ammQuoteVault,
+        ammObservationState,
+        ammGlobalConfig,
+        ammAuthority,
+        bondingCurveLpToken,
+        tokenVolume,
+        ammBuybackVault,
+    })
+        .instruction();
+}
+/**
+ * Builds an initializeNativeReferralVault instruction (creates native SOL referral vault).
+ *
+ * @param params - {@link BuildInitializeNativeReferralVaultParams}
+ * @returns Transaction instruction
+ */
+export function buildInitializeNativeReferralVault(params) {
+    const { user, config } = params;
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .initializeNativeReferralVault()
+        .accounts({ user })
+        .instruction();
+}
+/**
+ * Builds a withdrawReferralRewards instruction.
+ *
+ * @param params - {@link BuildWithdrawReferralRewardsParams}
+ * @returns Transaction instruction
+ */
+export function buildWithdrawReferralRewards(params) {
+    const { user, config } = params;
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .withdrawReferralRewards()
+        .accounts({ user })
+        .instruction();
+}
+/**
+ * Builds an executeBuybackNative instruction for a native SOL bonding curve.
+ * Permissionless — anyone can trigger. Only works when fee config is Revoked.
+ *
+ * @param params - {@link BuildExecuteBuybackNativeParams}
+ * @returns Transaction instruction
+ */
+export function buildExecuteBuybackNative(params) {
+    const { payer, mint, pythPriceFeed, config } = params;
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .executeBuybackNative()
+        .accountsPartial({
+        payer,
+        mint,
+        pythPriceFeed,
+    })
+        .instruction();
+}
+/**
+ * Builds an executeBuybackToken instruction for a token-based bonding curve.
+ * Permissionless — anyone can trigger. Only works when fee config is Revoked.
+ *
+ * @param params - {@link BuildExecuteBuybackTokenParams}
+ * @returns Transaction instruction
+ */
+export function buildExecuteBuybackToken(params) {
+    const { payer, mint, quoteMint, config } = params;
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .executeBuybackToken()
+        .accountsPartial({
+        payer,
+        mint,
+        quoteMint,
+    })
+        .instruction();
+}
+/**
+ * Builds a createStableCurve instruction.
+ * Creates a token-based bonding curve (e.g., using USDC as quote).
+ * The mint Keypair must be passed as a signer when sending the transaction.
+ * Atomically initializes the fee configuration via CPI to liquid-fees
+ * with the creator as the sole recipient (100%). Use `buildUpdateFeeConfig`
+ * to set custom recipients afterward.
+ *
+ * @param params - {@link BuildCreateStableCurveParams}
+ * @returns Transaction instruction
+ */
+export function buildCreateStableCurve(params) {
+    const { creator, mint, quoteMint, name, symbol, uri, config } = params;
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .createStableCurve({
+        name,
+        symbol,
+        uri,
+    })
+        .accounts({
+        creator,
+        mint,
+        quoteMint,
+    })
+        .instruction();
+}
+/**
+ * Builds a buyStable instruction.
+ * Buys tokens from a token-based bonding curve using quote tokens (e.g., USDC).
+ *
+ * @param params - {@link BuildBuyStableParams}
+ * @returns Transaction instruction
+ */
+export function buildBuyStable(params) {
+    const { user, mint, quoteMint, creator, amountIn, minAmountOut, feeRecipient, creatorReferralVault, traderReferralVault, config, } = params;
+    const program = getCachedLiquidProgram(config);
+    // Fee recipient quote token account
+    const feeRecipientQuoteAccount = getAssociatedTokenAddressSync(quoteMint, feeRecipient, true, TOKEN_PROGRAM_ID);
+    // Derive creator-related accounts that Anchor can't auto-resolve
+    const [creatorUserProperties] = getUserPropertiesPDA(creator, config.liquidStateProgramId);
+    return program.methods
+        .buyStable(amountIn, minAmountOut)
+        .accountsPartial({
+        user,
+        mint,
+        quoteMint,
+        feeRecipient: feeRecipientQuoteAccount,
+        creatorUserProperties,
+        creatorReferralVault: creatorReferralVault ?? null,
+        traderReferralVault: traderReferralVault ?? null,
+        liquidState: {
+            user,
+            tokenMint: mint,
+        },
+    })
+        .instruction();
+}
+/**
+ * Builds a buyStable instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildBuyStable`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildBuyStableParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildBuyStableAutoResolve(connection, params) {
+    const curve = await fetchStableBondingCurve(connection, params.mint, params.quoteMint, params.config);
+    return buildBuyStable({ ...params, creator: curve.creator });
+}
+/**
+ * Builds a sellStable instruction.
+ * Sells tokens to a token-based bonding curve for quote tokens (e.g., USDC).
+ *
+ * @param params - {@link BuildSellStableParams}
+ * @returns Transaction instruction
+ */
+export function buildSellStable(params) {
+    const { user, mint, quoteMint, creator, amountIn, minAmountOut, feeRecipient, creatorReferralVault, traderReferralVault, config, } = params;
+    const program = getCachedLiquidProgram(config);
+    // Fee recipient quote token account
+    const feeRecipientQuoteAccount = getAssociatedTokenAddressSync(quoteMint, feeRecipient, true, TOKEN_PROGRAM_ID);
+    // Derive creator-related accounts that Anchor can't auto-resolve
+    const [creatorUserProperties] = getUserPropertiesPDA(creator, config.liquidStateProgramId);
+    return program.methods
+        .sellStable(amountIn, minAmountOut)
+        .accountsPartial({
+        user,
+        mint,
+        quoteMint,
+        feeRecipient: feeRecipientQuoteAccount,
+        creatorUserProperties,
+        creatorReferralVault: creatorReferralVault ?? null,
+        traderReferralVault: traderReferralVault ?? null,
+        liquidState: {
+            user,
+            tokenMint: mint,
+        },
+    })
+        .instruction();
+}
+/**
+ * Builds a sellStable instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildSellStable`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildSellStableParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildSellStableAutoResolve(connection, params) {
+    const curve = await fetchStableBondingCurve(connection, params.mint, params.quoteMint, params.config);
+    return buildSellStable({ ...params, creator: curve.creator });
+}
+/**
+ * Builds a migrateStable instruction (token bonding curve -> AMM pool).
+ * Permissionless — anyone can trigger migration once the curve is complete.
+ *
+ * @param params - {@link BuildMigrateStableParams}
+ * @returns Transaction instruction
+ */
+export function buildMigrateStable(params) {
+    const { migrator, mint, quoteMint, config } = params;
+    const program = getCachedLiquidProgram(config);
+    // Derive AMM PDAs
+    const [bondingCurve] = getStableBondingCurvePDA(mint, quoteMint, config.liquidProgramId);
+    const [ammPoolState] = getPoolPDA(mint, quoteMint, config.liquidSwapProgramId);
+    const [ammLpMint] = getPoolLpMintPDA(ammPoolState, config.liquidSwapProgramId);
+    const [ammBaseVault] = getPoolVaultPDA(ammPoolState, mint, config.liquidSwapProgramId);
+    const [ammQuoteVault] = getPoolVaultPDA(ammPoolState, quoteMint, config.liquidSwapProgramId);
+    const [ammObservationState] = getObservationPDA(ammPoolState, config.liquidSwapProgramId);
+    const [ammGlobalConfig] = getSwapGlobalConfigPDA(config.liquidSwapProgramId);
+    const [ammAuthority] = getSwapAuthorityPDA(config.liquidSwapProgramId);
+    const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
+    const bondingCurveLpToken = getAssociatedTokenAddressSync(ammLpMint, bondingCurve, true, TOKEN_PROGRAM_ID);
+    const [ammBuybackVault] = getSwapBuybackVaultPDA(ammPoolState, quoteMint, config.liquidSwapProgramId);
+    return program.methods
+        .migrateStable()
+        .accounts({
+        signer: migrator,
+        mint,
+        quoteMint,
+        ammPoolState,
+        ammLpMint,
+        ammBaseVault,
+        ammQuoteVault,
+        ammObservationState,
+        ammGlobalConfig,
+        ammAuthority,
+        bondingCurveLpToken,
+        tokenVolume,
+        ammBuybackVault,
+    })
+        .instruction();
+}
+/**
+ * Builds a setFeeRecipients instruction.
+ * Admin-only instruction to set/update the protocol fee recipients.
+ *
+ * @param params - {@link BuildSetFeeRecipientsParams}
+ * @returns Transaction instruction
+ */
+export function buildSetFeeRecipients(params) {
+    const { admin, feeRecipients, config } = params;
+    if (feeRecipients.length !== 8) {
+        throw new Error("feeRecipients must have exactly 8 elements");
+    }
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .setFeeRecipients(feeRecipients)
+        .accounts({
+        admin,
+        feeRecipient1: feeRecipients[0],
+        feeRecipient2: feeRecipients[1],
+        feeRecipient3: feeRecipients[2],
+        feeRecipient4: feeRecipients[3],
+        feeRecipient5: feeRecipients[4],
+        feeRecipient6: feeRecipients[5],
+        feeRecipient7: feeRecipients[6],
+        feeRecipient8: feeRecipients[7],
+    })
+        .instruction();
+}
+/**
+ * Builds an initializeFeeRecipientVaults instruction.
+ * Permissionless instruction to create token accounts for all fee recipients
+ * for a given quote mint. Call this before trading stable curves.
+ *
+ * @param params - {@link BuildInitializeFeeRecipientVaultsParams}
+ * @returns Transaction instruction
+ */
+export function buildInitializeFeeRecipientVaults(params) {
+    const { payer, quoteMint, feeRecipients, config } = params;
+    if (feeRecipients.length !== 8) {
+        throw new Error("feeRecipients must have exactly 8 elements");
+    }
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .initializeFeeRecipientVaults()
+        .accounts({
+        payer,
+        quoteMint,
+        feeRecipient1: feeRecipients[0],
+        feeRecipient2: feeRecipients[1],
+        feeRecipient3: feeRecipients[2],
+        feeRecipient4: feeRecipients[3],
+        feeRecipient5: feeRecipients[4],
+        feeRecipient6: feeRecipients[5],
+        feeRecipient7: feeRecipients[6],
+        feeRecipient8: feeRecipients[7],
+    })
+        .instruction();
+}
+/**
+ * Builds an initializeReferralTokenVault instruction.
+ * Creates a referral token vault (ATA) for the user for a specific quote mint.
+ * Users must call this for each quote mint they want to receive referral rewards for.
+ * If not initialized, referral fees will be redirected to protocol fees.
+ *
+ * @param params - {@link BuildInitializeReferralTokenVaultParams}
+ * @returns Transaction instruction
+ */
+export function buildInitializeReferralTokenVault(params) {
+    const { user, quoteMint, config } = params;
+    const program = getCachedLiquidProgram(config);
+    return program.methods
+        .initializeReferralTokenVault()
+        .accounts({
+        user,
+        quoteMint,
+    })
+        .instruction();
+}
+//# sourceMappingURL=liquid.js.map

package/dist/instructions/liquid.js.map

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

package/dist/instructions/program-cache.d.ts

@@ -0,0 +1,35 @@
+import { Program } from "@coral-xyz/anchor";
+import type { LiquidConfig } from "../config.js";
+import type { Liquid } from "../idl/liquid.js";
+import type { LiquidSwap } from "../idl/liquid_swap.js";
+import type { LiquidFees } from "../idl/liquid_fees.js";
+import type { LiquidState } from "../idl/liquid_state.js";
+/**
+ * Returns a cached Liquid bonding curve program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as Liquid
+ */
+export declare function getCachedLiquidProgram(config: LiquidConfig): Program<Liquid>;
+/**
+ * Returns a cached Liquid Swap AMM program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as LiquidSwap
+ */
+export declare function getCachedSwapProgram(config: LiquidConfig): Program<LiquidSwap>;
+/**
+ * Returns a cached Liquid Fees program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as LiquidFees
+ */
+export declare function getCachedFeesProgram(config: LiquidConfig): Program<LiquidFees>;
+/**
+ * Returns a cached Liquid State program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as LiquidState
+ */
+export declare function getCachedStateProgram(config: LiquidConfig): Program<LiquidState>;
+//# sourceMappingURL=program-cache.d.ts.map

package/dist/instructions/program-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-cache.d.ts","sourceRoot":"","sources":["../../src/instructions/program-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAiC1D;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,WAAW,CAAC,CAMtB"}

package/dist/instructions/program-cache.js

@@ -0,0 +1,68 @@
+import { Program } from "@coral-xyz/anchor";
+import { createStubProvider } from "../provider.js";
+import liquidIdl from "../idl/liquid.json" with { type: "json" };
+import liquidSwapIdl from "../idl/liquid_swap.json" with { type: "json" };
+import liquidFeesIdl from "../idl/liquid_fees.json" with { type: "json" };
+import liquidStateIdl from "../idl/liquid_state.json" with { type: "json" };
+/**
+ * Cached stub Program instances for instruction building.
+ * Instruction building via `.instruction()` never hits the network,
+ * so these programs use a shared stub provider with no real Connection.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const cache = new Map();
+/**
+ * Returns a cached Program instance or creates one if it doesn't exist.
+ *
+ * @param key - Cache key prefix (e.g., "liquid", "swap")
+ * @param idl - Raw IDL JSON object
+ * @param address - Program address as a base58 string
+ * @returns Cached or newly created Program instance
+ */
+function getOrCreate(key, idl, address) {
+    const cacheKey = `${key}:${address}`;
+    let prog = cache.get(cacheKey);
+    if (!prog) {
+        const patchedIdl = { ...idl, address };
+        prog = new Program(patchedIdl, createStubProvider());
+        cache.set(cacheKey, prog);
+    }
+    return prog;
+}
+/**
+ * Returns a cached Liquid bonding curve program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as Liquid
+ */
+export function getCachedLiquidProgram(config) {
+    return getOrCreate("liquid", liquidIdl, config.liquidProgramId.toBase58());
+}
+/**
+ * Returns a cached Liquid Swap AMM program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as LiquidSwap
+ */
+export function getCachedSwapProgram(config) {
+    return getOrCreate("swap", liquidSwapIdl, config.liquidSwapProgramId.toBase58());
+}
+/**
+ * Returns a cached Liquid Fees program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as LiquidFees
+ */
+export function getCachedFeesProgram(config) {
+    return getOrCreate("fees", liquidFeesIdl, config.liquidFeesProgramId.toBase58());
+}
+/**
+ * Returns a cached Liquid State program instance for instruction building.
+ *
+ * @param config - Liquid protocol configuration
+ * @returns Cached Program instance typed as LiquidState
+ */
+export function getCachedStateProgram(config) {
+    return getOrCreate("state", liquidStateIdl, config.liquidStateProgramId.toBase58());
+}
+//# sourceMappingURL=program-cache.js.map

package/dist/instructions/program-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-cache.js","sourceRoot":"","sources":["../../src/instructions/program-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,SAAS,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjE,OAAO,aAAa,MAAM,yBAAyB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1E,OAAO,aAAa,MAAM,yBAAyB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1E,OAAO,cAAc,MAAM,0BAA0B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAO5E;;;;GAIG;AACH,8DAA8D;AAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;AAE9C;;;;;;;GAOG;AACH,SAAS,WAAW,CACnB,GAAW,EACX,GAA4B,EAC5B,OAAe;IAEf,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IACrC,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAA2B,CAAC;IACzD,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,UAAU,GAAG,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,OAAO,CAAC,UAAe,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IAC1D,OAAO,WAAW,CACjB,QAAQ,EACR,SAAS,EACT,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,CACjC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CACnC,MAAoB;IAEpB,OAAO,WAAW,CACjB,MAAM,EACN,aAAa,EACb,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CACrC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CACnC,MAAoB;IAEpB,OAAO,WAAW,CACjB,MAAM,EACN,aAAa,EACb,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CACrC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACpC,MAAoB;IAEpB,OAAO,WAAW,CACjB,OAAO,EACP,cAAc,EACd,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CACtC,CAAC;AACH,CAAC"}

package/dist/math/amm.d.ts

@@ -0,0 +1,42 @@
+import BN from "bn.js";
+import type { AmmSellOutput, AmmBuyInput, LpTokenAmounts } from "../types.js";
+/** AMM fee rates in basis points */
+export interface AmmFeeRates {
+    lpFeeRate: number;
+    creatorFeeRate: number;
+    protocolFeeRate: number;
+}
+/**
+ * Calculates expected output for selling base tokens on the AMM.
+ * Uses constant product formula: quoteOut = (amountIn * quoteVault) / (baseVault + amountIn)
+ *
+ * @param amountIn - Base tokens to sell
+ * @param baseVault - Current base vault balance
+ * @param quoteVault - Current quote vault balance
+ * @param fees - Fee rates in basis points
+ * @returns Sell output with gross/net quote amounts and fee breakdown
+ */
+export declare const calculateAmmSellOutput: (amountIn: BN, baseVault: BN, quoteVault: BN, fees: AmmFeeRates) => AmmSellOutput;
+/**
+ * Calculates required quote input for buying base tokens on the AMM.
+ * Reverse calculation: how much quote is needed for the desired base output.
+ *
+ * @param amountOut - Base tokens to buy
+ * @param baseVault - Current base vault balance
+ * @param quoteVault - Current quote vault balance
+ * @param fees - Fee rates in basis points
+ * @returns Buy input with gross/net quote amounts and fee breakdown
+ */
+export declare const calculateAmmBuyInput: (amountOut: BN, baseVault: BN, quoteVault: BN, fees: AmmFeeRates) => AmmBuyInput;
+/**
+ * Converts LP tokens to the equivalent base and quote token amounts.
+ *
+ * @param lpAmount - LP tokens to convert
+ * @param lpSupply - Total LP supply
+ * @param baseVault - Base vault balance
+ * @param quoteVault - Quote vault balance
+ * @param roundUp - Use ceiling division (for deposits) vs floor division (for withdrawals)
+ * @returns Equivalent base and quote token amounts for the given LP tokens
+ */
+export declare const calculateLpToTokens: (lpAmount: BN, lpSupply: BN, baseVault: BN, quoteVault: BN, roundUp?: boolean) => LpTokenAmounts;
+//# sourceMappingURL=amm.d.ts.map

package/dist/math/amm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amm.d.ts","sourceRoot":"","sources":["../../src/math/amm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,GAClC,UAAU,EAAE,EACZ,WAAW,EAAE,EACb,YAAY,EAAE,EACd,MAAM,WAAW,KACf,aAwBF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,EAAE,EACb,WAAW,EAAE,EACb,YAAY,EAAE,EACd,MAAM,WAAW,KACf,WAqCF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAC/B,UAAU,EAAE,EACZ,UAAU,EAAE,EACZ,WAAW,EAAE,EACb,YAAY,EAAE,EACd,UAAS,OAAe,KACtB,cAuBF,CAAC"}