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

package/LICENSE

@@ -182,11 +182,12 @@
       boilerplate notice, with the fields enclosed by brackets "[]"
       replaced with your own identifying information. (Don't include
       the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. Please also get an
-      "Alarm" or "alarm" trademark registered for your company name
-      before using the template below.
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
 
-   Copyright 2026 TrustWare.io (socials@trustware.io)
+   Copyright 2026 trustware.io (contact@trustware.io)
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -93,11 +93,13 @@ export function App() {
 
 ## Config Reference
 
-`TrustwareConfigOptions` is the single source of truth. The current supported shape is:
+`TrustwareConfigOptions` is the single source of truth. The shape is a discriminated union
+keyed on `mode` — `routes` is only required in the default `"deposit"` mode:
 
 ```ts
 type TrustwareConfigOptions = {
   apiKey: string;
+  mode?: "deposit"; // default, omit this field entirely for a normal deposit/top-up widget
   routes: {
     toChain: string;
     toToken: string;
@@ -117,12 +119,40 @@ type TrustwareConfigOptions = {
   messages?: Partial<TrustwareWidgetMessages>;
   retry?: RetryConfig;
   walletConnect?: WalletConnectConfig;
+  features?: FeatureFlags;
   onError?: (error: TrustwareError) => void;
   onSuccess?: (transaction: Transaction) => void;
   onEvent?: (event: TrustwareEvent) => void;
+} | {
+  apiKey: string;
+  mode: "swap"; // swap widget — from/to chain+token are chosen entirely in-widget
+  routes?: Partial<TrustwareConfigOptions["routes"]>; // optional, not required
+  // ...same common fields as above
 };
 ```
 
+### Modes
+
+- **`"deposit"`** (default — `mode` can be omitted): the standard bridge/top-up widget.
+  `routes.toChain` and `routes.toToken` are required.
+- **`"swap"`**: an in-widget token swap UI where the user picks both sides themselves.
+  `routes` is not required at all:
+
+  ```ts
+  const trustwareConfig = {
+    apiKey: process.env.NEXT_PUBLIC_TRUSTWARE_API_KEY!,
+    mode: "swap",
+  } satisfies TrustwareConfigOptions;
+  ```
+
+  Use `features.swapDefaultDestToken` / `features.swapLockDestToken` /
+  `features.swapAllowedDestTokens` to steer the destination token selection (see
+  `FeatureFlags` in `src/types/config.ts`).
+
+  > The older `features: { swapMode: true }` flag (combined with a `routes` object) still
+  > works and is treated as equivalent to `mode: "swap"`, but is deprecated in favor of the
+  > `mode` field above.
+
 ### Route Fields
 
 - `routes.toChain`: destination chain key or chain id string.
@@ -146,6 +176,7 @@ type TrustwareConfigOptions = {
 - `messages`: top-level copy overrides.
 - `retry`: API retry and rate-limit behavior.
 - `walletConnect`: WalletConnect overrides.
+- `features`: feature rollout controls, including swap-mode token selection constraints.
 - `onError`, `onSuccess`, `onEvent`: lifecycle callbacks.
 
 ## Widget Usage Patterns

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,118 @@
+# Third-Party Notices
+
+The Trustware SDK (`@trustware/sdk`) is licensed under the Apache License,
+Version 2.0 (see `LICENSE`). The published bundle incorporates code from the
+third-party open source packages listed below. Their license terms and
+copyright notices are reproduced here as required by their respective
+licenses.
+
+This file covers code compiled **into** the SDK bundle. Packages installed
+alongside the SDK as npm dependencies (`@reown/appkit`, `@reown/appkit-common`,
+`@reown/appkit-universal-connector`, `@solana/web3.js`) and peer dependencies
+(`react`, `react-dom`, `viem`) are distributed separately by their respective
+owners under their own licenses and carry their own license files. Note that
+the `@reown/appkit*` packages are licensed under the Reown Community License
+Agreement, which is **not** an open source license; see the `LICENSE.md` file
+in those packages for its terms.
+
+## Bundled packages
+
+| Package | License | Copyright |
+|---------|---------|-----------|
+| `@aa-sdk/core` | MIT | © 2023 Alchemy Insights, Inc. |
+| `@account-kit/infra` | MIT | © 2023 Alchemy Insights, Inc. |
+| `@account-kit/logging` | MIT | © 2023 Alchemy Insights, Inc. |
+| `@account-kit/smart-contracts` | MIT | © 2023 Alchemy Insights, Inc. |
+| `@solana/addresses` | MIT | © 2023 Solana Labs, Inc |
+| `@solana/codecs-core` | MIT | © 2023 Solana Labs, Inc |
+| `@solana/codecs-strings` | MIT | © 2023 Solana Labs, Inc |
+| `@solana/errors` | MIT | © 2023 Solana Labs, Inc |
+| `@solana/text-encoding-impl` | MIT | © 2023 Solana Labs, Inc |
+| `zod` | MIT | © 2025 Colin McDonnell |
+
+## License texts
+
+### MIT License — Alchemy packages
+
+Applies to: `@aa-sdk/core`, `@account-kit/infra`, `@account-kit/logging`,
+`@account-kit/smart-contracts`
+
+```
+MIT License
+
+Copyright (c) 2023 Alchemy Insights, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+### MIT License — Solana packages
+
+Applies to: `@solana/addresses`, `@solana/codecs-core`,
+`@solana/codecs-strings`, `@solana/errors`, `@solana/text-encoding-impl`
+
+```
+Copyright (c) 2023 Solana Labs, Inc
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+### MIT License — zod
+
+Applies to: `zod`
+
+```
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/constants.cjs

@@ -30,7 +30,7 @@ __export(constants_exports, {
 });
 module.exports = __toCommonJS(constants_exports);
 var SDK_NAME = "@trustware/sdk";
-var SDK_VERSION = "1.1.9-staging.6";
+var SDK_VERSION = "1.1.9-staging.7";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var GTM_ID = "GTM-TZDGNCXB";
 var API_PREFIX = "/api";

package/dist/constants.mjs

@@ -1,6 +1,6 @@
 // src/constants.ts
 var SDK_NAME = "@trustware/sdk";
-var SDK_VERSION = "1.1.9-staging.6";
+var SDK_VERSION = "1.1.9-staging.7";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var GTM_ID = "GTM-TZDGNCXB";
 var API_PREFIX = "/api";

package/dist/{core-2oZuxC1J.d.ts → core-DzqVEWwP.d.ts}

@@ -1,4 +1,4 @@
-import { B as BuildRouteResult, b as Transaction, T as TrustwareConfigOptions, W as WalletInterFaceAPI, m as ResolvedTrustwareConfig, y as TrustwareTheme, N as WalletIdentity, a0 as walletManager, G as WalletAddressResolution, a3 as buildRoute, a4 as buildDepositAddress, a5 as submitReceipt, a6 as getStatus, a7 as pollStatus } from './manager-BMO1O-cW.js';
+import { B as BuildRouteResult, b as Transaction, T as TrustwareConfigOptions, W as WalletInterFaceAPI, m as ResolvedTrustwareConfig, z as TrustwareTheme, O as WalletIdentity, a1 as walletManager, H as WalletAddressResolution, a4 as buildRoute, a5 as buildDepositAddress, a6 as submitReceipt, a7 as getStatus, a8 as pollStatus } from './manager-Dn4muk74.js';
 import { C as ChainDef, c as ChainType, G as GetBalancesOptions, B as BalanceRow, a as BalanceStreamOptions, W as WalletAddressBalanceWrapper } from './blockchain-BxAFzp0s.js';
 import { T as Token } from './types-BJY9r-mz.js';
 
@@ -8,6 +8,7 @@ type AddressValidationResult = {
 };
 declare function validateEvmAddress(address: string): AddressValidationResult;
 declare function validateSeiAddress(address: string): AddressValidationResult;
+declare function validateCosmosAddress(address: string, chain?: ChainDef | ChainType | string | null): AddressValidationResult;
 declare function validateSolanaAddress(address: string): AddressValidationResult;
 declare function validateBtcAddress(address: string): AddressValidationResult;
 declare function validateAddressForChain(address: string, chain?: ChainDef | ChainType | string | null): AddressValidationResult;
@@ -140,4 +141,4 @@ declare const Trustware: {
 };
 type TrustwareCore = typeof Trustware;
 
-export { Trustware as T, type TrustwareCore as a, validateBtcAddress as b, validateEvmAddress as c, validateRouteAddresses as d, validateSeiAddress as e, validateSolanaAddress as f, validateAddressForChain as v };
+export { Trustware as T, type TrustwareCore as a, validateBtcAddress as b, validateCosmosAddress as c, validateEvmAddress as d, validateRouteAddresses as e, validateSeiAddress as f, validateSolanaAddress as g, validateAddressForChain as v };

package/dist/{core-BTPkApRH.d.cts → core-gNyi5xsp.d.cts}

@@ -1,4 +1,4 @@
-import { B as BuildRouteResult, b as Transaction, T as TrustwareConfigOptions, W as WalletInterFaceAPI, m as ResolvedTrustwareConfig, y as TrustwareTheme, N as WalletIdentity, a0 as walletManager, G as WalletAddressResolution, a3 as buildRoute, a4 as buildDepositAddress, a5 as submitReceipt, a6 as getStatus, a7 as pollStatus } from './manager-BZwbtOyf.cjs';
+import { B as BuildRouteResult, b as Transaction, T as TrustwareConfigOptions, W as WalletInterFaceAPI, m as ResolvedTrustwareConfig, z as TrustwareTheme, O as WalletIdentity, a1 as walletManager, H as WalletAddressResolution, a4 as buildRoute, a5 as buildDepositAddress, a6 as submitReceipt, a7 as getStatus, a8 as pollStatus } from './manager-DWFNyouP.cjs';
 import { C as ChainDef, c as ChainType, G as GetBalancesOptions, B as BalanceRow, a as BalanceStreamOptions, W as WalletAddressBalanceWrapper } from './blockchain-BxAFzp0s.cjs';
 import { T as Token } from './types-DX3HtFcn.cjs';
 
@@ -8,6 +8,7 @@ type AddressValidationResult = {
 };
 declare function validateEvmAddress(address: string): AddressValidationResult;
 declare function validateSeiAddress(address: string): AddressValidationResult;
+declare function validateCosmosAddress(address: string, chain?: ChainDef | ChainType | string | null): AddressValidationResult;
 declare function validateSolanaAddress(address: string): AddressValidationResult;
 declare function validateBtcAddress(address: string): AddressValidationResult;
 declare function validateAddressForChain(address: string, chain?: ChainDef | ChainType | string | null): AddressValidationResult;
@@ -140,4 +141,4 @@ declare const Trustware: {
 };
 type TrustwareCore = typeof Trustware;
 
-export { Trustware as T, type TrustwareCore as a, validateBtcAddress as b, validateEvmAddress as c, validateRouteAddresses as d, validateSeiAddress as e, validateSolanaAddress as f, validateAddressForChain as v };
+export { Trustware as T, type TrustwareCore as a, validateBtcAddress as b, validateCosmosAddress as c, validateEvmAddress as d, validateRouteAddresses as e, validateSeiAddress as f, validateSolanaAddress as g, validateAddressForChain as v };

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.6";
+    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"
+    };
   }
 });
 
@@ -4001,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`,
     {
@@ -4009,7 +4033,8 @@ async function submitReceipt(intentId, txHash, sponsorshipRequestId) {
       headers: jsonHeaders({ "Idempotency-Key": txHash }),
       body: JSON.stringify({
         txHash,
-        ...sponsorshipRequestId ? { sponsorshipRequestId } : {}
+        ...sponsorshipRequestId ? { sponsorshipRequestId } : {},
+        ...eoaAddress ? { eoaAddress } : {}
       })
     }
   );
@@ -4131,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";
@@ -4285,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;
       }
     }
@@ -4385,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";
@@ -4396,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";
   }
 });
 
@@ -6180,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";
@@ -6238,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,
@@ -6257,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;
   }
 });