@trustware/sdk-staging 1.1.9-staging.5 → 1.1.9-staging.7

package/dist/core.cjs

@@ -75,7 +75,7 @@ var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
     SDK_NAME = "@trustware/sdk";
-    SDK_VERSION = "1.1.9-staging.5";
+    SDK_VERSION = "1.1.9-staging.7";
     API_ROOT = "https://bv-staging-api.trustware.io";
     API_PREFIX = "/api";
     WALLETCONNECT_PROJECT_ID = "72ea74c400f5111d43aea638d7d83a24";
@@ -284,7 +284,9 @@ var init_chains = __esm({
       btc: "bitcoin",
       bitcoin: "bitcoin",
       sei: "cosmos",
-      "pacific-1": "cosmos"
+      "pacific-1": "cosmos",
+      nibiru: "cosmos",
+      "cataclysm-1": "cosmos"
     };
   }
 });
@@ -1480,16 +1482,23 @@ function validateEvmAddress(address) {
   }
   return { isValid: true };
 }
-function validateSeiAddress(address) {
+function resolveCosmosBech32Prefix(chain) {
+  const chainDef = typeof chain === "object" && chain ? chain : void 0;
+  const identifier = chainDef?.networkIdentifier ?? chainDef?.chainId ?? chainDef?.id ?? (typeof chain === "string" ? chain : void 0);
+  const normalized = String(identifier ?? "").trim().toLowerCase();
+  return COSMOS_BECH32_PREFIX_BY_CHAIN_ID[normalized] ?? "sei";
+}
+function validateCosmosAddress(address, chain) {
   const trimmed = address.trim();
-  if ((0, import_viem.isAddress)(trimmed)) {
+  const prefix = resolveCosmosBech32Prefix(chain);
+  if (prefix === "sei" && (0, import_viem.isAddress)(trimmed)) {
     return { isValid: true };
   }
-  const result = validateBech32LikeAddress(trimmed, "sei");
+  const result = validateBech32LikeAddress(trimmed, prefix);
   if (result.isValid) return result;
   return {
     isValid: false,
-    error: "SEI addresses must be 0x-prefixed EVM or sei1 bech32 strings."
+    error: prefix === "sei" ? "SEI addresses must be 0x-prefixed EVM or sei1 bech32 strings." : `Address must be a valid ${prefix}1 bech32 string.`
   };
 }
 function validateSolanaAddress(address) {
@@ -1539,15 +1548,12 @@ function validateAddressForChain(address, chain) {
     case "bitcoin":
       return validateBtcAddress(trimmed);
     case "cosmos":
-      if (chainDef?.networkIdentifier?.toLowerCase() === "sei") {
-        return validateSeiAddress(trimmed);
-      }
-      return validateBech32LikeAddress(trimmed, "sei");
+      return validateCosmosAddress(trimmed, chainDef ?? chain);
     default:
       return { isValid: false, error: "Unsupported or unknown chain type." };
   }
 }
-function validateAddressForRouteChain(address, chainType) {
+function validateAddressForRouteChain(address, chainType, chainRef) {
   switch (normalizeChainType(chainType)) {
     case "evm":
       return validateEvmAddress(address);
@@ -1556,7 +1562,7 @@ function validateAddressForRouteChain(address, chainType) {
     case "bitcoin":
       return validateBtcAddress(address);
     case "cosmos":
-      return validateSeiAddress(address);
+      return validateCosmosAddress(address, chainRef ?? chainType);
     default:
       return { isValid: false, error: "Unsupported chain type." };
   }
@@ -1578,14 +1584,18 @@ function validateRouteAddresses(params) {
   const normalizedDirection = params.direction?.trim().toLowerCase();
   const isDepositFlow = normalizedDirection === "deposit" || (toType === "evm" || toType === "cosmos") && (fromType === "bitcoin" || fromType === "solana");
   if (isDepositFlow) {
-    const fromResult2 = validateAddressForRouteChain(fromAddress, fromType);
+    const fromResult2 = validateAddressForRouteChain(
+      fromAddress,
+      fromType,
+      params.fromChain
+    );
     if (!fromResult2.isValid) {
       return {
         isValid: false,
         error: `From address: ${fromResult2.error ?? "Invalid address."}`
       };
     }
-    const toResult2 = toType === "cosmos" ? validateSeiAddress(toAddress) : validateEvmAddress(toAddress);
+    const toResult2 = toType === "cosmos" ? validateCosmosAddress(toAddress, params.toChain) : validateEvmAddress(toAddress);
     if (!toResult2.isValid) {
       return {
         isValid: false,
@@ -1610,14 +1620,22 @@ function validateRouteAddresses(params) {
     }
     return { isValid: true };
   }
-  const fromResult = validateAddressForRouteChain(fromAddress, fromType);
+  const fromResult = validateAddressForRouteChain(
+    fromAddress,
+    fromType,
+    params.fromChain
+  );
   if (!fromResult.isValid) {
     return {
       isValid: false,
       error: `From address: ${fromResult.error ?? "Invalid address."}`
     };
   }
-  const toResult = validateAddressForRouteChain(toAddress, toType);
+  const toResult = validateAddressForRouteChain(
+    toAddress,
+    toType,
+    params.toChain
+  );
   if (!toResult.isValid) {
     return {
       isValid: false,
@@ -1626,7 +1644,7 @@ function validateRouteAddresses(params) {
   }
   return { isValid: true };
 }
-var import_viem, BECH32_CHARSET;
+var import_viem, BECH32_CHARSET, COSMOS_BECH32_PREFIX_BY_CHAIN_ID;
 var init_address = __esm({
   "src/validation/address.ts"() {
     "use strict";
@@ -1634,6 +1652,12 @@ var init_address = __esm({
     init_index_node4();
     init_chains();
     BECH32_CHARSET = /^[023456789acdefghjklmnpqrstuvwxyz]+$/i;
+    COSMOS_BECH32_PREFIX_BY_CHAIN_ID = {
+      "pacific-1": "sei",
+      sei: "sei",
+      "cataclysm-1": "nibi",
+      nibiru: "nibi"
+    };
   }
 });
 
@@ -2470,7 +2494,7 @@ var init_walletconnect = __esm({
     solanaMainnet = {
       id: 900,
       chainNamespace: "solana",
-      caipNetworkId: "solana:5eykt4UsFv8P8NJdTREpY1vzqAQ3H1FQ",
+      caipNetworkId: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
       name: "Solana Mainnet",
       nativeCurrency: {
         name: "Solana",
@@ -3348,8 +3372,62 @@ function getChainMeta(chainId) {
     rpcUrls: chain.rpcUrls.default.http
   };
 }
-async function buildWalletConnectAPI(walletCfg) {
+function extractSolanaAddress(connector) {
+  const caipAccount = connector.provider.session?.namespaces?.solana?.accounts?.[0];
+  if (!caipAccount) return null;
+  return caipAccount.split(":")[2] ?? null;
+}
+function buildWalletConnectSolanaProvider(connector) {
+  return {
+    get publicKey() {
+      const address = extractSolanaAddress(connector);
+      return address ? { toString: () => address } : void 0;
+    },
+    async connect() {
+      const address = extractSolanaAddress(connector);
+      if (!address) {
+        throw new Error(
+          "This wallet did not approve a Solana account over WalletConnect."
+        );
+      }
+      return { publicKey: { toString: () => address } };
+    },
+    async disconnect() {
+    },
+    async signTransaction(transaction) {
+      const tx = transaction;
+      const rawBytes = "version" in tx ? tx.serialize() : tx.serialize({
+        requireAllSignatures: false,
+        verifySignatures: false
+      });
+      const result = await connector.provider.request(
+        {
+          method: "solana_signTransaction",
+          params: { transaction: encodeBase64(rawBytes) }
+        },
+        solanaMainnet.caipNetworkId
+      );
+      if (!result.transaction) {
+        throw new Error(
+          "WalletConnect wallet did not return a signed Solana transaction."
+        );
+      }
+      const signedBytes = decodeBase64(result.transaction);
+      return { serialize: () => signedBytes };
+    },
+    on() {
+    },
+    off() {
+    },
+    removeListener() {
+    }
+  };
+}
+async function buildWalletConnectAPI(walletCfg, ecosystem = "evm") {
   const connector = await getUniversalConnector(walletCfg);
+  if (ecosystem === "solana") {
+    return toSolanaWalletInterface(buildWalletConnectSolanaProvider(connector));
+  }
   const provider = connector.provider;
   const api = {
     ecosystem: "evm",
@@ -3559,44 +3637,39 @@ var init_manager = __esm({
           this.emit();
         }
       }
-      async connectWalletConnect(walletCfg) {
-        if (this._status === "connected" && this._connectedVia === "walletconnect" && this._wallet) {
+      async connectWalletConnect(walletCfg, ecosystem = "evm") {
+        if (this._status === "connected" && this._connectedVia === "walletconnect" && this._wallet && this._wallet.ecosystem === ecosystem) {
           this.emit();
           return { error: null, api: this._wallet };
         }
+        if (this._connectedVia === "walletconnect" && this._wallet) {
+          await this._wallet.disconnect?.().catch(() => {
+          });
+          resetUniversalConnector();
+        }
         this._status = "connecting";
         this.clearConnectedState();
         this.emit();
         try {
           const connector = await getUniversalConnector(walletCfg);
           await connector.connect();
-          const api = await buildWalletConnectAPI(walletCfg);
+          const api = await buildWalletConnectAPI(walletCfg, ecosystem);
+          try {
+            await api.getAddress();
+          } catch {
+            await api.disconnect?.().catch(() => {
+            });
+            resetUniversalConnector();
+            throw new Error(
+              `This wallet did not approve a${ecosystem === "evm" ? "n" : ""} ${ecosystem === "evm" ? "EVM" : "Solana"} account over WalletConnect.`
+            );
+          }
           this._wallet = api;
           this._connectedVia = "walletconnect";
           this._connectedWalletId = "walletconnect";
-          const provider = connector.provider;
-          this._providerCleanup = bindWalletConnectEvents(provider, {
-            onAccountsChanged: (accounts) => {
-              if (accounts.length === 0) {
-                this.fullReset();
-                this.triggerExternalDisconnect();
-                this.emit();
-                return;
-              }
-              void this.syncIdentityFromWallet("walletconnect");
-              this.emit();
-            },
-            onChainChanged: () => {
-              void this.syncIdentityFromWallet("walletconnect");
-              this.emit();
-            },
-            onDisconnect: () => {
-              this.fullReset();
-              resetUniversalConnector();
-              this.triggerExternalDisconnect();
-              this.emit();
-            }
-          });
+          this._providerCleanup = this.bindWalletConnectProviderEvents(
+            connector.provider
+          );
           await this.syncIdentityFromWallet("walletconnect");
           this._status = "connected";
           this._error = null;
@@ -3611,6 +3684,100 @@ var init_manager = __esm({
           return { error: message, api: null };
         }
       }
+      bindWalletConnectProviderEvents(provider) {
+        return bindWalletConnectEvents(provider, {
+          onAccountsChanged: (accounts) => {
+            if (accounts.length === 0) {
+              this.fullReset();
+              this.triggerExternalDisconnect();
+              this.emit();
+              return;
+            }
+            void this.syncIdentityFromWallet("walletconnect");
+            this.emit();
+          },
+          onChainChanged: () => {
+            void this.syncIdentityFromWallet("walletconnect");
+            this.emit();
+          },
+          onDisconnect: () => {
+            this.fullReset();
+            resetUniversalConnector();
+            this.triggerExternalDisconnect();
+            this.emit();
+          }
+        });
+      }
+      // WalletConnect's own SignClient auto-restores the last persisted session
+      // from storage on every init — including after a fresh page load — but
+      // that restoration happens silently inside the library. Nothing calls back
+      // into our code for it. On mobile, backgrounding the tab to approve in a
+      // wallet app can cause the OS to reload the page before the original
+      // connect() promise ever resolves, so the connect flow that triggered the
+      // approval never gets to record it as "connected" here — even though
+      // WalletConnect itself already has a live, approved session sitting in
+      // storage. Call this on mount to pick that back up.
+      async restoreWalletConnectSession(walletCfg) {
+        if (this._status === "connected" && this._connectedVia === "walletconnect") {
+          return this._wallet?.ecosystem === "solana" ? "solana" : "evm";
+        }
+        if (typeof window === "undefined") return null;
+        try {
+          if (!Object.keys(window.localStorage).some((key) => key.startsWith("wc@2"))) {
+            return null;
+          }
+        } catch {
+        }
+        let connector;
+        try {
+          connector = await getUniversalConnector(walletCfg);
+        } catch (e2) {
+          console.warn(
+            "[Trustware SDK] Failed to restore WalletConnect session:",
+            e2
+          );
+          return null;
+        }
+        const session = connector.provider.session;
+        if (!session) return null;
+        const ecosystem = session.namespaces?.solana?.accounts?.length ? "solana" : session.namespaces?.eip155?.accounts?.length ? "evm" : null;
+        if (!ecosystem) return null;
+        try {
+          const api = await buildWalletConnectAPI(walletCfg, ecosystem);
+          this._wallet = api;
+          this._connectedVia = "walletconnect";
+          this._connectedWalletId = "walletconnect";
+          this._providerCleanup = this.bindWalletConnectProviderEvents(
+            connector.provider
+          );
+          await this.syncIdentityFromWallet("walletconnect");
+          this._status = "connected";
+          this._error = null;
+          this.emit();
+          return ecosystem;
+        } catch {
+          return null;
+        }
+      }
+      // Forcibly abandon an in-progress connect() call the caller has decided is
+      // stuck (e.g. the UI's own connect timeout elapsed with no response).
+      // There's no clean way to cancel a pending WalletConnect pairing proposal
+      // from this side, so this tears down the whole connector — the next
+      // connect attempt starts against a brand new SignClient/pairing instead of
+      // racing the abandoned one, which would otherwise risk reproducing the
+      // "No matching key. proposal" class of error a real retry needs to avoid.
+      cancelWalletConnectAttempt() {
+        if (this._connectedVia === "walletconnect" && this._status === "connected") {
+          return;
+        }
+        resetUniversalConnector();
+        if (this._status === "connecting") {
+          this.clearConnectedState();
+          this._status = "idle";
+          this._error = null;
+          this.emit();
+        }
+      }
       async disconnect(wagmi) {
         if (wagmi && this._connectedVia === "extension") {
           await wagmi.disconnect().catch(() => {
@@ -3858,7 +4025,7 @@ async function buildDepositAddress(body, signal) {
     route
   };
 }
-async function submitReceipt(intentId, txHash, sponsorshipRequestId) {
+async function submitReceipt(intentId, txHash, sponsorshipRequestId, eoaAddress) {
   const r = await rateLimitedFetch(
     `${apiBase()}/v1/route-intent/${intentId}/receipt`,
     {
@@ -3866,7 +4033,8 @@ async function submitReceipt(intentId, txHash, sponsorshipRequestId) {
       headers: jsonHeaders({ "Idempotency-Key": txHash }),
       body: JSON.stringify({
         txHash,
-        ...sponsorshipRequestId ? { sponsorshipRequestId } : {}
+        ...sponsorshipRequestId ? { sponsorshipRequestId } : {},
+        ...eoaAddress ? { eoaAddress } : {}
       })
     }
   );
@@ -3988,7 +4156,9 @@ var init_chainHelpers = __esm({
       btc: "bitcoin",
       bitcoin: "bitcoin",
       sei: "cosmos",
-      "pacific-1": "cosmos"
+      "pacific-1": "cosmos",
+      nibiru: "cosmos",
+      "cataclysm-1": "cosmos"
     };
     SEI_EVM_CHAIN_ID = "1329";
     SEI_COSMOS_CHAIN_ID = "pacific-1";
@@ -4142,7 +4312,8 @@ function filterSupportedChains(chains) {
     }
     if (chainType === "cosmos") {
       const seiKey = canonicalSeiChainKey(chain.chainId ?? chain.id);
-      if (seiKey !== "sei" && seiKey !== "pacific-1") {
+      const isNibiru = normalizeChainKey2(chain.chainId ?? chain.id) === NIBIRU_COSMOS_CHAIN_ID;
+      if (seiKey !== "sei" && !isNibiru) {
         return false;
       }
     }
@@ -4242,7 +4413,7 @@ function useChains() {
     error
   };
 }
-var import_react2, POPULAR_CHAINS_BY_TVL, POPULAR_LIMIT;
+var import_react2, POPULAR_CHAINS_BY_TVL, POPULAR_LIMIT, NIBIRU_COSMOS_CHAIN_ID;
 var init_useChains = __esm({
   "src/core/useChains.ts"() {
     "use strict";
@@ -4253,6 +4424,7 @@ var init_useChains = __esm({
     init_popularChains();
     POPULAR_CHAINS_BY_TVL = popularChains_default.byTvl;
     POPULAR_LIMIT = popularChains_default.popularLimit;
+    NIBIRU_COSMOS_CHAIN_ID = "cataclysm-1";
   }
 });
 
@@ -6037,46 +6209,80 @@ function normalizeSlippage(v) {
   if (n > 5) return 5;
   return n;
 }
+function warnDeprecatedSwapModeFlag() {
+  if (hasWarnedDeprecatedSwapModeFlag) return;
+  hasWarnedDeprecatedSwapModeFlag = true;
+  console.warn(
+    '[Trustware SDK] `features.swapMode` is deprecated \u2014 use `mode: "swap"` on the top-level config instead.'
+  );
+}
+function resolveMode(input) {
+  if (input.mode === "swap") return "swap";
+  if (input.mode === "deposit") return "deposit";
+  if (input.features?.swapMode) {
+    warnDeprecatedSwapModeFlag();
+    return "swap";
+  }
+  return "deposit";
+}
 function resolveConfig(input) {
   if (!input?.apiKey) {
-    throw new Error("TrustwareConfig: 'apiKey' is required.");
+    throw new TrustwareError({
+      code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+      message: "TrustwareConfig: 'apiKey' is required.",
+      userMessage: "Missing required API key configuration."
+    });
   }
-  if (!input.routes?.toChain || !input.routes?.toToken) {
-    throw new Error(
-      "TrustwareConfig: 'routes.toChain' and 'routes.toToken' are required."
-    );
+  const mode = resolveMode(input);
+  if (mode === "deposit" && (!input.routes?.toChain || !input.routes?.toToken)) {
+    throw new TrustwareError({
+      code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+      message: "TrustwareConfig: 'routes.toChain' and 'routes.toToken' are required in deposit mode.",
+      userMessage: "Missing required destination chain/token configuration."
+    });
   }
-  const toChain = input.routes.toChain;
-  if (input.routes.toAddress) {
+  const toChain = input.routes?.toChain;
+  if (input.routes?.toAddress && toChain) {
     const result = validateAddressForChain(input.routes.toAddress, toChain);
     if (!result.isValid) {
       console.error(`[Trustware SDK] Invalid toAddress: ${result.error}`);
-      throw new Error(`Invalid toAddress: ${result.error}`);
+      throw new TrustwareError({
+        code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+        message: `Invalid toAddress: ${result.error}`,
+        userMessage: "The configured destination address is invalid."
+      });
     }
   }
-  if (input.routes.fromAddress) {
-    const result = validateAddressForChain(
-      input.routes.fromAddress,
-      input.routes.fromChain ?? toChain
-    );
-    if (!result.isValid) {
-      console.error(`[Trustware SDK] Invalid fromAddress: ${result.error}`);
-      throw new Error(`Invalid fromAddress: ${result.error}`);
+  if (input.routes?.fromAddress) {
+    const fromChain = input.routes.fromChain ?? toChain;
+    if (fromChain) {
+      const result = validateAddressForChain(
+        input.routes.fromAddress,
+        fromChain
+      );
+      if (!result.isValid) {
+        console.error(`[Trustware SDK] Invalid fromAddress: ${result.error}`);
+        throw new TrustwareError({
+          code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+          message: `Invalid fromAddress: ${result.error}`,
+          userMessage: "The configured source address is invalid."
+        });
+      }
     }
   }
   const autoDetectProvider = typeof input.autoDetectProvider === "boolean" ? input.autoDetectProvider : DEFAULT_AUTO_DETECT_PROVIDER;
   const routes = {
-    toChain: input.routes.toChain,
-    toToken: input.routes.toToken,
-    fromToken: input.routes.fromToken,
-    fromAddress: input.routes.fromAddress,
-    fromChain: input.routes.fromChain,
-    toAddress: input.routes.toAddress,
+    toChain: input.routes?.toChain ?? "",
+    toToken: input.routes?.toToken ?? "",
+    fromToken: input.routes?.fromToken,
+    fromAddress: input.routes?.fromAddress,
+    fromChain: input.routes?.fromChain,
+    toAddress: input.routes?.toAddress,
     defaultSlippage: normalizeSlippage(
-      input.routes.defaultSlippage ?? DEFAULT_SLIPPAGE
+      input.routes?.defaultSlippage ?? DEFAULT_SLIPPAGE
     ),
     options: {
-      ...input.routes.options
+      ...input.routes?.options
     }
   };
   const theme = input.theme ?? "system";
@@ -6095,13 +6301,16 @@ function resolveConfig(input) {
     tokensPagination: input.features?.tokensPagination ?? DEFAULT_FEATURE_FLAGS.tokensPagination,
     balanceStreaming: input.features?.balanceStreaming ?? DEFAULT_FEATURE_FLAGS.balanceStreaming,
     shouldAllowGA4: input.features?.shouldAllowGA4 ?? DEFAULT_FEATURE_FLAGS.shouldAllowGA4,
-    swapMode: input.features?.swapMode ?? DEFAULT_FEATURE_FLAGS.swapMode,
+    // Always mirrors the canonical `mode`, however the caller set it (new `mode` field
+    // or the deprecated `features.swapMode` flag).
+    swapMode: mode === "swap",
     swapDefaultDestToken: input.features?.swapDefaultDestToken ?? DEFAULT_FEATURE_FLAGS.swapDefaultDestToken,
     swapLockDestToken: input.features?.swapLockDestToken ?? DEFAULT_FEATURE_FLAGS.swapLockDestToken,
     swapAllowedDestTokens: input.features?.swapAllowedDestTokens ?? DEFAULT_FEATURE_FLAGS.swapAllowedDestTokens
   };
   return {
     apiKey: input.apiKey,
+    mode,
     routes,
     autoDetectProvider,
     theme,
@@ -6114,12 +6323,15 @@ function resolveConfig(input) {
     onEvent: input.onEvent
   };
 }
+var hasWarnedDeprecatedSwapModeFlag;
 var init_merge = __esm({
   "src/config/merge.ts"() {
     "use strict";
     init_defaults();
     init_config();
     init_index();
+    init_TrustwareError();
+    hasWarnedDeprecatedSwapModeFlag = false;
   }
 });