@stridge/kit 0.1.0-alpha.6 → 0.1.0-alpha.60

package/dist/flows/deposit/widgets/transfer-crypto/compound/types.d.ts

@@ -58,7 +58,7 @@ interface TransferCryptoChain extends TransferCryptoAsset {
    */
   raw?: SupportedAssetDto;
   /**
-   * Full `Uda.supportedAssets()` response that produced the network entry.
+   * Full `Gateway.assets()` response that produced the network entry.
    */
   responseRaw?: SupportedAssetsResponse;
 }
@@ -67,13 +67,19 @@ interface TransferCryptoChain extends TransferCryptoAsset {
  * pins to the first-encountered chain's entry; per-chain context lives on `chainsByToken`.
  */
 interface TransferCryptoToken extends TransferCryptoAsset {
+  /**
+   * Estimated price impact of depositing this token, as a percentage decimal string
+   * (e.g. `"0.5"`). Surfaced on the disclosure row next to the processing-time hint. Omit when
+   * the gateway has no estimate — the row then shows the processing-time hint alone.
+   */
+  priceImpact?: string;
   /**
    * Source token DTO from the pinned chain — `AssetDto` for ERC-20s, `NativeCurrencyDto` for
    * chain-natives. Reflects the first chain the symbol was encountered on; integrators reading
    * per-chain `raw` walk `chainsByToken[symbol]`.
    */
   raw?: AssetDto | NativeCurrencyDto;
-  /** Full `Uda.supportedAssets()` response that produced the token entry. */
+  /** Full `Gateway.assets()` response that produced the token entry. */
   responseRaw?: SupportedAssetsResponse;
 }
 /**
@@ -182,6 +188,14 @@ interface TransferCryptoDisclosureProps {
    * override per route.
    */
   processingTime?: string;
+  /**
+   * Price-impact percentage surfaced on the trigger next to the
+   * processing-time hint (e.g. `"0.5"` renders `"0.5% price impact"`).
+   * Defaults to the active token's `priceImpact`; pass to override per
+   * route. When neither is set the trigger shows the processing-time
+   * hint alone.
+   */
+  priceImpact?: string;
 }
 //#endregion
 export { TransferCryptoAsset, TransferCryptoBodyProps, TransferCryptoChain, TransferCryptoDialogProps, TransferCryptoDisclosureProps, TransferCryptoHeaderProps, TransferCryptoProps, TransferCryptoToken };

package/dist/flows/shared/transformers/computeQuoteAttrs.d.ts

@@ -0,0 +1 @@
+import { QuoteResponse } from "@stridge/sdk";

package/dist/flows/shared/transformers/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/flows/shared/transformers/pickRelevantSettlement.d.ts

@@ -0,0 +1 @@
+import { GatewaySettlementDto, GatewayUdaDto } from "@stridge/sdk";

package/dist/flows/shared/transformers/pickRelevantSettlement.js

@@ -1 +1 @@
-function e(e,t={}){let n=e.settlements??[],r=t.txHash?.toLowerCase(),i=t.sinceIso??``,a=n.filter(e=>r?e.from?.tx_id?.toLowerCase()===r:(e.created_at??``)>=i);if(a.length!==0)return[...a].sort((e,t)=>(t.updated_at??``).localeCompare(e.updated_at??``))[0]}export{e as pickRelevantSettlement};
+function e(e,t={}){let n=e.settlements??[],r=t.txHash?.toLowerCase();if(r){let e=n.filter(e=>e.from?.tx_id?.toLowerCase()===r);return e.length===0?void 0:[...e].sort((e,t)=>(t.updated_at??``).localeCompare(e.updated_at??``))[0]}let i=t.bestMatch;if(i){let t=i.destination.recipientAddress.toLowerCase(),r=i.destination.tokenSymbol.toLowerCase(),a=new Date(i.submittedAt).toISOString(),o=i.sourceAmountBaseUnits,s=n.filter(n=>{let s=n.created_at??``;if(s&&s<a)return!1;let c=e.destination;return!(Number(c.eip155_id)!==i.destination.chainId||(c.asset_symbol??``).toLowerCase()!==r||(c.address??``).toLowerCase()!==t||o!==void 0&&n.from?.raw_amount!==o)});return s.length===0?void 0:[...s].sort((e,t)=>(t.updated_at??``).localeCompare(e.updated_at??``))[0]}let a=t.sinceIso??``,o=n.filter(e=>(e.created_at??``)>=a);if(o.length!==0)return[...o].sort((e,t)=>(t.updated_at??``).localeCompare(e.updated_at??``))[0]}export{e as pickRelevantSettlement};

package/dist/flows/shared/transformers/testnets.js

@@ -0,0 +1 @@
+const e=new Set([11155111,5,80001,80002,84532,421614,11155420,97]);export{e as KNOWN_TESTNET_EIP155_IDS};

package/dist/flows/withdraw/bindings/WithdrawBindings.d.ts

@@ -0,0 +1,92 @@
+import { WithdrawSubmitCallback } from "../orchestrator/types.js";
+import { ReactNode } from "react";
+//#region src/flows/withdraw/bindings/WithdrawBindings.d.ts
+/**
+ * Withdrawable balance the host surfaces to the withdraw form. Two accepted forms:
+ *
+ * - `number` — bare amount in display units (kit infers symbol from the provider-level
+ *   `asset.symbol`; USD value is derived for known stablecoins or hidden otherwise).
+ * - `{ amount, amountUsd? }` — explicit amount plus optional pre-computed USD value.
+ *
+ * `undefined` represents the loading state — the kit renders a skeleton / em-dashes instead
+ * of a value.
+ */
+type WithdrawBalanceInput = number | {
+  amount: number;
+  amountUsd?: number;
+};
+/**
+ * Trusted-recipient prefill chip surfaced next to the recipient address input. The kit no
+ * longer auto-derives a chip from `wagmi.address` — that misled users on embedded-wallet
+ * integrations, where `wagmi.address` is the integration's generated wallet rather than the
+ * user's primary self-custodial wallet. Hosts that have a verified, user-trusted address (a
+ * saved wallet on the user's profile, a KYC-bound payout destination, a whitelisted withdrawal
+ * address) pass it via {@link useWithdrawBindings} (or the `<WithdrawDialog>` prop of the same
+ * name); the chip's `aria-label` reads off `label` so the affordance is unambiguous about which
+ * address the user is filling with.
+ */
+interface WithdrawSuggestedRecipient {
+  /** Address that fills the recipient input when the chip is clicked. */
+  address: string;
+  /**
+   * Short human label for the chip — used as the accessible name (`aria-label`) so screen
+   * readers and click targets describe the saved address concretely (e.g. `"Saved wallet"`,
+   * `"Your verified address"`). When omitted, the chip falls back to a generic kit-default.
+   */
+  label?: string;
+  /**
+   * Receive-side chain id this address belongs to (EIP-155 numeric). When set, the chip is
+   * surfaced only while the form's selected receive chain matches — prevents the user from
+   * one-click-filling an Ethereum address while routing to BSC, etc. When omitted, the chip
+   * is surfaced unconditionally and address-chain compatibility is the integrator's concern.
+   */
+  chainId?: number;
+}
+/**
+ * Render-time inputs the host supplies to the withdraw flow. Whoever renders the withdraw UI —
+ * the kit's `<WithdrawDialog>` or a fully custom headless surface — publishes these via
+ * {@link useWithdrawBindings}. Form widgets read the display values reactively; the orchestrator's
+ * submit action reads `onSubmit` at submit time to fire the host's callback.
+ */
+interface WithdrawBindings {
+  /** Host-supplied source-side balance the form renders. */
+  balance?: WithdrawBalanceInput;
+  /**
+   * Host-supplied submit handler. Fired when the user submits the form (after the kit has
+   * prepared a fresh UDA target). The host calls the supplied actions to advance the FSM at
+   * the points its backend reaches the matching state.
+   */
+  onSubmit?: WithdrawSubmitCallback;
+  /**
+   * Trusted recipient address surfaced as a prefill chip on the recipient field. See
+   * {@link WithdrawSuggestedRecipient}.
+   */
+  suggestedRecipient?: WithdrawSuggestedRecipient;
+}
+/**
+ * Publish the host's render-time withdraw inputs (`balance`, `onSubmit`, `suggestedRecipient`)
+ * into the kit's withdraw scope. Call it once from whatever component renders the withdraw UI:
+ *
+ * - The kit's `<WithdrawDialog>` calls it internally with its render-time props.
+ * - A **headless** host that renders fully custom withdraw UI from `useWithdraw()` /
+ *   `useWithdrawState()` / `useWithdrawSnapshot()` calls it directly — it's the supported way
+ *   to wire `onSubmit` (and the optional display inputs) without mounting the dialog.
+ *
+ * Writes synchronously to the bridge ref during render so the controller's submit action always
+ * reads the latest `onSubmit`; a deferred `setState` updates the reactive state read by display
+ * widgets. Clears the bridge on unmount.
+ *
+ * @example Headless usage
+ * ```tsx
+ * useWithdrawBindings({
+ *     balance: walletBalance,
+ *     onSubmit: async (input, actions) => {
+ *         const txHash = await backend.broadcastWithdrawal(input.depositTarget);
+ *         actions.beginProcessing({ hash: txHash });
+ *     },
+ * });
+ * ```
+ */
+declare function useWithdrawBindings(bindings: WithdrawBindings): void;
+//#endregion
+export { WithdrawBalanceInput, WithdrawBindings, WithdrawSuggestedRecipient, useWithdrawBindings };

package/dist/flows/withdraw/bindings/WithdrawBindings.js

@@ -0,0 +1 @@
+"use client";import{createContext as e,use as t,useEffect as n,useMemo as r,useRef as i,useState as a}from"react";import{jsx as o}from"react/jsx-runtime";const s=e(null);s.displayName=`WithdrawBindingsContext`;function c({children:e}){let[t,n]=a({}),c=i({});return o(s,{value:r(()=>({bindings:t,setBindings:n,ref:c}),[t]),children:e})}function l(){return t(s)?.bindings??{}}function u(){let e=t(s),n=i({});return e?.ref??n}function d(e){let r=t(s),a=e.balance,o=e.onSubmit,c=e.suggestedRecipient;r&&(r.ref.current={...a===void 0?{}:{balance:a},...o?{onSubmit:o}:{},...c?{suggestedRecipient:c}:{}});let l=i(r?.setBindings);l.current=r?.setBindings;let u=i(r?.ref);u.current=r?.ref,n(()=>{let e=l.current;if(e)return e({...a===void 0?{}:{balance:a},...o?{onSubmit:o}:{},...c?{suggestedRecipient:c}:{}}),()=>{let e=l.current,t=u.current;t&&(t.current={}),e&&e({})}},[a,o,c])}export{c as WithdrawBindingsProvider,d as useWithdrawBindings,u as useWithdrawBindingsRef,l as useWithdrawBindingsValue};

package/dist/flows/withdraw/bindings/index.d.ts

@@ -0,0 +1 @@
+import { WithdrawBalanceInput, WithdrawBindings, WithdrawSuggestedRecipient, useWithdrawBindings } from "./WithdrawBindings.js";

package/dist/flows/withdraw/bindings/index.js

@@ -0,0 +1 @@
+import"./WithdrawBindings.js";

package/dist/flows/withdraw/dialog/WithdrawDialog.d.ts

@@ -1,102 +1,75 @@
-import { TxRef } from "../../../shared/driver/types.js";
-import { WithdrawalQuotePayload, WithdrawalSettlementFailurePayload, WithdrawalSettlementPendingPayload, WithdrawalSettlementSuccessPayload } from "../driver/payloads.js";
-import { SubmitWithdrawalInput } from "../driver/types.js";
-import { FailureInfo } from "../../../shared/orchestrator/types.js";
-import { WithdrawStateName } from "../orchestrator/types.js";
-import { WithdrawFormEventCallbacks } from "./WithdrawDialogEventsContext.js";
+import { Presentation } from "../../../shared/presentation/types.js";
+import { WithdrawSubmitCallback } from "../orchestrator/types.js";
+import { WithdrawBalanceInput, WithdrawSuggestedRecipient } from "../bindings/WithdrawBindings.js";
 import { ErrorInfo } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/flows/withdraw/dialog/WithdrawDialog.d.ts
 /**
- * Top-level withdraw dialog. Mounts inside `<KitProvider withdraw={…} />` once at the host's
- * app root and binds open state to the controller's `state.name !== "closed"`.
+ * Top-level withdraw dialog. Mounts inside `<StridgeProvider>` and binds open state to the
+ * controller's `state.name !== "closed"`.
  *
  * Body switch is keyed off the orchestrator's *effective* state (not logical state) so the
  * widget the user was looking at stays mounted through the dialog's close animation.
  *
- * Three top-level callbacks (`onOpened`, `onClosed`, `onStepChanged`) describe the dialog as a
- * stateful component. The grouped `events={{ … }}` prop carries the operational lifecycle —
- * form-level inputs, quote / submit / settlement transitions for the active withdrawal.
+ * Lifecycle observability is delivered by the unified event bus exported from
+ * `@stridge/kit/events`. The dialog takes no `on*` callback props; subscribe via
+ * `useStridgeFlowEvents` / `useStridgeEvents` for analytics or behavioural reactions.
+ * `onSubmit` is the host contract — its return value drives the FSM, distinct from any bus
+ * event.
  */
 declare function WithdrawDialog({
   container,
+  metadata,
   onError,
-  onOpened,
-  onClosed,
-  onStepChanged,
-  events
+  balance,
+  onSubmit,
+  suggestedRecipient,
+  presentation
 }?: WithdrawDialog.Props): _$react_jsx_runtime0.JSX.Element;
 declare namespace WithdrawDialog {
   interface Props {
     /**
      * Element the dialog portals into. Defaults to `document.body` (full-page overlay).
-     * Pass a transformed ancestor with `overflow: clip` — e.g. a mobile mockup frame — to
-     * scope the dialog's width, height, and backdrop to that rect.
      */
     container?: HTMLElement | null;
+    /**
+     * Consumer-attached metadata that rides along on every bus event emitted from this
+     * dialog's session. Snapshotted at `withdraw.opened` and frozen for the session.
+     */
+    metadata?: Record<string, unknown>;
     /** Forwarded to the dialog's internal {@link GatewayKitBoundary} for crash reporting. */
     onError?: (error: Error, errorInfo: ErrorInfo) => void;
     /**
-     * Fires once when the dialog transitions from `closed` to any open step. The withdraw
-     * flow has no `open({ method })` overload — `onOpened` carries no payload.
+     * Withdrawable balance to display in the form. Either a bare amount in display units
+     * (kit short-circuits USD to $1 for known stablecoins) or `{ amount, amountUsd? }`
+     * with an explicit pre-computed USD value. Pass `undefined` while loading; the form
+     * renders a skeleton until a value arrives.
      */
-    onOpened?: () => void;
-    /** Fires once when the dialog transitions back to `closed`. `atStep` is the last open step. */
-    onClosed?: (atStep: WithdrawStateName) => void;
-    /** Fires on every logical step transition. */
-    onStepChanged?: (event: {
-      from: WithdrawStateName;
-      to: WithdrawStateName;
-    }) => void;
+    balance?: WithdrawBalanceInput;
     /**
-     * Operational events — user actions, quote / submit / settlement transitions for the
-     * active withdrawal. Each callback is optional and fires after the controller has acted
-     * (state machine has transitioned, driver entity has settled), so payloads are guaranteed
-     * valid for the named event.
+     * Submit handler — fires once the kit has prepared a fresh UDA target for the
+     * withdrawal. The host's backend is responsible for broadcasting a transfer of the
+     * brand currency to that UDA; the kit hands a `WithdrawSubmitActions` handle the host
+     * calls (`beginProcessing` / `setTxHash` / `succeed` / `fail` / `decline`) to advance
+     * the FSM. Required when the dialog is used — a missing callback lands the user on
+     * the error screen instead of an infinite spinner. This is a contract, not a bus
+     * event: return value drives the FSM.
      */
-    events?: Events;
-  }
-  /**
-   * Operational lifecycle hooks. Splits cleanly into:
-   *
-   * - **Form-level inputs** (`onRecipientChanged` / `onAmountChanged` / `onReceiveTokenChanged`
-   *   / `onReceiveChainChanged`) — fire on every change of the form's local state.
-   * - **User actions** (`onWithdrawalConfirmed`) — fire when the user submits the form.
-   * - **Quote lifecycle** — track the form's quote entity through `loading → ready / error`.
-   * - **Submit lifecycle** — track the wagmi-driven broadcast through wagmi → receipt → terminal
-   *   verdict.
-   * - **Settlement entity** — track the gateway's settlement payload through pending / succeeded /
-   *   failed.
-   */
-  interface Events extends WithdrawFormEventCallbacks {
-    /** User submitted the form (the SUBMIT action — wallet prompt is about to fire). */
-    onWithdrawalConfirmed?: () => void;
-    /** Quote entity reached `ready` with the formatted payload. */
-    onQuoteResolved?: (quote: WithdrawalQuotePayload) => void;
-    /** Quote entity reached `error`. */
-    onQuoteFailed?: (failure: {
-      reason: string;
-      code?: string;
-    }) => void;
-    /** Wagmi broadcast completed and the orchestrator transitioned into `inProgress`. */
-    onWithdrawalSubmitted?: (event: {
-      input: SubmitWithdrawalInput;
-      tx: TxRef;
-    }) => void;
-    /** User declined the wallet signature prompt; orchestrator transitioned into `error`. */
-    onSignatureDeclined?: () => void;
-    /** Submission failed for a non-rejection reason (network, bad input, etc). */
-    onSubmissionFailed?: (failure: FailureInfo) => void;
-    /** The driver's `settlement` entity emitted a progressive pending update. */
-    onProcessingProgress?: (update: WithdrawalSettlementPendingPayload) => void;
-    /** Terminal success — settlement entity reached `ready{kind: "succeeded"}`. */
-    onSucceeded?: (result: WithdrawalSettlementSuccessPayload) => void;
+    onSubmit?: WithdrawSubmitCallback;
+    /**
+     * Trusted recipient address surfaced as a one-click prefill chip next to the
+     * recipient input. The kit no longer auto-derives this from `wagmi.address`. Pass an
+     * explicit address you trust the user wants to fill with. Omit to hide the chip.
+     */
+    suggestedRecipient?: WithdrawSuggestedRecipient;
     /**
-     * Terminal failure — either a settlement-driven failure (driver-emitted classification) or
-     * an FSM-derived failure (submission rejection escalated to the global error arm).
+     * Per-dialog surface override. `"auto"` (default) renders a centred dialog on wide
+     * containers and a bottom-sheet drawer below the breakpoint; `"dialog"` / `"drawer"`
+     * force one surface. Pass `{ mode, breakpoint }` to tune the px threshold (default 600).
+     * Wins over the provider's `appearance.presentation`; omit to inherit it.
      */
-    onFailed?: (failure: WithdrawalSettlementFailurePayload | FailureInfo) => void;
+    presentation?: Presentation;
   }
 }
 //#endregion

package/dist/flows/withdraw/dialog/WithdrawDialog.js

@@ -1 +1 @@
-"use client";import{useDialogLifecycle as e}from"../../../shared/orchestrator/useDialogLifecycle.js";import"../../../shared/orchestrator/index.js";import{useWithdrawSnapshot as t}from"../driver/context.js";import{useWithdrawEffectiveState as n,useWithdrawState as r}from"../orchestrator/controller.js";import{useWithdraw as i}from"../orchestrator/useWithdraw.js";import"../orchestrator/index.js";import{Dialog as a}from"../../../shared/ui/Dialog/Dialog.js";import"../../../shared/ui/Dialog/index.js";import{StepTransition as o}from"../../../shared/dialog/StepTransition.js";import{GatewayKitBoundary as s}from"../../../shared/error-handling/components/GatewayKitBoundary.js";import"../../../shared/error-handling/index.js";import{WithdrawError as c}from"../widgets/withdraw-error/WithdrawError.js";import{WithdrawDialogEventsProvider as l}from"./WithdrawDialogEventsContext.js";import{WithdrawForm as u}from"../widgets/withdraw-form/WithdrawForm.js";import{WithdrawInProgress as d}from"../widgets/withdraw-in-progress/WithdrawInProgress.js";import{WithdrawSuccess as f}from"../widgets/withdraw-success/WithdrawSuccess.js";import"../../../_internal/withdraw/widgets/index.js";import{useRef as p}from"react";import{jsx as m,jsxs as h}from"react/jsx-runtime";function g({container:e,onError:p,onOpened:g,onClosed:v,onStepChanged:y,events:b}={}){let x=r(),S=n(),{close:C}=i(),w=t(),T=x.name!==`closed`;_(x,w.settlement,w.quote,{onOpened:g,onClosed:v,onStepChanged:y,events:b});let E=S.name===`submitting`?`form`:S.name;return m(a,{open:T,onOpenChange:e=>e?void 0:C(),children:m(a.Content,{container:e,children:m(s,{onError:p,onReset:C,children:m(l,{events:b??{},children:h(o,{stateKey:E,children:[S.name===`form`||S.name===`submitting`?m(u,{}):null,S.name===`inProgress`?m(d,{}):null,S.name===`success`?m(f,{}):null,S.name===`error`?m(c,{}):null]})})})})})}function _(t,n,r,i){let a=p(i);a.current=i,e({state:t,settlement:n,quote:r,fireFsm:(e,t)=>v(e,t,a.current),fireSettlement:(e,t)=>y(t,a.current),fireQuote:(e,t)=>{if(t.status===e)return;let n=a.current.events;t.status===`ready`&&n?.onQuoteResolved?.(t.payload),t.status===`error`&&n?.onQuoteFailed?.({reason:t.error.message||`Quote failed.`,...t.error.name?{code:t.error.name}:{}})}})}function v(e,t,n){let{onOpened:r,onClosed:i,onStepChanged:a,events:o}=n,s=e.name===`form`&&!!e.ctx?.notice;if(t.name===`form`&&t.ctx?.notice&&!s&&o?.onSignatureDeclined?.(),e.name!==t.name&&(e.name===`closed`&&t.name!==`closed`&&r?.(),e.name!==`closed`&&t.name===`closed`&&i?.(e.name),a?.({from:e.name,to:t.name}),e.name===`form`&&t.name===`submitting`&&o?.onWithdrawalConfirmed?.(),e.name===`submitting`&&t.name===`inProgress`&&o?.onWithdrawalSubmitted?.({input:t.ctx.input,tx:t.ctx.tx}),t.name===`error`)){let e=t.ctx.failure;e!==void 0&&t.ctx.tx===void 0&&e&&(o?.onSubmissionFailed?.(e),o?.onFailed?.(e))}}function y(e,t){if(e.status!==`ready`&&e.status!==`stale`)return;let n=e.payload,r=t.events;if(r){if(n.kind===`pending`){r.onProcessingProgress?.(n);return}if(n.kind===`succeeded`){r.onSucceeded?.(n);return}n.kind===`failed`&&r.onFailed?.(n)}}export{g as WithdrawDialog};
+"use client";import{useWithdrawBindings as e}from"../bindings/WithdrawBindings.js";import"../bindings/index.js";import{useWithdrawSnapshot as t}from"../driver/context.js";import{useWithdrawState as n}from"../orchestrator/controller.js";import{useWithdraw as r}from"../orchestrator/useWithdraw.js";import"../orchestrator/index.js";import{useWithdrawEmissions as i}from"../../../events/emit/useWithdrawEmissions.js";import"../../../events/emit/index.js";import{useIntercomShutdownOnUnmount as a}from"../../../shared/support/useIntercomShutdownOnUnmount.js";import"../../../shared/support/index.js";import{AdaptiveSurface as o}from"../../../shared/ui/AdaptiveSurface/AdaptiveSurface.js";import"../../../shared/ui/AdaptiveSurface/index.js";import{Withdraw as s}from"../widgets/withdraw/compound/Withdraw.js";import"../../../withdraw/compound/index.js";import{WithdrawActivityDetail as c}from"../widgets/activity/WithdrawActivityDetail.js";import{WithdrawActivityList as l}from"../widgets/activity/WithdrawActivityList.js";import{WithdrawError as u}from"../widgets/withdraw-error/WithdrawError.js";import{WithdrawForm as d}from"../widgets/withdraw-form/WithdrawForm.js";import{WithdrawInProgress as f}from"../widgets/withdraw-in-progress/WithdrawInProgress.js";import{WithdrawSuccess as p}from"../widgets/withdraw-success/WithdrawSuccess.js";import"../../../withdraw/widgets/index.js";import{jsx as m,jsxs as h}from"react/jsx-runtime";function g({container:g,metadata:_,onError:v,balance:y,onSubmit:b,suggestedRecipient:x,presentation:S}={}){let C=n(),{close:w}=r(),T=t(),E=C.name!==`closed`;return i({state:C,settlement:T.settlement,quote:T.quote,metadata:_}),a(),e({...y===void 0?{}:{balance:y},...b?{onSubmit:b}:{},...x?{suggestedRecipient:x}:{}}),m(o,{open:E,onOpenChange:e=>e?void 0:w(),container:g,...S?{presentation:S}:{},children:m(s.Boundary,{...v?{onError:v}:{},children:m(s.Guards,{children:h(s.Steps,{children:[m(s.Step,{name:`form`,children:m(d,{})}),m(s.Step,{name:`inProgress`,children:m(f,{})}),m(s.Step,{name:`success`,children:m(p,{})}),m(s.Step,{name:`error`,children:m(u,{})}),m(s.Step,{name:`activityList`,children:m(l,{})}),m(s.Step,{name:`activityDetail`,children:m(c,{})})]})})})})}export{g as WithdrawDialog};

package/dist/flows/withdraw/driver/dto.d.ts

@@ -1,4 +1,4 @@
-import { GatewayPollResponse, GatewaySettlementDto, OnchainBalanceResponse, QuoteResponse, SupportedAssetDto, SupportedAssetsResponse } from "@stridge/sdk";
+import { GatewaySettlementDto, GatewayUdaDto, OnchainBalanceResponse, QuoteResponse, SupportedAssetDto, SupportedAssetsResponse } from "@stridge/sdk";
 
 //#region src/flows/withdraw/driver/dto.d.ts
 /**
@@ -22,18 +22,19 @@ type WithdrawalQuoteResponse = QuoteResponse;
  */
 type WithdrawalSettlementDto = GatewaySettlementDto;
 /**
- * Full `gateway/{owner}` poll response. Carries `destination` plus `settlements[]`. Used as the
- * `response` slot on the settlement entity envelope so headless integrators can correlate against
- * the UDA-level destination metadata.
+ * Per-UDA view from `gateway/{owner}`. Carries the UDA's `destination` plus `settlements[]`. Used
+ * as the `response` slot on the settlement entity envelope so headless integrators can correlate
+ * against the UDA-level destination metadata. The kit's `pollOnce` boundary picks the matching
+ * UDA out of the gateway's multi-UDA envelope before this type is observed downstream.
  */
-type WithdrawalSettlementResponse = GatewayPollResponse;
+type WithdrawalSettlementResponse = GatewayUdaDto;
 /**
- * Per-network entry from `Uda.supportedAssets()`. Surfaced as the `raw` slot on the
+ * Per-network entry from `Gateway.assets()`. Surfaced as the `raw` slot on the
  * `receiveOptions` entity so headless integrators can navigate the catalog without re-fetching.
  */
 type ReceiveOptionDto = SupportedAssetDto;
 /**
- * Full `Uda.supportedAssets()` response. Drives the receive chain + receive token dropdowns on
+ * Full `Gateway.assets()` response. Drives the receive chain + receive token dropdowns on
  * the form.
  */
 type ReceiveOptionsResponse = SupportedAssetsResponse;

package/dist/flows/withdraw/driver/payloads.d.ts

@@ -1,5 +1,7 @@
 import { SettlementFailureKind } from "../../../shared/driver/types.js";
 import { FormattedField } from "../../../shared/format/types.js";
+import { ChainType } from "../../../shared/chains/index.js";
+
 //#region src/flows/withdraw/driver/payloads.d.ts
 /**
  * Per-asset balance available to withdraw — the brand-managed source the cash-out flow draws
@@ -108,6 +110,12 @@ interface WithdrawalSettlementPendingPayload {
   kind: "pending";
   receiveAsset: WithdrawalReceiveAssetPayload;
   receiveAmount: FormattedField<number>;
+  /**
+   * USD value of `receiveAmount` at the settlement leg's price snapshot. Sourced from the
+   * gateway leg's `amount_usd` (`to` preferred, `from` fallback). Omitted when neither leg
+   * carries a priced amount — the in-progress hero then falls back to the quote's USD figure.
+   */
+  receiveAmountUsd?: FormattedField<number>;
   /** Recipient address — the destination the user supplied on the form. */
   recipient: FormattedField<string>;
   /** Unix-ms timestamp when the withdrawal was submitted. */
@@ -191,8 +199,15 @@ interface ReceiveChainPayload {
   networkId: string;
   /** Human-readable network name (e.g. `"Polygon"`). */
   networkName: string;
-  /** EIP-155 chain id (numeric). */
+  /** EIP-155 chain id (numeric). Only meaningful when `chainType === "evm"`. */
   eip155Id: number;
+  /**
+   * Chain family this network belongs to — driver-populated from the gateway's `chain_type`
+   * tag. The withdraw form drives recipient-address validation off this so a non-EVM receive
+   * chain accepts its own address shape instead of the EVM `0x…` form. Drivers that can't
+   * determine the family tag it `"unknown"`, which keeps the address gate permissive.
+   */
+  chainType: ChainType;
   /** Resolved chain icon URL — derived from the chain's native_currency.logo. */
   chainLogoUrl?: string;
   /**

package/dist/flows/withdraw/driver/transformers/settlementToWithdrawalPayload.js

@@ -1 +1 @@
-import{classifyFailureKind as e,classifySettlementStatus as t}from"../../../shared/transformers/classifySettlementStatus.js";import{parseDecimalSafe as n,parseSmallestUnit as r}from"../../../shared/transformers/parseSmallestUnit.js";import{parseIsoMs as i}from"../../../shared/transformers/parseIsoMs.js";import{formatDurationCompact as a}from"../../../../shared/format/formatDurationCompact.js";import{formatTimestamp as o}from"../../../../shared/format/formatTimestamp.js";import{formatTokenAmount as s}from"../../../../shared/format/formatTokenAmount.js";import{shortenAddress as c}from"../../../../shared/format/shortenAddress.js";function l(e,n,r){let i=t(e.status);return i===`completed`?d(e,n,r):i===`failed`?f(e,n,r):u(e,n,r)}function u(e,t,n){let r=e.from,a=e.to,l=i(r?.confirmed_at)??i(e.created_at)??Date.now(),u=p(t,n),d=m(a,t.destination.asset_decimals)||m(r,r?.asset_decimals??t.destination.asset_decimals),f=t.destination.address,g=r?.tx_id,_=r?.eip155_id===void 0?void 0:Number(r.eip155_id);return{kind:`pending`,receiveAsset:u,receiveAmount:{value:d,formatted:s(d,n.i18n,{maxDecimals:t.destination.asset_decimals})},recipient:{value:f,formatted:c(f)},submittedAt:{value:l,formatted:o(l,n.i18n)},...g?{txHash:{value:g,formatted:c(g)},...h(n,_,g)?{txExplorerUrl:h(n,_,g)}:{}}:{}}}function d(e,t,n){let r=e.from,l=e.to,u=i(r?.confirmed_at)??i(e.created_at)??Date.now(),d=i(l?.settled_at)??i(e.updated_at)??Date.now(),f=Math.max(0,d-u),_=Math.round(f/1e3),v=p(t,n),y=m(l,t.destination.asset_decimals),b=t.destination.address,x=r?.tx_id??``,S=r?.eip155_id===void 0?void 0:Number(r.eip155_id),C=l?.tx_id,w=h(n,g(l?.eip155_id)??g(t.destination.eip155_id),C);return{kind:`succeeded`,receiveAsset:v,receiveAmount:{value:y,formatted:s(y,n.i18n,{maxDecimals:t.destination.asset_decimals})},recipient:{value:b,formatted:c(b)},submittedAt:{value:u,formatted:o(u,n.i18n)},filledAt:{value:d,formatted:o(d,n.i18n)},totalTime:{value:_,formatted:a(f,n.i18n)},txHash:{value:x,formatted:x?c(x):``},...h(n,S,x)?{txExplorerUrl:h(n,S,x)}:{},...C?{completionTx:{hash:{value:C,formatted:c(C)},...w?{explorerUrl:w}:{}}}:{}}}function f(t,n,r){let a=t.from,l=i(a?.confirmed_at)??i(t.created_at)??Date.now(),u=i(t.updated_at)??Date.now(),d=p(n,r),f=n.destination.address,m=a?.tx_id,g=a?.eip155_id===void 0?void 0:Number(a.eip155_id);return{kind:`failed`,failureKind:e(t.error),receiveAsset:d,receiveAmount:{value:0,formatted:s(0,r.i18n)},recipient:{value:f,formatted:c(f)},submittedAt:{value:l,formatted:o(l,r.i18n)},failedAt:{value:u,formatted:o(u,r.i18n)},...m?{txHash:{value:m,formatted:c(m)},...h(r,g,m)?{txExplorerUrl:h(r,g,m)}:{}}:{}}}function p(e,t){let n=t.receiveAssetEnrichment,r=Number(e.destination.eip155_id);return{symbol:e.destination.asset_symbol,decimals:e.destination.asset_decimals,address:e.destination.asset_address,isNative:!e.destination.asset_address,...n?.assetLogoUrl?{assetLogoUrl:n.assetLogoUrl}:{},networkId:e.destination.network_id,networkName:n?.networkName??e.destination.network_name,...Number.isFinite(r)?{eip155Id:e.destination.eip155_id}:{},...n?.chainLogoUrl?{chainLogoUrl:n.chainLogoUrl}:{}}}function m(e,t){if(!e)return 0;if(e.amount){let t=n(e.amount);if(t>0)return t}return e.raw_amount?r(e.raw_amount,t):0}function h(e,t,n){if(!n||t===void 0)return;let r=e.explorers?.[t];if(r)return`${r.replace(/\/+$/,``)}/tx/${n}`}function g(e){if(e==null||e===``)return;let t=Number(e);return Number.isFinite(t)?t:void 0}export{l as settlementToWithdrawalPayload};
+import{classifyFailureKind as e,classifySettlementStatus as t}from"../../../shared/transformers/classifySettlementStatus.js";import{parseDecimalSafe as n,parseSmallestUnit as r}from"../../../shared/transformers/parseSmallestUnit.js";import{parseIsoMs as i}from"../../../shared/transformers/parseIsoMs.js";import{formatDurationCompact as a}from"../../../../shared/format/formatDurationCompact.js";import{formatTimestamp as o}from"../../../../shared/format/formatTimestamp.js";import{formatTokenAmount as s}from"../../../../shared/format/formatTokenAmount.js";import{formatUsd as c}from"../../../../shared/format/formatUsd.js";import{shortenAddress as l}from"../../../../shared/format/shortenAddress.js";function u(e,n,r){let i=t(e.status);return i===`completed`?f(e,n,r):i===`failed`?p(e,n,r):d(e,n,r)}function d(e,t,r){let a=e.from,u=e.to,d=i(a?.confirmed_at)??i(e.created_at)??Date.now(),f=m(t,r),p=g(u,t,r),v=h(u,p),y=n(u?.amount_usd)||n(a?.amount_usd),b=t.destination.address,x=a?.tx_id,S=a?.eip155_id===void 0?void 0:Number(a.eip155_id);return{kind:`pending`,receiveAsset:f,receiveAmount:{value:v,formatted:s(v,r.i18n,{maxDecimals:p})},...y>0?{receiveAmountUsd:{value:y,formatted:c(y,r.i18n)}}:{},recipient:{value:b,formatted:l(b)},submittedAt:{value:d,formatted:o(d,r.i18n)},...x?{txHash:{value:x,formatted:l(x)},..._(r,S,x)?{txExplorerUrl:_(r,S,x)}:{}}:{}}}function f(e,t,n){let r=e.from,c=e.to,u=i(r?.confirmed_at)??i(e.created_at)??Date.now(),d=i(c?.settled_at)??i(e.updated_at)??Date.now(),f=Math.max(0,d-u),p=Math.round(f/1e3),y=m(t,n),b=g(c,t,n),x=h(c,b),S=t.destination.address,C=r?.tx_id??``,w=r?.eip155_id===void 0?void 0:Number(r.eip155_id),T=c?.tx_id,E=_(n,v(c?.eip155_id)??v(t.destination.eip155_id),T);return{kind:`succeeded`,receiveAsset:y,receiveAmount:{value:x,formatted:s(x,n.i18n,{maxDecimals:b})},recipient:{value:S,formatted:l(S)},submittedAt:{value:u,formatted:o(u,n.i18n)},filledAt:{value:d,formatted:o(d,n.i18n)},totalTime:{value:p,formatted:a(f,n.i18n)},txHash:{value:C,formatted:C?l(C):``},..._(n,w,C)?{txExplorerUrl:_(n,w,C)}:{},...T?{completionTx:{hash:{value:T,formatted:l(T)},...E?{explorerUrl:E}:{}}}:{}}}function p(t,n,r){let a=t.from,c=i(a?.confirmed_at)??i(t.created_at)??Date.now(),u=i(t.updated_at)??Date.now(),d=m(n,r),f=n.destination.address,p=a?.tx_id,h=a?.eip155_id===void 0?void 0:Number(a.eip155_id);return{kind:`failed`,failureKind:e(t.error),receiveAsset:d,receiveAmount:{value:0,formatted:s(0,r.i18n)},recipient:{value:f,formatted:l(f)},submittedAt:{value:c,formatted:o(c,r.i18n)},failedAt:{value:u,formatted:o(u,r.i18n)},...p?{txHash:{value:p,formatted:l(p)},..._(r,h,p)?{txExplorerUrl:_(r,h,p)}:{}}:{}}}function m(e,t){let n=t.receiveAssetEnrichment,r=Number(e.destination.eip155_id);return{symbol:e.destination.asset_symbol,decimals:e.destination.asset_decimals,address:e.destination.asset_address,isNative:!e.destination.asset_address,...n?.assetLogoUrl?{assetLogoUrl:n.assetLogoUrl}:{},networkId:e.destination.network_id,networkName:n?.networkName??e.destination.network_name,...Number.isFinite(r)?{eip155Id:e.destination.eip155_id}:{},...n?.chainLogoUrl?{chainLogoUrl:n.chainLogoUrl}:{}}}function h(e,t){if(!e)return 0;if(e.amount){let t=n(e.amount);if(t>0)return t}return e.raw_amount?r(e.raw_amount,t):0}function g(e,t,n){return n.receiveAssetDecimals??e?.asset_decimals??t.destination.asset_decimals}function _(e,t,n){if(!n||t===void 0)return;let r=e.explorers?.[t];if(r)return`${r.replace(/\/+$/,``)}/tx/${n}`}function v(e){if(e==null||e===``)return;let t=Number(e);return Number.isFinite(t)?t:void 0}export{u as settlementToWithdrawalPayload};

package/dist/flows/withdraw/driver/transformers/supportedAssetsToReceiveOptionsPayload.js

@@ -1 +1 @@
-import{formatNetworkName as e}from"../../../../shared/format/formatNetworkName.js";function t(t,n={}){let r=n.excludedChainIds,i=[];for(let n of t.assets){if(r?.has(n.eip155_id))continue;let t=n.native_currency,a=new Set,o=(e,t)=>`${e.toUpperCase()}@${t.toLowerCase()}`,s=[];if(t?.symbol){let e={symbol:t.symbol,name:t.name??t.symbol,address:``,decimals:typeof t.decimals==`number`?t.decimals:18,isNative:!0,...t.logo?{assetLogoUrl:t.logo}:{}};s.push(e),a.add(o(e.symbol,e.address))}let c=t?.symbol?.toUpperCase();for(let e of n.assets){if(!e.symbol||!e.address||c&&e.symbol.toUpperCase()===c)continue;let t=o(e.symbol,e.address);a.has(t)||(a.add(t),s.push({symbol:e.symbol,name:e.name??e.symbol,address:e.address,decimals:e.decimals,isNative:!1,...e.logo?{assetLogoUrl:e.logo}:{}}))}s.length!==0&&i.push({networkId:n.network_id,networkName:e(n.network_name),eip155Id:n.eip155_id,...t?.logo?{chainLogoUrl:t.logo}:{},tokens:s})}return i.sort((e,t)=>e.eip155Id-t.eip155Id),i}export{t as supportedAssetsToReceiveOptionsPayload};
+import{toChainType as e}from"../../../../shared/chains/index.js";import{formatNetworkName as t}from"../../../../shared/format/formatNetworkName.js";function n(n,r={}){let i=r.excludedChainIds,a=[];for(let r of n.assets){if(i?.has(r.eip155_id))continue;let n=r.native_currency,o=new Set,s=(e,t)=>`${e.toUpperCase()}@${t.toLowerCase()}`,c=[];if(n?.symbol){let e={symbol:n.symbol,name:n.name??n.symbol,address:``,decimals:typeof n.decimals==`number`?n.decimals:18,isNative:!0,...n.logo?{assetLogoUrl:n.logo}:{}};c.push(e),o.add(s(e.symbol,e.address))}let l=n?.symbol?.toUpperCase();for(let e of r.assets){if(!e.symbol||!e.address||l&&e.symbol.toUpperCase()===l)continue;let t=s(e.symbol,e.address);o.has(t)||(o.add(t),c.push({symbol:e.symbol,name:e.name??e.symbol,address:e.address,decimals:e.decimals,isNative:!1,...e.logo?{assetLogoUrl:e.logo}:{}}))}c.length!==0&&a.push({networkId:r.network_id,networkName:t(r.network_name),eip155Id:r.eip155_id,chainType:e(r.chain_type),...n?.logo?{chainLogoUrl:n.logo}:{},tokens:c})}return a.sort((e,t)=>e.eip155Id-t.eip155Id),a}export{n as supportedAssetsToReceiveOptionsPayload};

package/dist/flows/withdraw/driver/types.d.ts

@@ -1,4 +1,5 @@
 import { Entity, SettlementFailureKind, TxRef } from "../../../shared/driver/types.js";
+import { FormattedField } from "../../../shared/format/types.js";
 import { ReceiveOptionDto, ReceiveOptionsResponse, WithdrawableBalanceDto, WithdrawableBalancesResponse, WithdrawalQuoteDto, WithdrawalQuoteResponse, WithdrawalSettlementDto, WithdrawalSettlementResponse } from "./dto.js";
 import { ReceiveChainPayload, ReceiveTokenOptionPayload, WithdrawableBalanceItemPayload, WithdrawalQuoteBreakdownPayload, WithdrawalQuotePayload, WithdrawalReceiveAssetPayload, WithdrawalSettlementFailurePayload, WithdrawalSettlementPayload, WithdrawalSettlementPendingPayload, WithdrawalSettlementSuccessPayload } from "./payloads.js";
 
@@ -8,8 +9,9 @@ import { ReceiveChainPayload, ReceiveTokenOptionPayload, WithdrawableBalanceItem
  * {@link WithdrawDriver.getSnapshot} and consumed by `useSyncExternalStore`. The kit's
  * `useWithdrawSnapshot()` hook returns this shape.
  *
- * Each field is an {@link Entity} envelope — components switch on `status` and read `payload` on
- * the `ready` / `stale` variants.
+ * Most fields are {@link Entity} envelopes — components switch on `status` and read `payload` on
+ * the `ready` / `stale` variants. The optional `minAmountUsd` / `maxAmountUsd` carry static
+ * config-derived USD bounds (set once at driver construction) and stay outside the entity model.
  */
 interface WithdrawSnapshot {
   /**
@@ -23,7 +25,7 @@ interface WithdrawSnapshot {
   withdrawableBalances: Entity<ReadonlyArray<WithdrawableBalanceItemPayload>, WithdrawableBalancesResponse, WithdrawableBalancesResponse>;
   /**
    * Per-chain catalog of routable receive destinations. Drives the form's "Receive chain" /
-   * "Receive token" pickers. Derived from `Uda.supportedAssets()`.
+   * "Receive token" pickers. Derived from `Gateway.assets()`.
    */
   receiveOptions: Entity<ReadonlyArray<ReceiveChainPayload>, ReadonlyArray<ReceiveOptionDto>, ReceiveOptionsResponse>;
   /**
@@ -37,6 +39,18 @@ interface WithdrawSnapshot {
    * error state screen renders.
    */
   settlement: Entity<WithdrawalSettlementPayload, WithdrawalSettlementDto, WithdrawalSettlementResponse>;
+  /**
+   * Optional lower USD bound on the withdraw amount. The withdraw form blocks submit with a
+   * localized "Min $X" CTA when the typed amount sits below `value`. Set from
+   * `<StridgeProvider flows.withdraw.minAmountUsd>` and constant across the driver's lifetime.
+   */
+  minAmountUsd?: FormattedField<number>;
+  /**
+   * Optional upper USD bound on the withdraw amount. The withdraw form blocks submit with a
+   * localized "Max $X" CTA when the typed amount sits above `value`. Set from
+   * `<StridgeProvider flows.withdraw.maxAmountUsd>` and constant across the driver's lifetime.
+   */
+  maxAmountUsd?: FormattedField<number>;
 }
 /**
  * Input to {@link WithdrawDriver.requestQuote}. The form widget builds this from current field
@@ -57,17 +71,57 @@ interface RequestWithdrawalQuoteInput {
   recipientAddress: string;
 }
 /**
- * Input to {@link WithdrawDriver.submitWithdrawal}. Identical to {@link RequestWithdrawalQuoteInput}
- * — the live driver re-uses the most recent quote for submit, so the same identifying fields
- * scope both calls.
+ * Input to {@link WithdrawDriver.prepareWithdrawal}. Identical to {@link RequestWithdrawalQuoteInput}
+ * — the live driver re-uses the most recent quote shape for the gateway/start call, so the same
+ * identifying fields scope both calls.
  */
-type SubmitWithdrawalInput = RequestWithdrawalQuoteInput;
+type PrepareWithdrawalInput = RequestWithdrawalQuoteInput;
 /**
- * Input to {@link WithdrawDriver.watchSettlement}. Carries the broadcast tx ref so the watcher
- * can scope its poll to the in-flight withdraw.
+ * Result of {@link WithdrawDriver.prepareWithdrawal}. Carries everything the host's `onSubmit`
+ * callback needs to broadcast a transfer to the Stridge UDA on the brand-currency chain — the
+ * UDA address, the chain, the token, the amount — plus the Stridge correlation fields the host
+ * may want to mirror into their own backend logs.
+ */
+interface WithdrawPreparation {
+  /**
+   * Where the host should send brand-currency funds. The kit has already provisioned a UDA
+   * (via `gateway/start`); the host's job is to broadcast a single on-chain transfer of
+   * `amount` of `tokenSymbol` from their treasury / custodial wallet to `address` on `chainId`.
+   * Stridge takes over from there to bridge into the user's chosen recipient/chain/token.
+   */
+  depositTarget: {
+    /** UDA deposit address on the brand-currency chain. */address: string; /** EIP-155 chain id of the brand-currency network. */
+    chainId: number; /** Brand-currency token symbol (e.g. `"USDC"`). */
+    tokenSymbol: string; /** ERC-20 contract address of the brand currency. Empty string for native gas tokens. */
+    tokenAddress: string; /** On-chain decimal precision (e.g. `6` for USDC on Ethereum, `18` for ETH). */
+    tokenDecimals: number; /** `true` when the brand currency is the chain's native gas token. */
+    isNative: boolean; /** Exact amount to transfer, in display units (kit-managed decimals already factored in). */
+    amount: number;
+  };
+  /**
+   * Stridge correlation slot the host can pass through to their own backend / logs. `owner`
+   * is the same value the kit threaded into `gateway/start.owner` for this UDA.
+   */
+  correlation: {
+    owner: string;
+  };
+}
+/**
+ * Input to {@link WithdrawDriver.watchSettlement}. `tx` is optional — when the host has
+ * surfaced a broadcast tx hash via the orchestrator's `setTxHash` action, the watcher anchors
+ * to it for precise matching. When omitted, the watcher falls back to a best-match heuristic
+ * (destination tuple + amount tolerance + submit-time window) so the kit can find the relevant
+ * settlement even if the host never surfaces a tx hash.
  */
 interface WatchWithdrawalSettlementInput {
-  tx: TxRef;
+  tx?: TxRef;
+  /**
+   * Form snapshot at submit time. The driver uses this in best-match mode to filter
+   * `gateway/{owner}` to settlements whose destination matches the user's selection.
+   */
+  form: RequestWithdrawalQuoteInput;
+  /** Unix-ms timestamp the host called `beginProcessing` — the start of the matching window. */
+  submittedAt: number;
 }
 /**
  * Input to {@link WithdrawDriver.watchWithdrawableBalances}. Optional listener — the form's
@@ -107,16 +161,25 @@ interface WithdrawDriver {
   getSnapshot(): WithdrawSnapshot;
   /** Subscribe to entity transitions outside React (analytics, headless integrations). */
   subscribe(listener: () => void): () => void;
+  /**
+   * Idempotent bootstrap trigger. The kit calls this from `useWithdraw().open()` and the
+   * headless `usePrefetchWithdraw()` hook. First call kicks off any deferred network work
+   * (e.g. `supportedAssets` + the initial `balance/onchain` fetch); subsequent calls are
+   * no-ops while bootstrap is in flight or completed.
+   */
+  arm(): void;
   /**
    * Fetches a fresh quote for `input` and updates the `quote` entity through its lifecycle
    * (`idle | loading → ready | error`). The `signal` cancels in-flight work.
    */
   requestQuote(input: RequestWithdrawalQuoteInput, signal: AbortSignal): Promise<void>;
   /**
-   * Submits the confirmed withdrawal. Resolves with the broadcast tx ref. The settlement
-   * watcher takes over from there to populate the `settlement` entity.
+   * Provisions a fresh UDA for this withdrawal (via `gateway/start`) and returns the deposit
+   * target + Stridge correlation slot for the host's `onSubmit` callback to act on. The kit
+   * never signs the withdraw transfer itself — the host's backend (treasury wallet, custodial
+   * signer, hot-wallet service) does. See {@link WithdrawPreparation}.
    */
-  submitWithdrawal(input: SubmitWithdrawalInput, signal: AbortSignal): Promise<TxRef>;
+  prepareWithdrawal(input: PrepareWithdrawalInput, signal: AbortSignal): Promise<WithdrawPreparation>;
   /**
    * Watches the settlement entity through its lifecycle (pending → succeeded / failed). The
    * listener fires on every transition with the new envelope; the FSM consumes these via the
@@ -130,4 +193,4 @@ interface WithdrawDriver {
   watchWithdrawableBalances?(input: WatchWithdrawableBalancesInput, listener: (entity: WithdrawSnapshot["withdrawableBalances"]) => void, signal: AbortSignal): void;
 }
 //#endregion
-export { RequestWithdrawalQuoteInput, SubmitWithdrawalInput, WatchWithdrawableBalancesInput, WatchWithdrawalSettlementInput, WithdrawDriver, WithdrawSnapshot };
+export { PrepareWithdrawalInput, RequestWithdrawalQuoteInput, WatchWithdrawableBalancesInput, WatchWithdrawalSettlementInput, WithdrawDriver, WithdrawPreparation, WithdrawSnapshot };