0xtrails 0.13.2 → 0.14.0

package/src/config.ts

@@ -1,118 +0,0 @@
-import {
-  PROD_SEQUENCE_INDEXER_URL,
-  PROD_SEQUENCE_METADATA_URL,
-  DEFAULT_WALLETCONNECT_PROJECT_ID,
-  DEFAULT_SLIPPAGE_TOLERANCE,
-  PROD_SEQUENCE_NODE_GATEWAY_URL,
-  PROD_TRAILS_API_URL,
-} from "./constants.js"
-
-export interface TrailsConfig {
-  trailsApiKey: string
-  trailsApiUrl?: string
-  trailsAppUrl?: string
-  sequenceIndexerUrl?: string
-  sequenceNodeGatewayUrl?: string
-  sequenceMetadataUrl?: string
-  walletConnectProjectId?: string
-  slippageTolerance?: string
-  debug?: boolean
-  commitHash?: string
-}
-
-const globalConfig: TrailsConfig = {
-  trailsApiKey: "",
-  sequenceIndexerUrl: PROD_SEQUENCE_INDEXER_URL,
-  sequenceNodeGatewayUrl: PROD_SEQUENCE_NODE_GATEWAY_URL,
-  sequenceMetadataUrl: PROD_SEQUENCE_METADATA_URL,
-  trailsApiUrl: PROD_TRAILS_API_URL,
-  walletConnectProjectId: DEFAULT_WALLETCONNECT_PROJECT_ID,
-  slippageTolerance: DEFAULT_SLIPPAGE_TOLERANCE,
-  debug: false,
-  commitHash: undefined,
-}
-
-// Set commit hash after globalConfig is initialized to avoid circular init issues.
-globalConfig.commitHash = declareCommitHash()
-
-/**
- * Updates the global config with new values
- * This is a temporary solution to sync config from TrailsProvider
- */
-export function updateGlobalConfig(updates: Partial<TrailsConfig>) {
-  Object.assign(globalConfig, updates)
-}
-
-// DEPRECATED: Use TrailsProvider context instead
-// This is kept only for backward compatibility during migration
-export function getConfig<T extends keyof TrailsConfig | undefined = undefined>(
-  propName?: T,
-): T extends undefined ? Readonly<TrailsConfig> : TrailsConfig[NonNullable<T>] {
-  // console.warn(
-  //   "[trails-sdk] getConfig is deprecated. Use TrailsProvider context with useTrails() hook instead.",
-  //   propName,
-  // )
-  return (propName ? globalConfig[propName] : globalConfig) as any
-}
-export function declareCommitHash() {
-  const cfPagesCommitHash = getEnvVar("CF_PAGES_COMMIT_SHA")
-  const viteCommitHash = getEnvVar("VITE_COMMIT_SHA")
-  // Use console.log directly to avoid circular-dep TDZ crash:
-  // config.ts imports logger.ts which imports config.ts — when this function
-  // runs at module-init time (line 38), `logger` is still uninitialised.
-  if (cfPagesCommitHash) {
-    console.log(
-      `[trails-sdk][config] commit hash from CF_PAGES_COMMIT_SHA: ${cfPagesCommitHash}`,
-    )
-  }
-  if (viteCommitHash) {
-    console.log(
-      `[trails-sdk][config] commit hash from VITE_COMMIT_SHA: ${viteCommitHash}`,
-    )
-  }
-  return cfPagesCommitHash || viteCommitHash
-}
-
-// DEPRECATED: These getter functions are kept for backward compatibility
-// New code should use TrailsProvider context with useTrails() hook
-
-/**
- * @deprecated Use TrailsProvider context instead
- */
-export function getSlippageTolerance() {
-  return globalConfig.slippageTolerance
-}
-
-/**
- * @deprecated Use TrailsProvider context instead
- */
-export function getCommitHash() {
-  return globalConfig.commitHash
-}
-
-export function getEnvVar(name: string) {
-  // In Vite/browser environments, check import.meta.env first
-  // This is where Vite injects environment variables at build time
-  if ((import.meta as any)?.env) {
-    // Check for VITE_ prefixed version first (Vite convention)
-    const vitePrefixed = (import.meta as any).env[`VITE_${name}`]
-    if (vitePrefixed !== undefined && vitePrefixed !== "") {
-      return vitePrefixed
-    }
-    // Check direct name (for variables injected via vite.config.ts define)
-    const direct = (import.meta as any).env[name]
-    if (direct !== undefined && direct !== "") {
-      return direct
-    }
-  }
-
-  // Fall back to process.env for Node.js environments
-  if (typeof process !== "undefined" && process?.env) {
-    const value = process.env[name]
-    if (value !== undefined && value !== "") {
-      return value
-    }
-  }
-
-  return undefined
-}

package/src/constants.ts

@@ -1,239 +0,0 @@
-import type { TrailsAddressOverrides } from "@0xtrails/api"
-import {
-  Context as SequenceContext,
-  Constants as SequenceConstants,
-} from "@0xsequence/wallet-primitives"
-import type { Address } from "ox"
-import type { Token } from "./tokens.js"
-
-// Sequence Wallet V3 `rc-5` contract addresses
-export const SEQUENCE_V3_CONTRACT_ADDRESSES: SequenceContext.Context & {
-  guestModule?: Address.Address
-} = {
-  ...SequenceContext.Rc5,
-  guestModule: SequenceConstants.DefaultGuestAddress,
-}
-
-export const SEQUENCE_V3_CONTRACT_ADDRESSES_OVERRIDES: TrailsAddressOverrides =
-  {
-    sequenceWalletFactoryAddress: SEQUENCE_V3_CONTRACT_ADDRESSES.factory,
-    sequenceWalletMainModuleAddress: SEQUENCE_V3_CONTRACT_ADDRESSES.stage1,
-    sequenceWalletMainModuleUpgradableAddress:
-      SEQUENCE_V3_CONTRACT_ADDRESSES.stage2,
-    sequenceWalletGuestModuleAddress:
-      SEQUENCE_V3_CONTRACT_ADDRESSES.guestModule,
-  }
-
-type TrailsContracts = {
-  trailsUtilsAddress: `0x${string}`
-  trailsIntentEntrypointAddress: `0x${string}`
-  trailsRouterAddress: `0x${string}`
-  trailsRouterShimAddress: `0x${string}`
-}
-
-// Trails contract addresses
-export const TRAILS_CONTRACTS: TrailsContracts = {
-  trailsUtilsAddress: "0x000000004f702C8398e158108937814d074cD74b",
-  trailsIntentEntrypointAddress: "0x91E9e3Fe369CF005dB2857Ef24955A66d1E692Cf",
-  trailsRouterAddress: "0xBaE357CBAA04a68cbfD5a560Ab06C4E9A3328A90",
-  trailsRouterShimAddress: "0xde04013becF982866A04d928A6df25e0D1FAaA71",
-}
-
-export const PROD_SEQUENCE_NODE_GATEWAY_URL = "https://nodes.sequence.app"
-export const PROD_SEQUENCE_INDEXER_URL = "https://indexer.sequence.app"
-export const PROD_SEQUENCE_METADATA_URL = "https://metadata.sequence.app"
-export const PROD_TRAILS_API_URL = "https://trails-api.sequence.app"
-export const PROD_TRAILS_APP_URL = "https://app.trails.build"
-
-// NOTE: sequence api is not used, however we pass through this context to
-// the sequence hooks config in the case of a double nesting of context
-// when trails is used inside of the sequence wallet app.
-export const PROD_SEQUENCE_API_URL = "https://api.sequence.app"
-
-export const PROD_KEYMACHINE_URL = "https://keymachine.sequence.app"
-
-export const DATABEAT_SERVER = "https://databeat.sequence.app"
-export const DATABEAT_KEY =
-  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHAiOiJzZXEtdHJhaWxzIiwiZXhwIjoyMDI4MTIwOTg4fQ.KZIjEziul_nZ4kjEXudvfqeWmVekc5ftXKx_EqDrmZU"
-
-export const DEFAULT_WALLETCONNECT_PROJECT_ID =
-  "10c5ac56159da00924d110c07c3f6e3a"
-
-export const SITE_URL = "https://trails.build/"
-export const TRAILS_SUPPORT_URL = "https://support.trails.build/"
-
-export const DEFAULT_SLIPPAGE_TOLERANCE = "0.05" // 0.001 = 0.1%, 0.005 = 0.5%, 0.03 = 3%, 0.05 = 5%
-
-// AUTO slippage mode - backend will calculate optimal slippage based on transaction amount and routing
-export const SLIPPAGE_AUTO = "auto"
-export const DEFAULT_SLIPPAGE_MODE = SLIPPAGE_AUTO
-
-export const DEFAULT_MODE = "pay"
-export const DEFAULT_THEME = "light"
-
-// Note: We should add this on the API side.
-export const FIAT_CURRENCY_SYMBOLS = {
-  EUR: "€",
-  GBP: "£",
-  CHF: "CHF",
-  NOK: "kr",
-  SEK: "kr",
-  DKK: "kr",
-  ISK: "kr",
-  PLN: "zł",
-  CZK: "Kč",
-  HUF: "Ft",
-  RON: "lei",
-  BGN: "лв",
-  HRK: "kn",
-  RSD: "Дин.",
-  UAH: "₴",
-  RUB: "₽",
-  BYN: "Br",
-  TRY: "₺",
-  GEL: "₾",
-  AMD: "֏",
-  AZN: "₼",
-  MDL: "MDL",
-  ALL: "Lek",
-  MKD: "ден",
-  BAM: "KM",
-  USD: "$",
-  CAD: "$",
-  MXN: "$",
-  BRL: "R$",
-  ARS: "$",
-  CLP: "$",
-  COP: "$",
-  PEN: "S/.",
-  VES: "Bs",
-  VEF: "Bs",
-  UYU: "$U",
-  PYG: "Gs",
-  BOB: "$b",
-  GTQ: "Q",
-  HNL: "L",
-  NIO: "C$",
-  CRC: "₡",
-  PAB: "B/.",
-  DOP: "RD$",
-  JMD: "J$",
-  TTD: "TT$",
-  BBD: "$",
-  BZD: "BZ$",
-  GYD: "$",
-  SRD: "$",
-  BSD: "$",
-  BMD: "$",
-  KYD: "$",
-  XCD: "$",
-  AWG: "ƒ",
-  ANG: "ƒ",
-  CUP: "₱",
-  SVC: "$",
-  CNY: "¥",
-  JPY: "¥",
-  KRW: "₩",
-  KPW: "₩",
-  INR: "₹",
-  IDR: "Rp",
-  MYR: "RM",
-  SGD: "$",
-  THB: "฿",
-  VND: "₫",
-  PHP: "₱",
-  PKR: "₨",
-  BDT: "৳",
-  LKR: "₨",
-  NPR: "₨",
-  MMK: "K",
-  KHR: "៛",
-  LAK: "₭",
-  MNT: "₮",
-  KZT: "лв",
-  UZS: "лв",
-  KGS: "лв",
-  TJS: "SM",
-  TWD: "NT$",
-  HKD: "$",
-  MOP: "MOP$",
-  BND: "$",
-  AUD: "$",
-  NZD: "$",
-  FJD: "$",
-  WST: "WS$",
-  VUV: "VT",
-  SBD: "$",
-  TVD: "$",
-  AED: "د.إ",
-  SAR: "﷼",
-  QAR: "﷼",
-  KWD: "KD",
-  BHD: "BD",
-  OMR: "﷼",
-  JOD: "JD",
-  ILS: "₪",
-  EGP: "£",
-  MAD: "DH",
-  TND: "DT",
-  DZD: "DA",
-  LBP: "£",
-  IQD: "ع.د",
-  SYP: "£",
-  YER: "﷼",
-  IRR: "﷼",
-  LYD: "LD",
-  SDG: "ج.س",
-  ZAR: "R",
-  NGN: "₦",
-  KES: "KSh",
-  GHS: "¢",
-  TZS: "TSh",
-  UGX: "USh",
-  ETB: "Br",
-  XOF: "CFA",
-  XAF: "FCFA",
-  AOA: "Kz",
-  MZN: "MT",
-  ZMW: "ZK",
-  BWP: "P",
-  MUR: "₨",
-  SCR: "₨",
-  MGA: "Ar",
-  RWF: "FRw",
-  CDF: "FC",
-  DJF: "Fdj",
-  GNF: "FG",
-  SLL: "Le",
-  GMD: "D",
-  CVE: "Esc",
-  ERN: "Nfk",
-  LSL: "L",
-  SZL: "E",
-  NAD: "$",
-  MWK: "MK",
-  SSP: "SSP",
-  ZWD: "Z$",
-  LRD: "$",
-  SOS: "S",
-  AFN: "؋",
-  GIP: "£",
-  FKP: "£",
-  SHP: "£",
-  GGP: "£",
-  IMP: "£",
-  JEP: "£",
-}
-
-export const USDC_BASE: Token = {
-  chainId: 8453,
-  chainName: "Base",
-  contractAddress: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
-  decimals: 6,
-  imageUrl:
-    "https://assets.sequence.info/images/tokens/large/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.webp",
-  isNativeToken: false,
-  name: "USDC",
-  symbol: "USDC",
-  tokenId: "USDC-Base",
-}

package/src/contractUtils.ts

@@ -1,46 +0,0 @@
-import type { PublicClient } from "viem"
-import { getChainRpcClient } from "./chains.js"
-import { logger } from "./logger.js"
-
-export async function getIsContract(
-  address: `0x${string}`,
-  chainId: number,
-  publicClient?: PublicClient,
-) {
-  const client = publicClient ?? getChainRpcClient(chainId)
-
-  const code = await client.getCode({ address })
-  const isNonZero = isNonZeroHexString(code)
-  const is7702 = is7702ContractCode(code)
-  const isContract = isNonZero && !is7702
-
-  logger.console.log(
-    "[trails-sdk] getIsContract:",
-    address,
-    "chainId:",
-    chainId,
-    "isContract:",
-    isContract,
-  )
-
-  return isContract
-}
-
-export function is7702ContractCode(hex: string | undefined): boolean {
-  return hex?.startsWith("0xef0100") || false
-}
-
-export function isNonZeroHexString(hex: string | undefined): boolean {
-  return (
-    hex !== undefined &&
-    hex !== "" &&
-    hex !== "0" &&
-    hex !== "0x" &&
-    hex !== "0x0" &&
-    hex !== "0x00"
-  )
-}
-
-export function getIsCustomCalldata(calldata: string | undefined): boolean {
-  return isNonZeroHexString(calldata)
-}

package/src/cssUtils.ts

@@ -1,5 +0,0 @@
-export function cssObjectToString(vars: Record<string, string>) {
-  return Object.entries(vars)
-    .map(([key, value]) => `${key}: ${value};`)
-    .join("\n")
-}

package/src/customChains.ts

@@ -1,24 +0,0 @@
-// Custom chain definition for Somnia
-export const somnia = {
-  id: 5031,
-  name: "Somnia",
-  nativeCurrency: {
-    decimals: 18,
-    name: "SOMI",
-    symbol: "SOMI",
-  },
-  rpcUrls: {
-    default: {
-      http: ["https://api.infra.mainnet.somnia.network"],
-    },
-    public: {
-      http: ["https://api.infra.mainnet.somnia.network"],
-    },
-  },
-  blockExplorers: {
-    default: {
-      name: "Somnia Explorer",
-      url: "https://explorer.somnia.network/",
-    },
-  },
-} as const

package/src/customTokens.ts

@@ -1,168 +0,0 @@
-import { useState, useCallback } from "react"
-import type { Token } from "./tokens.js"
-import { logger } from "./logger.js"
-
-import { addressEqual, normalizeAddress } from "./utils/address.js"
-const cacheVersion = "01"
-
-// Custom tokens storage key
-const CUSTOM_TOKENS_KEY = `trails-sdk:custom-tokens:${cacheVersion}`
-
-// Custom tokens storage utilities
-function getCustomTokensFromStorage(): Token[] {
-  if (typeof window === "undefined") return []
-
-  try {
-    const cached = localStorage.getItem(CUSTOM_TOKENS_KEY)
-    if (!cached) return []
-
-    const parsed = JSON.parse(cached) as Token[]
-    // Validate that it's an array
-    if (!Array.isArray(parsed)) {
-      logger.console.warn(
-        "[trails-sdk] Invalid custom tokens format in localStorage, clearing",
-      )
-      localStorage.removeItem(CUSTOM_TOKENS_KEY)
-      return []
-    }
-
-    // Validate each token has required fields
-    return parsed.filter((token) => {
-      const isValid =
-        token &&
-        typeof token.contractAddress === "string" &&
-        typeof token.symbol === "string" &&
-        typeof token.name === "string" &&
-        typeof token.decimals === "number"
-      if (!isValid) {
-        logger.console.warn(
-          "[trails-sdk] Invalid custom token found, skipping:",
-          token,
-        )
-      }
-      return isValid
-    }) as Token[]
-  } catch (error) {
-    logger.console.error(
-      "[trails-sdk] Error reading custom tokens from localStorage:",
-      error,
-    )
-    // Clear corrupted data
-    try {
-      localStorage.removeItem(CUSTOM_TOKENS_KEY)
-    } catch {
-      // Ignore errors when clearing
-    }
-    return []
-  }
-}
-
-function saveCustomTokensToStorage(tokens: Token[]): void {
-  if (typeof window === "undefined") return
-
-  try {
-    localStorage.setItem(CUSTOM_TOKENS_KEY, JSON.stringify(tokens))
-  } catch (error) {
-    logger.console.error(
-      "[trails-sdk] Error saving custom tokens to localStorage:",
-      error,
-    )
-    // Handle quota exceeded error gracefully
-    if (error instanceof DOMException && error.name === "QuotaExceededError") {
-      logger.console.warn(
-        "[trails-sdk] localStorage quota exceeded, cannot save custom tokens",
-      )
-    }
-  }
-}
-
-/**
- * Hook to manage custom tokens stored in localStorage
- * Custom tokens persist across sessions and are merged with supported tokens
- */
-export function useCustomTokens(): {
-  customTokens: Token[]
-  addCustomToken: (token: Token) => void
-  removeCustomToken: (chainId: number, contractAddress: string) => void
-  clearCustomTokens: () => void
-} {
-  const [customTokens, setCustomTokens] = useState<Token[]>(() => {
-    return getCustomTokensFromStorage()
-  })
-
-  const addCustomToken = useCallback((token: Token) => {
-    setCustomTokens((prev) => {
-      // Check if token already exists (same chainId + contractAddress)
-      const tokenKey = `${token.chainId || 0}-${normalizeAddress(token.contractAddress)}`
-      const existingIndex = prev.findIndex(
-        (t) =>
-          `${t.chainId || 0}-${normalizeAddress(t.contractAddress)}` ===
-          tokenKey,
-      )
-
-      // Ensure isCustomToken is set to true
-      const tokenWithFlag = { ...token, isCustomToken: true }
-
-      let updated: Token[]
-      if (existingIndex >= 0) {
-        const existingToken = prev[existingIndex]
-        if (!existingToken) {
-          return prev
-        }
-
-        // Avoid unnecessary state updates when token payload is unchanged.
-        const isSameTokenData =
-          existingToken.symbol === tokenWithFlag.symbol &&
-          existingToken.name === tokenWithFlag.name &&
-          existingToken.decimals === tokenWithFlag.decimals &&
-          (existingToken.chainId || 0) === (tokenWithFlag.chainId || 0) &&
-          normalizeAddress(existingToken.contractAddress) ===
-            normalizeAddress(tokenWithFlag.contractAddress) &&
-          existingToken.chainName === tokenWithFlag.chainName &&
-          existingToken.imageUrl === tokenWithFlag.imageUrl &&
-          existingToken.isCustomToken === true
-
-        if (isSameTokenData) {
-          return prev
-        }
-
-        // Update existing token
-        updated = [...prev]
-        updated[existingIndex] = tokenWithFlag
-      } else {
-        // Add new token
-        updated = [...prev, tokenWithFlag]
-      }
-
-      saveCustomTokensToStorage(updated)
-      return updated
-    })
-  }, [])
-
-  const removeCustomToken = useCallback(
-    (chainId: number, contractAddress: string) => {
-      setCustomTokens((prev) => {
-        const updated = prev.filter(
-          (t) =>
-            t.chainId !== chainId ||
-            !addressEqual(t.contractAddress, contractAddress),
-        )
-        saveCustomTokensToStorage(updated)
-        return updated
-      })
-    },
-    [],
-  )
-
-  const clearCustomTokens = useCallback(() => {
-    setCustomTokens([])
-    saveCustomTokensToStorage([])
-  }, [])
-
-  return {
-    customTokens,
-    addCustomToken,
-    removeCustomToken,
-    clearCustomTokens,
-  }
-}