@liquid-af/sdk 0.1.0

package/dist/math/amm.js

@@ -0,0 +1,109 @@
+import BN from "bn.js";
+import { FEE_RATE_DENOMINATOR } from "./constants.js";
+/**
+ * Calculates expected output for selling base tokens on the AMM.
+ * Uses constant product formula: quoteOut = (amountIn * quoteVault) / (baseVault + amountIn)
+ *
+ * @param amountIn - Base tokens to sell
+ * @param baseVault - Current base vault balance
+ * @param quoteVault - Current quote vault balance
+ * @param fees - Fee rates in basis points
+ * @returns Sell output with gross/net quote amounts and fee breakdown
+ */
+export const calculateAmmSellOutput = (amountIn, baseVault, quoteVault, fees) => {
+    // Gross output: (amountIn * quoteVault) / (baseVault + amountIn)
+    const grossQuoteOut = amountIn.mul(quoteVault).div(baseVault.add(amountIn));
+    const denom = new BN(FEE_RATE_DENOMINATOR);
+    const lpFee = grossQuoteOut.mul(new BN(fees.lpFeeRate)).div(denom);
+    const creatorFee = grossQuoteOut
+        .mul(new BN(fees.creatorFeeRate))
+        .div(denom);
+    const protocolFee = grossQuoteOut
+        .mul(new BN(fees.protocolFeeRate))
+        .div(denom);
+    const totalFees = lpFee.add(creatorFee).add(protocolFee);
+    const quoteOutNet = grossQuoteOut.sub(totalFees);
+    return {
+        quoteOut: grossQuoteOut,
+        quoteOutNet,
+        lpFee,
+        creatorFee,
+        protocolFee,
+        totalFees,
+    };
+};
+/**
+ * Calculates required quote input for buying base tokens on the AMM.
+ * Reverse calculation: how much quote is needed for the desired base output.
+ *
+ * @param amountOut - Base tokens to buy
+ * @param baseVault - Current base vault balance
+ * @param quoteVault - Current quote vault balance
+ * @param fees - Fee rates in basis points
+ * @returns Buy input with gross/net quote amounts and fee breakdown
+ */
+export const calculateAmmBuyInput = (amountOut, baseVault, quoteVault, fees) => {
+    const denom = new BN(FEE_RATE_DENOMINATOR);
+    // Quote needed for swap (without fees), ceiling division
+    const quoteForSwap = quoteVault
+        .mul(amountOut)
+        .div(baseVault.sub(amountOut))
+        .add(new BN(1));
+    // Total fee rate
+    const totalFeeRate = fees.lpFeeRate + fees.creatorFeeRate + fees.protocolFeeRate;
+    // Gross quote needed (including fees), ceiling division
+    const quoteInGross = quoteForSwap
+        .mul(denom)
+        .div(new BN(FEE_RATE_DENOMINATOR - totalFeeRate))
+        .add(new BN(1));
+    // Calculate individual fees
+    const lpFee = quoteInGross.mul(new BN(fees.lpFeeRate)).div(denom);
+    const creatorFee = quoteInGross.mul(new BN(fees.creatorFeeRate)).div(denom);
+    const protocolFee = quoteInGross
+        .mul(new BN(fees.protocolFeeRate))
+        .div(denom);
+    const totalFees = lpFee.add(creatorFee).add(protocolFee);
+    const quoteIn = quoteInGross.sub(totalFees);
+    return {
+        quoteIn,
+        quoteInGross,
+        lpFee,
+        creatorFee,
+        protocolFee,
+        totalFees,
+    };
+};
+/**
+ * Converts LP tokens to the equivalent base and quote token amounts.
+ *
+ * @param lpAmount - LP tokens to convert
+ * @param lpSupply - Total LP supply
+ * @param baseVault - Base vault balance
+ * @param quoteVault - Quote vault balance
+ * @param roundUp - Use ceiling division (for deposits) vs floor division (for withdrawals)
+ * @returns Equivalent base and quote token amounts for the given LP tokens
+ */
+export const calculateLpToTokens = (lpAmount, lpSupply, baseVault, quoteVault, roundUp = false) => {
+    let baseAmount;
+    let quoteAmount;
+    if (roundUp) {
+        // Ceiling division for deposits (require slightly more from user)
+        baseAmount = lpAmount
+            .mul(baseVault)
+            .add(lpSupply)
+            .sub(new BN(1))
+            .div(lpSupply);
+        quoteAmount = lpAmount
+            .mul(quoteVault)
+            .add(lpSupply)
+            .sub(new BN(1))
+            .div(lpSupply);
+    }
+    else {
+        // Floor division for withdrawals (give slightly less to user)
+        baseAmount = lpAmount.mul(baseVault).div(lpSupply);
+        quoteAmount = lpAmount.mul(quoteVault).div(lpSupply);
+    }
+    return { baseAmount, quoteAmount };
+};
+//# sourceMappingURL=amm.js.map

package/dist/math/amm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amm.js","sourceRoot":"","sources":["../../src/math/amm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAUtD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACrC,QAAY,EACZ,SAAa,EACb,UAAc,EACd,IAAiB,EACD,EAAE;IAClB,iEAAiE;IACjE,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,oBAAoB,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,aAAa;SAC9B,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SAChC,GAAG,CAAC,KAAK,CAAC,CAAC;IACb,MAAM,WAAW,GAAG,aAAa;SAC/B,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;SACjC,GAAG,CAAC,KAAK,CAAC,CAAC;IACb,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEzD,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEjD,OAAO;QACN,QAAQ,EAAE,aAAa;QACvB,WAAW;QACX,KAAK;QACL,UAAU;QACV,WAAW;QACX,SAAS;KACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CACnC,SAAa,EACb,SAAa,EACb,UAAc,EACd,IAAiB,EACH,EAAE;IAChB,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,oBAAoB,CAAC,CAAC;IAE3C,yDAAyD;IACzD,MAAM,YAAY,GAAG,UAAU;SAC7B,GAAG,CAAC,SAAS,CAAC;SACd,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;SAC7B,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjB,iBAAiB;IACjB,MAAM,YAAY,GACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC;IAE7D,wDAAwD;IACxD,MAAM,YAAY,GAAG,YAAY;SAC/B,GAAG,CAAC,KAAK,CAAC;SACV,GAAG,CAAC,IAAI,EAAE,CAAC,oBAAoB,GAAG,YAAY,CAAC,CAAC;SAChD,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjB,4BAA4B;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,YAAY;SAC9B,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;SACjC,GAAG,CAAC,KAAK,CAAC,CAAC;IACb,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAE5C,OAAO;QACN,OAAO;QACP,YAAY;QACZ,KAAK;QACL,UAAU;QACV,WAAW;QACX,SAAS;KACT,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAClC,QAAY,EACZ,QAAY,EACZ,SAAa,EACb,UAAc,EACd,UAAmB,KAAK,EACP,EAAE;IACnB,IAAI,UAAc,CAAC;IACnB,IAAI,WAAe,CAAC;IAEpB,IAAI,OAAO,EAAE,CAAC;QACb,kEAAkE;QAClE,UAAU,GAAG,QAAQ;aACnB,GAAG,CAAC,SAAS,CAAC;aACd,GAAG,CAAC,QAAQ,CAAC;aACb,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aACd,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChB,WAAW,GAAG,QAAQ;aACpB,GAAG,CAAC,UAAU,CAAC;aACf,GAAG,CAAC,QAAQ,CAAC;aACb,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aACd,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjB,CAAC;SAAM,CAAC;QACP,8DAA8D;QAC9D,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC,CAAC"}

package/dist/math/bonding-curve.d.ts

@@ -0,0 +1,34 @@
+import BN from "bn.js";
+import type { BondingCurveBuyResult, BondingCurveSellResult } from "../types.js";
+import { type FeeConfig } from "./fees.js";
+/**
+ * Calculates expected output for a buy transaction on the bonding curve.
+ * Uses constant product formula: k = virtualQuote * virtualToken
+ *
+ * @param amountInGross - Total quote amount the user is spending (before fees)
+ * @param curveState - Current curve reserves
+ * @param config - Fee configuration
+ * @param hasCreatorRef - Whether the creator has a referrer
+ * @param hasTraderRef - Whether the trader has a referrer
+ * @returns Buy result with tokens out, new reserves, net amount, and fee breakdown
+ */
+export declare const calculateBuyExpectation: (amountInGross: BN, curveState: {
+    virtualQuoteReserves: BN;
+    virtualTokenReserves: BN;
+}, config: FeeConfig, hasCreatorRef: boolean, hasTraderRef: boolean) => BondingCurveBuyResult;
+/**
+ * Calculates expected output for a sell transaction on the bonding curve.
+ * Uses constant product formula: k = virtualQuote * virtualToken
+ *
+ * @param amountInTokens - Amount of tokens to sell
+ * @param curveState - Current curve reserves
+ * @param config - Fee configuration
+ * @param hasCreatorRef - Whether the creator has a referrer
+ * @param hasTraderRef - Whether the trader has a referrer
+ * @returns Sell result with quote out (gross/net), new reserves, and fee breakdown
+ */
+export declare const calculateSellExpectation: (amountInTokens: BN, curveState: {
+    virtualQuoteReserves: BN;
+    virtualTokenReserves: BN;
+}, config: FeeConfig, hasCreatorRef: boolean, hasTraderRef: boolean) => BondingCurveSellResult;
+//# sourceMappingURL=bonding-curve.d.ts.map

package/dist/math/bonding-curve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bonding-curve.d.ts","sourceRoot":"","sources":["../../src/math/bonding-curve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GACnC,eAAe,EAAE,EACjB,YAAY;IAAE,oBAAoB,EAAE,EAAE,CAAC;IAAC,oBAAoB,EAAE,EAAE,CAAA;CAAE,EAClE,QAAQ,SAAS,EACjB,eAAe,OAAO,EACtB,cAAc,OAAO,KACnB,qBAwCF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GACpC,gBAAgB,EAAE,EAClB,YAAY;IAAE,oBAAoB,EAAE,EAAE,CAAC;IAAC,oBAAoB,EAAE,EAAE,CAAA;CAAE,EAClE,QAAQ,SAAS,EACjB,eAAe,OAAO,EACtB,cAAc,OAAO,KACnB,sBAyCF,CAAC"}

package/dist/math/bonding-curve.js

@@ -0,0 +1,80 @@
+import BN from "bn.js";
+import { calculateFees } from "./fees.js";
+/**
+ * Calculates expected output for a buy transaction on the bonding curve.
+ * Uses constant product formula: k = virtualQuote * virtualToken
+ *
+ * @param amountInGross - Total quote amount the user is spending (before fees)
+ * @param curveState - Current curve reserves
+ * @param config - Fee configuration
+ * @param hasCreatorRef - Whether the creator has a referrer
+ * @param hasTraderRef - Whether the trader has a referrer
+ * @returns Buy result with tokens out, new reserves, net amount, and fee breakdown
+ */
+export const calculateBuyExpectation = (amountInGross, curveState, config, hasCreatorRef, hasTraderRef) => {
+    const fees = calculateFees(amountInGross, config, hasCreatorRef, hasTraderRef);
+    // Net quote amount that goes into the curve after fees
+    const amountInNet = amountInGross.sub(fees.totalFees);
+    // Constant product: k = x * y
+    const k = curveState.virtualQuoteReserves.mul(curveState.virtualTokenReserves);
+    // New quote reserves after adding net amount
+    const newVirtualQuote = curveState.virtualQuoteReserves.add(amountInNet);
+    // Solve for new token reserves: newToken = k / newQuote + 1 (ceiling division)
+    const newVirtualToken = k.div(newVirtualQuote).add(new BN(1));
+    // Tokens out = difference in token reserves
+    const tokensOut = curveState.virtualTokenReserves.sub(newVirtualToken);
+    // On-chain, protocol fee is only reduced by referral amounts that are
+    // actually transferred. These helpers assume referrals succeed, so
+    // subtract them to match the expected on-chain protocol fee.
+    const effectiveProtocolFee = fees.protocolFee
+        .sub(fees.creatorReferralFee)
+        .sub(fees.traderReferralFee);
+    return {
+        ...fees,
+        protocolFee: effectiveProtocolFee,
+        tokensOut,
+        newVirtualQuote,
+        newVirtualToken,
+        amountInNet,
+    };
+};
+/**
+ * Calculates expected output for a sell transaction on the bonding curve.
+ * Uses constant product formula: k = virtualQuote * virtualToken
+ *
+ * @param amountInTokens - Amount of tokens to sell
+ * @param curveState - Current curve reserves
+ * @param config - Fee configuration
+ * @param hasCreatorRef - Whether the creator has a referrer
+ * @param hasTraderRef - Whether the trader has a referrer
+ * @returns Sell result with quote out (gross/net), new reserves, and fee breakdown
+ */
+export const calculateSellExpectation = (amountInTokens, curveState, config, hasCreatorRef, hasTraderRef) => {
+    // Constant product: k = x * y
+    const k = curveState.virtualQuoteReserves.mul(curveState.virtualTokenReserves);
+    // New token reserves after adding sold tokens
+    const newVirtualToken = curveState.virtualTokenReserves.add(amountInTokens);
+    // Solve for new quote reserves: newQuote = k / newToken + 1 (ceiling division)
+    const newVirtualQuote = k.div(newVirtualToken).add(new BN(1));
+    // Gross quote out (before fees)
+    const quoteOutGross = curveState.virtualQuoteReserves.sub(newVirtualQuote);
+    // Calculate fees on gross amount
+    const fees = calculateFees(quoteOutGross, config, hasCreatorRef, hasTraderRef);
+    // Net quote amount user receives
+    const quoteOutNet = quoteOutGross.sub(fees.totalFees);
+    // On-chain, protocol fee is only reduced by referral amounts that are
+    // actually transferred. These helpers assume referrals succeed, so
+    // subtract them to match the expected on-chain protocol fee.
+    const effectiveProtocolFee = fees.protocolFee
+        .sub(fees.creatorReferralFee)
+        .sub(fees.traderReferralFee);
+    return {
+        ...fees,
+        protocolFee: effectiveProtocolFee,
+        quoteOutGross,
+        quoteOutNet,
+        newVirtualQuote,
+        newVirtualToken,
+    };
+};
+//# sourceMappingURL=bonding-curve.js.map

package/dist/math/bonding-curve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bonding-curve.js","sourceRoot":"","sources":["../../src/math/bonding-curve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAkB,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACtC,aAAiB,EACjB,UAAkE,EAClE,MAAiB,EACjB,aAAsB,EACtB,YAAqB,EACG,EAAE;IAC1B,MAAM,IAAI,GAAG,aAAa,CACzB,aAAa,EACb,MAAM,EACN,aAAa,EACb,YAAY,CACZ,CAAC;IAEF,uDAAuD;IACvD,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtD,8BAA8B;IAC9B,MAAM,CAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAC5C,UAAU,CAAC,oBAAoB,CAC/B,CAAC;IAEF,6CAA6C;IAC7C,MAAM,eAAe,GAAG,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEzE,+EAA+E;IAC/E,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,4CAA4C;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAEvE,sEAAsE;IACtE,mEAAmE;IACnE,6DAA6D;IAC7D,MAAM,oBAAoB,GAAG,IAAI,CAAC,WAAW;SAC3C,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC;SAC5B,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE9B,OAAO;QACN,GAAG,IAAI;QACP,WAAW,EAAE,oBAAoB;QACjC,SAAS;QACT,eAAe;QACf,eAAe;QACf,WAAW;KACX,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACvC,cAAkB,EAClB,UAAkE,EAClE,MAAiB,EACjB,aAAsB,EACtB,YAAqB,EACI,EAAE;IAC3B,8BAA8B;IAC9B,MAAM,CAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAC5C,UAAU,CAAC,oBAAoB,CAC/B,CAAC;IAEF,8CAA8C;IAC9C,MAAM,eAAe,GAAG,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAE5E,+EAA+E;IAC/E,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9D,gCAAgC;IAChC,MAAM,aAAa,GAAG,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAE3E,iCAAiC;IACjC,MAAM,IAAI,GAAG,aAAa,CACzB,aAAa,EACb,MAAM,EACN,aAAa,EACb,YAAY,CACZ,CAAC;IAEF,iCAAiC;IACjC,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtD,sEAAsE;IACtE,mEAAmE;IACnE,6DAA6D;IAC7D,MAAM,oBAAoB,GAAG,IAAI,CAAC,WAAW;SAC3C,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC;SAC5B,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE9B,OAAO;QACN,GAAG,IAAI;QACP,WAAW,EAAE,oBAAoB;QACjC,aAAa;QACb,WAAW;QACX,eAAe;QACf,eAAe;KACf,CAAC;AACH,CAAC,CAAC"}

package/dist/math/constants.d.ts

@@ -0,0 +1,14 @@
+import BN from "bn.js";
+/** Basis points denominator (10,000 = 100%) */
+export declare const BPS_DENOMINATOR = 10000;
+/** Fee rate denominator for AMM (same as BPS) */
+export declare const FEE_RATE_DENOMINATOR = 10000;
+/** Q32 constant for fixed-point oracle math (2^32) */
+export declare const Q32: BN;
+/** Number of oracle observations stored */
+export declare const OBSERVATION_NUM = 100;
+/** Default oracle update duration in seconds */
+export declare const OBSERVATION_UPDATE_DURATION_DEFAULT = 15;
+/** Minimum rent-exempt balance for a 0-byte account */
+export declare const MIN_VAULT_BALANCE = 890880;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/math/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB,+CAA+C;AAC/C,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,sDAAsD;AACtD,eAAO,MAAM,GAAG,IAAqB,CAAC;AAEtC,2CAA2C;AAC3C,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,gDAAgD;AAChD,eAAO,MAAM,mCAAmC,KAAK,CAAC;AAEtD,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,SAAU,CAAC"}

package/dist/math/constants.js

@@ -0,0 +1,14 @@
+import BN from "bn.js";
+/** Basis points denominator (10,000 = 100%) */
+export const BPS_DENOMINATOR = 10000;
+/** Fee rate denominator for AMM (same as BPS) */
+export const FEE_RATE_DENOMINATOR = 10000;
+/** Q32 constant for fixed-point oracle math (2^32) */
+export const Q32 = new BN(1).shln(32);
+/** Number of oracle observations stored */
+export const OBSERVATION_NUM = 100;
+/** Default oracle update duration in seconds */
+export const OBSERVATION_UPDATE_DURATION_DEFAULT = 15;
+/** Minimum rent-exempt balance for a 0-byte account */
+export const MIN_VAULT_BALANCE = 890880;
+//# sourceMappingURL=constants.js.map

package/dist/math/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/math/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG,KAAM,CAAC;AAEtC,iDAAiD;AACjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAM,CAAC;AAE3C,sDAAsD;AACtD,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEtC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,gDAAgD;AAChD,MAAM,CAAC,MAAM,mCAAmC,GAAG,EAAE,CAAC;AAEtD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAO,CAAC"}

package/dist/math/fees.d.ts

@@ -0,0 +1,88 @@
+import BN from "bn.js";
+import type { PublicKey } from "@solana/web3.js";
+import type { FeeDistribution, FeeRecipient, DistributionResult } from "../types.js";
+/**
+ * Calculates basis points of an amount.
+ * result = (amount * bps) / 10000
+ *
+ * @param amount - The amount to calculate basis points of
+ * @param bps - Basis points (1 bps = 0.01%)
+ * @returns The calculated portion
+ */
+export declare const calcBps: (amount: BN, bps: number) => BN;
+/**
+ * Fee configuration for bonding curve trades.
+ */
+export interface FeeConfig {
+    protocolFeeBps: number;
+    creatorFeeBps: number;
+    creatorReferralBps: number;
+    traderReferralBps: number;
+}
+/**
+ * Calculates fee distribution for a given trade amount.
+ * Referral fees are carved from the protocol fee, not the trade amount.
+ *
+ * @param amount - Gross trade amount (before fees)
+ * @param config - Fee configuration in basis points
+ * @param hasCreatorRef - Whether the creator has a referrer
+ * @param hasTraderRef - Whether the trader has a referrer
+ * @returns Fee distribution breakdown
+ */
+export declare const calculateFees: (amount: BN, config: FeeConfig, hasCreatorRef: boolean, hasTraderRef: boolean) => FeeDistribution;
+/**
+ * Calculates expected distribution amounts for each fee recipient.
+ * Distributable = vaultBalance - MIN_VAULT_BALANCE (rent).
+ *
+ * @param vaultBalance - Current vault balance in lamports
+ * @param recipients - Fee recipients with basis point allocations
+ * @returns Distribution amounts per recipient
+ */
+export declare const calculateDistribution: (vaultBalance: number, recipients: FeeRecipient[]) => DistributionResult[];
+/**
+ * Calculates total distribution (sum of all recipient amounts).
+ *
+ * @param vaultBalance - Current vault balance in lamports
+ * @param recipients - Fee recipients with basis point allocations
+ * @returns Total amount distributed across all recipients
+ */
+export declare const calculateTotalDistribution: (vaultBalance: number, recipients: FeeRecipient[]) => number;
+/**
+ * Calculates dust remaining after distribution (due to integer rounding).
+ *
+ * @param vaultBalance - Current vault balance in lamports
+ * @param recipients - Fee recipients with basis point allocations
+ * @returns Undistributed lamports remaining in the vault
+ */
+export declare const calculateDistributionDust: (vaultBalance: number, recipients: FeeRecipient[]) => number;
+/**
+ * Creates a recipients array from pubkeys and basis points.
+ *
+ * @param pubkeys - Recipient public keys
+ * @param bpsArray - Basis point allocations (must match pubkeys length)
+ * @returns Array of fee recipients
+ */
+export declare const createRecipients: (pubkeys: PublicKey[], bpsArray: number[]) => FeeRecipient[];
+/**
+ * Creates equal-share recipients (auto-calculates BPS to sum to 10,000).
+ *
+ * @param count - Number of recipients
+ * @param pubkeys - Recipient public keys (must have at least `count` entries)
+ * @returns Array of fee recipients with equal allocations
+ */
+export declare const createEqualRecipients: (count: number, pubkeys: PublicKey[]) => FeeRecipient[];
+/**
+ * Creates a single recipient with 100% allocation.
+ *
+ * @param pubkey - Recipient public key
+ * @returns Array with a single fee recipient at 10,000 BPS
+ */
+export declare const createSingleRecipient: (pubkey: PublicKey) => FeeRecipient[];
+/**
+ * Validates that recipients sum to exactly 10,000 BPS.
+ *
+ * @param recipients - Fee recipients to validate
+ * @returns True if basis points sum to exactly 10,000
+ */
+export declare const validateRecipientsSum: (recipients: FeeRecipient[]) => boolean;
+//# sourceMappingURL=fees.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../src/math/fees.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EACX,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,EAAE,EAAE,KAAK,MAAM,KAAG,EACG,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACzB,QAAQ,EAAE,EACV,QAAQ,SAAS,EACjB,eAAe,OAAO,EACtB,cAAc,OAAO,KACnB,eAyBF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GACjC,cAAc,MAAM,EACpB,YAAY,YAAY,EAAE,KACxB,kBAAkB,EAMpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,cAAc,MAAM,EACpB,YAAY,YAAY,EAAE,KACxB,MAKF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACrC,cAAc,MAAM,EACpB,YAAY,YAAY,EAAE,KACxB,MAOF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,SAAS,SAAS,EAAE,EACpB,UAAU,MAAM,EAAE,KAChB,YAAY,EAQd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GACjC,OAAO,MAAM,EACb,SAAS,SAAS,EAAE,KAClB,YAAY,EAYd,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,KAAG,YAAY,EAErE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,YAAY,YAAY,EAAE,KAAG,OAGlE,CAAC"}

package/dist/math/fees.js

@@ -0,0 +1,135 @@
+import BN from "bn.js";
+import { BPS_DENOMINATOR, MIN_VAULT_BALANCE } from "./constants.js";
+/**
+ * Calculates basis points of an amount.
+ * result = (amount * bps) / 10000
+ *
+ * @param amount - The amount to calculate basis points of
+ * @param bps - Basis points (1 bps = 0.01%)
+ * @returns The calculated portion
+ */
+export const calcBps = (amount, bps) => amount.mul(new BN(bps)).div(new BN(BPS_DENOMINATOR));
+/**
+ * Calculates fee distribution for a given trade amount.
+ * Referral fees are carved from the protocol fee, not the trade amount.
+ *
+ * @param amount - Gross trade amount (before fees)
+ * @param config - Fee configuration in basis points
+ * @param hasCreatorRef - Whether the creator has a referrer
+ * @param hasTraderRef - Whether the trader has a referrer
+ * @returns Fee distribution breakdown
+ */
+export const calculateFees = (amount, config, hasCreatorRef, hasTraderRef) => {
+    const baseProtocolFee = calcBps(amount, config.protocolFeeBps);
+    const creatorFee = calcBps(amount, config.creatorFeeBps);
+    // Referral amounts are BPS of the protocol fee (not trade amount)
+    const creatorReferralFee = hasCreatorRef
+        ? calcBps(baseProtocolFee, config.creatorReferralBps)
+        : new BN(0);
+    const traderReferralFee = hasTraderRef
+        ? calcBps(baseProtocolFee, config.traderReferralBps)
+        : new BN(0);
+    // Protocol fee starts at base amount. On-chain, it is only reduced
+    // when referral transfers actually succeed.
+    const protocolFee = baseProtocolFee;
+    // Referrals are carved from protocol fee (not additive), so total = protocol + creator.
+    const totalFees = protocolFee.add(creatorFee);
+    return {
+        protocolFee,
+        creatorFee,
+        creatorReferralFee,
+        traderReferralFee,
+        totalFees,
+    };
+};
+/**
+ * Calculates expected distribution amounts for each fee recipient.
+ * Distributable = vaultBalance - MIN_VAULT_BALANCE (rent).
+ *
+ * @param vaultBalance - Current vault balance in lamports
+ * @param recipients - Fee recipients with basis point allocations
+ * @returns Distribution amounts per recipient
+ */
+export const calculateDistribution = (vaultBalance, recipients) => {
+    const distributable = Math.max(0, vaultBalance - MIN_VAULT_BALANCE);
+    return recipients.map((r) => ({
+        pubkey: r.pubkey,
+        amount: Math.floor((distributable * r.basisPoints) / BPS_DENOMINATOR),
+    }));
+};
+/**
+ * Calculates total distribution (sum of all recipient amounts).
+ *
+ * @param vaultBalance - Current vault balance in lamports
+ * @param recipients - Fee recipients with basis point allocations
+ * @returns Total amount distributed across all recipients
+ */
+export const calculateTotalDistribution = (vaultBalance, recipients) => {
+    return calculateDistribution(vaultBalance, recipients).reduce((sum, r) => sum + r.amount, 0);
+};
+/**
+ * Calculates dust remaining after distribution (due to integer rounding).
+ *
+ * @param vaultBalance - Current vault balance in lamports
+ * @param recipients - Fee recipients with basis point allocations
+ * @returns Undistributed lamports remaining in the vault
+ */
+export const calculateDistributionDust = (vaultBalance, recipients) => {
+    const distributable = Math.max(0, vaultBalance - MIN_VAULT_BALANCE);
+    const totalDistributed = calculateTotalDistribution(vaultBalance, recipients);
+    return distributable - totalDistributed;
+};
+/**
+ * Creates a recipients array from pubkeys and basis points.
+ *
+ * @param pubkeys - Recipient public keys
+ * @param bpsArray - Basis point allocations (must match pubkeys length)
+ * @returns Array of fee recipients
+ */
+export const createRecipients = (pubkeys, bpsArray) => {
+    if (pubkeys.length !== bpsArray.length) {
+        throw new Error("pubkeys and bpsArray must have the same length");
+    }
+    return pubkeys.map((pubkey, i) => ({
+        pubkey,
+        basisPoints: bpsArray[i],
+    }));
+};
+/**
+ * Creates equal-share recipients (auto-calculates BPS to sum to 10,000).
+ *
+ * @param count - Number of recipients
+ * @param pubkeys - Recipient public keys (must have at least `count` entries)
+ * @returns Array of fee recipients with equal allocations
+ */
+export const createEqualRecipients = (count, pubkeys) => {
+    if (pubkeys.length < count) {
+        throw new Error(`Need at least ${count} pubkeys, got ${pubkeys.length}`);
+    }
+    const bpsPerRecipient = Math.floor(BPS_DENOMINATOR / count);
+    const remainder = BPS_DENOMINATOR % count;
+    return pubkeys.slice(0, count).map((pubkey, i) => ({
+        pubkey,
+        basisPoints: i === 0 ? bpsPerRecipient + remainder : bpsPerRecipient,
+    }));
+};
+/**
+ * Creates a single recipient with 100% allocation.
+ *
+ * @param pubkey - Recipient public key
+ * @returns Array with a single fee recipient at 10,000 BPS
+ */
+export const createSingleRecipient = (pubkey) => {
+    return [{ pubkey, basisPoints: BPS_DENOMINATOR }];
+};
+/**
+ * Validates that recipients sum to exactly 10,000 BPS.
+ *
+ * @param recipients - Fee recipients to validate
+ * @returns True if basis points sum to exactly 10,000
+ */
+export const validateRecipientsSum = (recipients) => {
+    const sum = recipients.reduce((acc, r) => acc + r.basisPoints, 0);
+    return sum === BPS_DENOMINATOR;
+};
+//# sourceMappingURL=fees.js.map

package/dist/math/fees.js.map

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

package/dist/math/index.d.ts

@@ -0,0 +1,8 @@
+export { BPS_DENOMINATOR, FEE_RATE_DENOMINATOR, Q32, OBSERVATION_NUM, OBSERVATION_UPDATE_DURATION_DEFAULT, MIN_VAULT_BALANCE, } from "./constants.js";
+export { calcBps, calculateFees, calculateDistribution, calculateTotalDistribution, calculateDistributionDust, createRecipients, createEqualRecipients, createSingleRecipient, validateRecipientsSum, } from "./fees.js";
+export type { FeeConfig } from "./fees.js";
+export { calculateBuyExpectation, calculateSellExpectation, } from "./bonding-curve.js";
+export { calculateAmmSellOutput, calculateAmmBuyInput, calculateLpToTokens, } from "./amm.js";
+export type { AmmFeeRates } from "./amm.js";
+export { calculatePoolMarketCap, lookupFeeTier, calculateFeesForPool, WSOL_MINT, } from "./tiered-fees.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/math/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,oBAAoB,EACpB,GAAG,EACH,eAAe,EACf,mCAAmC,EACnC,iBAAiB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,OAAO,EACP,aAAa,EACb,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACN,uBAAuB,EACvB,wBAAwB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACnB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EACN,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,SAAS,GACT,MAAM,kBAAkB,CAAC"}

package/dist/math/index.js

@@ -0,0 +1,6 @@
+export { BPS_DENOMINATOR, FEE_RATE_DENOMINATOR, Q32, OBSERVATION_NUM, OBSERVATION_UPDATE_DURATION_DEFAULT, MIN_VAULT_BALANCE, } from "./constants.js";
+export { calcBps, calculateFees, calculateDistribution, calculateTotalDistribution, calculateDistributionDust, createRecipients, createEqualRecipients, createSingleRecipient, validateRecipientsSum, } from "./fees.js";
+export { calculateBuyExpectation, calculateSellExpectation, } from "./bonding-curve.js";
+export { calculateAmmSellOutput, calculateAmmBuyInput, calculateLpToTokens, } from "./amm.js";
+export { calculatePoolMarketCap, lookupFeeTier, calculateFeesForPool, WSOL_MINT, } from "./tiered-fees.js";
+//# sourceMappingURL=index.js.map

package/dist/math/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/math/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,oBAAoB,EACpB,GAAG,EACH,eAAe,EACf,mCAAmC,EACnC,iBAAiB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,OAAO,EACP,aAAa,EACb,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACN,uBAAuB,EACvB,wBAAwB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACN,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,SAAS,GACT,MAAM,kBAAkB,CAAC"}

package/dist/math/tiered-fees.d.ts

@@ -0,0 +1,80 @@
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+import type { FeeTier } from "../types.js";
+/** WSOL mint address (native SOL wrapped as SPL token) */
+export declare const WSOL_MINT: PublicKey;
+/**
+ * Calculate pool fully diluted market cap in USD.
+ *
+ * The market cap is calculated as:
+ * - Pool token price (in USD) × base token total supply
+ * - Pool token price = (quote vault value in USD) / base vault amount
+ *
+ * For WSOL pools, the quote vault is converted to USD using the oracle price.
+ * For USDC pools, the quote vault is already in USD (assumed 1:1 peg).
+ *
+ * @param quoteVaultAmount - Quote vault balance (lamports for WSOL, 6 decimals for USDC)
+ * @param baseVaultAmount - Base vault balance (token decimals)
+ * @param baseTotalSupply - Total supply of base token (token decimals)
+ * @param solPriceUsd - SOL/USD price from oracle (6 decimals)
+ * @param quoteMint - Quote mint pubkey (to detect WSOL vs stable)
+ * @returns Market cap in USD (6 decimals)
+ *
+ * @example
+ * ```typescript
+ * // Pool with 100 SOL and 1M tokens, SOL = $150, supply = 1B tokens
+ * // Token price = (100 SOL × $150) / 1M = $0.015 per token
+ * // Market cap = $0.015 × 1B = $15M
+ * const marketCap = calculatePoolMarketCap(
+ *   new BN(100_000_000_000),  // 100 SOL in lamports
+ *   new BN(1_000_000_000_000),  // 1M tokens (6 decimals)
+ *   new BN(1_000_000_000_000_000),  // 1B tokens (6 decimals)
+ *   new BN(150_000_000),  // $150 (6 decimals)
+ *   WSOL_MINT,
+ * );
+ * // Returns: 15_000_000_000_000 ($15M with 6 decimals)
+ * ```
+ */
+export declare function calculatePoolMarketCap(quoteVaultAmount: BN, baseVaultAmount: BN, baseTotalSupply: BN, solPriceUsd: BN, quoteMint: PublicKey): BN;
+/**
+ * Find appropriate fee tier for given market cap.
+ *
+ * Performs a linear scan through the active fee tiers to find the tier
+ * whose range contains the given market cap. If the market cap exceeds
+ * all tier ranges, returns the last tier.
+ *
+ * @param marketCapUsd - Pool market cap in USD (6 decimals)
+ * @param tiers - Array of active fee tiers (sorted, validated)
+ * @returns Tuple of [lpFeeRate, protocolFeeRate, creatorFeeRate] in basis points
+ *
+ * @example
+ * ```typescript
+ * const tiers = [
+ *   { rangeStartInclusive: new BN(0), rangeEndExclusive: new BN(1_000_000_000_000), lpFeeRate: 30, protocolFeeRate: 5, creatorFeeRate: 5 },
+ *   { rangeStartInclusive: new BN(1_000_000_000_000), rangeEndExclusive: new BN('18446744073709551615'), lpFeeRate: 20, protocolFeeRate: 3, creatorFeeRate: 3 },
+ * ];
+ *
+ * // Market cap = $500K -> uses first tier (high fees)
+ * const [lp, protocol, creator] = lookupFeeTier(new BN(500_000_000_000), tiers);
+ * // Returns: [30, 5, 5]
+ *
+ * // Market cap = $5M -> uses second tier (low fees)
+ * const [lp2, protocol2, creator2] = lookupFeeTier(new BN(5_000_000_000_000), tiers);
+ * // Returns: [20, 3, 3]
+ * ```
+ */
+export declare function lookupFeeTier(marketCapUsd: BN, tiers: FeeTier[]): [number, number, number];
+/**
+ * Calculate the fee rates that would apply for a given pool state.
+ * Helper function that combines market cap calculation and tier lookup.
+ *
+ * @param quoteVaultAmount - Quote vault balance
+ * @param baseVaultAmount - Base vault balance
+ * @param baseTotalSupply - Total supply of base token
+ * @param solPriceUsd - SOL/USD price from oracle (6 decimals)
+ * @param quoteMint - Quote mint pubkey
+ * @param tiers - Array of active fee tiers
+ * @returns Tuple of [lpFeeRate, protocolFeeRate, creatorFeeRate] in basis points
+ */
+export declare function calculateFeesForPool(quoteVaultAmount: BN, baseVaultAmount: BN, baseTotalSupply: BN, solPriceUsd: BN, quoteMint: PublicKey, tiers: FeeTier[]): [number, number, number];
+//# sourceMappingURL=tiered-fees.d.ts.map

package/dist/math/tiered-fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiered-fees.d.ts","sourceRoot":"","sources":["../../src/math/tiered-fees.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,0DAA0D;AAC1D,eAAO,MAAM,SAAS,WAErB,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CACrC,gBAAgB,EAAE,EAAE,EACpB,eAAe,EAAE,EAAE,EACnB,eAAe,EAAE,EAAE,EACnB,WAAW,EAAE,EAAE,EACf,SAAS,EAAE,SAAS,GAClB,EAAE,CA6BJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAC5B,YAAY,EAAE,EAAE,EAChB,KAAK,EAAE,OAAO,EAAE,GACd,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAsB1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CACnC,gBAAgB,EAAE,EAAE,EACpB,eAAe,EAAE,EAAE,EACnB,eAAe,EAAE,EAAE,EACnB,WAAW,EAAE,EAAE,EACf,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,OAAO,EAAE,GACd,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAU1B"}