@liquid-af/sdk 0.11.6 → 0.11.8

package/src/index.ts

@@ -15,6 +15,7 @@ export {
 	DEVNET_CONFIG,
 	LOCALNET_CONFIG,
 	WSOL_MINT,
+	REFERRER_COSIGNER,
 	BPS_DENOMINATOR,
 	NUM_FEE_RECIPIENTS,
 	MAX_FEE_RECIPIENTS_FEES,

package/src/lut.ts

@@ -1,16 +1,24 @@
 import {
+	AddressLookupTableProgram,
 	ComputeBudgetProgram,
 	PublicKey,
+	SYSVAR_INSTRUCTIONS_PUBKEY,
 	SystemProgram,
 	type Connection,
 	type AddressLookupTableAccount,
+	type TransactionInstruction,
 } from "@solana/web3.js";
 import {
 	ASSOCIATED_TOKEN_PROGRAM_ID,
 	TOKEN_2022_PROGRAM_ID,
 	TOKEN_PROGRAM_ID,
+	getAssociatedTokenAddressSync,
 } from "@solana/spl-token";
-import { type LiquidConfig, WSOL_MINT } from "./config.js";
+import {
+	type LiquidConfig,
+	REFERRER_COSIGNER,
+	WSOL_MINT,
+} from "./config.js";
 import {
 	getSwapAuthorityPDA,
 	getSwapGlobalConfigPDA,
@@ -19,8 +27,22 @@ import {
 	getGlobalAmmVolumePDA,
 	getGlobalCurveVolumePDA,
 	getCashbackConfigPDA,
+	getUserPropertiesPDA,
+	getTokenVolumePDA,
 } from "./pda/liquid-state.js";
-import { getLiquidGlobalConfigPDA } from "./pda/liquid.js";
+import {
+	getLiquidGlobalConfigPDA,
+	getBondingCurvePDA,
+	getBondingCurveSolVaultPDA,
+	getBuybackVaultPDA,
+	getBondingCurveTokenAccount,
+	getStableBondingCurvePDA,
+} from "./pda/liquid.js";
+import {
+	getFeeConfigPDA,
+	getFeeVaultPDA,
+	getFeeGlobalConfigPDA
+} from "./pda/liquid-fees.js";
 import { fetchAmmConfig } from "./accounts/liquid-swap.js";
 
 const SEED_CPI_AUTHORITY = Buffer.from("cpi_authority");
@@ -37,17 +59,18 @@ function getCpiAuthorityPDA(programId: PublicKey): PublicKey {
 }
 
 /**
- * Returns the 21 account addresses for the global LUT.
+ * Returns the 26 account addresses for the global LUT.
  *
- * Programs (9): System, SPL Token, Token-2022, ATA, ComputeBudget, State, Events, Fees, Swap
+ * Programs (10): System, SPL Token, Token-2022, ATA, ComputeBudget, Liquid, State, Events, Fees, Swap
  * Liquid PDAs (2): global_config, cpi_authority
  * Swap PDAs (3): authority, global_config, cpi_authority
  * State PDAs (4): global_amm_volume, global_curve_volume, cashback_config, cpi_authority
- * Constants (2): WSOL mint, oracle price feed
+ * Fees PDAs (2): global_config, cpi_authority
+ * Constants (5): WSOL mint, oracle price feed, instructions sysvar, referrer cosigner, USDC mint
  *
  * @param config - Liquid protocol configuration
  * @param connection - Solana RPC connection (for fetching oracle price feed)
- * @returns Array of 21 public keys to populate the LUT
+ * @returns Array of 26 public keys to populate the LUT
  */
 export async function getLutAccounts(
 	config: LiquidConfig,
@@ -79,6 +102,12 @@ export async function getLutAccounts(
 	const [cashbackConfig] = getCashbackConfigPDA(config.liquidStateProgramId);
 	const stateCpiAuthority = getCpiAuthorityPDA(config.liquidStateProgramId);
 
+	// Fees PDAs
+	const [feeGlobalConfig] = getFeeGlobalConfigPDA(
+		config.liquidFeesProgramId,
+	);
+	const feesCpiAuthority = getCpiAuthorityPDA(config.liquidFeesProgramId);
+
 	return [
 		// Programs
 		SystemProgram.programId,
@@ -86,6 +115,7 @@ export async function getLutAccounts(
 		TOKEN_2022_PROGRAM_ID,
 		ASSOCIATED_TOKEN_PROGRAM_ID,
 		ComputeBudgetProgram.programId,
+		config.liquidProgramId,
 		config.liquidStateProgramId,
 		config.liquidEventsProgramId,
 		config.liquidFeesProgramId,
@@ -102,9 +132,15 @@ export async function getLutAccounts(
 		globalCurveVolume,
 		cashbackConfig,
 		stateCpiAuthority,
+		// Fees global PDAs
+		feeGlobalConfig,
+		feesCpiAuthority,
 		// Constants
 		WSOL_MINT,
 		oraclePriceFeed,
+		SYSVAR_INSTRUCTIONS_PUBKEY,
+		REFERRER_COSIGNER,
+		config.usdcMint,
 	];
 }
 
@@ -121,4 +157,252 @@ export async function fetchLut(
 ): Promise<AddressLookupTableAccount | null> {
 	const result = await connection.getAddressLookupTable(lutAddress);
 	return result.value;
+}
+
+export interface GetNativeTokenLutAccountsParams {
+	/** Token mint address */
+	mint: PublicKey;
+	/** Trading user's public key */
+	user: PublicKey;
+	/** Bonding curve creator's public key */
+	creator: PublicKey;
+	/** Protocol configuration */
+	config: LiquidConfig;
+}
+
+/**
+ * Returns the per-token + per-user addresses for a native (SOL) bonding curve LUT.
+ * These supplement the global LUT — no global accounts are included.
+ *
+ * Token PDAs (9): mint, bondingCurve, solVault, buybackVault, bondingCurveTokenAccount,
+ *   feeConfig, feeVault, feeVaultTokenAccount, tokenVolume
+ * User PDAs (3): userProperties, creatorUserProperties, userTokenAccount
+ */
+export function getNativeTokenLutAccounts(
+	params: GetNativeTokenLutAccountsParams,
+): PublicKey[] {
+	const { mint, user, creator, config } = params;
+
+	// Token PDAs
+	const [bondingCurve] = getBondingCurvePDA(mint, config.liquidProgramId);
+	const [solVault] = getBondingCurveSolVaultPDA(
+		bondingCurve,
+		config.liquidProgramId,
+	);
+	const [buybackVault] = getBuybackVaultPDA(
+		bondingCurve,
+		config.liquidProgramId,
+	);
+	const bondingCurveTokenAccount = getBondingCurveTokenAccount(
+		mint,
+		config.liquidProgramId,
+	);
+	const [feeConfig] = getFeeConfigPDA(
+		mint,
+		WSOL_MINT,
+		config.liquidFeesProgramId,
+	);
+	const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
+	const feeVaultTokenAccount = getAssociatedTokenAddressSync(
+		WSOL_MINT,
+		feeVault,
+		true,
+		TOKEN_PROGRAM_ID,
+	);
+	const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
+
+	// User PDAs
+	const [userProperties] = getUserPropertiesPDA(
+		user,
+		config.liquidStateProgramId,
+	);
+	const [creatorUserProperties] = getUserPropertiesPDA(
+		creator,
+		config.liquidStateProgramId,
+	);
+	const userTokenAccount = getAssociatedTokenAddressSync(
+		mint,
+		user,
+		true,
+		TOKEN_2022_PROGRAM_ID,
+	);
+
+	return [
+		// Token PDAs
+		mint,
+		bondingCurve,
+		solVault,
+		buybackVault,
+		bondingCurveTokenAccount,
+		feeConfig,
+		feeVault,
+		feeVaultTokenAccount,
+		tokenVolume,
+		// User PDAs
+		userProperties,
+		creatorUserProperties,
+		userTokenAccount,
+	];
+}
+
+export interface GetStableTokenLutAccountsParams {
+	/** Token mint address */
+	mint: PublicKey;
+	/** Quote token mint address (e.g. USDC) */
+	quoteMint: PublicKey;
+	/** Trading user's public key */
+	user: PublicKey;
+	/** Bonding curve creator's public key */
+	creator: PublicKey;
+	/** Protocol configuration */
+	config: LiquidConfig;
+}
+
+/**
+ * Returns the per-token + per-user addresses for a stable (quote token) bonding curve LUT.
+ * These supplement the global LUT — no global accounts are included.
+ *
+ * Token PDAs (10): mint, quoteMint, bondingCurve, bondingCurveQuoteVault,
+ *   bondingCurveTokenAccount, buybackVault, feeConfig, feeVault, feeVaultTokenAccount, tokenVolume
+ * User PDAs (4): userProperties, creatorUserProperties, userTokenAccount, userQuoteAccount
+ */
+export function getStableTokenLutAccounts(
+	params: GetStableTokenLutAccountsParams,
+): PublicKey[] {
+	const { mint, quoteMint, user, creator, config } = params;
+
+	// Token PDAs
+	const [bondingCurve] = getStableBondingCurvePDA(
+		mint,
+		config.liquidProgramId,
+	);
+	const bondingCurveQuoteVault = getAssociatedTokenAddressSync(
+		quoteMint,
+		bondingCurve,
+		true,
+		TOKEN_PROGRAM_ID,
+	);
+	const bondingCurveTokenAccount = getAssociatedTokenAddressSync(
+		mint,
+		bondingCurve,
+		true,
+		TOKEN_2022_PROGRAM_ID,
+	);
+	const [buybackVault] = getBuybackVaultPDA(
+		bondingCurve,
+		config.liquidProgramId,
+	);
+	const [feeConfig] = getFeeConfigPDA(
+		mint,
+		quoteMint,
+		config.liquidFeesProgramId,
+	);
+	const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
+	const feeVaultTokenAccount = getAssociatedTokenAddressSync(
+		quoteMint,
+		feeVault,
+		true,
+		TOKEN_PROGRAM_ID,
+	);
+	const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
+
+	// User PDAs
+	const [userProperties] = getUserPropertiesPDA(
+		user,
+		config.liquidStateProgramId,
+	);
+	const [creatorUserProperties] = getUserPropertiesPDA(
+		creator,
+		config.liquidStateProgramId,
+	);
+	const userTokenAccount = getAssociatedTokenAddressSync(
+		mint,
+		user,
+		true,
+		TOKEN_2022_PROGRAM_ID,
+	);
+	const userQuoteAccount = getAssociatedTokenAddressSync(
+		quoteMint,
+		user,
+		true,
+		TOKEN_PROGRAM_ID,
+	);
+
+	return [
+		// Token PDAs
+		mint,
+		bondingCurve,
+		bondingCurveQuoteVault,
+		bondingCurveTokenAccount,
+		buybackVault,
+		feeConfig,
+		feeVault,
+		feeVaultTokenAccount,
+		tokenVolume,
+		// User PDAs
+		userProperties,
+		creatorUserProperties,
+		userTokenAccount,
+		userQuoteAccount,
+	];
+}
+
+export interface BuildCreateTokenLutParams {
+	/** Solana RPC connection (to fetch a recent slot) */
+	connection: Connection;
+	/** Payer/authority public key for the LUT */
+	payer: PublicKey;
+	/** Addresses to populate the LUT with */
+	addresses: PublicKey[];
+}
+
+export interface CreateTokenLutResult {
+	/** The derived LUT address */
+	lutAddress: PublicKey;
+	/** Create + extend instructions to include in a transaction */
+	instructions: TransactionInstruction[];
+}
+
+/**
+ * Builds instructions to create an Address Lookup Table and populate it
+ * with the given addresses. Handles deduplication.
+ *
+ * The caller is responsible for including these instructions in a transaction,
+ * signing, and sending. The LUT must be active for at least 1 slot before
+ * it can be used in subsequent transactions.
+ *
+ * @returns The derived LUT address and the instructions to create + extend it
+ */
+export async function buildCreateTokenLut(
+	params: BuildCreateTokenLutParams,
+): Promise<CreateTokenLutResult> {
+	const { connection, payer, addresses } = params;
+
+	// Deduplicate addresses
+	const seen = new Set<string>();
+	const unique: PublicKey[] = [];
+	for (const addr of addresses) {
+		const key = addr.toBase58();
+		if (!seen.has(key)) {
+			seen.add(key);
+			unique.push(addr);
+		}
+	}
+
+	const slot = await connection.getSlot();
+
+	const [createIx, lutAddress] = AddressLookupTableProgram.createLookupTable({
+		authority: payer,
+		payer,
+		recentSlot: slot,
+	});
+
+	const extendIx = AddressLookupTableProgram.extendLookupTable({
+		lookupTable: lutAddress,
+		authority: payer,
+		payer,
+		addresses: unique,
+	});
+
+	return { lutAddress, instructions: [createIx, extendIx] };
 }