@streamflow/common 8.9.0 → 9.0.0-alpha.p308.8fcedb9

package/dist/cjs/index.cjs

@@ -79,16 +79,66 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 var divCeilN = (n, d) => n / d + (n % d ? BigInt(1) : BigInt(0));
+function multiplyBigIntByNumber(x, y, scaleDigits = 9) {
+  if (!Number.isFinite(y) || y === 0) return 0n;
+  const isNegative = x < 0n !== y < 0;
+  const absX = x < 0n ? -x : x;
+  const absY = Math.abs(y);
+  const s = absY.toFixed(scaleDigits);
+  const [intPart, fracPartRaw = ""] = s.split(".");
+  const fracPart = fracPartRaw.padEnd(scaleDigits, "0").slice(0, scaleDigits);
+  const yScaled = BigInt(intPart + fracPart);
+  const scale = 10n ** BigInt(scaleDigits);
+  const product = absX * yScaled / scale;
+  return isNegative ? -product : product;
+}
+
+// lib/fetch-token-price.ts
+var fetchTokenPrice = async (mintId, cluster = "mainnet" /* Mainnet */, options) => {
+  const url = `https://token-api.streamflow.finance/price?ids=${encodeURIComponent(mintId)}&cluster=${encodeURIComponent(cluster)}`;
+  const impl = options?.fetchImpl ?? fetch;
+  const controller = new AbortController();
+  const timeout = options?.timeoutMs ? setTimeout(() => controller.abort(), options.timeoutMs) : void 0;
+  try {
+    const res = await impl(url, {
+      headers: { "Content-Type": "application/json" },
+      signal: controller.signal
+    });
+    if (!res.ok) {
+      throw new Error(`Price API error: ${res.status} ${res.statusText}`);
+    }
+    const json = await res.json();
+    const entry = json?.data?.[mintId];
+    return { id: mintId, value: typeof entry?.value === "number" ? entry.value : null };
+  } finally {
+    if (timeout) clearTimeout(timeout);
+  }
+};
+function getTokenPriceQueryOptions(mintId, cluster = "mainnet" /* Mainnet */, options) {
+  const { staleTimeMs = 6e4, gcTimeMs = 3e5, retry = 2, refetchOnWindowFocus = false, ...rest } = options ?? {};
+  const key = ["sf", "price", cluster, mintId];
+  return {
+    queryKey: key,
+    queryFn: () => fetchTokenPrice(mintId, cluster, rest),
+    staleTime: staleTimeMs,
+    gcTime: gcTimeMs,
+    retry,
+    refetchOnWindowFocus
+  };
+}
 
 exports.ContractError = ContractError;
 exports.IChain = IChain;
 exports.ICluster = ICluster;
 exports.assertHasPublicKey = assertHasPublicKey;
 exports.divCeilN = divCeilN;
+exports.fetchTokenPrice = fetchTokenPrice;
 exports.getBN = getBN;
 exports.getNumberFromBN = getNumberFromBN;
+exports.getTokenPriceQueryOptions = getTokenPriceQueryOptions;
 exports.handleContractError = handleContractError;
 exports.invariant = invariant;
+exports.multiplyBigIntByNumber = multiplyBigIntByNumber;
 exports.sleep = sleep;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../types.ts","../../lib/assertions.ts","../../lib/utils.ts"],"names":["ICluster","IChain","BN"],"mappings":"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","file":"index.cjs","sourcesContent":["import { type TransactionInstruction } from \"@solana/web3.js\";\n\nexport interface ITransactionResult {\n  ixs: TransactionInstruction[];\n  txId: string;\n}\n\n// Utility types\nexport enum ICluster {\n  Mainnet = \"mainnet\",\n  Devnet = \"devnet\",\n  Testnet = \"testnet\",\n  Local = \"local\",\n}\n\nexport enum IChain {\n  Solana = \"Solana\",\n  Aptos = \"Aptos\",\n  Ethereum = \"Ethereum\",\n  BNB = \"BNB\",\n  Polygon = \"Polygon\",\n  Sui = \"Sui\",\n}\n\n/**\n * Error wrapper for calls made to the contract on chain\n */\nexport class ContractError extends Error {\n  public contractErrorCode: string | null;\n\n  public description: string | null;\n\n  /**\n   * Constructs the Error Wrapper\n   * @param error Original error raised probably by the chain SDK\n   * @param code extracted code from the error if managed to parse it\n   */\n  constructor(error: Error, code?: string | null, description?: string | null) {\n    super(error.message, { cause: error }); // Call the base class constructor with the error message\n    this.contractErrorCode = code ?? null;\n    this.description = description ?? null;\n    // Copy properties from the original error\n    Object.setPrototypeOf(this, ContractError.prototype);\n    this.name = \"ContractError\"; // Set the name property\n    this.stack = error.stack;\n  }\n}\n","import type { PublicKey } from \"@solana/web3.js\";\n\nconst prefix = \"Assertion failed\";\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const invariant: (condition: any, message?: string | (() => string)) => asserts condition = (\n  condition,\n  message,\n) => {\n  if (condition) {\n    return;\n  }\n  const provided: string | undefined = typeof message === \"function\" ? message() : message;\n  const value: string = provided ? `${prefix}: ${provided}` : prefix;\n  throw new Error(value);\n};\n\nexport function assertHasPublicKey<T extends { publicKey?: PublicKey | null }>(\n  value: T,\n  message?: string | (() => string),\n): asserts value is T & { publicKey: PublicKey } {\n  invariant(value.publicKey, message ?? \"publicKey is missing\");\n}\n\n","import BN from \"bn.js\";\n\nimport { ContractError } from \"../types.js\";\n\n/**\n * Used for conversion of token amounts to their Big Number representation.\n * Get Big Number representation in the smallest units from the same value in the highest units.\n * @param {number} value - Number of tokens you want to convert to its BN representation.\n * @param {number} decimals - Number of decimals the token has.\n */\nexport const getBN = (value: number, decimals: number): BN => {\n  const decimalPart = value - Math.trunc(value);\n  const integerPart = new BN(Math.trunc(value));\n\n  const decimalE = new BN(decimalPart * 1e9);\n\n  const sum = integerPart.mul(new BN(1e9)).add(decimalE);\n  const resultE = sum.mul(new BN(10).pow(new BN(decimals)));\n  return resultE.div(new BN(1e9));\n};\n\n/**\n * Used for token amounts conversion from their Big Number representation to number.\n * Get value in the highest units from BN representation of the same value in the smallest units.\n * @param {BN} value - Big Number representation of value in the smallest units.\n * @param {number} decimals - Number of decimals the token has.\n */\nexport const getNumberFromBN = (value: BN, decimals: number): number =>\n  value.gt(new BN(2 ** 53 - 1)) ? value.div(new BN(10 ** decimals)).toNumber() : value.toNumber() / 10 ** decimals;\n\n/**\n * Used to make on chain calls to the contract and wrap raised errors if any\n * @param func function that interacts with the contract\n * @param callback callback that may be used to extract error code\n * @returns {T}\n */\nexport async function handleContractError<T>(\n  func: () => Promise<T>,\n  callback?: (err: Error) => string | null,\n): Promise<T> {\n  try {\n    return await func();\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  } catch (err: any) {\n    if (err instanceof Error) {\n      if (callback) {\n        throw new ContractError(err, callback(err));\n      }\n      throw new ContractError(err);\n    }\n    throw err;\n  }\n}\n\n/**\n * Pause async function execution for given amount of milliseconds\n * @param ms millisecond to sleep for\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport const divCeilN = (n: bigint, d: bigint): bigint => n / d + (n % d ? BigInt(1) : BigInt(0));\n"]}
+{"version":3,"sources":["../../types.ts","../../lib/assertions.ts","../../lib/utils.ts","../../lib/fetch-token-price.ts"],"names":["ICluster","IChain","BN"],"mappings":"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","file":"index.cjs","sourcesContent":["import { type TransactionInstruction } from \"@solana/web3.js\";\n\nexport interface ITransactionResult {\n  ixs: TransactionInstruction[];\n  txId: string;\n}\n\n// Utility types\nexport enum ICluster {\n  Mainnet = \"mainnet\",\n  Devnet = \"devnet\",\n  Testnet = \"testnet\",\n  Local = \"local\",\n}\n\nexport enum IChain {\n  Solana = \"Solana\",\n  Aptos = \"Aptos\",\n  Ethereum = \"Ethereum\",\n  BNB = \"BNB\",\n  Polygon = \"Polygon\",\n  Sui = \"Sui\",\n}\n\n/**\n * Error wrapper for calls made to the contract on chain\n */\nexport class ContractError extends Error {\n  public contractErrorCode: string | null;\n\n  public description: string | null;\n\n  /**\n   * Constructs the Error Wrapper\n   * @param error Original error raised probably by the chain SDK\n   * @param code extracted code from the error if managed to parse it\n   */\n  constructor(error: Error, code?: string | null, description?: string | null) {\n    super(error.message, { cause: error }); // Call the base class constructor with the error message\n    this.contractErrorCode = code ?? null;\n    this.description = description ?? null;\n    // Copy properties from the original error\n    Object.setPrototypeOf(this, ContractError.prototype);\n    this.name = \"ContractError\"; // Set the name property\n    this.stack = error.stack;\n  }\n}\n","import type { PublicKey } from \"@solana/web3.js\";\n\nconst prefix = \"Assertion failed\";\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const invariant: (condition: any, message?: string | (() => string)) => asserts condition = (\n  condition,\n  message,\n) => {\n  if (condition) {\n    return;\n  }\n  const provided: string | undefined = typeof message === \"function\" ? message() : message;\n  const value: string = provided ? `${prefix}: ${provided}` : prefix;\n  throw new Error(value);\n};\n\nexport function assertHasPublicKey<T extends { publicKey?: PublicKey | null }>(\n  value: T,\n  message?: string | (() => string),\n): asserts value is T & { publicKey: PublicKey } {\n  invariant(value.publicKey, message ?? \"publicKey is missing\");\n}\n\n","import BN from \"bn.js\";\n\nimport { ContractError } from \"../types.js\";\n\n/**\n * Used for conversion of token amounts to their Big Number representation.\n * Get Big Number representation in the smallest units from the same value in the highest units.\n * @param {number} value - Number of tokens you want to convert to its BN representation.\n * @param {number} decimals - Number of decimals the token has.\n */\nexport const getBN = (value: number, decimals: number): BN => {\n  const decimalPart = value - Math.trunc(value);\n  const integerPart = new BN(Math.trunc(value));\n\n  const decimalE = new BN(decimalPart * 1e9);\n\n  const sum = integerPart.mul(new BN(1e9)).add(decimalE);\n  const resultE = sum.mul(new BN(10).pow(new BN(decimals)));\n  return resultE.div(new BN(1e9));\n};\n\n/**\n * Used for token amounts conversion from their Big Number representation to number.\n * Get value in the highest units from BN representation of the same value in the smallest units.\n * @param {BN} value - Big Number representation of value in the smallest units.\n * @param {number} decimals - Number of decimals the token has.\n */\nexport const getNumberFromBN = (value: BN, decimals: number): number =>\n  value.gt(new BN(2 ** 53 - 1)) ? value.div(new BN(10 ** decimals)).toNumber() : value.toNumber() / 10 ** decimals;\n\n/**\n * Used to make on chain calls to the contract and wrap raised errors if any\n * @param func function that interacts with the contract\n * @param callback callback that may be used to extract error code\n * @returns {T}\n */\nexport async function handleContractError<T>(\n  func: () => Promise<T>,\n  callback?: (err: Error) => string | null,\n): Promise<T> {\n  try {\n    return await func();\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  } catch (err: any) {\n    if (err instanceof Error) {\n      if (callback) {\n        throw new ContractError(err, callback(err));\n      }\n      throw new ContractError(err);\n    }\n    throw err;\n  }\n}\n\n/**\n * Pause async function execution for given amount of milliseconds\n * @param ms millisecond to sleep for\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport const divCeilN = (n: bigint, d: bigint): bigint => n / d + (n % d ? BigInt(1) : BigInt(0));\n\n/**\n * Multiply a bigint by a JS number using string-based fixed-point to avoid overflow/precision issues.\n * Returns floor(x * y).\n */\nexport function multiplyBigIntByNumber(x: bigint, y: number, scaleDigits = 9): bigint {\n  if (!Number.isFinite(y) || y === 0) return 0n;\n  const isNegative = (x < 0n) !== (y < 0);\n  const absX = x < 0n ? -x : x;\n  const absY = Math.abs(y);\n\n  const s = absY.toFixed(scaleDigits);\n  const [intPart, fracPartRaw = \"\"] = s.split(\".\");\n  const fracPart = fracPartRaw.padEnd(scaleDigits, \"0\").slice(0, scaleDigits);\n  const yScaled = BigInt(intPart + fracPart); // absY * 10^scaleDigits\n  const scale = 10n ** BigInt(scaleDigits);\n  const product = (absX * yScaled) / scale;\n  return isNegative ? -product : product;\n}\n","import { ICluster } from \"../types.js\";\n\nexport type TokensPricesResponse = {\n  data: Record<string, { id: string; value: number | undefined }>;\n};\n\nexport type TokenPriceResult = { id: string; value: number | null };\n\nexport interface FetchTokenPriceOptions {\n  fetchImpl?: typeof fetch;\n  timeoutMs?: number;\n}\n\nexport const fetchTokenPrice = async (\n  mintId: string,\n  cluster: ICluster = ICluster.Mainnet,\n  options?: FetchTokenPriceOptions,\n): Promise<TokenPriceResult> => {\n  const url = `https://token-api.streamflow.finance/price?ids=${encodeURIComponent(mintId)}&cluster=${encodeURIComponent(cluster)}`;\n\n  const impl = options?.fetchImpl ?? fetch;\n  const controller = new AbortController();\n  const timeout = options?.timeoutMs\n    ? setTimeout(() => controller.abort(), options.timeoutMs)\n    : undefined;\n\n  try {\n    const res = await impl(url, {\n      headers: { \"Content-Type\": \"application/json\" },\n      signal: controller.signal,\n    });\n    if (!res.ok) {\n      throw new Error(`Price API error: ${res.status} ${res.statusText}`);\n    }\n    const json = (await res.json()) as TokensPricesResponse;\n    const entry = json?.data?.[mintId];\n    return { id: mintId, value: typeof entry?.value === \"number\" ? entry.value : null };\n  } finally {\n    if (timeout) clearTimeout(timeout);\n  }\n};\n\nexport interface TokenPriceQueryOptionsOverrides {\n  staleTimeMs?: number;\n  gcTimeMs?: number;\n  retry?: number | boolean;\n  refetchOnWindowFocus?: boolean;\n}\n\nexport function getTokenPriceQueryOptions(\n  mintId: string,\n  cluster: ICluster = ICluster.Mainnet,\n  options?: FetchTokenPriceOptions & TokenPriceQueryOptionsOverrides,\n) {\n  const { staleTimeMs = 60_000, gcTimeMs = 300_000, retry = 2, refetchOnWindowFocus = false, ...rest } =\n    options ?? {};\n  const key = [\"sf\", \"price\", cluster, mintId];\n  return {\n    queryKey: key,\n    queryFn: () => fetchTokenPrice(mintId, cluster, rest),\n    staleTime: staleTimeMs,\n    gcTime: gcTimeMs,\n    retry,\n    refetchOnWindowFocus,\n  };\n}\n\n"]}

package/dist/cjs/index.d.cts

@@ -67,5 +67,40 @@ declare function handleContractError<T>(func: () => Promise<T>, callback?: (err:
  */
 declare function sleep(ms: number): Promise<void>;
 declare const divCeilN: (n: bigint, d: bigint) => bigint;
+/**
+ * Multiply a bigint by a JS number using string-based fixed-point to avoid overflow/precision issues.
+ * Returns floor(x * y).
+ */
+declare function multiplyBigIntByNumber(x: bigint, y: number, scaleDigits?: number): bigint;
+
+type TokensPricesResponse = {
+    data: Record<string, {
+        id: string;
+        value: number | undefined;
+    }>;
+};
+type TokenPriceResult = {
+    id: string;
+    value: number | null;
+};
+interface FetchTokenPriceOptions {
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}
+declare const fetchTokenPrice: (mintId: string, cluster?: ICluster, options?: FetchTokenPriceOptions) => Promise<TokenPriceResult>;
+interface TokenPriceQueryOptionsOverrides {
+    staleTimeMs?: number;
+    gcTimeMs?: number;
+    retry?: number | boolean;
+    refetchOnWindowFocus?: boolean;
+}
+declare function getTokenPriceQueryOptions(mintId: string, cluster?: ICluster, options?: FetchTokenPriceOptions & TokenPriceQueryOptionsOverrides): {
+    queryKey: string[];
+    queryFn: () => Promise<TokenPriceResult>;
+    staleTime: number;
+    gcTime: number;
+    retry: number | boolean;
+    refetchOnWindowFocus: boolean;
+};
 
-export { ContractError, IChain, ICluster, type ITransactionResult, assertHasPublicKey, divCeilN, getBN, getNumberFromBN, handleContractError, invariant, sleep };
+export { ContractError, type FetchTokenPriceOptions, IChain, ICluster, type ITransactionResult, type TokenPriceQueryOptionsOverrides, type TokenPriceResult, type TokensPricesResponse, assertHasPublicKey, divCeilN, fetchTokenPrice, getBN, getNumberFromBN, getTokenPriceQueryOptions, handleContractError, invariant, multiplyBigIntByNumber, sleep };