@trustware/sdk-staging 1.1.16-staging.2 → 1.1.16-staging.3

package/README.md

@@ -108,39 +108,41 @@ export function App() {
 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;
-    fromToken?: string;
-    fromChain?: string;
-    fromAddress?: string;
-    toAddress?: string;
-    defaultSlippage?: number;
-    options?: {
-      routeRefreshMs?: number;
-      fixedFromAmount?: string | number;
-      minAmountOut?: string | number;
-      maxAmountOut?: string | number;
+type TrustwareConfigOptions =
+  | {
+      apiKey: string;
+      mode?: "deposit"; // default, omit this field entirely for a normal deposit/top-up widget
+      routes: {
+        toChain: string;
+        toToken: string;
+        fromToken?: string;
+        fromChain?: string;
+        fromAddress?: string;
+        toAddress?: string;
+        defaultSlippage?: number;
+        options?: {
+          routeRefreshMs?: number;
+          fixedFromAmount?: string | number;
+          minAmountOut?: string | number;
+          maxAmountOut?: string | number;
+        };
+      };
+      autoDetectProvider?: boolean;
+      theme?: "light" | "dark" | "system"; // TrustwareTheme
+      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
     };
-  };
-  autoDetectProvider?: boolean;
-  theme?: "light" | "dark" | "system"; // TrustwareTheme
-  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
@@ -412,6 +414,12 @@ whose fees exceed what it delivers, throwing a `RouteError` with code
 `fees_exceed_output`. A route the provider did not price in USD is not refused.
 `routeNetUsd(estimate)` / `isValueDestroying(estimate)` expose the same check.
 
+An address the backend cannot accept on its chain (wrong EIP-55 checksum, not a
+Solana public key) comes back as a 400 `RouteError` with code `invalid_address`
+and one `rejected` provider outcome per provider. No provider was called; fix
+the request rather than retry it. `validateRouteAddresses` catches the same
+cases client-side before the request is spent.
+
 ### Provider Context
 
 `useTrustware()` returns `{ status, errors, core, emitError, emitSuccess,

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.16-staging.2";
+var SDK_VERSION = "1.1.16-staging.3";
 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.16-staging.2";
+var SDK_VERSION = "1.1.16-staging.3";
 var API_ROOT = "https://bv-staging-api.trustware.io";
 var GTM_ID = "GTM-TZDGNCXB";
 var API_PREFIX = "/api";

package/dist/{core-BZYVv-Vo.d.ts → core-B31ElTB8.d.ts}

@@ -123,9 +123,12 @@ declare function assertRouteDeliversValue(route: RoutePlan | undefined): void;
 /** One provider's answer, as the routing API reports it. */
 type RouteProviderOutcome = {
     name: string;
-    /** "declined" — this provider cannot route the pair; "failed" — it errored. */
-    outcome: "declined" | "failed" | (string & {});
-    /** Stable machine code; see RouteDeclineCode / RouteFailureCode. */
+    /** "declined" — this provider cannot route the pair; "failed" — it errored;
+     *  "rejected" — it refused the request before any call because the caller's
+     *  own input cannot be valid (see RouteRejectionCode). */
+    outcome: "declined" | "failed" | "rejected" | (string & {});
+    /** Stable machine code; see RouteDeclineCode / RouteFailureCode /
+     *  RouteRejectionCode. */
     code: string;
     message: string;
 };
@@ -152,12 +155,25 @@ declare const RouteFailureCode: {
     readonly Timeout: "timeout";
     readonly ProviderError: "provider_error";
 };
+/**
+ * Codes for a provider that refused the request before any call. The caller's
+ * input is the problem, not the pair and not the provider: an address that
+ * cannot be valid on its chain (not hex, wrong EIP-55 checksum, not a Solana
+ * public key). The backend's validators are shared and deterministic, so one
+ * rejection is the verdict whatever the other providers said.
+ */
+declare const RouteRejectionCode: {
+    readonly InvalidAddress: "invalid_address";
+};
 /** Top-level verdict for the request as a whole. */
 declare const RouteErrorCode: {
     /** Every provider declined: a negative result, returned as 404. */
     readonly NoRouteAvailable: "no_route_available";
     /** At least one provider failed, so "unroutable" cannot be claimed: 502. */
     readonly ProvidersFailed: "providers_failed";
+    /** The caller's address cannot be valid on its chain; no provider was
+     *  asked. Returned as 400. Fix the request rather than retry it. */
+    readonly InvalidAddress: "invalid_address";
     /** A route came back but the SDK refused it: its fees exceed its output.
      *  Reached client-side, so `status` is 0. */
     readonly FeesExceedOutput: "fees_exceed_output";
@@ -175,7 +191,8 @@ declare const RouteErrorCode: {
  */
 declare class RouteError extends Error {
     /** HTTP status: 404 when every provider declined, 502 when one failed,
-     *  0 when the SDK reached the verdict itself without a response. */
+     *  400 when the caller's address was rejected, 0 when the SDK reached the
+     *  verdict itself without a response. */
     readonly status: number;
     /** Top-level verdict — see RouteErrorCode. Empty when the API sent none. */
     readonly code: string;
@@ -189,6 +206,8 @@ declare class RouteError extends Error {
     });
     /** True when every provider declined — nobody failed, so the pair is the problem. */
     get isNoRouteAvailable(): boolean;
+    /** True when the caller's address was rejected — nothing to retry, fix the request. */
+    get isInvalidAddress(): boolean;
     /** The distinct provider codes, e.g. ["amount_too_low", "no_routes"]. */
     get providerCodes(): string[];
 }
@@ -200,8 +219,13 @@ type RouteErrorFacts = {
     codes: string[];
     /** Per-provider outcomes, empty when only the message survived. */
     providers: readonly RouteProviderOutcome[];
-    /** True when no provider failed — every one of them declined. */
+    /** True when no provider failed or rejected — every one of them declined. */
     allDeclined: boolean;
+    /**
+     * True when a provider rejected the caller's own input. Outranks the rest:
+     * the pair may route fine and no provider failed, the request is wrong.
+     */
+    rejected: boolean;
     /**
      * The smallest amount a provider said it would accept, when one said so.
      * Both spellings are covered: Squid's own "Minimum swap amount for this route
@@ -324,4 +348,4 @@ declare const Trustware: {
 };
 type TrustwareCore = typeof Trustware;
 
-export { RouteDeclineCode as R, Trustware as T, RouteError as a, RouteErrorCode as b, type RouteErrorFacts as c, RouteFailureCode as d, type RouteProviderOutcome as e, type TrustwareCore as f, assertRouteDeliversValue as g, formatMinimum as h, isRouteError as i, isValueDestroying as j, validateBtcAddress as k, validateCosmosAddress as l, validateEvmAddress as m, validateRouteAddresses as n, validateSeiAddress as o, parseRouteError as p, validateSolanaAddress as q, routeNetUsd as r, validateAddressForChain as v };
+export { RouteDeclineCode as R, Trustware as T, RouteError as a, RouteErrorCode as b, type RouteErrorFacts as c, RouteFailureCode as d, type RouteProviderOutcome as e, RouteRejectionCode as f, type TrustwareCore as g, assertRouteDeliversValue as h, formatMinimum as i, isRouteError as j, isValueDestroying as k, validateBtcAddress as l, validateCosmosAddress as m, validateEvmAddress as n, validateRouteAddresses as o, parseRouteError as p, validateSeiAddress as q, routeNetUsd as r, validateSolanaAddress as s, validateAddressForChain as v };

package/dist/{core-EpQvLUSx.d.cts → core-Bp73X3Mp.d.cts}

@@ -123,9 +123,12 @@ declare function assertRouteDeliversValue(route: RoutePlan | undefined): void;
 /** One provider's answer, as the routing API reports it. */
 type RouteProviderOutcome = {
     name: string;
-    /** "declined" — this provider cannot route the pair; "failed" — it errored. */
-    outcome: "declined" | "failed" | (string & {});
-    /** Stable machine code; see RouteDeclineCode / RouteFailureCode. */
+    /** "declined" — this provider cannot route the pair; "failed" — it errored;
+     *  "rejected" — it refused the request before any call because the caller's
+     *  own input cannot be valid (see RouteRejectionCode). */
+    outcome: "declined" | "failed" | "rejected" | (string & {});
+    /** Stable machine code; see RouteDeclineCode / RouteFailureCode /
+     *  RouteRejectionCode. */
     code: string;
     message: string;
 };
@@ -152,12 +155,25 @@ declare const RouteFailureCode: {
     readonly Timeout: "timeout";
     readonly ProviderError: "provider_error";
 };
+/**
+ * Codes for a provider that refused the request before any call. The caller's
+ * input is the problem, not the pair and not the provider: an address that
+ * cannot be valid on its chain (not hex, wrong EIP-55 checksum, not a Solana
+ * public key). The backend's validators are shared and deterministic, so one
+ * rejection is the verdict whatever the other providers said.
+ */
+declare const RouteRejectionCode: {
+    readonly InvalidAddress: "invalid_address";
+};
 /** Top-level verdict for the request as a whole. */
 declare const RouteErrorCode: {
     /** Every provider declined: a negative result, returned as 404. */
     readonly NoRouteAvailable: "no_route_available";
     /** At least one provider failed, so "unroutable" cannot be claimed: 502. */
     readonly ProvidersFailed: "providers_failed";
+    /** The caller's address cannot be valid on its chain; no provider was
+     *  asked. Returned as 400. Fix the request rather than retry it. */
+    readonly InvalidAddress: "invalid_address";
     /** A route came back but the SDK refused it: its fees exceed its output.
      *  Reached client-side, so `status` is 0. */
     readonly FeesExceedOutput: "fees_exceed_output";
@@ -175,7 +191,8 @@ declare const RouteErrorCode: {
  */
 declare class RouteError extends Error {
     /** HTTP status: 404 when every provider declined, 502 when one failed,
-     *  0 when the SDK reached the verdict itself without a response. */
+     *  400 when the caller's address was rejected, 0 when the SDK reached the
+     *  verdict itself without a response. */
     readonly status: number;
     /** Top-level verdict — see RouteErrorCode. Empty when the API sent none. */
     readonly code: string;
@@ -189,6 +206,8 @@ declare class RouteError extends Error {
     });
     /** True when every provider declined — nobody failed, so the pair is the problem. */
     get isNoRouteAvailable(): boolean;
+    /** True when the caller's address was rejected — nothing to retry, fix the request. */
+    get isInvalidAddress(): boolean;
     /** The distinct provider codes, e.g. ["amount_too_low", "no_routes"]. */
     get providerCodes(): string[];
 }
@@ -200,8 +219,13 @@ type RouteErrorFacts = {
     codes: string[];
     /** Per-provider outcomes, empty when only the message survived. */
     providers: readonly RouteProviderOutcome[];
-    /** True when no provider failed — every one of them declined. */
+    /** True when no provider failed or rejected — every one of them declined. */
     allDeclined: boolean;
+    /**
+     * True when a provider rejected the caller's own input. Outranks the rest:
+     * the pair may route fine and no provider failed, the request is wrong.
+     */
+    rejected: boolean;
     /**
      * The smallest amount a provider said it would accept, when one said so.
      * Both spellings are covered: Squid's own "Minimum swap amount for this route
@@ -324,4 +348,4 @@ declare const Trustware: {
 };
 type TrustwareCore = typeof Trustware;
 
-export { RouteDeclineCode as R, Trustware as T, RouteError as a, RouteErrorCode as b, type RouteErrorFacts as c, RouteFailureCode as d, type RouteProviderOutcome as e, type TrustwareCore as f, assertRouteDeliversValue as g, formatMinimum as h, isRouteError as i, isValueDestroying as j, validateBtcAddress as k, validateCosmosAddress as l, validateEvmAddress as m, validateRouteAddresses as n, validateSeiAddress as o, parseRouteError as p, validateSolanaAddress as q, routeNetUsd as r, validateAddressForChain as v };
+export { RouteDeclineCode as R, Trustware as T, RouteError as a, RouteErrorCode as b, type RouteErrorFacts as c, RouteFailureCode as d, type RouteProviderOutcome as e, RouteRejectionCode as f, type TrustwareCore as g, assertRouteDeliversValue as h, formatMinimum as i, isRouteError as j, isValueDestroying as k, validateBtcAddress as l, validateCosmosAddress as m, validateEvmAddress as n, validateRouteAddresses as o, parseRouteError as p, validateSeiAddress as q, routeNetUsd as r, validateSolanaAddress as s, validateAddressForChain as v };

package/dist/core.cjs

@@ -83,7 +83,7 @@ var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
     SDK_NAME = "@trustware/sdk";
-    SDK_VERSION = "1.1.16-staging.2";
+    SDK_VERSION = "1.1.16-staging.3";
     API_ROOT = "https://bv-staging-api.trustware.io";
     API_PREFIX = "/api";
     WALLETCONNECT_PROJECT_ID = "72ea74c400f5111d43aea638d7d83a24";
@@ -4105,10 +4105,12 @@ function routeErrorFromResponse(status, body, fallbackMessage) {
 }
 function parseRouteError(raw) {
   if (isRouteError(raw) && raw.providers.length > 0) {
+    const rejected = raw.providers.some((p) => p.outcome === "rejected");
     return {
       codes: providerCodes(raw.providers),
       providers: raw.providers,
-      allDeclined: raw.providers.every((p) => p.outcome !== "failed"),
+      allDeclined: !rejected && raw.providers.every((p) => p.outcome !== "failed"),
+      rejected,
       minimum: firstMinimum(raw.providers.map((p) => p.message))
     };
   }
@@ -4123,6 +4125,7 @@ function parseRouteError(raw) {
     codes,
     providers: [],
     allDeclined: !codes.some((code) => failureCodes.includes(code)),
+    rejected: false,
     minimum: firstMinimum([text])
   };
 }
@@ -4172,7 +4175,7 @@ function formatMinimum(minimum) {
   if (minimum.symbol.toUpperCase() === "USD") return `$${minimum.amount}`;
   return `${minimum.amount} ${minimum.symbol}`;
 }
-var RouteDeclineCode, RouteFailureCode, RouteErrorCode, ALL_PROVIDER_CODES, RouteError, MAX_ROUTE_ERROR_TEXT, ROUTE_SUMMARIES;
+var RouteDeclineCode, RouteFailureCode, RouteRejectionCode, RouteErrorCode, ALL_PROVIDER_CODES, RouteError, MAX_ROUTE_ERROR_TEXT, ROUTE_SUMMARIES;
 var init_routeError = __esm({
   "src/core/routeError.ts"() {
     "use strict";
@@ -4194,18 +4197,25 @@ var init_routeError = __esm({
       Timeout: "timeout",
       ProviderError: "provider_error"
     };
+    RouteRejectionCode = {
+      InvalidAddress: "invalid_address"
+    };
     RouteErrorCode = {
       /** Every provider declined: a negative result, returned as 404. */
       NoRouteAvailable: "no_route_available",
       /** At least one provider failed, so "unroutable" cannot be claimed: 502. */
       ProvidersFailed: "providers_failed",
+      /** The caller's address cannot be valid on its chain; no provider was
+       *  asked. Returned as 400. Fix the request rather than retry it. */
+      InvalidAddress: "invalid_address",
       /** A route came back but the SDK refused it: its fees exceed its output.
        *  Reached client-side, so `status` is 0. */
       FeesExceedOutput: "fees_exceed_output"
     };
     ALL_PROVIDER_CODES = [
       ...Object.values(RouteDeclineCode),
-      ...Object.values(RouteFailureCode)
+      ...Object.values(RouteFailureCode),
+      ...Object.values(RouteRejectionCode)
     ];
     RouteError = class extends Error {
       constructor(params) {
@@ -4219,6 +4229,10 @@ var init_routeError = __esm({
       get isNoRouteAvailable() {
         return this.code === RouteErrorCode.NoRouteAvailable || this.status === 404;
       }
+      /** True when the caller's address was rejected — nothing to retry, fix the request. */
+      get isInvalidAddress() {
+        return this.code === RouteErrorCode.InvalidAddress;
+      }
       /** The distinct provider codes, e.g. ["amount_too_low", "no_routes"]. */
       get providerCodes() {
         return providerCodes(this.providers);
@@ -7340,6 +7354,7 @@ __export(core_exports, {
   RouteError: () => RouteError,
   RouteErrorCode: () => RouteErrorCode,
   RouteFailureCode: () => RouteFailureCode,
+  RouteRejectionCode: () => RouteRejectionCode,
   Trustware: () => Trustware,
   assertRouteDeliversValue: () => assertRouteDeliversValue,
   assertValidPostHook: () => assertValidPostHook,
@@ -7362,6 +7377,7 @@ init_core2();
   RouteError,
   RouteErrorCode,
   RouteFailureCode,
+  RouteRejectionCode,
   Trustware,
   assertRouteDeliversValue,
   assertValidPostHook,