0xtrails 0.6.6 → 0.7.0

package/src/index.ts

@@ -4,6 +4,17 @@ export {
   InsufficientBalanceError,
   UserRejectionError,
   getIsUserRejectionError,
+  getIsBalanceTooLowError,
+  getIsApiError,
+  getIsRateLimitedError,
+  getIsRequiredAmountNotMetError,
+  getIsNoAvailableQuoteError,
+  getIsQuoteFailedError,
+  getIsQuoteTokenError,
+  getIsQuoteInputError,
+  getIsInsufficientLiquidityError,
+  getIsWalletAlreadyConnectedError,
+  getPrettifiedErrorMessage,
 } from "./error.js"
 export {
   getSupportedChains,
@@ -41,6 +52,12 @@ export type {
   SwapReturn,
   Quote,
 } from "./prepareSend.js"
+export { useTrailsSendTransaction } from "./widget/hooks/useTrailsSendTransaction.js"
+export type {
+  UseTrailsSendTransactionParameters,
+  UseTrailsSendTransactionReturnType,
+  TrailsSendTransactionVariables,
+} from "./widget/hooks/useTrailsSendTransaction.js"
 export type {
   TransactionState,
   IntentTransaction,
@@ -71,26 +88,28 @@ export {
 export type {
   NativeTokenBalance,
   TokenBalance,
-  TokenBalanceExtended,
 } from "./tokenBalances.js"
 export {
   getSupportedTokens,
   useSupportedTokens,
   useTokenList,
   useGetTokenImageUrl,
+  useTokenAddress,
+  useTokenInfo,
+  convertApiTokenInfoToToken,
 } from "./tokens.js"
-export type { SupportedToken } from "./tokens.js"
+export type { Token } from "./tokens.js"
+export {
+  formatBalanceFields,
+  formatUsdFields,
+  formatPriceFields,
+  formatUsdAmountFormatted,
+} from "./tokenBalances.js"
 export { getTxTimeDiff } from "./transactions.js"
 export { useCommitIntent, useExecuteIntent } from "./mutations.js"
 export type { Mode } from "./mode.js"
 export { TRAILS_ROUTER_PLACEHOLDER_AMOUNT } from "./trailsRouter.js"
 export { getERC20TransferData } from "./encoders.js"
-// Config functions - getters are deprecated, use TrailsProvider context instead
-export {
-  getSlippageTolerance,
-  getDebug,
-  getCommitHash,
-} from "./config.js"
 export * from "./widget/index.js"
 export { TrailsProvider } from "./widget/providers/TrailsProvider.js"
 export type {
@@ -116,4 +135,5 @@ export type {
   Intent,
   ExecuteIntentRequest,
   ExecuteIntentResponse,
-} from "@0xsequence/trails-api"
+  TrailsContracts,
+} from "@0xtrails/api"

package/src/indexerClient.ts

@@ -16,6 +16,7 @@ import {
   bsc,
   etherlink,
   katana,
+  monad,
 } from "viem/chains"
 
 export type IndexerGatewayConfig = {
@@ -92,6 +93,7 @@ export function getChainIndexerUrl(
     421613: "arbitrum-nova-sepolia",
     [etherlink.id]: "etherlink",
     [katana.id]: "katana",
+    [monad.id]: "monad",
   }
 
   const chainSlug = chainIdToSlug[chainId]

package/src/intentReceiptMonitor.ts

@@ -1,8 +1,5 @@
 import type { TrailsClient } from "./trailsClient.js"
-import type {
-  IntentReceipt,
-  WaitIntentReceiptResponse,
-} from "@0xsequence/trails-api"
+import type { IntentReceipt, WaitIntentReceiptResponse } from "@0xtrails/api"
 import { type Query, useQuery } from "@tanstack/react-query"
 import { logger } from "./logger.js"
 

package/src/intentReceiptPoller.ts

@@ -3,11 +3,11 @@ import type {
   IntentReceipt,
   WaitIntentReceiptResponse,
   TransactionStatus,
-} from "@0xsequence/trails-api"
+} from "@0xtrails/api"
 import { logger } from "./logger.js"
 
 const POLL_INTERVAL = 150 // 150 ms
-const MAX_WAIT_TIME = 5 * 60 * 1000 // 5 minutes
+const MAX_WAIT_TIME = 15 * 60 * 1000 // 15 minutes
 
 /**
  * Callback invoked when the deposit transaction hash is discovered (for gasless flows).

package/src/intents.ts

@@ -7,8 +7,9 @@ import type {
   ExecuteIntentRequest,
   GasFeeOptions,
   DepositSignature,
-} from "@0xsequence/trails-api"
-import { JsonEncode } from "@0xsequence/trails-api"
+  TrailsContracts,
+} from "@0xtrails/api"
+import { JsonEncode } from "@0xtrails/api"
 import type { TrailsClient } from "./trailsClient.js"
 import { logger } from "./logger.js"
 
@@ -21,7 +22,10 @@ import {
   type WalletClient,
 } from "viem"
 import { getChainInfo, getChainRpcClient } from "./chains.js"
-import { SEQUENCE_V3_CONTRACT_ADDRESSES } from "./constants.js"
+import {
+  SEQUENCE_V3_CONTRACT_ADDRESSES,
+  TRAILS_CONTRACTS,
+} from "./constants.js"
 import {
   trackTransactionStarted,
   trackTransactionSubmitted,
@@ -119,7 +123,11 @@ export async function quoteIntent(
   trailsClient: TrailsApi,
   args: QuoteIntentRequest,
   additionalTrackingProps: Record<string, string> = {},
-): Promise<{ intent: Intent; gasFeeOptions?: GasFeeOptions }> {
+): Promise<{
+  intent: Intent
+  gasFeeOptions?: GasFeeOptions
+  trailsContracts?: TrailsContracts
+}> {
   // Track intent quote request
   trackIntentQuoteRequested({
     originChainId: args.originChainId || 0,
@@ -383,7 +391,10 @@ export async function commitIntent(
     })
 
     // Commit the intent that was returned from quoteIntent
-    const response = await trailsClient.commitIntent({ intent })
+    const response = await trailsClient.commitIntent({
+      intent,
+      trailsContracts: TRAILS_CONTRACTS,
+    })
 
     // Track successful intent commit
     trackIntentCommitCompleted({

package/src/mode.ts

@@ -1 +1 @@
-export type Mode = "pay" | "fund" | "earn" | "swap" | "receive"
+export type Mode = "pay" | "fund" | "earn" | "swap"

package/src/mutations.ts

@@ -1,8 +1,9 @@
 import { useMutation } from "@tanstack/react-query"
-import type { Intent, DepositSignature } from "@0xsequence/trails-api"
+import type { Intent, DepositSignature } from "@0xtrails/api"
 import { useTrailsClient } from "./trailsClient.js"
 import { logger } from "./logger.js"
 import { getFullErrorMessage } from "./error.js"
+import { TRAILS_CONTRACTS } from "./constants.js"
 import {
   trackIntentCommitStarted,
   trackIntentCommitCompleted,
@@ -12,7 +13,7 @@ import {
   type ExecuteIntentResponse,
   type IntentStatus,
   IntentStatusError,
-} from "@0xsequence/trails-api"
+} from "@0xtrails/api"
 
 /**
  * Hook for committing an intent to the Trails API
@@ -46,7 +47,10 @@ export function useCommitIntent() {
         })
 
         // Commit the intent
-        const response = await trailsClient.commitIntent({ intent })
+        const response = await trailsClient.commitIntent({
+          intent,
+          trailsContracts: TRAILS_CONTRACTS,
+        })
 
         logger.console.log("[trails-sdk] useCommitIntent: Commit successful", {
           intentId: intent.intentId,

package/src/prepareSend.ts

@@ -12,6 +12,7 @@ import type { TransactionState } from "./transactions.js"
 import { logger } from "./logger.js"
 import { getIsCustomCalldata } from "./contractUtils.js"
 import { getChainInfo, getChainRpcClient } from "./chains.js"
+import { TRAILS_CONTRACTS } from "./constants.js"
 
 // Import from transactionIntent module
 import {
@@ -22,7 +23,6 @@ import {
   handleCrossChain,
   isSameChain,
   isSameToken,
-  validateCctpDestinationToken,
 } from "./transactionIntent/index.js"
 
 // Re-export types for backward compatibility
@@ -39,7 +39,6 @@ export type {
 export {
   isSameChain,
   isSameToken,
-  validateCctpDestinationToken,
 } from "./transactionIntent/index.js"
 
 export async function prepareSend(
@@ -86,6 +85,8 @@ export async function prepareSend(
     sequenceProjectAccessKey,
     sequenceIndexerUrl,
     isSmartWallet,
+    trailsApiKey,
+    trailsApiUrl,
   } = options
   let { sourceTokenPriceUsd, destinationTokenPriceUsd } = options
 
@@ -139,13 +140,6 @@ export async function prepareSend(
     throw new Error("Recipient address cannot be zero address")
   }
 
-  // Validate CCTP destination token requirement
-  validateCctpDestinationToken(
-    destinationTokenAddress,
-    destinationChainId,
-    quoteProvider,
-  )
-
   let effectiveDestinationAddress = recipient
   let effectiveDestinationCalldata = destinationCalldata
 
@@ -189,6 +183,7 @@ export async function prepareSend(
       destinationChainId,
       originTokenAddress,
       destinationTokenAddress,
+      trailsRouterAddress: TRAILS_CONTRACTS.trailsRouterAddress,
     })
 
     if (wrapResult) {
@@ -247,18 +242,28 @@ export async function prepareSend(
   }
 
   // Track payment start
+  // For EXACT_INPUT, swapAmount is the origin amount, not destination amount
+  // We don't know the destination amount yet until we get the quote
+  // For EXACT_OUTPUT, swapAmount is the destination amount, so it's correct
+  // For EXACT_OUTPUT, we don't know the origin amount until we get the quote
   trackPaymentStarted({
     userAddress: account.address,
     originChainId,
     destinationChainId,
     originTokenAddress,
+    originTokenAmount:
+      tradeType === TradeType.EXACT_INPUT ? swapAmount : undefined,
+    originTokenDecimals: sourceTokenDecimals,
     destinationTokenAddress,
     destinationTokenSymbol: destinationTokenSymbol || "",
-    destinationTokenAmount: swapAmount,
+    destinationTokenAmount:
+      tradeType === TradeType.EXACT_OUTPUT ? swapAmount : undefined,
+    destinationTokenDecimals: destinationTokenDecimals,
     mode,
     fundMethod,
     sourceTokenPriceUsd: sourceTokenPriceUsd?.toString(),
     destinationTokenPriceUsd: destinationTokenPriceUsd?.toString(),
+    tradeType: tradeType.toString(),
   })
 
   // Note: Disable this check for now to allow fetching a quote even when the origin balance is zero
@@ -429,6 +434,8 @@ export async function prepareSend(
       sequenceProjectAccessKey,
       sequenceIndexerUrl,
       isSmartWallet,
+      trailsApiKey,
+      trailsApiUrl,
     })
   }
 
@@ -473,6 +480,8 @@ export async function prepareSend(
     sequenceProjectAccessKey,
     sequenceIndexerUrl,
     isSmartWallet,
+    trailsApiKey,
+    trailsApiUrl,
   })
 }
 
@@ -492,10 +501,6 @@ export {
   getSlippageToleranceFromIntent,
   getPriceImpactFromIntent,
   getPriceImpactUsdFromIntent,
-  getFeesFromRelaySdkQuote,
-  getSlippageToleranceFromRelaySdkQuote,
-  getPriceImpactFromRelaySdkQuote,
-  getPriceImpactUsdFromRelaySdkQuote,
   getZeroFees,
   getCompletionEstimateSeconds,
   getNormalizedQuoteObject,

package/src/prices.ts

@@ -1,4 +1,4 @@
-import type { Token, TokenPrice } from "@0xsequence/trails-api"
+import type { Token, TokenPrice } from "@0xtrails/api"
 import { QueryClient, useQuery } from "@tanstack/react-query"
 import { zeroAddress } from "viem"
 import { logger } from "./logger.js"

package/src/sequenceWallet.ts

@@ -439,9 +439,9 @@ export class StaticSigner implements signers.SapientSigner {
 
   constructor(
     private readonly address: string,
-    private readonly signature: string,
+    readonly _signature: string,
   ) {
-    const raw = hexToBytes(this.signature as `0x${string}`)
+    const raw = hexToBytes(this._signature as `0x${string}`)
 
     // Separate last byte as suffix
     this.savedSuffix = raw.slice(-1)

package/src/time.ts

@@ -43,3 +43,31 @@ export const formatRelativeDate = (dateString?: string) => {
     return { relative: null, full: null }
   }
 }
+
+/**
+ * Format completion time estimate in seconds to a human-readable string
+ * @param seconds - The number of seconds for completion estimate
+ * @returns Formatted string like "30s", "5m", "1h30m", etc.
+ */
+export const formatCompletionTime = (seconds: number): string => {
+  if (seconds < 60) {
+    return `${seconds}s`
+  } else if (seconds < 3600) {
+    const minutes = Math.floor(seconds / 60)
+    const remainingSeconds = seconds % 60
+    return remainingSeconds > 0
+      ? `${minutes}m${remainingSeconds}s`
+      : `${minutes}m`
+  } else {
+    const hours = Math.floor(seconds / 3600)
+    const remainingMinutes = Math.floor((seconds % 3600) / 60)
+    const remainingSeconds = seconds % 60
+    if (remainingMinutes > 0 || remainingSeconds > 0) {
+      return `${hours}h${remainingMinutes}m${
+        remainingSeconds > 0 ? `${remainingSeconds}s` : ""
+      }`
+    } else {
+      return `${hours}h`
+    }
+  }
+}