@trustware/sdk-staging 1.1.10-staging.0 → 1.1.11-staging.1

package/dist/{manager-B6NNV-E_.d.ts → manager-BY3NHAks.d.ts}

@@ -236,7 +236,36 @@ declare function submitReceipt(intentId: string, txHash: string, sponsorshipRequ
  *  executes from a smart account, so the backend records the tx against the
  *  address the user actually connects with. */
 eoaAddress?: string): Promise<any>;
+/**
+ * Reports the submitted tx hash for one execution step of a multi-step
+ * route — approve steps only; the main tx keeps going through
+ * `submitReceipt`. `stepIndex` is the step's position in
+ * `route.execution.approvals` (the backend seeds its step plan in the same
+ * order). Best-effort telemetry: callers fire-and-forget so a failed report
+ * never blocks the payment flow, but a successful one lets the backend tell
+ * "approve landed, main never followed" apart from an intent the user
+ * abandoned before signing anything.
+ */
+declare function submitStepReceipt(intentId: string, stepIndex: number, txHash: string): Promise<any>;
+/**
+ * Fetches the current status for a route intent.
+ *
+ * Response contract:
+ * - 404 (throws)              → intent doesn't exist. Stop polling.
+ * - 200 status: "pending"     → intent exists, no receipt yet. Keep polling.
+ * - 200 status: "submitted"   → receipt in, tx in flight. Keep polling.
+ * - 200 status: "bridging"    → cross-chain leg in progress. Keep polling.
+ * - 200 status: "success"/"failed" → terminal. Stop polling.
+ *
+ * A "pending" payload is a stub ({intent_id, status, intent_status,
+ * create_date}) — the full Transaction fields appear once a receipt lands.
+ */
 declare function getStatus(intentId: string): Promise<Transaction>;
+/**
+ * Polls intent status until terminal ("success"/"failed") or timeout.
+ * Non-terminal statuses ("pending", "submitted", "bridging") keep the loop
+ * going; a 404 (unknown intent) throws out of the loop — don't retry it.
+ */
 declare function pollStatus(intentId: string, { intervalMs, timeoutMs }?: {
     intervalMs?: number | undefined;
     timeoutMs?: number | undefined;
@@ -283,11 +312,30 @@ type Transaction = {
     destTxHash: string;
     requestId: string;
     transactionRequest: unknown;
-    status: "submitted" | "bridging" | "success" | "failed";
+    /**
+     * "pending" means the intent exists but no receipt has been submitted yet —
+     * the backend returns it (HTTP 200) instead of the old 404 so pollers can
+     * tell "not ready yet, keep polling" apart from "unknown intent" (a real
+     * 404, which means stop polling). A pending response carries only
+     * `intent_id`, `status`, `intent_status`, and `create_date`; the other
+     * Transaction fields are absent until a receipt lands.
+     */
+    status: "pending" | "submitted" | "bridging" | "success" | "failed";
     statusRaw?: unknown;
     routePath?: unknown;
     routeStatus?: unknown;
+    /**
+     * Exact once landed_amount_verified is true; otherwise a pre-trade quote
+     * estimate copied in when the transaction was submitted — neither Squid's
+     * nor LiFi's status API carries a real landed-amount field, so the
+     * backend confirms it by reading the destination chain directly instead
+     * (see BVT-246). Check `landed_amount_verified` before auto-continuing
+     * on this value.
+     */
     toAmountWei?: string | number;
+    /** True once toAmountWei has been confirmed on-chain rather than being the
+     *  pre-trade quote estimate. Wire field: `landed_amount_verified`. */
+    landed_amount_verified?: boolean;
     fromChainBlock: number;
     toChainBlock: number;
     fromChainTxUrl?: string;
@@ -793,4 +841,4 @@ declare function useWalletInfo(wagmi?: WagmiBridge): {
 };
 declare function useWalletExternalDisconnect(cb: () => void): void;
 
-export { type WalletConnectConfig as $, type ResolvedWalletConnectConfig as A, type BuildRouteBody as B, type RetryConfig as C, type DetectedWallet as D, type EIP1193 as E, type FeatureFlags as F, type RouteApproval as G, type RouteEstimate as H, IdentityStore as I, type RouteIntent as J, type RouteParams as K, type RoutePlan as L, type RouteSponsorship as M, type RoutesConfig as N, type SimpleWalletInterface as O, type PostHookRequest as P, type SponsorshipApproval as Q, type RateLimitInfo as R, type SolanaProviderLike as S, type TrustwareConfigOptions as T, type SwapTokenRef as U, type TrustwareTheme as V, type WalletMeta as W, type TrustwareWidgetMessages as X, type WalletAddressResolution as Y, type WalletAddressSource as Z, type WalletCategory as _, type WalletId as a, type WalletEcosystem as a0, type WalletIdentity as a1, type WalletIdentityAddress as a2, type WalletIdentityChainLike as a3, buildWalletIdentityAddress as a4, createWalletIdentity as a5, resolveWalletAddressForChain as a6, upsertWalletIdentityAddress as a7, buildRoute as a8, buildDepositAddress as a9, submitReceipt as aa, getStatus as ab, pollStatus as ac, type SolanaWalletInterface as b, type WagmiBridge as c, type WagmiConnector as d, type WalletSnapshot as e, useWalletExternalDisconnect as f, useWalletInfo as g, useWireDetectionIntoManager as h, type WalletInterFaceAPI as i, TrustwareError as j, type Transaction as k, type TrustwareEvent as l, type BuildRouteResponse as m, type BuildRouteResult as n, DEFAULT_AUTO_DETECT_PROVIDER as o, DEFAULT_FEATURE_FLAGS as p, DEFAULT_MESSAGES as q, DEFAULT_RETRY_CONFIG as r, DEFAULT_SLIPPAGE as s, type EIP6963ProviderDetail as t, useWalletConnectConnect as u, type EvmWalletInterface as v, walletManager as w, type ResolvedFeatureFlags as x, type ResolvedRetryConfig as y, type ResolvedTrustwareConfig as z };
+export { type WalletConnectConfig as $, type ResolvedWalletConnectConfig as A, type BuildRouteBody as B, type RetryConfig as C, type DetectedWallet as D, type EIP1193 as E, type FeatureFlags as F, type RouteApproval as G, type RouteEstimate as H, IdentityStore as I, type RouteIntent as J, type RouteParams as K, type RoutePlan as L, type RouteSponsorship as M, type RoutesConfig as N, type SimpleWalletInterface as O, type PostHookRequest as P, type SponsorshipApproval as Q, type RateLimitInfo as R, type SolanaProviderLike as S, type TrustwareConfigOptions as T, type SwapTokenRef as U, type TrustwareTheme as V, type WalletMeta as W, type TrustwareWidgetMessages as X, type WalletAddressResolution as Y, type WalletAddressSource as Z, type WalletCategory as _, type WalletId as a, type WalletEcosystem as a0, type WalletIdentity as a1, type WalletIdentityAddress as a2, type WalletIdentityChainLike as a3, buildWalletIdentityAddress as a4, createWalletIdentity as a5, resolveWalletAddressForChain as a6, upsertWalletIdentityAddress as a7, buildRoute as a8, buildDepositAddress as a9, submitReceipt as aa, submitStepReceipt as ab, getStatus as ac, pollStatus as ad, type SolanaWalletInterface as b, type WagmiBridge as c, type WagmiConnector as d, type WalletSnapshot as e, useWalletExternalDisconnect as f, useWalletInfo as g, useWireDetectionIntoManager as h, type WalletInterFaceAPI as i, TrustwareError as j, type Transaction as k, type TrustwareEvent as l, type BuildRouteResponse as m, type BuildRouteResult as n, DEFAULT_AUTO_DETECT_PROVIDER as o, DEFAULT_FEATURE_FLAGS as p, DEFAULT_MESSAGES as q, DEFAULT_RETRY_CONFIG as r, DEFAULT_SLIPPAGE as s, type EIP6963ProviderDetail as t, useWalletConnectConnect as u, type EvmWalletInterface as v, walletManager as w, type ResolvedFeatureFlags as x, type ResolvedRetryConfig as y, type ResolvedTrustwareConfig as z };

package/dist/{manager-BwjyFjjz.d.cts → manager-DT8enQbE.d.cts}

@@ -236,7 +236,36 @@ declare function submitReceipt(intentId: string, txHash: string, sponsorshipRequ
  *  executes from a smart account, so the backend records the tx against the
  *  address the user actually connects with. */
 eoaAddress?: string): Promise<any>;
+/**
+ * Reports the submitted tx hash for one execution step of a multi-step
+ * route — approve steps only; the main tx keeps going through
+ * `submitReceipt`. `stepIndex` is the step's position in
+ * `route.execution.approvals` (the backend seeds its step plan in the same
+ * order). Best-effort telemetry: callers fire-and-forget so a failed report
+ * never blocks the payment flow, but a successful one lets the backend tell
+ * "approve landed, main never followed" apart from an intent the user
+ * abandoned before signing anything.
+ */
+declare function submitStepReceipt(intentId: string, stepIndex: number, txHash: string): Promise<any>;
+/**
+ * Fetches the current status for a route intent.
+ *
+ * Response contract:
+ * - 404 (throws)              → intent doesn't exist. Stop polling.
+ * - 200 status: "pending"     → intent exists, no receipt yet. Keep polling.
+ * - 200 status: "submitted"   → receipt in, tx in flight. Keep polling.
+ * - 200 status: "bridging"    → cross-chain leg in progress. Keep polling.
+ * - 200 status: "success"/"failed" → terminal. Stop polling.
+ *
+ * A "pending" payload is a stub ({intent_id, status, intent_status,
+ * create_date}) — the full Transaction fields appear once a receipt lands.
+ */
 declare function getStatus(intentId: string): Promise<Transaction>;
+/**
+ * Polls intent status until terminal ("success"/"failed") or timeout.
+ * Non-terminal statuses ("pending", "submitted", "bridging") keep the loop
+ * going; a 404 (unknown intent) throws out of the loop — don't retry it.
+ */
 declare function pollStatus(intentId: string, { intervalMs, timeoutMs }?: {
     intervalMs?: number | undefined;
     timeoutMs?: number | undefined;
@@ -283,11 +312,30 @@ type Transaction = {
     destTxHash: string;
     requestId: string;
     transactionRequest: unknown;
-    status: "submitted" | "bridging" | "success" | "failed";
+    /**
+     * "pending" means the intent exists but no receipt has been submitted yet —
+     * the backend returns it (HTTP 200) instead of the old 404 so pollers can
+     * tell "not ready yet, keep polling" apart from "unknown intent" (a real
+     * 404, which means stop polling). A pending response carries only
+     * `intent_id`, `status`, `intent_status`, and `create_date`; the other
+     * Transaction fields are absent until a receipt lands.
+     */
+    status: "pending" | "submitted" | "bridging" | "success" | "failed";
     statusRaw?: unknown;
     routePath?: unknown;
     routeStatus?: unknown;
+    /**
+     * Exact once landed_amount_verified is true; otherwise a pre-trade quote
+     * estimate copied in when the transaction was submitted — neither Squid's
+     * nor LiFi's status API carries a real landed-amount field, so the
+     * backend confirms it by reading the destination chain directly instead
+     * (see BVT-246). Check `landed_amount_verified` before auto-continuing
+     * on this value.
+     */
     toAmountWei?: string | number;
+    /** True once toAmountWei has been confirmed on-chain rather than being the
+     *  pre-trade quote estimate. Wire field: `landed_amount_verified`. */
+    landed_amount_verified?: boolean;
     fromChainBlock: number;
     toChainBlock: number;
     fromChainTxUrl?: string;
@@ -793,4 +841,4 @@ declare function useWalletInfo(wagmi?: WagmiBridge): {
 };
 declare function useWalletExternalDisconnect(cb: () => void): void;
 
-export { type WalletConnectConfig as $, type ResolvedWalletConnectConfig as A, type BuildRouteBody as B, type RetryConfig as C, type DetectedWallet as D, type EIP1193 as E, type FeatureFlags as F, type RouteApproval as G, type RouteEstimate as H, IdentityStore as I, type RouteIntent as J, type RouteParams as K, type RoutePlan as L, type RouteSponsorship as M, type RoutesConfig as N, type SimpleWalletInterface as O, type PostHookRequest as P, type SponsorshipApproval as Q, type RateLimitInfo as R, type SolanaProviderLike as S, type TrustwareConfigOptions as T, type SwapTokenRef as U, type TrustwareTheme as V, type WalletMeta as W, type TrustwareWidgetMessages as X, type WalletAddressResolution as Y, type WalletAddressSource as Z, type WalletCategory as _, type WalletId as a, type WalletEcosystem as a0, type WalletIdentity as a1, type WalletIdentityAddress as a2, type WalletIdentityChainLike as a3, buildWalletIdentityAddress as a4, createWalletIdentity as a5, resolveWalletAddressForChain as a6, upsertWalletIdentityAddress as a7, buildRoute as a8, buildDepositAddress as a9, submitReceipt as aa, getStatus as ab, pollStatus as ac, type SolanaWalletInterface as b, type WagmiBridge as c, type WagmiConnector as d, type WalletSnapshot as e, useWalletExternalDisconnect as f, useWalletInfo as g, useWireDetectionIntoManager as h, type WalletInterFaceAPI as i, TrustwareError as j, type Transaction as k, type TrustwareEvent as l, type BuildRouteResponse as m, type BuildRouteResult as n, DEFAULT_AUTO_DETECT_PROVIDER as o, DEFAULT_FEATURE_FLAGS as p, DEFAULT_MESSAGES as q, DEFAULT_RETRY_CONFIG as r, DEFAULT_SLIPPAGE as s, type EIP6963ProviderDetail as t, useWalletConnectConnect as u, type EvmWalletInterface as v, walletManager as w, type ResolvedFeatureFlags as x, type ResolvedRetryConfig as y, type ResolvedTrustwareConfig as z };
+export { type WalletConnectConfig as $, type ResolvedWalletConnectConfig as A, type BuildRouteBody as B, type RetryConfig as C, type DetectedWallet as D, type EIP1193 as E, type FeatureFlags as F, type RouteApproval as G, type RouteEstimate as H, IdentityStore as I, type RouteIntent as J, type RouteParams as K, type RoutePlan as L, type RouteSponsorship as M, type RoutesConfig as N, type SimpleWalletInterface as O, type PostHookRequest as P, type SponsorshipApproval as Q, type RateLimitInfo as R, type SolanaProviderLike as S, type TrustwareConfigOptions as T, type SwapTokenRef as U, type TrustwareTheme as V, type WalletMeta as W, type TrustwareWidgetMessages as X, type WalletAddressResolution as Y, type WalletAddressSource as Z, type WalletCategory as _, type WalletId as a, type WalletEcosystem as a0, type WalletIdentity as a1, type WalletIdentityAddress as a2, type WalletIdentityChainLike as a3, buildWalletIdentityAddress as a4, createWalletIdentity as a5, resolveWalletAddressForChain as a6, upsertWalletIdentityAddress as a7, buildRoute as a8, buildDepositAddress as a9, submitReceipt as aa, submitStepReceipt as ab, getStatus as ac, pollStatus as ad, type SolanaWalletInterface as b, type WagmiBridge as c, type WagmiConnector as d, type WalletSnapshot as e, useWalletExternalDisconnect as f, useWalletInfo as g, useWireDetectionIntoManager as h, type WalletInterFaceAPI as i, TrustwareError as j, type Transaction as k, type TrustwareEvent as l, type BuildRouteResponse as m, type BuildRouteResult as n, DEFAULT_AUTO_DETECT_PROVIDER as o, DEFAULT_FEATURE_FLAGS as p, DEFAULT_MESSAGES as q, DEFAULT_RETRY_CONFIG as r, DEFAULT_SLIPPAGE as s, type EIP6963ProviderDetail as t, useWalletConnectConnect as u, type EvmWalletInterface as v, walletManager as w, type ResolvedFeatureFlags as x, type ResolvedRetryConfig as y, type ResolvedTrustwareConfig as z };

package/dist/{metadata-BiTMMvlY.d.ts → metadata-BPvFYMlc.d.ts}

@@ -1,4 +1,4 @@
-import { D as DetectedWallet, c as WagmiBridge, i as WalletInterFaceAPI, E as EIP1193, a as WalletId, t as EIP6963ProviderDetail, W as WalletMeta } from './manager-B6NNV-E_.js';
+import { D as DetectedWallet, c as WagmiBridge, i as WalletInterFaceAPI, E as EIP1193, a as WalletId, t as EIP6963ProviderDetail, W as WalletMeta } from './manager-BY3NHAks.js';
 
 /** Try wagmi bridge first (if provided), otherwise return EIP-1193 adapter. */
 declare function connectDetectedWallet(dw: DetectedWallet, opts?: {

package/dist/{metadata-HCflXcsF.d.cts → metadata-DyxUcKHk.d.cts}

@@ -1,4 +1,4 @@
-import { D as DetectedWallet, c as WagmiBridge, i as WalletInterFaceAPI, E as EIP1193, a as WalletId, t as EIP6963ProviderDetail, W as WalletMeta } from './manager-BwjyFjjz.cjs';
+import { D as DetectedWallet, c as WagmiBridge, i as WalletInterFaceAPI, E as EIP1193, a as WalletId, t as EIP6963ProviderDetail, W as WalletMeta } from './manager-DT8enQbE.cjs';
 
 /** Try wagmi bridge first (if provided), otherwise return EIP-1193 adapter. */
 declare function connectDetectedWallet(dw: DetectedWallet, opts?: {

package/dist/smart-account.cjs

@@ -12265,7 +12265,7 @@ var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
     SDK_NAME = "@trustware/sdk";
-    SDK_VERSION = "1.1.10-staging.0";
+    SDK_VERSION = "1.1.11-staging.1";
     API_ROOT = "https://bv-staging-api.trustware.io";
     API_PREFIX = "/api";
   }