@lifi/sdk 4.0.0-alpha.2 → 4.0.0-alpha.21

package/dist/esm/errors/SDKError.js

@@ -1,18 +1,18 @@
 import { version } from '../version.js';
 // Note: SDKError is used to wrapper and present errors at the top level
-// Where opportunity allows we also add the step and the process related to the error
+// Where opportunity allows we also add the step and the action related to the error
 export class SDKError extends Error {
     step;
-    process;
+    action;
     code;
     name = 'SDKError';
     cause;
-    constructor(cause, step, process) {
+    constructor(cause, step, action) {
         const errorMessage = `${cause.message ? `[${cause.name}] ${cause.message}` : 'Unknown error occurred'}\nLI.FI SDK version: ${version}`;
         super(errorMessage);
         this.name = 'SDKError';
         this.step = step;
-        this.process = process;
+        this.action = action;
         this.cause = cause;
         this.stack = this.cause.stack;
         this.code = cause.code;

package/dist/esm/errors/SDKError.js.map

@@ -1 +1 @@
-{"version":3,"file":"SDKError.js","sourceRoot":"","sources":["../../../src/errors/SDKError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAIvC,wEAAwE;AACxE,qFAAqF;AACrF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAW;IACf,OAAO,CAAU;IACjB,IAAI,CAAW;IACN,IAAI,GAAG,UAAU,CAAA;IACjB,KAAK,CAAW;IAEzB,YAAY,KAAgB,EAAE,IAAe,EAAE,OAAiB;QAC9D,MAAM,YAAY,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,wBAAwB,wBAAwB,OAAO,EAAE,CAAA;QACtI,KAAK,CAAC,YAAY,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}
+{"version":3,"file":"SDKError.js","sourceRoot":"","sources":["../../../src/errors/SDKError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAIvC,wEAAwE;AACxE,oFAAoF;AACpF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAW;IACf,MAAM,CAAkB;IACxB,IAAI,CAAW;IACN,IAAI,GAAG,UAAU,CAAA;IACjB,KAAK,CAAW;IAEzB,YAAY,KAAgB,EAAE,IAAe,EAAE,MAAwB;QACrE,MAAM,YAAY,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,wBAAwB,wBAAwB,OAAO,EAAE,CAAA;QACtI,KAAK,CAAC,YAAY,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}

package/dist/esm/errors/constants.d.ts

@@ -8,7 +8,9 @@ export declare enum ErrorName {
     NotFoundError = "NotFoundError",
     UnknownError = "UnknownError",
     SlippageError = "SlippageError",
-    HTTPError = "HTTPError"
+    HTTPError = "HTTPError",
+    ConfigError = "ConfigError",
+    ExecuteStepRetryError = "ExecuteStepRetryError"
 }
 export type ErrorCode = LiFiErrorCode;
 export declare enum LiFiErrorCode {
@@ -37,7 +39,8 @@ export declare enum LiFiErrorCode {
     TransactionRejected = 1022,
     RateLimitExceeded = 1023,
     ThirdPartyError = 1024,
-    InsufficientGas = 1025
+    InsufficientGas = 1025,
+    ConfigError = 1026
 }
 export declare enum ErrorMessage {
     UnknownError = "Unknown error occurred.",

package/dist/esm/errors/constants.js

@@ -10,6 +10,8 @@ export var ErrorName;
     ErrorName["UnknownError"] = "UnknownError";
     ErrorName["SlippageError"] = "SlippageError";
     ErrorName["HTTPError"] = "HTTPError";
+    ErrorName["ConfigError"] = "ConfigError";
+    ErrorName["ExecuteStepRetryError"] = "ExecuteStepRetryError";
 })(ErrorName || (ErrorName = {}));
 export var LiFiErrorCode;
 (function (LiFiErrorCode) {
@@ -39,6 +41,7 @@ export var LiFiErrorCode;
     LiFiErrorCode[LiFiErrorCode["RateLimitExceeded"] = 1023] = "RateLimitExceeded";
     LiFiErrorCode[LiFiErrorCode["ThirdPartyError"] = 1024] = "ThirdPartyError";
     LiFiErrorCode[LiFiErrorCode["InsufficientGas"] = 1025] = "InsufficientGas";
+    LiFiErrorCode[LiFiErrorCode["ConfigError"] = 1026] = "ConfigError";
 })(LiFiErrorCode || (LiFiErrorCode = {}));
 export var ErrorMessage;
 (function (ErrorMessage) {

package/dist/esm/errors/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAWX;AAXD,WAAY,SAAS;IACnB,kCAAqB,CAAA;IACrB,4CAA+B,CAAA;IAC/B,wCAA2B,CAAA;IAC3B,kDAAqC,CAAA;IACrC,gDAAmC,CAAA;IACnC,0CAA6B,CAAA;IAC7B,4CAA+B,CAAA;IAC/B,0CAA6B,CAAA;IAC7B,4CAA+B,CAAA;IAC/B,oCAAuB,CAAA;AACzB,CAAC,EAXW,SAAS,KAAT,SAAS,QAWpB;AAID,MAAM,CAAN,IAAY,aA2BX;AA3BD,WAAY,aAAa;IACvB,sEAAoB,CAAA;IACpB,0EAAsB,CAAA;IACtB,wFAA6B,CAAA;IAC7B,8EAAwB,CAAA;IACxB,0DAAc,CAAA;IACd,kFAA0B,CAAA;IAC1B,4DAAe,CAAA;IACf,4EAAuB,CAAA;IACvB,sFAA4B,CAAA;IAC5B,sEAAoB,CAAA;IACpB,kFAA0B,CAAA;IAC1B,sEAAoB,CAAA;IACpB,8EAAwB,CAAA;IACxB,oEAAmB,CAAA;IACnB,8EAAwB,CAAA;IACxB,8EAAwB,CAAA;IACxB,gGAAiC,CAAA;IACjC,oGAAmC,CAAA;IACnC,gFAAyB,CAAA;IACzB,kGAAkC,CAAA;IAClC,kFAA0B,CAAA;IAC1B,kFAA0B,CAAA;IAC1B,kFAA0B,CAAA;IAC1B,8EAAwB,CAAA;IACxB,0EAAsB,CAAA;IACtB,0EAAsB,CAAA;AACxB,CAAC,EA3BW,aAAa,KAAb,aAAa,QA2BxB;AAED,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,wDAAwC,CAAA;IACxC,qIAAqH,CAAA;IACrH,qDAAqC,CAAA;IACrC,sEAAsD,CAAA;IACtD,iEAAiD,CAAA;AACnD,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/errors/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,kCAAqB,CAAA;IACrB,4CAA+B,CAAA;IAC/B,wCAA2B,CAAA;IAC3B,kDAAqC,CAAA;IACrC,gDAAmC,CAAA;IACnC,0CAA6B,CAAA;IAC7B,4CAA+B,CAAA;IAC/B,0CAA6B,CAAA;IAC7B,4CAA+B,CAAA;IAC/B,oCAAuB,CAAA;IACvB,wCAA2B,CAAA;IAC3B,4DAA+C,CAAA;AACjD,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB;AAID,MAAM,CAAN,IAAY,aA4BX;AA5BD,WAAY,aAAa;IACvB,sEAAoB,CAAA;IACpB,0EAAsB,CAAA;IACtB,wFAA6B,CAAA;IAC7B,8EAAwB,CAAA;IACxB,0DAAc,CAAA;IACd,kFAA0B,CAAA;IAC1B,4DAAe,CAAA;IACf,4EAAuB,CAAA;IACvB,sFAA4B,CAAA;IAC5B,sEAAoB,CAAA;IACpB,kFAA0B,CAAA;IAC1B,sEAAoB,CAAA;IACpB,8EAAwB,CAAA;IACxB,oEAAmB,CAAA;IACnB,8EAAwB,CAAA;IACxB,8EAAwB,CAAA;IACxB,gGAAiC,CAAA;IACjC,oGAAmC,CAAA;IACnC,gFAAyB,CAAA;IACzB,kGAAkC,CAAA;IAClC,kFAA0B,CAAA;IAC1B,kFAA0B,CAAA;IAC1B,kFAA0B,CAAA;IAC1B,8EAAwB,CAAA;IACxB,0EAAsB,CAAA;IACtB,0EAAsB,CAAA;IACtB,kEAAkB,CAAA;AACpB,CAAC,EA5BW,aAAa,KAAb,aAAa,QA4BxB;AAED,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,wDAAwC,CAAA;IACxC,qIAAqH,CAAA;IACrH,qDAAqC,CAAA;IACrC,sEAAsD,CAAA;IACtD,iEAAiD,CAAA;AACnD,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB"}

package/dist/esm/errors/errors.d.ts

@@ -1,3 +1,4 @@
+import type { ExecuteStepRetryParams } from '../types/core.js';
 import { BaseError } from './baseError.js';
 import { LiFiErrorCode } from './constants.js';
 export declare class RPCError extends BaseError {
@@ -21,3 +22,12 @@ export declare class ServerError extends BaseError {
 export declare class ValidationError extends BaseError {
     constructor(message: string);
 }
+/**
+ * Thrown by a step executor when executeStep should be retried with the given params
+ * (e.g. wallet rejected 7702 upgrade → retry with atomicityNotReady).
+ * The execution layer catches this and retries executeStep(client, step, retryParams).
+ */
+export declare class ExecuteStepRetryError extends BaseError {
+    readonly retryParams: ExecuteStepRetryParams;
+    constructor(message: string, retryParams: ExecuteStepRetryParams, cause?: Error);
+}

package/dist/esm/errors/errors.js

@@ -35,4 +35,16 @@ export class ValidationError extends BaseError {
         super(ErrorName.ValidationError, LiFiErrorCode.ValidationError, message);
     }
 }
+/**
+ * Thrown by a step executor when executeStep should be retried with the given params
+ * (e.g. wallet rejected 7702 upgrade → retry with atomicityNotReady).
+ * The execution layer catches this and retries executeStep(client, step, retryParams).
+ */
+export class ExecuteStepRetryError extends BaseError {
+    retryParams;
+    constructor(message, retryParams, cause) {
+        super(ErrorName.ExecuteStepRetryError, LiFiErrorCode.InternalError, message, cause);
+        this.retryParams = retryParams;
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/esm/errors/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEzD,MAAM,OAAO,QAAS,SAAQ,SAAS;IACrC,YAAY,IAAmB,EAAE,OAAe,EAAE,KAAa;QAC7D,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACjD,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,IAAmB,EAAE,OAAe,EAAE,KAAa;QAC7D,KAAK,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACtD,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,IAAmB,EAAE,OAAe,EAAE,KAAa;QAC7D,KAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACzD,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC5E,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3E,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IACpE,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,SAAS,CAAC,eAAe,EAAE,aAAa,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IAC1E,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/errors/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEzD,MAAM,OAAO,QAAS,SAAQ,SAAS;IACrC,YAAY,IAAmB,EAAE,OAAe,EAAE,KAAa;QAC7D,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACjD,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,IAAmB,EAAE,OAAe,EAAE,KAAa;QAC7D,KAAK,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACtD,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,IAAmB,EAAE,OAAe,EAAE,KAAa;QAC7D,KAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACzD,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC5E,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3E,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IACpE,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,SAAS,CAAC,eAAe,EAAE,aAAa,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IAC1E,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IACzC,WAAW,CAAwB;IAE5C,YACE,OAAe,EACf,WAAmC,EACnC,KAAa;QAEb,KAAK,CACH,SAAS,CAAC,qBAAqB,EAC/B,aAAa,CAAC,aAAa,EAC3B,OAAO,EACP,KAAK,CACN,CAAA;QACD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAChC,CAAC;CACF"}

package/dist/esm/index.d.ts

@@ -1,7 +1,5 @@
 export * from '@lifi/types';
-export type { Client } from 'viem';
-export { formatUnits, isHex, parseUnits } from 'viem/utils';
-export { getChains, getChainsFromConfig } from './actions/getChains.js';
+export { getChains } from './actions/getChains.js';
 export { getConnections } from './actions/getConnections.js';
 export { getContractCallsQuote } from './actions/getContractCallsQuote.js';
 export { getGasRecommendation } from './actions/getGasRecommendation.js';
@@ -21,25 +19,37 @@ export { getTools } from './actions/getTools.js';
 export { getTransactionHistory } from './actions/getTransactionHistory.js';
 export { getWalletBalances } from './actions/getWalletBalances.js';
 export { actions } from './actions/index.js';
+export { patchContractCalls } from './actions/patchContractCalls.js';
 export { relayTransaction } from './actions/relayTransaction.js';
 export { createClient } from './client/createClient.js';
+export { getActionMessage, getSubstatusMessage } from './core/actionMessages.js';
+export { BaseStepExecutionTask } from './core/BaseStepExecutionTask.js';
 export { BaseStepExecutor } from './core/BaseStepExecutor.js';
-export { checkBalance } from './core/checkBalance.js';
 export { executeRoute, getActiveRoute, getActiveRoutes, resumeRoute, stopRouteExecution, updateRouteExecution, } from './core/execution.js';
 export { StatusManager } from './core/StatusManager.js';
-export { stepComparison } from './core/stepComparison.js';
-export { isTokenMessageSigningAllowed } from './core/utils.js';
-export { waitForDestinationChainTransaction } from './core/waitForDestinationChainTransaction.js';
+export type { SDKStorage } from './core/storage.js';
+export { createDefaultStorage, InMemoryStorage, LocalStorageAdapter, } from './core/storage.js';
+export { TaskPipeline } from './core/TaskPipeline.js';
+export { CheckBalanceTask } from './core/tasks/CheckBalanceTask.js';
+export { checkBalance } from './core/tasks/helpers/checkBalance.js';
+export { getTransactionRequestData } from './core/tasks/helpers/getTransactionRequestData.js';
+export { stepComparison } from './core/tasks/helpers/stepComparison.js';
+export { PrepareTransactionTask } from './core/tasks/PrepareTransactionTask.js';
+export { WaitForTransactionStatusTask } from './core/tasks/WaitForTransactionStatusTask.js';
 export { BaseError } from './errors/baseError.js';
 export type { ErrorCode } from './errors/constants.js';
 export { ErrorMessage, ErrorName, LiFiErrorCode } from './errors/constants.js';
-export { BalanceError, ProviderError, RPCError, ServerError, TransactionError, UnknownError, ValidationError, } from './errors/errors.js';
+export { BalanceError, ExecuteStepRetryError, ProviderError, RPCError, ServerError, TransactionError, UnknownError, ValidationError, } from './errors/errors.js';
 export { HTTPError } from './errors/httpError.js';
 export { SDKError } from './errors/SDKError.js';
-export type { AcceptExchangeRateUpdateHook, AcceptSlippageUpdateHook, AcceptSlippageUpdateHookParams, ExchangeRateUpdateParams, Execution, ExecutionOptions, ExecutionStatus, InteractionSettings, LiFiStepExtended, Process, ProcessStatus, ProcessType, RouteExecutionData, RouteExecutionDataDictionary, RouteExecutionDictionary, RouteExtended, RPCUrls, SDKBaseConfig, SDKClient, SDKConfig, SDKProvider, StepExecutor, StepExecutorOptions, StepExtended, SwitchChainHook, TransactionMethodType, TransactionParameters, TransactionRequestParameters, TransactionRequestUpdateHook, UpdateRouteHook, } from './types/core.js';
+export type { AcceptExchangeRateUpdateHook, AcceptSlippageUpdateHook, AcceptSlippageUpdateHookParams, ContractCallParams, ContractTool, ExchangeRateUpdateParams, ExecuteStepRetryParams, Execution, ExecutionAction, ExecutionActionStatus, ExecutionActionType, ExecutionOptions, ExecutionStatus, GetContractCallsHook, GetContractCallsResult, InteractionSettings, LiFiStepExtended, RequestInterceptor, RouteExecutionData, RouteExecutionDataDictionary, RouteExecutionDictionary, RouteExtended, RPCUrls, SDKBaseConfig, SDKClient, SDKConfig, SDKProvider, StepExecutor, StepExecutorOptions, StepExtended, TransactionMethodType, TransactionParameters, TransactionRequestParameters, TransactionRequestUpdateHook, UpdateRouteHook, } from './types/core.js';
+export type { StepExecutorBaseContext, StepExecutorContext, TaskResult, TaskStatus, } from './types/execution.js';
 export { checkPackageUpdates } from './utils/checkPackageUpdates.js';
 export { convertQuoteToRoute } from './utils/convertQuoteToRoute.js';
 export { fetchTxErrorDetails } from './utils/fetchTxErrorDetails.js';
+export { formatUnits } from './utils/formatUnits.js';
+export { isHex } from './utils/isHex.js';
+export { parseUnits } from './utils/parseUnits.js';
 export { sleep } from './utils/sleep.js';
 export { waitForResult } from './utils/waitForResult.js';
-export { withDedupe } from './utils/withDedupe.js';
+export { LruMap, withDedupe } from './utils/withDedupe.js';

package/dist/esm/index.js

@@ -1,8 +1,7 @@
 // biome-ignore lint/performance/noBarrelFile: module entrypoint
 // biome-ignore lint/performance/noReExportAll: types
 export * from '@lifi/types';
-export { formatUnits, isHex, parseUnits } from 'viem/utils';
-export { getChains, getChainsFromConfig } from './actions/getChains.js';
+export { getChains } from './actions/getChains.js';
 export { getConnections } from './actions/getConnections.js';
 export { getContractCallsQuote } from './actions/getContractCallsQuote.js';
 export { getGasRecommendation } from './actions/getGasRecommendation.js';
@@ -22,24 +21,34 @@ export { getTools } from './actions/getTools.js';
 export { getTransactionHistory } from './actions/getTransactionHistory.js';
 export { getWalletBalances } from './actions/getWalletBalances.js';
 export { actions } from './actions/index.js';
+export { patchContractCalls } from './actions/patchContractCalls.js';
 export { relayTransaction } from './actions/relayTransaction.js';
 export { createClient } from './client/createClient.js';
+export { getActionMessage, getSubstatusMessage } from './core/actionMessages.js';
+export { BaseStepExecutionTask } from './core/BaseStepExecutionTask.js';
 export { BaseStepExecutor } from './core/BaseStepExecutor.js';
-export { checkBalance } from './core/checkBalance.js';
 export { executeRoute, getActiveRoute, getActiveRoutes, resumeRoute, stopRouteExecution, updateRouteExecution, } from './core/execution.js';
 export { StatusManager } from './core/StatusManager.js';
-export { stepComparison } from './core/stepComparison.js';
-export { isTokenMessageSigningAllowed } from './core/utils.js';
-export { waitForDestinationChainTransaction } from './core/waitForDestinationChainTransaction.js';
+export { createDefaultStorage, InMemoryStorage, LocalStorageAdapter, } from './core/storage.js';
+export { TaskPipeline } from './core/TaskPipeline.js';
+export { CheckBalanceTask } from './core/tasks/CheckBalanceTask.js';
+export { checkBalance } from './core/tasks/helpers/checkBalance.js';
+export { getTransactionRequestData } from './core/tasks/helpers/getTransactionRequestData.js';
+export { stepComparison } from './core/tasks/helpers/stepComparison.js';
+export { PrepareTransactionTask } from './core/tasks/PrepareTransactionTask.js';
+export { WaitForTransactionStatusTask } from './core/tasks/WaitForTransactionStatusTask.js';
 export { BaseError } from './errors/baseError.js';
 export { ErrorMessage, ErrorName, LiFiErrorCode } from './errors/constants.js';
-export { BalanceError, ProviderError, RPCError, ServerError, TransactionError, UnknownError, ValidationError, } from './errors/errors.js';
+export { BalanceError, ExecuteStepRetryError, ProviderError, RPCError, ServerError, TransactionError, UnknownError, ValidationError, } from './errors/errors.js';
 export { HTTPError } from './errors/httpError.js';
 export { SDKError } from './errors/SDKError.js';
 export { checkPackageUpdates } from './utils/checkPackageUpdates.js';
 export { convertQuoteToRoute } from './utils/convertQuoteToRoute.js';
 export { fetchTxErrorDetails } from './utils/fetchTxErrorDetails.js';
+export { formatUnits } from './utils/formatUnits.js';
+export { isHex } from './utils/isHex.js';
+export { parseUnits } from './utils/parseUnits.js';
 export { sleep } from './utils/sleep.js';
 export { waitForResult } from './utils/waitForResult.js';
-export { withDedupe } from './utils/withDedupe.js';
+export { LruMap, withDedupe } from './utils/withDedupe.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/core.d.ts

@@ -1,5 +1,7 @@
-import type { ChainId, ChainType, CoinKey, ExtendedChain, FeeCost, GasCost, LiFiStep, Route, RouteOptions, Step, Substatus, Token, TokenAmount } from '@lifi/types';
-import type { Client } from 'viem';
+import type { ChainId, ChainType, CoinKey, ContractCall, ExtendedChain, FeeCost, GasCost, LiFiStep, Route, RouteOptions, Step, Substatus, Token, TokenAmount } from '@lifi/types';
+import type { SDKStorage } from '../core/storage.js';
+import type { ExtendedRequestInit } from './request.js';
+export type RequestInterceptor = (request: ExtendedRequestInit) => ExtendedRequestInit | Promise<ExtendedRequestInit>;
 export interface SDKBaseConfig {
     apiKey?: string;
     apiUrl: string;
@@ -11,6 +13,10 @@ export interface SDKBaseConfig {
     disableVersionCheck?: boolean;
     widgetVersion?: string;
     debug: boolean;
+    preloadChains?: boolean;
+    chainsRefetchInterval?: number;
+    requestInterceptor?: RequestInterceptor;
+    storage?: SDKStorage;
 }
 export interface SDKConfig extends Partial<Omit<SDKBaseConfig, 'integrator'>> {
     integrator: string;
@@ -28,6 +34,7 @@ export interface SDKClient {
     providers: SDKProvider[];
     getProvider(type: ChainType): SDKProvider | undefined;
     setProviders(providers: SDKProvider[]): void;
+    setChains(chains: ExtendedChain[]): void;
     getChains(): Promise<ExtendedChain[]>;
     getChainById(chainId: ChainId): Promise<ExtendedChain>;
     getRpcUrls(): Promise<RPCUrls>;
@@ -42,11 +49,16 @@ export interface InteractionSettings {
     allowUpdates?: boolean;
     allowExecution?: boolean;
 }
+/**
+ * Params passed when retrying executeStep after an ExecuteStepRetryError.
+ * Providers can use this to pass strategy-specific retry options (e.g. atomicityNotReady for Ethereum 7702).
+ */
+export type ExecuteStepRetryParams = Record<string, unknown>;
 export interface StepExecutor {
     allowUserInteraction: boolean;
     allowExecution: boolean;
     setInteraction(settings?: InteractionSettings): void;
-    executeStep(client: SDKClient, step: LiFiStepExtended): Promise<LiFiStepExtended>;
+    executeStep(client: SDKClient, step: LiFiStepExtended, retryParams?: ExecuteStepRetryParams): Promise<LiFiStepExtended>;
 }
 export interface RouteExecutionData {
     route: Route;
@@ -81,7 +93,6 @@ export interface TransactionRequestParameters extends TransactionParameters {
     requestType: 'approve' | 'transaction';
 }
 export type TransactionRequestUpdateHook = (updatedTxRequest: TransactionRequestParameters) => Promise<TransactionParameters>;
-export type SwitchChainHook = (chainId: number) => Promise<Client | undefined>;
 export interface AcceptSlippageUpdateHookParams {
     toToken: Token;
     oldToAmount: string;
@@ -96,48 +107,66 @@ export interface ExchangeRateUpdateParams {
     newToAmount: string;
 }
 export type AcceptExchangeRateUpdateHook = (params: ExchangeRateUpdateParams) => Promise<boolean | undefined>;
+export interface ContractCallParams {
+    fromChainId: number;
+    toChainId: number;
+    fromTokenAddress: string;
+    toTokenAddress: string;
+    fromAddress: string;
+    toAddress?: string;
+    fromAmount: bigint;
+    toAmount: bigint;
+    slippage?: number;
+}
+export interface ContractTool {
+    name: string;
+    logoURI: string;
+}
+export interface GetContractCallsResult {
+    contractCalls: ContractCall[];
+    patcher?: boolean;
+    contractTool?: ContractTool;
+}
+export type GetContractCallsHook = (params: ContractCallParams) => Promise<GetContractCallsResult>;
 export interface ExecutionOptions {
     acceptExchangeRateUpdateHook?: AcceptExchangeRateUpdateHook;
-    switchChainHook?: SwitchChainHook;
     updateRouteHook?: UpdateRouteHook;
     updateTransactionRequestHook?: TransactionRequestUpdateHook;
+    getContractCalls?: GetContractCallsHook;
+    adjustZeroOutputFromPreviousStep?: boolean;
     executeInBackground?: boolean;
-    disableMessageSigning?: boolean;
     /**
      * @deprecated
      */
     infiniteApproval?: boolean;
 }
 export type ExecutionStatus = 'ACTION_REQUIRED' | 'PENDING' | 'FAILED' | 'DONE';
-export type ProcessStatus = 'STARTED' | 'ACTION_REQUIRED' | 'MESSAGE_REQUIRED' | 'RESET_REQUIRED' | 'PENDING' | 'FAILED' | 'DONE' | 'CANCELLED';
-export type ProcessType = 'TOKEN_ALLOWANCE' | 'PERMIT' | 'SWAP' | 'CROSS_CHAIN' | 'RECEIVING_CHAIN';
-export type Process = {
-    type: ProcessType;
-    status: ProcessStatus;
+export type ExecutionActionStatus = 'STARTED' | 'ACTION_REQUIRED' | 'MESSAGE_REQUIRED' | 'RESET_REQUIRED' | 'PENDING' | 'FAILED' | 'DONE' | 'CANCELLED';
+export type ExecutionActionType = 'PERMIT' | 'CHECK_ALLOWANCE' | 'NATIVE_PERMIT' | 'RESET_ALLOWANCE' | 'SET_ALLOWANCE' | 'SWAP' | 'CROSS_CHAIN' | 'RECEIVING_CHAIN';
+export type ExecutionAction = {
+    type: ExecutionActionType;
+    status: ExecutionActionStatus;
+    message?: string;
     substatus?: Substatus;
+    substatusMessage?: string;
     chainId?: number;
     txHash?: string;
-    taskId?: string;
     txLink?: string;
+    taskId?: string;
     txType?: TransactionMethodType;
-    actionRequiredAt?: number;
-    doneAt?: number;
-    failedAt?: number;
-    pendingAt?: number;
-    startedAt: number;
-    message?: string;
+    txHex?: string;
     error?: {
         code: string | number;
         message: string;
         htmlMessage?: string;
     };
-    [key: string]: any;
 };
 export interface Execution {
     startedAt: number;
-    doneAt?: number;
+    signedAt?: number;
     status: ExecutionStatus;
-    process: Array<Process>;
+    actions: Array<ExecutionAction>;
+    lastActionType?: ExecutionActionType;
     fromAmount?: string;
     toAmount?: string;
     toToken?: Token;
@@ -145,5 +174,10 @@ export interface Execution {
     gasCosts?: GasCost[];
     internalTxLink?: string;
     externalTxLink?: string;
+    error?: {
+        code: string | number;
+        message: string;
+        htmlMessage?: string;
+    };
 }
 export type TransactionMethodType = 'standard' | 'relayed' | 'batched';

package/dist/esm/types/execution.d.ts

@@ -0,0 +1,23 @@
+import type { ExtendedChain } from '@lifi/types';
+import type { StatusManager } from '../core/StatusManager.js';
+import type { ExecuteStepRetryParams, ExecutionOptions, LiFiStepExtended, SDKClient } from './core.js';
+export interface StepExecutorBaseContext {
+    statusManager: StatusManager;
+    executionOptions?: ExecutionOptions;
+    fromChain: ExtendedChain;
+    toChain: ExtendedChain;
+    isBridgeExecution: boolean;
+    client: SDKClient;
+    step: LiFiStepExtended;
+    allowUserInteraction: boolean;
+    retryParams?: ExecuteStepRetryParams;
+}
+export interface StepExecutorContext extends StepExecutorBaseContext {
+    pollingIntervalMs?: number;
+}
+export interface TaskResult<TContext = Record<string, unknown>> {
+    status: TaskStatus;
+    /** Optional: data produced for downstream tasks. Pipeline merges into the executor context. */
+    context?: TContext;
+}
+export type TaskStatus = 'COMPLETED' | 'PAUSED';

package/dist/esm/types/execution.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution.js.map

package/dist/esm/types/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../../src/types/execution.ts"],"names":[],"mappings":""}

package/dist/esm/utils/convertQuoteToRoute.d.ts

@@ -1,10 +1,18 @@
 import type { LiFiStep, Route } from '@lifi/types';
+interface ConvertQuoteToRouteOptions {
+    /**
+     * When true, if the quote has zero output values (toAmount, toAmountMin, toAmountUSD),
+     * use the values from the previous included step that has non-zero output.
+     */
+    adjustZeroOutputFromPreviousStep?: boolean;
+}
+export declare function formatTokenPrice(amount?: string | bigint, price?: string, decimals?: number): number;
 /**
  * Converts a quote to Route
  * @param quote - Step returned from the quote endpoint.
- * @param txHash
- * @param chainId
+ * @param options - Optional configuration for handling edge cases.
  * @returns - The route to be executed.
  * @throws {BaseError} Throws a ValidationError if the step has missing values.
  */
-export declare const convertQuoteToRoute: (quote: LiFiStep) => Route;
+export declare const convertQuoteToRoute: (quote: LiFiStep, options?: ConvertQuoteToRouteOptions) => Route;
+export {};

package/dist/esm/utils/convertQuoteToRoute.js

@@ -1,18 +1,87 @@
 import { ValidationError } from '../errors/errors.js';
 import { SDKError } from '../errors/SDKError.js';
+import { formatUnits } from './formatUnits.js';
+const parseBigInt = (value) => {
+    if (!value) {
+        return 0n;
+    }
+    try {
+        return BigInt(value);
+    }
+    catch {
+        return 0n;
+    }
+};
+const parseNumber = (value) => {
+    if (!value) {
+        return 0;
+    }
+    const parsed = Number(value);
+    return Number.isNaN(parsed) ? 0 : parsed;
+};
+const isZeroOutput = (toAmount, toAmountMin, toAmountUSD) => {
+    return (!parseBigInt(toAmount) &&
+        !parseBigInt(toAmountMin) &&
+        !parseNumber(toAmountUSD));
+};
+const hasNonZeroOutput = (step) => {
+    return (!!parseBigInt(step.estimate.toAmount) ||
+        !!parseBigInt(step.estimate.toAmountMin));
+};
+const findPreviousNonZeroStep = (steps) => {
+    // Find the last step that has non-zero output (the step before the zero output step)
+    for (let i = steps.length - 1; i >= 0; i--) {
+        const step = steps[i];
+        if (hasNonZeroOutput(step)) {
+            return step;
+        }
+    }
+    return undefined;
+};
+export function formatTokenPrice(amount, price, decimals) {
+    if (!amount || !price) {
+        return 0;
+    }
+    const formattedAmount = typeof amount === 'bigint' && decimals !== undefined
+        ? formatUnits(amount, decimals)
+        : amount.toString();
+    if (Number.isNaN(Number(formattedAmount)) || Number.isNaN(Number(price))) {
+        return 0;
+    }
+    return Number.parseFloat(formattedAmount) * Number.parseFloat(price);
+}
 /**
  * Converts a quote to Route
  * @param quote - Step returned from the quote endpoint.
- * @param txHash
- * @param chainId
+ * @param options - Optional configuration for handling edge cases.
  * @returns - The route to be executed.
  * @throws {BaseError} Throws a ValidationError if the step has missing values.
  */
-export const convertQuoteToRoute = (quote) => {
+export const convertQuoteToRoute = (quote, options) => {
+    let toAmount = quote.estimate.toAmount;
+    let toAmountMin = quote.estimate.toAmountMin;
+    let toAmountUSD = quote.estimate.toAmountUSD;
+    // Handle zero output values by looking at previous included step
+    if (options?.adjustZeroOutputFromPreviousStep &&
+        quote.includedSteps?.length &&
+        isZeroOutput(toAmount, toAmountMin, toAmountUSD)) {
+        const previousStep = findPreviousNonZeroStep(quote.includedSteps);
+        if (previousStep) {
+            toAmount = previousStep.estimate.toAmount;
+            toAmountMin = previousStep.estimate.toAmountMin;
+            toAmountUSD = formatTokenPrice(parseBigInt(toAmount), previousStep.action.toToken.priceUSD, previousStep.action.toToken.decimals).toFixed(2);
+            // Update the last included step's estimate with the adjusted values
+            const lastStep = quote.includedSteps[quote.includedSteps.length - 1];
+            if (lastStep && !hasNonZeroOutput(lastStep)) {
+                lastStep.estimate.toAmount = toAmount;
+                lastStep.estimate.toAmountMin = toAmountMin;
+            }
+        }
+    }
     if (!quote.estimate.fromAmountUSD) {
         throw new SDKError(new ValidationError("Missing 'fromAmountUSD' in step estimate."));
     }
-    if (!quote.estimate.toAmountUSD) {
+    if (!toAmountUSD) {
         throw new SDKError(new ValidationError("Missing 'toAmountUSD' in step estimate."));
     }
     const route = {
@@ -24,9 +93,9 @@ export const convertQuoteToRoute = (quote) => {
         fromAddress: quote.action.fromAddress,
         toChainId: quote.action.toToken.chainId,
         toToken: quote.action.toToken,
-        toAmount: quote.estimate.toAmount,
-        toAmountMin: quote.estimate.toAmountMin,
-        toAmountUSD: quote.estimate.toAmountUSD,
+        toAmount,
+        toAmountMin,
+        toAmountUSD,
         toAddress: quote.action.toAddress || quote.action.fromAddress,
         gasCostUSD: quote.estimate.gasCosts?.[0]?.amountUSD || '0',
         steps: [quote],

package/dist/esm/utils/convertQuoteToRoute.js.map

@@ -1 +1 @@
-{"version":3,"file":"convertQuoteToRoute.js","sourceRoot":"","sources":["../../../src/utils/convertQuoteToRoute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAe,EAAS,EAAE;IAC5D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAClC,MAAM,IAAI,QAAQ,CAChB,IAAI,eAAe,CAAC,2CAA2C,CAAC,CACjE,CAAA;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAChB,IAAI,eAAe,CAAC,yCAAyC,CAAC,CAC/D,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAU;QACnB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO;QAC3C,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;QACjC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;QACnC,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa;QAC3C,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;QACrC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO;QACvC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACjC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;QACvC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;QACvC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW;QAC7D,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,GAAG;QAC1D,KAAK,EAAE,CAAC,KAAK,CAAC;QACd,SAAS,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,EAAE;KACzD,CAAA;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}
+{"version":3,"file":"convertQuoteToRoute.js","sourceRoot":"","sources":["../../../src/utils/convertQuoteToRoute.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/formatUnits.d.ts

@@ -0,0 +1,4 @@
+/**
+ *  Divides a number by a given exponent of base 10 (10exponent), and formats it into a string representation of the number.
+ */
+export declare function formatUnits(value: bigint, decimals: number): string;

package/dist/esm/utils/formatUnits.js

@@ -0,0 +1,18 @@
+/**
+ *  Divides a number by a given exponent of base 10 (10exponent), and formats it into a string representation of the number.
+ */
+export function formatUnits(value, decimals) {
+    let display = value.toString();
+    const negative = display.startsWith('-');
+    if (negative) {
+        display = display.slice(1);
+    }
+    display = display.padStart(decimals, '0');
+    let [integer, fraction] = [
+        display.slice(0, display.length - decimals),
+        display.slice(display.length - decimals),
+    ];
+    fraction = fraction.replace(/(0+)$/, '');
+    return `${negative ? '-' : ''}${integer || '0'}${fraction ? `.${fraction}` : ''}`;
+}
+//# sourceMappingURL=formatUnits.js.map

package/dist/esm/utils/formatUnits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatUnits.js","sourceRoot":"","sources":["../../../src/utils/formatUnits.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAgB;IACzD,IAAI,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;IAE9B,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC5B,CAAC;IAED,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IAEzC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG;QACxB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;KACzC,CAAA;IACD,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACxC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,IAAI,GAAG,GAC5C,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAC9B,EAAE,CAAA;AACJ,CAAC"}

package/dist/esm/utils/isHex.d.ts

@@ -0,0 +1,4 @@
+export type Hex = `0x${string}`;
+export declare function isHex(value: unknown, { strict }?: {
+    strict?: boolean | undefined;
+}): value is Hex;

package/dist/esm/utils/isHex.js

@@ -0,0 +1,10 @@
+export function isHex(value, { strict = true } = {}) {
+    if (!value) {
+        return false;
+    }
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return strict ? /^0x[0-9a-fA-F]*$/.test(value) : value.startsWith('0x');
+}
+//# sourceMappingURL=isHex.js.map

package/dist/esm/utils/isHex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isHex.js","sourceRoot":"","sources":["../../../src/utils/isHex.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,KAAK,CACnB,KAAc,EACd,EAAE,MAAM,GAAG,IAAI,KAAuC,EAAE;IAExD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACzE,CAAC"}

package/dist/esm/utils/parseUnits.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Multiplies a string representation of a number by a given exponent of base 10 (10exponent).
+ */
+export declare function parseUnits(value: string, decimals: number): bigint;