@lifi/sdk 4.8.2 → 4.10.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @lifi/sdk
 
+## 4.10.0
+
+### Minor Changes
+
+- [#499](https://github.com/lifinance/sdk/pull/499) [`2d60ab4`](https://github.com/lifinance/sdk/commit/2d60ab43af2ecd1c17a3bbb126de408952a46d80) Thanks [@chybisov](https://github.com/chybisov)! - `sleep` takes an optional `{ signal }`. It rejects with the abort reason as soon as the signal aborts.
+
+### Patch Changes
+
+- [#496](https://github.com/lifinance/sdk/pull/496) [`dcbbdcc`](https://github.com/lifinance/sdk/commit/dcbbdccc2684c4549cbfe06444698f11347206af) Thanks [@chybisov](https://github.com/chybisov)! - Bump the `@lifi/types` pin to `^18.12.1`, which adds `slippageScope` and the route-wide
+  slippage commitment types.
+
+- [#499](https://github.com/lifinance/sdk/pull/499) [`2d60ab4`](https://github.com/lifinance/sdk/commit/2d60ab43af2ecd1c17a3bbb126de408952a46d80) Thanks [@chybisov](https://github.com/chybisov)! - Stop the balance check's retry loop once its 10 s timeout rejects, so a late balance read can no longer change `step.action.fromAmount`.
+
+- [#499](https://github.com/lifinance/sdk/pull/499) [`2d60ab4`](https://github.com/lifinance/sdk/commit/2d60ab43af2ecd1c17a3bbb126de408952a46d80) Thanks [@chybisov](https://github.com/chybisov)! - `LruMap` now evicts the least recently used entry instead of the oldest one, and no longer grows past its size on iOS 18.
+
+- [#499](https://github.com/lifinance/sdk/pull/499) [`2d60ab4`](https://github.com/lifinance/sdk/commit/2d60ab43af2ecd1c17a3bbb126de408952a46d80) Thanks [@chybisov](https://github.com/chybisov)! - `parseUnits` rounds long fractions exactly, and `parseUnits` and `formatUnits` throw on a negative or fractional `decimals` instead of giving a wrong amount. An input with no digit, such as `''`, still parses as `0n`.
+
+- [#499](https://github.com/lifinance/sdk/pull/499) [`2d60ab4`](https://github.com/lifinance/sdk/commit/2d60ab43af2ecd1c17a3bbb126de408952a46d80) Thanks [@chybisov](https://github.com/chybisov)! - `withTimeout` now rejects with its timeout error only when its own timeout fires. Any other `AbortError` from the wrapped function passes through, so a wallet `AbortError` in the Bitcoin and Solana signing steps is no longer reported as `TransactionExpired`.
+
+## 4.9.0
+
+### Minor Changes
+
+- [#493](https://github.com/lifinance/sdk/pull/493) [`145f2b4`](https://github.com/lifinance/sdk/commit/145f2b49dbbc55776e0b0fe34b0b890f3e5be199) Thanks [@chybisov](https://github.com/chybisov)! - The `rpcUrls` option of `createClient` can split a chain's RPCs by role: `{ read?: string[]; write?: string[]; bundle?: string[] }` next to the existing plain list. Reads use `read` (unset: the chain's own RPCs). `write` and `bundle` are dedicated send and bundle-submission RPCs; only `@lifi/sdk-provider-solana` uses them today, and other providers ignore them. `client.config.rpcUrls`, `getRpcUrls` and `getRpcUrlsByChainId` keep holding plain read lists; the new optional `client.getWriteRpcUrlsByChainId` and `client.getBundleRpcUrlsByChainId` return a chain's write and bundle lists, empty when it has none.
+  
+  Plain lists work as before. At the type level, `SDKConfig['rpcUrls']` is now `RPCUrlsConfig`, so code that reads it back from a config object must narrow each entry with `Array.isArray`.
+
+### Patch Changes
+
+- [#491](https://github.com/lifinance/sdk/pull/491) [`a65b003`](https://github.com/lifinance/sdk/commit/a65b00391698c3e8c2a1cd826bb0969c6977ecb6) Thanks [@chybisov](https://github.com/chybisov)! - A caller that aborts a deduplicated request no longer fails the other callers of that request. `getTokens` and `getChains` share an in-flight request between callers that ask the same query, and the shared request carried the first caller's signal, so when that caller aborted, every other caller got its `AbortError`. Now a caller that aborts leaves the shared request at once, and the request is aborted only when every caller has aborted. `withDedupe` takes an optional `signal` and passes its callback the signal to hand on to the request.
+
+- [#495](https://github.com/lifinance/sdk/pull/495) [`9e815bd`](https://github.com/lifinance/sdk/commit/9e815bdd0d818b7e0866c78bdf48065185b64210) Thanks [@chybisov](https://github.com/chybisov)! - `withDedupe` adds its own handler to a shared request only once a caller with a signal joins. A request shared only by callers without a signal is still reported as an unhandled rejection when it fails and no caller handles it, as it was before `signal` support.
+
 ## 4.8.2
 
 ### Patch Changes

package/dist/cjs/actions/getChains.js

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_SDKError = require("../errors/SDKError.js");
 const require_utils_request = require("../utils/request.js");
 const require_utils_withDedupe = require("../utils/withDedupe.js");
 //#region src/actions/getChains.ts
@@ -19,7 +20,12 @@ const _getChains = async (config, params, options) => {
 		if (value === void 0 || value === null) delete params[key];
 	}
 	const urlSearchParams = new URLSearchParams(params).toString();
-	return (await require_utils_withDedupe.withDedupe(() => require_utils_request.request(config, `${config.apiUrl}/chains?${urlSearchParams}`, { signal: options?.signal }), { id: `${getChains.name}.${config.apiUrl}.${urlSearchParams}` })).chains;
+	return (await require_utils_withDedupe.withDedupe((signal) => require_utils_request.request(config, `${config.apiUrl}/chains?${urlSearchParams}`, { signal }), {
+		id: `${getChains.name}.${config.apiUrl}.${urlSearchParams}`,
+		signal: options?.signal
+	}).catch((error) => {
+		throw error instanceof require_errors_SDKError.SDKError ? error : new require_errors_SDKError.SDKError(error);
+	})).chains;
 };
 //#endregion
 exports._getChains = _getChains;

package/dist/cjs/actions/getChains.js.map

@@ -1 +1 @@
-{"version":3,"file":"getChains.js","names":["withDedupe","request"],"sources":["../../../src/actions/getChains.ts"],"sourcesContent":["import type {\n  ChainsRequest,\n  ChainsResponse,\n  ExtendedChain,\n  RequestOptions,\n} from '@lifi/types'\nimport type { SDKBaseConfig, SDKClient } from '../types/core.js'\nimport { request } from '../utils/request.js'\nimport { withDedupe } from '../utils/withDedupe.js'\n\n/**\n * Get all available chains\n * @param client - The SDK client\n * @param params - The configuration of the requested chains\n * @param options - Request options\n * @returns A list of all available chains\n * @throws {LiFiError} Throws a LiFiError if request fails.\n */\nexport const getChains = async (\n  client: SDKClient,\n  params?: ChainsRequest,\n  options?: RequestOptions\n): Promise<ExtendedChain[]> => {\n  return await _getChains(client.config, params, options)\n}\n\nexport const _getChains = async (\n  config: SDKBaseConfig,\n  params?: ChainsRequest,\n  options?: RequestOptions\n): Promise<ExtendedChain[]> => {\n  if (params) {\n    for (const key of Object.keys(params)) {\n      const value = params[key as keyof ChainsRequest]\n      if (value === undefined || value === null) {\n        delete params[key as keyof ChainsRequest]\n      }\n    }\n  }\n  const urlSearchParams = new URLSearchParams(\n    params as Record<string, string>\n  ).toString()\n  const response = await withDedupe(\n    () =>\n      request<ChainsResponse>(\n        config,\n        `${config.apiUrl}/chains?${urlSearchParams}`,\n        {\n          signal: options?.signal,\n        }\n      ),\n    { id: `${getChains.name}.${config.apiUrl}.${urlSearchParams}` }\n  )\n  return response.chains\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,MAAa,YAAY,OACvB,QACA,QACA,YAC6B;CAC7B,OAAO,MAAM,WAAW,OAAO,QAAQ,QAAQ,OAAO;AACxD;AAEA,MAAa,aAAa,OACxB,QACA,QACA,YAC6B;CAC7B,IAAI,QACF,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;EACrC,MAAM,QAAQ,OAAO;EACrB,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO,OAAO;CAElB;CAEF,MAAM,kBAAkB,IAAI,gBAC1B,MACF,CAAC,CAAC,SAAS;CAYX,QAAO,MAXgBA,yBAAAA,iBAEnBC,sBAAAA,QACE,QACA,GAAG,OAAO,OAAO,UAAU,mBAC3B,EACE,QAAQ,SAAS,OACnB,CACF,GACF,EAAE,IAAI,GAAG,UAAU,KAAK,GAAG,OAAO,OAAO,GAAG,kBAAkB,CAChE,EAAA,CACgB;AAClB"}
+{"version":3,"file":"getChains.js","names":["withDedupe","request","SDKError"],"sources":["../../../src/actions/getChains.ts"],"sourcesContent":["import type {\n  ChainsRequest,\n  ChainsResponse,\n  ExtendedChain,\n  RequestOptions,\n} from '@lifi/types'\nimport { SDKError } from '../errors/SDKError.js'\nimport type { SDKBaseConfig, SDKClient } from '../types/core.js'\nimport { request } from '../utils/request.js'\nimport { withDedupe } from '../utils/withDedupe.js'\n\n/**\n * Get all available chains\n * @param client - The SDK client\n * @param params - The configuration of the requested chains\n * @param options - Request options\n * @returns A list of all available chains\n * @throws {LiFiError} Throws a LiFiError if request fails.\n */\nexport const getChains = async (\n  client: SDKClient,\n  params?: ChainsRequest,\n  options?: RequestOptions\n): Promise<ExtendedChain[]> => {\n  return await _getChains(client.config, params, options)\n}\n\nexport const _getChains = async (\n  config: SDKBaseConfig,\n  params?: ChainsRequest,\n  options?: RequestOptions\n): Promise<ExtendedChain[]> => {\n  if (params) {\n    for (const key of Object.keys(params)) {\n      const value = params[key as keyof ChainsRequest]\n      if (value === undefined || value === null) {\n        delete params[key as keyof ChainsRequest]\n      }\n    }\n  }\n  const urlSearchParams = new URLSearchParams(\n    params as Record<string, string>\n  ).toString()\n  const response = await withDedupe(\n    (signal) =>\n      request<ChainsResponse>(\n        config,\n        `${config.apiUrl}/chains?${urlSearchParams}`,\n        {\n          signal,\n        }\n      ),\n    {\n      id: `${getChains.name}.${config.apiUrl}.${urlSearchParams}`,\n      signal: options?.signal,\n    }\n  ).catch((error) => {\n    // A caller that aborts leaves before the request settles; keep its error\n    // shaped like one from `request`.\n    throw error instanceof SDKError ? error : new SDKError(error)\n  })\n  return response.chains\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,MAAa,YAAY,OACvB,QACA,QACA,YAC6B;CAC7B,OAAO,MAAM,WAAW,OAAO,QAAQ,QAAQ,OAAO;AACxD;AAEA,MAAa,aAAa,OACxB,QACA,QACA,YAC6B;CAC7B,IAAI,QACF,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;EACrC,MAAM,QAAQ,OAAO;EACrB,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO,OAAO;CAElB;CAEF,MAAM,kBAAkB,IAAI,gBAC1B,MACF,CAAC,CAAC,SAAS;CAmBX,QAAO,MAlBgBA,yBAAAA,YACpB,WACCC,sBAAAA,QACE,QACA,GAAG,OAAO,OAAO,UAAU,mBAC3B,EACE,OACF,CACF,GACF;EACE,IAAI,GAAG,UAAU,KAAK,GAAG,OAAO,OAAO,GAAG;EAC1C,QAAQ,SAAS;CACnB,CACF,CAAC,CAAC,OAAO,UAAU;EAGjB,MAAM,iBAAiBC,wBAAAA,WAAW,QAAQ,IAAIA,wBAAAA,SAAS,KAAK;CAC9D,CAAC,EAAA,CACe;AAClB"}

package/dist/cjs/actions/getContractCallsQuote.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors_errors = require("../errors/errors.js");
 const require_errors_SDKError = require("../errors/SDKError.js");
+const require_errors_errors = require("../errors/errors.js");
 const require_utils_request = require("../utils/request.js");
 let _lifi_types = require("@lifi/types");
 //#region src/actions/getContractCallsQuote.ts

package/dist/cjs/actions/getGasRecommendation.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors_errors = require("../errors/errors.js");
 const require_errors_SDKError = require("../errors/SDKError.js");
+const require_errors_errors = require("../errors/errors.js");
 const require_utils_request = require("../utils/request.js");
 //#region src/actions/getGasRecommendation.ts
 /**

package/dist/cjs/actions/getQuote.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors_errors = require("../errors/errors.js");
 const require_errors_SDKError = require("../errors/SDKError.js");
+const require_errors_errors = require("../errors/errors.js");
 const require_utils_request = require("../utils/request.js");
 const require_utils_toQueryString = require("../utils/toQueryString.js");
 //#region src/actions/getQuote.ts

package/dist/cjs/actions/getRelayedTransactionStatus.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_SDKError = require("../errors/SDKError.js");
 const require_errors_baseError = require("../errors/baseError.js");
 require("../errors/constants.js");
 const require_errors_errors = require("../errors/errors.js");
-const require_errors_SDKError = require("../errors/SDKError.js");
 const require_utils_request = require("../utils/request.js");
 const require_utils_decode = require("../utils/decode.js");
 const require_actions_getStatus = require("./getStatus.js");

package/dist/cjs/actions/getRelayerQuote.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_SDKError = require("../errors/SDKError.js");
 const require_errors_baseError = require("../errors/baseError.js");
 require("../errors/constants.js");
 const require_errors_errors = require("../errors/errors.js");
-const require_errors_SDKError = require("../errors/SDKError.js");
 const require_utils_request = require("../utils/request.js");
 //#region src/actions/getRelayerQuote.ts
 /**

package/dist/cjs/actions/getRoutes.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors_errors = require("../errors/errors.js");
 const require_errors_SDKError = require("../errors/SDKError.js");
+const require_errors_errors = require("../errors/errors.js");
 const require_utils_request = require("../utils/request.js");
 const require_utils_isRoutesRequest = require("../utils/isRoutesRequest.js");
 //#region src/actions/getRoutes.ts

package/dist/cjs/actions/getStatus.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors_errors = require("../errors/errors.js");
 const require_errors_SDKError = require("../errors/SDKError.js");
+const require_errors_errors = require("../errors/errors.js");
 const require_utils_request = require("../utils/request.js");
 //#region src/actions/getStatus.ts
 /**

package/dist/cjs/actions/getToken.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors_errors = require("../errors/errors.js");
 const require_errors_SDKError = require("../errors/SDKError.js");
+const require_errors_errors = require("../errors/errors.js");
 const require_utils_request = require("../utils/request.js");
 //#region src/actions/getToken.ts
 /**

package/dist/cjs/actions/getTokens.js

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_SDKError = require("../errors/SDKError.js");
 const require_utils_request = require("../utils/request.js");
 const require_utils_withDedupe = require("../utils/withDedupe.js");
 //#region src/actions/getTokens.ts
@@ -9,7 +10,12 @@ async function getTokens(client, params, options) {
 	}
 	const urlSearchParams = new URLSearchParams(params).toString();
 	params?.extended;
-	return await require_utils_withDedupe.withDedupe(() => require_utils_request.request(client.config, `${client.config.apiUrl}/tokens?${urlSearchParams}`, { signal: options?.signal }), { id: `${getTokens.name}.${client.config.apiUrl}.${urlSearchParams}` });
+	return await require_utils_withDedupe.withDedupe((signal) => require_utils_request.request(client.config, `${client.config.apiUrl}/tokens?${urlSearchParams}`, { signal }), {
+		id: `${getTokens.name}.${client.config.apiUrl}.${urlSearchParams}`,
+		signal: options?.signal
+	}).catch((error) => {
+		throw error instanceof require_errors_SDKError.SDKError ? error : new require_errors_SDKError.SDKError(error);
+	});
 }
 //#endregion
 exports.getTokens = getTokens;

package/dist/cjs/actions/getTokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTokens.js","names":["withDedupe","request"],"sources":["../../../src/actions/getTokens.ts"],"sourcesContent":["import type {\n  RequestOptions,\n  TokensExtendedResponse,\n  TokensRequest,\n  TokensResponse,\n} from '@lifi/types'\nimport type { SDKClient } from '../types/core.js'\nimport { request } from '../utils/request.js'\nimport { withDedupe } from '../utils/withDedupe.js'\n\n/**\n * Get all known tokens.\n * @param client - The SDK client\n * @param params - The configuration of the requested tokens\n * @param options - Request options\n * @returns The tokens that are available on the requested chains\n */\nexport async function getTokens(\n  client: SDKClient,\n  params?: TokensRequest & { extended?: false | undefined },\n  options?: RequestOptions\n): Promise<TokensResponse>\nexport async function getTokens(\n  client: SDKClient,\n  params: TokensRequest & { extended: true },\n  options?: RequestOptions\n): Promise<TokensExtendedResponse>\nexport async function getTokens(\n  client: SDKClient,\n  params?: TokensRequest,\n  options?: RequestOptions\n): Promise<TokensResponse> {\n  if (params) {\n    for (const key of Object.keys(params)) {\n      const value = params[key as keyof TokensRequest]\n      if (value === undefined || value === null) {\n        delete params[key as keyof TokensRequest]\n      }\n    }\n  }\n  const urlSearchParams = new URLSearchParams(\n    params as Record<string, string>\n  ).toString()\n  const _isExtended = params?.extended === true\n  const response = await withDedupe(\n    () =>\n      request<\n        typeof _isExtended extends true\n          ? TokensExtendedResponse\n          : TokensResponse\n      >(client.config, `${client.config.apiUrl}/tokens?${urlSearchParams}`, {\n        signal: options?.signal,\n      }),\n    { id: `${getTokens.name}.${client.config.apiUrl}.${urlSearchParams}` }\n  )\n  return response\n}\n"],"mappings":";;;;AA2BA,eAAsB,UACpB,QACA,QACA,SACyB;CACzB,IAAI,QACF,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;EACrC,MAAM,QAAQ,OAAO;EACrB,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO,OAAO;CAElB;CAEF,MAAM,kBAAkB,IAAI,gBAC1B,MACF,CAAC,CAAC,SAAS;CACS,QAAQ;CAY5B,OAAO,MAXgBA,yBAAAA,iBAEnBC,sBAAAA,QAIE,OAAO,QAAQ,GAAG,OAAO,OAAO,OAAO,UAAU,mBAAmB,EACpE,QAAQ,SAAS,OACnB,CAAC,GACH,EAAE,IAAI,GAAG,UAAU,KAAK,GAAG,OAAO,OAAO,OAAO,GAAG,kBAAkB,CACvE;AAEF"}
+{"version":3,"file":"getTokens.js","names":["withDedupe","request","SDKError"],"sources":["../../../src/actions/getTokens.ts"],"sourcesContent":["import type {\n  RequestOptions,\n  TokensExtendedResponse,\n  TokensRequest,\n  TokensResponse,\n} from '@lifi/types'\nimport { SDKError } from '../errors/SDKError.js'\nimport type { SDKClient } from '../types/core.js'\nimport { request } from '../utils/request.js'\nimport { withDedupe } from '../utils/withDedupe.js'\n\n/**\n * Get all known tokens.\n * @param client - The SDK client\n * @param params - The configuration of the requested tokens\n * @param options - Request options\n * @returns The tokens that are available on the requested chains\n */\nexport async function getTokens(\n  client: SDKClient,\n  params?: TokensRequest & { extended?: false | undefined },\n  options?: RequestOptions\n): Promise<TokensResponse>\nexport async function getTokens(\n  client: SDKClient,\n  params: TokensRequest & { extended: true },\n  options?: RequestOptions\n): Promise<TokensExtendedResponse>\nexport async function getTokens(\n  client: SDKClient,\n  params?: TokensRequest,\n  options?: RequestOptions\n): Promise<TokensResponse> {\n  if (params) {\n    for (const key of Object.keys(params)) {\n      const value = params[key as keyof TokensRequest]\n      if (value === undefined || value === null) {\n        delete params[key as keyof TokensRequest]\n      }\n    }\n  }\n  const urlSearchParams = new URLSearchParams(\n    params as Record<string, string>\n  ).toString()\n  const _isExtended = params?.extended === true\n  const response = await withDedupe(\n    (signal) =>\n      request<\n        typeof _isExtended extends true\n          ? TokensExtendedResponse\n          : TokensResponse\n      >(client.config, `${client.config.apiUrl}/tokens?${urlSearchParams}`, {\n        signal,\n      }),\n    {\n      id: `${getTokens.name}.${client.config.apiUrl}.${urlSearchParams}`,\n      signal: options?.signal,\n    }\n  ).catch((error) => {\n    // A caller that aborts leaves before the request settles; keep its error\n    // shaped like one from `request`.\n    throw error instanceof SDKError ? error : new SDKError(error)\n  })\n  return response\n}\n"],"mappings":";;;;;AA4BA,eAAsB,UACpB,QACA,QACA,SACyB;CACzB,IAAI,QACF,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;EACrC,MAAM,QAAQ,OAAO;EACrB,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO,OAAO;CAElB;CAEF,MAAM,kBAAkB,IAAI,gBAC1B,MACF,CAAC,CAAC,SAAS;CACS,QAAQ;CAmB5B,OAAO,MAlBgBA,yBAAAA,YACpB,WACCC,sBAAAA,QAIE,OAAO,QAAQ,GAAG,OAAO,OAAO,OAAO,UAAU,mBAAmB,EACpE,OACF,CAAC,GACH;EACE,IAAI,GAAG,UAAU,KAAK,GAAG,OAAO,OAAO,OAAO,GAAG;EACjD,QAAQ,SAAS;CACnB,CACF,CAAC,CAAC,OAAO,UAAU;EAGjB,MAAM,iBAAiBC,wBAAAA,WAAW,QAAQ,IAAIA,wBAAAA,SAAS,KAAK;CAC9D,CAAC;AAEH"}

package/dist/cjs/actions/relayTransaction.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors_SDKError = require("../errors/SDKError.js");
 const require_errors_baseError = require("../errors/baseError.js");
 require("../errors/constants.js");
 const require_errors_errors = require("../errors/errors.js");
-const require_errors_SDKError = require("../errors/SDKError.js");
 const require_utils_request = require("../utils/request.js");
 //#region src/actions/relayTransaction.ts
 /**

package/dist/cjs/client/createClient.js

@@ -6,11 +6,26 @@ const require_client_getClientStorage = require("./getClientStorage.js");
 function createClient(options) {
 	if (!options.integrator) throw new Error("Integrator not found. Please see documentation https://docs.li.fi/integrate-li.fi-js-sdk/set-up-the-sdk");
 	if (!options.disableVersionCheck && process.env.NODE_ENV === "development") require_utils_checkPackageUpdates.checkPackageUpdates(require_version.name, require_version.version);
-	const { providers, ...configOptions } = options;
+	const { providers, rpcUrls, ...configOptions } = options;
+	const readRpcUrls = {};
+	const writeRpcUrls = {};
+	const bundleRpcUrls = {};
+	let hasRoles = false;
+	for (const key in rpcUrls) {
+		const chainId = Number(key);
+		const entry = rpcUrls[chainId];
+		if (Array.isArray(entry)) readRpcUrls[chainId] = entry;
+		else if (entry) {
+			hasRoles = true;
+			if (entry.read) readRpcUrls[chainId] = entry.read;
+			if (entry.write?.length) writeRpcUrls[chainId] = entry.write;
+			if (entry.bundle?.length) bundleRpcUrls[chainId] = entry.bundle;
+		}
+	}
 	const _config = {
 		...configOptions,
 		apiUrl: configOptions?.apiUrl ?? "https://li.quest/v1",
-		rpcUrls: configOptions?.rpcUrls ?? {},
+		rpcUrls: hasRoles ? readRpcUrls : rpcUrls ?? {},
 		debug: configOptions?.debug ?? false,
 		preloadChains: configOptions?.preloadChains ?? true,
 		integrator: configOptions?.integrator ?? "lifi-sdk"
@@ -50,6 +65,12 @@ function createClient(options) {
 			const chainRpcUrls = (await this.getRpcUrls())[chainId];
 			if (!chainRpcUrls?.length) throw new Error(`RPC URL not found for chainId: ${chainId}`);
 			return chainRpcUrls;
+		},
+		async getWriteRpcUrlsByChainId(chainId) {
+			return writeRpcUrls[chainId] ?? [];
+		},
+		async getBundleRpcUrlsByChainId(chainId) {
+			return bundleRpcUrls[chainId] ?? [];
 		}
 	};
 	function extend(base) {

package/dist/cjs/client/createClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"createClient.js","names":["name","version","getClientStorage"],"sources":["../../../src/client/createClient.ts"],"sourcesContent":["import type { ChainId, ChainType, ExtendedChain } from '@lifi/types'\nimport type {\n  SDKBaseConfig,\n  SDKClient,\n  SDKConfig,\n  SDKProvider,\n} from '../types/core.js'\nimport { checkPackageUpdates } from '../utils/checkPackageUpdates.js'\nimport { name, version } from '../version.js'\nimport { getClientStorage } from './getClientStorage.js'\n\nexport function createClient(options: SDKConfig): SDKClient {\n  if (!options.integrator) {\n    throw new Error(\n      'Integrator not found. Please see documentation https://docs.li.fi/integrate-li.fi-js-sdk/set-up-the-sdk'\n    )\n  }\n\n  if (!options.disableVersionCheck && process.env.NODE_ENV === 'development') {\n    checkPackageUpdates(name, version)\n  }\n\n  const { providers, ...configOptions } = options\n\n  const _config: SDKBaseConfig = {\n    ...configOptions,\n    apiUrl: configOptions?.apiUrl ?? 'https://li.quest/v1',\n    rpcUrls: configOptions?.rpcUrls ?? {},\n    debug: configOptions?.debug ?? false,\n    preloadChains: configOptions?.preloadChains ?? true,\n    integrator: configOptions?.integrator ?? 'lifi-sdk',\n  }\n\n  let _providers: SDKProvider[] = providers ?? []\n  const _storage = getClientStorage(_config)\n\n  const client: SDKClient = {\n    get config() {\n      return _config\n    },\n    get providers() {\n      return _providers\n    },\n    getProvider(type: ChainType) {\n      return this.providers.find((provider) => provider.type === type)\n    },\n    setProviders(newProviders: SDKProvider[]) {\n      const providerMap = new Map(\n        this.providers.map((provider) => [provider.type, provider])\n      )\n      for (const provider of newProviders) {\n        providerMap.set(provider.type, provider)\n      }\n      _providers = Array.from(providerMap.values())\n    },\n    setChains(chains: ExtendedChain[]) {\n      _storage.setChains(chains)\n    },\n    async getChains() {\n      return await _storage.getChains()\n    },\n    async getChainById(chainId: ChainId) {\n      const chains = await this.getChains()\n      const chain = chains?.find((chain) => chain.id === chainId)\n      if (!chain) {\n        throw new Error(`ChainId ${chainId} not found`)\n      }\n      return chain\n    },\n    async getRpcUrls() {\n      return await _storage.getRpcUrls()\n    },\n    async getRpcUrlsByChainId(chainId: ChainId) {\n      const rpcUrls = await this.getRpcUrls()\n      const chainRpcUrls = rpcUrls[chainId]\n      if (!chainRpcUrls?.length) {\n        throw new Error(`RPC URL not found for chainId: ${chainId}`)\n      }\n      return chainRpcUrls\n    },\n  }\n\n  function extend<TClient extends SDKClient>(\n    base: TClient\n  ): <TExtensions extends Record<string, any>>(\n    extendFn: (client: TClient) => TExtensions\n  ) => TClient & TExtensions {\n    return (extendFn) => {\n      const extensions = extendFn(base)\n      // Copy descriptors rather than spreading. `config` and `providers` are\n      // accessors over closure variables, and `setProviders` reassigns\n      // `_providers` — so a spread would freeze the extension on the values\n      // those getters happened to return at extend time, leaving it with a\n      // provider list that never updates.\n      const extended = Object.defineProperties(\n        {},\n        {\n          ...Object.getOwnPropertyDescriptors(base),\n          ...Object.getOwnPropertyDescriptors(extensions),\n        }\n      ) as TClient & typeof extensions\n\n      // Preserve the extend function for further extensions\n      return Object.assign(extended, {\n        extend: extend(extended),\n      })\n    }\n  }\n\n  return Object.assign(client, { extend: extend(client) })\n}\n"],"mappings":";;;;;AAWA,SAAgB,aAAa,SAA+B;CAC1D,IAAI,CAAC,QAAQ,YACX,MAAM,IAAI,MACR,yGACF;CAGF,IAAI,CAAC,QAAQ,uBAAuB,QAAQ,IAAI,aAAa,eAC3D,kCAAA,oBAAoBA,gBAAAA,MAAMC,gBAAAA,OAAO;CAGnC,MAAM,EAAE,WAAW,GAAG,kBAAkB;CAExC,MAAM,UAAyB;EAC7B,GAAG;EACH,QAAQ,eAAe,UAAU;EACjC,SAAS,eAAe,WAAW,CAAC;EACpC,OAAO,eAAe,SAAS;EAC/B,eAAe,eAAe,iBAAiB;EAC/C,YAAY,eAAe,cAAc;CAC3C;CAEA,IAAI,aAA4B,aAAa,CAAC;CAC9C,MAAM,WAAWC,gCAAAA,iBAAiB,OAAO;CAEzC,MAAM,SAAoB;EACxB,IAAI,SAAS;GACX,OAAO;EACT;EACA,IAAI,YAAY;GACd,OAAO;EACT;EACA,YAAY,MAAiB;GAC3B,OAAO,KAAK,UAAU,MAAM,aAAa,SAAS,SAAS,IAAI;EACjE;EACA,aAAa,cAA6B;GACxC,MAAM,cAAc,IAAI,IACtB,KAAK,UAAU,KAAK,aAAa,CAAC,SAAS,MAAM,QAAQ,CAAC,CAC5D;GACA,KAAK,MAAM,YAAY,cACrB,YAAY,IAAI,SAAS,MAAM,QAAQ;GAEzC,aAAa,MAAM,KAAK,YAAY,OAAO,CAAC;EAC9C;EACA,UAAU,QAAyB;GACjC,SAAS,UAAU,MAAM;EAC3B;EACA,MAAM,YAAY;GAChB,OAAO,MAAM,SAAS,UAAU;EAClC;EACA,MAAM,aAAa,SAAkB;GAEnC,MAAM,SAAQ,MADO,KAAK,UAAU,EAAA,EACd,MAAM,UAAU,MAAM,OAAO,OAAO;GAC1D,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,WAAW,QAAQ,WAAW;GAEhD,OAAO;EACT;EACA,MAAM,aAAa;GACjB,OAAO,MAAM,SAAS,WAAW;EACnC;EACA,MAAM,oBAAoB,SAAkB;GAE1C,MAAM,gBAAe,MADC,KAAK,WAAW,EAAA,CACT;GAC7B,IAAI,CAAC,cAAc,QACjB,MAAM,IAAI,MAAM,kCAAkC,SAAS;GAE7D,OAAO;EACT;CACF;CAEA,SAAS,OACP,MAGyB;EACzB,QAAQ,aAAa;GACnB,MAAM,aAAa,SAAS,IAAI;GAMhC,MAAM,WAAW,OAAO,iBACtB,CAAC,GACD;IACE,GAAG,OAAO,0BAA0B,IAAI;IACxC,GAAG,OAAO,0BAA0B,UAAU;GAChD,CACF;GAGA,OAAO,OAAO,OAAO,UAAU,EAC7B,QAAQ,OAAO,QAAQ,EACzB,CAAC;EACH;CACF;CAEA,OAAO,OAAO,OAAO,QAAQ,EAAE,QAAQ,OAAO,MAAM,EAAE,CAAC;AACzD"}
+{"version":3,"file":"createClient.js","names":["name","version","getClientStorage"],"sources":["../../../src/client/createClient.ts"],"sourcesContent":["import type { ChainId, ChainType, ExtendedChain } from '@lifi/types'\nimport type {\n  RPCUrls,\n  SDKBaseConfig,\n  SDKClient,\n  SDKConfig,\n  SDKProvider,\n} from '../types/core.js'\nimport { checkPackageUpdates } from '../utils/checkPackageUpdates.js'\nimport { name, version } from '../version.js'\nimport { getClientStorage } from './getClientStorage.js'\n\nexport function createClient(options: SDKConfig): SDKClient {\n  if (!options.integrator) {\n    throw new Error(\n      'Integrator not found. Please see documentation https://docs.li.fi/integrate-li.fi-js-sdk/set-up-the-sdk'\n    )\n  }\n\n  if (!options.disableVersionCheck && process.env.NODE_ENV === 'development') {\n    checkPackageUpdates(name, version)\n  }\n\n  const { providers, rpcUrls, ...configOptions } = options\n\n  // Role entries split once, here: the config keeps plain read lists, so\n  // everything that reads `config.rpcUrls` sees `string[]` as before.\n  const readRpcUrls: RPCUrls = {}\n  const writeRpcUrls: RPCUrls = {}\n  const bundleRpcUrls: RPCUrls = {}\n  let hasRoles = false\n  for (const key in rpcUrls) {\n    const chainId = Number(key) as ChainId\n    const entry = rpcUrls[chainId]\n    if (Array.isArray(entry)) {\n      readRpcUrls[chainId] = entry\n    } else if (entry) {\n      hasRoles = true\n      if (entry.read) {\n        readRpcUrls[chainId] = entry.read\n      }\n      if (entry.write?.length) {\n        writeRpcUrls[chainId] = entry.write\n      }\n      if (entry.bundle?.length) {\n        bundleRpcUrls[chainId] = entry.bundle\n      }\n    }\n  }\n\n  const _config: SDKBaseConfig = {\n    ...configOptions,\n    apiUrl: configOptions?.apiUrl ?? 'https://li.quest/v1',\n    // Plain lists only: the caller's own object, exactly as before.\n    rpcUrls: hasRoles ? readRpcUrls : ((rpcUrls ?? {}) as RPCUrls),\n    debug: configOptions?.debug ?? false,\n    preloadChains: configOptions?.preloadChains ?? true,\n    integrator: configOptions?.integrator ?? 'lifi-sdk',\n  }\n\n  let _providers: SDKProvider[] = providers ?? []\n  const _storage = getClientStorage(_config)\n\n  const client: SDKClient = {\n    get config() {\n      return _config\n    },\n    get providers() {\n      return _providers\n    },\n    getProvider(type: ChainType) {\n      return this.providers.find((provider) => provider.type === type)\n    },\n    setProviders(newProviders: SDKProvider[]) {\n      const providerMap = new Map(\n        this.providers.map((provider) => [provider.type, provider])\n      )\n      for (const provider of newProviders) {\n        providerMap.set(provider.type, provider)\n      }\n      _providers = Array.from(providerMap.values())\n    },\n    setChains(chains: ExtendedChain[]) {\n      _storage.setChains(chains)\n    },\n    async getChains() {\n      return await _storage.getChains()\n    },\n    async getChainById(chainId: ChainId) {\n      const chains = await this.getChains()\n      const chain = chains?.find((chain) => chain.id === chainId)\n      if (!chain) {\n        throw new Error(`ChainId ${chainId} not found`)\n      }\n      return chain\n    },\n    async getRpcUrls() {\n      return await _storage.getRpcUrls()\n    },\n    async getRpcUrlsByChainId(chainId: ChainId) {\n      const rpcUrls = await this.getRpcUrls()\n      const chainRpcUrls = rpcUrls[chainId]\n      if (!chainRpcUrls?.length) {\n        throw new Error(`RPC URL not found for chainId: ${chainId}`)\n      }\n      return chainRpcUrls\n    },\n    async getWriteRpcUrlsByChainId(chainId: ChainId) {\n      return writeRpcUrls[chainId] ?? []\n    },\n    async getBundleRpcUrlsByChainId(chainId: ChainId) {\n      return bundleRpcUrls[chainId] ?? []\n    },\n  }\n\n  function extend<TClient extends SDKClient>(\n    base: TClient\n  ): <TExtensions extends Record<string, any>>(\n    extendFn: (client: TClient) => TExtensions\n  ) => TClient & TExtensions {\n    return (extendFn) => {\n      const extensions = extendFn(base)\n      // Copy descriptors rather than spreading. `config` and `providers` are\n      // accessors over closure variables, and `setProviders` reassigns\n      // `_providers` — so a spread would freeze the extension on the values\n      // those getters happened to return at extend time, leaving it with a\n      // provider list that never updates.\n      const extended = Object.defineProperties(\n        {},\n        {\n          ...Object.getOwnPropertyDescriptors(base),\n          ...Object.getOwnPropertyDescriptors(extensions),\n        }\n      ) as TClient & typeof extensions\n\n      // Preserve the extend function for further extensions\n      return Object.assign(extended, {\n        extend: extend(extended),\n      })\n    }\n  }\n\n  return Object.assign(client, { extend: extend(client) })\n}\n"],"mappings":";;;;;AAYA,SAAgB,aAAa,SAA+B;CAC1D,IAAI,CAAC,QAAQ,YACX,MAAM,IAAI,MACR,yGACF;CAGF,IAAI,CAAC,QAAQ,uBAAuB,QAAQ,IAAI,aAAa,eAC3D,kCAAA,oBAAoBA,gBAAAA,MAAMC,gBAAAA,OAAO;CAGnC,MAAM,EAAE,WAAW,SAAS,GAAG,kBAAkB;CAIjD,MAAM,cAAuB,CAAC;CAC9B,MAAM,eAAwB,CAAC;CAC/B,MAAM,gBAAyB,CAAC;CAChC,IAAI,WAAW;CACf,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,UAAU,OAAO,GAAG;EAC1B,MAAM,QAAQ,QAAQ;EACtB,IAAI,MAAM,QAAQ,KAAK,GACrB,YAAY,WAAW;OAClB,IAAI,OAAO;GAChB,WAAW;GACX,IAAI,MAAM,MACR,YAAY,WAAW,MAAM;GAE/B,IAAI,MAAM,OAAO,QACf,aAAa,WAAW,MAAM;GAEhC,IAAI,MAAM,QAAQ,QAChB,cAAc,WAAW,MAAM;EAEnC;CACF;CAEA,MAAM,UAAyB;EAC7B,GAAG;EACH,QAAQ,eAAe,UAAU;EAEjC,SAAS,WAAW,cAAgB,WAAW,CAAC;EAChD,OAAO,eAAe,SAAS;EAC/B,eAAe,eAAe,iBAAiB;EAC/C,YAAY,eAAe,cAAc;CAC3C;CAEA,IAAI,aAA4B,aAAa,CAAC;CAC9C,MAAM,WAAWC,gCAAAA,iBAAiB,OAAO;CAEzC,MAAM,SAAoB;EACxB,IAAI,SAAS;GACX,OAAO;EACT;EACA,IAAI,YAAY;GACd,OAAO;EACT;EACA,YAAY,MAAiB;GAC3B,OAAO,KAAK,UAAU,MAAM,aAAa,SAAS,SAAS,IAAI;EACjE;EACA,aAAa,cAA6B;GACxC,MAAM,cAAc,IAAI,IACtB,KAAK,UAAU,KAAK,aAAa,CAAC,SAAS,MAAM,QAAQ,CAAC,CAC5D;GACA,KAAK,MAAM,YAAY,cACrB,YAAY,IAAI,SAAS,MAAM,QAAQ;GAEzC,aAAa,MAAM,KAAK,YAAY,OAAO,CAAC;EAC9C;EACA,UAAU,QAAyB;GACjC,SAAS,UAAU,MAAM;EAC3B;EACA,MAAM,YAAY;GAChB,OAAO,MAAM,SAAS,UAAU;EAClC;EACA,MAAM,aAAa,SAAkB;GAEnC,MAAM,SAAQ,MADO,KAAK,UAAU,EAAA,EACd,MAAM,UAAU,MAAM,OAAO,OAAO;GAC1D,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,WAAW,QAAQ,WAAW;GAEhD,OAAO;EACT;EACA,MAAM,aAAa;GACjB,OAAO,MAAM,SAAS,WAAW;EACnC;EACA,MAAM,oBAAoB,SAAkB;GAE1C,MAAM,gBAAe,MADC,KAAK,WAAW,EAAA,CACT;GAC7B,IAAI,CAAC,cAAc,QACjB,MAAM,IAAI,MAAM,kCAAkC,SAAS;GAE7D,OAAO;EACT;EACA,MAAM,yBAAyB,SAAkB;GAC/C,OAAO,aAAa,YAAY,CAAC;EACnC;EACA,MAAM,0BAA0B,SAAkB;GAChD,OAAO,cAAc,YAAY,CAAC;EACpC;CACF;CAEA,SAAS,OACP,MAGyB;EACzB,QAAQ,aAAa;GACnB,MAAM,aAAa,SAAS,IAAI;GAMhC,MAAM,WAAW,OAAO,iBACtB,CAAC,GACD;IACE,GAAG,OAAO,0BAA0B,IAAI;IACxC,GAAG,OAAO,0BAA0B,UAAU;GAChD,CACF;GAGA,OAAO,OAAO,OAAO,UAAU,EAC7B,QAAQ,OAAO,QAAQ,EACzB,CAAC;EACH;CACF;CAEA,OAAO,OAAO,OAAO,QAAQ,EAAE,QAAQ,OAAO,MAAM,EAAE,CAAC;AACzD"}

package/dist/cjs/core/tasks/helpers/checkBalance.js

@@ -52,6 +52,8 @@ const checkBalance = async (client, walletAddress, step, options = {}) => {
 	const tokens = reqs.map((r) => r.token);
 	const slippage = step.action.slippage ?? 0;
 	const slippageScaled = BigInt(Math.floor((1 - slippage) * Number(SLIPPAGE_PRECISION)));
+	const controller = new AbortController();
+	const { signal } = controller;
 	await require_utils_withTimeout.withTimeout(async () => {
 		for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
 			const isFinal = attempt === 5;
@@ -60,9 +62,10 @@ const checkBalance = async (client, walletAddress, step, options = {}) => {
 				balances = await provider.getBalance(client, walletAddress, tokens);
 			} catch (error) {
 				if (isFinal) throw new require_errors_errors.BalanceError("Could not read wallet balance.", error);
-				await require_utils_sleep.sleep(BACKOFF_BASE_MS * 2 ** attempt);
+				await require_utils_sleep.sleep(BACKOFF_BASE_MS * 2 ** attempt, { signal });
 				continue;
 			}
+			if (signal.aborted) return;
 			const balanceByAddress = new Map(balances.map((b) => [b.address.toLowerCase(), b.amount]));
 			const unknown = [];
 			const insufficient = [];
@@ -95,12 +98,12 @@ const checkBalance = async (client, walletAddress, step, options = {}) => {
 				});
 				throw new require_errors_errors.BalanceError("The balance is too low.", /* @__PURE__ */ new Error(`${lines.join(" ")} No funds have been sent.`));
 			}
-			await require_utils_sleep.sleep(BACKOFF_BASE_MS * 2 ** attempt);
+			await require_utils_sleep.sleep(BACKOFF_BASE_MS * 2 ** attempt, { signal });
 		}
 	}, {
 		timeout: OVERALL_TIMEOUT_MS,
 		errorInstance: new require_errors_errors.BalanceError("Could not read wallet balance.")
-	});
+	}).finally(() => controller.abort());
 };
 //#endregion
 exports.checkBalance = checkBalance;

package/dist/cjs/core/tasks/helpers/checkBalance.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkBalance.js","names":["withTimeout","BalanceError","sleep","formatUnits"],"sources":["../../../../../src/core/tasks/helpers/checkBalance.ts"],"sourcesContent":["import type { LiFiStep, Token, TokenAmount } from '@lifi/types'\nimport { BalanceError } from '../../../errors/errors.js'\nimport type { SDKClient } from '../../../types/core.js'\nimport { formatUnits } from '../../../utils/formatUnits.js'\nimport { sleep } from '../../../utils/sleep.js'\nimport { withTimeout } from '../../../utils/withTimeout.js'\n\nconst MAX_ATTEMPTS = 6\n// Exponential backoff: 150, 300, 600, 1200, 2400 → ≈4.65s of sleep total.\nconst BACKOFF_BASE_MS = 150\nconst OVERALL_TIMEOUT_MS = 10_000\nconst SLIPPAGE_PRECISION = 1_000_000_000n\n\ntype Bucket = 'source' | 'gas' | 'fee'\n\ntype Requirement = {\n  token: Token\n  sourcePart: bigint // step.action.fromAmount\n  gasPart: bigint // step.estimate.gasCosts in this token\n  feePart: bigint // non-included step.estimate.feeCosts in this token\n}\n\nexport type CheckBalanceOptions = {\n  /**\n   * Set to `false` when outer-tx gas is paid by something other than\n   * `walletAddress` (SCA executor, 4337 bundler / paymaster, relayer):\n   * `gasPart` is excluded from the sufficiency check and slippage rescue.\n   * Source amount and non-included fees (e.g. LZ `msg.value`) are still\n   * verified. Defaults to `true` (strict, today's behavior).\n   */\n  walletPaysGas?: boolean\n}\n\n/**\n * Verifies that the wallet holds enough of every token required to execute\n * the step on its source chain — the source-token amount, any gas costs, and\n * any non-included fee costs. Reads all balances in one batched provider\n * call, retries within a bounded budget to absorb transient RPC failures and\n * post-confirmation propagation lag, and applies slippage to the source-token\n * portion only as a last resort (overhead is never trimmed).\n *\n * Throws BalanceError(\"The balance is too low.\") on a genuine shortfall, or\n * BalanceError(\"Could not read wallet balance.\") if the balance can't be read\n * after retries.\n */\nexport const checkBalance = async (\n  client: SDKClient,\n  walletAddress: string,\n  step: LiFiStep,\n  options: CheckBalanceOptions = {}\n): Promise<void> => {\n  const fromChainId = step.action.fromChainId\n  // Chains with non-standard native decimals (e.g. Tempo, Stable) report\n  // gas costs in units that don't align with wallet balances — drop the\n  // gas portion of the check on those chains.\n  const fromChain = await client.getChainById(fromChainId)\n  const walletPaysGas =\n    (options.walletPaysGas ?? true) && !fromChain.nonStandardNativeDecimals\n  const requirements = new Map<string, Requirement>()\n  const add = (token: Token, amount: bigint, bucket: Bucket): void => {\n    if (token.chainId !== fromChainId || amount === 0n) {\n      return\n    }\n    const key = token.address.toLowerCase()\n    const req = requirements.get(key) ?? {\n      token,\n      sourcePart: 0n,\n      gasPart: 0n,\n      feePart: 0n,\n    }\n    if (bucket === 'source') {\n      req.sourcePart += amount\n    } else if (bucket === 'gas') {\n      req.gasPart += amount\n    } else {\n      req.feePart += amount\n    }\n    requirements.set(key, req)\n  }\n  add(step.action.fromToken, BigInt(step.action.fromAmount), 'source')\n  for (const gas of step.estimate?.gasCosts ?? []) {\n    add(gas.token, BigInt(gas.amount), 'gas')\n  }\n  for (const fee of step.estimate?.feeCosts ?? []) {\n    // Included fees are already part of fromAmount — don't count twice.\n    if (!fee.included) {\n      add(fee.token, BigInt(fee.amount), 'fee')\n    }\n  }\n\n  const reservedOverhead = (r: Requirement): bigint =>\n    r.feePart + (walletPaysGas ? r.gasPart : 0n)\n  const need = (r: Requirement): bigint => r.sourcePart + reservedOverhead(r)\n\n  // Drop pure-gas entries when `walletPaysGas` is false (e.g. native ETH\n  // on Safe Apps with only `gasPart`) — saves one balance read each.\n  for (const [key, req] of requirements) {\n    if (need(req) === 0n) {\n      requirements.delete(key)\n    }\n  }\n\n  if (requirements.size === 0) {\n    return\n  }\n\n  // Provider is dispatched by wallet address; all requirements share the\n  // source chain, which matches this provider by virtue of the address.\n  const provider = client.providers.find((p) => p.isAddress(walletAddress))\n  if (!provider) {\n    throw new Error(`SDK Token Provider for ${walletAddress} is not found.`)\n  }\n\n  const reqs = Array.from(requirements.values())\n  const tokens = reqs.map((r) => r.token)\n  const slippage = step.action.slippage ?? 0\n  const slippageScaled = BigInt(\n    Math.floor((1 - slippage) * Number(SLIPPAGE_PRECISION))\n  )\n\n  await withTimeout(\n    async () => {\n      for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {\n        const isFinal = attempt === MAX_ATTEMPTS - 1\n\n        let balances: TokenAmount[]\n        try {\n          balances = await provider.getBalance(client, walletAddress, tokens)\n        } catch (error) {\n          if (isFinal) {\n            throw new BalanceError(\n              'Could not read wallet balance.',\n              error as Error\n            )\n          }\n          await sleep(BACKOFF_BASE_MS * 2 ** attempt)\n          continue\n        }\n\n        const balanceByAddress = new Map(\n          balances.map((b) => [b.address.toLowerCase(), b.amount] as const)\n        )\n\n        const unknown: Token[] = []\n        const insufficient: { req: Requirement; have: bigint }[] = []\n        for (const req of reqs) {\n          const have = balanceByAddress.get(req.token.address.toLowerCase())\n          if (have === undefined) {\n            unknown.push(req.token)\n          } else if (have < need(req)) {\n            insufficient.push({ req, have })\n          }\n        }\n\n        if (unknown.length === 0 && insufficient.length === 0) {\n          return\n        }\n\n        // Final-attempt slippage rescue: only when the sole shortfall is\n        // the source-token portion. Trim source to (balance − reserved\n        // overhead) so the overhead reserve is preserved.\n        if (\n          isFinal &&\n          unknown.length === 0 &&\n          insufficient.length === 1 &&\n          insufficient[0].req.sourcePart > 0n\n        ) {\n          const { req, have } = insufficient[0]\n          const reserved = reservedOverhead(req)\n          const minAcceptable =\n            (req.sourcePart * slippageScaled) / SLIPPAGE_PRECISION + reserved\n          if (have >= minAcceptable) {\n            const newFromAmount = (have - reserved).toString()\n            step.action.fromAmount = newFromAmount\n            if (step.includedSteps?.length) {\n              step.includedSteps[0].action.fromAmount = newFromAmount\n            }\n            return\n          }\n        }\n\n        if (isFinal) {\n          if (unknown.length > 0) {\n            throw new BalanceError(\n              'Could not read wallet balance.',\n              new Error(\n                `Could not read balance for: ${unknown\n                  .map((t) => t.symbol || t.address)\n                  .join(', ')}.`\n              )\n            )\n          }\n          const lines = insufficient.map(({ req, have }) => {\n            const needed = formatUnits(need(req), req.token.decimals)\n            const current = formatUnits(have, req.token.decimals)\n            const symbol = req.token.symbol\n            // The \"fees\" branch covers pure-overhead tokens; with\n            // walletPaysGas=false, gas is excluded from `need(req)` so it\n            // only fires for genuine fee shortfalls.\n            return req.sourcePart > 0n\n              ? `Your ${symbol} balance is too low, you try to transfer ${needed} ${symbol}, but your wallet only holds ${current} ${symbol}.`\n              : `Insufficient ${symbol} for fees: need ${needed} ${symbol}, have ${current} ${symbol}.`\n          })\n          throw new BalanceError(\n            'The balance is too low.',\n            new Error(`${lines.join(' ')} No funds have been sent.`)\n          )\n        }\n\n        await sleep(BACKOFF_BASE_MS * 2 ** attempt)\n      }\n    },\n    {\n      timeout: OVERALL_TIMEOUT_MS,\n      errorInstance: new BalanceError('Could not read wallet balance.'),\n    }\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"checkBalance.js","names":["withTimeout","BalanceError","sleep","formatUnits"],"sources":["../../../../../src/core/tasks/helpers/checkBalance.ts"],"sourcesContent":["import type { LiFiStep, Token, TokenAmount } from '@lifi/types'\nimport { BalanceError } from '../../../errors/errors.js'\nimport type { SDKClient } from '../../../types/core.js'\nimport { formatUnits } from '../../../utils/formatUnits.js'\nimport { sleep } from '../../../utils/sleep.js'\nimport { withTimeout } from '../../../utils/withTimeout.js'\n\nconst MAX_ATTEMPTS = 6\n// Exponential backoff: 150, 300, 600, 1200, 2400 → ≈4.65s of sleep total.\nconst BACKOFF_BASE_MS = 150\nconst OVERALL_TIMEOUT_MS = 10_000\nconst SLIPPAGE_PRECISION = 1_000_000_000n\n\ntype Bucket = 'source' | 'gas' | 'fee'\n\ntype Requirement = {\n  token: Token\n  sourcePart: bigint // step.action.fromAmount\n  gasPart: bigint // step.estimate.gasCosts in this token\n  feePart: bigint // non-included step.estimate.feeCosts in this token\n}\n\nexport type CheckBalanceOptions = {\n  /**\n   * Set to `false` when outer-tx gas is paid by something other than\n   * `walletAddress` (SCA executor, 4337 bundler / paymaster, relayer):\n   * `gasPart` is excluded from the sufficiency check and slippage rescue.\n   * Source amount and non-included fees (e.g. LZ `msg.value`) are still\n   * verified. Defaults to `true` (strict, today's behavior).\n   */\n  walletPaysGas?: boolean\n}\n\n/**\n * Verifies that the wallet holds enough of every token required to execute\n * the step on its source chain — the source-token amount, any gas costs, and\n * any non-included fee costs. Reads all balances in one batched provider\n * call, retries within a bounded budget to absorb transient RPC failures and\n * post-confirmation propagation lag, and applies slippage to the source-token\n * portion only as a last resort (overhead is never trimmed).\n *\n * Throws BalanceError(\"The balance is too low.\") on a genuine shortfall, or\n * BalanceError(\"Could not read wallet balance.\") if the balance can't be read\n * after retries.\n */\nexport const checkBalance = async (\n  client: SDKClient,\n  walletAddress: string,\n  step: LiFiStep,\n  options: CheckBalanceOptions = {}\n): Promise<void> => {\n  const fromChainId = step.action.fromChainId\n  // Chains with non-standard native decimals (e.g. Tempo, Stable) report\n  // gas costs in units that don't align with wallet balances — drop the\n  // gas portion of the check on those chains.\n  const fromChain = await client.getChainById(fromChainId)\n  const walletPaysGas =\n    (options.walletPaysGas ?? true) && !fromChain.nonStandardNativeDecimals\n  const requirements = new Map<string, Requirement>()\n  const add = (token: Token, amount: bigint, bucket: Bucket): void => {\n    if (token.chainId !== fromChainId || amount === 0n) {\n      return\n    }\n    const key = token.address.toLowerCase()\n    const req = requirements.get(key) ?? {\n      token,\n      sourcePart: 0n,\n      gasPart: 0n,\n      feePart: 0n,\n    }\n    if (bucket === 'source') {\n      req.sourcePart += amount\n    } else if (bucket === 'gas') {\n      req.gasPart += amount\n    } else {\n      req.feePart += amount\n    }\n    requirements.set(key, req)\n  }\n  add(step.action.fromToken, BigInt(step.action.fromAmount), 'source')\n  for (const gas of step.estimate?.gasCosts ?? []) {\n    add(gas.token, BigInt(gas.amount), 'gas')\n  }\n  for (const fee of step.estimate?.feeCosts ?? []) {\n    // Included fees are already part of fromAmount — don't count twice.\n    if (!fee.included) {\n      add(fee.token, BigInt(fee.amount), 'fee')\n    }\n  }\n\n  const reservedOverhead = (r: Requirement): bigint =>\n    r.feePart + (walletPaysGas ? r.gasPart : 0n)\n  const need = (r: Requirement): bigint => r.sourcePart + reservedOverhead(r)\n\n  // Drop pure-gas entries when `walletPaysGas` is false (e.g. native ETH\n  // on Safe Apps with only `gasPart`) — saves one balance read each.\n  for (const [key, req] of requirements) {\n    if (need(req) === 0n) {\n      requirements.delete(key)\n    }\n  }\n\n  if (requirements.size === 0) {\n    return\n  }\n\n  // Provider is dispatched by wallet address; all requirements share the\n  // source chain, which matches this provider by virtue of the address.\n  const provider = client.providers.find((p) => p.isAddress(walletAddress))\n  if (!provider) {\n    throw new Error(`SDK Token Provider for ${walletAddress} is not found.`)\n  }\n\n  const reqs = Array.from(requirements.values())\n  const tokens = reqs.map((r) => r.token)\n  const slippage = step.action.slippage ?? 0\n  const slippageScaled = BigInt(\n    Math.floor((1 - slippage) * Number(SLIPPAGE_PRECISION))\n  )\n\n  // Aborted once `withTimeout` settles. A timeout rejects at once, but the\n  // loop keeps running; the signal stops it before it can change `step`.\n  const controller = new AbortController()\n  const { signal } = controller\n\n  await withTimeout(\n    async () => {\n      for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {\n        const isFinal = attempt === MAX_ATTEMPTS - 1\n\n        let balances: TokenAmount[]\n        try {\n          balances = await provider.getBalance(client, walletAddress, tokens)\n        } catch (error) {\n          if (isFinal) {\n            throw new BalanceError(\n              'Could not read wallet balance.',\n              error as Error\n            )\n          }\n          await sleep(BACKOFF_BASE_MS * 2 ** attempt, { signal })\n          continue\n        }\n        if (signal.aborted) {\n          return\n        }\n\n        const balanceByAddress = new Map(\n          balances.map((b) => [b.address.toLowerCase(), b.amount] as const)\n        )\n\n        const unknown: Token[] = []\n        const insufficient: { req: Requirement; have: bigint }[] = []\n        for (const req of reqs) {\n          const have = balanceByAddress.get(req.token.address.toLowerCase())\n          if (have === undefined) {\n            unknown.push(req.token)\n          } else if (have < need(req)) {\n            insufficient.push({ req, have })\n          }\n        }\n\n        if (unknown.length === 0 && insufficient.length === 0) {\n          return\n        }\n\n        // Final-attempt slippage rescue: only when the sole shortfall is\n        // the source-token portion. Trim source to (balance − reserved\n        // overhead) so the overhead reserve is preserved.\n        if (\n          isFinal &&\n          unknown.length === 0 &&\n          insufficient.length === 1 &&\n          insufficient[0].req.sourcePart > 0n\n        ) {\n          const { req, have } = insufficient[0]\n          const reserved = reservedOverhead(req)\n          const minAcceptable =\n            (req.sourcePart * slippageScaled) / SLIPPAGE_PRECISION + reserved\n          if (have >= minAcceptable) {\n            const newFromAmount = (have - reserved).toString()\n            step.action.fromAmount = newFromAmount\n            if (step.includedSteps?.length) {\n              step.includedSteps[0].action.fromAmount = newFromAmount\n            }\n            return\n          }\n        }\n\n        if (isFinal) {\n          if (unknown.length > 0) {\n            throw new BalanceError(\n              'Could not read wallet balance.',\n              new Error(\n                `Could not read balance for: ${unknown\n                  .map((t) => t.symbol || t.address)\n                  .join(', ')}.`\n              )\n            )\n          }\n          const lines = insufficient.map(({ req, have }) => {\n            const needed = formatUnits(need(req), req.token.decimals)\n            const current = formatUnits(have, req.token.decimals)\n            const symbol = req.token.symbol\n            // The \"fees\" branch covers pure-overhead tokens; with\n            // walletPaysGas=false, gas is excluded from `need(req)` so it\n            // only fires for genuine fee shortfalls.\n            return req.sourcePart > 0n\n              ? `Your ${symbol} balance is too low, you try to transfer ${needed} ${symbol}, but your wallet only holds ${current} ${symbol}.`\n              : `Insufficient ${symbol} for fees: need ${needed} ${symbol}, have ${current} ${symbol}.`\n          })\n          throw new BalanceError(\n            'The balance is too low.',\n            new Error(`${lines.join(' ')} No funds have been sent.`)\n          )\n        }\n\n        await sleep(BACKOFF_BASE_MS * 2 ** attempt, { signal })\n      }\n    },\n    {\n      timeout: OVERALL_TIMEOUT_MS,\n      errorInstance: new BalanceError('Could not read wallet balance.'),\n    }\n  ).finally(() => controller.abort())\n}\n"],"mappings":"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"}

package/dist/cjs/index.d.ts

@@ -1,5 +1,5 @@
 import { InMemoryStorage, LocalStorageAdapter, SDKStorage, createDefaultStorage } from "./core/storage.js";
-import { AcceptExchangeRateUpdateHook, AcceptSlippageUpdateHook, AcceptSlippageUpdateHookParams, ContractCallParams, ContractTool, ExchangeRateUpdateParams, ExecuteStepRetryParams, Execution, ExecutionAction, ExecutionActionStatus, ExecutionActionType, ExecutionOptions, ExecutionStatus, GetContractCallsHook, GetContractCallsResult, InteractionSettings, LiFiStepExtended, RPCUrls, RequestInterceptor, RouteExecutionData, RouteExecutionDataDictionary, RouteExecutionDictionary, RouteExtended, SDKBaseConfig, SDKClient, SDKConfig, SDKProvider, StepExecutor, StepExecutorOptions, StepExtended, TransactionMethodType, TransactionParameters, TransactionRequestParameters, TransactionRequestUpdateHook, UpdateRouteHook } from "./types/core.js";
+import { AcceptExchangeRateUpdateHook, AcceptSlippageUpdateHook, AcceptSlippageUpdateHookParams, ContractCallParams, ContractTool, ExchangeRateUpdateParams, ExecuteStepRetryParams, Execution, ExecutionAction, ExecutionActionStatus, ExecutionActionType, ExecutionOptions, ExecutionStatus, GetContractCallsHook, GetContractCallsResult, InteractionSettings, LiFiStepExtended, RPCUrls, RPCUrlsByRole, RPCUrlsConfig, RequestInterceptor, RouteExecutionData, RouteExecutionDataDictionary, RouteExecutionDictionary, RouteExtended, SDKBaseConfig, SDKClient, SDKConfig, SDKProvider, StepExecutor, StepExecutorOptions, StepExtended, TransactionMethodType, TransactionParameters, TransactionRequestParameters, TransactionRequestUpdateHook, UpdateRouteHook } from "./types/core.js";
 import { getChains } from "./actions/getChains.js";
 import { getConnections } from "./actions/getConnections.js";
 import { getContractCallsQuote } from "./actions/getContractCallsQuote.js";
@@ -46,11 +46,12 @@ import { convertQuoteToRoute } from "./utils/convertQuoteToRoute.js";
 import { fetchTxErrorDetails } from "./utils/fetchTxErrorDetails.js";
 import { formatUnits } from "./utils/formatUnits.js";
 import { isHex } from "./utils/isHex.js";
+import { LruMap } from "./utils/lru.js";
 import { parseUnits } from "./utils/parseUnits.js";
 import { sleep } from "./utils/sleep.js";
 import { waitForResult } from "./utils/waitForResult.js";
-import { LruMap, withDedupe } from "./utils/withDedupe.js";
+import { withDedupe } from "./utils/withDedupe.js";
 import { withTimeout } from "./utils/withTimeout.js";
 import { name, version } from "./version.js";
 export * from "@lifi/types";
-export { type AcceptExchangeRateUpdateHook, type AcceptSlippageUpdateHook, type AcceptSlippageUpdateHookParams, BalanceError, BaseError, BaseStepExecutionTask, BaseStepExecutor, type CheckBalanceOptions, CheckBalanceTask, type ContractCallParams, type ContractTool, type ErrorCode, ErrorMessage, ErrorName, type ExchangeRateUpdateParams, ExecuteStepRetryError, type ExecuteStepRetryParams, type Execution, type ExecutionAction, type ExecutionActionStatus, type ExecutionActionType, type ExecutionOptions, type ExecutionStatus, type GetContractCallsHook, type GetContractCallsResult, type GetStatusRequestExtended, HTTPError, InMemoryStorage, type InteractionSettings, LiFiErrorCode, type LiFiStepExtended, type LiFiStepRequest, LocalStorageAdapter, LruMap, PrepareTransactionTask, ProviderError, type QuoteRequest, type QuoteRequestFromAmount, type QuoteRequestToAmount, RPCError, type RPCUrls, type RequestInterceptor, type RouteExecutionData, type RouteExecutionDataDictionary, type RouteExecutionDictionary, type RouteExtended, type SDKBaseConfig, type SDKClient, type SDKConfig, SDKError, type SDKProvider, type SDKStorage, ServerError, StatusManager, type StepExecutor, type StepExecutorBaseContext, type StepExecutorContext, type StepExecutorOptions, type StepExtended, TaskPipeline, type TaskResult, type TaskStatus, TransactionError, type TransactionMethodType, type TransactionParameters, type TransactionRequestParameters, type TransactionRequestUpdateHook, UnknownError, type UpdateRouteHook, ValidationError, WaitForTransactionStatusTask, actions, checkBalance, checkPackageUpdates, convertQuoteToRoute, createClient, createDefaultStorage, executeRoute, fetchTxErrorDetails, formatUnits, getActionMessage, getActiveRoute, getActiveRoutes, getChains, getConnections, getContractCallsQuote, getGasRecommendation, getNameServiceAddress, getQuote, getRelayedTransactionStatus, getRelayerQuote, getRoutes, getStatus, getStepTransaction, getSubstatusMessage, getToken, getTokenBalance, getTokenBalances, getTokenBalancesByChain, getTokens, getTools, getTransactionHistory, getTransactionRequestData, isHex, name, parseUnits, patchContractCalls, relayTransaction, resumeRoute, sleep, stepComparison, stopRouteExecution, updateRouteExecution, version, waitForResult, withDedupe, withTimeout };
+export { type AcceptExchangeRateUpdateHook, type AcceptSlippageUpdateHook, type AcceptSlippageUpdateHookParams, BalanceError, BaseError, BaseStepExecutionTask, BaseStepExecutor, type CheckBalanceOptions, CheckBalanceTask, type ContractCallParams, type ContractTool, type ErrorCode, ErrorMessage, ErrorName, type ExchangeRateUpdateParams, ExecuteStepRetryError, type ExecuteStepRetryParams, type Execution, type ExecutionAction, type ExecutionActionStatus, type ExecutionActionType, type ExecutionOptions, type ExecutionStatus, type GetContractCallsHook, type GetContractCallsResult, type GetStatusRequestExtended, HTTPError, InMemoryStorage, type InteractionSettings, LiFiErrorCode, type LiFiStepExtended, type LiFiStepRequest, LocalStorageAdapter, LruMap, PrepareTransactionTask, ProviderError, type QuoteRequest, type QuoteRequestFromAmount, type QuoteRequestToAmount, RPCError, type RPCUrls, type RPCUrlsByRole, type RPCUrlsConfig, type RequestInterceptor, type RouteExecutionData, type RouteExecutionDataDictionary, type RouteExecutionDictionary, type RouteExtended, type SDKBaseConfig, type SDKClient, type SDKConfig, SDKError, type SDKProvider, type SDKStorage, ServerError, StatusManager, type StepExecutor, type StepExecutorBaseContext, type StepExecutorContext, type StepExecutorOptions, type StepExtended, TaskPipeline, type TaskResult, type TaskStatus, TransactionError, type TransactionMethodType, type TransactionParameters, type TransactionRequestParameters, type TransactionRequestUpdateHook, UnknownError, type UpdateRouteHook, ValidationError, WaitForTransactionStatusTask, actions, checkBalance, checkPackageUpdates, convertQuoteToRoute, createClient, createDefaultStorage, executeRoute, fetchTxErrorDetails, formatUnits, getActionMessage, getActiveRoute, getActiveRoutes, getChains, getConnections, getContractCallsQuote, getGasRecommendation, getNameServiceAddress, getQuote, getRelayedTransactionStatus, getRelayerQuote, getRoutes, getStatus, getStepTransaction, getSubstatusMessage, getToken, getTokenBalance, getTokenBalances, getTokenBalancesByChain, getTokens, getTools, getTransactionHistory, getTransactionRequestData, isHex, name, parseUnits, patchContractCalls, relayTransaction, resumeRoute, sleep, stepComparison, stopRouteExecution, updateRouteExecution, version, waitForResult, withDedupe, withTimeout };

package/dist/cjs/index.js

@@ -1,11 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_version = require("./version.js");
+const require_errors_SDKError = require("./errors/SDKError.js");
 const require_errors_baseError = require("./errors/baseError.js");
 const require_errors_constants = require("./errors/constants.js");
 const require_errors_errors = require("./errors/errors.js");
 const require_errors_httpError = require("./errors/httpError.js");
-const require_version = require("./version.js");
-const require_errors_SDKError = require("./errors/SDKError.js");
 const require_utils_sleep = require("./utils/sleep.js");
+const require_utils_lru = require("./utils/lru.js");
 const require_utils_withDedupe = require("./utils/withDedupe.js");
 const require_actions_getChains = require("./actions/getChains.js");
 const require_actions_getConnections = require("./actions/getConnections.js");
@@ -62,7 +63,7 @@ exports.HTTPError = require_errors_httpError.HTTPError;
 exports.InMemoryStorage = require_core_storage.InMemoryStorage;
 exports.LiFiErrorCode = require_errors_constants.LiFiErrorCode;
 exports.LocalStorageAdapter = require_core_storage.LocalStorageAdapter;
-exports.LruMap = require_utils_withDedupe.LruMap;
+exports.LruMap = require_utils_lru.LruMap;
 exports.PrepareTransactionTask = require_core_tasks_PrepareTransactionTask.PrepareTransactionTask;
 exports.ProviderError = require_errors_errors.ProviderError;
 exports.RPCError = require_errors_errors.RPCError;

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

@@ -19,10 +19,51 @@ export interface SDKBaseConfig {
   requestInterceptor?: RequestInterceptor;
   storage?: SDKStorage;
 }
-export interface SDKConfig extends Partial<Omit<SDKBaseConfig, "integrator">> {
+export interface SDKConfig extends Partial<Omit<SDKBaseConfig, "integrator" | "rpcUrls">> {
   integrator: string;
+  /**
+   * Per chain, one list for reads and sends, or lists by role. The client
+   * keeps the read lists in `config.rpcUrls` and serves the write and bundle
+   * lists through `getWriteRpcUrlsByChainId` and `getBundleRpcUrlsByChainId`.
+   */
+  rpcUrls?: RPCUrlsConfig;
   providers?: SDKProvider[];
 }
+/**
+ * RPC URLs for one chain, split by what they are used for.
+ */
+export interface RPCUrlsByRole {
+  /**
+   * Reads: balances, simulation and confirmation. Unset, the chain's own RPC
+   * URLs serve reads, as for a chain with no `rpcUrls` entry.
+   */
+  read?: string[];
+  /**
+   * Sends. Unset or empty, the read URLs send as well. While `write` is set,
+   * nothing is sent through the read URLs: when `bundle` is unset, the write
+   * URLs that support bundles also submit bundles, and with none of them, a
+   * route that needs a bundle fails.
+   *
+   * Only `@lifi/sdk-provider-solana` uses this today; other providers ignore
+   * it.
+   */
+  write?: string[];
+  /**
+   * Bundle submissions (Jito `sendBundle`). Unset, empty, or with no URL that
+   * supports bundles, the write URLs that do submit them. While `bundle` or
+   * `write` is set, bundles never go to the read URLs.
+   *
+   * Only `@lifi/sdk-provider-solana` uses this today; other providers ignore
+   * it.
+   */
+  bundle?: string[];
+}
+/**
+ * The `rpcUrls` option of `createClient`: per chain, either one list for reads
+ * and sends, or lists by role.
+ */
+export type RPCUrlsConfig = Partial<Record<ChainId, string[] | RPCUrlsByRole>>;
+/** RPC URL lists per chain. `client.config.rpcUrls` holds the read lists. */
 export type RPCUrls = Partial<Record<ChainId, string[]>>;
 export interface SDKProvider {
   readonly type: ChainType;
@@ -47,6 +88,20 @@ export interface SDKClient {
   getChainById(chainId: ChainId): Promise<ExtendedChain>;
   getRpcUrls(): Promise<RPCUrls>;
   getRpcUrlsByChainId(chainId: ChainId): Promise<string[]>;
+  /**
+   * The chain's dedicated write RPC URLs (`rpcUrls[chainId].write`). Empty
+   * when the chain has none.
+   *
+   * Optional so clients from other SDK versions, and hand-written ones, still
+   * satisfy `SDKClient`. Providers treat a missing method as no write list.
+   */
+  getWriteRpcUrlsByChainId?(chainId: ChainId): Promise<string[]>;
+  /**
+   * The chain's dedicated bundle RPC URLs (`rpcUrls[chainId].bundle`). Empty
+   * when the chain has none. Optional for the same reason as
+   * `getWriteRpcUrlsByChainId`.
+   */
+  getBundleRpcUrlsByChainId?(chainId: ChainId): Promise<string[]>;
 }
 export interface StepExecutorOptions {
   routeId: string;

package/dist/cjs/utils/abort.d.ts

@@ -0,0 +1,6 @@
+//#region src/utils/abort.d.ts
+/** Older runtimes and polyfills can abort a signal without a `reason`. */
+export declare const getAbortError: (signal: AbortSignal) => unknown;
+export declare const isAbortError: (error: unknown) => boolean;
+//#endregion
+//# sourceMappingURL=abort.d.ts.map

package/dist/cjs/utils/abort.js

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/abort.ts
+/** Older runtimes and polyfills can abort a signal without a `reason`. */
+const getAbortError = (signal) => signal.reason ?? Object.assign(/* @__PURE__ */ new Error("This operation was aborted"), { name: "AbortError" });
+const isAbortError = (error) => typeof error === "object" && error !== null && "name" in error && error.name === "AbortError";
+//#endregion
+exports.getAbortError = getAbortError;
+exports.isAbortError = isAbortError;
+
+//# sourceMappingURL=abort.js.map

package/dist/cjs/utils/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","names":[],"sources":["../../../src/utils/abort.ts"],"sourcesContent":["/** Older runtimes and polyfills can abort a signal without a `reason`. */\nexport const getAbortError = (signal: AbortSignal): unknown =>\n  signal.reason ??\n  Object.assign(new Error('This operation was aborted'), { name: 'AbortError' })\n\nexport const isAbortError = (error: unknown): boolean =>\n  typeof error === 'object' &&\n  error !== null &&\n  'name' in error &&\n  error.name === 'AbortError'\n"],"mappings":";;;AACA,MAAa,iBAAiB,WAC5B,OAAO,UACP,OAAO,uBAAO,IAAI,MAAM,4BAA4B,GAAG,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAa,gBAAgB,UAC3B,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS"}

package/dist/cjs/utils/checkPackageUpdates.js

@@ -5,7 +5,7 @@ const checkPackageUpdates = async (packageName, packageVersion) => {
 	try {
 		const pkgName = packageName ?? "@lifi/sdk";
 		const latestVersion = (await (await fetch(`https://registry.npmjs.org/${pkgName}/latest`)).json()).version;
-		const currentVersion = packageVersion ?? "4.8.2";
+		const currentVersion = packageVersion ?? "4.10.0";
 		if (latestVersion > currentVersion) console.warn(`${pkgName}: new package version is available. Please update as soon as possible to enjoy the newest features. Current version: ${currentVersion}. Latest version: ${latestVersion}.`);
 	} catch (_error) {}
 };

package/dist/cjs/utils/convertQuoteToRoute.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors_errors = require("../errors/errors.js");
 const require_errors_SDKError = require("../errors/SDKError.js");
+const require_errors_errors = require("../errors/errors.js");
 const require_utils_formatUnits = require("./formatUnits.js");
 //#region src/utils/convertQuoteToRoute.ts
 const parseBigInt = (value) => {

package/dist/cjs/utils/formatUnits.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 *  Divides a number by a given exponent of base 10 (10exponent), and formats it into a string representation of the number.
 */
 function formatUnits(value, decimals) {
+	if (!Number.isInteger(decimals) || decimals < 0) throw new Error(`\`decimals\` must be a non-negative integer. Got \`${decimals}\`.`);
 	let display = value.toString();
 	const negative = display.startsWith("-");
 	if (negative) display = display.slice(1);

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

@@ -1 +1 @@
-{"version":3,"file":"formatUnits.js","names":[],"sources":["../../../src/utils/formatUnits.ts"],"sourcesContent":["/**\n *  Divides a number by a given exponent of base 10 (10exponent), and formats it into a string representation of the number.\n */\nexport function formatUnits(value: bigint, decimals: number): string {\n  let display = value.toString()\n\n  const negative = display.startsWith('-')\n  if (negative) {\n    display = display.slice(1)\n  }\n\n  display = display.padStart(decimals, '0')\n\n  let [integer, fraction] = [\n    display.slice(0, display.length - decimals),\n    display.slice(display.length - decimals),\n  ]\n  fraction = fraction.replace(/(0+)$/, '')\n  return `${negative ? '-' : ''}${integer || '0'}${\n    fraction ? `.${fraction}` : ''\n  }`\n}\n"],"mappings":";;;;;AAGA,SAAgB,YAAY,OAAe,UAA0B;CACnE,IAAI,UAAU,MAAM,SAAS;CAE7B,MAAM,WAAW,QAAQ,WAAW,GAAG;CACvC,IAAI,UACF,UAAU,QAAQ,MAAM,CAAC;CAG3B,UAAU,QAAQ,SAAS,UAAU,GAAG;CAExC,IAAI,CAAC,SAAS,YAAY,CACxB,QAAQ,MAAM,GAAG,QAAQ,SAAS,QAAQ,GAC1C,QAAQ,MAAM,QAAQ,SAAS,QAAQ,CACzC;CACA,WAAW,SAAS,QAAQ,SAAS,EAAE;CACvC,OAAO,GAAG,WAAW,MAAM,KAAK,WAAW,MACzC,WAAW,IAAI,aAAa;AAEhC"}
+{"version":3,"file":"formatUnits.js","names":[],"sources":["../../../src/utils/formatUnits.ts"],"sourcesContent":["/**\n *  Divides a number by a given exponent of base 10 (10exponent), and formats it into a string representation of the number.\n */\nexport function formatUnits(value: bigint, decimals: number): string {\n  if (!Number.isInteger(decimals) || decimals < 0) {\n    throw new Error(\n      `\\`decimals\\` must be a non-negative integer. Got \\`${decimals}\\`.`\n    )\n  }\n\n  let display = value.toString()\n\n  const negative = display.startsWith('-')\n  if (negative) {\n    display = display.slice(1)\n  }\n\n  display = display.padStart(decimals, '0')\n\n  let [integer, fraction] = [\n    display.slice(0, display.length - decimals),\n    display.slice(display.length - decimals),\n  ]\n  fraction = fraction.replace(/(0+)$/, '')\n  return `${negative ? '-' : ''}${integer || '0'}${\n    fraction ? `.${fraction}` : ''\n  }`\n}\n"],"mappings":";;;;;AAGA,SAAgB,YAAY,OAAe,UAA0B;CACnE,IAAI,CAAC,OAAO,UAAU,QAAQ,KAAK,WAAW,GAC5C,MAAM,IAAI,MACR,sDAAsD,SAAS,IACjE;CAGF,IAAI,UAAU,MAAM,SAAS;CAE7B,MAAM,WAAW,QAAQ,WAAW,GAAG;CACvC,IAAI,UACF,UAAU,QAAQ,MAAM,CAAC;CAG3B,UAAU,QAAQ,SAAS,UAAU,GAAG;CAExC,IAAI,CAAC,SAAS,YAAY,CACxB,QAAQ,MAAM,GAAG,QAAQ,SAAS,QAAQ,GAC1C,QAAQ,MAAM,QAAQ,SAAS,QAAQ,CACzC;CACA,WAAW,SAAS,QAAQ,SAAS,EAAE;CACvC,OAAO,GAAG,WAAW,MAAM,KAAK,WAAW,MACzC,WAAW,IAAI,aAAa;AAEhC"}

package/dist/cjs/utils/lru.d.ts

@@ -0,0 +1,14 @@
+//#region src/utils/lru.d.ts
+/**
+ * Map with a LRU (Least recently used) policy.
+ *
+ * https://en.wikipedia.org/wiki/Cache_replacement_policies#LRU
+ */
+export declare class LruMap<value = unknown> extends Map<string, value> {
+  maxSize: number;
+  constructor(size: number);
+  override get(key: string): value | undefined;
+  override set(key: string, value: value): this;
+}
+//#endregion
+//# sourceMappingURL=lru.d.ts.map