0xtrails 0.13.2 → 0.14.0

package/src/widget/utils/historyFilters.ts

@@ -1,157 +0,0 @@
-import type { IntentTransaction } from "../../transactions.js"
-
-export type HistoryFilterType =
-  | "all"
-  | "executing"
-  | "succeeded"
-  | "failed"
-  | "aborted"
-  | "refunded"
-  | "invalid"
-  | "committed"
-  | "quoted"
-  | "onramp"
-
-const HISTORY_STATUS_DESCRIPTIONS: Partial<
-  Record<HistoryFilterType | string, string>
-> = {
-  all: "Show every transaction in your history.",
-  succeeded: "Completed successfully and delivered the intended result.",
-  executing:
-    "Accepted and currently being processed onchain or by the backend.",
-  failed: "Execution was attempted but ended in a terminal error.",
-  aborted: "Stopped before completion and will not continue automatically.",
-  refunded: "Funds were returned after the original flow could not complete.",
-  invalid: "Rejected because the request or intent data was not valid.",
-  committed: "Saved and ready to execute, but execution has not started yet.",
-  quoted: "A quote was created, but the intent has not been committed yet.",
-  onramp: "Show onramp transactions such as card or exchange funding flows.",
-  pending: "Still waiting for the next status update.",
-  on_hold: "Temporarily paused until a prerequisite is met.",
-  mining: "Submitted onchain and waiting to be mined.",
-  relaying: "Being relayed between chains or systems.",
-  sent: "Submitted to the network and awaiting confirmation.",
-  errored: "Encountered an unexpected error.",
-  unknown: "Status is not available yet.",
-}
-
-export const HISTORY_FILTER_OPTIONS: Array<{
-  key: HistoryFilterType
-  label: string
-  activeClass: string
-  tooltip?: string
-}> = [
-  {
-    key: "all",
-    label: "All",
-    activeClass:
-      "bg-gray-200 dark:bg-gray-600 text-gray-800 dark:text-gray-200",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.all,
-  },
-  {
-    key: "succeeded",
-    label: "Succeeded",
-    activeClass:
-      "bg-green-50 dark:bg-green-900/20 text-green-600 dark:text-green-400 hover:bg-green-50 dark:hover:bg-green-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.succeeded,
-  },
-  {
-    key: "executing",
-    label: "Executing",
-    activeClass:
-      "bg-blue-50 dark:bg-blue-900/20 text-blue-600 dark:text-blue-400 hover:bg-blue-50 dark:hover:bg-blue-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.executing,
-  },
-  {
-    key: "failed",
-    label: "Failed",
-    activeClass:
-      "bg-red-50 dark:bg-red-900/20 text-red-600 dark:text-red-400 hover:bg-red-50 dark:hover:bg-red-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.failed,
-  },
-  {
-    key: "aborted",
-    label: "Aborted",
-    activeClass:
-      "bg-red-50 dark:bg-red-900/20 text-red-600 dark:text-red-400 hover:bg-red-50 dark:hover:bg-red-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.aborted,
-  },
-  {
-    key: "refunded",
-    label: "Refunded",
-    activeClass:
-      "bg-amber-50 dark:bg-amber-900/20 text-amber-600 dark:text-amber-400 hover:bg-amber-50 dark:hover:bg-amber-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.refunded,
-  },
-  {
-    key: "invalid",
-    label: "Invalid",
-    activeClass:
-      "bg-orange-50 dark:bg-orange-900/20 text-orange-600 dark:text-orange-400 hover:bg-orange-50 dark:hover:bg-orange-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.invalid,
-  },
-  {
-    key: "committed",
-    label: "Committed",
-    activeClass:
-      "bg-teal-50 dark:bg-teal-900/20 text-teal-600 dark:text-teal-400 hover:bg-teal-50 dark:hover:bg-teal-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.committed,
-  },
-  {
-    key: "quoted",
-    label: "Quoted",
-    activeClass:
-      "bg-gray-200 dark:bg-gray-600 text-gray-800 dark:text-gray-200",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.quoted,
-  },
-  {
-    key: "onramp",
-    label: "Onramp",
-    activeClass:
-      "bg-purple-50 dark:bg-purple-900/20 text-purple-600 dark:text-purple-400 hover:bg-purple-50 dark:hover:bg-purple-900/20",
-    tooltip: HISTORY_STATUS_DESCRIPTIONS.onramp,
-  },
-]
-
-const INTENT_FILTERS = new Set<HistoryFilterType>([
-  "executing",
-  "succeeded",
-  "failed",
-  "aborted",
-  "refunded",
-  "invalid",
-  "committed",
-  "quoted",
-])
-
-export function getIntentStatuses(
-  filter: HistoryFilterType,
-): string[] | undefined {
-  return INTENT_FILTERS.has(filter) ? [filter.toUpperCase()] : undefined
-}
-
-export function matchesIntentHistoryFilter(
-  transaction: IntentTransaction,
-  filter: HistoryFilterType,
-): boolean {
-  if (filter === "all") return true
-  if (filter === "onramp") return false
-
-  return transaction.intentStatus?.toUpperCase() === filter.toUpperCase()
-}
-
-export function getHistoryEmptyMessage(filter: HistoryFilterType): string {
-  return filter === "all"
-    ? "No transactions found."
-    : filter === "onramp"
-      ? "No onramp transactions found. Buy crypto to see them here."
-      : filter === "succeeded"
-        ? "No completed transactions yet."
-        : `No ${filter} transactions.`
-}
-
-export function getHistoryStatusDescription(
-  status?: string,
-): string | undefined {
-  return status ? HISTORY_STATUS_DESCRIPTIONS[status.toLowerCase()] : undefined
-}

package/src/widget/utils/historyUtils.ts

@@ -1,101 +0,0 @@
-import type { Intent, IntentTransaction } from "../../index.js"
-
-/**
- * Maps Intent from API to IntentTransaction format for display
- */
-export function mapIntentToTransaction(
-  intent: Intent,
-  originTokenInfo?: { symbol: string; name: string; decimals: number } | null,
-  destinationTokenInfo?: {
-    symbol: string
-    name: string
-    decimals: number
-  } | null,
-  getTokenImageUrl?: (params: {
-    chainId: number
-    contractAddress?: string
-    symbol?: string
-  }) => string,
-): IntentTransaction {
-  // Normalize status to uppercase
-  const normalizeStatus = (status?: string): string => {
-    return status?.toUpperCase() || "UNKNOWN"
-  }
-
-  // Extract actual token info from the intent response, using resolved token info if available
-  // Only create token objects if we have valid token addresses (not empty strings)
-  const originToken =
-    intent.quoteRequest?.originTokenAddress &&
-    intent.quoteRequest.originTokenAddress !== ""
-      ? {
-          symbol: originTokenInfo?.symbol || "TOKEN",
-          name: originTokenInfo?.name || "Token",
-          decimals:
-            originTokenInfo?.decimals ||
-            intent.depositTransaction?.decimals ||
-            18,
-          imageUrl: getTokenImageUrl
-            ? getTokenImageUrl({
-                chainId: intent.originChainId,
-                contractAddress: intent.quoteRequest.originTokenAddress,
-                symbol: originTokenInfo?.symbol,
-              })
-            : "",
-          chainId: intent.originChainId,
-          address: intent.quoteRequest.originTokenAddress,
-        }
-      : undefined
-
-  const destinationToken =
-    intent.quoteRequest?.destinationTokenAddress &&
-    intent.quoteRequest.destinationTokenAddress !== ""
-      ? {
-          symbol: destinationTokenInfo?.symbol || "TOKEN",
-          name: destinationTokenInfo?.name || "Token",
-          decimals: destinationTokenInfo?.decimals || 18,
-          imageUrl: getTokenImageUrl
-            ? getTokenImageUrl({
-                chainId: intent.destinationChainId,
-                contractAddress: intent.quoteRequest.destinationTokenAddress,
-                symbol: destinationTokenInfo?.symbol,
-              })
-            : "",
-          chainId: intent.destinationChainId,
-          address: intent.quoteRequest.destinationTokenAddress,
-        }
-      : undefined
-
-  return {
-    originIntentAddress: intent.originIntentAddress,
-    destinationIntentAddress: intent.destinationIntentAddress || "",
-    mainSigner: intent.ownerAddress,
-    intentId: intent.intentId,
-    metaTxnId:
-      intent.originMetaTxn?.id ||
-      intent.destinationMetaTxn?.id ||
-      intent.intentId,
-    txnHash: undefined,
-    executionStatus: normalizeStatus(intent.status),
-    originChainId: intent.originChainId,
-    destinationChainId: intent.destinationChainId,
-    originTokenAddress: intent.quoteRequest?.originTokenAddress,
-    originTokenAmount: intent.quoteRequest?.originTokenAmount
-      ? String(intent.quoteRequest.originTokenAmount)
-      : intent.depositTransaction?.amount
-        ? String(intent.depositTransaction.amount)
-        : "0",
-    destinationTokenAddress: intent.quoteRequest?.destinationTokenAddress,
-    destinationTokenAmount: intent.quoteRequest?.destinationTokenAmount
-      ? String(intent.quoteRequest.destinationTokenAmount)
-      : intent.quote?.toAmount
-        ? String(intent.quote.toAmount)
-        : "0",
-    destinationToAddress:
-      intent.quoteRequest?.destinationToAddress || intent.ownerAddress,
-    createdAt: intent.createdAt,
-    originToken,
-    destinationToken,
-    originTransactionHash: undefined,
-    destinationTransactionHash: undefined,
-  }
-}

package/src/widget/utils/localeStore.ts

@@ -1,68 +0,0 @@
-/**
- * Singleton store for locale preference that can be accessed from non-React contexts
- * This is used by utility functions that need locale information but can't use React hooks
- */
-class LocaleStore {
-  private static instance: LocaleStore
-  private locale: string | null = null
-  private listeners: Set<(locale: string | null) => void> = new Set()
-
-  private constructor() {
-    // Load from localStorage on initialization
-    try {
-      const stored =
-        typeof window !== "undefined" &&
-        typeof localStorage !== "undefined" &&
-        typeof localStorage.getItem === "function"
-          ? localStorage.getItem("trails-locale-preference")
-          : null
-      this.locale = stored
-    } catch (error) {
-      console.warn("Failed to load locale from localStorage:", error)
-    }
-  }
-
-  static getInstance(): LocaleStore {
-    if (!LocaleStore.instance) {
-      LocaleStore.instance = new LocaleStore()
-    }
-    return LocaleStore.instance
-  }
-
-  setLocale(locale: string | null) {
-    this.locale = locale
-    this.notifyListeners()
-  }
-
-  getLocale(): string | null {
-    return this.locale
-  }
-
-  getEffectiveLocale(): string {
-    if (this.locale) {
-      return this.locale
-    }
-
-    // Fallback to browser locale
-    if (typeof navigator !== "undefined" && navigator.language) {
-      return navigator.language
-    }
-
-    return "en-US"
-  }
-
-  subscribe(listener: (locale: string | null) => void) {
-    this.listeners.add(listener)
-    return () => {
-      this.listeners.delete(listener)
-    }
-  }
-
-  private notifyListeners() {
-    this.listeners.forEach((listener) => {
-      listener(this.locale)
-    })
-  }
-}
-
-export const localeStore = LocaleStore.getInstance()

package/src/widget/utils/meldProviderUtils.ts

@@ -1,26 +0,0 @@
-import type { MeldServiceProvider } from "@0xtrails/api/onramp"
-
-import { addressEqual } from "../../utils/address.js"
-
-/**
- * Get provider logo URL from cached providers list
- */
-export function getProviderImage(
-  providers: MeldServiceProvider[],
-  serviceProvider?: string,
-): string {
-  if (!serviceProvider) return ""
-
-  // Find provider in the cached list
-  const providerInfo = providers.find((p) =>
-    addressEqual(p.serviceProvider, serviceProvider),
-  )
-
-  return (
-    providerInfo?.logos?.light ||
-    providerInfo?.logos?.dark ||
-    providerInfo?.logos?.lightShort ||
-    providerInfo?.logos?.darkShort ||
-    ""
-  )
-}

package/src/widget/utils/meshSupportedTokens.ts

@@ -1,28 +0,0 @@
-import type { MeshSupportedToken } from "@0xtrails/api/onramp"
-
-export function getMatchingMeshSupportedTokens(
-  supportedTokens: MeshSupportedToken[],
-  chainId?: number | null,
-  symbol?: string | null,
-): MeshSupportedToken[] {
-  if (!chainId || !symbol) {
-    return []
-  }
-
-  const normalizedSymbol = symbol.toUpperCase()
-  return supportedTokens.filter(
-    (token) =>
-      Number(token.chainId) === chainId &&
-      token.symbol?.toUpperCase() === normalizedSymbol,
-  )
-}
-
-export function isMeshAssetSupported(
-  supportedTokens: MeshSupportedToken[],
-  chainId?: number | null,
-  symbol?: string | null,
-): boolean {
-  return (
-    getMatchingMeshSupportedTokens(supportedTokens, chainId, symbol).length > 0
-  )
-}

package/src/widget/utils/onrampConfig.ts

@@ -1,15 +0,0 @@
-export type MeshOnrampConfig = {
-  mesh?: {
-    enabled?: boolean
-    environment?: "sandbox" | "production"
-    mode?: "sandbox" | "production"
-    sandbox?: boolean
-    exchanges?: string[]
-  }
-}
-
-export function getActiveMeshEnvironment(
-  config?: MeshOnrampConfig | null,
-): "sandbox" | "production" {
-  return config?.mesh?.environment ?? "production"
-}

package/src/widget/utils/statusLabel.ts

@@ -1,3 +0,0 @@
-export function formatRawStatusLabel(status?: string): string {
-  return status?.toLowerCase() || "unknown"
-}

package/src/widget/utils/tokens.ts

@@ -1,138 +0,0 @@
-import type { Token } from "../../tokens.js"
-import { zeroAddress } from "viem"
-import { isNativeToken, addressEqual } from "../../utils/address.js"
-
-/**
- * Finds a supported token by contract address and optionally chain ID.
- * Performs case-insensitive address comparison.
- *
- * @param supportedTokens - Array of supported tokens to search
- * @param tokenAddress - Token contract address to find (can be zeroAddress for native tokens)
- * @param chainId - Optional chain ID to match. If not provided, returns first match across all chains
- * @returns The matching token, or undefined if not found
- */
-export function findSupportedToken(
-  supportedTokens: Token[] | undefined,
-  tokenAddress: string | undefined | null,
-  chainId?: number | null,
-): Token | undefined {
-  if (!supportedTokens || !tokenAddress) {
-    return undefined
-  }
-
-  return supportedTokens.find((token) => {
-    const tokenAddressMatch =
-      addressEqual(token.contractAddress, tokenAddress) ||
-      (isNativeToken(tokenAddress) &&
-        (addressEqual(token.contractAddress, zeroAddress) ||
-          token.isNativeToken))
-
-    if (chainId !== undefined && chainId !== null) {
-      return tokenAddressMatch && token.chainId === chainId
-    }
-
-    return tokenAddressMatch
-  })
-}
-
-/**
- * Finds a supported token by symbol and optionally chain ID.
- *
- * @param supportedTokens - Array of supported tokens to search
- * @param symbol - Token symbol to find (case-insensitive)
- * @param chainId - Optional chain ID to match. If not provided, returns first match across all chains
- * @returns The matching token, or undefined if not found
- *
- * @example
- * ```ts
- * const token = findSupportedTokenBySymbol(supportedTokens, "USDC", 1)
- * // Returns USDC on Ethereum
- * ```
- */
-export function findSupportedTokenBySymbol(
-  supportedTokens: Token[] | undefined,
-  symbol: string | undefined | null,
-  chainId?: number | null,
-): Token | undefined {
-  if (!supportedTokens || !symbol) {
-    return undefined
-  }
-
-  const normalizedSymbol = symbol.toUpperCase()
-
-  return supportedTokens.find((token) => {
-    const symbolMatch = token.symbol?.toUpperCase() === normalizedSymbol
-
-    if (chainId !== undefined && chainId !== null) {
-      return symbolMatch && token.chainId === chainId
-    }
-
-    return symbolMatch
-  })
-}
-
-/**
- * Finds a supported token by address or symbol and optionally chain ID.
- * First tries to match by address, then falls back to symbol matching.
- *
- * @param supportedTokens - Array of supported tokens to search
- * @param tokenAddressOrSymbol - Token contract address or symbol to find
- * @param chainId - Optional chain ID to match. If not provided, returns first match across all chains
- * @returns The matching token, or undefined if not found
- *
- * @example
- * ```ts
- * const token = findSupportedTokenByAddressOrSymbol(supportedTokens, "USDC", 1)
- * // Returns USDC on Ethereum
- *
- * const token2 = findSupportedTokenByAddressOrSymbol(supportedTokens, "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", 1)
- * // Returns USDC on Ethereum by address
- * ```
- */
-export function findSupportedTokenByAddressOrSymbol(
-  supportedTokens: Token[] | undefined,
-  tokenAddressOrSymbol: string | undefined | null,
-  chainId?: number | null,
-): Token | undefined {
-  if (!supportedTokens || !tokenAddressOrSymbol) {
-    return undefined
-  }
-
-  // Check if it's an address (starts with 0x and is longer than 5 chars)
-  const isAddress =
-    tokenAddressOrSymbol.startsWith("0x") && tokenAddressOrSymbol.length > 5
-
-  if (isAddress) {
-    return findSupportedToken(supportedTokens, tokenAddressOrSymbol, chainId)
-  }
-
-  return findSupportedTokenBySymbol(
-    supportedTokens,
-    tokenAddressOrSymbol,
-    chainId,
-  )
-}
-
-/**
- * Finds the first supported token on a specific chain.
- *
- * @param supportedTokens - Array of supported tokens to search
- * @param chainId - Chain ID to match
- * @returns The first matching token on the chain, or undefined if not found
- *
- * @example
- * ```ts
- * const token = findFirstSupportedTokenOnChain(supportedTokens, 1)
- * // Returns first token on Ethereum
- * ```
- */
-export function findFirstSupportedTokenOnChain(
-  supportedTokens: Token[] | undefined,
-  chainId: number | null | undefined,
-): Token | undefined {
-  if (!supportedTokens || chainId === undefined || chainId === null) {
-    return undefined
-  }
-
-  return supportedTokens.find((token) => token.chainId === chainId)
-}

package/src/widget/utils/trailsOnrampConfig.ts

@@ -1,39 +0,0 @@
-import type { TrailsOnRampConfig } from "../../onramp/TrailsOnRampProvider.js"
-import { normalizeTrailsOnrampConfig } from "../../onramp/trailsOnramp.js"
-
-export type WidgetOnrampConfig = {
-  mesh?: {
-    environment?: "sandbox" | "production"
-    exchanges?: string[]
-    clientId?: string
-    sandbox?: boolean
-    sandboxEnabled?: boolean
-    productionEnabled?: boolean
-    mode?: "sandbox" | "production"
-  }
-  environment?: "sandbox" | "production"
-  apiKey?: string
-  jwt?: string
-  hostname?: string
-  clientId?: string
-}
-
-type OnrampFactoryWithConfig = {
-  trailsOnrampConfig?: WidgetOnrampConfig
-}
-
-export function getWidgetOnrampConfig(
-  onramp?: unknown,
-): WidgetOnrampConfig | undefined {
-  if (!onramp) {
-    return normalizeTrailsOnrampConfig({ mesh: {} })
-  }
-
-  if (typeof onramp === "function") {
-    return normalizeTrailsOnrampConfig(
-      (onramp as OnrampFactoryWithConfig | undefined)?.trailsOnrampConfig,
-    )
-  }
-
-  return normalizeTrailsOnrampConfig(onramp as TrailsOnRampConfig)
-}

package/src/widget/utils/transactionFailure.ts

@@ -1,52 +0,0 @@
-import type { TransactionState } from "../../transactions.js"
-
-export const hasFailedTransaction = (tx: TransactionState): boolean => {
-  const hasFailedState = tx.state === "failed"
-  const hasFailureEvent = tx.decodedGuestModuleEvents?.some(
-    (event) => event.type === "CallFailed",
-  )
-  return hasFailedState || Boolean(hasFailureEvent)
-}
-
-export const hasAbortedTransaction = (tx: TransactionState): boolean => {
-  const hasAbortedState = tx.state === "aborted"
-  const hasAbortedEvent = tx.decodedGuestModuleEvents?.some(
-    (event) => event.type === "CallAborted",
-  )
-  return hasAbortedState || Boolean(hasAbortedEvent)
-}
-
-/**
- * Returns true when a transaction should be treated as failed in widget UI.
- *
- * A transaction is considered failed if:
- * - its lifecycle state is `failed` or `aborted`, or
- * - decoded guest module events include `CallFailed` or `CallAborted`.
- */
-export function hasFailedOrAbortedTransaction(
-  tx?: TransactionState | null,
-): boolean {
-  if (!tx) return false
-
-  const hasFailedState = tx.state === "failed" || tx.state === "aborted"
-  const hasFailureEvent = tx.decodedGuestModuleEvents?.some(
-    (event) => event.type === "CallFailed" || event.type === "CallAborted",
-  )
-
-  return hasFailedState || Boolean(hasFailureEvent)
-}
-
-/**
- * Returns true when any transaction in the list is failed or aborted.
- *
- * This is used for screen-level decisions (for example, showing failure CTAs
- * or rendering the receipt in failure state) so pending/receipt logic stays
- * consistent across components.
- */
-export function hasAnyFailedOrAbortedTransactions(
-  transactionStates?: TransactionState[] | null,
-): boolean {
-  return Boolean(
-    transactionStates?.some((tx) => hasFailedOrAbortedTransaction(tx)),
-  )
-}

package/src/widget/utils/viewManagerGuards.ts

@@ -1,49 +0,0 @@
-import type { Screen } from "../hooks/useViewManager.js"
-
-const DISCONNECTED_ALLOWED_SCREENS = new Set<Screen>([
-  "connect",
-  "wallet-connect",
-  "wallet-connection-pending",
-  "wallet-list",
-])
-
-const COMMITTED_INTENT_SCREENS = new Set<Screen>([
-  "wallet-confirmation",
-  "onramp-confirmation",
-])
-
-const PRESERVE_TRANSFER_FLOW_SCREENS = new Set<Screen>([
-  "direct-transfer-screen",
-  "wallet-confirmation",
-  "onramp-confirmation",
-  "onramp-mesh",
-  "pending",
-  "receipt",
-])
-
-export function shouldRedirectToConnect(
-  isConnected: boolean,
-  screen: Screen,
-): boolean {
-  return !isConnected && !DISCONNECTED_ALLOWED_SCREENS.has(screen)
-}
-
-export function shouldClearTransferFlowOnNavigate(
-  from: Screen,
-  to: Screen,
-): boolean {
-  return (
-    (from === "direct-transfer-screen" &&
-      to !== "pending" &&
-      to !== "receipt" &&
-      to !== "qr-code-wallet-select") ||
-    (from === "fund-form" && !PRESERVE_TRANSFER_FLOW_SCREENS.has(to))
-  )
-}
-
-export function shouldCleanupStoredIntentOnClose(
-  intentId: string | null | undefined,
-  screen: Screen,
-): intentId is string {
-  return Boolean(intentId) && COMMITTED_INTENT_SCREENS.has(screen)
-}