@streamflow/common 8.0.1 → 8.0.2-alpha.p287.a3616ff

package/dist/cjs/solana/rpc/index.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+var web3_js = require('@solana/web3.js');
+var buffer = require('buffer');
+
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// solana/rpc/consume-limit-estimate/estimate.ts
+var estimateConsumeLimit = async (connection, tx, options = {}) => {
+  const { increaseFactor = 0.05 } = options;
+  const simulationResults = await connection.simulateTransaction(tx, {
+    sigVerify: false,
+    replaceRecentBlockhash: true
+  });
+  return {
+    unitsConsumed: simulationResults.value.unitsConsumed ? Math.ceil(simulationResults.value.unitsConsumed * (1 + increaseFactor)) : simulationResults.value.unitsConsumed,
+    data: simulationResults
+  };
+};
+
+// solana/rpc/priority-fee-estimate/percentile.ts
+var percentile_exports = {};
+__export(percentile_exports, {
+  getPriorityFeeEstimate: () => getPriorityFeeEstimate,
+  getRecentPrioritizationFee: () => getRecentPrioritizationFee
+});
+function deserializeRawTransaction(serializedTx) {
+  const txBuffer = buffer.Buffer.from(serializedTx, "base64");
+  try {
+    const tx = web3_js.Transaction.from(txBuffer);
+    return resolveTransactionAccounts(tx);
+  } catch (error) {
+    try {
+      const vtx = web3_js.VersionedTransaction.deserialize(txBuffer);
+      return resolveTransactionAccounts(vtx);
+    } catch (vError) {
+      throw new Error("Failed to deserialize transaction: " + (vError instanceof Error ? vError.message : vError), {
+        cause: vError
+      });
+    }
+  }
+}
+var resolveTransactionAccounts = (tx) => {
+  if (tx instanceof web3_js.Transaction) {
+    const message2 = tx.compileMessage();
+    const accounts2 = message2.accountKeys;
+    const writableAccounts2 = accounts2.filter((_, idx) => message2.isAccountWritable(idx));
+    return {
+      type: "legacy",
+      transaction: tx,
+      accounts: accounts2,
+      writableAccounts: writableAccounts2
+    };
+  }
+  const message = tx.message;
+  const accounts = "staticAccountKeys" in message ? message.staticAccountKeys : message.accountKeys;
+  const writableAccounts = accounts.filter((_, idx) => message.isAccountWritable(idx));
+  return {
+    type: "versioned",
+    transaction: tx,
+    accounts,
+    writableAccounts
+  };
+};
+
+// solana/rpc/priority-fee-estimate/calc-fee.ts
+var resolveMedian = (values) => {
+  if (values.length < 2) {
+    return 0;
+  }
+  const sortedRates = [...values].sort((a, b) => a - b);
+  const medianIndex = Math.floor(sortedRates.length / 2);
+  const medianArrValue = sortedRates[medianIndex];
+  const medianPrevValue = sortedRates[medianIndex - 1];
+  if (medianPrevValue === void 0 || medianArrValue === void 0) {
+    return 0;
+  }
+  const medianValue = sortedRates.length % 2 === 0 ? (medianPrevValue + medianArrValue) / 2 : medianArrValue;
+  return medianValue;
+};
+
+// solana/rpc/priority-fee-estimate/percentile.ts
+var getPriorityFeeEstimate = async (connection, options) => {
+  const recentPrioritizationFee = await getRecentPrioritizationFee(connection, options);
+  const median = resolveMedian(recentPrioritizationFee.result.map((r) => r.prioritizationFee));
+  return { median: Math.ceil(median * (1 + (options.increaseFactor ?? 0.05))), data: recentPrioritizationFee };
+};
+var getRecentPrioritizationFee = async (connection, options) => {
+  const { accountsOrTx, percentile = 5e3 } = options;
+  return connection._rpcRequest(
+    "getRecentPrioritizationFees",
+    buildArgs(accountsOrTx, percentile)
+  );
+};
+var buildArgs = (accountsOrTx, percentile) => {
+  const accountsArray = accountsOrTx instanceof Array ? accountsOrTx.map((a) => a.toString()) : deserializeRawTransaction(accountsOrTx).writableAccounts.map((a) => a.toString());
+  return [
+    accountsArray,
+    {
+      percentile
+    }
+  ];
+};
+
+// solana/rpc/priority-fee-estimate/general.ts
+var general_exports = {};
+__export(general_exports, {
+  getPriorityFeeEstimate: () => getPriorityFeeEstimate2,
+  getRecentPrioritizationFee: () => getRecentPrioritizationFee2
+});
+var pk = (address) => {
+  return typeof address === "string" ? new web3_js.PublicKey(address) : address;
+};
+
+// solana/rpc/priority-fee-estimate/general.ts
+var getPriorityFeeEstimate2 = async (connection, options) => {
+  const recentPrioritizationFee = await getRecentPrioritizationFee2(connection, options);
+  const median = resolveMedian(recentPrioritizationFee.map((r) => r.prioritizationFee));
+  return { median: Math.ceil(median * (1 + (options.increaseFactor ?? 0.05))), data: recentPrioritizationFee };
+};
+var getRecentPrioritizationFee2 = async (connection, options) => {
+  return connection.getRecentPrioritizationFees({ lockedWritableAccounts: buildArgs2(options.accountsOrTx)[0] });
+};
+var buildArgs2 = (accountsOrTx) => {
+  const accountsArray = accountsOrTx instanceof Array ? accountsOrTx.map(pk) : deserializeRawTransaction(accountsOrTx).writableAccounts;
+  return [accountsArray];
+};
+
+exports.estimateConsumeLimit = estimateConsumeLimit;
+exports.priorityFeeEstimation = general_exports;
+exports.priorityFeeEstimationPercentile = percentile_exports;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/solana/rpc/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../solana/rpc/consume-limit-estimate/estimate.ts","../../../../solana/rpc/priority-fee-estimate/percentile.ts","../../../../solana/lib/deserialize-raw-transaction.ts","../../../../solana/rpc/priority-fee-estimate/calc-fee.ts","../../../../solana/rpc/priority-fee-estimate/general.ts","../../../../solana/lib/public-key.ts"],"names":["Buffer","Transaction","VersionedTransaction","message","accounts","writableAccounts","getPriorityFeeEstimate","getRecentPrioritizationFee","PublicKey","buildArgs"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { VersionedTransaction, Connection } from \"@solana/web3.js\";\n\nimport type { GetConsumeLimitEstimateOptions } from \"../types.js\";\n\n/**\n * Estimate the consume limit of a transaction based on the simulation results of the transaction.\n * @param connection - The connection to the RPC\n * @param tx - The transaction to estimate the consume limit for\n * @param options - The options for the estimate\n * @returns The consume limit estimate multiplied by a multiplier percent or undefined and the native simulation results\n */\nexport const estimateConsumeLimit = async (\n  connection: Connection,\n  tx: VersionedTransaction,\n  options: GetConsumeLimitEstimateOptions = {},\n) => {\n  const { increaseFactor = 0.05 } = options;\n  const simulationResults = await connection.simulateTransaction(tx, {\n    sigVerify: false,\n    replaceRecentBlockhash: true,\n  });\n  return {\n    unitsConsumed: simulationResults.value.unitsConsumed\n      ? Math.ceil(simulationResults.value.unitsConsumed * (1 + increaseFactor))\n      : simulationResults.value.unitsConsumed,\n    data: simulationResults,\n  };\n};\n","import type { Connection, PublicKey } from \"@solana/web3.js\";\n\nimport { deserializeRawTransaction } from \"../../lib/deserialize-raw-transaction.js\";\nimport type { GetPriorityFeeEstimateOptions } from \"../types.js\";\nimport { resolveMedian } from \"./calc-fee.js\";\n\ntype RpcRequest = (methodName: string, args: Array<any> | ReadonlyArray<any>) => Promise<any>;\n\n/**\n * @category GetPriorityFeeEstimateOptions\n * @interface RecentPrioritizationFee\n * @property result - The result of the recent prioritization fees.\n * @property result.prioritizationFee - The prioritization fee.\n * @property result.slot - The slot of the prioritization fee.\n */\ninterface RecentPrioritizationFee {\n  result: Array<{ prioritizationFee: number; slot: number }>;\n}\n\n/**\n * Fetch the recent prioritization fees from the RPC [getRecentPrioritizationFees]\n * @param connection - The connection to the RPC\n * @param options - The options for the RPC\n * @returns The priority fee estimate\n */\nexport const getPriorityFeeEstimate = async (connection: Connection, options: GetPriorityFeeEstimateOptions) => {\n  const recentPrioritizationFee = await getRecentPrioritizationFee(connection, options);\n  const median = resolveMedian(recentPrioritizationFee.result.map((r) => r.prioritizationFee));\n  return { median: Math.ceil(median * (1 + (options.increaseFactor ?? 0.05))), data: recentPrioritizationFee };\n};\n\n/**\n * If an RPC of use supports percentile value, aka {@link https://docs.triton.one/chains/solana/improved-priority-fees-api}\n * @param connection - The connection to the RPC\n * @param options - The options for the RPC\n * @returns The priority fee estimate\n */\nexport const getRecentPrioritizationFee = async (\n  connection: Connection,\n  options: Pick<GetPriorityFeeEstimateOptions, \"accountsOrTx\" | \"percentile\">,\n): Promise<RecentPrioritizationFee> => {\n  const { accountsOrTx, percentile = 5000 } = options;\n\n  return (connection as unknown as { _rpcRequest: RpcRequest })._rpcRequest(\n    \"getRecentPrioritizationFees\",\n    buildArgs(accountsOrTx, percentile),\n  ) as Promise<RecentPrioritizationFee>;\n};\n\nconst buildArgs = (accountsOrTx: (string | PublicKey)[] | string, percentile: number) => {\n  const accountsArray =\n    accountsOrTx instanceof Array\n      ? accountsOrTx.map((a) => a.toString())\n      : deserializeRawTransaction(accountsOrTx).writableAccounts.map((a) => a.toString());\n  return [\n    accountsArray,\n    {\n      percentile,\n    },\n  ] as const;\n};\n","import { Transaction, VersionedTransaction, type PublicKey } from \"@solana/web3.js\";\nimport { Buffer } from \"buffer\";\n\ninterface TransactionAccountsProvider {\n  accountKeys: PublicKey[];\n}\n\nexport function deserializeRawTransaction(serializedTx: string) {\n  const txBuffer = Buffer.from(serializedTx, \"base64\");\n  try {\n    const tx = Transaction.from(txBuffer);\n    return resolveTransactionAccounts(tx);\n  } catch (error) {\n    try {\n      const vtx = VersionedTransaction.deserialize(txBuffer);\n      return resolveTransactionAccounts(vtx);\n    } catch (vError) {\n      throw new Error(\"Failed to deserialize transaction: \" + (vError instanceof Error ? vError.message : vError), {\n        cause: vError,\n      });\n    }\n  }\n}\n\nexport const resolveTransactionAccounts = (tx: VersionedTransaction | Transaction) => {\n  if (tx instanceof Transaction) {\n    const message = tx.compileMessage();\n    const accounts = message.accountKeys;\n    const writableAccounts = accounts.filter((_, idx) => message.isAccountWritable(idx));\n    return {\n      type: \"legacy\",\n      transaction: tx,\n      accounts,\n      writableAccounts,\n    };\n  }\n\n  const message = tx.message;\n  const accounts =\n    \"staticAccountKeys\" in message\n      ? message.staticAccountKeys\n      : (message as unknown as TransactionAccountsProvider).accountKeys;\n\n  const writableAccounts = accounts.filter((_, idx) => message.isAccountWritable(idx));\n  return {\n    type: \"versioned\",\n    transaction: tx,\n    accounts,\n    writableAccounts,\n  };\n};\n","export const resolveMedian = (values: number[]) => {\n  if (values.length < 2) {\n    return 0;\n  }\n\n  const sortedRates = [...values].sort((a, b) => a - b);\n  const medianIndex = Math.floor(sortedRates.length / 2);\n  const medianArrValue = sortedRates[medianIndex];\n  const medianPrevValue = sortedRates[medianIndex - 1];\n\n  if (medianPrevValue === undefined || medianArrValue === undefined) {\n    return 0;\n  }\n\n  const medianValue = sortedRates.length % 2 === 0 ? (medianPrevValue + medianArrValue) / 2 : medianArrValue;\n\n  return medianValue;\n};\n","import type { Connection, PublicKey } from \"@solana/web3.js\";\n\nimport { deserializeRawTransaction } from \"../../lib/deserialize-raw-transaction.js\";\nimport type { GetPriorityFeeEstimateOptions } from \"../types.js\";\nimport { resolveMedian } from \"./calc-fee.js\";\nimport { pk } from \"../../lib/public-key.js\";\n\n/**\n * Fetch the recent prioritization fees from the RPC [getRecentPrioritizationFees] (https://solana.com/docs/rpc/http/getrecentprioritizationfees)\n * @deprecated Not recommended for use because it provides a single number per slot to indicate the minimum priority fee amount.\n * @param connection - The connection to the RPC\n * @param options - The options for the RPC\n * @returns The priority fee estimate\n */\nexport const getPriorityFeeEstimate = async (connection: Connection, options: GetPriorityFeeEstimateOptions) => {\n  const recentPrioritizationFee = await getRecentPrioritizationFee(connection, options);\n  const median = resolveMedian(recentPrioritizationFee.map((r) => r.prioritizationFee));\n  return { median: Math.ceil(median * (1 + (options.increaseFactor ?? 0.05))), data: recentPrioritizationFee };\n};\n\n/**\n * Fetch the recent prioritization fees from the RPC [getRecentPrioritizationFees] (https://solana.com/docs/rpc/http/getrecentprioritizationfees)\n * @deprecated Not recommended for use because it provides a single number per slot to indicate the minimum priority fee amount.\n * @param connection - The connection to the RPC\n * @param options - The options for the RPC\n * @returns The priority fee estimate\n */\nexport const getRecentPrioritizationFee = async (\n  connection: Connection,\n  options: Pick<GetPriorityFeeEstimateOptions, \"accountsOrTx\">,\n) => {\n  return connection.getRecentPrioritizationFees({ lockedWritableAccounts: buildArgs(options.accountsOrTx)[0] });\n};\n\nconst buildArgs = (accountsOrTx: (string | PublicKey)[] | string) => {\n  const accountsArray =\n    accountsOrTx instanceof Array ? accountsOrTx.map(pk) : deserializeRawTransaction(accountsOrTx).writableAccounts;\n  return [accountsArray] as const;\n};\n","import { PublicKey } from \"@solana/web3.js\";\n\n/**\n * Converts a string or PublicKey to a PublicKey object.\n * @param address - The input address as a string or PublicKey.\n * @returns The PublicKey object.\n */\nexport const pk = (address: string | PublicKey): PublicKey => {\n  return typeof address === \"string\" ? new PublicKey(address) : address;\n};\n"]}

package/dist/cjs/solana/rpc/index.d.cts

@@ -0,0 +1,113 @@
+import * as _solana_web3_js from '@solana/web3.js';
+import { PublicKey, Connection, VersionedTransaction } from '@solana/web3.js';
+
+/**
+ * @interface GetPriorityFeeEstimateOptions - The options for the priority fee estimate
+ */
+interface GetPriorityFeeEstimateOptions {
+    /**
+     * The accounts or transaction to get the priority fee estimate for.
+     * `string` is a serialized base64 transaction.
+     * `array` is interpreted as an array of public keys in string format or as PublicKey instances (writable accounts).
+     */
+    accountsOrTx: (string | PublicKey)[] | string;
+    /**
+     * The percentile of the priority fee estimate to return.
+     *
+     * examples: Triton RPC - [0, 10000]
+     * @default 5000
+     */
+    percentile?: number;
+    /**
+     * The multiplier to apply to the priority fee estimate.
+     * The result is multiplied by 1 + increaseFactor.
+     * @default 0.05 = 5%
+     */
+    increaseFactor?: number;
+}
+/**
+ * @interface GetConsumeLimitEstimateOptions - The options for the consume limit estimate
+ */
+interface GetConsumeLimitEstimateOptions {
+    /**
+     * The multiplier to apply to the consume limit estimate.
+     * The result is multiplied by 1 + increaseFactor.
+     * @default 0.05 = 5%
+     */
+    increaseFactor?: number;
+}
+
+/**
+ * Estimate the consume limit of a transaction based on the simulation results of the transaction.
+ * @param connection - The connection to the RPC
+ * @param tx - The transaction to estimate the consume limit for
+ * @param options - The options for the estimate
+ * @returns The consume limit estimate multiplied by a multiplier percent or undefined and the native simulation results
+ */
+declare const estimateConsumeLimit: (connection: Connection, tx: VersionedTransaction, options?: GetConsumeLimitEstimateOptions) => Promise<{
+    unitsConsumed: number | undefined;
+    data: _solana_web3_js.RpcResponseAndContext<_solana_web3_js.SimulatedTransactionResponse>;
+}>;
+
+/**
+ * @category GetPriorityFeeEstimateOptions
+ * @interface RecentPrioritizationFee
+ * @property result - The result of the recent prioritization fees.
+ * @property result.prioritizationFee - The prioritization fee.
+ * @property result.slot - The slot of the prioritization fee.
+ */
+interface RecentPrioritizationFee {
+    result: Array<{
+        prioritizationFee: number;
+        slot: number;
+    }>;
+}
+/**
+ * Fetch the recent prioritization fees from the RPC [getRecentPrioritizationFees]
+ * @param connection - The connection to the RPC
+ * @param options - The options for the RPC
+ * @returns The priority fee estimate
+ */
+declare const getPriorityFeeEstimate$1: (connection: Connection, options: GetPriorityFeeEstimateOptions) => Promise<{
+    median: number;
+    data: RecentPrioritizationFee;
+}>;
+/**
+ * If an RPC of use supports percentile value, aka {@link https://docs.triton.one/chains/solana/improved-priority-fees-api}
+ * @param connection - The connection to the RPC
+ * @param options - The options for the RPC
+ * @returns The priority fee estimate
+ */
+declare const getRecentPrioritizationFee$1: (connection: Connection, options: Pick<GetPriorityFeeEstimateOptions, "accountsOrTx" | "percentile">) => Promise<RecentPrioritizationFee>;
+
+declare namespace percentile {
+  export { getPriorityFeeEstimate$1 as getPriorityFeeEstimate, getRecentPrioritizationFee$1 as getRecentPrioritizationFee };
+}
+
+/**
+ * Fetch the recent prioritization fees from the RPC [getRecentPrioritizationFees] (https://solana.com/docs/rpc/http/getrecentprioritizationfees)
+ * @deprecated Not recommended for use because it provides a single number per slot to indicate the minimum priority fee amount.
+ * @param connection - The connection to the RPC
+ * @param options - The options for the RPC
+ * @returns The priority fee estimate
+ */
+declare const getPriorityFeeEstimate: (connection: Connection, options: GetPriorityFeeEstimateOptions) => Promise<{
+    median: number;
+    data: _solana_web3_js.RecentPrioritizationFees[];
+}>;
+/**
+ * Fetch the recent prioritization fees from the RPC [getRecentPrioritizationFees] (https://solana.com/docs/rpc/http/getrecentprioritizationfees)
+ * @deprecated Not recommended for use because it provides a single number per slot to indicate the minimum priority fee amount.
+ * @param connection - The connection to the RPC
+ * @param options - The options for the RPC
+ * @returns The priority fee estimate
+ */
+declare const getRecentPrioritizationFee: (connection: Connection, options: Pick<GetPriorityFeeEstimateOptions, "accountsOrTx">) => Promise<_solana_web3_js.RecentPrioritizationFees[]>;
+
+declare const general_getPriorityFeeEstimate: typeof getPriorityFeeEstimate;
+declare const general_getRecentPrioritizationFee: typeof getRecentPrioritizationFee;
+declare namespace general {
+  export { general_getPriorityFeeEstimate as getPriorityFeeEstimate, general_getRecentPrioritizationFee as getRecentPrioritizationFee };
+}
+
+export { type GetConsumeLimitEstimateOptions, type GetPriorityFeeEstimateOptions, estimateConsumeLimit, general as priorityFeeEstimation, percentile as priorityFeeEstimationPercentile };

package/dist/esm/index.js

@@ -25,7 +25,7 @@ var ContractError = class _ContractError extends Error {
    * @param code extracted code from the error if managed to parse it
    */
   constructor(error, code, description) {
-    super(error.message);
+    super(error.message, { cause: error });
     this.contractErrorCode = code ?? null;
     this.description = description ?? null;
     Object.setPrototypeOf(this, _ContractError.prototype);

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../types.ts","../../lib/assertions.ts","../../lib/utils.ts"],"names":["ICluster","IChain"],"mappings":"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","file":"index.js","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); // 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","const 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","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"],"names":["ICluster","IChain"],"mappings":";;;;AAQY,IAAA,QAAA,qBAAAA,SAAL,KAAA;AACL,EAAAA,UAAA,SAAU,CAAA,GAAA,SAAA;AACV,EAAAA,UAAA,QAAS,CAAA,GAAA,QAAA;AACT,EAAAA,UAAA,SAAU,CAAA,GAAA,SAAA;AACV,EAAAA,UAAA,OAAQ,CAAA,GAAA,OAAA;AAJE,EAAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;AAOA,IAAA,MAAA,qBAAAC,OAAL,KAAA;AACL,EAAAA,QAAA,QAAS,CAAA,GAAA,QAAA;AACT,EAAAA,QAAA,OAAQ,CAAA,GAAA,OAAA;AACR,EAAAA,QAAA,UAAW,CAAA,GAAA,UAAA;AACX,EAAAA,QAAA,KAAM,CAAA,GAAA,KAAA;AACN,EAAAA,QAAA,SAAU,CAAA,GAAA,SAAA;AACV,EAAAA,QAAA,KAAM,CAAA,GAAA,KAAA;AANI,EAAAA,OAAAA,OAAAA;AAAA,CAAA,EAAA,MAAA,IAAA,EAAA;AAYC,IAAA,aAAA,GAAN,MAAM,cAAA,SAAsB,KAAM,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUvC,WAAA,CAAY,KAAc,EAAA,IAAA,EAAsB,WAA6B,EAAA;AAC3E,IAAA,KAAA,CAAM,KAAM,CAAA,OAAA,EAAS,EAAE,KAAA,EAAO,OAAO,CAAA;AACrC,IAAA,IAAA,CAAK,oBAAoB,IAAQ,IAAA,IAAA;AACjC,IAAA,IAAA,CAAK,cAAc,WAAe,IAAA,IAAA;AAElC,IAAO,MAAA,CAAA,cAAA,CAAe,IAAM,EAAA,cAAA,CAAc,SAAS,CAAA;AACnD,IAAA,IAAA,CAAK,IAAO,GAAA,eAAA;AACZ,IAAA,IAAA,CAAK,QAAQ,KAAM,CAAA,KAAA;AAAA;AAEvB;;;AC9CA,IAAM,MAAS,GAAA,kBAAA;AAEF,IAAA,SAAA,GAAsF,CACjG,SAAA,EACA,OACG,KAAA;AACH,EAAA,IAAI,SAAW,EAAA;AACb,IAAA;AAAA;AAEF,EAAA,MAAM,QAA+B,GAAA,OAAO,OAAY,KAAA,UAAA,GAAa,SAAY,GAAA,OAAA;AACjF,EAAA,MAAM,QAAgB,QAAW,GAAA,CAAA,EAAG,MAAM,CAAA,EAAA,EAAK,QAAQ,CAAK,CAAA,GAAA,MAAA;AAC5D,EAAM,MAAA,IAAI,MAAM,KAAK,CAAA;AACvB;ACFa,IAAA,KAAA,GAAQ,CAAC,KAAA,EAAe,QAAyB,KAAA;AAC5D,EAAA,MAAM,WAAc,GAAA,KAAA,GAAQ,IAAK,CAAA,KAAA,CAAM,KAAK,CAAA;AAC5C,EAAA,MAAM,cAAc,IAAI,EAAA,CAAG,IAAK,CAAA,KAAA,CAAM,KAAK,CAAC,CAAA;AAE5C,EAAA,MAAM,QAAW,GAAA,IAAI,EAAG,CAAA,WAAA,GAAc,GAAG,CAAA;AAEzC,EAAM,MAAA,GAAA,GAAM,YAAY,GAAI,CAAA,IAAI,GAAG,GAAG,CAAC,CAAE,CAAA,GAAA,CAAI,QAAQ,CAAA;AACrD,EAAA,MAAM,OAAU,GAAA,GAAA,CAAI,GAAI,CAAA,IAAI,EAAG,CAAA,EAAE,CAAE,CAAA,GAAA,CAAI,IAAI,EAAA,CAAG,QAAQ,CAAC,CAAC,CAAA;AACxD,EAAA,OAAO,OAAQ,CAAA,GAAA,CAAI,IAAI,EAAA,CAAG,GAAG,CAAC,CAAA;AAChC;AAQa,IAAA,eAAA,GAAkB,CAAC,KAAA,EAAW,QACzC,KAAA,KAAA,CAAM,EAAG,CAAA,IAAI,EAAG,CAAA,CAAA,IAAK,EAAK,GAAA,CAAC,CAAC,CAAA,GAAI,MAAM,GAAI,CAAA,IAAI,EAAG,CAAA,EAAA,IAAM,QAAQ,CAAC,CAAE,CAAA,QAAA,EAAa,GAAA,KAAA,CAAM,QAAS,EAAA,GAAI,EAAM,IAAA;AAQ1G,eAAsB,mBAAA,CACpB,MACA,QACY,EAAA;AACZ,EAAI,IAAA;AACF,IAAA,OAAO,MAAM,IAAK,EAAA;AAAA,WAEX,GAAU,EAAA;AACjB,IAAA,IAAI,eAAe,KAAO,EAAA;AACxB,MAAA,IAAI,QAAU,EAAA;AACZ,QAAA,MAAM,IAAI,aAAA,CAAc,GAAK,EAAA,QAAA,CAAS,GAAG,CAAC,CAAA;AAAA;AAE5C,MAAM,MAAA,IAAI,cAAc,GAAG,CAAA;AAAA;AAE7B,IAAM,MAAA,GAAA;AAAA;AAEV;AAMO,SAAS,MAAM,EAA2B,EAAA;AAC/C,EAAA,OAAO,IAAI,OAAQ,CAAA,CAAC,YAAY,UAAW,CAAA,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD;AAEO,IAAM,QAAW,GAAA,CAAC,CAAW,EAAA,CAAA,KAAsB,CAAI,GAAA,CAAA,IAAK,CAAI,GAAA,CAAA,GAAI,MAAO,CAAA,CAAC,CAAI,GAAA,MAAA,CAAO,CAAC,CAAA","file":"index.js","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","const 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","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"]}

package/dist/esm/solana/index.d.ts

@@ -1,4 +1,5 @@
-import { PublicKey, MemcmpFilter, Connection, TransactionInstruction, AccountInfo, BlockhashWithExpiryBlockHeight, Context, Commitment, Keypair, Transaction, VersionedTransaction, RpcResponseAndContext, SimulatedTransactionResponse, SignatureStatus } from '@solana/web3.js';
+import * as _solana_web3_js from '@solana/web3.js';
+import { PublicKey, MemcmpFilter, Connection, TransactionInstruction, VersionedTransaction, AccountInfo, BlockhashWithExpiryBlockHeight, Context, Commitment, Keypair, Transaction, RpcResponseAndContext, SimulatedTransactionResponse, SignatureStatus } from '@solana/web3.js';
 import BN from 'bn.js';
 import PQueue from 'p-queue';
 import { Mint } from '@solana/spl-token';
@@ -8,16 +9,28 @@ declare const getFilters: <T extends Record<string, number | PublicKey>>(criteri
 
 declare const prepareWrappedAccount: (connection: Connection, senderAddress: PublicKey, amount: BN) => Promise<TransactionInstruction[]>;
 
+type ComputePriceEstimate = (tx: string | (string | PublicKey)[]) => Promise<number>;
+type ComputeLimitEstimate = (tx: VersionedTransaction) => Promise<number>;
+interface ITransactionSolanaExt {
+    computePrice?: number | ComputePriceEstimate;
+    computeLimit?: number | ComputeLimitEstimate | "autoSimulate";
+}
 /**
- * Converts a string or PublicKey to a PublicKey object.
- * @param address - The input address as a string or PublicKey.
- * @returns The PublicKey object.
+ * Acceptable type with resolved values.
+ * Function types may be omitted if passed to destinations that do not support them.
  */
-declare const pk: (address: string | PublicKey) => PublicKey;
-
-interface ITransactionSolanaExt {
-    computePrice?: number;
-    computeLimit?: number;
+type ITransactionSolanaExtResolvedValues = {
+    computePrice?: number | ComputePriceEstimate;
+    computeLimit?: number | ComputeLimitEstimate;
+};
+type KeysNotOfA<T, ToExclude> = Pick<T, Exclude<keyof T, keyof ToExclude>>;
+type ITransactionSolanaExtResolved<T extends ITransactionSolanaExt = ITransactionSolanaExt> = {
+    [AK in keyof KeysNotOfA<T, ITransactionSolanaExt>]: T[AK];
+} & ITransactionSolanaExtResolvedValues;
+interface IInteractSolanaExt extends ITransactionSolanaExt {
+    invoker: {
+        publicKey: string | PublicKey | null;
+    };
 }
 interface Account {
     pubkey: PublicKey;
@@ -45,6 +58,9 @@ interface ThrottleParams {
     sendThrottler?: PQueue;
     waitBeforeConfirming?: number | undefined;
 }
+interface TransactionExecutionParams extends ThrottleParams {
+    skipSimulation?: boolean;
+}
 interface IProgramAccount<T> {
     publicKey: PublicKey;
     account: T;
@@ -90,11 +106,12 @@ declare function isTransactionVersioned(tx: Transaction | VersionedTransaction):
  * @param partialSigners - optional signers that will be used to partially sign a Transaction
  * @returns Transaction and Blockhash
  */
-declare function prepareTransaction(connection: Connection, ixs: TransactionInstruction[], payer: PublicKey | undefined | null, commitment?: Commitment, ...partialSigners: (Keypair | undefined)[]): Promise<{
+declare function prepareTransaction(connection: Connection, ixs: TransactionInstruction[], payer: PublicKey | undefined | null, commitment?: Commitment, partialSigners?: (Keypair | undefined)[]): Promise<{
     tx: VersionedTransaction;
     hash: BlockhashWithExpiryBlockHeight;
     context: Context;
 }>;
+declare function createVersionedTransaction(ixs: TransactionInstruction[], payer: PublicKey | undefined | null, recentBlockhash: BlockhashWithExpiryBlockHeight["blockhash"], partialSigners?: (Keypair | undefined)[]): VersionedTransaction;
 declare function signTransaction<T extends Transaction | VersionedTransaction>(invoker: Keypair | SignerWalletAdapter, tx: T): Promise<T>;
 /**
  * Signs, sends and confirms Transaction
@@ -102,10 +119,10 @@ declare function signTransaction<T extends Transaction | VersionedTransaction>(i
  * @param invoker - Keypair used as signer
  * @param tx - Transaction instance
  * @param confirmationParams - Confirmation Params that will be used for execution
- * @param throttleParams - rate or throttler instance to throttle TX sending - to not spam the blockchain too much
+ * @param transactionExecutionParams - rate or throttler instance to throttle TX sending - to not spam the blockchain too much and solana execution params (eg. skipSimulation)
  * @returns Transaction signature
  */
-declare function signAndExecuteTransaction(connection: Connection, invoker: Keypair | SignerWalletAdapter, tx: Transaction | VersionedTransaction, confirmationParams: ConfirmationParams, throttleParams: ThrottleParams): Promise<string>;
+declare function signAndExecuteTransaction(connection: Connection, invoker: Keypair | SignerWalletAdapter, tx: Transaction | VersionedTransaction, confirmationParams: ConfirmationParams, transactionExecutionParams: TransactionExecutionParams): Promise<string>;
 /**
  * Sends and confirms Transaction
  * Uses custom confirmation logic that:
@@ -118,10 +135,10 @@ declare function signAndExecuteTransaction(connection: Connection, invoker: Keyp
  * @param connection - Solana client connection
  * @param tx - Transaction instance
  * @param confirmationParams - Confirmation Params that will be used for execution
- * @param throttleParams - rate or throttler instance to throttle TX sending - to not spam the blockchain too much
+ * @param transactionExecutionParams - rate or throttler instance to throttle TX sending - to not spam the blockchain too much and solana execution params (eg. skipSimulation)
  * @returns Transaction signature
  */
-declare function executeTransaction(connection: Connection, tx: Transaction | VersionedTransaction, confirmationParams: ConfirmationParams, throttleParams: ThrottleParams): Promise<string>;
+declare function executeTransaction(connection: Connection, tx: Transaction | VersionedTransaction, confirmationParams: ConfirmationParams, transactionExecutionParams: TransactionExecutionParams): Promise<string>;
 /**
  * Launches a PromisePool with all transaction being executed at the same time, allows to throttle all TXs through one Queue
  * @param connection - Solana client connection
@@ -207,8 +224,8 @@ declare function createAtaBatch(connection: Connection, invoker: Keypair | Signe
 declare function checkOrCreateAtaBatch(connection: Connection, owners: PublicKey[], mint: PublicKey, invoker: SignerWalletAdapter | Keypair, programId?: PublicKey): Promise<TransactionInstruction[]>;
 /**
  * Create Base instructions for Solana
- * - sets compute price if `computePrice` is provided
- * - sets compute limit if `computeLimit` is provided
+ * - sets compute price if `computePrice` is provided. If `computePrice` is a function, it will be ignored (the value must be resolved before calling this function).
+ * - sets compute limit if `computeLimit` is provided. If `computeLimit` is a function, it will be ignored (the value must be resolved before calling this function).
  */
 declare function prepareBaseInstructions(connection: Connection, { computePrice, computeLimit }: ITransactionSolanaExt): TransactionInstruction[];
 /**
@@ -236,4 +253,45 @@ declare function getMintAndProgram(connection: Connection, address: PublicKey, c
  */
 declare function getMultipleAccountsInfoBatched(connection: Connection, pubKeys: PublicKey[], commitment?: Commitment): Promise<(AccountInfo<Buffer> | null)[]>;
 
-export { type Account, type AtaParams, type CheckAssociatedTokenAccountsData, type ConfirmationParams, type IProgramAccount, type ITransactionSolanaExt, type ThrottleParams, TransactionFailedError, ata, ataBatchExist, buildSendThrottler, checkOrCreateAtaBatch, confirmAndEnsureTransaction, createAtaBatch, enrichAtaParams, executeMultipleTransactions, executeTransaction, generateCreateAtaBatchTx, getFilters, getMintAndProgram, getMultipleAccountsInfoBatched, getProgramAccounts, isSignerKeypair, isSignerWallet, isTransactionVersioned, pk, prepareBaseInstructions, prepareTransaction, prepareWrappedAccount, sendAndConfirmTransaction, signAndExecuteTransaction, signTransaction, simulateTransaction };
+declare function deserializeRawTransaction(serializedTx: string): {
+    type: string;
+    transaction: Transaction;
+    accounts: PublicKey[];
+    writableAccounts: PublicKey[];
+} | {
+    type: string;
+    transaction: VersionedTransaction;
+    accounts: PublicKey[];
+    writableAccounts: PublicKey[];
+};
+declare const resolveTransactionAccounts: (tx: VersionedTransaction | Transaction) => {
+    type: string;
+    transaction: Transaction;
+    accounts: PublicKey[];
+    writableAccounts: PublicKey[];
+} | {
+    type: string;
+    transaction: VersionedTransaction;
+    accounts: PublicKey[];
+    writableAccounts: PublicKey[];
+};
+
+declare const createTestTransaction: (ixs: Parameters<typeof createVersionedTransaction>[0], payer: Parameters<typeof createVersionedTransaction>[1], recentBlockhash?: Parameters<typeof createVersionedTransaction>[2], partialSigners?: Parameters<typeof createVersionedTransaction>[3]) => _solana_web3_js.VersionedTransaction;
+declare function estimateComputeUnitPrice(estimate: ComputePriceEstimate, testTx: ReturnType<typeof createTestTransaction>): Promise<number>;
+declare function createAndEstimateTransaction<ParamsT extends ITransactionSolanaExtResolved<IInteractSolanaExt>, CreateFn extends (extParams: ParamsT) => Promise<TransactionInstruction[]>>(createFn: CreateFn, extParams: ParamsT): Promise<Awaited<ReturnType<CreateFn>>>;
+declare function createAndEstimateTransaction<ParamsT extends ITransactionSolanaExtResolved<IInteractSolanaExt>, CreateFn extends (extParams: ParamsT) => Promise<any>>(createFn: CreateFn, extParams: ParamsT, select: (result: Awaited<ReturnType<CreateFn>>) => TransactionInstruction[]): Promise<Awaited<ReturnType<CreateFn>>>;
+
+/**
+ * Converts a string or PublicKey to a PublicKey object.
+ * @param address - The input address as a string or PublicKey.
+ * @returns The PublicKey object.
+ */
+declare const pk: (address: string | PublicKey) => PublicKey;
+
+type UnwrapAutoSimulate<T extends IInteractSolanaExt = IInteractSolanaExt> = Omit<T, "computeLimit"> & {
+    skipSimulation: boolean;
+    computeLimit?: ITransactionSolanaExtResolved["computeLimit"];
+};
+declare const unwrapExecutionParams: <T extends IInteractSolanaExt>({ computeLimit, ...rest }: T, connection: Connection) => UnwrapAutoSimulate<T>;
+
+export { type Account, type AtaParams, type CheckAssociatedTokenAccountsData, type ComputeLimitEstimate, type ComputePriceEstimate, type ConfirmationParams, type IInteractSolanaExt, type IProgramAccount, type ITransactionSolanaExt, type ITransactionSolanaExtResolved, type ThrottleParams, type TransactionExecutionParams, TransactionFailedError, ata, ataBatchExist, buildSendThrottler, checkOrCreateAtaBatch, confirmAndEnsureTransaction, createAndEstimateTransaction, createAtaBatch, createVersionedTransaction, deserializeRawTransaction, enrichAtaParams, estimateComputeUnitPrice, executeMultipleTransactions, executeTransaction, generateCreateAtaBatchTx, getFilters, getMintAndProgram, getMultipleAccountsInfoBatched, getProgramAccounts, isSignerKeypair, isSignerWallet, isTransactionVersioned, pk, prepareBaseInstructions, prepareTransaction, prepareWrappedAccount, resolveTransactionAccounts, sendAndConfirmTransaction, signAndExecuteTransaction, signTransaction, simulateTransaction, unwrapExecutionParams };