@liquid-af/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { LiquidClient } from "./client.js";
+export type { LiquidClientConfig } from "./client.js";
+export { ReadonlyWallet, createReadonlyProvider, createStubProvider, } from "./provider.js";
+export { LiquidError, LiquidErrorCode } from "./errors.js";
+export type { LiquidConfig } from "./config.js";
+export { MAINNET_CONFIG, DEVNET_CONFIG, LOCALNET_CONFIG, WSOL_MINT, BPS_DENOMINATOR, NUM_FEE_RECIPIENTS, MAX_FEE_RECIPIENTS_FEES, MAX_QUOTE_MINTS, MAX_CASHBACK_RANGES, MIN_MULTIPLIER_BPS, MAX_MULTIPLIER_BPS, MIN_VAULT_BALANCE, LIMITS, } from "./config.js";
+export type { GlobalConfiguration, BondingCurveState, AmmConfig, FeeTier, PoolState, Observation, ObservationState, UnifiedFeeConfiguration, UserProperties, ReferrerInfo, UserSnapshot, Deal, AdminUpdateUserArgs, TokenVolumeAccumulator, GlobalCurveVolume, GlobalAmmVolume, CashbackRange, CashbackConfiguration, FeeDistribution, BondingCurveBuyResult, BondingCurveSellResult, SwapFees, AmmSellOutput, AmmBuyInput, LpTokenAmounts, DistributionResult, PoolInfo, BuyCurvePreview, SellCurvePreview, SwapPreview, FeeRecipient, FeeModeAnchor, CurveStatusAnchor, } from "./types.js";
+export { FeeMode, toAnchorFeeMode, feeModeEquals, CurveStatus, curveStatusEquals, } from "./types.js";
+export * from "./pda/index.js";
+export * from "./math/index.js";
+export * from "./accounts/index.js";
+export * from "./instructions/index.js";
+export * from "./helpers/index.js";
+export * from "./events/index.js";
+export * from "./transaction/index.js";
+export * from "./oracle.js";
+export type { Liquid, LiquidSwap, LiquidFees, LiquidState } from "./idl/index.js";
+export { getLiquidProgram, getLiquidSwapProgram, getLiquidFeesProgram, getLiquidStateProgram, liquidIdl, liquidSwapIdl, liquidFeesIdl, liquidStateIdl, } from "./idl/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EACN,cAAc,EACd,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE3D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACN,cAAc,EACd,aAAa,EACb,eAAe,EACf,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,GACN,MAAM,aAAa,CAAC;AAErB,YAAY,EACX,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,IAAI,EACJ,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,QAAQ,EACR,aAAa,EACb,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,iBAAiB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,OAAO,EACP,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAEpB,cAAc,gBAAgB,CAAC;AAE/B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,yBAAyB,CAAC;AAExC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,mBAAmB,CAAC;AAElC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,aAAa,CAAC;AAE5B,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,GACd,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { LiquidClient } from "./client.js";
+export { ReadonlyWallet, createReadonlyProvider, createStubProvider, } from "./provider.js";
+export { LiquidError, LiquidErrorCode } from "./errors.js";
+export { MAINNET_CONFIG, DEVNET_CONFIG, LOCALNET_CONFIG, WSOL_MINT, BPS_DENOMINATOR, NUM_FEE_RECIPIENTS, MAX_FEE_RECIPIENTS_FEES, MAX_QUOTE_MINTS, MAX_CASHBACK_RANGES, MIN_MULTIPLIER_BPS, MAX_MULTIPLIER_BPS, MIN_VAULT_BALANCE, LIMITS, } from "./config.js";
+export { FeeMode, toAnchorFeeMode, feeModeEquals, CurveStatus, curveStatusEquals, } from "./types.js";
+export * from "./pda/index.js";
+export * from "./math/index.js";
+export * from "./accounts/index.js";
+export * from "./instructions/index.js";
+export * from "./helpers/index.js";
+export * from "./events/index.js";
+export * from "./transaction/index.js";
+export * from "./oracle.js";
+export { getLiquidProgram, getLiquidSwapProgram, getLiquidFeesProgram, getLiquidStateProgram, liquidIdl, liquidSwapIdl, liquidFeesIdl, liquidStateIdl, } from "./idl/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACN,cAAc,EACd,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EACN,cAAc,EACd,aAAa,EACb,eAAe,EACf,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,GACN,MAAM,aAAa,CAAC;AAqCrB,OAAO,EACN,OAAO,EACP,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAEpB,cAAc,gBAAgB,CAAC;AAE/B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,yBAAyB,CAAC;AAExC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,mBAAmB,CAAC;AAElC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,aAAa,CAAC;AAG5B,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,GACd,MAAM,gBAAgB,CAAC"}

package/dist/instructions/index.d.ts

@@ -0,0 +1,9 @@
+export { buildCreateNativeCurve, buildBumpNative, buildBuyNative, buildBuyNativeAutoResolve, buildSellNative, buildSellNativeAutoResolve, buildMigrateNative, buildInitializeNativeReferralVault, buildWithdrawReferralRewards, buildExecuteBuybackNative, buildExecuteBuybackToken, buildCreateStableCurve, buildBuyStable, buildBuyStableAutoResolve, buildSellStable, buildSellStableAutoResolve, buildMigrateStable, buildSetFeeRecipients, buildInitializeFeeRecipientVaults, buildInitializeReferralTokenVault, } from "./liquid.js";
+export type { BuildCreateNativeCurveParams, BuildBumpNativeParams, BuildBuyNativeParams, BuildSellNativeParams, BuildMigrateNativeParams, BuildInitializeNativeReferralVaultParams, BuildWithdrawReferralRewardsParams, BuildExecuteBuybackNativeParams, BuildExecuteBuybackTokenParams, BuildCreateStableCurveParams, BuildBuyStableParams, BuildSellStableParams, BuildMigrateStableParams, BuildSetFeeRecipientsParams, BuildInitializeFeeRecipientVaultsParams, BuildInitializeReferralTokenVaultParams, } from "./liquid.js";
+export { buildCreatePool, buildSwapBuy, buildSwapSell, buildDeposit, buildWithdraw, buildSwapExecuteBuyback, } from "./liquid-swap.js";
+export type { BuildCreatePoolParams, BuildSwapBuyParams, BuildSwapSellParams, BuildDepositParams, BuildWithdrawParams, BuildSwapExecuteBuybackParams, } from "./liquid-swap.js";
+export { buildUpdateFeeConfig, buildRevokeFeeConfig, buildDistributeFees, buildDistributeTokenFees, buildClaimFees, buildClaimTokenFees, deriveRecipientVaultPairs, } from "./liquid-fees.js";
+export type { BuildUpdateFeeConfigParams, BuildRevokeFeeConfigParams, BuildDistributeFeesParams, BuildDistributeTokenFeesParams, BuildClaimFeesParams, BuildClaimTokenFeesParams, RecipientVaultPair, } from "./liquid-fees.js";
+export { buildInitializeUser, buildSetReferrer, buildSetCashbackMode, buildTransferAdmin, buildAcceptAdmin, buildCancelAdminTransfer, buildCreateDeal, buildUpdateDeal, buildCloseDeal, buildRedeemDeal, buildTakeSnapshot, buildAdminUpdateUser, } from "./liquid-state.js";
+export type { BuildInitializeUserParams, BuildSetReferrerParams, BuildSetCashbackModeParams, BuildTransferAdminParams, BuildAcceptAdminParams, BuildCancelAdminTransferParams, BuildCreateDealParams, BuildUpdateDealParams, BuildCloseDealParams, BuildRedeemDealParams, BuildTakeSnapshotParams, BuildAdminUpdateUserParams, } from "./liquid-state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/instructions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instructions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,kCAAkC,EAClC,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EAExB,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAElB,qBAAqB,EACrB,iCAAiC,EACjC,iCAAiC,GACjC,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,4BAA4B,EAC5B,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,wCAAwC,EACxC,kCAAkC,EAClC,+BAA+B,EAC/B,8BAA8B,EAE9B,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EAExB,2BAA2B,EAC3B,uCAAuC,EACvC,uCAAuC,GACvC,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,6BAA6B,GAC7B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,8BAA8B,EAC9B,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,8BAA8B,EAC9B,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/instructions/index.js

@@ -0,0 +1,9 @@
+export { buildCreateNativeCurve, buildBumpNative, buildBuyNative, buildBuyNativeAutoResolve, buildSellNative, buildSellNativeAutoResolve, buildMigrateNative, buildInitializeNativeReferralVault, buildWithdrawReferralRewards, buildExecuteBuybackNative, buildExecuteBuybackToken, 
+// Stable curve builders
+buildCreateStableCurve, buildBuyStable, buildBuyStableAutoResolve, buildSellStable, buildSellStableAutoResolve, buildMigrateStable, 
+// Admin builders
+buildSetFeeRecipients, buildInitializeFeeRecipientVaults, buildInitializeReferralTokenVault, } from "./liquid.js";
+export { buildCreatePool, buildSwapBuy, buildSwapSell, buildDeposit, buildWithdraw, buildSwapExecuteBuyback, } from "./liquid-swap.js";
+export { buildUpdateFeeConfig, buildRevokeFeeConfig, buildDistributeFees, buildDistributeTokenFees, buildClaimFees, buildClaimTokenFees, deriveRecipientVaultPairs, } from "./liquid-fees.js";
+export { buildInitializeUser, buildSetReferrer, buildSetCashbackMode, buildTransferAdmin, buildAcceptAdmin, buildCancelAdminTransfer, buildCreateDeal, buildUpdateDeal, buildCloseDeal, buildRedeemDeal, buildTakeSnapshot, buildAdminUpdateUser, } from "./liquid-state.js";
+//# sourceMappingURL=index.js.map

package/dist/instructions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instructions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,kCAAkC,EAClC,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB;AACxB,wBAAwB;AACxB,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,eAAe,EACf,0BAA0B,EAC1B,kBAAkB;AAClB,iBAAiB;AACjB,qBAAqB,EACrB,iCAAiC,EACjC,iCAAiC,GACjC,MAAM,aAAa,CAAC;AAsBrB,OAAO,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAU1B,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GACzB,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/instructions/liquid-fees.d.ts

@@ -0,0 +1,111 @@
+import type { PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type { LiquidConfig } from "../config.js";
+import type { FeeRecipient } from "../types.js";
+export interface BuildUpdateFeeConfigParams {
+    authority: PublicKey;
+    tokenMint: PublicKey;
+    recipients?: FeeRecipient[] | null;
+    newUpdateAuthority?: PublicKey | null;
+    /** Required when changing recipients to verify token fee vault is drained. */
+    quoteMint?: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds an updateFeeConfig instruction.
+ * Cannot change to Revoked mode (use revokeFeeConfig instead).
+ *
+ * @param params - {@link BuildUpdateFeeConfigParams}
+ * @returns Transaction instruction
+ */
+export declare function buildUpdateFeeConfig(params: BuildUpdateFeeConfigParams): Promise<TransactionInstruction>;
+export interface BuildRevokeFeeConfigParams {
+    authority: PublicKey;
+    tokenMint: PublicKey;
+    /** Quote mint for token fee vault ATA derivation. */
+    quoteMint: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a revokeFeeConfig instruction.
+ * Permanently sets fee mode to Revoked (buyback-and-burn). Irreversible.
+ *
+ * @param params - {@link BuildRevokeFeeConfigParams}
+ * @returns Transaction instruction
+ */
+export declare function buildRevokeFeeConfig(params: BuildRevokeFeeConfigParams): Promise<TransactionInstruction>;
+export interface BuildDistributeFeesParams {
+    payer: PublicKey;
+    tokenMint: PublicKey;
+    recipientVaults: PublicKey[];
+    config: LiquidConfig;
+}
+/**
+ * Builds a distributeFees instruction.
+ * Permissionless — anyone can trigger fee distribution for Recipients tokens.
+ * Recipient vaults must be recipient vault PDAs (derived via getRecipientVaultPDA),
+ * passed in the same order as fee_config.recipients.
+ *
+ * @param params - {@link BuildDistributeFeesParams}
+ * @returns Transaction instruction
+ */
+export declare function buildDistributeFees(params: BuildDistributeFeesParams): Promise<TransactionInstruction>;
+export interface RecipientVaultPair {
+    vaultPda: PublicKey;
+    vaultAta: PublicKey;
+}
+export interface BuildDistributeTokenFeesParams {
+    payer: PublicKey;
+    tokenMint: PublicKey;
+    quoteMint: PublicKey;
+    recipientVaultPairs: RecipientVaultPair[];
+    config: LiquidConfig;
+}
+/**
+ * Builds a distributeTokenFees instruction.
+ * Permissionless — anyone can trigger token fee distribution for Recipients tokens.
+ * Remaining accounts must be pairs of (recipient_vault_pda, recipient_vault_token_account)
+ * in the same order as fee_config.recipients.
+ *
+ * @param params - {@link BuildDistributeTokenFeesParams}
+ * @returns Transaction instruction
+ */
+export declare function buildDistributeTokenFees(params: BuildDistributeTokenFeesParams): Promise<TransactionInstruction>;
+export interface BuildClaimFeesParams {
+    recipient: PublicKey;
+    tokenMint: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a claimFees instruction.
+ * Allows a recipient to claim accumulated SOL fees from their vault PDA.
+ *
+ * @param params - {@link BuildClaimFeesParams}
+ * @returns Transaction instruction
+ */
+export declare function buildClaimFees(params: BuildClaimFeesParams): Promise<TransactionInstruction>;
+export interface BuildClaimTokenFeesParams {
+    recipient: PublicKey;
+    tokenMint: PublicKey;
+    quoteMint: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a claimTokenFees instruction.
+ * Allows a recipient to claim accumulated token fees from their vault ATA.
+ * Closes the vault ATA after claiming to reclaim rent.
+ *
+ * @param params - {@link BuildClaimTokenFeesParams}
+ * @returns Transaction instruction
+ */
+export declare function buildClaimTokenFees(params: BuildClaimTokenFeesParams): Promise<TransactionInstruction>;
+/**
+ * Helper: derives recipient vault PDA pairs for use with buildDistributeTokenFees.
+ *
+ * @param tokenMint - Token mint address
+ * @param recipients - Array of recipient public keys in fee_config order
+ * @param quoteMint - Quote mint for ATA derivation
+ * @param config - Liquid protocol config
+ * @returns Array of RecipientVaultPair for remaining accounts
+ */
+export declare function deriveRecipientVaultPairs(tokenMint: PublicKey, recipients: PublicKey[], quoteMint: PublicKey, config: LiquidConfig): RecipientVaultPair[];
+//# sourceMappingURL=liquid-fees.d.ts.map

package/dist/instructions/liquid-fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-fees.d.ts","sourceRoot":"","sources":["../../src/instructions/liquid-fees.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,MAAM,WAAW,0BAA0B;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACnC,kBAAkB,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,0BAA0B,GAChC,OAAO,CAAC,sBAAsB,CAAC,CA2CjC;AAED,MAAM,WAAW,0BAA0B;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,0BAA0B,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAqBjC;AAED,MAAM,WAAW,yBAAyB;IACzC,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,yBAAyB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC9C,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,8BAA8B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAmBjC;AAED,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAYjC;AAED,MAAM,WAAW,yBAAyB;IACzC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,yBAAyB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAajC;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,SAAS,EAAE,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,YAAY,GAClB,kBAAkB,EAAE,CAetB"}

package/dist/instructions/liquid-fees.js

@@ -0,0 +1,169 @@
+import { getAssociatedTokenAddressSync } from "@solana/spl-token";
+import { getCachedFeesProgram } from "./program-cache.js";
+import { getFeeConfigPDA, getFeeVaultPDA, getRecipientVaultPDA, } from "../pda/liquid-fees.js";
+/**
+ * Builds an updateFeeConfig instruction.
+ * Cannot change to Revoked mode (use revokeFeeConfig instead).
+ *
+ * @param params - {@link BuildUpdateFeeConfigParams}
+ * @returns Transaction instruction
+ */
+export function buildUpdateFeeConfig(params) {
+    const { authority, tokenMint, recipients, newUpdateAuthority, quoteMint, config, } = params;
+    const program = getCachedFeesProgram(config);
+    const formattedRecipients = recipients?.map((r) => ({
+        pubkey: r.pubkey,
+        basisPoints: r.basisPoints,
+    })) ?? null;
+    // When changing recipients, the token fee vault must be passed to verify it's drained
+    let tokenFeeVault = null;
+    if (recipients && quoteMint) {
+        const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+        const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
+        tokenFeeVault = getAssociatedTokenAddressSync(quoteMint, feeVault, true);
+    }
+    return program.methods
+        .updateFeeConfig({
+        recipients: formattedRecipients,
+        newUpdateAuthority: newUpdateAuthority ?? null,
+    })
+        .accounts({
+        authority,
+        tokenMint,
+        tokenFeeVault
+    })
+        .instruction();
+}
+/**
+ * Builds a revokeFeeConfig instruction.
+ * Permanently sets fee mode to Revoked (buyback-and-burn). Irreversible.
+ *
+ * @param params - {@link BuildRevokeFeeConfigParams}
+ * @returns Transaction instruction
+ */
+export function buildRevokeFeeConfig(params) {
+    const { authority, tokenMint, quoteMint, config } = params;
+    const program = getCachedFeesProgram(config);
+    // Derive token fee vault ATA (fee_vault's ATA for quote_mint)
+    const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+    const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
+    const tokenFeeVault = getAssociatedTokenAddressSync(quoteMint, feeVault, true);
+    return program.methods
+        .revokeFeeConfig()
+        .accounts({
+        authority,
+        tokenMint,
+        tokenFeeVault,
+    })
+        .instruction();
+}
+/**
+ * Builds a distributeFees instruction.
+ * Permissionless — anyone can trigger fee distribution for Recipients tokens.
+ * Recipient vaults must be recipient vault PDAs (derived via getRecipientVaultPDA),
+ * passed in the same order as fee_config.recipients.
+ *
+ * @param params - {@link BuildDistributeFeesParams}
+ * @returns Transaction instruction
+ */
+export function buildDistributeFees(params) {
+    const { payer, tokenMint, recipientVaults, config } = params;
+    const program = getCachedFeesProgram(config);
+    return program.methods
+        .distributeFees()
+        .accounts({
+        payer,
+        tokenMint,
+    })
+        .remainingAccounts(recipientVaults.map((vault) => ({
+        pubkey: vault,
+        isSigner: false,
+        isWritable: true,
+    })))
+        .instruction();
+}
+/**
+ * Builds a distributeTokenFees instruction.
+ * Permissionless — anyone can trigger token fee distribution for Recipients tokens.
+ * Remaining accounts must be pairs of (recipient_vault_pda, recipient_vault_token_account)
+ * in the same order as fee_config.recipients.
+ *
+ * @param params - {@link BuildDistributeTokenFeesParams}
+ * @returns Transaction instruction
+ */
+export function buildDistributeTokenFees(params) {
+    const { payer, tokenMint, quoteMint, recipientVaultPairs, config } = params;
+    const program = getCachedFeesProgram(config);
+    // Flatten pairs into interleaved remaining accounts: [pda1, ata1, pda2, ata2, ...]
+    const remainingAccounts = recipientVaultPairs.flatMap((pair) => [
+        { pubkey: pair.vaultPda, isSigner: false, isWritable: false },
+        { pubkey: pair.vaultAta, isSigner: false, isWritable: true },
+    ]);
+    return program.methods
+        .distributeTokenFees()
+        .accountsPartial({
+        payer,
+        tokenMint,
+        quoteMint
+    })
+        .remainingAccounts(remainingAccounts)
+        .instruction();
+}
+/**
+ * Builds a claimFees instruction.
+ * Allows a recipient to claim accumulated SOL fees from their vault PDA.
+ *
+ * @param params - {@link BuildClaimFeesParams}
+ * @returns Transaction instruction
+ */
+export function buildClaimFees(params) {
+    const { recipient, tokenMint, config } = params;
+    const program = getCachedFeesProgram(config);
+    const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+    return program.methods
+        .claimFees()
+        .accounts({
+        recipient,
+        feeConfig,
+    })
+        .instruction();
+}
+/**
+ * Builds a claimTokenFees instruction.
+ * Allows a recipient to claim accumulated token fees from their vault ATA.
+ * Closes the vault ATA after claiming to reclaim rent.
+ *
+ * @param params - {@link BuildClaimTokenFeesParams}
+ * @returns Transaction instruction
+ */
+export function buildClaimTokenFees(params) {
+    const { recipient, tokenMint, quoteMint, config } = params;
+    const program = getCachedFeesProgram(config);
+    const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+    return program.methods
+        .claimTokenFees()
+        .accounts({
+        recipient,
+        feeConfig,
+        quoteMint,
+    })
+        .instruction();
+}
+/**
+ * Helper: derives recipient vault PDA pairs for use with buildDistributeTokenFees.
+ *
+ * @param tokenMint - Token mint address
+ * @param recipients - Array of recipient public keys in fee_config order
+ * @param quoteMint - Quote mint for ATA derivation
+ * @param config - Liquid protocol config
+ * @returns Array of RecipientVaultPair for remaining accounts
+ */
+export function deriveRecipientVaultPairs(tokenMint, recipients, quoteMint, config) {
+    const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+    return recipients.map((recipient) => {
+        const [vaultPda] = getRecipientVaultPDA(feeConfig, recipient, config.liquidFeesProgramId);
+        const vaultAta = getAssociatedTokenAddressSync(quoteMint, vaultPda, true);
+        return { vaultPda, vaultAta };
+    });
+}
+//# sourceMappingURL=liquid-fees.js.map

package/dist/instructions/liquid-fees.js.map

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

package/dist/instructions/liquid-state.d.ts

@@ -0,0 +1,173 @@
+import type { PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type { LiquidConfig } from "../config.js";
+export interface BuildInitializeUserParams {
+    user: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds an initializeUser instruction.
+ * Creates the user properties account in liquid-state.
+ *
+ * @param params - {@link BuildInitializeUserParams}
+ * @returns Transaction instruction
+ */
+export declare function buildInitializeUser(params: BuildInitializeUserParams): Promise<TransactionInstruction>;
+export interface BuildSetReferrerParams {
+    user: PublicKey;
+    referrer: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a setReferrer instruction.
+ * One-time operation — referrer cannot be changed once set.
+ *
+ * @param params - {@link BuildSetReferrerParams}
+ * @returns Transaction instruction
+ */
+export declare function buildSetReferrer(params: BuildSetReferrerParams): Promise<TransactionInstruction>;
+export interface BuildSetCashbackModeParams {
+    user: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a setCashbackMode instruction.
+ * Toggles user between earning mode (earn credits) and spending mode (spend credits).
+ *
+ * @param params - {@link BuildSetCashbackModeParams}
+ * @returns Transaction instruction
+ */
+export declare function buildSetCashbackMode(params: BuildSetCashbackModeParams): Promise<TransactionInstruction>;
+export interface BuildTransferAdminParams {
+    admin: PublicKey;
+    newAdmin: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a transferAdmin instruction.
+ * Proposes transfer of admin authority to a new pubkey (two-step).
+ * The new admin must call {@link buildAcceptAdmin} to complete the transfer.
+ *
+ * @param params - {@link BuildTransferAdminParams}
+ * @returns Transaction instruction
+ */
+export declare function buildTransferAdmin(params: BuildTransferAdminParams): Promise<TransactionInstruction>;
+export interface BuildAcceptAdminParams {
+    newAdmin: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds an acceptAdmin instruction.
+ * Completes a pending admin transfer. Must be called by the pending admin.
+ *
+ * @param params - {@link BuildAcceptAdminParams}
+ * @returns Transaction instruction
+ */
+export declare function buildAcceptAdmin(params: BuildAcceptAdminParams): Promise<TransactionInstruction>;
+export interface BuildCancelAdminTransferParams {
+    authority: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a cancelAdminTransfer instruction.
+ * Cancels a pending admin transfer. Callable by either the current admin or the pending admin.
+ *
+ * @param params - {@link BuildCancelAdminTransferParams}
+ * @returns Transaction instruction
+ */
+export declare function buildCancelAdminTransfer(params: BuildCancelAdminTransferParams): Promise<TransactionInstruction>;
+export interface BuildCreateDealParams {
+    admin: PublicKey;
+    owner: PublicKey;
+    cashbackMultiplierBps: number;
+    payer: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a createDeal instruction.
+ * Admin creates an exclusive deal for a pubkey (typically a referrer/influencer).
+ *
+ * @param params - {@link BuildCreateDealParams}
+ * @returns Transaction instruction
+ */
+export declare function buildCreateDeal(params: BuildCreateDealParams): Promise<TransactionInstruction>;
+export interface BuildUpdateDealParams {
+    admin: PublicKey;
+    dealOwner: PublicKey;
+    newCashbackMultiplierBps: number;
+    config: LiquidConfig;
+}
+/**
+ * Builds an updateDeal instruction.
+ * Admin updates a deal's cashback multiplier.
+ *
+ * @param params - {@link BuildUpdateDealParams}
+ * @returns Transaction instruction
+ */
+export declare function buildUpdateDeal(params: BuildUpdateDealParams): Promise<TransactionInstruction>;
+export interface BuildCloseDealParams {
+    admin: PublicKey;
+    dealOwner: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a closeDeal instruction.
+ * Admin closes/deletes a deal, returning rent to admin.
+ *
+ * @param params - {@link BuildCloseDealParams}
+ * @returns Transaction instruction
+ */
+export declare function buildCloseDeal(params: BuildCloseDealParams): Promise<TransactionInstruction>;
+export interface BuildRedeemDealParams {
+    user: PublicKey;
+    dealOwner: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a redeemDeal instruction.
+ * User redeems their referrer's deal, copying the multiplier.
+ *
+ * @param params - {@link BuildRedeemDealParams}
+ * @returns Transaction instruction
+ */
+export declare function buildRedeemDeal(params: BuildRedeemDealParams): Promise<TransactionInstruction>;
+export interface BuildTakeSnapshotParams {
+    admin: PublicKey;
+    user: PublicKey;
+    payer: PublicKey;
+    snapshotIndex: number;
+    config: LiquidConfig;
+}
+/**
+ * Builds a takeSnapshot instruction.
+ * Admin takes a snapshot of a user's volume since last snapshot.
+ *
+ * The caller must provide the current `snapshotIndex` (from `user_properties.snapshot_count`)
+ * because the snapshot PDA seed depends on this value and cannot be resolved without a
+ * network fetch.
+ *
+ * @param params - {@link BuildTakeSnapshotParams}
+ * @returns Transaction instruction
+ */
+export declare function buildTakeSnapshot(params: BuildTakeSnapshotParams): Promise<TransactionInstruction>;
+export interface BuildAdminUpdateUserParams {
+    admin: PublicKey;
+    user: PublicKey;
+    payer: PublicKey;
+    newReferrer: PublicKey | null;
+    newCashbackMultiplierBps: number | null;
+    snapshotIndex: number;
+    config: LiquidConfig;
+}
+/**
+ * Builds an adminUpdateUser instruction.
+ * Admin updates a user's referrer/multiplier and always takes a snapshot.
+ *
+ * The caller must provide the current `snapshotIndex` (from `user_properties.snapshot_count`)
+ * because the snapshot PDA seed depends on this value and cannot be resolved without a
+ * network fetch.
+ *
+ * @param params - {@link BuildAdminUpdateUserParams}
+ * @returns Transaction instruction
+ */
+export declare function buildAdminUpdateUser(params: BuildAdminUpdateUserParams): Promise<TransactionInstruction>;
+//# sourceMappingURL=liquid-state.d.ts.map

package/dist/instructions/liquid-state.d.ts.map

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