@lifi/sdk 3.0.0-alpha.8 → 3.0.0-beta.0

package/src/_types/utils/base64ToUint8Array.d.ts

@@ -0,0 +1,2 @@
+export declare function base64ToUint8Array(base64String: string): Uint8Array;
+//# sourceMappingURL=base64ToUint8Array.d.ts.map

package/src/_types/utils/base64ToUint8Array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64ToUint8Array.d.ts","sourceRoot":"","sources":["../../utils/base64ToUint8Array.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,cAQtD"}

package/{dist/cjs → src/_types}/utils/errors.d.ts

@@ -25,7 +25,8 @@ export declare enum LiFiErrorCode {
     BalanceError = 1013,
     AllowanceRequired = 1014,
     InsufficientFunds = 1015,
-    ExchangeRateUpdateCanceled = 1016
+    ExchangeRateUpdateCanceled = 1016,
+    WalletChangedDuringExecution = 1017
 }
 export declare enum EthersErrorType {
     ActionRejected = "ACTION_REJECTED",
@@ -105,3 +106,4 @@ export declare class HTTPError extends Error {
     constructor(response: Response);
 }
 export {};
+//# sourceMappingURL=errors.d.ts.map

package/src/_types/utils/errors.d.ts.map

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

package/src/_types/utils/getTransactionMessage.d.ts

@@ -0,0 +1,4 @@
+import type { LiFiStep, Process } from '@lifi/types';
+export declare const getTransactionNotSentMessage: (step?: LiFiStep, process?: Process) => Promise<string>;
+export declare const getTransactionFailedMessage: (step: LiFiStep, txLink?: string) => Promise<string>;
+//# sourceMappingURL=getTransactionMessage.d.ts.map

package/src/_types/utils/getTransactionMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTransactionMessage.d.ts","sourceRoot":"","sources":["../../utils/getTransactionMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAIpD,eAAO,MAAM,4BAA4B,UAChC,QAAQ,YACL,OAAO,KAChB,QAAQ,MAAM,CAwBhB,CAAA;AAED,eAAO,MAAM,2BAA2B,SAChC,QAAQ,WACL,MAAM,KACd,QAAQ,MAAM,CAShB,CAAA"}

package/src/_types/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './errors.js';
+export * from './getTransactionMessage.js';
+export * from './median.js';
+export * from './parseError.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_types/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA"}

package/{dist/cjs → src/_types}/utils/median.d.ts

@@ -1 +1,2 @@
 export declare const median: (arr: bigint[]) => bigint | undefined;
+//# sourceMappingURL=median.d.ts.map

package/src/_types/utils/median.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"median.d.ts","sourceRoot":"","sources":["../../utils/median.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,QAAS,MAAM,EAAE,KAAG,MAAM,GAAG,SAU/C,CAAA"}

package/src/_types/utils/parseBackendError.d.ts

@@ -0,0 +1,3 @@
+import type { LiFiError } from './errors.js';
+export declare const parseBackendError: (e: any) => Promise<LiFiError>;
+//# sourceMappingURL=parseBackendError.d.ts.map

package/src/_types/utils/parseBackendError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBackendError.d.ts","sourceRoot":"","sources":["../../utils/parseBackendError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAS5C,eAAO,MAAM,iBAAiB,MAAa,GAAG,KAAG,QAAQ,SAAS,CAwCjE,CAAA"}

package/{dist → src/_types}/utils/parseError.d.ts

@@ -1,5 +1,5 @@
 import type { LiFiStep, Process } from '@lifi/types';
-import { LiFiError } from './errors';
+import { LiFiError } from './errors.js';
 /**
  * Available MetaMask error codes:
  *
@@ -31,7 +31,5 @@ import { LiFiError } from './errors';
  * https://eips.ethereum.org/EIPS/eip-1474#error-codes
  * https://eips.ethereum.org/EIPS/eip-1193#provider-errors
  */
-export declare const getTransactionNotSentMessage: (step?: LiFiStep, process?: Process) => Promise<string>;
-export declare const getTransactionFailedMessage: (step: LiFiStep, txLink?: string) => Promise<string>;
 export declare const parseError: (e: any, step?: LiFiStep, process?: Process) => Promise<LiFiError>;
-export declare const parseBackendError: (e: any) => Promise<LiFiError>;
+//# sourceMappingURL=parseError.d.ts.map

package/src/_types/utils/parseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseError.d.ts","sourceRoot":"","sources":["../../utils/parseError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAMpD,OAAO,EAIL,SAAS,EAOV,MAAM,aAAa,CAAA;AAGpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,eAAO,MAAM,UAAU,MAClB,GAAG,SACC,QAAQ,YACL,OAAO,KAChB,QAAQ,SAAS,CAyJnB,CAAA"}

package/{dist → src/_types}/utils/utils.d.ts

@@ -8,3 +8,4 @@ export declare const wait: (ms: number) => Promise<undefined>;
 export declare const repeatUntilDone: <T>(toRepeat: () => Promise<T | undefined>, timeout?: number) => Promise<T>;
 export declare const isZeroAddress: (address: string) => boolean;
 export declare const isNativeTokenAddress: (address: string) => boolean;
+//# sourceMappingURL=utils.d.ts.map

package/src/_types/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../utils/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,OAAQ,MAAM,KAAG,QAAQ,SAAS,CAIlD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,gBAChB,MAAM,QAAQ,CAAC,GAAG,SAAS,CAAC,uBAErC,QAAQ,CAAC,CAWX,CAAA;AAED,eAAO,MAAM,aAAa,YAAa,MAAM,KAAG,OAK/C,CAAA;AAED,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,OAUtD,CAAA"}

package/src/_types/version.d.ts

@@ -0,0 +1,3 @@
+export declare const name = "@lifi/sdk";
+export declare const version = "3.0.0-beta.0";
+//# sourceMappingURL=version.d.ts.map

package/src/_types/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,cAAc,CAAA;AAC/B,eAAO,MAAM,OAAO,iBAAiB,CAAA"}

package/src/config.ts

@@ -0,0 +1,91 @@
+import type { ChainId, ExtendedChain } from '@lifi/types'
+import type { SDKProvider } from './core/types.js'
+import type { RPCUrls, SDKBaseConfig, SDKConfig } from './types/internal.js'
+
+export const config = (() => {
+  const _config: SDKBaseConfig = {
+    integrator: 'lifi-sdk',
+    apiUrl: 'https://li.quest/v1',
+    rpcUrls: {},
+    chains: [],
+    providers: [],
+    preloadChains: true,
+  }
+  let _loading: Promise<void> | undefined
+  return {
+    set loading(loading: Promise<void>) {
+      _loading = loading
+    },
+    get() {
+      return _config
+    },
+    set(options: SDKConfig) {
+      const { chains, providers, rpcUrls, ...otherOptions } = options
+      Object.assign(_config, otherOptions)
+      if (chains) {
+        this.setChains(chains)
+      }
+      if (providers) {
+        this.setProviders(providers)
+      }
+      if (rpcUrls) {
+        this.setRPCUrls(rpcUrls)
+      }
+      return _config
+    },
+    setProviders(providers: SDKProvider[]) {
+      const providerMap = new Map(
+        _config.providers.map((provider) => [provider.type, provider])
+      )
+      providers.forEach((provider) => providerMap.set(provider.type, provider))
+      _config.providers = Array.from(providerMap.values())
+    },
+    setChains(chains: ExtendedChain[]) {
+      const rpcUrls = chains.reduce((rpcUrls, chain) => {
+        if (chain.metamask?.rpcUrls?.length) {
+          rpcUrls[chain.id as ChainId] = chain.metamask.rpcUrls
+        }
+        return rpcUrls
+      }, {} as RPCUrls)
+      this.setRPCUrls(rpcUrls)
+      _config.chains = chains
+      _loading = undefined
+    },
+    async getChains() {
+      if (_loading) {
+        await _loading
+      }
+      return _config.chains
+    },
+    async getChainById(chainId: ChainId) {
+      if (_loading) {
+        await _loading
+      }
+      const chain = _config.chains?.find((chain) => chain.id === chainId)
+      if (!chain) {
+        throw new Error(`ChainId ${chainId} not found`)
+      }
+      return chain
+    },
+    setRPCUrls(rpcUrls: RPCUrls) {
+      for (const rpcUrlsKey in rpcUrls) {
+        const chainId = rpcUrlsKey as unknown as ChainId
+        const urls = rpcUrls[chainId]
+        if (!urls?.length) {
+          continue
+        }
+        if (!_config.rpcUrls[chainId]?.length) {
+          _config.rpcUrls[chainId] = Array.from(urls)
+        } else {
+          _config.rpcUrls[chainId]?.push(...urls)
+        }
+      }
+    },
+    async getRPCUrls() {
+      if (_loading) {
+        await _loading
+      }
+      return _config.rpcUrls
+    },
+  }
+})()

package/src/constants.ts

@@ -0,0 +1,4 @@
+export const AddressZero = '0x0000000000000000000000000000000000000000'
+export const AlternativeAddressZero =
+  '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'
+export const wrappedSolAddress = 'So11111111111111111111111111111111111111112'

package/src/core/BaseStepExecutor.ts

@@ -0,0 +1,40 @@
+import type { LiFiStep } from '@lifi/types'
+import { StatusManager } from './StatusManager.js'
+import type {
+  ExecutionOptions,
+  InteractionSettings,
+  StepExecutor,
+  StepExecutorOptions,
+} from './types.js'
+
+// Please be careful when changing the defaults as it may break the behavior (e.g., background execution)
+const defaultInteractionSettings = {
+  allowInteraction: true,
+  allowUpdates: true,
+  allowExecution: true,
+}
+
+export abstract class BaseStepExecutor implements StepExecutor {
+  protected executionOptions?: ExecutionOptions
+  protected statusManager: StatusManager
+
+  public allowUserInteraction = true
+  public allowExecution = true
+
+  constructor(options: StepExecutorOptions) {
+    this.statusManager = new StatusManager(options.routeId)
+    this.executionOptions = options.executionOptions
+  }
+
+  setInteraction = (settings?: InteractionSettings): void => {
+    const interactionSettings = {
+      ...defaultInteractionSettings,
+      ...settings,
+    }
+    this.allowUserInteraction = interactionSettings.allowInteraction
+    this.statusManager.allowUpdates(interactionSettings.allowUpdates)
+    this.allowExecution = interactionSettings.allowExecution
+  }
+
+  abstract executeStep(step: LiFiStep): Promise<LiFiStep>
+}

package/src/core/EVM/EVM.ts

@@ -0,0 +1,47 @@
+import { ChainType } from '@lifi/types'
+import { isAddress } from 'viem'
+import type { StepExecutorOptions } from '../types.js'
+import { EVMStepExecutor } from './EVMStepExecutor.js'
+import { getENSAddress } from './getENSAddress.js'
+import { getEVMBalance } from './getEVMBalance.js'
+import type { EVMProvider, EVMProviderOptions } from './types.js'
+
+export function EVM(options?: EVMProviderOptions): EVMProvider {
+  const _options: EVMProviderOptions = options ?? {}
+  return {
+    get type() {
+      return ChainType.EVM
+    },
+    get multisig() {
+      return _options.multisig
+    },
+    isAddress,
+    resolveAddress: getENSAddress,
+    getBalance: getEVMBalance,
+    async getStepExecutor(
+      options: StepExecutorOptions
+    ): Promise<EVMStepExecutor> {
+      if (!_options.getWalletClient) {
+        throw new Error(`getWalletClient is not provided.`)
+      }
+
+      const walletClient = await _options.getWalletClient()
+
+      const executor = new EVMStepExecutor({
+        walletClient,
+        multisig: _options.multisig,
+        routeId: options.routeId,
+        executionOptions: {
+          ...options.executionOptions,
+          switchChainHook:
+            _options.switchChain ?? options.executionOptions?.switchChainHook,
+        },
+      })
+
+      return executor
+    },
+    setOptions(options: EVMProviderOptions) {
+      Object.assign(_options, options)
+    },
+  }
+}