@syndicure/vault-sdk 0.1.0

package/dist/pool/fetcher.js.map

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

package/dist/pool/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @vault-program/sdk — Pool index for fast lookup and routing.
+ *
+ * Builds in-memory maps from mints → pools, enabling O(1) lookups
+ * and efficient graph traversal for route finding.
+ */
+import { PublicKey } from "@solana/web3.js";
+import { Pool, PoolType } from "../types";
+/** Indexed view of all pools for fast lookups. */
+export interface PoolIndex {
+    /** All pools loaded from chain. */
+    all: Pool[];
+    /** Pool lookup by its PDA address string. */
+    byAddress: Map<string, Pool>;
+    /**
+     * Canonical pair key → Pool.
+     * Key format: `"mintA_base58:mintB_base58"` (already sorted on-chain).
+     */
+    byMintPair: Map<string, Pool>;
+    /**
+     * Mint → all pools that contain that mint (as A or B).
+     * Key is the mint's base58 string.
+     */
+    byMint: Map<string, Pool[]>;
+    /**
+     * For NFT pools: collection mint → pools.
+     * Key is the collection (asset_b_mint for NFT pools) base58 string.
+     */
+    byCollection: Map<string, Pool[]>;
+    /** Pools grouped by type. */
+    byType: Map<PoolType, Pool[]>;
+    /**
+     * Token routing adjacency map.
+     * Key: mint base58 → Set of directly reachable mint base58 strings.
+     * Only includes active TokenToken pools.
+     */
+    tokenGraph: Map<string, Set<string>>;
+}
+/**
+ * Build a PoolIndex from a list of pools.
+ * Only active pools are included in the routing graph.
+ */
+export declare function buildPoolIndex(pools: Pool[]): PoolIndex;
+/**
+ * Retrieve the pool for a canonical mint pair from the index.
+ * Mints are auto-sorted so caller order doesn't matter.
+ */
+export declare function getPoolByMints(index: PoolIndex, mintA: PublicKey, mintB: PublicKey): Pool | undefined;
+/**
+ * Get all unique token mints that appear in active TokenToken pools.
+ */
+export declare function getAllTokenMints(index: PoolIndex): PublicKey[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE1C,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,GAAG,EAAE,IAAI,EAAE,CAAC;IAEZ,6CAA6C;IAC7C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;OAGG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE9B;;;OAGG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5B;;;OAGG;IACH,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAElC,6BAA6B;IAC7B,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9B;;;;OAIG;IACH,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAyCvD;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,GACf,IAAI,GAAG,SAAS,CAKlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,CAS9D"}

package/dist/pool/index.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * @vault-program/sdk — Pool index for fast lookup and routing.
+ *
+ * Builds in-memory maps from mints → pools, enabling O(1) lookups
+ * and efficient graph traversal for route finding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPoolIndex = buildPoolIndex;
+exports.getPoolByMints = getPoolByMints;
+exports.getAllTokenMints = getAllTokenMints;
+const web3_js_1 = require("@solana/web3.js");
+const types_1 = require("../types");
+/**
+ * Build a PoolIndex from a list of pools.
+ * Only active pools are included in the routing graph.
+ */
+function buildPoolIndex(pools) {
+    const byAddress = new Map();
+    const byMintPair = new Map();
+    const byMint = new Map();
+    const byCollection = new Map();
+    const byType = new Map();
+    const tokenGraph = new Map();
+    for (const pool of pools) {
+        const addr = pool.address.toBase58();
+        byAddress.set(addr, pool);
+        // Pair key
+        const mintA = pool.assetAMint.toBase58();
+        const mintB = pool.assetBMint.toBase58();
+        byMintPair.set(`${mintA}:${mintB}`, pool);
+        // By-mint index
+        pushToMap(byMint, mintA, pool);
+        pushToMap(byMint, mintB, pool);
+        // By-type index
+        pushToMap(byType, pool.poolType, pool);
+        // Collection index (NFT pools)
+        if (pool.poolType === types_1.PoolType.TokenNft ||
+            pool.poolType === types_1.PoolType.TokenPnft ||
+            pool.poolType === types_1.PoolType.TokenCoreNft) {
+            pushToMap(byCollection, mintB, pool);
+        }
+        // Token graph (only active TokenToken pools)
+        if (pool.poolType === types_1.PoolType.TokenToken && pool.isActive) {
+            getOrCreate(tokenGraph, mintA).add(mintB);
+            getOrCreate(tokenGraph, mintB).add(mintA);
+        }
+    }
+    return { all: pools, byAddress, byMintPair, byMint, byCollection, byType, tokenGraph };
+}
+// ─── Helpers ─────────────────────────────────────────────────
+function pushToMap(map, key, value) {
+    const arr = map.get(key);
+    if (arr)
+        arr.push(value);
+    else
+        map.set(key, [value]);
+}
+function getOrCreate(map, key) {
+    let set = map.get(key);
+    if (!set) {
+        set = new Set();
+        map.set(key, set);
+    }
+    return set;
+}
+/**
+ * Retrieve the pool for a canonical mint pair from the index.
+ * Mints are auto-sorted so caller order doesn't matter.
+ */
+function getPoolByMints(index, mintA, mintB) {
+    const a = mintA.toBase58();
+    const b = mintB.toBase58();
+    // On-chain: asset_a_mint < asset_b_mint (byte-sorted), but we try both orders
+    return index.byMintPair.get(`${a}:${b}`) ?? index.byMintPair.get(`${b}:${a}`);
+}
+/**
+ * Get all unique token mints that appear in active TokenToken pools.
+ */
+function getAllTokenMints(index) {
+    const mints = new Set();
+    for (const pool of index.all) {
+        if (pool.poolType === types_1.PoolType.TokenToken && pool.isActive) {
+            mints.add(pool.assetAMint.toBase58());
+            mints.add(pool.assetBMint.toBase58());
+        }
+    }
+    return Array.from(mints).map((s) => new web3_js_1.PublicKey(s));
+}
+//# sourceMappingURL=index.js.map

package/dist/pool/index.js.map

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

package/dist/routing/pathfinder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @vault-program/sdk — Route finding via BFS over the pool graph.
+ *
+ * Discovers all paths (up to MAX_HOPS) between two token mints,
+ * using only active TokenToken pools.
+ */
+import { PublicKey } from "@solana/web3.js";
+import { Route } from "../types";
+import { PoolIndex } from "../pool/index";
+/**
+ * Find all token-swap routes from `inputMint` to `outputMint`.
+ *
+ * Uses BFS limited to `maxHops` (default 3). Each route is a
+ * sequence of 1–3 hops through distinct TokenToken pools.
+ *
+ * @returns Array of routes sorted by fewest hops (ascending).
+ *          Empty if no path exists.
+ */
+export declare function findRoutes(index: PoolIndex, inputMint: PublicKey, outputMint: PublicKey, maxHops?: number): Route[];
+/**
+ * Get all token mints reachable from `inputMint` within `maxHops`.
+ * Useful for populating output-token selector UI.
+ */
+export declare function getReachableMints(index: PoolIndex, inputMint: PublicKey, maxHops?: number): PublicKey[];
+//# sourceMappingURL=pathfinder.d.ts.map

package/dist/routing/pathfinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathfinder.d.ts","sourceRoot":"","sources":["../../src/routing/pathfinder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAa,KAAK,EAAO,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,SAAS,EAAkB,MAAM,eAAe,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,SAAS,EACrB,OAAO,GAAE,MAAiB,GACzB,KAAK,EAAE,CA6ET;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,MAAiB,GACzB,SAAS,EAAE,CA4Bb"}

package/dist/routing/pathfinder.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * @vault-program/sdk — Route finding via BFS over the pool graph.
+ *
+ * Discovers all paths (up to MAX_HOPS) between two token mints,
+ * using only active TokenToken pools.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findRoutes = findRoutes;
+exports.getReachableMints = getReachableMints;
+const web3_js_1 = require("@solana/web3.js");
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const index_1 = require("../pool/index");
+/**
+ * Find all token-swap routes from `inputMint` to `outputMint`.
+ *
+ * Uses BFS limited to `maxHops` (default 3). Each route is a
+ * sequence of 1–3 hops through distinct TokenToken pools.
+ *
+ * @returns Array of routes sorted by fewest hops (ascending).
+ *          Empty if no path exists.
+ */
+function findRoutes(index, inputMint, outputMint, maxHops = constants_1.MAX_HOPS) {
+    const inputStr = inputMint.toBase58();
+    const outputStr = outputMint.toBase58();
+    if (inputStr === outputStr)
+        return [];
+    const routes = [];
+    const queue = [
+        { mint: inputStr, hops: [], visitedPools: new Set() },
+    ];
+    while (queue.length > 0) {
+        const node = queue.shift();
+        if (node.hops.length >= maxHops)
+            continue;
+        // Get all mints reachable from current mint
+        const neighbours = index.tokenGraph.get(node.mint);
+        if (!neighbours)
+            continue;
+        for (const nextMintStr of neighbours) {
+            // Find the pool connecting node.mint ↔ nextMintStr
+            const currentMint = new web3_js_1.PublicKey(node.mint);
+            const nextMint = new web3_js_1.PublicKey(nextMintStr);
+            const pool = (0, index_1.getPoolByMints)(index, currentMint, nextMint);
+            if (!pool)
+                continue;
+            if (!pool.isActive)
+                continue;
+            if (pool.poolType !== types_1.PoolType.TokenToken)
+                continue;
+            const poolAddr = pool.address.toBase58();
+            if (node.visitedPools.has(poolAddr))
+                continue;
+            // Determine direction
+            const aToB = pool.assetAMint.toBase58() === node.mint;
+            const hop = {
+                pool,
+                aToB,
+                inputMint: currentMint,
+                outputMint: nextMint,
+            };
+            const newHops = [...node.hops, hop];
+            const newVisited = new Set(node.visitedPools);
+            newVisited.add(poolAddr);
+            if (nextMintStr === outputStr) {
+                // Found a complete route
+                routes.push({
+                    hops: newHops,
+                    inputMint,
+                    outputMint,
+                });
+            }
+            else if (newHops.length < maxHops) {
+                // Continue searching
+                queue.push({
+                    mint: nextMintStr,
+                    hops: newHops,
+                    visitedPools: newVisited,
+                });
+            }
+        }
+    }
+    // Sort: fewest hops first, then by pool address (stable)
+    routes.sort((a, b) => a.hops.length - b.hops.length);
+    return routes;
+}
+/**
+ * Get all token mints reachable from `inputMint` within `maxHops`.
+ * Useful for populating output-token selector UI.
+ */
+function getReachableMints(index, inputMint, maxHops = constants_1.MAX_HOPS) {
+    const inputStr = inputMint.toBase58();
+    const reachable = new Set();
+    const queue = [{ mint: inputStr, depth: 0 }];
+    const visited = new Set([inputStr]);
+    while (queue.length > 0) {
+        const { mint, depth } = queue.shift();
+        if (depth >= maxHops)
+            continue;
+        const neighbours = index.tokenGraph.get(mint);
+        if (!neighbours)
+            continue;
+        for (const next of neighbours) {
+            reachable.add(next);
+            if (!visited.has(next)) {
+                visited.add(next);
+                queue.push({ mint: next, depth: depth + 1 });
+            }
+        }
+    }
+    // Don't include the input mint itself
+    reachable.delete(inputStr);
+    return Array.from(reachable).map((s) => new web3_js_1.PublicKey(s));
+}
+//# sourceMappingURL=pathfinder.js.map

package/dist/routing/pathfinder.js.map

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

package/dist/routing/quote.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @vault-program/sdk — Price quote engine.
+ *
+ * Mirrors the on-chain constant-product math exactly so that
+ * client-side quotes match program execution.
+ *
+ * Fee model (from `math/fees.rs`):
+ *   total_fee      = amount_in × fee_bps / 10_000
+ *   treasury_cut   = total_fee × treasury_fee_bps / 10_000
+ *   lp_cut         = total_fee − treasury_cut
+ *   effective_input = amount_in − total_fee
+ *
+ * AMM output (from `math/constant_product.rs`):
+ *   output = (output_reserve × effective_input) / (input_reserve + effective_input)
+ */
+import BN from "bn.js";
+import { Route, Hop, Pool, FeeBreakdown, HopQuote, SwapQuote } from "../types";
+/**
+ * Calculate fee breakdown.
+ * All division truncates (floor) — matching the on-chain rounding.
+ */
+export declare function calculateFee(amountIn: BN, feeBps: number, treasuryFeeBps: number): FeeBreakdown;
+/**
+ * Constant-product output: dy = (y × dx) / (x + dx).
+ * Truncates (rounds down), matching on-chain behaviour.
+ * Returns zero if any input is zero.
+ */
+export declare function computeOutput(effectiveInput: BN, inputReserve: BN, outputReserve: BN): BN;
+/**
+ * Resolve the effective fee bps for a pool.
+ * Pool-level override (if non-zero) takes precedence over the protocol default.
+ */
+export declare function resolveFeeBps(pool: Pool, protocolFeeBps: number): number;
+/** Quote a single hop. */
+export declare function quoteHop(hop: Hop, amountIn: BN, protocolFeeBps: number, treasuryFeeBps: number): HopQuote;
+/**
+ * Quote a complete swap route.
+ *
+ * @param route           The route (1–3 hops) to quote.
+ * @param amountIn        Raw input amount.
+ * @param protocolFeeBps  Protocol default swap fee (from ProtocolConfig).
+ * @param treasuryFeeBps  Treasury's share of the fee (from ProtocolConfig).
+ * @param slippageBps     Slippage tolerance in bps (e.g. 50 = 0.5%).
+ */
+export declare function quoteRoute(route: Route, amountIn: BN, protocolFeeBps: number, treasuryFeeBps: number, slippageBps?: number): SwapQuote;
+/**
+ * Find the best route and return its quote.
+ *
+ * Evaluates all provided routes and returns the one with the
+ * highest expected output.
+ */
+export declare function bestQuote(routes: Route[], amountIn: BN, protocolFeeBps: number, treasuryFeeBps: number, slippageBps?: number): SwapQuote | null;
+//# sourceMappingURL=quote.d.ts.map

package/dist/routing/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../src/routing/quote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB,OAAO,EACL,KAAK,EACL,GAAG,EACH,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,SAAS,EACV,MAAM,UAAU,CAAC;AAIlB;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,EAAE,EACZ,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,YAAY,CASd;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,EAAE,EAClB,YAAY,EAAE,EAAE,EAChB,aAAa,EAAE,EAAE,GAChB,EAAE,CAWJ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAExE;AAID,0BAA0B;AAC1B,wBAAgB,QAAQ,CACtB,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,EAAE,EACZ,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,QAAQ,CA2BV;AAID;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,EAAE,EACZ,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,WAAW,GAAE,MAAW,GACvB,SAAS,CA+BX;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,EAAE,EACZ,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,GAAG,IAAI,CAalB"}

package/dist/routing/quote.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * @vault-program/sdk — Price quote engine.
+ *
+ * Mirrors the on-chain constant-product math exactly so that
+ * client-side quotes match program execution.
+ *
+ * Fee model (from `math/fees.rs`):
+ *   total_fee      = amount_in × fee_bps / 10_000
+ *   treasury_cut   = total_fee × treasury_fee_bps / 10_000
+ *   lp_cut         = total_fee − treasury_cut
+ *   effective_input = amount_in − total_fee
+ *
+ * AMM output (from `math/constant_product.rs`):
+ *   output = (output_reserve × effective_input) / (input_reserve + effective_input)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateFee = calculateFee;
+exports.computeOutput = computeOutput;
+exports.resolveFeeBps = resolveFeeBps;
+exports.quoteHop = quoteHop;
+exports.quoteRoute = quoteRoute;
+exports.bestQuote = bestQuote;
+const bn_js_1 = __importDefault(require("bn.js"));
+const constants_1 = require("../constants");
+// ─── Core math (matches on-chain exactly) ────────────────────
+/**
+ * Calculate fee breakdown.
+ * All division truncates (floor) — matching the on-chain rounding.
+ */
+function calculateFee(amountIn, feeBps, treasuryFeeBps) {
+    const denom = new bn_js_1.default(constants_1.BPS_DENOMINATOR);
+    const totalFee = amountIn.mul(new bn_js_1.default(feeBps)).div(denom);
+    const treasuryCut = totalFee.mul(new bn_js_1.default(treasuryFeeBps)).div(denom);
+    const lpCut = totalFee.sub(treasuryCut);
+    const effectiveInput = amountIn.sub(totalFee);
+    return { totalFee, treasuryCut, lpCut, effectiveInput };
+}
+/**
+ * Constant-product output: dy = (y × dx) / (x + dx).
+ * Truncates (rounds down), matching on-chain behaviour.
+ * Returns zero if any input is zero.
+ */
+function computeOutput(effectiveInput, inputReserve, outputReserve) {
+    if (effectiveInput.isZero() ||
+        inputReserve.isZero() ||
+        outputReserve.isZero()) {
+        return new bn_js_1.default(0);
+    }
+    const numerator = outputReserve.mul(effectiveInput);
+    const denominator = inputReserve.add(effectiveInput);
+    return numerator.div(denominator);
+}
+/**
+ * Resolve the effective fee bps for a pool.
+ * Pool-level override (if non-zero) takes precedence over the protocol default.
+ */
+function resolveFeeBps(pool, protocolFeeBps) {
+    return pool.poolFeeBps > 0 ? pool.poolFeeBps : protocolFeeBps;
+}
+// ─── Hop quote ───────────────────────────────────────────────
+/** Quote a single hop. */
+function quoteHop(hop, amountIn, protocolFeeBps, treasuryFeeBps) {
+    const pool = hop.pool;
+    const [inputReserve, outputReserve] = hop.aToB
+        ? [pool.reserveA, pool.reserveB]
+        : [pool.reserveB, pool.reserveA];
+    const feeBps = resolveFeeBps(pool, protocolFeeBps);
+    const fee = calculateFee(amountIn, feeBps, treasuryFeeBps);
+    const outputAmount = computeOutput(fee.effectiveInput, inputReserve, outputReserve);
+    // Price impact: compare execution price vs spot price
+    // spot = outputReserve / inputReserve
+    // exec = outputAmount / amountIn
+    // impact = 1 − exec/spot = 1 − (outputAmount × inputReserve) / (amountIn × outputReserve)
+    let priceImpact = 0;
+    if (!amountIn.isZero() && !outputReserve.isZero()) {
+        const spotNumerator = outputAmount.mul(inputReserve);
+        const spotDenominator = amountIn.mul(outputReserve);
+        if (!spotDenominator.isZero()) {
+            // Use floating point for the impact fraction
+            const ratio = Number(spotNumerator.toString()) / Number(spotDenominator.toString());
+            priceImpact = Math.max(0, 1 - ratio);
+        }
+    }
+    return { inputAmount: amountIn, outputAmount, fee, priceImpact };
+}
+// ─── Full route quote ────────────────────────────────────────
+/**
+ * Quote a complete swap route.
+ *
+ * @param route           The route (1–3 hops) to quote.
+ * @param amountIn        Raw input amount.
+ * @param protocolFeeBps  Protocol default swap fee (from ProtocolConfig).
+ * @param treasuryFeeBps  Treasury's share of the fee (from ProtocolConfig).
+ * @param slippageBps     Slippage tolerance in bps (e.g. 50 = 0.5%).
+ */
+function quoteRoute(route, amountIn, protocolFeeBps, treasuryFeeBps, slippageBps = 50) {
+    let currentAmount = amountIn;
+    const hopQuotes = [];
+    let totalFees = new bn_js_1.default(0);
+    for (const hop of route.hops) {
+        const hq = quoteHop(hop, currentAmount, protocolFeeBps, treasuryFeeBps);
+        hopQuotes.push(hq);
+        totalFees = totalFees.add(hq.fee.totalFee);
+        currentAmount = hq.outputAmount;
+    }
+    // Aggregate price impact: 1 − ∏(1 − hop_impact)
+    const totalPriceImpact = 1 - hopQuotes.reduce((acc, hq) => acc * (1 - hq.priceImpact), 1);
+    // Minimum output with slippage tolerance
+    const slippageDenom = new bn_js_1.default(constants_1.BPS_DENOMINATOR);
+    const minimumOutput = currentAmount
+        .mul(slippageDenom.sub(new bn_js_1.default(slippageBps)))
+        .div(slippageDenom);
+    return {
+        route,
+        amountIn,
+        expectedOutput: currentAmount,
+        minimumOutput,
+        hopQuotes,
+        totalPriceImpact,
+        totalFees,
+    };
+}
+/**
+ * Find the best route and return its quote.
+ *
+ * Evaluates all provided routes and returns the one with the
+ * highest expected output.
+ */
+function bestQuote(routes, amountIn, protocolFeeBps, treasuryFeeBps, slippageBps) {
+    if (routes.length === 0)
+        return null;
+    let best = null;
+    for (const route of routes) {
+        const quote = quoteRoute(route, amountIn, protocolFeeBps, treasuryFeeBps, slippageBps);
+        if (!best || quote.expectedOutput.gt(best.expectedOutput)) {
+            best = quote;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=quote.js.map

package/dist/routing/quote.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @vault-program/sdk — Core types for pool, config, and routing.
+ */
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+export declare enum PoolType {
+    TokenToken = 0,
+    TokenNft = 1,
+    TokenPnft = 2,
+    TokenCoreNft = 3
+}
+export interface ProtocolConfig {
+    authority: PublicKey;
+    treasury: PublicKey;
+    poolCreationFee: BN;
+    swapFeeBps: number;
+    treasuryFeeBps: number;
+    totalPools: BN;
+    isPaused: boolean;
+    bump: number;
+    treasuryBump: number;
+    tokenSwapSolFee: BN;
+    nftSwapSolFee: BN;
+}
+export interface Pool {
+    /** Pool PDA address (added client-side, not on-chain). */
+    address: PublicKey;
+    creator: PublicKey;
+    assetAMint: PublicKey;
+    assetBMint: PublicKey;
+    poolType: PoolType;
+    vaultA: PublicKey;
+    vaultB: PublicKey;
+    nftEscrowCount: number;
+    lpMint: PublicKey;
+    totalLpSupply: BN;
+    reserveA: BN;
+    reserveB: BN;
+    cumulativeFeeA: BN;
+    cumulativeFeeB: BN;
+    feePerShareA: BN;
+    feePerShareB: BN;
+    lastPrice: BN;
+    isLocked: boolean;
+    isActive: boolean;
+    assetAIsToken2022: boolean;
+    assetBIsToken2022: boolean;
+    poolFeeBps: number;
+    basePrice: BN;
+    curveDelta: BN;
+    createdAt: BN;
+    bump: number;
+}
+export interface LiquidityPosition {
+    owner: PublicKey;
+    pool: PublicKey;
+    lpTokensHeld: BN;
+    depositedA: BN;
+    depositedB: BN;
+    feeDebtA: BN;
+    feeDebtB: BN;
+    lastUpdated: BN;
+    bump: number;
+}
+/** A single leg of a swap route through one pool. */
+export interface Hop {
+    pool: Pool;
+    /** true = swap A→B in this pool; false = B→A. */
+    aToB: boolean;
+    inputMint: PublicKey;
+    outputMint: PublicKey;
+}
+/** A complete route from input mint to output mint (1–3 hops). */
+export interface Route {
+    hops: Hop[];
+    inputMint: PublicKey;
+    outputMint: PublicKey;
+}
+/** Fee breakdown for a single hop. */
+export interface FeeBreakdown {
+    totalFee: BN;
+    treasuryCut: BN;
+    lpCut: BN;
+    effectiveInput: BN;
+}
+/** Quote result for a single hop. */
+export interface HopQuote {
+    inputAmount: BN;
+    outputAmount: BN;
+    fee: FeeBreakdown;
+    /** Price impact as a fraction (0.01 = 1%). */
+    priceImpact: number;
+}
+/** Full swap quote across all hops. */
+export interface SwapQuote {
+    route: Route;
+    amountIn: BN;
+    expectedOutput: BN;
+    minimumOutput: BN;
+    hopQuotes: HopQuote[];
+    /** Aggregate price impact (1 − ∏(1 − hop_impact)). */
+    totalPriceImpact: number;
+    totalFees: BN;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AAIvB,oBAAY,QAAQ;IAClB,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,SAAS,IAAI;IACb,YAAY,IAAI;CACjB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;IACpB,eAAe,EAAE,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,EAAE,CAAC;IACpB,aAAa,EAAE,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,0DAA0D;IAC1D,OAAO,EAAE,SAAS,CAAC;IAEnB,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,SAAS,CAAC;IACtB,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,EAAE,CAAC;IAClB,QAAQ,EAAE,EAAE,CAAC;IACb,QAAQ,EAAE,EAAE,CAAC;IACb,cAAc,EAAE,EAAE,CAAC;IACnB,cAAc,EAAE,EAAE,CAAC;IACnB,YAAY,EAAE,EAAE,CAAC;IACjB,YAAY,EAAE,EAAE,CAAC;IACjB,SAAS,EAAE,EAAE,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,EAAE,CAAC;IACd,UAAU,EAAE,EAAE,CAAC;IACf,SAAS,EAAE,EAAE,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,EAAE,CAAC;IACjB,UAAU,EAAE,EAAE,CAAC;IACf,UAAU,EAAE,EAAE,CAAC;IACf,QAAQ,EAAE,EAAE,CAAC;IACb,QAAQ,EAAE,EAAE,CAAC;IACb,WAAW,EAAE,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,qDAAqD;AACrD,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;CACvB;AAID,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,EAAE,CAAC;IACb,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE,EAAE,CAAC;IACV,cAAc,EAAE,EAAE,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,EAAE,CAAC;IAChB,YAAY,EAAE,EAAE,CAAC;IACjB,GAAG,EAAE,YAAY,CAAC;IAClB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,EAAE,CAAC;IACb,cAAc,EAAE,EAAE,CAAC;IACnB,aAAa,EAAE,EAAE,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,EAAE,CAAC;CACf"}