@trustware/sdk-staging 1.1.9-staging.6 → 1.1.10-staging.0

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.10-staging.0";
 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.10-staging.0";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var GTM_ID = "GTM-TZDGNCXB";
 var API_PREFIX = "/api";

package/dist/{core-BTPkApRH.d.cts → core-B7Ez-5-r.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 { n as BuildRouteResult, k as Transaction, T as TrustwareConfigOptions, i as WalletInterFaceAPI, z as ResolvedTrustwareConfig, V as TrustwareTheme, a1 as WalletIdentity, w as walletManager, Y as WalletAddressResolution, a8 as buildRoute, a9 as buildDepositAddress, aa as submitReceipt, ab as getStatus, ac as pollStatus } from './manager-BwjyFjjz.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-2oZuxC1J.d.ts → core-BPLiD1UG.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 { n as BuildRouteResult, k as Transaction, T as TrustwareConfigOptions, i as WalletInterFaceAPI, z as ResolvedTrustwareConfig, V as TrustwareTheme, a1 as WalletIdentity, w as walletManager, Y as WalletAddressResolution, a8 as buildRoute, a9 as buildDepositAddress, aa as submitReceipt, ab as getStatus, ac as pollStatus } from './manager-B6NNV-E_.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 };