@syndicure/vault-sdk 0.1.0

package/dist/instructions/nft.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * @vault-program/sdk — NFT pool instruction builders.
+ *
+ * Builds transactions for:
+ *   - swap_token_for_nft
+ *   - swap_nft_for_token
+ *   - add_liquidity_token_nft
+ *   - remove_liquidity_token_nft
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSwapTokenForNft = buildSwapTokenForNft;
+exports.buildSwapNftForToken = buildSwapNftForToken;
+exports.buildAddLiquidityNft = buildAddLiquidityNft;
+exports.buildRemoveLiquidityNft = buildRemoveLiquidityNft;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const constants_1 = require("../constants");
+const pda_1 = require("../pda");
+// ─── Helpers ─────────────────────────────────────────────────
+function tokenProgramForA(pool) {
+    return pool.assetAIsToken2022
+        ? new web3_js_1.PublicKey("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb")
+        : spl_token_1.TOKEN_PROGRAM_ID;
+}
+async function buildSwapTokenForNft(opts) {
+    const pid = opts.programId ?? constants_1.PROGRAM_ID;
+    const [configPda] = (0, pda_1.deriveConfigPda)(pid);
+    const [treasuryPda] = (0, pda_1.deriveTreasuryPda)(pid);
+    const [nftEscrow] = (0, pda_1.deriveNftEscrowPda)(opts.pool.address, opts.nftMint, pid);
+    return opts.program.methods
+        .swapTokenForNft(opts.maxCost)
+        .accounts({
+        user: opts.user,
+        config: configPda,
+        pool: opts.pool.address,
+        assetAMint: opts.pool.assetAMint,
+        vaultA: opts.pool.vaultA,
+        userTokenA: opts.userTokenA,
+        treasury: treasuryPda,
+        treasuryFeeAccount: opts.treasuryFeeAccount,
+        nftMint: opts.nftMint,
+        nftMetadata: opts.nftMetadata,
+        poolNftAccount: opts.poolNftAccount,
+        userNftAccount: opts.userNftAccount,
+        nftEscrow,
+        creatorFeeVault: (0, pda_1.deriveCreatorFeeVaultPda)(opts.pool.address, pid)[0],
+        tokenProgramA: tokenProgramForA(opts.pool),
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .preInstructions([
+        web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+            units: opts.computeUnits ?? 400000,
+        }),
+    ]);
+}
+async function buildSwapNftForToken(opts) {
+    const pid = opts.programId ?? constants_1.PROGRAM_ID;
+    const [configPda] = (0, pda_1.deriveConfigPda)(pid);
+    const [treasuryPda] = (0, pda_1.deriveTreasuryPda)(pid);
+    const [nftEscrow] = (0, pda_1.deriveNftEscrowPda)(opts.pool.address, opts.nftMint, pid);
+    return opts.program.methods
+        .swapNftForToken(opts.minPayout)
+        .accounts({
+        user: opts.user,
+        config: configPda,
+        pool: opts.pool.address,
+        assetAMint: opts.pool.assetAMint,
+        vaultA: opts.pool.vaultA,
+        userTokenA: opts.userTokenA,
+        treasury: treasuryPda,
+        treasuryFeeAccount: opts.treasuryFeeAccount,
+        nftMint: opts.nftMint,
+        nftMetadata: opts.nftMetadata,
+        userNftAccount: opts.userNftAccount,
+        poolNftAccount: opts.poolNftAccount,
+        nftEscrow,
+        creatorFeeVault: (0, pda_1.deriveCreatorFeeVaultPda)(opts.pool.address, pid)[0],
+        tokenProgramA: tokenProgramForA(opts.pool),
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .preInstructions([
+        web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+            units: opts.computeUnits ?? 400000,
+        }),
+    ]);
+}
+async function buildAddLiquidityNft(opts) {
+    const pid = opts.programId ?? constants_1.PROGRAM_ID;
+    const [configPda] = (0, pda_1.deriveConfigPda)(pid);
+    const [lpMint] = (0, pda_1.deriveLpMintPda)(opts.pool.address, pid);
+    const [position] = (0, pda_1.derivePositionPda)(opts.pool.address, opts.user, pid);
+    const [nftEscrow] = (0, pda_1.deriveNftEscrowPda)(opts.pool.address, opts.nftMint, pid);
+    return opts.program.methods
+        .addLiquidityTokenNft(opts.tokenAmount)
+        .accounts({
+        user: opts.user,
+        config: configPda,
+        pool: opts.pool.address,
+        vaultA: opts.pool.vaultA,
+        assetAMint: opts.pool.assetAMint,
+        lpMint,
+        userTokenA: opts.userTokenA,
+        userLpAccount: opts.userLpAccount,
+        position,
+        nftMint: opts.nftMint,
+        nftMetadata: opts.nftMetadata,
+        userNftAccount: opts.userNftAccount,
+        poolNftAccount: opts.poolNftAccount,
+        nftEscrow,
+        tokenProgramA: tokenProgramForA(opts.pool),
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .preInstructions([
+        web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+            units: opts.computeUnits ?? 400000,
+        }),
+    ]);
+}
+async function buildRemoveLiquidityNft(opts) {
+    const pid = opts.programId ?? constants_1.PROGRAM_ID;
+    const [configPda] = (0, pda_1.deriveConfigPda)(pid);
+    const [lpMint] = (0, pda_1.deriveLpMintPda)(opts.pool.address, pid);
+    const [position] = (0, pda_1.derivePositionPda)(opts.pool.address, opts.user, pid);
+    const [nftEscrow] = (0, pda_1.deriveNftEscrowPda)(opts.pool.address, opts.nftMint, pid);
+    return opts.program.methods
+        .removeLiquidityTokenNft(opts.lpTokensToBurn)
+        .accounts({
+        user: opts.user,
+        config: configPda,
+        pool: opts.pool.address,
+        vaultA: opts.pool.vaultA,
+        assetAMint: opts.pool.assetAMint,
+        lpMint,
+        userTokenA: opts.userTokenA,
+        userLpAccount: opts.userLpAccount,
+        position,
+        nftMint: opts.nftMint,
+        poolNftAccount: opts.poolNftAccount,
+        userNftAccount: opts.userNftAccount,
+        nftEscrow,
+        tokenProgramA: tokenProgramForA(opts.pool),
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .preInstructions([
+        web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+            units: opts.computeUnits ?? 400000,
+        }),
+    ]);
+}
+//# sourceMappingURL=nft.js.map

package/dist/instructions/nft.js.map

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

package/dist/instructions/swap.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @vault-program/sdk — Swap instruction builder.
+ *
+ * Builds swap_tokens transactions for 1–3 hop routes with the
+ * correct `remaining_accounts` layout.
+ *
+ * Layout per hop (intermediate = 9 accounts, final = 8 accounts):
+ *   [0] pool          writable
+ *   [1] mintA          read-only
+ *   [2] mintB          read-only
+ *   [3] vaultA         writable
+ *   [4] vaultB         writable
+ *   [5] tokenProgramA  read-only
+ *   [6] tokenProgramB  read-only
+ *   [7] treasuryFee    writable
+ *   [8] userInterToken writable  (intermediate hops only)
+ */
+import { Program } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { SwapQuote } from "../types";
+export interface BuildSwapOpts {
+    /** Anchor program instance. */
+    program: Program<any>;
+    /** The wallet executing the swap. */
+    user: PublicKey;
+    /** Quote obtained from the routing module. */
+    quote: SwapQuote;
+    /** User ATA for the input token. */
+    userInputToken: PublicKey;
+    /** User ATA for the output token. */
+    userOutputToken: PublicKey;
+    /**
+     * User ATAs for intermediate tokens (between hops).
+     * Required for 2+ hop routes: index 0 = ATA for token
+     * between hop 0 and hop 1, etc.
+     */
+    userIntermediateTokens?: PublicKey[];
+    /** Override treasury PDA (defaults to derived). */
+    treasuryPda?: PublicKey;
+    /** Override config PDA (defaults to derived). */
+    configPda?: PublicKey;
+    /** Override program ID. */
+    programId?: PublicKey;
+    /** Compute unit limit (default 400_000). */
+    computeUnits?: number;
+}
+/**
+ * Build a complete swap_tokens transaction.
+ *
+ * Returns the method builder — call `.rpc()` or `.transaction()` on it.
+ */
+export declare function buildSwapTransaction(opts: BuildSwapOpts): Promise<any>;
+/**
+ * Convenience: build + send a swap transaction, returning the signature.
+ */
+export declare function executeSwap(opts: BuildSwapOpts): Promise<string>;
+//# sourceMappingURL=swap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../src/instructions/swap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAM,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,SAAS,EAIV,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAO,SAAS,EAAQ,MAAM,UAAU,CAAC;AAMhD,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;IACjB,oCAAoC;IACpC,cAAc,EAAE,SAAS,CAAC;IAC1B,qCAAqC;IACrC,eAAe,EAAE,SAAS,CAAC;IAC3B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,SAAS,EAAE,CAAC;IACrC,mDAAmD;IACnD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,iDAAiD;IACjD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+ED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CA2C5E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtE"}

package/dist/instructions/swap.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * @vault-program/sdk — Swap instruction builder.
+ *
+ * Builds swap_tokens transactions for 1–3 hop routes with the
+ * correct `remaining_accounts` layout.
+ *
+ * Layout per hop (intermediate = 9 accounts, final = 8 accounts):
+ *   [0] pool          writable
+ *   [1] mintA          read-only
+ *   [2] mintB          read-only
+ *   [3] vaultA         writable
+ *   [4] vaultB         writable
+ *   [5] tokenProgramA  read-only
+ *   [6] tokenProgramB  read-only
+ *   [7] treasuryFee    writable
+ *   [8] userInterToken writable  (intermediate hops only)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSwapTransaction = buildSwapTransaction;
+exports.executeSwap = executeSwap;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const pda_1 = require("../pda");
+const constants_1 = require("../constants");
+// ─── Helpers ─────────────────────────────────────────────────
+function tokenProgramForMint(pool, isA) {
+    const is2022 = isA ? pool.assetAIsToken2022 : pool.assetBIsToken2022;
+    // Token-2022 program ID
+    return is2022
+        ? new web3_js_1.PublicKey("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb")
+        : spl_token_1.TOKEN_PROGRAM_ID;
+}
+/**
+ * Derive the treasury ATA for the fee mint.
+ * Fee is always taken on the INPUT side of the hop.
+ */
+async function deriveTreasuryFeeAccount(hop, treasuryPda) {
+    const feeMint = hop.aToB ? hop.pool.assetAMint : hop.pool.assetBMint;
+    return (0, spl_token_1.getAssociatedTokenAddress)(feeMint, treasuryPda, true);
+}
+// ─── Builder ─────────────────────────────────────────────────
+/**
+ * Build remaining_accounts for a multi-hop swap.
+ *
+ * @returns [remainingAccounts, hopDirections]
+ */
+async function buildRemainingAccounts(hops, treasuryPda, userIntermediateTokens) {
+    const remaining = [];
+    const directions = [];
+    for (let i = 0; i < hops.length; i++) {
+        const hop = hops[i];
+        const pool = hop.pool;
+        const isLast = i === hops.length - 1;
+        const treasuryFee = await deriveTreasuryFeeAccount(hop, treasuryPda);
+        const tokenProgramA = tokenProgramForMint(pool, true);
+        const tokenProgramB = tokenProgramForMint(pool, false);
+        remaining.push({ pubkey: pool.address, isSigner: false, isWritable: true }, { pubkey: pool.assetAMint, isSigner: false, isWritable: false }, { pubkey: pool.assetBMint, isSigner: false, isWritable: false }, { pubkey: pool.vaultA, isSigner: false, isWritable: true }, { pubkey: pool.vaultB, isSigner: false, isWritable: true }, { pubkey: tokenProgramA, isSigner: false, isWritable: false }, { pubkey: tokenProgramB, isSigner: false, isWritable: false }, { pubkey: treasuryFee, isSigner: false, isWritable: true });
+        // Intermediate hops include user's intermediate token account
+        if (!isLast) {
+            if (!userIntermediateTokens[i]) {
+                throw new Error(`Missing userIntermediateTokens[${i}] for hop ${i} → ${i + 1}`);
+            }
+            remaining.push({
+                pubkey: userIntermediateTokens[i],
+                isSigner: false,
+                isWritable: true,
+            });
+        }
+        directions.push(hop.aToB);
+    }
+    return [remaining, directions];
+}
+/**
+ * Build a complete swap_tokens transaction.
+ *
+ * Returns the method builder — call `.rpc()` or `.transaction()` on it.
+ */
+async function buildSwapTransaction(opts) {
+    const programId = opts.programId ?? constants_1.PROGRAM_ID;
+    const [configPda] = opts.configPda
+        ? [opts.configPda]
+        : (0, pda_1.deriveConfigPda)(programId);
+    const [treasuryPda] = opts.treasuryPda
+        ? [opts.treasuryPda]
+        : (0, pda_1.deriveTreasuryPda)(programId);
+    const hops = opts.quote.route.hops;
+    const numHops = hops.length;
+    const [remaining, directions] = await buildRemainingAccounts(hops, treasuryPda, opts.userIntermediateTokens ?? []);
+    const builder = opts.program.methods
+        .swapTokens(opts.quote.amountIn, opts.quote.minimumOutput, numHops, directions)
+        .accounts({
+        user: opts.user,
+        config: configPda,
+        userInputToken: opts.userInputToken,
+        userOutputToken: opts.userOutputToken,
+        treasury: treasuryPda,
+        creatorFeeVault: (0, pda_1.deriveCreatorFeeVaultPda)(hops[0].pool.address, opts.programId ?? constants_1.PROGRAM_ID)[0],
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    })
+        .remainingAccounts(remaining)
+        .preInstructions([
+        web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({
+            units: opts.computeUnits ?? 400000,
+        }),
+    ]);
+    return builder;
+}
+/**
+ * Convenience: build + send a swap transaction, returning the signature.
+ */
+async function executeSwap(opts) {
+    const builder = await buildSwapTransaction(opts);
+    return builder.rpc();
+}
+//# sourceMappingURL=swap.js.map

package/dist/instructions/swap.js.map

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

package/dist/pda.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @vault-program/sdk — PDA derivation helpers.
+ */
+import { PublicKey } from "@solana/web3.js";
+/** Derive the singleton ProtocolConfig PDA. */
+export declare function deriveConfigPda(programId?: PublicKey): [PublicKey, number];
+/** Derive the treasury PDA. */
+export declare function deriveTreasuryPda(programId?: PublicKey): [PublicKey, number];
+/**
+ * Derive the Pool PDA.
+ * Mints are auto-sorted into canonical order (mintA < mintB).
+ * Returns `[poolPda, bump, sortedMintA, sortedMintB]`.
+ */
+export declare function derivePoolPda(mintA: PublicKey, mintB: PublicKey, programId?: PublicKey): [PublicKey, number, PublicKey, PublicKey];
+/** Derive the LP mint PDA for a given pool. */
+export declare function deriveLpMintPda(poolPda: PublicKey, programId?: PublicKey): [PublicKey, number];
+/** Derive the liquidity position PDA for a user + pool pair. */
+export declare function derivePositionPda(poolPda: PublicKey, user: PublicKey, programId?: PublicKey): [PublicKey, number];
+/** Derive the NFT escrow PDA. */
+export declare function deriveNftEscrowPda(poolPda: PublicKey, nftMint: PublicKey, programId?: PublicKey): [PublicKey, number];
+/**
+ * Sort two mints into canonical (ascending byte) order.
+ * This matches the on-chain constraint `asset_a_mint < asset_b_mint`.
+ */
+export declare function sortMints(a: PublicKey, b: PublicKey): [PublicKey, PublicKey];
+/** Derive the CreatorFeeVault PDA for a given pool. */
+export declare function deriveCreatorFeeVaultPda(poolPda: PublicKey, programId?: PublicKey): [PublicKey, number];
+//# sourceMappingURL=pda.d.ts.map

package/dist/pda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../src/pda.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,SAAS,YAAa,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAK3E;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAAC,SAAS,YAAa,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAK7E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,SAAS,YAAa,GACrB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAO3C;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,EAClB,SAAS,YAAa,GACrB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,SAAS,EACf,SAAS,YAAa,GACrB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,iCAAiC;AACjC,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,SAAS,EAClB,SAAS,YAAa,GACrB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAI5E;AAED,uDAAuD;AACvD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,EAClB,SAAS,YAAa,GACrB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB"}

package/dist/pda.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * @vault-program/sdk — PDA derivation helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveConfigPda = deriveConfigPda;
+exports.deriveTreasuryPda = deriveTreasuryPda;
+exports.derivePoolPda = derivePoolPda;
+exports.deriveLpMintPda = deriveLpMintPda;
+exports.derivePositionPda = derivePositionPda;
+exports.deriveNftEscrowPda = deriveNftEscrowPda;
+exports.sortMints = sortMints;
+exports.deriveCreatorFeeVaultPda = deriveCreatorFeeVaultPda;
+const web3_js_1 = require("@solana/web3.js");
+const constants_1 = require("./constants");
+/** Derive the singleton ProtocolConfig PDA. */
+function deriveConfigPda(programId = constants_1.PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.PROTOCOL_CONFIG_SEED], programId);
+}
+/** Derive the treasury PDA. */
+function deriveTreasuryPda(programId = constants_1.PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.TREASURY_SEED], programId);
+}
+/**
+ * Derive the Pool PDA.
+ * Mints are auto-sorted into canonical order (mintA < mintB).
+ * Returns `[poolPda, bump, sortedMintA, sortedMintB]`.
+ */
+function derivePoolPda(mintA, mintB, programId = constants_1.PROGRAM_ID) {
+    const [sorted0, sorted1] = sortMints(mintA, mintB);
+    const [pda, bump] = web3_js_1.PublicKey.findProgramAddressSync([constants_1.POOL_SEED, sorted0.toBuffer(), sorted1.toBuffer()], programId);
+    return [pda, bump, sorted0, sorted1];
+}
+/** Derive the LP mint PDA for a given pool. */
+function deriveLpMintPda(poolPda, programId = constants_1.PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.LP_MINT_SEED, poolPda.toBuffer()], programId);
+}
+/** Derive the liquidity position PDA for a user + pool pair. */
+function derivePositionPda(poolPda, user, programId = constants_1.PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.LP_POSITION_SEED, poolPda.toBuffer(), user.toBuffer()], programId);
+}
+/** Derive the NFT escrow PDA. */
+function deriveNftEscrowPda(poolPda, nftMint, programId = constants_1.PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.NFT_ESCROW_SEED, poolPda.toBuffer(), nftMint.toBuffer()], programId);
+}
+/**
+ * Sort two mints into canonical (ascending byte) order.
+ * This matches the on-chain constraint `asset_a_mint < asset_b_mint`.
+ */
+function sortMints(a, b) {
+    const bufA = a.toBuffer();
+    const bufB = b.toBuffer();
+    return Buffer.compare(bufA, bufB) <= 0 ? [a, b] : [b, a];
+}
+/** Derive the CreatorFeeVault PDA for a given pool. */
+function deriveCreatorFeeVaultPda(poolPda, programId = constants_1.PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([constants_1.CREATOR_FEE_SEED, poolPda.toBuffer()], programId);
+}
+//# sourceMappingURL=pda.js.map

package/dist/pda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda.js","sourceRoot":"","sources":["../src/pda.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAeH,0CAKC;AAGD,8CAKC;AAOD,sCAWC;AAGD,0CAQC;AAGD,8CASC;AAGD,gDASC;AAMD,8BAIC;AAGD,4DAQC;AApGD,6CAA4C;AAC5C,2CASqB;AAErB,+CAA+C;AAC/C,SAAgB,eAAe,CAAC,SAAS,GAAG,sBAAU;IACpD,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,gCAAoB,CAAC,EACtB,SAAS,CACV,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,SAAgB,iBAAiB,CAAC,SAAS,GAAG,sBAAU;IACtD,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,yBAAa,CAAC,EACf,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAC3B,KAAgB,EAChB,KAAgB,EAChB,SAAS,GAAG,sBAAU;IAEtB,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,mBAAS,CAAC,sBAAsB,CAClD,CAAC,qBAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,EACnD,SAAS,CACV,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,+CAA+C;AAC/C,SAAgB,eAAe,CAC7B,OAAkB,EAClB,SAAS,GAAG,sBAAU;IAEtB,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,wBAAY,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,EAClC,SAAS,CACV,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAgB,iBAAiB,CAC/B,OAAkB,EAClB,IAAe,EACf,SAAS,GAAG,sBAAU;IAEtB,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,4BAAgB,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EACvD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,SAAgB,kBAAkB,CAChC,OAAkB,EAClB,OAAkB,EAClB,SAAS,GAAG,sBAAU;IAEtB,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,2BAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,EACzD,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,CAAY,EAAE,CAAY;IAClD,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1B,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,uDAAuD;AACvD,SAAgB,wBAAwB,CACtC,OAAkB,EAClB,SAAS,GAAG,sBAAU;IAEtB,OAAO,mBAAS,CAAC,sBAAsB,CACrC,CAAC,4BAAgB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,EACtC,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/pool/fetcher.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @vault-program/sdk — Pool account deserialization.
+ *
+ * Uses raw `getProgramAccounts` with discriminator filter + borsh layout
+ * so the SDK does not depend on a full Anchor Program instance.
+ */
+import { Connection, PublicKey } from "@solana/web3.js";
+import { Pool, ProtocolConfig } from "../types";
+/** Parse a Pool from raw account data + its public key. */
+export declare function deserializePool(address: PublicKey, data: Buffer): Pool;
+/**
+ * Fetch all Pool accounts from the program.
+ * Uses a single `getProgramAccounts` call with a discriminator filter.
+ */
+export declare function fetchAllPools(connection: Connection, programId?: PublicKey): Promise<Pool[]>;
+/**
+ * Fetch a single Pool by its PDA address.
+ * Returns `null` if the account does not exist.
+ */
+export declare function fetchPool(connection: Connection, poolAddress: PublicKey): Promise<Pool | null>;
+/** Fetch and deserialize the ProtocolConfig. Returns `null` if not found. */
+export declare function fetchConfig(connection: Connection, programId?: PublicKey): Promise<ProtocolConfig | null>;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/pool/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/pool/fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,IAAI,EAAY,cAAc,EAAE,MAAM,UAAU,CAAC;AA6E1D,2DAA2D;AAC3D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,GACX,IAAI,CA6BN;AAID;;;GAGG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,EACtB,SAAS,YAAa,GACrB,OAAO,CAAC,IAAI,EAAE,CAAC,CAUjB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAItB;AAoBD,6EAA6E;AAC7E,wBAAsB,WAAW,CAC/B,UAAU,EAAE,UAAU,EACtB,SAAS,YAAa,GACrB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmBhC"}

package/dist/pool/fetcher.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * @vault-program/sdk — Pool account deserialization.
+ *
+ * Uses raw `getProgramAccounts` with discriminator filter + borsh layout
+ * so the SDK does not depend on a full Anchor Program instance.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserializePool = deserializePool;
+exports.fetchAllPools = fetchAllPools;
+exports.fetchPool = fetchPool;
+exports.fetchConfig = fetchConfig;
+const web3_js_1 = require("@solana/web3.js");
+const bn_js_1 = __importDefault(require("bn.js"));
+const constants_1 = require("../constants");
+const pda_1 = require("../pda");
+// ─── Anchor discriminator (first 8 bytes of sha256("account:Pool")) ──
+const POOL_DISCRIMINATOR = Buffer.from([
+    241, 154, 109, 4, 17, 177, 109, 188,
+]);
+// ─── Borsh layout offsets for Pool ───────────────────────────
+// Anchor prepends an 8-byte discriminator. All offsets below are
+// relative to the start of the account data (i.e., include the discriminator).
+const OFF_CREATOR = 8;
+const OFF_ASSET_A_MINT = 40;
+const OFF_ASSET_B_MINT = 72;
+const OFF_POOL_TYPE = 104; // 1 byte enum
+const OFF_VAULT_A = 105;
+const OFF_VAULT_B = 137;
+const OFF_NFT_ESCROW_COUNT = 169; // u32 LE
+const OFF_LP_MINT = 173;
+const OFF_TOTAL_LP_SUPPLY = 205; // u64 LE
+const OFF_RESERVE_A = 213;
+const OFF_RESERVE_B = 221;
+const OFF_CUMULATIVE_FEE_A = 229;
+const OFF_CUMULATIVE_FEE_B = 237;
+const OFF_FEE_PER_SHARE_A = 245; // u128 LE (16 bytes)
+const OFF_FEE_PER_SHARE_B = 261;
+const OFF_LAST_PRICE = 277; // u64 LE
+const OFF_IS_LOCKED = 285; // bool
+const OFF_IS_ACTIVE = 286;
+const OFF_ASSET_A_IS_TOKEN_2022 = 287;
+const OFF_ASSET_B_IS_TOKEN_2022 = 288;
+const OFF_POOL_FEE_BPS = 289; // u16 LE
+const OFF_BASE_PRICE = 291; // u64 LE
+const OFF_CURVE_DELTA = 299;
+const OFF_CREATED_AT = 307; // i64 LE
+const OFF_BUMP = 315;
+// ─── Helpers ─────────────────────────────────────────────────
+function readPubkey(buf, offset) {
+    return new web3_js_1.PublicKey(buf.subarray(offset, offset + 32));
+}
+function readU64(buf, offset) {
+    return new bn_js_1.default(buf.subarray(offset, offset + 8), "le");
+}
+function readU128(buf, offset) {
+    return new bn_js_1.default(buf.subarray(offset, offset + 16), "le");
+}
+function readI64(buf, offset) {
+    return new bn_js_1.default(buf.subarray(offset, offset + 8), "le");
+}
+function readU16(buf, offset) {
+    return buf.readUInt16LE(offset);
+}
+function readU32(buf, offset) {
+    return buf.readUInt32LE(offset);
+}
+function readBool(buf, offset) {
+    return buf[offset] !== 0;
+}
+function readPoolType(buf, offset) {
+    const v = buf[offset];
+    if (v > 3)
+        throw new Error(`Unknown PoolType variant: ${v}`);
+    return v;
+}
+// ─── Deserialize a single Pool ───────────────────────────────
+/** Parse a Pool from raw account data + its public key. */
+function deserializePool(address, data) {
+    return {
+        address,
+        creator: readPubkey(data, OFF_CREATOR),
+        assetAMint: readPubkey(data, OFF_ASSET_A_MINT),
+        assetBMint: readPubkey(data, OFF_ASSET_B_MINT),
+        poolType: readPoolType(data, OFF_POOL_TYPE),
+        vaultA: readPubkey(data, OFF_VAULT_A),
+        vaultB: readPubkey(data, OFF_VAULT_B),
+        nftEscrowCount: readU32(data, OFF_NFT_ESCROW_COUNT),
+        lpMint: readPubkey(data, OFF_LP_MINT),
+        totalLpSupply: readU64(data, OFF_TOTAL_LP_SUPPLY),
+        reserveA: readU64(data, OFF_RESERVE_A),
+        reserveB: readU64(data, OFF_RESERVE_B),
+        cumulativeFeeA: readU64(data, OFF_CUMULATIVE_FEE_A),
+        cumulativeFeeB: readU64(data, OFF_CUMULATIVE_FEE_B),
+        feePerShareA: readU128(data, OFF_FEE_PER_SHARE_A),
+        feePerShareB: readU128(data, OFF_FEE_PER_SHARE_B),
+        lastPrice: readU64(data, OFF_LAST_PRICE),
+        isLocked: readBool(data, OFF_IS_LOCKED),
+        isActive: readBool(data, OFF_IS_ACTIVE),
+        assetAIsToken2022: readBool(data, OFF_ASSET_A_IS_TOKEN_2022),
+        assetBIsToken2022: readBool(data, OFF_ASSET_B_IS_TOKEN_2022),
+        poolFeeBps: readU16(data, OFF_POOL_FEE_BPS),
+        basePrice: readU64(data, OFF_BASE_PRICE),
+        curveDelta: readU64(data, OFF_CURVE_DELTA),
+        createdAt: readI64(data, OFF_CREATED_AT),
+        bump: data[OFF_BUMP],
+    };
+}
+// ─── Fetch helpers ───────────────────────────────────────────
+/**
+ * Fetch all Pool accounts from the program.
+ * Uses a single `getProgramAccounts` call with a discriminator filter.
+ */
+async function fetchAllPools(connection, programId = constants_1.PROGRAM_ID) {
+    const accounts = await connection.getProgramAccounts(programId, {
+        filters: [
+            { memcmp: { offset: 0, bytes: POOL_DISCRIMINATOR.toString("base64") } },
+        ],
+    });
+    return accounts.map(({ pubkey, account }) => deserializePool(pubkey, account.data));
+}
+/**
+ * Fetch a single Pool by its PDA address.
+ * Returns `null` if the account does not exist.
+ */
+async function fetchPool(connection, poolAddress) {
+    const info = await connection.getAccountInfo(poolAddress);
+    if (!info)
+        return null;
+    return deserializePool(poolAddress, info.data);
+}
+// ─── Config discriminator (sha256("account:ProtocolConfig")[..8]) ──
+const CONFIG_DISCRIMINATOR = Buffer.from([
+    222, 70, 13, 54, 120, 240, 223, 72,
+]);
+const CFG_OFF_AUTHORITY = 8;
+const CFG_OFF_TREASURY = 40;
+const CFG_OFF_POOL_CREATION_FEE = 72; // u64
+const CFG_OFF_SWAP_FEE_BPS = 80; // u16
+const CFG_OFF_TREASURY_FEE_BPS = 82; // u16
+const CFG_OFF_TOTAL_POOLS = 84; // u64
+const CFG_OFF_IS_PAUSED = 92; // bool
+const CFG_OFF_BUMP = 93; // u8
+const CFG_OFF_TREASURY_BUMP = 94; // u8
+const CFG_OFF_TOKEN_SWAP_SOL_FEE = 95; // u64
+const CFG_OFF_NFT_SWAP_SOL_FEE = 103; // u64
+/** Fetch and deserialize the ProtocolConfig. Returns `null` if not found. */
+async function fetchConfig(connection, programId = constants_1.PROGRAM_ID) {
+    const [configPda] = (0, pda_1.deriveConfigPda)(programId);
+    const info = await connection.getAccountInfo(configPda);
+    if (!info)
+        return null;
+    const data = info.data;
+    return {
+        authority: readPubkey(data, CFG_OFF_AUTHORITY),
+        treasury: readPubkey(data, CFG_OFF_TREASURY),
+        poolCreationFee: readU64(data, CFG_OFF_POOL_CREATION_FEE),
+        swapFeeBps: readU16(data, CFG_OFF_SWAP_FEE_BPS),
+        treasuryFeeBps: readU16(data, CFG_OFF_TREASURY_FEE_BPS),
+        totalPools: readU64(data, CFG_OFF_TOTAL_POOLS),
+        isPaused: readBool(data, CFG_OFF_IS_PAUSED),
+        bump: data[CFG_OFF_BUMP],
+        treasuryBump: data[CFG_OFF_TREASURY_BUMP],
+        tokenSwapSolFee: readU64(data, CFG_OFF_TOKEN_SWAP_SOL_FEE),
+        nftSwapSolFee: readU64(data, CFG_OFF_NFT_SWAP_SOL_FEE),
+    };
+}
+//# sourceMappingURL=fetcher.js.map