@liquid-af/sdk 0.1.0

package/dist/instructions/liquid-state.js

@@ -0,0 +1,194 @@
+import { getCachedStateProgram } from "./program-cache.js";
+import { getDealPDA, getUserSnapshotPDA } from "../pda/liquid-state.js";
+/**
+ * Builds an initializeUser instruction.
+ * Creates the user properties account in liquid-state.
+ *
+ * @param params - {@link BuildInitializeUserParams}
+ * @returns Transaction instruction
+ */
+export function buildInitializeUser(params) {
+    const { user, config } = params;
+    const program = getCachedStateProgram(config);
+    return program.methods.initializeUser().accounts({ user }).instruction();
+}
+/**
+ * Builds a setReferrer instruction.
+ * One-time operation — referrer cannot be changed once set.
+ *
+ * @param params - {@link BuildSetReferrerParams}
+ * @returns Transaction instruction
+ */
+export function buildSetReferrer(params) {
+    const { user, referrer, config } = params;
+    const program = getCachedStateProgram(config);
+    return program.methods
+        .setReferrer(referrer)
+        .accounts({ user })
+        .instruction();
+}
+/**
+ * Builds a setCashbackMode instruction.
+ * Toggles user between earning mode (earn credits) and spending mode (spend credits).
+ *
+ * @param params - {@link BuildSetCashbackModeParams}
+ * @returns Transaction instruction
+ */
+export function buildSetCashbackMode(params) {
+    const { user, config } = params;
+    const program = getCachedStateProgram(config);
+    return program.methods.setCashbackMode().accounts({ user }).instruction();
+}
+/**
+ * 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 function buildTransferAdmin(params) {
+    const { admin, newAdmin, config } = params;
+    const program = getCachedStateProgram(config);
+    return program.methods
+        .transferAdmin(newAdmin)
+        .accounts({ admin })
+        .instruction();
+}
+/**
+ * Builds an acceptAdmin instruction.
+ * Completes a pending admin transfer. Must be called by the pending admin.
+ *
+ * @param params - {@link BuildAcceptAdminParams}
+ * @returns Transaction instruction
+ */
+export function buildAcceptAdmin(params) {
+    const { newAdmin, config } = params;
+    const program = getCachedStateProgram(config);
+    return program.methods
+        .acceptAdmin()
+        .accounts({ newAdmin })
+        .instruction();
+}
+/**
+ * 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 function buildCancelAdminTransfer(params) {
+    const { authority, config } = params;
+    const program = getCachedStateProgram(config);
+    return program.methods
+        .cancelAdminTransfer()
+        .accounts({ authority })
+        .instruction();
+}
+/**
+ * Builds a createDeal instruction.
+ * Admin creates an exclusive deal for a pubkey (typically a referrer/influencer).
+ *
+ * @param params - {@link BuildCreateDealParams}
+ * @returns Transaction instruction
+ */
+export function buildCreateDeal(params) {
+    const { admin, owner, cashbackMultiplierBps, payer, config } = params;
+    const program = getCachedStateProgram(config);
+    return program.methods
+        .createDeal(owner, cashbackMultiplierBps)
+        .accounts({ admin, payer })
+        .instruction();
+}
+/**
+ * Builds an updateDeal instruction.
+ * Admin updates a deal's cashback multiplier.
+ *
+ * @param params - {@link BuildUpdateDealParams}
+ * @returns Transaction instruction
+ */
+export function buildUpdateDeal(params) {
+    const { admin, dealOwner, newCashbackMultiplierBps, config } = params;
+    const program = getCachedStateProgram(config);
+    const [deal] = getDealPDA(dealOwner, config.liquidStateProgramId);
+    return program.methods
+        .updateDeal(newCashbackMultiplierBps)
+        .accountsPartial({ admin, deal })
+        .instruction();
+}
+/**
+ * Builds a closeDeal instruction.
+ * Admin closes/deletes a deal, returning rent to admin.
+ *
+ * @param params - {@link BuildCloseDealParams}
+ * @returns Transaction instruction
+ */
+export function buildCloseDeal(params) {
+    const { admin, dealOwner, config } = params;
+    const program = getCachedStateProgram(config);
+    const [deal] = getDealPDA(dealOwner, config.liquidStateProgramId);
+    return program.methods
+        .closeDeal()
+        .accountsPartial({ admin, deal })
+        .instruction();
+}
+/**
+ * Builds a redeemDeal instruction.
+ * User redeems their referrer's deal, copying the multiplier.
+ *
+ * @param params - {@link BuildRedeemDealParams}
+ * @returns Transaction instruction
+ */
+export function buildRedeemDeal(params) {
+    const { user, dealOwner, config } = params;
+    const program = getCachedStateProgram(config);
+    const [deal] = getDealPDA(dealOwner, config.liquidStateProgramId);
+    return program.methods
+        .redeemDeal()
+        .accountsPartial({ user, deal })
+        .instruction();
+}
+/**
+ * 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 function buildTakeSnapshot(params) {
+    const { admin, user, payer, snapshotIndex, config } = params;
+    const program = getCachedStateProgram(config);
+    const [userSnapshot] = getUserSnapshotPDA(user, snapshotIndex, config.liquidStateProgramId);
+    return program.methods
+        .takeSnapshot()
+        .accountsPartial({ admin, user, payer, userSnapshot })
+        .instruction();
+}
+/**
+ * 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 function buildAdminUpdateUser(params) {
+    const { admin, user, payer, newReferrer, newCashbackMultiplierBps, snapshotIndex, config, } = params;
+    const program = getCachedStateProgram(config);
+    const [userSnapshot] = getUserSnapshotPDA(user, snapshotIndex, config.liquidStateProgramId);
+    return program.methods
+        .adminUpdateUser({
+        newReferrer: newReferrer ?? null,
+        newCashbackMultiplierBps: newCashbackMultiplierBps ?? null,
+    })
+        .accountsPartial({ admin, user, payer, userSnapshot })
+        .instruction();
+}
+//# sourceMappingURL=liquid-state.js.map

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

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

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

@@ -0,0 +1,122 @@
+import type { PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type BN from "bn.js";
+import type { LiquidConfig } from "../config.js";
+export interface BuildCreatePoolParams {
+    signer: PublicKey;
+    payer?: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseTokenProgram: PublicKey;
+    quoteTokenProgram: PublicKey;
+    initAmountBase: BN;
+    initAmountQuote: BN;
+    config: LiquidConfig;
+}
+/**
+ * Builds a create pool instruction.
+ *
+ * @param params - {@link BuildCreatePoolParams}
+ * @returns Transaction instruction
+ */
+export declare function buildCreatePool(params: BuildCreatePoolParams): Promise<TransactionInstruction>;
+export interface BuildSwapBuyParams {
+    payer: PublicKey;
+    creator: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseTokenProgram: PublicKey;
+    quoteTokenProgram: PublicKey;
+    maxAmountIn: BN;
+    amountOut: BN;
+    feeRecipient: PublicKey;
+    oraclePriceFeed?: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a buy swap instruction (quote -> base).
+ *
+ * @param params - {@link BuildSwapBuyParams}
+ * @returns Transaction instruction
+ */
+export declare function buildSwapBuy(params: BuildSwapBuyParams): Promise<TransactionInstruction>;
+export interface BuildSwapSellParams {
+    payer: PublicKey;
+    creator: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseTokenProgram: PublicKey;
+    quoteTokenProgram: PublicKey;
+    amountIn: BN;
+    minimumAmountOut: BN;
+    feeRecipient: PublicKey;
+    oraclePriceFeed?: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds a sell swap instruction (base -> quote).
+ *
+ * @param params - {@link BuildSwapSellParams}
+ * @returns Transaction instruction
+ */
+export declare function buildSwapSell(params: BuildSwapSellParams): Promise<TransactionInstruction>;
+export interface BuildDepositParams {
+    owner: PublicKey;
+    poolAddress: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseTokenProgram: PublicKey;
+    quoteTokenProgram: PublicKey;
+    baseVault: PublicKey;
+    quoteVault: PublicKey;
+    lpMint: PublicKey;
+    lpTokenAmount: BN;
+    maximumBaseAmount: BN;
+    maximumQuoteAmount: BN;
+    config: LiquidConfig;
+}
+/**
+ * Builds a deposit (add liquidity) instruction.
+ *
+ * @param params - {@link BuildDepositParams}
+ * @returns Transaction instruction
+ */
+export declare function buildDeposit(params: BuildDepositParams): Promise<TransactionInstruction>;
+export interface BuildWithdrawParams {
+    owner: PublicKey;
+    poolAddress: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseTokenProgram: PublicKey;
+    quoteTokenProgram: PublicKey;
+    baseVault: PublicKey;
+    quoteVault: PublicKey;
+    lpMint: PublicKey;
+    lpTokenAmount: BN;
+    minimumBaseAmount: BN;
+    minimumQuoteAmount: BN;
+    config: LiquidConfig;
+}
+/**
+ * Builds a withdraw (remove liquidity) instruction.
+ *
+ * @param params - {@link BuildWithdrawParams}
+ * @returns Transaction instruction
+ */
+export declare function buildWithdraw(params: BuildWithdrawParams): Promise<TransactionInstruction>;
+export interface BuildSwapExecuteBuybackParams {
+    payer: PublicKey;
+    baseMint: PublicKey;
+    quoteMint: PublicKey;
+    baseTokenProgram: PublicKey;
+    quoteTokenProgram: PublicKey;
+    config: LiquidConfig;
+}
+/**
+ * Builds an executeBuyback instruction for an AMM pool.
+ * Permissionless. Only works when fee config is Revoked.
+ *
+ * @param params - {@link BuildSwapExecuteBuybackParams}
+ * @returns Transaction instruction
+ */
+export declare function buildSwapExecuteBuyback(params: BuildSwapExecuteBuybackParams): Promise<TransactionInstruction>;
+//# sourceMappingURL=liquid-swap.d.ts.map

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

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

package/dist/instructions/liquid-swap.js

@@ -0,0 +1,167 @@
+import { getAssociatedTokenAddressSync, TOKEN_PROGRAM_ID, } from "@solana/spl-token";
+import { getCachedSwapProgram } from "./program-cache.js";
+/**
+ * Builds a create pool instruction.
+ *
+ * @param params - {@link BuildCreatePoolParams}
+ * @returns Transaction instruction
+ */
+export function buildCreatePool(params) {
+    const { signer, payer, baseMint, quoteMint, baseTokenProgram, quoteTokenProgram, initAmountBase, initAmountQuote, config, } = params;
+    const program = getCachedSwapProgram(config);
+    const creatorBase = getAssociatedTokenAddressSync(baseMint, signer, false, baseTokenProgram);
+    const creatorQuote = getAssociatedTokenAddressSync(quoteMint, signer, false, quoteTokenProgram);
+    return program.methods
+        .create(initAmountBase, initAmountQuote, null)
+        .accounts({
+        signer,
+        payer: payer ?? signer,
+        baseMint,
+        quoteMint,
+        creatorBase,
+        creatorQuote,
+        baseTokenProgram,
+        quoteTokenProgram,
+    })
+        .instruction();
+}
+/**
+ * Builds a buy swap instruction (quote -> base).
+ *
+ * @param params - {@link BuildSwapBuyParams}
+ * @returns Transaction instruction
+ */
+export function buildSwapBuy(params) {
+    const { payer, creator, baseMint, quoteMint, baseTokenProgram, quoteTokenProgram, maxAmountIn, amountOut, feeRecipient, oraclePriceFeed, config, } = params;
+    const program = getCachedSwapProgram(config);
+    const baseTokenAccount = getAssociatedTokenAddressSync(baseMint, payer, false, baseTokenProgram);
+    const quoteTokenAccount = getAssociatedTokenAddressSync(quoteMint, payer, false, quoteTokenProgram);
+    return program.methods
+        .buy(maxAmountIn, amountOut)
+        .accountsPartial({
+        payer,
+        creator,
+        baseTokenAccount,
+        quoteTokenAccount,
+        baseTokenProgram,
+        quoteTokenProgram,
+        baseMint,
+        quoteMint,
+        feeRecipient,
+        liquidState: {
+            user: payer,
+            tokenMint: baseMint,
+        },
+        ...(oraclePriceFeed ? { oraclePriceFeed } : {}),
+    })
+        .instruction();
+}
+/**
+ * Builds a sell swap instruction (base -> quote).
+ *
+ * @param params - {@link BuildSwapSellParams}
+ * @returns Transaction instruction
+ */
+export function buildSwapSell(params) {
+    const { payer, creator, baseMint, quoteMint, baseTokenProgram, quoteTokenProgram, amountIn, minimumAmountOut, feeRecipient, oraclePriceFeed, config, } = params;
+    const program = getCachedSwapProgram(config);
+    const baseTokenAccount = getAssociatedTokenAddressSync(baseMint, payer, false, baseTokenProgram);
+    const quoteTokenAccount = getAssociatedTokenAddressSync(quoteMint, payer, false, quoteTokenProgram);
+    return program.methods
+        .sell(amountIn, minimumAmountOut)
+        .accountsPartial({
+        payer,
+        creator,
+        baseTokenAccount,
+        quoteTokenAccount,
+        baseTokenProgram,
+        quoteTokenProgram,
+        baseMint,
+        quoteMint,
+        feeRecipient,
+        liquidState: {
+            user: payer,
+            tokenMint: baseMint,
+        },
+        ...(oraclePriceFeed ? { oraclePriceFeed } : {}),
+    })
+        .instruction();
+}
+/**
+ * Builds a deposit (add liquidity) instruction.
+ *
+ * @param params - {@link BuildDepositParams}
+ * @returns Transaction instruction
+ */
+export function buildDeposit(params) {
+    const { owner, poolAddress, baseMint, quoteMint, baseTokenProgram, quoteTokenProgram, baseVault, quoteVault, lpMint, lpTokenAmount, maximumBaseAmount, maximumQuoteAmount, config, } = params;
+    const program = getCachedSwapProgram(config);
+    const ownerLpToken = getAssociatedTokenAddressSync(lpMint, owner, false, TOKEN_PROGRAM_ID);
+    const baseAccount = getAssociatedTokenAddressSync(baseMint, owner, false, baseTokenProgram);
+    const quoteAccount = getAssociatedTokenAddressSync(quoteMint, owner, false, quoteTokenProgram);
+    return program.methods
+        .deposit(lpTokenAmount, maximumBaseAmount, maximumQuoteAmount)
+        .accounts({
+        owner,
+        poolState: poolAddress,
+        ownerLpToken,
+        baseAccount,
+        quoteAccount,
+        baseMint,
+        quoteMint,
+        baseVault,
+        quoteVault,
+        lpMint,
+    })
+        .instruction();
+}
+/**
+ * Builds a withdraw (remove liquidity) instruction.
+ *
+ * @param params - {@link BuildWithdrawParams}
+ * @returns Transaction instruction
+ */
+export function buildWithdraw(params) {
+    const { owner, poolAddress, baseMint, quoteMint, baseTokenProgram, quoteTokenProgram, baseVault, quoteVault, lpMint, lpTokenAmount, minimumBaseAmount, minimumQuoteAmount, config, } = params;
+    const program = getCachedSwapProgram(config);
+    const ownerLpToken = getAssociatedTokenAddressSync(lpMint, owner, false, TOKEN_PROGRAM_ID);
+    const baseAccount = getAssociatedTokenAddressSync(baseMint, owner, false, baseTokenProgram);
+    const quoteAccount = getAssociatedTokenAddressSync(quoteMint, owner, false, quoteTokenProgram);
+    return program.methods
+        .withdraw(lpTokenAmount, minimumBaseAmount, minimumQuoteAmount)
+        .accounts({
+        owner,
+        poolState: poolAddress,
+        ownerLpToken,
+        baseAccount,
+        quoteAccount,
+        baseMint,
+        quoteMint,
+        baseVault,
+        quoteVault,
+        lpMint,
+    })
+        .instruction();
+}
+/**
+ * Builds an executeBuyback instruction for an AMM pool.
+ * Permissionless. Only works when fee config is Revoked.
+ *
+ * @param params - {@link BuildSwapExecuteBuybackParams}
+ * @returns Transaction instruction
+ */
+export function buildSwapExecuteBuyback(params) {
+    const { payer, baseMint, quoteMint, baseTokenProgram, quoteTokenProgram, config, } = params;
+    const program = getCachedSwapProgram(config);
+    return program.methods
+        .executeBuyback()
+        .accounts({
+        payer,
+        baseMint,
+        quoteMint,
+        baseTokenProgram,
+        quoteTokenProgram,
+    })
+        .instruction();
+}
+//# sourceMappingURL=liquid-swap.js.map

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

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