@liquid-af/sdk 0.8.1 → 0.9.0

package/dist/helpers/ata.d.ts

@@ -0,0 +1,28 @@
+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 declare function buildEnsureAtaInstruction(payer: PublicKey, owner: PublicKey, mint: PublicKey, tokenProgram: PublicKey): {
+    ata: PublicKey;
+    instruction: TransactionInstruction;
+};
+//# sourceMappingURL=ata.d.ts.map

package/dist/helpers/ata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ata.d.ts","sourceRoot":"","sources":["../../src/helpers/ata.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,SAAS,EACf,YAAY,EAAE,SAAS,GACrB;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,sBAAsB,CAAA;CAAE,CAUzD"}

package/dist/helpers/ata.js

@@ -0,0 +1,29 @@
+import { createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddressSync, } from "@solana/spl-token";
+/**
+ * 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, owner, mint, tokenProgram) {
+    const ata = getAssociatedTokenAddressSync(mint, owner, false, tokenProgram);
+    const instruction = createAssociatedTokenAccountIdempotentInstruction(payer, ata, owner, mint, tokenProgram);
+    return { ata, instruction };
+}
+//# sourceMappingURL=ata.js.map

package/dist/helpers/ata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ata.js","sourceRoot":"","sources":["../../src/helpers/ata.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iDAAiD,EACjD,6BAA6B,GAC7B,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,yBAAyB,CACxC,KAAgB,EAChB,KAAgB,EAChB,IAAe,EACf,YAAuB;IAEvB,MAAM,GAAG,GAAG,6BAA6B,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,iDAAiD,CACpE,KAAK,EACL,GAAG,EACH,KAAK,EACL,IAAI,EACJ,YAAY,CACZ,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;AAC7B,CAAC"}

package/dist/helpers/index.d.ts

@@ -1,4 +1,5 @@
 export { previewBuyOnCurve, previewSellOnCurve, previewSwapSell, previewSwapBuy, calculateBuyCurvePreview, calculateSellCurvePreview, calculateSwapSellPreview, calculateSwapBuyPreview, } from "./preview.js";
 export type { CurvePreviewState, SwapPreviewState, CurvePreviewOptions, CurvePrefetchedState, NativeCurveOptions, StableCurveOptions, CurveAsyncOptions, SwapPrefetchedState, } from "./preview.js";
 export { resolveTokenProgram } from "./user.js";
+export { buildEnsureAtaInstruction } from "./ata.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC"}

package/dist/helpers/index.js

@@ -1,3 +1,4 @@
 export { previewBuyOnCurve, previewSellOnCurve, previewSwapSell, previewSwapBuy, calculateBuyCurvePreview, calculateSellCurvePreview, calculateSwapSellPreview, calculateSwapBuyPreview, } from "./preview.js";
 export { resolveTokenProgram } from "./user.js";
+export { buildEnsureAtaInstruction } from "./ata.js";
 //# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAatB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAatB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC"}