0xtrails 0.5.0 → 0.6.0

package/src/chains.ts

@@ -1,5 +1,7 @@
 import { useQuery } from "@tanstack/react-query"
-import type { Chain as ViemChain } from "viem"
+import type { Chain as ViemChain, PublicClient } from "viem"
+import { createPublicClient, http } from "viem"
+import { getConfig } from "./config.js"
 
 import {
   arbitrum,
@@ -147,6 +149,41 @@ export const getRpcUrl = (
   return `${sequenceRpcUrls[chainId]}/${sequenceProjectAccessKey}`
 }
 
+/**
+ * Get HTTP transport for a chain using Sequence RPC URLs
+ * This is a temporary solution to use global config for RPC URLs
+ * @param chainId - The chain ID to get the transport for
+ * @returns Viem HTTP transport configured with Sequence RPC URL if available
+ */
+export function getHttpTransport(chainId: number) {
+  const config = getConfig()
+  const trailsApiKey = config.trailsApiKey
+  const sequenceNodeGatewayUrl = config.sequenceNodeGatewayUrl
+
+  if (trailsApiKey && sequenceNodeGatewayUrl) {
+    const rpcUrl = getRpcUrl(chainId, trailsApiKey, sequenceNodeGatewayUrl)
+    if (rpcUrl) {
+      return http(rpcUrl)
+    }
+  }
+
+  // Fallback to default http() if Sequence RPC URL is not available
+  return http()
+}
+
+/**
+ * Create a public RPC client for a chain using Sequence RPC URLs
+ * This is a temporary solution to use global config for RPC URLs
+ * @param chain - The chain to create the public client for
+ * @returns Viem PublicClient configured with Sequence RPC URL if available
+ */
+export function getPublicRpcClient(chain: Chain): PublicClient {
+  return createPublicClient({
+    chain,
+    transport: getHttpTransport(chain.id),
+  })
+}
+
 export const supportedSequenceChains: Record<number, Chain> = {
   [apeChain.id]: getChainInfo(apeChain.id)!,
   [arbitrum.id]: getChainInfo(arbitrum.id)!,
@@ -280,30 +317,67 @@ export async function getSupportedSequenceChains(): Promise<Chain[]> {
   return Object.values(supportedSequenceChains)
 }
 
-export async function getSupportedSequenceTestnetChains(): Promise<Chain[]> {
-  return Object.values(supportedSequenceTestnetChains)
+// Chain order for sorting (in the desired display order)
+const CHAIN_ORDER = [
+  1, // Ethereum
+  8453, // Base
+  42161, // Arbitrum
+  137, // Polygon
+  747474, // Katana
+  56, // BNB Smart Chain
+  10, // Optimism
+  43114, // Avalanche
+  42170, // Arbitrum Nova
+  42793, // Etherlink
+  100, // Gnosis
+  8333, // B3
+  33139, // Ape Chain
+  1868, // Soneium
+  5031, // Somnia
+  660279, // Xai
+]
+
+// Mapping of chain ID to normalized display name
+const CHAIN_NAME_MAP: Record<number, string> = {
+  [arbitrum.id]: "Arbitrum", // Rename from "Arbitrum One"
+  [optimism.id]: "Optimism", // Rename from "OP Mainnet"
+  [soneium.id]: "Soneium", // Rename from "Soneium Mainnet"
+  [xai.id]: "Xai", // Rename from "Xai Mainnet"
 }
 
-// Priority chains that should appear first in the list
-const PRIORITY_CHAIN_IDS = [1, 8453, 42161, 10, 137]
+/**
+ * Gets the normalized display name for a chain.
+ * @param chainId - The chain ID
+ * @param originalName - The original chain name from viem
+ * @returns The normalized chain name
+ */
+export function getNormalizedChainName(
+  chainId: number,
+  originalName: string,
+): string {
+  return CHAIN_NAME_MAP[chainId] || originalName
+}
 
-// Sort function for chains with priority order and then by name
-function sortChains(chainList: Chain[]): Chain[] {
+/**
+ * Sorts chains by the predefined order, then alphabetically for chains not in the order.
+ * @param chainList - The list of chains to sort
+ * @returns The sorted list of chains
+ */
+export function sortChainsByOrder(chainList: Chain[]): Chain[] {
   return chainList.sort((a, b) => {
-    // 1. Priority chains first (1, 8453, 42161, 10, 137)
-    const aPriority = PRIORITY_CHAIN_IDS.indexOf(a.id)
-    const bPriority = PRIORITY_CHAIN_IDS.indexOf(b.id)
+    const aIndex = CHAIN_ORDER.indexOf(a.id)
+    const bIndex = CHAIN_ORDER.indexOf(b.id)
 
-    // If both are priority chains, sort by priority order
-    if (aPriority !== -1 && bPriority !== -1) {
-      return aPriority - bPriority
+    // If both chains are in the order, sort by their position
+    if (aIndex !== -1 && bIndex !== -1) {
+      return aIndex - bIndex
     }
 
-    // If only one is a priority chain, prioritize it
-    if (aPriority !== -1) return -1
-    if (bPriority !== -1) return 1
+    // If only one chain is in the order, prioritize it
+    if (aIndex !== -1) return -1
+    if (bIndex !== -1) return 1
 
-    // 2. Sort by chain name alphabetically
+    // If neither chain is in the order, sort alphabetically
     return a.name.localeCompare(b.name)
   })
 }
@@ -345,10 +419,8 @@ export async function getSupportedChains({
     (chain, index, self) => index === self.findIndex((c) => c.id === chain.id),
   )
 
-  const sortedChains = sortChains(uniqueChains)
-
-  // Sort chains by priority and then by name
-  return sortedChains
+  // Sort chains by predefined order
+  return sortChainsByOrder(uniqueChains)
 }
 
 export function useSupportedChains({
@@ -378,21 +450,3 @@ export function getIsTestnetChainId(chainId: number): boolean {
   const testnetChainIds = Object.keys(supportedSequenceTestnetChains)
   return testnetChainIds.includes(chainId.toString())
 }
-
-// Get chain color for UI styling
-export function getChainColor(chainId: number): string {
-  switch (chainId) {
-    case 1:
-      return "bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200" // More gray-blue for Ethereum
-    case 8453:
-      return "bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200" // Blue for Base
-    case 42161:
-      return "bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200"
-    case 137:
-      return "bg-purple-100 text-purple-800 dark:bg-purple-900 dark:text-purple-200"
-    case 10:
-      return "bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200"
-    default:
-      return "bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200"
-  }
-}

package/src/config.ts

@@ -1,8 +1,8 @@
 import {
   PROD_SEQUENCE_INDEXER_URL,
+  PROD_SEQUENCE_METADATA_URL,
   DEFAULT_WALLETCONNECT_PROJECT_ID,
   DEFAULT_SLIPPAGE_TOLERANCE,
-  PROD_SEQUENCE_PROJECT_ACCESS_KEY,
   PROD_SEQUENCE_NODE_GATEWAY_URL,
   PROD_TRAILS_API_URL,
 } from "./constants.js"
@@ -14,6 +14,7 @@ export interface TrailsConfig {
   trailsApiUrl?: string
   sequenceIndexerUrl?: string
   sequenceNodeGatewayUrl?: string
+  sequenceMetadataUrl?: string
   walletConnectProjectId?: string
   slippageTolerance?: string
   debug?: boolean
@@ -21,9 +22,10 @@ export interface TrailsConfig {
 }
 
 const globalConfig: TrailsConfig = {
-  trailsApiKey: PROD_SEQUENCE_PROJECT_ACCESS_KEY,
+  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,
@@ -31,15 +33,23 @@ const globalConfig: TrailsConfig = {
   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,
-  )
+  // 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() {
@@ -75,6 +85,14 @@ export function getDebug() {
   return globalConfig.debug || getQueryParam("debug") === "true"
 }
 
+/**
+ * Sets the global debug mode for backward compatibility with getDebug()
+ * This is called by TrailsProvider to sync the debug state
+ */
+export function setGlobalDebug(debug: boolean) {
+  globalConfig.debug = debug
+}
+
 /**
  * @deprecated Use TrailsProvider context instead
  */

package/src/constants.ts

@@ -29,12 +29,9 @@ export const ATTESATION_SIGNER_ADDRESS: Address.Address =
 
 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"
 
-// This is used for Sequence Indexer and API
-export const PROD_SEQUENCE_PROJECT_ACCESS_KEY =
-  "AQAAAAAAAKhGHJc3N5V2AWqfJ1v9xZ2u0nA"
-
 export const DATABEAT_SERVER = "https://databeat.sequence.app"
 export const DATABEAT_KEY =
   "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHAiOiJzZXEtdHJhaWxzIiwiZXhwIjoyMDI4MTIwOTg4fQ.KZIjEziul_nZ4kjEXudvfqeWmVekc5ftXKx_EqDrmZU"

package/src/contractUtils.ts

@@ -1,12 +1,12 @@
-import { createPublicClient, http } from "viem"
-import { getChainInfo } from "./chains.js"
+import { getChainInfo, getPublicRpcClient } from "./chains.js"
 import { logger } from "./logger.js"
 
 export async function getIsContract(address: `0x${string}`, chainId: number) {
-  const client = createPublicClient({
-    chain: getChainInfo(chainId)!,
-    transport: http(),
-  })
+  const chainInfo = getChainInfo(chainId)
+  if (!chainInfo) {
+    throw new Error(`Chain ${chainId} not found`)
+  }
+  const client = getPublicRpcClient(chainInfo)
 
   const code = await client.getCode({ address })
   const isNonZero = isNonZeroHexString(code)

package/src/estimate.ts

@@ -1,5 +1,5 @@
-import { type PublicClient, formatUnits, createPublicClient, http } from "viem"
-import { getChainInfo } from "./chains.js"
+import { type PublicClient, formatUnits } from "viem"
+import { getChainInfo, getPublicRpcClient } from "./chains.js"
 import { logger } from "./logger.js"
 
 // Default minimum gas limit for deposit transactions
@@ -360,10 +360,7 @@ export async function getDefaultGasCostEstimate(
       try {
         const chain = getChainInfo(chainId)
         if (chain) {
-          const publicClient = createPublicClient({
-            chain,
-            transport: http(),
-          })
+          const publicClient = getPublicRpcClient(chain)
 
           // Try to estimate gas if we have transaction details
           let gasLimit = DEFAULT_MIN_GASLIMIT

package/src/fees.ts

@@ -58,10 +58,9 @@ export async function extractTrailsFeeBreakdown(
     return null
   }
 
-  // Get chain IDs from the calls array to determine origin and destination chains
-  const calls = intent?.calls || []
-  const originChainId: number | undefined = calls[0]?.chainId // First call is origin chain
-  const destinationChainId: number | undefined = calls[1]?.chainId // Second call is destination chain
+  // Get chain IDs from origin and destination calls
+  const originChainId = intent.quoteRequest.originChainId
+  const destinationChainId = intent.quoteRequest.destinationChainId
 
   // Use the origin and destination gas fees
   const originChainQuote = fees.originGas
@@ -84,8 +83,7 @@ export async function extractTrailsFeeBreakdown(
   // Extract origin relay fee if available
   if (originChainQuote && originChainId !== undefined) {
     const originTokenSymbol = originChainQuote.nativeTokenSymbol || "ETH"
-    const originChainIdNum =
-      typeof originChainId === "bigint" ? Number(originChainId) : originChainId
+    const originChainIdNum = originChainId
     const nativeTokenAddress = zeroAddress
 
     breakdown.originRelayFee = {
@@ -106,10 +104,7 @@ export async function extractTrailsFeeBreakdown(
   if (destinationChainQuote && destinationChainId !== undefined) {
     const destinationTokenSymbol =
       destinationChainQuote.nativeTokenSymbol || "ETH"
-    const destinationChainIdNum =
-      typeof destinationChainId === "bigint"
-        ? Number(destinationChainId)
-        : destinationChainId
+    const destinationChainIdNum = destinationChainId
     const nativeTokenAddress = zeroAddress
 
     breakdown.destinationRelayFee = {

package/src/gasless.ts

@@ -597,3 +597,48 @@ export async function signIntent({
 
   return { signature, v, r, s }
 }
+
+/**
+ * Calculates the byte length of a hex signature string.
+ * @param signature - The signature (hex string with or without 0x prefix)
+ * @returns The number of bytes in the signature
+ */
+function getSignatureBytes(signature: string): number {
+  return signature.startsWith("0x")
+    ? (signature.length - 2) / 2
+    : signature.length / 2
+}
+
+/**
+ * Validates that a signature is exactly 65 bytes (standard ECDSA signature length).
+ * @param signature - The signature to validate (hex string with or without 0x prefix)
+ * @returns true if signature is 65 bytes, false otherwise
+ */
+export function isValidGaslessSignature(signature: string): boolean {
+  // Standard ECDSA signatures are 65 bytes (32 bytes r + 32 bytes s + 1 byte v)
+  // Smart contract wallets return longer signatures which are not supported
+  return getSignatureBytes(signature) === 65
+}
+
+/**
+ * Validates that a signature is exactly 65 bytes and throws an appropriate error if invalid.
+ * @param signature - The signature to validate (hex string with or without 0x prefix)
+ * @throws Error if signature is not 65 bytes
+ */
+export function validateGaslessSignature(signature: string): void {
+  const signatureBytes = getSignatureBytes(signature)
+
+  if (signatureBytes !== 65) {
+    if (signatureBytes > 65) {
+      throw new Error(
+        "Smart contract wallets are not supported for gasless transfers at the moment. " +
+          "Please use an EOA (Externally Owned Account) wallet for gasless transactions.",
+      )
+    } else {
+      throw new Error(
+        `Invalid signature length: expected 65 bytes, got ${signatureBytes} bytes. ` +
+          "The signature may be malformed.",
+      )
+    }
+  }
+}

package/src/index.ts

@@ -10,6 +10,7 @@ export {
   useSupportedChains,
   getChainInfo,
   getAllChains,
+  getRpcUrl,
   type Chain,
 } from "./chains.js"
 export { useIndexerGatewayClient } from "./indexerClient.js"
@@ -42,20 +43,20 @@ export type {
   TransactionState,
   IntentTransaction,
   IntentTransactionHistoryResponse,
-  GetIntentTransactionHistoryParams,
   TransactionHistoryResponse,
   GetAccountTransactionHistoryParams,
   UseAccountTransactionHistoryParams,
   UseAccountTransactionHistoryReturn,
-  UseIntentTransactionHistoryParams,
-  UseIntentTransactionHistoryReturn,
 } from "./transactions.js"
 export {
-  getIntentTransactionHistory,
   getAccountTransactionHistory,
   useAccountTransactionHistory,
-  useIntentTransactionHistory,
 } from "./transactions.js"
+export { useIntentTransactionHistory } from "./widget/hooks/useIntentTransactionHistory.js"
+export type {
+  UseIntentTransactionHistoryParams,
+  UseIntentTransactionHistoryReturn,
+} from "./widget/hooks/useIntentTransactionHistory.js"
 export {
   getAccountTotalBalanceUsd,
   getHasSufficientBalanceToken,
@@ -74,6 +75,7 @@ export {
   getSupportedTokens,
   useSupportedTokens,
   useTokenList,
+  useGetTokenImageUrl,
 } from "./tokens.js"
 export type { SupportedToken } from "./tokens.js"
 export { getTxTimeDiff } from "./transactions.js"
@@ -83,7 +85,6 @@ export { TRAILS_ROUTER_PLACEHOLDER_AMOUNT } from "./trailsRouter.js"
 export { getERC20TransferData } from "./encoders.js"
 // Config functions - getters are deprecated, use TrailsProvider context instead
 export {
-  getConfig,
   getSlippageTolerance,
   getDebug,
   getCommitHash,

package/src/indexerClient.ts

@@ -28,7 +28,7 @@ export type IndexerGatewayConfig = {
  * Get the indexer URL for a specific chain slug
  * Dynamically determines the environment prefix by parsing the base indexer URL
  * @param chainSlug - The chain slug (e.g., "arbitrum", "base")
- * @param baseIndexerUrl - Optional base indexer URL. If not provided, uses getConfig("sequenceIndexerUrl")
+ * @param baseIndexerUrl -Indexer URL
  * @returns The chain-specific indexer URL with appropriate environment prefix
  */
 export function getIndexerUrlFromChainSlug(
@@ -67,7 +67,7 @@ export function getIndexerUrlFromChainSlug(
  * Get the chain-specific indexer URL by chain ID
  * Returns the appropriate indexer URL based on the current environment
  * @param chainId - The chain ID
- * @param baseIndexerUrl - Optional base indexer URL. If not provided, uses getConfig("sequenceIndexerUrl")
+ * @param baseIndexerUrl - Indexer URL
  */
 export function getChainIndexerUrl(
   chainId: number,