@cubee_ee/sdk 0.1.0

package/dist/math/singleToken.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeAllocations = computeAllocations;
+exports.computeTwoTokenOptimalAllocations = computeTwoTokenOptimalAllocations;
+exports.capDepositAmountsToLpRatio = capDepositAmountsToLpRatio;
+const fixedPoint_1 = require("./fixedPoint");
+const cubicMath_1 = require("./cubicMath");
+const slippage_1 = require("./slippage");
+const config_1 = require("../config");
+/**
+ * Port of stld `compute_allocations` from
+ * `contracts/programs/single-token-liquidity/src/math.rs`.
+ *
+ * W_i = weight_i * factBalance_i / virtBalance_i (dimensionless concentration).
+ * share_i = W_i / ΣW. amount_alloc[i] = amountIn * share_i.
+ *
+ * Integer truncation of per-token amounts routes the remainder to the
+ * input-token slot so Σ allocations == amountIn exactly.
+ */
+function computeAllocations(params) {
+    const { actualBalances, virtualBalances, weightsBps, amountIn, tokenInIndex } = params;
+    const n = actualBalances.length;
+    if (n !== virtualBalances.length || n !== weightsBps.length) {
+        throw new Error("computeAllocations: length mismatch");
+    }
+    if (tokenInIndex < 0 || tokenInIndex >= n) {
+        throw new Error("computeAllocations: tokenInIndex out of range");
+    }
+    const wScaled = [];
+    for (let i = 0; i < n; i++) {
+        if (virtualBalances[i] <= 0n) {
+            throw new Error(`computeAllocations: virtualBalance[${i}] must be positive`);
+        }
+        const w = (BigInt(weightsBps[i]) * actualBalances[i] * fixedPoint_1.ONE) / (virtualBalances[i] * 10000n);
+        wScaled.push(w);
+    }
+    const sumW = wScaled.reduce((a, b) => a + b, 0n);
+    if (sumW === 0n) {
+        throw new Error("computeAllocations: pool not seeded (ΣW = 0)");
+    }
+    const allocations = wScaled.map((w) => (amountIn * w) / sumW);
+    const sumAlloc = allocations.reduce((a, b) => a + b, 0n);
+    if (sumAlloc < amountIn) {
+        allocations[tokenInIndex] += amountIn - sumAlloc;
+    }
+    return { allocations, wScaled, sumW };
+}
+function swapFeeAmount(amount, swapFeeRate) {
+    return (amount * BigInt(swapFeeRate)) / BigInt(config_1.SWAP_FEE_PRECISION);
+}
+function amountAfterSwapFee(amount, swapFeeRate) {
+    const fee = swapFeeAmount(amount, swapFeeRate);
+    if (swapFeeRate > 0 && fee === 0n) {
+        throw new Error("computeTwoTokenOptimalAllocations: swap amount too small, fee rounds to zero");
+    }
+    return amount - fee;
+}
+function protocolFeeAmount(swapFee, protocolFeeRate) {
+    return (swapFee * BigInt(protocolFeeRate)) / BigInt(config_1.PROTOCOL_FEE_PRECISION);
+}
+function scoreTwoTokenSwap(params) {
+    const { actualBalances, virtualBalances, protocolFeesOwed, weightsBps, amountIn, tokenInIndex, swapToOther, swapFeeRate, protocolFeeRate, } = params;
+    const other = tokenInIndex === 0 ? 1 : 0;
+    const remainingInput = amountIn - swapToOther;
+    if (swapToOther <= 0n || remainingInput <= 0n)
+        return { score: 0n, amountOut: 0n };
+    let afterFee;
+    try {
+        afterFee = amountAfterSwapFee(swapToOther, swapFeeRate);
+    }
+    catch {
+        return { score: 0n, amountOut: 0n };
+    }
+    const swapFee = swapToOther - afterFee;
+    const protocolFee = protocolFeeAmount(swapFee, protocolFeeRate);
+    const inLp = (0, slippage_1.lpBalances)(actualBalances[tokenInIndex], virtualBalances[tokenInIndex], protocolFeesOwed[tokenInIndex]);
+    const outLp = (0, slippage_1.lpBalances)(actualBalances[other], virtualBalances[other], protocolFeesOwed[other]);
+    let amountOut;
+    try {
+        amountOut = (0, cubicMath_1.calcOutGivenIn)({
+            virtualBalanceIn: inLp.lpVirtual,
+            weightInBps: BigInt(weightsBps[tokenInIndex]),
+            virtualBalanceOut: outLp.lpVirtual,
+            weightOutBps: BigInt(weightsBps[other]),
+            amountIn: afterFee,
+            actualBalanceOut: outLp.lpActual,
+        });
+    }
+    catch {
+        return { score: 0n, amountOut: 0n };
+    }
+    if (amountOut <= 0n || amountOut >= outLp.lpActual)
+        return { score: 0n, amountOut };
+    const lpInAfter = inLp.lpActual + swapToOther - protocolFee;
+    const lpOutAfter = outLp.lpActual - amountOut;
+    if (lpInAfter <= 0n || lpOutAfter <= 0n)
+        return { score: 0n, amountOut };
+    const ratioIn = (remainingInput * fixedPoint_1.ONE) / lpInAfter;
+    const ratioOut = (amountOut * fixedPoint_1.ONE) / lpOutAfter;
+    return { score: ratioIn < ratioOut ? ratioIn : ratioOut, amountOut };
+}
+function computeTwoTokenOptimalAllocations(params) {
+    const { amountIn, tokenInIndex } = params;
+    if (amountIn <= 1n) {
+        throw new Error("computeTwoTokenOptimalAllocations: amountIn too small");
+    }
+    let low = 1n;
+    let high = amountIn - 1n;
+    for (let i = 0; i < 32 && low < high; i++) {
+        const mid = low + (high - low) / 2n;
+        const current = scoreTwoTokenSwap({ ...params, swapToOther: mid }).score;
+        const next = scoreTwoTokenSwap({
+            ...params,
+            swapToOther: mid + 1n < amountIn ? mid + 1n : amountIn - 1n,
+        }).score;
+        if (next >= current)
+            low = mid + 1n;
+        else
+            high = mid;
+    }
+    const center = low < 1n ? 1n : low >= amountIn ? amountIn - 1n : low;
+    let bestSwap = center;
+    let bestScore = 0n;
+    const start = center > 8n ? center - 8n : 1n;
+    const end = center + 8n < amountIn ? center + 8n : amountIn - 1n;
+    for (let swapToOther = start; swapToOther <= end; swapToOther++) {
+        const { score, amountOut } = scoreTwoTokenSwap({ ...params, swapToOther });
+        if (amountOut > 0n && score > bestScore) {
+            bestScore = score;
+            bestSwap = swapToOther;
+        }
+    }
+    if (bestScore === 0n) {
+        throw new Error("computeTwoTokenOptimalAllocations: amount too small");
+    }
+    const allocations = [0n, 0n];
+    const other = tokenInIndex === 0 ? 1 : 0;
+    allocations[tokenInIndex] = amountIn - bestSwap;
+    allocations[other] = bestSwap;
+    return { allocations, wScaled: [], sumW: bestScore };
+}
+/**
+ * Mirror of stld `cap_deposit_amounts_to_lp_ratio`.
+ *
+ * `add_liquidity` mints BPT from the minimum ratio against LP-accessible
+ * balances (`actual - protocolFeesOwed`). Any helper-held amount above that
+ * common ratio would be donated, so the helper deposits the capped basket and
+ * refunds the rest.
+ */
+function capDepositAmountsToLpRatio(params) {
+    const { helperBalances, actualBalances, protocolFeesOwed } = params;
+    const n = helperBalances.length;
+    if (n !== actualBalances.length || n !== protocolFeesOwed.length) {
+        throw new Error("capDepositAmountsToLpRatio: length mismatch");
+    }
+    const lpBalancesForAdd = actualBalances.map((actual, i) => actual > protocolFeesOwed[i] ? actual - protocolFeesOwed[i] : 0n);
+    let ratioMin = null;
+    for (let i = 0; i < n; i++) {
+        if (actualBalances[i] > 0n && lpBalancesForAdd[i] === 0n) {
+            throw new Error("capDepositAmountsToLpRatio: live token has no LP claim");
+        }
+        if (lpBalancesForAdd[i] === 0n)
+            continue;
+        if (helperBalances[i] <= 0n) {
+            throw new Error("capDepositAmountsToLpRatio: amount too small");
+        }
+        const ratio = (helperBalances[i] * fixedPoint_1.ONE) / lpBalancesForAdd[i];
+        ratioMin = ratioMin === null || ratio < ratioMin ? ratio : ratioMin;
+    }
+    if (ratioMin === null || ratioMin === 0n) {
+        throw new Error("capDepositAmountsToLpRatio: amount too small");
+    }
+    const depositAmounts = lpBalancesForAdd.map((lp, i) => {
+        if (lp === 0n)
+            return 0n;
+        const amount = (lp * ratioMin) / fixedPoint_1.ONE;
+        if (amount <= 0n) {
+            throw new Error("capDepositAmountsToLpRatio: amount too small");
+        }
+        return amount > helperBalances[i] ? helperBalances[i] : amount;
+    });
+    const refundAmounts = helperBalances.map((balance, i) => balance > depositAmounts[i] ? balance - depositAmounts[i] : 0n);
+    return { depositAmounts, refundAmounts, lpBalancesForAdd };
+}
+//# sourceMappingURL=singleToken.js.map

package/dist/math/singleToken.js.map

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

package/dist/math/slippage.d.ts

@@ -0,0 +1,24 @@
+/**
+ * min_out = expected * (SLIPPAGE_PRECISION - slippage_hbps) / SLIPPAGE_PRECISION.
+ * Matches `apply_slippage` in stld's math.rs.
+ */
+export declare function applySlippage(expected: bigint, slippageHbps: number): bigint;
+/**
+ * fee = amount * rate / SWAP_FEE_PRECISION. Returns amount - fee.
+ * Matches `apply_swap_fee`.
+ */
+export declare function applySwapFee(amount: bigint, swapFeeRate: number): bigint;
+/**
+ * LP-accessible balances: lp_actual = actual - pfo; lp_virtual scaled to
+ * match. Used by the off-chain single-token quote in `math/singleToken`.
+ */
+export declare function lpBalances(actual: bigint, virtualBal: bigint, pfo: bigint): {
+    lpActual: bigint;
+    lpVirtual: bigint;
+};
+/**
+ * Price impact in hundredths of basis point: (spot - actual) / spot × 1_000_000.
+ * 0 if spot is 0.
+ */
+export declare function priceImpactHbps(spot: bigint, actual: bigint): number;
+//# sourceMappingURL=slippage.d.ts.map

package/dist/math/slippage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slippage.d.ts","sourceRoot":"","sources":["../../src/math/slippage.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOxE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAKnH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/math/slippage.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySlippage = applySlippage;
+exports.applySwapFee = applySwapFee;
+exports.lpBalances = lpBalances;
+exports.priceImpactHbps = priceImpactHbps;
+const config_1 = require("../config");
+/**
+ * min_out = expected * (SLIPPAGE_PRECISION - slippage_hbps) / SLIPPAGE_PRECISION.
+ * Matches `apply_slippage` in stld's math.rs.
+ */
+function applySlippage(expected, slippageHbps) {
+    if (slippageHbps < 0 || slippageHbps > config_1.SLIPPAGE_PRECISION) {
+        throw new Error(`slippage: ${slippageHbps} out of [0, ${config_1.SLIPPAGE_PRECISION}]`);
+    }
+    const keep = BigInt(config_1.SLIPPAGE_PRECISION - slippageHbps);
+    return (expected * keep) / BigInt(config_1.SLIPPAGE_PRECISION);
+}
+/**
+ * fee = amount * rate / SWAP_FEE_PRECISION. Returns amount - fee.
+ * Matches `apply_swap_fee`.
+ */
+function applySwapFee(amount, swapFeeRate) {
+    if (swapFeeRate < 0)
+        throw new Error("swapFee: negative rate");
+    const fee = (amount * BigInt(swapFeeRate)) / BigInt(config_1.SWAP_FEE_PRECISION);
+    if (swapFeeRate > 0 && fee === 0n) {
+        throw new Error("swapFee: amount too small, fee rounds to zero");
+    }
+    return amount - fee;
+}
+/**
+ * LP-accessible balances: lp_actual = actual - pfo; lp_virtual scaled to
+ * match. Used by the off-chain single-token quote in `math/singleToken`.
+ */
+function lpBalances(actual, virtualBal, pfo) {
+    const lpActual = actual >= pfo ? actual - pfo : 0n;
+    const lpVirtual = actual > 0n ? (virtualBal * lpActual) / actual : virtualBal;
+    return { lpActual, lpVirtual };
+}
+/**
+ * Price impact in hundredths of basis point: (spot - actual) / spot × 1_000_000.
+ * 0 if spot is 0.
+ */
+function priceImpactHbps(spot, actual) {
+    if (spot <= 0n)
+        return 0;
+    if (actual >= spot)
+        return 0;
+    const diff = spot - actual;
+    const hbps = (diff * BigInt(config_1.SLIPPAGE_PRECISION)) / spot;
+    return Number(hbps);
+}
+//# sourceMappingURL=slippage.js.map

package/dist/math/slippage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slippage.js","sourceRoot":"","sources":["../../src/math/slippage.ts"],"names":[],"mappings":";;AAMA,sCAMC;AAMD,oCAOC;AAMD,gCAKC;AAMD,0CAMC;AAhDD,sCAAmE;AAEnE;;;GAGG;AACH,SAAgB,aAAa,CAAC,QAAgB,EAAE,YAAoB;IAClE,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,2BAAkB,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,eAAe,2BAAkB,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,2BAAkB,GAAG,YAAY,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,2BAAkB,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,MAAc,EAAE,WAAmB;IAC9D,IAAI,WAAW,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,2BAAkB,CAAC,CAAC;IACxE,IAAI,WAAW,GAAG,CAAC,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,GAAG,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,MAAc,EAAE,UAAkB,EAAE,GAAW;IACxE,MAAM,QAAQ,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,MAAM,SAAS,GACb,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,IAAY,EAAE,MAAc;IAC1D,IAAI,IAAI,IAAI,EAAE;QAAE,OAAO,CAAC,CAAC;IACzB,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,2BAAkB,CAAC,CAAC,GAAG,IAAI,CAAC;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/math/weightedMath.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Validate a weight vector. Must sum exactly to 10_000 (WEIGHT_SCALE) and
+ * every entry must be in [MIN_WEIGHT, MAX_WEIGHT].
+ */
+export declare function validateWeights(weights: number[]): void;
+/**
+ * Weighted spot price of token_out priced in token_in, normalised to 18
+ * decimals. Used only for display; on-chain quoting uses calcOutGivenIn.
+ */
+export declare function calcSpotPrice(params: {
+    balanceIn: bigint;
+    weightInBps: bigint;
+    balanceOut: bigint;
+    weightOutBps: bigint;
+    decimalsIn: number;
+    decimalsOut: number;
+}): bigint;
+//# sourceMappingURL=weightedMath.d.ts.map

package/dist/math/weightedMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weightedMath.d.ts","sourceRoot":"","sources":["../../src/math/weightedMath.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAiBvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAWT"}

package/dist/math/weightedMath.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWeights = validateWeights;
+exports.calcSpotPrice = calcSpotPrice;
+const config_1 = require("../config");
+/**
+ * Validate a weight vector. Must sum exactly to 10_000 (WEIGHT_SCALE) and
+ * every entry must be in [MIN_WEIGHT, MAX_WEIGHT].
+ */
+function validateWeights(weights) {
+    if (!Array.isArray(weights) || weights.length < 2) {
+        throw new Error("weightedMath: at least 2 weights required");
+    }
+    let sum = 0;
+    for (const w of weights) {
+        if (!Number.isInteger(w)) {
+            throw new Error("weightedMath: weights must be integers (bps)");
+        }
+        if (w < config_1.MIN_WEIGHT || w > config_1.MAX_WEIGHT) {
+            throw new Error(`weightedMath: weight ${w} out of [${config_1.MIN_WEIGHT}, ${config_1.MAX_WEIGHT}]`);
+        }
+        sum += w;
+    }
+    if (sum !== config_1.WEIGHT_SCALE) {
+        throw new Error(`weightedMath: weights sum to ${sum}, expected ${config_1.WEIGHT_SCALE}`);
+    }
+}
+/**
+ * Weighted spot price of token_out priced in token_in, normalised to 18
+ * decimals. Used only for display; on-chain quoting uses calcOutGivenIn.
+ */
+function calcSpotPrice(params) {
+    const { balanceIn, weightInBps, balanceOut, weightOutBps, decimalsIn, decimalsOut } = params;
+    const scaleIn = 10n ** BigInt(18 - decimalsIn);
+    const scaleOut = 10n ** BigInt(18 - decimalsOut);
+    const bI = balanceIn * scaleIn;
+    const bO = balanceOut * scaleOut;
+    if (bO === 0n || weightOutBps === 0n)
+        return 0n;
+    // price = (bI / wI) / (bO / wO)
+    const numer = bI * weightOutBps * 10n ** 18n;
+    const denom = bO * weightInBps;
+    return numer / denom;
+}
+//# sourceMappingURL=weightedMath.js.map

package/dist/math/weightedMath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weightedMath.js","sourceRoot":"","sources":["../../src/math/weightedMath.ts"],"names":[],"mappings":";;AAMA,0CAiBC;AAMD,sCAkBC;AA/CD,sCAAiE;AAEjE;;;GAGG;AACH,SAAgB,eAAe,CAAC,OAAiB;IAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,GAAG,mBAAU,IAAI,CAAC,GAAG,mBAAU,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,YAAY,mBAAU,KAAK,mBAAU,GAAG,CAAC,CAAC;QACrF,CAAC;QACD,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,qBAAY,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,cAAc,qBAAY,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,MAO7B;IACC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC7F,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,GAAG,IAAI,MAAM,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC;IAC/B,MAAM,EAAE,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,KAAK,EAAE,IAAI,YAAY,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAChD,gCAAgC;IAChC,MAAM,KAAK,GAAG,EAAE,GAAG,YAAY,GAAG,GAAG,IAAI,GAAG,CAAC;IAC7C,MAAM,KAAK,GAAG,EAAE,GAAG,WAAW,CAAC;IAC/B,OAAO,KAAK,GAAG,KAAK,CAAC;AACvB,CAAC"}

package/dist/parsers/borsh.d.ts

@@ -0,0 +1,24 @@
+import BN from "bn.js";
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Minimal Borsh-compatible reader. Enough to decode the Cube contract
+ * event structs (Pubkey × N, u8/u16/u32/u64/i64, bool, Vec<u64>,
+ * Vec<Pubkey>). Avoids pulling a borsh dep into the SDK's hot path.
+ */
+export declare class BorshReader {
+    private readonly buf;
+    private offset;
+    constructor(buf: Buffer);
+    remaining(): number;
+    skip(n: number): void;
+    u8(): number;
+    u16(): number;
+    u32(): number;
+    u64(): BN;
+    i64(): BN;
+    bool(): boolean;
+    pubkey(): PublicKey;
+    vecU64(): BN[];
+    vecPubkey(): PublicKey[];
+}
+//# sourceMappingURL=borsh.d.ts.map

package/dist/parsers/borsh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"borsh.d.ts","sourceRoot":"","sources":["../../src/parsers/borsh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,WAAW;IAEV,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,OAAO,CAAC,MAAM,CAAK;gBACU,GAAG,EAAE,MAAM;IAExC,SAAS,IAAI,MAAM;IAInB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrB,EAAE,IAAI,MAAM;IAMZ,GAAG,IAAI,MAAM;IAMb,GAAG,IAAI,MAAM;IAMb,GAAG,IAAI,EAAE;IAMT,GAAG,IAAI,EAAE;IAYT,IAAI,IAAI,OAAO;IAIf,MAAM,IAAI,SAAS;IAMnB,MAAM,IAAI,EAAE,EAAE;IAOd,SAAS,IAAI,SAAS,EAAE;CAMzB"}

package/dist/parsers/borsh.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BorshReader = void 0;
+const bn_js_1 = __importDefault(require("bn.js"));
+const web3_js_1 = require("@solana/web3.js");
+/**
+ * Minimal Borsh-compatible reader. Enough to decode the Cube contract
+ * event structs (Pubkey × N, u8/u16/u32/u64/i64, bool, Vec<u64>,
+ * Vec<Pubkey>). Avoids pulling a borsh dep into the SDK's hot path.
+ */
+class BorshReader {
+    constructor(buf) {
+        this.buf = buf;
+        this.offset = 0;
+    }
+    remaining() {
+        return this.buf.length - this.offset;
+    }
+    skip(n) {
+        this.offset += n;
+    }
+    u8() {
+        const v = this.buf.readUInt8(this.offset);
+        this.offset += 1;
+        return v;
+    }
+    u16() {
+        const v = this.buf.readUInt16LE(this.offset);
+        this.offset += 2;
+        return v;
+    }
+    u32() {
+        const v = this.buf.readUInt32LE(this.offset);
+        this.offset += 4;
+        return v;
+    }
+    u64() {
+        const slice = this.buf.slice(this.offset, this.offset + 8);
+        this.offset += 8;
+        return new bn_js_1.default(slice, "le");
+    }
+    i64() {
+        const slice = this.buf.slice(this.offset, this.offset + 8);
+        this.offset += 8;
+        // i64 is two's complement little-endian — treat as signed.
+        const bn = new bn_js_1.default(slice, "le");
+        if (slice[7] & 0x80) {
+            // top bit set → negative: subtract 2^64
+            return bn.sub(new bn_js_1.default(2).pow(new bn_js_1.default(64)));
+        }
+        return bn;
+    }
+    bool() {
+        return this.u8() !== 0;
+    }
+    pubkey() {
+        const slice = this.buf.slice(this.offset, this.offset + 32);
+        this.offset += 32;
+        return new web3_js_1.PublicKey(slice);
+    }
+    vecU64() {
+        const len = this.u32();
+        const out = [];
+        for (let i = 0; i < len; i++)
+            out.push(this.u64());
+        return out;
+    }
+    vecPubkey() {
+        const len = this.u32();
+        const out = [];
+        for (let i = 0; i < len; i++)
+            out.push(this.pubkey());
+        return out;
+    }
+}
+exports.BorshReader = BorshReader;
+//# sourceMappingURL=borsh.js.map

package/dist/parsers/borsh.js.map

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

package/dist/parsers/events.d.ts

@@ -0,0 +1,3 @@
+import { CubicPoolEvent } from "../types/events";
+export declare function parseCubicPoolEvents(logs: string[]): CubicPoolEvent[];
+//# sourceMappingURL=events.d.ts.map

package/dist/parsers/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/parsers/events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAiCjD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CA0BrE"}

package/dist/parsers/events.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCubicPoolEvents = parseCubicPoolEvents;
+const web3_js_1 = require("@solana/web3.js");
+const borsh_1 = require("./borsh");
+/**
+ * Anchor event log format (base64-encoded after `Program data:`):
+ *   [ 8-byte discriminator | borsh-encoded event struct ]
+ *
+ * Discriminators for cubic-pool and single-token-liquidity are hard-coded
+ * here from the generated IDL. Never guess from event name — the Anchor
+ * macro actually uses `sha256("event:<Name>")[0..8]`, but for robustness
+ * we pin the bytes.
+ */
+// Cubic-pool event discriminators (from target/idl/cubic_pool.json):
+const DISC = {
+    PoolInitialized: Buffer.from([100, 118, 173, 87, 12, 198, 254, 229]),
+    Swap: Buffer.from([81, 108, 227, 190, 205, 208, 10, 196]),
+    LiquidityAdded: Buffer.from([154, 26, 221, 108, 238, 64, 217, 161]),
+    LiquidityRemoved: Buffer.from([225, 105, 216, 39, 124, 116, 169, 189]),
+    ProtocolFeesCollected: Buffer.from([165, 34, 125, 155, 15, 86, 99, 191]),
+    SwapFeeRateUpdated: Buffer.from([101, 132, 24, 255, 91, 253, 227, 101]),
+    ProtocolFeeRateUpdated: Buffer.from([189, 56, 7, 65, 0, 95, 192, 6]),
+    PoolEnabledUpdated: Buffer.from([101, 47, 3, 240, 197, 181, 236, 142]),
+    SwapsEnabledUpdated: Buffer.from([55, 116, 118, 138, 102, 26, 227, 223]),
+    DebugLiquidityWithdrawn: Buffer.from([174, 59, 149, 22, 135, 129, 129, 83]),
+    PoolStateLog: Buffer.from([59, 254, 237, 111, 163, 10, 140, 224]),
+    PoolInfo: Buffer.from([207, 20, 87, 97, 251, 212, 234, 45]),
+    BannedExtensionsUpdated: Buffer.from([107, 126, 13, 149, 182, 108, 139, 202]),
+    // Stld:
+    SingleTokenDeposit: Buffer.from([215, 54, 137, 104, 219, 39, 164, 235]),
+};
+function parseCubicPoolEvents(logs) {
+    const out = [];
+    for (const line of logs) {
+        const m = line.match(/^Program data:\s+(.+)$/);
+        if (!m)
+            continue;
+        const buf = Buffer.from(m[1], "base64");
+        if (buf.length < 8)
+            continue;
+        const disc = buf.slice(0, 8);
+        const payload = buf.slice(8);
+        const name = matchDiscriminator(disc);
+        if (!name) {
+            out.push({ kind: "Unknown", name: "unknown", data: { disc: disc.toString("base64"), payload: payload.toString("base64") } });
+            continue;
+        }
+        try {
+            const ev = decodeEvent(name, payload);
+            if (ev)
+                out.push(ev);
+        }
+        catch (e) {
+            out.push({
+                kind: "Unknown",
+                name,
+                data: { error: String(e), payload: payload.toString("base64") },
+            });
+        }
+    }
+    return out;
+}
+function matchDiscriminator(d) {
+    for (const [name, bytes] of Object.entries(DISC)) {
+        if (bytes.equals(d))
+            return name;
+    }
+    return null;
+}
+function decodeEvent(name, buf) {
+    const r = new borsh_1.BorshReader(buf);
+    switch (name) {
+        case "Swap": {
+            const pool = r.pubkey();
+            const user = r.pubkey();
+            const tokenIn = r.pubkey();
+            const tokenOut = r.pubkey();
+            const amountIn = r.u64();
+            const amountOut = r.u64();
+            const feeAmount = r.u64();
+            const protocolFeeAmount = r.u64();
+            const timestamp = r.i64().toNumber();
+            return { kind: "Swap", pool, user, tokenIn, tokenOut, amountIn, amountOut, feeAmount, protocolFeeAmount, timestamp };
+        }
+        case "LiquidityAdded": {
+            const pool = r.pubkey();
+            const user = r.pubkey();
+            const tokenAmounts = r.vecU64();
+            const bptAmount = r.u64();
+            const timestamp = r.i64().toNumber();
+            return { kind: "LiquidityAdded", pool, user, tokenAmounts, bptAmount, timestamp };
+        }
+        case "LiquidityRemoved": {
+            const pool = r.pubkey();
+            const user = r.pubkey();
+            const bptAmount = r.u64();
+            const tokenAmounts = r.vecU64();
+            const timestamp = r.i64().toNumber();
+            return { kind: "LiquidityRemoved", pool, user, bptAmount, tokenAmounts, timestamp };
+        }
+        case "ProtocolFeesCollected": {
+            const pool = r.pubkey();
+            const authority = r.pubkey();
+            const tokenAmounts = r.vecU64();
+            const timestamp = r.i64().toNumber();
+            return { kind: "ProtocolFeesCollected", pool, authority, tokenAmounts, timestamp };
+        }
+        case "PoolInitialized": {
+            const pool = r.pubkey();
+            const config = r.pubkey();
+            const tokenCount = r.u8();
+            const bptMint = r.pubkey();
+            const timestamp = r.i64().toNumber();
+            return { kind: "PoolInitialized", pool, config, tokenCount, bptMint, timestamp };
+        }
+        case "PoolEnabledUpdated": {
+            const pool = r.pubkey();
+            const authority = r.pubkey();
+            const oldValue = r.bool();
+            const newValue = r.bool();
+            const timestamp = r.i64().toNumber();
+            return { kind: "PoolEnabledUpdated", pool, authority, oldValue, newValue, timestamp };
+        }
+        case "SwapsEnabledUpdated": {
+            const pool = r.pubkey();
+            const authority = r.pubkey();
+            const oldValue = r.bool();
+            const newValue = r.bool();
+            const timestamp = r.i64().toNumber();
+            return { kind: "SwapsEnabledUpdated", pool, authority, oldValue, newValue, timestamp };
+        }
+        case "SingleTokenDeposit": {
+            const helper = r.pubkey();
+            const pool = r.pubkey();
+            const user = r.pubkey();
+            const tokenInIndex = r.u8();
+            const amountIn = r.u64();
+            const slippageHundredthsBps = r.u32();
+            const allocations = r.vecU64();
+            const depositedAmounts = r.vecU64();
+            const bptReceived = r.u64();
+            const dustRefunded = r.u64();
+            const timestamp = r.i64().toNumber();
+            return {
+                kind: "SingleTokenDeposit",
+                helper,
+                pool,
+                user,
+                tokenInIndex,
+                amountIn,
+                slippageHundredthsBps,
+                allocations,
+                depositedAmounts,
+                bptReceived,
+                dustRefunded,
+                timestamp,
+            };
+        }
+        // Events we don't yet surface as typed — decode as Unknown so the
+        // caller gets the discriminator name and can act on it.
+        case "SwapFeeRateUpdated":
+        case "ProtocolFeeRateUpdated":
+        case "BannedExtensionsUpdated":
+        case "DebugLiquidityWithdrawn":
+        case "PoolStateLog":
+        case "PoolInfo":
+            return { kind: "Unknown", name, data: { raw: buf.toString("base64") } };
+    }
+}
+void web3_js_1.PublicKey; // keep import used by types above via type inference
+//# sourceMappingURL=events.js.map