0xtrails 0.1.13 → 0.2.1

package/src/chains.ts

@@ -30,6 +30,7 @@ import {
   soneiumMinato,
   xaiTestnet,
   etherlinkTestnet,
+  somniaTestnet,
 } from "viem/chains"
 import { getRelaySupportedChains } from "./relaySdk.js"
 import { getLifiSupportedChains } from "./lifi.js"
@@ -38,6 +39,7 @@ import {
   getSequenceNodeGatewayUrl,
 } from "./config.js"
 import type { QuoteProvider } from "./intents.js"
+import { somnia } from "./customChains.js"
 
 export function getAllChains(): Chain[] {
   return [
@@ -48,6 +50,7 @@ export function getAllChains(): Chain[] {
     gnosis,
     polygon,
     soneium,
+    somnia,
     xai,
     apeChain,
     arbitrumNova,
@@ -70,6 +73,7 @@ export function getAllChains(): Chain[] {
     soneiumMinato,
     xaiTestnet,
     etherlinkTestnet,
+    somniaTestnet,
   ]
 }
 
@@ -87,6 +91,7 @@ function getSequenceRpcUrls(): Record<number, string> {
     [gnosis.id]: getSequenceRpcUrlFromSlug("gnosis"),
     [polygon.id]: getSequenceRpcUrlFromSlug("polygon"),
     [soneium.id]: getSequenceRpcUrlFromSlug("soneium"),
+    [somnia.id]: getSequenceRpcUrlFromSlug("somnia"),
     [xai.id]: getSequenceRpcUrlFromSlug("xai"),
     [apeChain.id]: getSequenceRpcUrlFromSlug("apechain"),
     [arbitrumNova.id]: getSequenceRpcUrlFromSlug("arbitrum-nova"),
@@ -124,6 +129,7 @@ export const supportedSequenceChains: Record<number, Chain> = {
   [optimism.id]: getChainInfo(optimism.id)!,
   [polygon.id]: getChainInfo(polygon.id)!,
   [soneium.id]: getChainInfo(soneium.id)!,
+  [somnia.id]: getChainInfo(somnia.id)!,
   [xai.id]: getChainInfo(xai.id)!,
   [katana.id]: getChainInfo(katana.id)!,
   [etherlink.id]: getChainInfo(etherlink.id)!,
@@ -143,6 +149,7 @@ export const supportedSequenceTestnetChains: Record<number, Chain> = {
   [soneiumMinato.id]: getChainInfo(soneiumMinato.id)!,
   [xaiTestnet.id]: getChainInfo(xaiTestnet.id)!,
   [etherlinkTestnet.id]: getChainInfo(etherlinkTestnet.id)!,
+  [somniaTestnet.id]: getChainInfo(somniaTestnet.id)!,
 }
 
 export const mainnetChainsToTestnetChains: Record<number, Chain> = {
@@ -161,6 +168,7 @@ export const mainnetChainsToTestnetChains: Record<number, Chain> = {
   [arbitrumNova.id]: arbitrumSepolia,
   [apeChain.id]: sepolia,
   [etherlink.id]: etherlinkTestnet,
+  [somnia.id]: somniaTestnet,
 }
 
 // Helper to get chain info
@@ -189,6 +197,16 @@ export function getChainInfo(
     }
   }
 
+  // Override explorer URLs for specific chains
+  if (chainId === katana.id && chainInfo) {
+    chainInfo.blockExplorers = {
+      default: {
+        name: "Katanascan",
+        url: "https://katanascan.com", // use katanascan instead of explorer.katanarpc.com
+      },
+    }
+  }
+
   return chainInfo
 }
 

package/src/config.ts

@@ -6,20 +6,23 @@ import {
   PROD_SEQUENCE_PROJECT_ACCESS_KEY,
   DEV_SEQUENCE_INDEXER_URL,
   DEV_SEQUENCE_API_URL,
+  DEV_TRAILS_API_URL,
   DEV_SEQUENCE_PROJECT_ACCESS_KEY,
   DEFAULT_SEQUENCE_ENV,
   PROD_SEQUENCE_NODE_GATEWAY_URL,
   DEV_SEQUENCE_NODE_GATEWAY_URL,
+  PROD_TRAILS_API_URL,
 } from "./constants.js"
 import { getQueryParam } from "./queryParams.js"
 
-type SequenceEnv = "prod" | "dev" | "local" | "cors-anywhere"
+export type SequenceEnv = "prod" | "dev" | "local" | "cors-anywhere"
 
 export const globalConfig: {
   sequenceProjectAccessKey: string
   sequenceIndexerUrl: string
   sequenceNodeGatewayUrl: string
   sequenceApiUrl: string
+  trailsApiUrl: string
   sequenceEnv: SequenceEnv
   walletConnectProjectId: string
   slippageTolerance: string
@@ -27,11 +30,12 @@ export const globalConfig: {
   commitHash: string | undefined
 } = {
   commitHash: declareCommitHash(),
+  sequenceEnv: declareSequenceEnv(),
   sequenceProjectAccessKey: declareSequenceProjectAccessKey(),
   sequenceIndexerUrl: declareSequenceIndexerUrl(),
   sequenceNodeGatewayUrl: declareSequenceNodeGatewayUrl(),
   sequenceApiUrl: declareSequenceApiUrl(),
-  sequenceEnv: declareSequenceEnv(),
+  trailsApiUrl: declareTrailsApiUrl(),
   walletConnectProjectId: DEFAULT_WALLETCONNECT_PROJECT_ID,
   slippageTolerance: DEFAULT_SLIPPAGE_TOLERANCE,
   debug: false,
@@ -49,12 +53,18 @@ export function declareSequenceEnv(): SequenceEnv {
     if (getEnvVar("ENV") === "development" || getEnvVar("ENV") === "dev") {
       return "dev"
     }
-    if (
-      getEnvVar("CF_PAGES_BRANCH") === "master" ||
-      getEnvVar("CF_PAGES_BRANCH") === "main" ||
-      getEnvVar("ENV") === "production" ||
-      getEnvVar("ENV") === "prod"
-    ) {
+
+    // Special handling for Cloudflare Pages branches
+    const cfPagesBranch = getEnvVar("CF_PAGES_BRANCH")
+    if (cfPagesBranch) {
+      // If running on Cloudflare Pages, all branches except "production" default to dev
+      if (cfPagesBranch === "prod" || cfPagesBranch === "production") {
+        return "prod"
+      }
+      return "dev"
+    }
+
+    if (getEnvVar("ENV") === "production" || getEnvVar("ENV") === "prod") {
       return "prod"
     }
   }
@@ -74,11 +84,21 @@ export function declareSequenceApiUrl() {
     return PROD_SEQUENCE_API_URL
   }
   if (declareSequenceEnv() === "local") {
-    return getEnvVar("TEST_API_URL") || DEV_SEQUENCE_API_URL
+    return getEnvVar("SEQUENCE_API_URL") || DEV_SEQUENCE_API_URL
   }
   return DEV_SEQUENCE_API_URL
 }
 
+export function declareTrailsApiUrl() {
+  if (declareSequenceEnv() === "prod") {
+    return PROD_TRAILS_API_URL
+  }
+  if (declareSequenceEnv() === "local") {
+    return getEnvVar("TRAILS_API_URL") || DEV_TRAILS_API_URL
+  }
+  return DEV_TRAILS_API_URL
+}
+
 export function declareSequenceNodeGatewayUrl() {
   if (declareSequenceEnv() === "prod") {
     return PROD_SEQUENCE_NODE_GATEWAY_URL
@@ -87,9 +107,21 @@ export function declareSequenceNodeGatewayUrl() {
 }
 
 export function declareSequenceProjectAccessKey() {
-  if (declareSequenceEnv() === "prod") {
+  const sequenceEnv = declareSequenceEnv()
+
+  // Check for explicit env var override
+  if (typeof process !== "undefined") {
+    const envVarKey = getEnvVar("SEQUENCE_PROJECT_ACCESS_KEY")
+    if (envVarKey) {
+      return envVarKey
+    }
+  }
+
+  // Use dev/prod keys based on environment
+  if (sequenceEnv === "prod") {
     return PROD_SEQUENCE_PROJECT_ACCESS_KEY
   }
+
   return DEV_SEQUENCE_PROJECT_ACCESS_KEY
 }
 
@@ -105,6 +137,10 @@ export function declareCommitHash() {
   return cfPagesCommitHash || viteCommitHash
 }
 
+export function getSequenceConfig() {
+  return globalConfig
+}
+
 export function getSequenceProjectAccessKey() {
   return globalConfig.sequenceProjectAccessKey
 }
@@ -137,25 +173,40 @@ export function getSequenceApiUrl() {
   return globalConfig.sequenceApiUrl
 }
 
+export function setTrailsApiUrl(trailsApiUrl: string) {
+  globalConfig.trailsApiUrl = trailsApiUrl
+}
+
+export function getTrailsApiUrl() {
+  return globalConfig.trailsApiUrl
+}
+
 export function setSequenceEnv(sequenceEnv: SequenceEnv) {
   globalConfig.sequenceEnv = sequenceEnv
 
   if (sequenceEnv === "prod") {
     setSequenceIndexerUrl(PROD_SEQUENCE_INDEXER_URL)
     setSequenceApiUrl(PROD_SEQUENCE_API_URL)
+    setTrailsApiUrl(PROD_TRAILS_API_URL)
     setSequenceNodeGatewayUrl(PROD_SEQUENCE_NODE_GATEWAY_URL)
+    setSequenceProjectAccessKey(PROD_SEQUENCE_PROJECT_ACCESS_KEY)
   }
 
   if (sequenceEnv === "local") {
-    if (getEnvVar("API_URL")) {
-      setSequenceApiUrl(getEnvVar("API_URL"))
+    if (getEnvVar("SEQUENCE_API_URL")) {
+      setSequenceApiUrl(getEnvVar("SEQUENCE_API_URL"))
+    }
+    if (getEnvVar("TRAILS_API_URL")) {
+      setTrailsApiUrl(getEnvVar("TRAILS_API_URL"))
     }
   }
 
   if (sequenceEnv === "dev") {
     setSequenceIndexerUrl(DEV_SEQUENCE_INDEXER_URL)
     setSequenceApiUrl(DEV_SEQUENCE_API_URL)
+    setTrailsApiUrl(DEV_TRAILS_API_URL)
     setSequenceNodeGatewayUrl(DEV_SEQUENCE_NODE_GATEWAY_URL)
+    setSequenceProjectAccessKey(DEV_SEQUENCE_PROJECT_ACCESS_KEY)
   }
 }
 
@@ -208,13 +259,8 @@ export function getAccountIntentTransactionHistory() {
   return FeatureFlags.accountIntentTransactionHistory
 }
 
-export function getSameChainSwapDifferentIntentAddresses() {
-  return FeatureFlags.sameChainSwapDifferentIntentAddresses
-}
-
 export const FeatureFlags = {
   accountIntentTransactionHistory: false,
-  sameChainSwapDifferentIntentAddresses: false,
 }
 
 export function getEnvVar(name: string) {

package/src/constants.ts

@@ -1,3 +1,4 @@
+import type { AddressOverrides } from "@0xsequence/trails-api"
 import type { Context as ContextLike } from "@0xsequence/wallet-primitives"
 
 export const SEQUENCE_V3_CONTRACT_ADDRESSES: ContextLike.Context = {
@@ -8,34 +9,39 @@ export const SEQUENCE_V3_CONTRACT_ADDRESSES: ContextLike.Context = {
     "0x6041600e3d396021805130553df33d3d36153402601f57363d3d373d363d30545af43d82803e903d91601f57fd5bf3" as `0x${string}`,
 }
 
-export const TRAILS_BALANCE_INJECTOR_ADDRESS =
-  "0x9eCA6CEf73799402a1afe4779f588f03034c5D0f"
+export const SEQUENCE_V3_CONTRACT_ADDRESSES_OVERRIDES: AddressOverrides = {
+  sequenceWalletFactoryAddress: SEQUENCE_V3_CONTRACT_ADDRESSES.factory,
+  sequenceWalletMainModuleAddress: SEQUENCE_V3_CONTRACT_ADDRESSES.stage1,
+  sequenceWalletMainModuleUpgradableAddress:
+    SEQUENCE_V3_CONTRACT_ADDRESSES.stage2,
+} as AddressOverrides
+
+export const TRAILS_ROUTER_ADDRESS =
+  "0x07abd6f71aE3EAD08b2B6D5d091eE24d32dc1Dfa"
+
+export const TRAILS_INTENT_ENTRYPOINT_ADDRESS =
+  "0xf9dF60584Da03f8D83fF1Bed663465734B2221a7"
 
 export const ATTESATION_SIGNER_ADDRESS =
   "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
 
-export const TRAILS_LIFI_SAPIENT_SIGNER_ADDRESS =
-  "0xd7571bd1e3af468c3a49966c9a92a2e907cdfa52"
-export const TRAILS_RELAY_SAPIENT_SIGNER_ADDRESS =
-  "0x9a013e7d186611af36a918ef23d81886e8c256f8"
-export const TRAILS_CCTP_SAPIENT_SIGNER_ADDRESS =
-  "0xc1A9B197eBb31Fc2B613C59dAC3f3E5698A429D0"
-
 export const DEFAULT_SEQUENCE_ENV = "prod"
 
 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_API_URL = "https://api.sequence.app"
+export const PROD_TRAILS_API_URL = "https://trails-api.sequence.app"
 export const DEV_SEQUENCE_NODE_GATEWAY_URL = "https://dev-nodes.sequence.app"
 export const DEV_SEQUENCE_INDEXER_URL = "https://dev-indexer.sequence.app"
 export const DEV_SEQUENCE_API_URL = "https://dev-api.sequence.app"
+export const DEV_TRAILS_API_URL = "https://dev-trails-api.sequence-dev.app"
 
+// TODO: Update with new single address once latest contracts are deployed
 export const intentEntrypoints: Record<number, `0x${string}`> = {
-  8453: "0x2bf4c63199eD7D8A737E8DB2cC19E0C0103F6bE3",
-  84532: "0xdcd9160492C6D43ABbd28D4d06F68ad77f1A0F2b",
-  421614: "0xf18A16E1C778baCA5d6f7F48cC4c9bb913e5e579",
-  42161: "0x674827B6BE8780DBdb96DC02c735275e3a982c90",
-  137: "0x4dBb20eA3A969F1A44d7653D4Dc8632B853E36DE",
+  8453: "0x80DB82D640F9Df20Cfe89fa4E70B0EcC56f3715c", // Base
+  42161: "0x20CC15eb516Ba56398c28CE1A567e3a82889Db46", // Arbitrum One
+  137: "0x1C69bCdcD751785F2a3b815333B46AB150370E6E", // Polygon
+  747474: "0x814A110fF7c664C26e6c3e2E6E85C23291e4359e", // Katana
 }
 
 // This is used for Sequence Indexer and API
@@ -54,5 +60,3 @@ export const DEFAULT_WALLETCONNECT_PROJECT_ID =
 export const SITE_URL = "https://trails.build/"
 
 export const DEFAULT_SLIPPAGE_TOLERANCE = "0.05" // 0.001 = 0.1%, 0.005 = 0.5%, 0.03 = 3%, 0.05 = 5%
-
-export const MINIMUM_USD_AMOUNT_FOR_SWAP = "0.15"

package/src/contractUtils.ts

@@ -1,5 +1,6 @@
 import { createPublicClient, http } from "viem"
 import { getChainInfo } from "./chains.js"
+import { logger } from "./logger.js"
 
 export async function getIsContract(address: `0x${string}`, chainId: number) {
   const client = createPublicClient({
@@ -8,9 +9,39 @@ export async function getIsContract(address: `0x${string}`, chainId: number) {
   })
 
   const code = await client.getCode({ address })
-  return code !== "0x"
+  const isNonZero = isNonZeroHexString(code)
+  const is7702 = is7702ContractCode(code)
+  const isContract = isNonZero && !is7702
+
+  logger.console.log(
+    "[trails-sdk] code:",
+    code?.slice(0, 10),
+    "address:",
+    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 calldata !== undefined && calldata !== "" && calldata !== "0x"
+  return isNonZeroHexString(calldata)
 }

package/src/customChains.ts

@@ -0,0 +1,24 @@
+// 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