@lightconexyz/lightcone-sdk 0.1.0 → 0.2.0

package/dist/shared/fmt/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.num = exports.decimal = void 0;
+exports.decimal = __importStar(require("./decimal"));
+exports.num = __importStar(require("./num"));
+//# sourceMappingURL=index.js.map

package/dist/shared/fmt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/fmt/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAqC;AACrC,6CAA6B","sourcesContent":["export * as decimal from \"./decimal\";\nexport * as num from \"./num\";\n"]}

package/dist/shared/fmt/num.d.ts

@@ -0,0 +1,6 @@
+export declare function displayFormattedString(input: string): string;
+export declare function displayWithDecimals(value: number, decimals: number): string;
+export declare function display(value: number): string;
+export declare function toDecimalValue(value: bigint, decimals: number): number;
+export declare function fromDecimalValue(value: number, decimals: number): bigint;
+//# sourceMappingURL=num.d.ts.map

package/dist/shared/fmt/num.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"num.d.ts","sourceRoot":"","sources":["../../../src/shared/fmt/num.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAe7C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/shared/fmt/num.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.displayFormattedString = displayFormattedString;
+exports.displayWithDecimals = displayWithDecimals;
+exports.display = display;
+exports.toDecimalValue = toDecimalValue;
+exports.fromDecimalValue = fromDecimalValue;
+function displayFormattedString(input) {
+    const [rawInteger, rawFraction] = input.split(".");
+    const negative = rawInteger.startsWith("-");
+    const integer = negative ? rawInteger.slice(1) : rawInteger;
+    const withCommas = integer.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+    const fraction = rawFraction?.replace(/0+$/, "");
+    const prefix = negative ? "-" : "";
+    if (!fraction) {
+        return `${prefix}${withCommas}`;
+    }
+    return `${prefix}${withCommas}.${fraction}`;
+}
+function displayWithDecimals(value, decimals) {
+    return displayFormattedString(value.toFixed(decimals));
+}
+function display(value) {
+    if (Math.abs(value) >= 100) {
+        return displayWithDecimals(value, 0);
+    }
+    if (Math.abs(value) >= 1) {
+        return displayWithDecimals(value, 2);
+    }
+    if (value === 0) {
+        return "0";
+    }
+    const abs = Math.abs(value);
+    const exponent = Math.floor(Math.log10(abs));
+    const decimals = Math.min(Math.max(Math.abs(exponent) + 2, 2), 8);
+    return displayWithDecimals(value, decimals);
+}
+function toDecimalValue(value, decimals) {
+    return Number(value) / 10 ** decimals;
+}
+function fromDecimalValue(value, decimals) {
+    return BigInt(Math.trunc(value * 10 ** decimals));
+}
+//# sourceMappingURL=num.js.map

package/dist/shared/fmt/num.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"num.js","sourceRoot":"","sources":["../../../src/shared/fmt/num.ts"],"names":[],"mappings":";;AAAA,wDAaC;AAED,kDAEC;AAED,0BAeC;AAED,wCAEC;AAED,4CAEC;AA1CD,SAAgB,sBAAsB,CAAC,KAAa;IAClD,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,GAAG,MAAM,GAAG,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,GAAG,MAAM,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;AAC9C,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAa,EAAE,QAAgB;IACjE,OAAO,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,OAAO,CAAC,KAAa;IACnC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;QAC3B,OAAO,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,cAAc,CAAC,KAAa,EAAE,QAAgB;IAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;AACxC,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAa,EAAE,QAAgB;IAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC","sourcesContent":["export function displayFormattedString(input: string): string {\n  const [rawInteger, rawFraction] = input.split(\".\");\n  const negative = rawInteger.startsWith(\"-\");\n  const integer = negative ? rawInteger.slice(1) : rawInteger;\n  const withCommas = integer.replace(/\\B(?=(\\d{3})+(?!\\d))/g, \",\");\n  const fraction = rawFraction?.replace(/0+$/, \"\");\n  const prefix = negative ? \"-\" : \"\";\n\n  if (!fraction) {\n    return `${prefix}${withCommas}`;\n  }\n\n  return `${prefix}${withCommas}.${fraction}`;\n}\n\nexport function displayWithDecimals(value: number, decimals: number): string {\n  return displayFormattedString(value.toFixed(decimals));\n}\n\nexport function display(value: number): string {\n  if (Math.abs(value) >= 100) {\n    return displayWithDecimals(value, 0);\n  }\n  if (Math.abs(value) >= 1) {\n    return displayWithDecimals(value, 2);\n  }\n  if (value === 0) {\n    return \"0\";\n  }\n\n  const abs = Math.abs(value);\n  const exponent = Math.floor(Math.log10(abs));\n  const decimals = Math.min(Math.max(Math.abs(exponent) + 2, 2), 8);\n  return displayWithDecimals(value, decimals);\n}\n\nexport function toDecimalValue(value: bigint, decimals: number): number {\n  return Number(value) / 10 ** decimals;\n}\n\nexport function fromDecimalValue(value: number, decimals: number): bigint {\n  return BigInt(Math.trunc(value * 10 ** decimals));\n}\n"]}

package/dist/shared/index.d.ts

@@ -1,8 +1,5 @@
-/**
- * Shared utilities used across API and WebSocket modules.
- */
-export { Resolution } from "./types";
-export { parseDecimal, formatDecimal, isZero } from "./price";
-export { scalePriceSize, ScalingError, } from "./scaling";
-export type { OrderbookDecimals, ScaledAmounts } from "./scaling";
+export { asOrderBookId, asPubkeyStr, deriveOrderbookId, resolutionSeconds, sideLabel, OrderUpdateType, Resolution, Side, TimeInForce, TriggerResultStatus, TriggerStatus, TriggerType, TriggerUpdateType, type Branded, type OrderBookId, type PubkeyStr, type SubmitOrderRequest, } from "./types";
+export { formatDecimal, isZero, parseDecimal } from "./price";
+export { alignPriceToTick, scalePriceSize, scalePriceSizeLegacy, ScalingError, type LegacyScaledAmounts, type OrderbookDecimals, type ScaledAmounts, } from "./scaling";
+export { scalePriceSizeLegacy as scalePriceSizeV1 } from "./scaling";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,UAAU,EACV,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/shared/index.js

@@ -1,18 +1,30 @@
 "use strict";
-/**
- * Shared utilities used across API and WebSocket modules.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScalingError = exports.scalePriceSize = exports.isZero = exports.formatDecimal = exports.parseDecimal = exports.Resolution = void 0;
+exports.scalePriceSizeV1 = exports.ScalingError = exports.scalePriceSizeLegacy = exports.scalePriceSize = exports.alignPriceToTick = exports.parseDecimal = exports.isZero = exports.formatDecimal = exports.TriggerUpdateType = exports.TriggerType = exports.TriggerStatus = exports.TriggerResultStatus = exports.TimeInForce = exports.Side = exports.Resolution = exports.OrderUpdateType = exports.sideLabel = exports.resolutionSeconds = exports.deriveOrderbookId = exports.asPubkeyStr = exports.asOrderBookId = void 0;
 var types_1 = require("./types");
+Object.defineProperty(exports, "asOrderBookId", { enumerable: true, get: function () { return types_1.asOrderBookId; } });
+Object.defineProperty(exports, "asPubkeyStr", { enumerable: true, get: function () { return types_1.asPubkeyStr; } });
+Object.defineProperty(exports, "deriveOrderbookId", { enumerable: true, get: function () { return types_1.deriveOrderbookId; } });
+Object.defineProperty(exports, "resolutionSeconds", { enumerable: true, get: function () { return types_1.resolutionSeconds; } });
+Object.defineProperty(exports, "sideLabel", { enumerable: true, get: function () { return types_1.sideLabel; } });
+Object.defineProperty(exports, "OrderUpdateType", { enumerable: true, get: function () { return types_1.OrderUpdateType; } });
 Object.defineProperty(exports, "Resolution", { enumerable: true, get: function () { return types_1.Resolution; } });
+Object.defineProperty(exports, "Side", { enumerable: true, get: function () { return types_1.Side; } });
+Object.defineProperty(exports, "TimeInForce", { enumerable: true, get: function () { return types_1.TimeInForce; } });
+Object.defineProperty(exports, "TriggerResultStatus", { enumerable: true, get: function () { return types_1.TriggerResultStatus; } });
+Object.defineProperty(exports, "TriggerStatus", { enumerable: true, get: function () { return types_1.TriggerStatus; } });
+Object.defineProperty(exports, "TriggerType", { enumerable: true, get: function () { return types_1.TriggerType; } });
+Object.defineProperty(exports, "TriggerUpdateType", { enumerable: true, get: function () { return types_1.TriggerUpdateType; } });
 var price_1 = require("./price");
-Object.defineProperty(exports, "parseDecimal", { enumerable: true, get: function () { return price_1.parseDecimal; } });
 Object.defineProperty(exports, "formatDecimal", { enumerable: true, get: function () { return price_1.formatDecimal; } });
 Object.defineProperty(exports, "isZero", { enumerable: true, get: function () { return price_1.isZero; } });
+Object.defineProperty(exports, "parseDecimal", { enumerable: true, get: function () { return price_1.parseDecimal; } });
 var scaling_1 = require("./scaling");
+Object.defineProperty(exports, "alignPriceToTick", { enumerable: true, get: function () { return scaling_1.alignPriceToTick; } });
 Object.defineProperty(exports, "scalePriceSize", { enumerable: true, get: function () { return scaling_1.scalePriceSize; } });
+Object.defineProperty(exports, "scalePriceSizeLegacy", { enumerable: true, get: function () { return scaling_1.scalePriceSizeLegacy; } });
 Object.defineProperty(exports, "ScalingError", { enumerable: true, get: function () { return scaling_1.ScalingError; } });
-// deriveOrderbookId is exported from the program module (orders.ts)
-// Re-exported here for convenience via the shared module path
+// Backward-compatible name from v1.
+var scaling_2 = require("./scaling");
+Object.defineProperty(exports, "scalePriceSizeV1", { enumerable: true, get: function () { return scaling_2.scalePriceSizeLegacy; } });
 //# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAAqC;AAA5B,mGAAA,UAAU,OAAA;AACnB,iCAA8D;AAArD,qGAAA,YAAY,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,+FAAA,MAAM,OAAA;AAC5C,qCAGmB;AAFjB,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AAId,oEAAoE;AACpE,8DAA8D","sourcesContent":["/**\n * Shared utilities used across API and WebSocket modules.\n */\n\nexport { Resolution } from \"./types\";\nexport { parseDecimal, formatDecimal, isZero } from \"./price\";\nexport {\n  scalePriceSize,\n  ScalingError,\n} from \"./scaling\";\nexport type { OrderbookDecimals, ScaledAmounts } from \"./scaling\";\n\n// deriveOrderbookId is exported from the program module (orders.ts)\n// Re-exported here for convenience via the shared module path\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":";;;AAAA,iCAkBiB;AAjBf,sGAAA,aAAa,OAAA;AACb,oGAAA,WAAW,OAAA;AACX,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AACjB,kGAAA,SAAS,OAAA;AACT,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AACV,6FAAA,IAAI,OAAA;AACJ,oGAAA,WAAW,OAAA;AACX,4GAAA,mBAAmB,OAAA;AACnB,sGAAA,aAAa,OAAA;AACb,oGAAA,WAAW,OAAA;AACX,0GAAA,iBAAiB,OAAA;AAOnB,iCAA8D;AAArD,sGAAA,aAAa,OAAA;AAAE,+FAAA,MAAM,OAAA;AAAE,qGAAA,YAAY,OAAA;AAE5C,qCAQmB;AAPjB,2GAAA,gBAAgB,OAAA;AAChB,yGAAA,cAAc,OAAA;AACd,+GAAA,oBAAoB,OAAA;AACpB,uGAAA,YAAY,OAAA;AAMd,oCAAoC;AACpC,qCAAqE;AAA5D,2GAAA,oBAAoB,OAAoB","sourcesContent":["export {\n  asOrderBookId,\n  asPubkeyStr,\n  deriveOrderbookId,\n  resolutionSeconds,\n  sideLabel,\n  OrderUpdateType,\n  Resolution,\n  Side,\n  TimeInForce,\n  TriggerResultStatus,\n  TriggerStatus,\n  TriggerType,\n  TriggerUpdateType,\n  type Branded,\n  type OrderBookId,\n  type PubkeyStr,\n  type SubmitOrderRequest,\n} from \"./types\";\n\nexport { formatDecimal, isZero, parseDecimal } from \"./price\";\n\nexport {\n  alignPriceToTick,\n  scalePriceSize,\n  scalePriceSizeLegacy,\n  ScalingError,\n  type LegacyScaledAmounts,\n  type OrderbookDecimals,\n  type ScaledAmounts,\n} from \"./scaling\";\n\n// Backward-compatible name from v1.\nexport { scalePriceSizeLegacy as scalePriceSizeV1 } from \"./scaling\";\n"]}

package/dist/shared/price.d.ts

@@ -1,41 +1,13 @@
 /**
- * Price utilities for the Lightcone SDK.
- *
- * This module provides helper functions for working with decimal string prices.
- * The SDK uses String types for price/size/balance fields to preserve
- * the exact decimal representation from the server, as different tokens
- * have different decimal places (USDC=6, SOL=9, BTC=8, etc.).
+ * Parse a decimal string to a number.
  */
+export declare function parseDecimal(value: string): number;
 /**
- * Parse a decimal string to number for calculations.
- *
- * @example
- * ```typescript
- * parseDecimal("0.500000"); // returns 0.5
- * parseDecimal("1.000000"); // returns 1.0
- * ```
- */
-export declare function parseDecimal(s: string): number;
-/**
- * Format a number as a decimal string with specified precision.
- *
- * @example
- * ```typescript
- * formatDecimal(0.5, 6);  // returns "0.500000"
- * formatDecimal(1.0, 6);  // returns "1.000000"
- * ```
+ * Format a number to a fixed decimal string.
  */
 export declare function formatDecimal(value: number, precision: number): string;
 /**
- * Check if a decimal string represents zero.
- *
- * @example
- * ```typescript
- * isZero("0");        // true
- * isZero("0.0");      // true
- * isZero("0.000000"); // true
- * isZero("0.001");    // false
- * ```
+ * Whether a decimal string represents numeric zero.
  */
-export declare function isZero(s: string): boolean;
+export declare function isZero(value: string): boolean;
 //# sourceMappingURL=price.d.ts.map

package/dist/shared/price.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../../src/shared/price.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAGzC"}
+{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../../src/shared/price.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG7C"}

package/dist/shared/price.js

@@ -1,57 +1,29 @@
 "use strict";
-/**
- * Price utilities for the Lightcone SDK.
- *
- * This module provides helper functions for working with decimal string prices.
- * The SDK uses String types for price/size/balance fields to preserve
- * the exact decimal representation from the server, as different tokens
- * have different decimal places (USDC=6, SOL=9, BTC=8, etc.).
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseDecimal = parseDecimal;
 exports.formatDecimal = formatDecimal;
 exports.isZero = isZero;
 /**
- * Parse a decimal string to number for calculations.
- *
- * @example
- * ```typescript
- * parseDecimal("0.500000"); // returns 0.5
- * parseDecimal("1.000000"); // returns 1.0
- * ```
+ * Parse a decimal string to a number.
  */
-function parseDecimal(s) {
-    const result = parseFloat(s);
-    if (isNaN(result)) {
-        throw new Error(`Invalid decimal string: ${s}`);
+function parseDecimal(value) {
+    const parsed = Number.parseFloat(value);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`Invalid decimal string: ${value}`);
     }
-    return result;
+    return parsed;
 }
 /**
- * Format a number as a decimal string with specified precision.
- *
- * @example
- * ```typescript
- * formatDecimal(0.5, 6);  // returns "0.500000"
- * formatDecimal(1.0, 6);  // returns "1.000000"
- * ```
+ * Format a number to a fixed decimal string.
  */
 function formatDecimal(value, precision) {
     return value.toFixed(precision);
 }
 /**
- * Check if a decimal string represents zero.
- *
- * @example
- * ```typescript
- * isZero("0");        // true
- * isZero("0.0");      // true
- * isZero("0.000000"); // true
- * isZero("0.001");    // false
- * ```
+ * Whether a decimal string represents numeric zero.
  */
-function isZero(s) {
-    const parsed = parseFloat(s);
-    return !isNaN(parsed) && parsed === 0;
+function isZero(value) {
+    const parsed = Number.parseFloat(value);
+    return !Number.isNaN(parsed) && parsed === 0;
 }
 //# sourceMappingURL=price.js.map

package/dist/shared/price.js.map

@@ -1 +1 @@
-{"version":3,"file":"price.js","sourceRoot":"","sources":["../../src/shared/price.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAWH,oCAMC;AAWD,sCAEC;AAaD,wBAGC;AA5CD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,CAAS;IACpC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,KAAa,EAAE,SAAiB;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,MAAM,CAAC,CAAS;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC;AACxC,CAAC","sourcesContent":["/**\n * Price utilities for the Lightcone SDK.\n *\n * This module provides helper functions for working with decimal string prices.\n * The SDK uses String types for price/size/balance fields to preserve\n * the exact decimal representation from the server, as different tokens\n * have different decimal places (USDC=6, SOL=9, BTC=8, etc.).\n */\n\n/**\n * Parse a decimal string to number for calculations.\n *\n * @example\n * ```typescript\n * parseDecimal(\"0.500000\"); // returns 0.5\n * parseDecimal(\"1.000000\"); // returns 1.0\n * ```\n */\nexport function parseDecimal(s: string): number {\n  const result = parseFloat(s);\n  if (isNaN(result)) {\n    throw new Error(`Invalid decimal string: ${s}`);\n  }\n  return result;\n}\n\n/**\n * Format a number as a decimal string with specified precision.\n *\n * @example\n * ```typescript\n * formatDecimal(0.5, 6);  // returns \"0.500000\"\n * formatDecimal(1.0, 6);  // returns \"1.000000\"\n * ```\n */\nexport function formatDecimal(value: number, precision: number): string {\n  return value.toFixed(precision);\n}\n\n/**\n * Check if a decimal string represents zero.\n *\n * @example\n * ```typescript\n * isZero(\"0\");        // true\n * isZero(\"0.0\");      // true\n * isZero(\"0.000000\"); // true\n * isZero(\"0.001\");    // false\n * ```\n */\nexport function isZero(s: string): boolean {\n  const parsed = parseFloat(s);\n  return !isNaN(parsed) && parsed === 0;\n}\n\n"]}
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../src/shared/price.ts"],"names":[],"mappings":";;AAGA,oCAMC;AAKD,sCAEC;AAKD,wBAGC;AAxBD;;GAEG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAa,EAAE,SAAiB;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,KAAa;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["/**\n * Parse a decimal string to a number.\n */\nexport function parseDecimal(value: string): number {\n  const parsed = Number.parseFloat(value);\n  if (Number.isNaN(parsed)) {\n    throw new Error(`Invalid decimal string: ${value}`);\n  }\n  return parsed;\n}\n\n/**\n * Format a number to a fixed decimal string.\n */\nexport function formatDecimal(value: number, precision: number): string {\n  return value.toFixed(precision);\n}\n\n/**\n * Whether a decimal string represents numeric zero.\n */\nexport function isZero(value: string): boolean {\n  const parsed = Number.parseFloat(value);\n  return !Number.isNaN(parsed) && parsed === 0;\n}\n"]}

package/dist/shared/scaling.d.ts

@@ -1,45 +1,32 @@
+import Decimal from "decimal.js";
 import { OrderSide } from "../program/types";
-/**
- * Orderbook decimal configuration
- */
 export interface OrderbookDecimals {
     orderbookId: string;
     baseDecimals: number;
     quoteDecimals: number;
     priceDecimals: number;
+    tickSize?: bigint;
 }
-/**
- * Scaled amounts result
- */
 export interface ScaledAmounts {
+    amountIn: bigint;
+    amountOut: bigint;
     makerAmount: bigint;
     takerAmount: bigint;
 }
-/**
- * Error thrown during price/size scaling
- */
 export declare class ScalingError extends Error {
     constructor(message: string);
-    static zeroPriceOrSize(): ScalingError;
-    static negativeValue(field: string): ScalingError;
-    static overflow(field: string): ScalingError;
+    static nonPositivePrice(value: string): ScalingError;
+    static nonPositiveSize(value: string): ScalingError;
+    static overflow(context: string): ScalingError;
+    static zeroAmount(): ScalingError;
+    static fractionalAmount(value: string): ScalingError;
+    static invalidDecimal(input: string, reason: string): ScalingError;
 }
-/**
- * Scale price and size to maker_amount and taker_amount using exact decimal arithmetic.
- *
- * For BID orders (buying base with quote):
- *   - maker_amount = price * size * 10^quoteDecimals (what maker gives in quote tokens)
- *   - taker_amount = size * 10^baseDecimals (what maker receives in base tokens)
- *
- * For ASK orders (selling base for quote):
- *   - maker_amount = size * 10^baseDecimals (what maker gives in base tokens)
- *   - taker_amount = price * size * 10^quoteDecimals (what maker receives in quote tokens)
- *
- * @param priceStr - Price as a decimal string (e.g., "0.75")
- * @param sizeStr - Size as a decimal string (e.g., "100")
- * @param side - Order side (BID or ASK)
- * @param decimals - Orderbook decimal configuration
- * @returns Scaled maker_amount and taker_amount as bigints
- */
-export declare function scalePriceSize(priceStr: string, sizeStr: string, side: OrderSide, decimals: OrderbookDecimals): ScaledAmounts;
+export declare function alignPriceToTick(price: Decimal, decimals: OrderbookDecimals): Decimal;
+export declare function scalePriceSize(priceInput: string | Decimal, sizeInput: string | Decimal, side: OrderSide, decimals: OrderbookDecimals): ScaledAmounts;
+export interface LegacyScaledAmounts {
+    makerAmount: bigint;
+    takerAmount: bigint;
+}
+export declare function scalePriceSizeLegacy(price: string, size: string, side: OrderSide, decimals: OrderbookDecimals): LegacyScaledAmounts;
 //# sourceMappingURL=scaling.d.ts.map

package/dist/shared/scaling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaling.d.ts","sourceRoot":"","sources":["../../src/shared/scaling.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,eAAe,IAAI,YAAY;IAItC,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAIjD,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;CAG7C;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,aAAa,CAyCf"}
+{"version":3,"file":"scaling.d.ts","sourceRoot":"","sources":["../../src/shared/scaling.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAIpD,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAInD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAI9C,MAAM,CAAC,UAAU,IAAI,YAAY;IAIjC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAIpD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;CAGnE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAWrF;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,GAAG,OAAO,EAC5B,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,aAAa,CA0Cf;AA8BD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,mBAAmB,CAMrB"}

package/dist/shared/scaling.js

@@ -4,81 +4,112 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScalingError = void 0;
+exports.alignPriceToTick = alignPriceToTick;
 exports.scalePriceSize = scalePriceSize;
+exports.scalePriceSizeLegacy = scalePriceSizeLegacy;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const types_1 = require("../program/types");
-/**
- * Error thrown during price/size scaling
- */
+const U64_MAX = (1n << 64n) - 1n;
 class ScalingError extends Error {
     constructor(message) {
         super(message);
         this.name = "ScalingError";
     }
-    static zeroPriceOrSize() {
-        return new ScalingError("Price and size must be non-zero");
+    static nonPositivePrice(value) {
+        return new ScalingError(`Price must be positive, got ${value}`);
+    }
+    static nonPositiveSize(value) {
+        return new ScalingError(`Size must be positive, got ${value}`);
+    }
+    static overflow(context) {
+        return new ScalingError(`Overflow: ${context}`);
     }
-    static negativeValue(field) {
-        return new ScalingError(`${field} must be positive`);
+    static zeroAmount() {
+        return new ScalingError("Computed amount is zero");
     }
-    static overflow(field) {
-        return new ScalingError(`${field} exceeds u64 range`);
+    static fractionalAmount(value) {
+        return new ScalingError(`Fractional lamports not allowed: ${value}`);
+    }
+    static invalidDecimal(input, reason) {
+        return new ScalingError(`Invalid decimal '${input}': ${reason}`);
     }
 }
 exports.ScalingError = ScalingError;
-const U64_MAX = (1n << 64n) - 1n;
-/**
- * Scale price and size to maker_amount and taker_amount using exact decimal arithmetic.
- *
- * For BID orders (buying base with quote):
- *   - maker_amount = price * size * 10^quoteDecimals (what maker gives in quote tokens)
- *   - taker_amount = size * 10^baseDecimals (what maker receives in base tokens)
- *
- * For ASK orders (selling base for quote):
- *   - maker_amount = size * 10^baseDecimals (what maker gives in base tokens)
- *   - taker_amount = price * size * 10^quoteDecimals (what maker receives in quote tokens)
- *
- * @param priceStr - Price as a decimal string (e.g., "0.75")
- * @param sizeStr - Size as a decimal string (e.g., "100")
- * @param side - Order side (BID or ASK)
- * @param decimals - Orderbook decimal configuration
- * @returns Scaled maker_amount and taker_amount as bigints
- */
-function scalePriceSize(priceStr, sizeStr, side, decimals) {
-    const price = new decimal_js_1.default(priceStr);
-    const size = new decimal_js_1.default(sizeStr);
-    if (price.isZero() || size.isZero()) {
-        throw ScalingError.zeroPriceOrSize();
-    }
-    if (price.isNegative()) {
-        throw ScalingError.negativeValue("price");
-    }
-    if (size.isNegative()) {
-        throw ScalingError.negativeValue("size");
-    }
-    const baseScale = new decimal_js_1.default(10).pow(decimals.baseDecimals);
-    const quoteScale = new decimal_js_1.default(10).pow(decimals.quoteDecimals);
-    const baseAmount = size.mul(baseScale).floor();
-    const quoteAmount = price.mul(size).mul(quoteScale).floor();
-    const baseAmountBigInt = BigInt(baseAmount.toFixed(0));
-    const quoteAmountBigInt = BigInt(quoteAmount.toFixed(0));
-    if (baseAmountBigInt > U64_MAX) {
-        throw ScalingError.overflow("base amount");
-    }
-    if (quoteAmountBigInt > U64_MAX) {
-        throw ScalingError.overflow("quote amount");
+function alignPriceToTick(price, decimals) {
+    const tickSize = decimals.tickSize ?? 0n;
+    if (tickSize <= 1n) {
+        return price;
+    }
+    const quoteMultiplier = new decimal_js_1.default(10).pow(decimals.quoteDecimals);
+    const tick = new decimal_js_1.default(tickSize.toString());
+    const lamports = price.mul(quoteMultiplier).trunc();
+    const aligned = lamports.div(tick).trunc().mul(tick);
+    return aligned.div(quoteMultiplier);
+}
+function scalePriceSize(priceInput, sizeInput, side, decimals) {
+    const price = normalizeDecimal(priceInput, "price");
+    const size = normalizeDecimal(sizeInput, "size");
+    if (price.lte(0)) {
+        throw ScalingError.nonPositivePrice(price.toString());
+    }
+    if (size.lte(0)) {
+        throw ScalingError.nonPositiveSize(size.toString());
+    }
+    const baseMultiplier = new decimal_js_1.default(10).pow(decimals.baseDecimals);
+    const quoteMultiplier = new decimal_js_1.default(10).pow(decimals.quoteDecimals);
+    const baseLamports = size.mul(baseMultiplier);
+    const quoteLamports = price.mul(size).mul(quoteMultiplier);
+    assertWhole(baseLamports, "base_lamports");
+    assertWhole(quoteLamports, "quote_lamports");
+    const base = toU64(baseLamports, "base_lamports");
+    const quote = toU64(quoteLamports, "quote_lamports");
+    if (base === 0n || quote === 0n) {
+        throw ScalingError.zeroAmount();
     }
     if (side === types_1.OrderSide.BID) {
         return {
-            makerAmount: quoteAmountBigInt,
-            takerAmount: baseAmountBigInt,
+            amountIn: quote,
+            amountOut: base,
+            makerAmount: quote,
+            takerAmount: base,
         };
     }
-    else {
-        return {
-            makerAmount: baseAmountBigInt,
-            takerAmount: quoteAmountBigInt,
-        };
+    return {
+        amountIn: base,
+        amountOut: quote,
+        makerAmount: base,
+        takerAmount: quote,
+    };
+}
+function normalizeDecimal(value, field) {
+    if (value instanceof decimal_js_1.default) {
+        return value;
+    }
+    try {
+        return new decimal_js_1.default(value);
     }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw ScalingError.invalidDecimal(value, reason || field);
+    }
+}
+function assertWhole(value, label) {
+    if (!value.isInteger()) {
+        throw ScalingError.fractionalAmount(`${label} = ${value.toString()}`);
+    }
+}
+function toU64(value, label) {
+    const bigint = BigInt(value.toFixed(0));
+    if (bigint < 0n || bigint > U64_MAX) {
+        throw ScalingError.overflow(`${label} ${value.toString()} does not fit in u64`);
+    }
+    return bigint;
+}
+function scalePriceSizeLegacy(price, size, side, decimals) {
+    const scaled = scalePriceSize(price, size, side, decimals);
+    return {
+        makerAmount: scaled.amountIn,
+        takerAmount: scaled.amountOut,
+    };
 }
 //# sourceMappingURL=scaling.js.map

package/dist/shared/scaling.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaling.js","sourceRoot":"","sources":["../../src/shared/scaling.ts"],"names":[],"mappings":";;;;;;AA8DA,wCA8CC;AA5GD,4DAAiC;AACjC,4CAA6C;AAoB7C;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,eAAe;QACpB,OAAO,IAAI,YAAY,CAAC,iCAAiC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,KAAa;QAChC,OAAO,IAAI,YAAY,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,KAAa;QAC3B,OAAO,IAAI,YAAY,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACxD,CAAC;CACF;AAjBD,oCAiBC;AAED,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AAEjC;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,cAAc,CAC5B,QAAgB,EAChB,OAAe,EACf,IAAe,EACf,QAA2B;IAE3B,MAAM,KAAK,GAAG,IAAI,oBAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,oBAAO,CAAC,OAAO,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,MAAM,YAAY,CAAC,eAAe,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;QACvB,MAAM,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QACtB,MAAM,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAO,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,oBAAO,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC;IAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;IAE5D,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,iBAAiB,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,IAAI,gBAAgB,GAAG,OAAO,EAAE,CAAC;QAC/B,MAAM,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,iBAAiB,GAAG,OAAO,EAAE,CAAC;QAChC,MAAM,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,IAAI,KAAK,iBAAS,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO;YACL,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EAAE,gBAAgB;SAC9B,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO;YACL,WAAW,EAAE,gBAAgB;YAC7B,WAAW,EAAE,iBAAiB;SAC/B,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import Decimal from \"decimal.js\";\nimport { OrderSide } from \"../program/types\";\n\n/**\n * Orderbook decimal configuration\n */\nexport interface OrderbookDecimals {\n  orderbookId: string;\n  baseDecimals: number;\n  quoteDecimals: number;\n  priceDecimals: number;\n}\n\n/**\n * Scaled amounts result\n */\nexport interface ScaledAmounts {\n  makerAmount: bigint;\n  takerAmount: bigint;\n}\n\n/**\n * Error thrown during price/size scaling\n */\nexport class ScalingError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ScalingError\";\n  }\n\n  static zeroPriceOrSize(): ScalingError {\n    return new ScalingError(\"Price and size must be non-zero\");\n  }\n\n  static negativeValue(field: string): ScalingError {\n    return new ScalingError(`${field} must be positive`);\n  }\n\n  static overflow(field: string): ScalingError {\n    return new ScalingError(`${field} exceeds u64 range`);\n  }\n}\n\nconst U64_MAX = (1n << 64n) - 1n;\n\n/**\n * Scale price and size to maker_amount and taker_amount using exact decimal arithmetic.\n *\n * For BID orders (buying base with quote):\n *   - maker_amount = price * size * 10^quoteDecimals (what maker gives in quote tokens)\n *   - taker_amount = size * 10^baseDecimals (what maker receives in base tokens)\n *\n * For ASK orders (selling base for quote):\n *   - maker_amount = size * 10^baseDecimals (what maker gives in base tokens)\n *   - taker_amount = price * size * 10^quoteDecimals (what maker receives in quote tokens)\n *\n * @param priceStr - Price as a decimal string (e.g., \"0.75\")\n * @param sizeStr - Size as a decimal string (e.g., \"100\")\n * @param side - Order side (BID or ASK)\n * @param decimals - Orderbook decimal configuration\n * @returns Scaled maker_amount and taker_amount as bigints\n */\nexport function scalePriceSize(\n  priceStr: string,\n  sizeStr: string,\n  side: OrderSide,\n  decimals: OrderbookDecimals\n): ScaledAmounts {\n  const price = new Decimal(priceStr);\n  const size = new Decimal(sizeStr);\n\n  if (price.isZero() || size.isZero()) {\n    throw ScalingError.zeroPriceOrSize();\n  }\n  if (price.isNegative()) {\n    throw ScalingError.negativeValue(\"price\");\n  }\n  if (size.isNegative()) {\n    throw ScalingError.negativeValue(\"size\");\n  }\n\n  const baseScale = new Decimal(10).pow(decimals.baseDecimals);\n  const quoteScale = new Decimal(10).pow(decimals.quoteDecimals);\n\n  const baseAmount = size.mul(baseScale).floor();\n  const quoteAmount = price.mul(size).mul(quoteScale).floor();\n\n  const baseAmountBigInt = BigInt(baseAmount.toFixed(0));\n  const quoteAmountBigInt = BigInt(quoteAmount.toFixed(0));\n\n  if (baseAmountBigInt > U64_MAX) {\n    throw ScalingError.overflow(\"base amount\");\n  }\n  if (quoteAmountBigInt > U64_MAX) {\n    throw ScalingError.overflow(\"quote amount\");\n  }\n\n  if (side === OrderSide.BID) {\n    return {\n      makerAmount: quoteAmountBigInt,\n      takerAmount: baseAmountBigInt,\n    };\n  } else {\n    return {\n      makerAmount: baseAmountBigInt,\n      takerAmount: quoteAmountBigInt,\n    };\n  }\n}\n"]}
+{"version":3,"file":"scaling.js","sourceRoot":"","sources":["../../src/shared/scaling.ts"],"names":[],"mappings":"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","sourcesContent":["import Decimal from \"decimal.js\";\nimport { OrderSide } from \"../program/types\";\n\nexport interface OrderbookDecimals {\n  orderbookId: string;\n  baseDecimals: number;\n  quoteDecimals: number;\n  priceDecimals: number;\n  tickSize?: bigint;\n}\n\nexport interface ScaledAmounts {\n  amountIn: bigint;\n  amountOut: bigint;\n  // Backward-compatible aliases used by v1 builder code.\n  makerAmount: bigint;\n  takerAmount: bigint;\n}\n\nconst U64_MAX = (1n << 64n) - 1n;\n\nexport class ScalingError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ScalingError\";\n  }\n\n  static nonPositivePrice(value: string): ScalingError {\n    return new ScalingError(`Price must be positive, got ${value}`);\n  }\n\n  static nonPositiveSize(value: string): ScalingError {\n    return new ScalingError(`Size must be positive, got ${value}`);\n  }\n\n  static overflow(context: string): ScalingError {\n    return new ScalingError(`Overflow: ${context}`);\n  }\n\n  static zeroAmount(): ScalingError {\n    return new ScalingError(\"Computed amount is zero\");\n  }\n\n  static fractionalAmount(value: string): ScalingError {\n    return new ScalingError(`Fractional lamports not allowed: ${value}`);\n  }\n\n  static invalidDecimal(input: string, reason: string): ScalingError {\n    return new ScalingError(`Invalid decimal '${input}': ${reason}`);\n  }\n}\n\nexport function alignPriceToTick(price: Decimal, decimals: OrderbookDecimals): Decimal {\n  const tickSize = decimals.tickSize ?? 0n;\n  if (tickSize <= 1n) {\n    return price;\n  }\n\n  const quoteMultiplier = new Decimal(10).pow(decimals.quoteDecimals);\n  const tick = new Decimal(tickSize.toString());\n  const lamports = price.mul(quoteMultiplier).trunc();\n  const aligned = lamports.div(tick).trunc().mul(tick);\n  return aligned.div(quoteMultiplier);\n}\n\nexport function scalePriceSize(\n  priceInput: string | Decimal,\n  sizeInput: string | Decimal,\n  side: OrderSide,\n  decimals: OrderbookDecimals\n): ScaledAmounts {\n  const price = normalizeDecimal(priceInput, \"price\");\n  const size = normalizeDecimal(sizeInput, \"size\");\n\n  if (price.lte(0)) {\n    throw ScalingError.nonPositivePrice(price.toString());\n  }\n  if (size.lte(0)) {\n    throw ScalingError.nonPositiveSize(size.toString());\n  }\n\n  const baseMultiplier = new Decimal(10).pow(decimals.baseDecimals);\n  const quoteMultiplier = new Decimal(10).pow(decimals.quoteDecimals);\n\n  const baseLamports = size.mul(baseMultiplier);\n  const quoteLamports = price.mul(size).mul(quoteMultiplier);\n\n  assertWhole(baseLamports, \"base_lamports\");\n  assertWhole(quoteLamports, \"quote_lamports\");\n\n  const base = toU64(baseLamports, \"base_lamports\");\n  const quote = toU64(quoteLamports, \"quote_lamports\");\n\n  if (base === 0n || quote === 0n) {\n    throw ScalingError.zeroAmount();\n  }\n\n  if (side === OrderSide.BID) {\n    return {\n      amountIn: quote,\n      amountOut: base,\n      makerAmount: quote,\n      takerAmount: base,\n    };\n  }\n\n  return {\n    amountIn: base,\n    amountOut: quote,\n    makerAmount: base,\n    takerAmount: quote,\n  };\n}\n\nfunction normalizeDecimal(value: string | Decimal, field: string): Decimal {\n  if (value instanceof Decimal) {\n    return value;\n  }\n\n  try {\n    return new Decimal(value);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    throw ScalingError.invalidDecimal(value, reason || field);\n  }\n}\n\nfunction assertWhole(value: Decimal, label: string): void {\n  if (!value.isInteger()) {\n    throw ScalingError.fractionalAmount(`${label} = ${value.toString()}`);\n  }\n}\n\nfunction toU64(value: Decimal, label: string): bigint {\n  const bigint = BigInt(value.toFixed(0));\n  if (bigint < 0n || bigint > U64_MAX) {\n    throw ScalingError.overflow(`${label} ${value.toString()} does not fit in u64`);\n  }\n  return bigint;\n}\n\n// Legacy aliases kept for existing integrations.\nexport interface LegacyScaledAmounts {\n  makerAmount: bigint;\n  takerAmount: bigint;\n}\n\nexport function scalePriceSizeLegacy(\n  price: string,\n  size: string,\n  side: OrderSide,\n  decimals: OrderbookDecimals\n): LegacyScaledAmounts {\n  const scaled = scalePriceSize(price, size, side, decimals);\n  return {\n    makerAmount: scaled.amountIn,\n    takerAmount: scaled.amountOut,\n  };\n}\n"]}