@liquid-af/sdk 0.8.2 → 0.9.1

package/src/client.ts

@@ -58,7 +58,6 @@ import {
 } from "./instructions/liquid-fees.js";
 import {
 	buildInitializeUser,
-	buildSetReferrer,
 	buildSetCashbackMode,
 	buildRedeemDeal,
 } from "./instructions/liquid-state.js";
@@ -727,13 +726,6 @@ export class LiquidClient {
 		return buildInitializeUser({ ...params, config: this.config });
 	}
 
-	/** Builds a setReferrer instruction. One-time operation — referrer cannot be changed. */
-	buildSetReferrer(params: {
-		user: PublicKey;
-		referrer: PublicKey;
-	}): Promise<TransactionInstruction> {
-		return buildSetReferrer({ ...params, config: this.config });
-	}
 
 	/** Builds a setCashbackMode instruction. Toggles between earning and spending mode. */
 	buildSetCashbackMode(params: {

package/src/helpers/ata.ts

@@ -0,0 +1,44 @@
+import {
+	createAssociatedTokenAccountIdempotentInstruction,
+	getAssociatedTokenAddressSync,
+} from "@solana/spl-token";
+import type { PublicKey, TransactionInstruction } from "@solana/web3.js";
+
+/**
+ * Builds an instruction that creates the ATA for `owner` idempotently.
+ * Safe to include even if the ATA already exists — it becomes a no-op on-chain.
+ *
+ * Use this to ensure the user's token account exists before calling a buy
+ * instruction, since the on-chain program no longer auto-creates it.
+ *
+ * @param payer - Rent payer for account creation
+ * @param owner - Token account owner (wallet)
+ * @param mint - Token mint
+ * @param tokenProgram - TOKEN_PROGRAM_ID or TOKEN_2022_PROGRAM_ID
+ * @returns `{ ata, instruction }` — the derived ATA address and the init instruction
+ *
+ * @example
+ * ```typescript
+ * const { ata, instruction: ataIx } = buildEnsureAtaInstruction(
+ *     payer, user, mint, TOKEN_2022_PROGRAM_ID,
+ * );
+ * const buyIx = await buildBuyExactInNative({ ..., userTokenAccount: ata });
+ * await sendTransaction([ataIx, buyIx], ...);
+ * ```
+ */
+export function buildEnsureAtaInstruction(
+	payer: PublicKey,
+	owner: PublicKey,
+	mint: PublicKey,
+	tokenProgram: PublicKey,
+): { ata: PublicKey; instruction: TransactionInstruction } {
+	const ata = getAssociatedTokenAddressSync(mint, owner, false, tokenProgram);
+	const instruction = createAssociatedTokenAccountIdempotentInstruction(
+		payer,
+		ata,
+		owner,
+		mint,
+		tokenProgram,
+	);
+	return { ata, instruction };
+}

package/src/helpers/index.ts

@@ -21,3 +21,4 @@ export type {
 } from "./preview.js";
 
 export { resolveTokenProgram } from "./user.js";
+export { buildEnsureAtaInstruction } from "./ata.js";