@tokenops/sdk 1.0.0

package/dist/chunk-5SGMJADP.cjs

@@ -0,0 +1,139 @@
+'use strict';
+
+var chunk56UI7LUR_cjs = require('./chunk-56UI7LUR.cjs');
+
+// src/fhe/scale-ratio.ts
+var FHE_SPLIT_DENOMINATOR = 90090000n;
+var MAX_UINT64 = (1n << 64n) - 1n;
+var MAX_UINT128 = (1n << 128n) - 1n;
+var MAX_FRACTION_DENOMINATOR = 16n;
+var BASIS_POINT_SCALE = 10000n;
+function scaleRatio({
+  numerator,
+  denominator,
+  minDenominator = FHE_SPLIT_DENOMINATOR,
+  width = "uint128"
+}) {
+  if (denominator <= 0n) {
+    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      method: "scaleRatio",
+      argument: "denominator",
+      reason: `must be > 0, got ${denominator}`,
+      value: denominator
+    });
+  }
+  if (numerator < 0n) {
+    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      method: "scaleRatio",
+      argument: "numerator",
+      reason: `must be >= 0, got ${numerator}`,
+      value: numerator
+    });
+  }
+  if (minDenominator <= 0n) {
+    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      method: "scaleRatio",
+      argument: "minDenominator",
+      reason: `must be > 0, got ${minDenominator}`,
+      value: minDenominator
+    });
+  }
+  if (denominator >= minDenominator) {
+    assertWithinWidth(numerator, width, "numerator");
+    assertWithinWidth(denominator, width, "denominator");
+    return { numerator, denominator };
+  }
+  const scaledNumerator = (numerator * minDenominator + denominator - 1n) / denominator;
+  assertWithinWidth(scaledNumerator, width, "scaled numerator");
+  assertWithinWidth(minDenominator, width, "scaled denominator");
+  return { numerator: scaledNumerator, denominator: minDenominator };
+}
+function assertWithinWidth(value, width, label) {
+  const max = width === "uint64" ? MAX_UINT64 : MAX_UINT128;
+  if (value > max) {
+    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      method: "scaleRatio",
+      argument: label,
+      reason: `exceeds ${width} range`,
+      value
+    });
+  }
+}
+var share = {
+  /**
+   * Build a `ScaledRatio` from a simple fraction `n/m`.
+   *
+   * - `m` must be in `1..16` — every integer in this range divides
+   *   {@link FHE_SPLIT_DENOMINATOR} cleanly, so the result is exact.
+   * - `n` must be in `0..m` — `0` is a zero-share (no-op split) and `m`
+   *   itself is the whole position.
+   *
+   * Both arguments accept `number` (must be an integer) or `bigint` —
+   * use whichever is convenient at the call site.
+   *
+   * @throws InvalidArgumentError if `m` is outside `1..16` or `n` is
+   *         outside `0..m`, or either input is a non-integer `number`.
+   */
+  fraction(numerator, denominator) {
+    const n = toIntegerBigInt(numerator, "share.fraction", "numerator");
+    const m = toIntegerBigInt(denominator, "share.fraction", "denominator");
+    if (m <= 0n || m > MAX_FRACTION_DENOMINATOR) {
+      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+        method: "share.fraction",
+        argument: "denominator",
+        reason: `must be in 1..${MAX_FRACTION_DENOMINATOR}, got ${m}`,
+        value: m
+      });
+    }
+    if (n < 0n || n > m) {
+      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+        method: "share.fraction",
+        argument: "numerator",
+        reason: `must be in 0..${m} (denominator), got ${n}`,
+        value: n
+      });
+    }
+    return scaleRatio({ numerator: n, denominator: m, width: "uint64" });
+  },
+  /**
+   * Build a `ScaledRatio` from a basis-point amount.
+   *
+   * `bps` must be in `0..10_000` — `0` is a zero-share and `10_000` is
+   * the whole position (= 100%). `10_000` divides
+   * {@link FHE_SPLIT_DENOMINATOR} cleanly, so the result is exact:
+   * `bps × 9_009` over `90_090_000`.
+   *
+   * Accepts `number` (must be an integer) or `bigint`.
+   *
+   * @throws InvalidArgumentError if `bps` is outside `0..10_000`, or is
+   *         a non-integer `number`.
+   */
+  basisPoints(bps) {
+    const value = toIntegerBigInt(bps, "share.basisPoints", "bps");
+    if (value < 0n || value > BASIS_POINT_SCALE) {
+      throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+        method: "share.basisPoints",
+        argument: "bps",
+        reason: `must be in 0..${BASIS_POINT_SCALE}, got ${value}`,
+        value
+      });
+    }
+    return scaleRatio({ numerator: value, denominator: BASIS_POINT_SCALE, width: "uint64" });
+  }
+};
+function toIntegerBigInt(value, method, argument) {
+  if (typeof value === "bigint") return value;
+  if (!Number.isInteger(value)) {
+    throw new chunk56UI7LUR_cjs.InvalidArgumentError({
+      method,
+      argument,
+      reason: `must be an integer, got ${value}`,
+      value
+    });
+  }
+  return BigInt(value);
+}
+
+exports.FHE_SPLIT_DENOMINATOR = FHE_SPLIT_DENOMINATOR;
+exports.scaleRatio = scaleRatio;
+exports.share = share;