@picon-finance/dlmm-sdk 1.13.0 → 1.14.0

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { DistributionMode } from "./generated/types/distributionMode";
 export * as events from "./events";
 export * from "./entities";
 export * from "./utils/constants";
+export * from "./utils/price";
 export { NATIVE_MINT_ADDRESS } from "./utils/ata";
 export type { QuoteOutput, TransferFee, FeeRates } from "./quote";
 export * from "./program_addresses";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClE,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClE,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -3,5 +3,6 @@ export { DistributionMode } from "./generated/types/distributionMode";
 export * as events from "./events";
 export * from "./entities";
 export * from "./utils/constants";
+export * from "./utils/price";
 export { NATIVE_MINT_ADDRESS } from "./utils/ata";
 export * from "./program_addresses";

package/dist/utils/price.d.ts

@@ -0,0 +1,4 @@
+export declare function getBaseBinPrice(binStep: number): bigint;
+export declare function getBinPrice(baseBinPrice: bigint, binId: number): bigint | undefined;
+export declare function getBinPriceFromStep(binStep: number, binId: number): bigint | undefined;
+//# sourceMappingURL=price.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"price.d.ts","sourceRoot":"","sources":["../../src/utils/price.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBnF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtF"}

package/dist/utils/price.js

@@ -0,0 +1,27 @@
+import { MAX_BASIS_POINTS } from "./constants";
+import { expBySquaring, MAX, MAX_EXPONENTIAL, ONE, SCALE_OFFSET } from "./u64x64";
+export function getBaseBinPrice(binStep) {
+    const priceStep = (BigInt(binStep) << SCALE_OFFSET) / BigInt(MAX_BASIS_POINTS);
+    return ONE + priceStep;
+}
+export function getBinPrice(baseBinPrice, binId) {
+    if (baseBinPrice < 0n || baseBinPrice > MAX) {
+        throw new Error(`getBinPrice: baseBinPrice out of u128 range (${baseBinPrice})`);
+    }
+    if (baseBinPrice <= ONE)
+        return;
+    if (binId === 0)
+        return ONE;
+    const invert = binId > 0;
+    const absBinId = Math.abs(binId);
+    if (absBinId >= MAX_EXPONENTIAL)
+        return;
+    const invertedBase = MAX / baseBinPrice;
+    const price = expBySquaring(invertedBase, absBinId);
+    if (price === 0n)
+        return;
+    return invert ? MAX / price : price;
+}
+export function getBinPriceFromStep(binStep, binId) {
+    return getBinPrice(getBaseBinPrice(binStep), binId);
+}

package/dist/utils/u64x64.d.ts

@@ -0,0 +1,6 @@
+export declare const SCALE_OFFSET = 64n;
+export declare const ONE: bigint;
+export declare const MAX: bigint;
+export declare const MAX_EXPONENTIAL = 524288;
+export declare function expBySquaring(base: bigint, exp: number): bigint;
+//# sourceMappingURL=u64x64.d.ts.map

package/dist/utils/u64x64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"u64x64.d.ts","sourceRoot":"","sources":["../../src/utils/u64x64.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,GAAG,QAAqB,CAAC;AACtC,eAAO,MAAM,GAAG,QAAoB,CAAC;AACrC,eAAO,MAAM,eAAe,SAAU,CAAC;AAQvC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAgB/D"}

package/dist/utils/u64x64.js

@@ -0,0 +1,25 @@
+export const SCALE_OFFSET = 64n;
+export const ONE = 1n << SCALE_OFFSET;
+export const MAX = (1n << 128n) - 1n; // u128::MAX
+export const MAX_EXPONENTIAL = 0x80000; // 2^19
+function mulU128(a, b) {
+    const product = a * b;
+    if (product > MAX)
+        throw new Error("u64x64: u128 multiplication overflow");
+    return product;
+}
+export function expBySquaring(base, exp) {
+    let result = ONE;
+    let remainingBits = 32 - Math.clz32(exp);
+    for (let bit = 0x1; bit <= 0x40000; bit <<= 1) {
+        if (exp & bit) {
+            result = mulU128(result, base) >> SCALE_OFFSET;
+        }
+        remainingBits -= 1;
+        if (remainingBits === 0) {
+            return result;
+        }
+        base = mulU128(base, base) >> SCALE_OFFSET;
+    }
+    throw new Error(`u64x64.expBySquaring: exp out of range (${exp})`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picon-finance/dlmm-sdk",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Typescript SDK for interacting with the Picon DLMM protocol",
   "author": "Picon Finance",
   "license": "MIT",

package/src/index.ts

@@ -3,6 +3,7 @@ export { DistributionMode } from "./generated/types/distributionMode";
 export * as events from "./events";
 export * from "./entities";
 export * from "./utils/constants";
+export * from "./utils/price";
 export { NATIVE_MINT_ADDRESS } from "./utils/ata";
 export type { QuoteOutput, TransferFee, FeeRates } from "./quote";
 export * from "./program_addresses";

package/src/utils/price.ts

@@ -0,0 +1,32 @@
+import { MAX_BASIS_POINTS } from "./constants";
+import { expBySquaring, MAX, MAX_EXPONENTIAL, ONE, SCALE_OFFSET } from "./u64x64";
+
+export function getBaseBinPrice(binStep: number): bigint {
+    const priceStep = (BigInt(binStep) << SCALE_OFFSET) / BigInt(MAX_BASIS_POINTS);
+    return ONE + priceStep;
+}
+
+export function getBinPrice(baseBinPrice: bigint, binId: number): bigint | undefined {
+    if (baseBinPrice < 0n || baseBinPrice > MAX) {
+        throw new Error(`getBinPrice: baseBinPrice out of u128 range (${baseBinPrice})`);
+    }
+
+    if (baseBinPrice <= ONE) return;
+    if (binId === 0) return ONE;
+
+    const invert = binId > 0;
+    const absBinId = Math.abs(binId);
+
+    if (absBinId >= MAX_EXPONENTIAL) return;
+
+    const invertedBase = MAX / baseBinPrice;
+    const price = expBySquaring(invertedBase, absBinId);
+
+    if (price === 0n) return;
+
+    return invert ? MAX / price : price;
+}
+
+export function getBinPriceFromStep(binStep: number, binId: number): bigint | undefined {
+    return getBinPrice(getBaseBinPrice(binStep), binId);
+}

package/src/utils/u64x64.ts

@@ -0,0 +1,28 @@
+export const SCALE_OFFSET = 64n;
+export const ONE = 1n << SCALE_OFFSET;
+export const MAX = (1n << 128n) - 1n; // u128::MAX
+export const MAX_EXPONENTIAL = 0x80000; // 2^19
+
+function mulU128(a: bigint, b: bigint): bigint {
+  const product = a * b;
+  if (product > MAX) throw new Error("u64x64: u128 multiplication overflow");
+  return product;
+}
+
+export function expBySquaring(base: bigint, exp: number): bigint {
+  let result = ONE;
+  let remainingBits = 32 - Math.clz32(exp);
+
+  for (let bit = 0x1; bit <= 0x40000; bit <<= 1) {
+    if (exp & bit) {
+      result = mulU128(result, base) >> SCALE_OFFSET;
+    }
+    remainingBits -= 1;
+    if (remainingBits === 0) {
+      return result;
+    }
+    base = mulU128(base, base) >> SCALE_OFFSET;
+  }
+
+  throw new Error(`u64x64.expBySquaring: exp out of range (${exp})`);
+}