@stridge/kit 0.1.0-alpha.4 → 0.1.0-alpha.40

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 {
   /**
@@ -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 };

package/dist/flows/withdraw/orchestrator/controller.js

@@ -1 +1 @@
-"use client";import{useLingui as e}from"../../../shared/i18n/useLingui.js";import"../../../i18n/index.js";import{toFailure as t}from"../../../shared/orchestrator/toFailure.js";import{useDriverSettlementListener as n}from"../../../shared/orchestrator/useDriverSettlementListener.js";import{useEffectiveState as r}from"../../../shared/orchestrator/useEffectiveState.js";import{useSettlementWatcher as i}from"../../../shared/orchestrator/useSettlementWatcher.js";import"../../../shared/orchestrator/index.js";import{useWithdrawDriverInstance as a}from"../driver/context.js";import{initialState as o,reducer as s}from"./reducer.js";import{createContext as c,use as l,useCallback as u,useMemo as d,useReducer as f,useRef as p}from"react";import{jsx as m}from"react/jsx-runtime";const h={id:`ldK3jJ`,message:`Failed to submit withdrawal.`},g={id:`kUFhUv`,message:`Withdrawal failed.`},_=c(null);_.displayName=`WithdrawControllerContext`;function v(){let e=l(_);if(!e)throw Error(`useWithdraw / WithdrawControllerProvider must be used inside <KitProvider withdraw={…} />. Mount KitProvider once at the host's app root with a withdraw driver.`);return e}function y(){return v().state}function b(){return v().effectiveState}function x(){return v().actions}function S({children:e}){let t=a(),[n,c]=f(s,o),l=w(n,c,t);i(t,n.name===`inProgress`?n.ctx.tx:void 0),T(n,c,t);let u=r(n),p=C(c,l);return m(_,{value:d(()=>({state:n,effectiveState:u,dispatch:c,controller:p,actions:l}),[n,u,p,l]),children:e})}function C(e,t){let n=u(()=>{e({type:`OPEN`})},[e]),r=u(()=>{e({type:`CLOSE`})},[e]);return d(()=>({open:n,close:r,actions:t}),[n,r,t])}function w(n,r,i){let a=p(n);a.current=n;let o=p(i);o.current=i;let s=p(r);s.current=r;let{i18n:c}=e(),l=p(c);l.current=c;let f=u(e=>{let n=o.current;s.current({type:`SUBMIT`,input:e});let r=new AbortController,i={sourceAssetSymbol:e.sourceAssetSymbol,sourceChainId:e.sourceChainId,amount:e.amount,receiveTokenSymbol:e.receiveTokenSymbol,receiveChainId:e.receiveChainId,recipientAddress:e.recipientAddress};n.submitWithdrawal(i,r.signal).then(e=>{r.signal.aborted||s.current({type:`SUBMIT_CONFIRMED`,tx:e})}).catch(n=>{r.signal.aborted||s.current({type:`SUBMIT_FAILED`,failure:t(n,l.current._(h)),input:e})})},[]),m=u(()=>{s.current({type:`CLOSE`})},[]),g=u(()=>{s.current({type:`RESET`})},[]),_=u(()=>{s.current({type:`CLEAR_NOTICE`})},[]);return d(()=>({submit:f,close:m,reset:g,clearNotice:_}),[f,m,g,_])}function T(t,r,i){let a=p(t);a.current=t;let{i18n:o}=e(),s=p(o);s.current=o,n(i,(e,t)=>{if(a.current.name===`inProgress`){if(e===`succeeded`){r({type:`SETTLEMENT_SUCCEEDED`});return}if(e===`failed`){let e=t.settlement,n=e.status===`ready`||e.status===`stale`?e.payload:null,i=n&&n.kind===`failed`?{reason:s.current._(g),code:n.failureKind}:void 0;r({type:`SETTLEMENT_FAILED`,...i?{failure:i}:{}})}}})}export{S as WithdrawControllerProvider,v as useControllerContext,x as useWithdrawActions,b as useWithdrawEffectiveState,y as useWithdrawState};
+"use client";import{useLingui as e}from"../../../shared/i18n/useLingui.js";import"../../../i18n/index.js";import{toFailure as t}from"../../../shared/orchestrator/toFailure.js";import{useDriverSettlementListener as n}from"../../../shared/orchestrator/useDriverSettlementListener.js";import{useEffectiveState as r}from"../../../shared/orchestrator/useEffectiveState.js";import{useSettlementWatcher as i}from"../../../shared/orchestrator/useSettlementWatcher.js";import"../../../shared/orchestrator/index.js";import{useWithdrawBindingsRef as a}from"../bindings/WithdrawBindings.js";import"../bindings/index.js";import{useWithdrawDriverInstance as o}from"../driver/context.js";import{initialState as s,reducer as c}from"./reducer.js";import{createContext as l,use as u,useCallback as d,useMemo as f,useReducer as p,useRef as m}from"react";import{jsx as h}from"react/jsx-runtime";const g={id:`ldK3jJ`,message:`Failed to submit withdrawal.`},_={id:`kUFhUv`,message:`Withdrawal failed.`},v={id:`srsA0x`,message:`Withdrawal declined.`},y=l(null);y.displayName=`WithdrawControllerContext`;function b(){let e=u(y);if(!e)throw Error(`useWithdraw / WithdrawControllerProvider must be used inside <KitProvider withdraw={…} />. Mount KitProvider once at the host's app root with a withdraw driver.`);return e}function x(){return u(y)}function S(){return b().state}function C(){return b().effectiveState}function w(){return b().actions}function T({children:e}){let t=o(),[n,a]=p(c,s),l=D(n,a,t),u=n.name===`inProgress`?{form:n.ctx.input,submittedAt:n.ctx.submittedAt,...n.ctx.tx?{tx:n.ctx.tx}:{}}:void 0;i(t,u,u?`${u.submittedAt}|${u.tx?.hash??``}`:void 0),O(n,a,t);let d=r(n),m=E(a,l,t);return h(y,{value:f(()=>({state:n,effectiveState:d,dispatch:a,controller:m,actions:l}),[n,d,m,l]),children:e})}function E(e,t,n){let r=m(n);r.current=n;let i=d(()=>{r.current.arm(),e({type:`OPEN`})},[e]),a=d(()=>{e({type:`CLOSE`})},[e]);return f(()=>({open:i,close:a,actions:t}),[i,a,t])}function D(n,r,i){let o=m(n);o.current=n;let s=m(i);s.current=i;let c=m(r);c.current=r;let{i18n:l}=e(),u=m(l);u.current=l;let p=a(),h=d(e=>{let n=s.current;c.current({type:`SUBMIT`,input:e});let r=new AbortController,i={sourceAssetSymbol:e.sourceAssetSymbol,sourceChainId:e.sourceChainId,amount:e.amount,receiveTokenSymbol:e.receiveTokenSymbol,receiveChainId:e.receiveChainId,recipientAddress:e.recipientAddress},a={beginProcessing(e){c.current({type:`BEGIN_PROCESSING`,submittedAt:Date.now(),...e?{tx:e}:{}})},setTxHash(e){c.current({type:`SET_TX_HASH`,tx:e,submittedAt:Date.now()})},fail(e){c.current({type:`MARK_FAILED`,...e?{failure:e}:{}})},decline(){c.current({type:`SUBMIT_FAILED`,failure:{reason:u.current._(v),code:`UserRejectedRequestError`},input:e})},succeed(){c.current({type:`MARK_SUCCEEDED`})}};n.prepareWithdrawal(i,r.signal).then(i=>{if(r.signal.aborted)return;let o=p.current.onSubmit;if(!o){c.current({type:`SUBMIT_FAILED`,failure:t(Error(`WithdrawDialog onSubmit is missing.`),u.current._(g)),input:e});return}let s=n.getSnapshot().quote,l=s.status===`ready`||s.status===`stale`?s.payload:void 0;try{let n=o({form:e,depositTarget:i.depositTarget,correlation:i.correlation,...l?{quote:l}:{}},a,r.signal);n&&typeof n.catch==`function`&&n.catch(n=>{r.signal.aborted||c.current({type:`SUBMIT_FAILED`,failure:t(n,u.current._(g)),input:e})})}catch(n){if(r.signal.aborted)return;c.current({type:`SUBMIT_FAILED`,failure:t(n,u.current._(g)),input:e})}}).catch(n=>{r.signal.aborted||c.current({type:`SUBMIT_FAILED`,failure:t(n,u.current._(g)),input:e})})},[]),_=d(()=>{c.current({type:`CLOSE`})},[]),y=d(()=>{c.current({type:`RESET`})},[]),b=d(()=>{c.current({type:`CLEAR_NOTICE`})},[]);return f(()=>({submit:h,close:_,reset:y,clearNotice:b}),[h,_,y,b])}function O(t,r,i){let a=m(t);a.current=t;let{i18n:o}=e(),s=m(o);s.current=o,n(i,(e,t)=>{if(a.current.name===`inProgress`){if(e===`succeeded`){r({type:`SETTLEMENT_SUCCEEDED`});return}if(e===`failed`){let e=t.settlement,n=e.status===`ready`||e.status===`stale`?e.payload:null,i=n&&n.kind===`failed`?{reason:s.current._(_),code:n.failureKind}:void 0;r({type:`SETTLEMENT_FAILED`,...i?{failure:i}:{}})}}})}export{T as WithdrawControllerProvider,b as useControllerContext,x as useOptionalControllerContext,w as useWithdrawActions,C as useWithdrawEffectiveState,S as useWithdrawState};

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

@@ -1,4 +1,4 @@
 import { FailureInfo } from "../../../shared/orchestrator/types.js";
 import { WithdrawActions, WithdrawController, WithdrawEvent, WithdrawState, WithdrawStateName, WithdrawalFormSnapshot } from "./types.js";
 import { useWithdrawState } from "./controller.js";
-import { useWithdraw } from "./useWithdraw.js";
+import { useOptionalWithdraw, usePrefetchWithdraw, useWithdraw } from "./useWithdraw.js";

package/dist/flows/withdraw/orchestrator/reducer.js

@@ -1 +1 @@
-import{isUserRejectionFailure as e}from"../../../shared/orchestrator/userRejection.js";import"../../../shared/orchestrator/index.js";const t={name:`closed`};function n(e,t){switch(e.name){case`closed`:return r(t);case`form`:return i(e,t);case`submitting`:return a(e,t);case`inProgress`:return o(e,t);case`success`:return s(e,t);case`error`:return c(e,t);default:return l(e)}}function r(e){return e.type===`OPEN`?{name:`form`}:{name:`closed`}}function i(e,t){switch(t.type){case`SUBMIT`:return{name:`submitting`,ctx:{input:t.input}};case`CLEAR_NOTICE`:return e.ctx?.notice?{name:`form`}:e;case`CLOSE`:return{name:`closed`};default:return e}}function a(t,n){switch(n.type){case`SUBMIT_CONFIRMED`:return{name:`inProgress`,ctx:{input:t.ctx.input,tx:n.tx}};case`SUBMIT_FAILED`:return e(n.failure)?{name:`form`,ctx:{notice:n.failure.reason}}:{name:`error`,ctx:{input:n.input,failure:n.failure}};case`CLOSE`:return{name:`closed`};default:return t}}function o(e,t){switch(t.type){case`SETTLEMENT_SUCCEEDED`:return{name:`success`,ctx:{input:e.ctx.input,tx:e.ctx.tx}};case`SETTLEMENT_FAILED`:return{name:`error`,ctx:{input:e.ctx.input,tx:e.ctx.tx,...t.failure?{failure:t.failure}:{}}};case`CLOSE`:return{name:`closed`};default:return e}}function s(e,t){switch(t.type){case`RESET`:return{name:`form`};case`CLOSE`:return{name:`closed`};default:return e}}function c(e,t){switch(t.type){case`RESET`:return{name:`form`};case`CLOSE`:return{name:`closed`};default:return e}}function l(e){throw Error(`Unhandled withdraw state: ${JSON.stringify(e)}`)}export{t as initialState,n as reducer};
+import{isUserRejectionFailure as e}from"../../../shared/orchestrator/userRejection.js";import"../../../shared/orchestrator/index.js";const t={name:`closed`};function n(e,t){switch(e.name){case`closed`:return r(t);case`form`:return i(e,t);case`submitting`:return a(e,t);case`inProgress`:return o(e,t);case`success`:return s(e,t);case`error`:return c(e,t);default:return l(e)}}function r(e){return e.type===`OPEN`?{name:`form`}:{name:`closed`}}function i(e,t){switch(t.type){case`SUBMIT`:return{name:`submitting`,ctx:{input:t.input}};case`CLEAR_NOTICE`:return e.ctx?.notice?{name:`form`}:e;case`CLOSE`:return{name:`closed`};default:return e}}function a(t,n){switch(n.type){case`BEGIN_PROCESSING`:return{name:`inProgress`,ctx:{input:t.ctx.input,submittedAt:n.submittedAt,...n.tx?{tx:n.tx}:{}}};case`SET_TX_HASH`:return{name:`inProgress`,ctx:{input:t.ctx.input,submittedAt:n.submittedAt,tx:n.tx}};case`MARK_SUCCEEDED`:return{name:`success`,ctx:{input:t.ctx.input}};case`MARK_FAILED`:return{name:`error`,ctx:{input:t.ctx.input,...n.failure?{failure:n.failure}:{}}};case`SUBMIT_FAILED`:return e(n.failure)?{name:`form`,ctx:{notice:n.failure.reason}}:{name:`error`,ctx:{input:n.input,failure:n.failure}};case`CLOSE`:return{name:`closed`};default:return t}}function o(e,t){switch(t.type){case`SET_TX_HASH`:return{name:`inProgress`,ctx:{...e.ctx,tx:t.tx}};case`BEGIN_PROCESSING`:return{name:`inProgress`,ctx:{input:e.ctx.input,submittedAt:e.ctx.submittedAt,...e.ctx.tx?{tx:e.ctx.tx}:t.tx?{tx:t.tx}:{}}};case`MARK_SUCCEEDED`:return{name:`success`,ctx:{input:e.ctx.input,...e.ctx.tx?{tx:e.ctx.tx}:{}}};case`MARK_FAILED`:return{name:`error`,ctx:{input:e.ctx.input,...e.ctx.tx?{tx:e.ctx.tx}:{},...t.failure?{failure:t.failure}:{}}};case`SETTLEMENT_SUCCEEDED`:return{name:`success`,ctx:{input:e.ctx.input,...e.ctx.tx?{tx:e.ctx.tx}:{}}};case`SETTLEMENT_FAILED`:return{name:`error`,ctx:{input:e.ctx.input,...e.ctx.tx?{tx:e.ctx.tx}:{},...t.failure?{failure:t.failure}:{}}};case`CLOSE`:return{name:`closed`};default:return e}}function s(e,t){switch(t.type){case`RESET`:return{name:`form`};case`CLOSE`:return{name:`closed`};default:return e}}function c(e,t){switch(t.type){case`RESET`:return{name:`form`};case`CLOSE`:return{name:`closed`};default:return e}}function l(e){throw Error(`Unhandled withdraw state: ${JSON.stringify(e)}`)}export{t as initialState,n as reducer};

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

@@ -1,6 +1,7 @@
 import { TxRef } from "../../../shared/driver/types.js";
 import { FailureInfo } from "../../../shared/orchestrator/types.js";
-
+import { WithdrawalQuotePayload } from "../driver/payloads.js";
+import { WithdrawPreparation } from "../driver/types.js";
 //#region src/flows/withdraw/orchestrator/types.d.ts
 /**
  * Form values captured at submit time. The orchestrator carries this snapshot through every
@@ -20,24 +21,34 @@ interface WithdrawalFormSnapshot {
   receiveTokenSymbol: string;
   /** Receive-side chain id (EIP-155 numeric). */
   receiveChainId: number;
+  /**
+   * Pre-formatted USD figure the form displayed under the amount input at submit time. Carried
+   * through the FSM so the in-progress / success heroes can render the same dollar value the
+   * user just saw on the form, before the indexer prices the settlement legs. Optional because
+   * the form's USD computation already returns `undefined` for invalid amounts; the snapshot
+   * mirrors that. Pre-formatted (locale-aware) — the orchestrator does not re-format.
+   */
+  amountUsd?: string;
 }
 /**
- * State machine state for the orchestrated withdraw dialog. Per-state discriminated `ctx` narrows
- * what data is available — illegal states (e.g. `inProgress` without a tx ref) are
- * unrepresentable.
+ * State machine state for the orchestrated withdraw dialog. Per-state discriminated `ctx`
+ * narrows what data is available.
  *
- * The reducer carries navigation intent only — entity-derived data (quote payload, settlement
- * payload, balances) lives on the driver and is read directly by widgets.
+ * **Host-paced lifecycle** (different from the old wagmi-signed model): the kit stays in
+ * `submitting` until the host's `onSubmit` callback calls one of the controller's actions
+ * (`beginProcessing`, `fail`, `succeed`). `inProgress` accepts an optional `tx` — the host may
+ * move the user into processing before a broadcast tx hash exists; the kit polls
+ * `gateway/{owner}` and best-matches the relevant settlement (destination tuple + amount +
+ * submit-time window) until the host supplies a tx hash via `setTxHash`. `success` / `error`
+ * similarly accept optional `tx` since the host may declare a terminal verdict directly.
  */
 type WithdrawState = {
   name: "closed";
 } | {
   name: "form";
   /**
-   * Optional notice rendered inline near the submit footer. Currently set when the user
-   * declines the wallet signature: the FSM lands the user back on the form (preserving
-   * recipient + amount + receive selection) with `notice = "Signature declined…"` so they
-   * can retry without losing context. Cleared on the next SUBMIT or CLOSE.
+   * Optional notice rendered inline near the submit footer. Cleared on the next SUBMIT
+   * or CLOSE.
    */
   ctx?: {
     notice?: string;
@@ -50,24 +61,28 @@ type WithdrawState = {
 } | {
   name: "inProgress";
   ctx: {
-    input: WithdrawalFormSnapshot;
-    tx: TxRef;
+    input: WithdrawalFormSnapshot; /** Unix-ms timestamp the host moved the FSM into processing (drives best-match windowing). */
+    submittedAt: number;
+    /**
+     * Source-chain broadcast hash, when the host has surfaced one via
+     * `actions.setTxHash`. Absent while the kit relies on the best-match heuristic.
+     */
+    tx?: TxRef;
   };
 } | {
   name: "success";
   ctx: {
     input: WithdrawalFormSnapshot;
-    tx: TxRef;
+    tx?: TxRef;
   };
 } | {
   name: "error";
   ctx: {
     /**
      * Form snapshot captured at submit time. Set when error follows a submit attempt;
-     * absent when the error path was reached without a known prior submit (currently
-     * unreachable in V2 — kept optional so resume-style entries can re-use the slot).
+     * absent when the error path was reached without a known prior submit.
      */
-    input?: WithdrawalFormSnapshot; /** Optional non-settlement failure (quote / submission rejection). */
+    input?: WithdrawalFormSnapshot; /** Optional non-settlement failure (quote / submission rejection, host-supplied failure). */
     failure?: FailureInfo; /** Source-chain broadcast tx hash when the error followed a successful broadcast. */
     tx?: TxRef;
   };
@@ -79,6 +94,16 @@ type WithdrawState = {
 type WithdrawStateName = WithdrawState["name"];
 /**
  * Reducer event union. Strict discriminated; no stringly-typed transitions.
+ *
+ * The host-paced lifecycle splits the old `SUBMIT_CONFIRMED { tx }` event into three pieces so
+ * the host can move the user forward at whichever step their backend actually completes:
+ *
+ * - `BEGIN_PROCESSING { tx?, submittedAt }` — host accepted the request; move to inProgress with
+ *   or without a tx hash.
+ * - `SET_TX_HASH { tx }` — host surfaced a broadcast hash later; upgrade best-match polling to
+ *   tx-anchored.
+ * - `MARK_SUCCEEDED` / `MARK_FAILED { failure? }` — host short-circuits to a terminal verdict
+ *   (e.g. their own settlement verification ran independently of Stridge's poll).
  */
 type WithdrawEvent = {
   type: "OPEN";
@@ -88,12 +113,22 @@ type WithdrawEvent = {
   type: "SUBMIT";
   input: WithdrawalFormSnapshot;
 } | {
-  type: "SUBMIT_CONFIRMED";
+  type: "BEGIN_PROCESSING";
+  submittedAt: number;
+  tx?: TxRef;
+} | {
+  type: "SET_TX_HASH";
   tx: TxRef;
+  submittedAt: number;
 } | {
   type: "SUBMIT_FAILED";
   failure: FailureInfo;
   input: WithdrawalFormSnapshot;
+} | {
+  type: "MARK_SUCCEEDED";
+} | {
+  type: "MARK_FAILED";
+  failure?: FailureInfo;
 } | {
   type: "SETTLEMENT_SUCCEEDED";
 } | {
@@ -101,15 +136,7 @@ type WithdrawEvent = {
   failure?: FailureInfo;
 } | {
   type: "RESET";
-}
-/**
- * Drops the inline notice on the `form` state. Dispatched by the form widget when the user
- * starts editing again after a wallet-rejection landed them back on `form{notice}`. Mirror of
- * deposit's `regenerating → ready` transition (where the notice clears as a side-effect of
- * the next quote resolving) — withdraw's form has no FSM-driven phase to ride on, so the
- * widget signals it explicitly.
- */
-| {
+} | {
   type: "CLEAR_NOTICE";
 };
 /**
@@ -134,9 +161,11 @@ interface WithdrawController {
  */
 interface WithdrawActions {
   /**
-   * Submits the withdrawal through the driver. Dispatches `SUBMIT` synchronously (so the form
-   * flips to the loading-button state) and then `SUBMIT_CONFIRMED` / `SUBMIT_FAILED` based on
-   * the driver's `submitWithdrawal` resolution.
+   * Submits the withdrawal. Dispatches `SUBMIT` synchronously (so the form flips to the
+   * loading-button state) and then fires the host's `<WithdrawDialog onSubmit>` callback with
+   * the prepared UDA target + a `WithdrawSubmitActions` handle. The kit stays in `submitting`
+   * until the host calls one of those actions (`beginProcessing`, `setTxHash`, `decline`,
+   * `fail`, `succeed`).
    */
   submit(input: WithdrawalFormSnapshot): void;
   /** Close the dialog. Idempotent. */
@@ -147,10 +176,80 @@ interface WithdrawActions {
    */
   reset(): void;
   /**
-   * Clear the form's inline notice (typically the post-rejection "Signature declined." hint).
-   * No-op when there's no notice or the FSM isn't on `form`.
+   * Clear the form's inline notice. No-op when there's no notice or the FSM isn't on `form`.
    */
   clearNotice(): void;
 }
+/**
+ * Payload the kit hands to the host's `<WithdrawDialog onSubmit>` callback. Carries everything
+ * the host needs to broadcast the source-chain transfer to the UDA (or to validate the request
+ * server-side before broadcasting / queueing).
+ */
+interface WithdrawSubmitInput {
+  /** What the user picked on the form (recipient, amount, receive token + chain). */
+  form: WithdrawalFormSnapshot;
+  /** Where the host should send brand-currency funds to trigger the bridge. */
+  depositTarget: WithdrawPreparation["depositTarget"];
+  /** Stridge correlation slot — useful for backend logs / cross-system traces. */
+  correlation: WithdrawPreparation["correlation"];
+  /** Active quote payload at submit time, when one is available. */
+  quote?: WithdrawalQuotePayload;
+}
+/**
+ * Imperative handles the host's `onSubmit` callback receives. Each action advances the kit's
+ * FSM at the point the host's backend reaches the matching state. All actions are optional —
+ * the host calls only what fits their flow (e.g. backend pre-validates and accepts ⇒
+ * `beginProcessing()`; later the broadcast lands ⇒ `setTxHash({ hash })`; settlement watching
+ * via Stridge takes over from there). The kit also exposes a `signal` for cancellation when
+ * the user closes the dialog mid-submit.
+ */
+interface WithdrawSubmitActions {
+  /**
+   * Move the FSM into `inProgress`. Pass `tx` if a broadcast hash already exists at this point;
+   * otherwise omit — the kit polls `gateway/{owner}` with a best-match heuristic until you
+   * call {@link setTxHash}. Idempotent — calling more than once is a no-op.
+   */
+  beginProcessing(tx?: TxRef): void;
+  /**
+   * Surface a broadcast hash mid-processing. Upgrades the watcher from best-match to
+   * tx-anchored. Legal from `inProgress` or `submitting` (auto-promotes to `inProgress`).
+   */
+  setTxHash(tx: TxRef): void;
+  /**
+   * Mark the withdraw failed. Legal from `submitting` (pre-broadcast rejection) and
+   * `inProgress` (post-broadcast failure). The optional `failure` carries a localized
+   * reason + machine code for analytics; omit when the host has nothing meaningful to
+   * report and just needs to terminate the flow.
+   *
+   * For user-rejection (the user said no in their wallet), prefer {@link decline} so the
+   * kit can emit `withdraw.submission.declined` instead of `withdraw.submission.failed`.
+   */
+  fail(failure?: FailureInfo): void;
+  /**
+   * Mark the withdraw as user-declined. Use when the user explicitly refused a wallet
+   * prompt or backed out of a host-side confirmation step. The kit routes the FSM back to
+   * `form{notice}` (same as the wallet-rejection heuristic) and emits
+   * `withdraw.submission.declined` on the unified bus — distinct from `*.failed` because
+   * declining is a user choice, not an error. Analytics that count `.failed` events stay
+   * accurate.
+   *
+   * Legal from `submitting`. When the host doesn't call this explicitly, the kit's
+   * built-in rejection heuristic still classifies wallet-rejection-shaped errors as
+   * declines automatically.
+   */
+  decline(): void;
+  /**
+   * Mark the withdraw succeeded directly. Useful when the host runs their own settlement
+   * verification independently of Stridge's poll. Legal from `submitting` and `inProgress`.
+   */
+  succeed(): void;
+}
+/**
+ * Host-supplied callback fired when the user submits the withdrawal form. The kit hands the
+ * callback the resolved {@link WithdrawSubmitInput} plus a {@link WithdrawSubmitActions} handle
+ * the host calls to advance the FSM. The kit does NOT await the callback's promise — the host
+ * is in control of pacing via the actions. The `signal` aborts when the user closes the dialog.
+ */
+type WithdrawSubmitCallback = (input: WithdrawSubmitInput, actions: WithdrawSubmitActions, signal: AbortSignal) => void | Promise<void>;
 //#endregion
-export { WithdrawActions, WithdrawController, WithdrawEvent, WithdrawState, WithdrawStateName, WithdrawalFormSnapshot };
+export { WithdrawActions, WithdrawController, WithdrawEvent, WithdrawState, WithdrawStateName, WithdrawSubmitActions, WithdrawSubmitCallback, WithdrawSubmitInput, WithdrawalFormSnapshot };

package/dist/flows/withdraw/orchestrator/useWithdraw.d.ts

@@ -19,5 +19,40 @@ import { WithdrawController } from "./types.js";
  * ```
  */
 declare function useWithdraw(): WithdrawController;
+/**
+ * Non-throwing variant of {@link useWithdraw} — returns `null` when called outside a
+ * `<KitProvider withdraw={…} />`. Lets hosts mount `<StridgeProvider />` conditionally
+ * (e.g. only after a wallet is connected) without descendants crashing the moment they render
+ * before the provider exists.
+ *
+ * @example
+ * ```tsx
+ * const withdraw = useOptionalWithdraw();
+ * return (
+ *     <button onClick={() => withdraw?.open()} disabled={!withdraw}>
+ *         Withdraw
+ *     </button>
+ * );
+ * ```
+ */
+declare function useOptionalWithdraw(): WithdrawController | null;
+/**
+ * Headless prefetch handle for the withdraw driver. Returns a stable function that arms the
+ * driver — kicks off the deferred `supportedAssets` + initial `balance/onchain` bootstrap.
+ * Calling it before the user opens the dialog warms the cache so the subsequent
+ * `useWithdraw().open()` lands on populated data without a perceptible loading window.
+ *
+ * Fire-and-forget: returns `void`. Observe bootstrap state via
+ * `useWithdrawSnapshot().receiveOptions.status` if needed.
+ *
+ * ```tsx
+ * const withdraw = useWithdraw();
+ * const prefetchWithdraw = usePrefetchWithdraw();
+ * <button onMouseEnter={prefetchWithdraw} onClick={() => withdraw.open()}>Withdraw</button>;
+ * ```
+ *
+ * Idempotent — subsequent calls are no-ops while the driver is already armed.
+ */
+declare function usePrefetchWithdraw(): () => void;
 //#endregion
-export { useWithdraw };
+export { useOptionalWithdraw, usePrefetchWithdraw, useWithdraw };

package/dist/flows/withdraw/orchestrator/useWithdraw.js

@@ -1 +1 @@
-"use client";import{useControllerContext as e}from"./controller.js";function t(){return e().controller}export{t as useWithdraw};
+"use client";import{useWithdrawDriverInstance as e}from"../driver/context.js";import{useControllerContext as t,useOptionalControllerContext as n}from"./controller.js";import{useCallback as r}from"react";function i(){return t().controller}function a(){return n()?.controller??null}function o(){let t=e();return r(()=>{t.arm()},[t])}export{a as useOptionalWithdraw,o as usePrefetchWithdraw,i as useWithdraw};

package/dist/flows/withdraw/widgets/withdraw-form/WithdrawForm.d.ts

@@ -1,16 +1,6 @@
-import { WithdrawFormEventCallbacks } from "../../dialog/WithdrawDialogEventsContext.js";
-import { ComponentProps } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/flows/withdraw/widgets/withdraw-form/WithdrawForm.d.ts
-type OrchestratedProps = ComponentProps<"div"> & {
-  /**
-   * Form-level event callbacks. Optional — when omitted, the form falls back to whatever the
-   * enclosing `<WithdrawDialog>` provides via context. Hosts using `<WithdrawForm>` directly
-   * (custom UI without the dialog) can pass callbacks here.
-   */
-  events?: WithdrawFormEventCallbacks;
-};
 /**
  * Orchestrated `WithdrawForm` widget. Reads source-side balances, the receive-options catalog,
  * and the active quote payload from the driver, drives the FSM via `useWithdrawActions().submit`,
@@ -21,9 +11,11 @@ type OrchestratedProps = ComponentProps<"div"> & {
  * Quote lifecycle: the form fires `driver.requestQuote(...)` (debounced ~400ms) whenever both
  * `recipientAddress` and `amount > 0` are populated and re-fires on receive-side changes. Stale
  * entity transitions keep showing the last-known payload until the user changes a field.
+ *
+ * Interaction events (`withdraw.recipient.changed`, `withdraw.amount.changed`, `withdraw.amount.maxed`,
+ * `withdraw.receive.token.changed`, `withdraw.receive.chain.changed`, `withdraw.submit.clicked`)
+ * flow through the unified event bus — the form takes no callback props.
  */
-declare function WithdrawForm({
-  events: localEvents
-}: OrchestratedProps): _$react_jsx_runtime0.JSX.Element | null;
+declare function WithdrawForm(): _$react_jsx_runtime0.JSX.Element | null;
 //#endregion
 export { WithdrawForm };

package/dist/flows/withdraw/widgets/withdraw-form/WithdrawForm.js

@@ -1 +1 @@
-"use client";import{useKitI18n as e}from"../../../../shared/i18n/useKitI18n.js";import{useLingui as t}from"../../../../shared/i18n/useLingui.js";import"../../../../i18n/index.js";import{useWithdrawDriverInstance as n,useWithdrawSnapshot as r}from"../../driver/context.js";import{useWithdrawActions as i,useWithdrawEffectiveState as ee}from"../../orchestrator/controller.js";import{parseAmountInputValue as a}from"../../../../shared/ui/AmountInput/utils.js";import"../../../../shared/ui/AmountInput/index.js";import{toAssetDescriptor as o}from"../../../../shared/widgets/asset-descriptor.js";import{useQuoteCountdown as te}from"../../../../shared/quote/useQuoteCountdown.js";import"../../../../shared/quote/index.js";import{WithdrawForm as s}from"./compound/WithdrawForm.js";import"./compound/index.js";import{useWithdrawDialogEvents as ne}from"../../dialog/WithdrawDialogEventsContext.js";import{isValidEvmAddress as re,resolveSubmitLabel as ie}from"./validation.js";import{useCallback as c,useEffect as l,useMemo as u,useRef as d,useState as f}from"react";import{jsx as p,jsxs as ae}from"react/jsx-runtime";import{useAccount as oe}from"wagmi";function m({events:m}){let h=r(),g=n(),_=ee(),v=i(),{_:y}=t(),b=ne(),se=u(()=>({...b,...m??{}}),[b,m]),x=d(se);x.current=se;let{address:ce}=oe(),le=ce??``,[S,ue]=f(``),[de,fe]=f(``),C=_.name===`submitting`,w=_.name===`form`?_.ctx?.notice:void 0,T=d(w);T.current=w;let E=h.withdrawableBalances.status===`ready`||h.withdrawableBalances.status===`stale`?h.withdrawableBalances.payload[0]:void 0,D=u(()=>o(E)??{symbol:`USDC`},[E]),pe=u(()=>o(E?{symbol:E.networkName,eip155Id:E.eip155Id,isNative:!0,logoUrl:E.chainLogoUrl}:void 0)??{symbol:`BSC`},[E]),me=E?{amount:E.amount.formatted,symbol:E.symbol}:void 0,O=h.receiveOptions.status===`ready`||h.receiveOptions.status===`stale`?h.receiveOptions.payload:[],k=E?.eip155Id?Number(E.eip155Id):void 0,A=E?.symbol??D.symbol,j=u(()=>{let e=new Map;for(let t of O)for(let n of t.tokens){let r=n.symbol.toUpperCase(),i=e.get(r);i?i.push({chain:t,token:n}):e.set(r,[{chain:t,token:n}])}return e},[O]),M=u(()=>{if(j.size===0)return;let e=A.toUpperCase();return j.has(e)?e:j.keys().next().value},[j,A]),N=c(e=>{let t=j.get(e);if(!(!t||t.length===0))return(k===void 0?void 0:t.find(e=>e.chain.eip155Id===k))??t[0]},[j,k]),[P,F]=f(void 0),[I,L]=f(void 0);l(()=>{if(I||!M)return;let e=N(M);e&&(F(e.chain),L(e.token))},[M,N,I]);let R=c(()=>{T.current&&v.clearNotice()},[v]),he=c(e=>{R(),ue(e),x.current.onRecipientChanged?.(e)},[R]),z=e().locale,B=c(e=>{R(),fe(e);let t=a(e,z);x.current.onAmountChanged?.({raw:e,numeric:t})},[R,z]),V=c(e=>{R();let t=e.symbol.toUpperCase(),n=j.get(t)?.find(e=>e.chain.eip155Id===P?.eip155Id)??N(t);n&&(F(n.chain),L(n.token),x.current.onReceiveTokenChanged?.(n.token),n.chain.eip155Id!==P?.eip155Id&&x.current.onReceiveChainChanged?.(n.chain))},[R,j,N,P?.eip155Id]),ge=c(e=>{R(),F(e);let t=I?.symbol.toUpperCase(),n=(t?e.tokens.find(e=>e.symbol.toUpperCase()===t):void 0)??e.tokens[0];n&&L(n),x.current.onReceiveChainChanged?.(e),n&&n.symbol!==I?.symbol&&x.current.onReceiveTokenChanged?.(n)},[R,I?.symbol]),H=a(de,z),U=H!==null&&H>0,_e=S.trim(),ve=_e.length>0,W=re(_e),G=P!==void 0&&I!==void 0,K=U&&E!==void 0&&H>E.amount.value,[q,ye]=f(null),J=(h.quote.status===`ready`||h.quote.status===`stale`)&&ve&&U&&G&&q!==null&&q.recipient===S&&q.amount===H&&q.receiveChainId===P.eip155Id&&q.receiveSymbol===I.symbol?h.quote.payload:void 0,be=u(()=>j.size===0?[D]:[...j.values()].map(e=>{let t=e[0];return o({symbol:t.token.symbol,eip155Id:t.chain.eip155Id,address:t.token.address,isNative:t.token.isNative,logoUrl:t.token.assetLogoUrl})??{symbol:t.token.symbol}}),[j,D]),xe=u(()=>{let e=I?.symbol.toUpperCase(),t=e?j.get(e):void 0;return(t?t.map(e=>e.chain):O).map(e=>o({symbol:e.networkName,eip155Id:e.eip155Id,isNative:!0,logoUrl:e.chainLogoUrl})??{symbol:e.networkName})},[I?.symbol,j,O]),Se=I?o({symbol:I.symbol,eip155Id:P?.eip155Id,address:I.address,isNative:I.isNative,logoUrl:I.assetLogoUrl}):D,Ce=P?o({symbol:P.networkName,eip155Id:P.eip155Id,isNative:!0,logoUrl:P.chainLogoUrl}):pe,we=u(()=>{if(J?.breakdown)return{route:J.breakdown.selectedRoute?.label,networkCost:J.breakdown.networkCost?.formatted,priceImpact:J.breakdown.priceImpact?.formatted}},[J]),Te=u(()=>{if(U)return J?.receiveAmountUsd?J.receiveAmountUsd.formatted:`$${H.toFixed(2)}`},[H,U,J]),Ee=J&&U?J.receiveAmount.formatted:void 0,De=J?.receiveAmountUsd?.formatted,Y=W&&U&&!K&&G&&J===void 0&&h.quote.status!==`error`,X=W&&U&&!K&&G&&J!==void 0,Oe=te({expiresAt:J?.expiresAt,enabled:X}),ke=X&&J?J.quoteTotalSeconds:void 0,[Z,Q]=f(!1);l(()=>{Q(!1)},[S,H,P?.eip155Id,I?.symbol,_.name]),l(()=>{if(!X||!J||_.name!==`form`||Z)return;let e=Math.max(0,J.expiresAt-Date.now()),t=setTimeout(()=>{Q(!0)},e);return()=>clearTimeout(t)},[X,J,_.name,Z]),l(()=>{if(!Z||_.name!==`form`||k===void 0||!P||!I||!W||!U||K)return;let e=new AbortController,t={recipient:S,amount:H??0,receiveChainId:P.eip155Id,receiveSymbol:I.symbol},n={sourceAssetSymbol:A,sourceChainId:k,amount:H??0,receiveTokenSymbol:I.symbol,receiveChainId:P.eip155Id,recipientAddress:S};return x.current.onQuoteRequested?.(n),g.requestQuote(n,e.signal).then(()=>{e.signal.aborted||ye(t)}).catch(()=>{}).finally(()=>{e.signal.aborted||Q(!1)}),()=>e.abort()},[Z,g,S,H,W,U,K,k,A,P,I,_.name]);let $=!W||!U||K||!G||Y||Z,Ae=ie({enterRecipientAddress:y({id:`nr03QI`,message:`Enter Recipient Address`}),enterValidRecipientAddress:y({id:`GZPxmc`,message:`Enter Valid Recipient Address`}),enterAmount:y({id:`yH9V_J`,message:`Enter Amount`}),insufficientBalance:y({id:`N2DUxS`,message:`Insufficient Balance`}),regeneratingQuote:y({id:`Ly6geA`,message:`Regenerating quote…`}),estimatingQuote:y({id:`Uevt3L`,message:`Estimating quote`})},{isRecipientFilled:ve,isRecipientValid:W,isAmountValid:U,exceedsBalance:K,quoteEstimating:Y,quoteRegenerating:Z}),je=d(null);l(()=>{if(je.current?.abort(),!W||!U||K||!G||_.name!==`form`||k===void 0)return;let e=new AbortController;je.current=e;let t={recipient:S,amount:H,receiveChainId:P.eip155Id,receiveSymbol:I.symbol},n=setTimeout(()=>{let n={sourceAssetSymbol:A,sourceChainId:k,amount:H,receiveTokenSymbol:I.symbol,receiveChainId:P.eip155Id,recipientAddress:S};x.current.onQuoteRequested?.(n),g.requestQuote(n,e.signal).then(()=>{e.signal.aborted||ye(t)}).catch(()=>{})},400);return()=>{clearTimeout(n),e.abort()}},[g,S,H,W,U,K,G,k,A,P?.eip155Id,I?.symbol,_.name]);let Me=c(()=>{E&&B(E.amount.formatted)},[E,B]),Ne=c(()=>{C||$||k===void 0||!P||!I||v.submit({sourceAssetSymbol:A,sourceChainId:k,amount:H??0,recipientAddress:S,receiveTokenSymbol:I.symbol,receiveChainId:P.eip155Id})},[v,H,k,A,P,I,S,$,C]),Pe=c(e=>{let t=O.find(t=>String(t.eip155Id)===String(e.chainId));t&&ge(t)},[ge,O]),Fe=c(e=>{let t=e.symbol.toUpperCase(),n=j.get(t);!n||n.length===0||V((n.find(e=>e.chain.eip155Id===P?.eip155Id)??n[0]).token)},[V,j,P?.eip155Id]);return _.name!==`form`&&_.name!==`submitting`?null:ae(s,{recipientAddress:S,onRecipientChange:he,connectedAddress:le,amount:de,onAmountChange:B,onAmountMax:Me,sourceAsset:D,sourceChain:pe,receiveAsset:Se,receiveChain:Ce,receiveAssetOptions:be,onReceiveAssetChange:Fe,receiveChainOptions:xe,onReceiveChainChange:Pe,balance:me,amountUsd:Te,receiveAmount:Ee,receiveAmountUsd:De,breakdown:we,quoteEstimating:Y,quoteRegenerating:Z,...Oe===void 0?{}:{quoteSeconds:Oe},...ke===void 0?{}:{quoteTotalSeconds:ke},submitting:C,submitDisabled:$,submitLabel:Ae,...w?{notice:w}:{},onSubmit:Ne,children:[p(s.Header,{}),ae(s.Body,{children:[p(s.RecipientField,{}),p(s.AmountField,{}),p(s.ReceiveSelectors,{}),p(s.BreakdownCard,{})]}),p(s.Footer,{})]})}export{m as WithdrawForm};
+"use client";import{isValidAddressForChainType as e}from"../../../../shared/chains/index.js";import{useKitI18n as t}from"../../../../shared/i18n/useKitI18n.js";import{useLingui as n}from"../../../../shared/i18n/useLingui.js";import"../../../../i18n/index.js";import{useWithdrawBindingsValue as r}from"../../bindings/WithdrawBindings.js";import"../../bindings/index.js";import{useWithdrawDriverInstance as ee,useWithdrawSnapshot as te}from"../../driver/context.js";import{useWithdrawActions as ne,useWithdrawEffectiveState as re}from"../../orchestrator/controller.js";import{formatTokenAmount as ie}from"../../../../shared/format/formatTokenAmount.js";import{useKitEmitter as ae}from"../../../../events/emit/useKitEmitter.js";import"../../../../events/emit/index.js";import{parseAmountInputValue as oe}from"../../../../shared/ui/AmountInput/utils.js";import"../../../../shared/ui/AmountInput/index.js";import{toAssetDescriptor as i}from"../../../../shared/widgets/asset-descriptor.js";import{useQuoteCountdown as se}from"../../../../shared/quote/useQuoteCountdown.js";import"../../../../shared/quote/index.js";import{WithdrawForm as a}from"./compound/WithdrawForm.js";import"./compound/index.js";import{resolveSubmitLabel as ce}from"./validation.js";import{useCallback as o,useEffect as s,useMemo as c,useRef as le,useState as l}from"react";import{jsx as u,jsxs as ue}from"react/jsx-runtime";function d(){let d=te(),f=ee(),p=re(),m=ne(),{i18n:de,_:h}=n(),g=ae(),{balance:_,suggestedRecipient:fe}=r(),[v,pe]=l(``),[me,he]=l(``),ge=p.name===`submitting`,y=p.name===`form`?p.ctx?.notice:void 0,_e=le(y);_e.current=y;let b=d.withdrawableBalances.status===`ready`||d.withdrawableBalances.status===`stale`?d.withdrawableBalances.payload[0]:void 0,x=c(()=>i(b)??{symbol:`USDC`},[b]),ve=c(()=>i(b?{symbol:b.networkName,eip155Id:b.eip155Id,isNative:!0,logoUrl:b.chainLogoUrl}:void 0)??{symbol:`BSC`},[b]),S=typeof _==`number`?_:typeof _==`object`?_.amount:void 0,ye=b?.symbol??x.symbol,C=S??b?.amount.value,be=S===void 0?b?.symbol:ye,w=C!==void 0&&be!==void 0?{amount:S===void 0?b?.amount.formatted??ie(C,de):ie(S,de),symbol:be}:void 0,T=d.receiveOptions.status===`ready`||d.receiveOptions.status===`stale`?d.receiveOptions.payload:[],E=b?.eip155Id?Number(b.eip155Id):void 0,D=b?.symbol??x.symbol,O=c(()=>{let e=new Map;for(let t of T)for(let n of t.tokens){let r=n.symbol.toUpperCase(),ee=e.get(r);ee?ee.push({chain:t,token:n}):e.set(r,[{chain:t,token:n}])}return e},[T]),k=c(()=>{if(O.size===0)return;let e=D.toUpperCase();return O.has(e)?e:O.keys().next().value},[O,D]),A=o(e=>{let t=O.get(e);if(!(!t||t.length===0))return(E===void 0?void 0:t.find(e=>e.chain.eip155Id===E))??t[0]},[O,E]),[j,M]=l(void 0),[N,P]=l(void 0);s(()=>{if(N||!k)return;let e=A(k);e&&(M(e.chain),P(e.token))},[k,A,N]);let F=o(()=>{_e.current&&m.clearNotice()},[m]),xe=o(e=>{F(),pe(e),g({type:`withdraw.recipient.changed`,flow:`withdraw`,tier:`ui`,payload:{value:e}})},[F,g]),I=t().locale,L=o(e=>{F(),he(e),g({type:`withdraw.amount.changed`,flow:`withdraw`,tier:`ui`,payload:{raw:e,numeric:oe(e,I)}})},[F,g,I]),Se=o(e=>{F();let t=e.symbol.toUpperCase(),n=O.get(t)?.find(e=>e.chain.eip155Id===j?.eip155Id)??A(t);n&&(M(n.chain),P(n.token),g({type:`withdraw.receive.token.changed`,flow:`withdraw`,tier:`ui`,payload:{token:n.token}}),n.chain.eip155Id!==j?.eip155Id&&g({type:`withdraw.receive.chain.changed`,flow:`withdraw`,tier:`ui`,payload:{chain:n.chain}}))},[F,g,O,A,j?.eip155Id]),Ce=o(e=>{F(),M(e);let t=N?.symbol.toUpperCase(),n=(t?e.tokens.find(e=>e.symbol.toUpperCase()===t):void 0)??e.tokens[0];n&&P(n),g({type:`withdraw.receive.chain.changed`,flow:`withdraw`,tier:`ui`,payload:{chain:e}}),n!==void 0&&(N===void 0||n.address!==N.address)&&g({type:`withdraw.receive.token.changed`,flow:`withdraw`,tier:`ui`,payload:{token:n}})},[F,g,N]),R=oe(me,I),z=R!==null&&R>0,we=v.trim(),Te=we.length>0,Ee=j?.chainType??`unknown`,B=e(we,Ee),V=j!==void 0&&N!==void 0,H=z&&C!==void 0&&R>C,U=d.minAmountUsd,W=d.maxAmountUsd,De=b?.amountUsd&&b.amount.value>0?b.amountUsd.value/b.amount.value:void 0,G=De!==void 0&&R!==null?R*De:void 0,K=z&&G!==void 0&&U!==void 0&&U.value>0&&G<U.value,q=z&&G!==void 0&&W!==void 0&&W.value>0&&G>W.value,[J,Oe]=l(null),Y=(d.quote.status===`ready`||d.quote.status===`stale`)&&Te&&z&&V&&J!==null&&J.recipient===v&&J.amount===R&&J.receiveChainId===j.eip155Id&&J.receiveSymbol===N.symbol?d.quote.payload:void 0,ke=c(()=>O.size===0?[x]:[...O.values()].map(e=>{let t=e[0];return i({symbol:t.token.symbol,eip155Id:t.chain.eip155Id,address:t.token.address,isNative:t.token.isNative,logoUrl:t.token.assetLogoUrl})??{symbol:t.token.symbol}}),[O,x]),Ae=c(()=>{let e=N?.symbol.toUpperCase(),t=e?O.get(e):void 0;return(t?t.map(e=>e.chain):T).map(e=>i({symbol:e.networkName,eip155Id:e.eip155Id,isNative:!0,logoUrl:e.chainLogoUrl})??{symbol:e.networkName})},[N?.symbol,O,T]),je=N?i({symbol:N.symbol,eip155Id:j?.eip155Id,address:N.address,isNative:N.isNative,logoUrl:N.assetLogoUrl}):x,Me=j?i({symbol:j.networkName,eip155Id:j.eip155Id,isNative:!0,logoUrl:j.chainLogoUrl}):ve,Ne=c(()=>{if(Y?.breakdown)return{route:Y.breakdown.selectedRoute?.label,networkCost:Y.breakdown.networkCost?.formatted,priceImpact:Y.breakdown.priceImpact?.formatted}},[Y]),X=c(()=>{if(z)return Y?.receiveAmountUsd?Y.receiveAmountUsd.formatted:`$${R.toFixed(2)}`},[R,z,Y]),Pe=Y&&z?Y.receiveAmount.formatted:void 0,Fe=Y?.receiveAmountUsd?.formatted,Ie=B&&z&&!H&&!K&&!q&&V&&Y===void 0&&d.quote.status!==`error`,Z=B&&z&&!H&&!K&&!q&&V&&Y!==void 0,Le=se({expiresAt:Y?.expiresAt,enabled:Z}),Re=Z&&Y?Y.quoteTotalSeconds:void 0,[Q,ze]=l(!1);s(()=>{ze(!1)},[v,R,j?.eip155Id,N?.symbol,p.name]),s(()=>{if(!Z||!Y||p.name!==`form`||Q)return;let e=Math.max(0,Y.expiresAt-Date.now()),t=setTimeout(()=>{ze(!0),g({type:`withdraw.quote.expired`,flow:`withdraw`,tier:`flow`,payload:{}})},e);return()=>clearTimeout(t)},[g,Z,Y,p.name,Q]),s(()=>{if(!Q||p.name!==`form`||E===void 0||!j||!N||!B||!z||H||K||q)return;let e=new AbortController,t={recipient:v,amount:R??0,receiveChainId:j.eip155Id,receiveSymbol:N.symbol},n={sourceAssetSymbol:D,sourceChainId:E,amount:R??0,receiveTokenSymbol:N.symbol,receiveChainId:j.eip155Id,recipientAddress:v};return g({type:`withdraw.quote.requested`,flow:`withdraw`,tier:`flow`,payload:{input:n}}),f.requestQuote(n,e.signal).then(()=>{e.signal.aborted||Oe(t)}).catch(()=>{}).finally(()=>{e.signal.aborted||ze(!1)}),()=>e.abort()},[g,Q,f,v,R,B,z,H,K,q,E,D,j,N,p.name]);let $=!B||!z||H||K||q||!V||Ie||Q,Be=ce({enterRecipientAddress:h({id:`nr03QI`,message:`Enter Recipient Address`}),enterValidRecipientAddress:h({id:`GZPxmc`,message:`Enter Valid Recipient Address`}),enterAmount:h({id:`yH9V_J`,message:`Enter Amount`}),insufficientBalance:h({id:`N2DUxS`,message:`Insufficient Balance`}),...U?{belowMinimumAmount:h({id:`WkRH60`,message:`Min {0}`,values:{0:U.formatted}})}:{},...W?{aboveCapAmount:h({id:`AHyker`,message:`Max {0}`,values:{0:W.formatted}})}:{},regeneratingQuote:h({id:`Ly6geA`,message:`Regenerating quote…`}),estimatingQuote:h({id:`Uevt3L`,message:`Estimating quote`})},{isRecipientFilled:Te,isRecipientValid:B,isAmountValid:z,exceedsBalance:H,belowMinimum:K,aboveCap:q,quoteEstimating:Ie,quoteRegenerating:Q}),Ve=le(null);s(()=>{if(Ve.current?.abort(),!B||!z||H||K||q||!V||p.name!==`form`||E===void 0)return;let e=new AbortController;Ve.current=e;let t={recipient:v,amount:R,receiveChainId:j.eip155Id,receiveSymbol:N.symbol},n=setTimeout(()=>{let n={sourceAssetSymbol:D,sourceChainId:E,amount:R,receiveTokenSymbol:N.symbol,receiveChainId:j.eip155Id,recipientAddress:v};g({type:`withdraw.quote.requested`,flow:`withdraw`,tier:`flow`,payload:{input:n}}),f.requestQuote(n,e.signal).then(()=>{e.signal.aborted||Oe(t)}).catch(()=>{})},400);return()=>{clearTimeout(n),e.abort()}},[g,f,v,R,B,z,H,K,q,V,E,D,j?.eip155Id,N?.symbol,p.name]);let He=o(()=>{w&&(L(w.amount),g({type:`withdraw.max.clicked`,flow:`withdraw`,tier:`ui`,payload:{}}))},[w,g,L]),Ue=o(()=>{g({type:`withdraw.submit.clicked`,flow:`withdraw`,tier:`ui`,payload:{}}),!(ge||$)&&(E===void 0||!j||!N||m.submit({sourceAssetSymbol:D,sourceChainId:E,amount:R??0,recipientAddress:v,receiveTokenSymbol:N.symbol,receiveChainId:j.eip155Id,...X?{amountUsd:X}:{}}))},[m,R,X,g,E,D,j,N,v,$,ge]),We=o(e=>{let t=T.find(t=>String(t.eip155Id)===String(e.chainId));t&&Ce(t)},[Ce,T]),Ge=o(e=>{let t=e.symbol.toUpperCase(),n=O.get(t);!n||n.length===0||Se((n.find(e=>e.chain.eip155Id===j?.eip155Id)??n[0]).token)},[Se,O,j?.eip155Id]);return p.name!==`form`&&p.name!==`submitting`?null:ue(a,{recipientAddress:v,onRecipientChange:xe,recipientChainType:Ee,...fe?{suggestedRecipient:fe}:{},amount:me,onAmountChange:L,onAmountMax:He,sourceAsset:x,sourceChain:ve,receiveAsset:je,receiveChain:Me,receiveAssetOptions:ke,onReceiveAssetChange:Ge,receiveChainOptions:Ae,onReceiveChainChange:We,balance:w,amountUsd:X,receiveAmount:Pe,receiveAmountUsd:Fe,breakdown:Ne,quoteEstimating:Ie,quoteRegenerating:Q,...Le===void 0?{}:{quoteSeconds:Le},...Re===void 0?{}:{quoteTotalSeconds:Re},submitting:ge,submitDisabled:$,submitLabel:Be,...y?{notice:y}:{},onSubmit:Ue,onBreakdownOpenChange:e=>g({type:`withdraw.breakdown.clicked`,flow:`withdraw`,tier:`ui`,payload:{open:e}}),children:[u(a.Header,{}),ue(a.Body,{children:[u(a.RecipientField,{}),u(a.AmountField,{}),u(a.ReceiveSelectors,{}),u(a.BreakdownCard,{})]}),u(a.Footer,{})]})}export{d as WithdrawForm};

package/dist/flows/withdraw/widgets/withdraw-form/compound/WithdrawForm.js

@@ -1 +1 @@
-"use client";import{DialogShell as e}from"../../../../../shared/dialog/DialogShell.js";import{Tooltip as t}from"../../../../../shared/ui/Tooltip/Tooltip.js";import"../../../../../shared/ui/Tooltip/index.js";import{Frame as n}from"../../../../../shared/dialog/Frame.js";import{WithdrawFormContext as r}from"./context.js";import{WITHDRAW_FORM_SLOTS as i}from"./WithdrawForm.slots.js";import{styles as a}from"./WithdrawForm.styles.js";import{WithdrawFormAmountField as o}from"./components/AmountField.js";import{WithdrawFormBody as s}from"./components/Body.js";import{WithdrawFormBreakdownCard as c}from"./components/BreakdownCard.js";import{WithdrawFormFooter as l}from"./components/Footer.js";import{WithdrawFormHeader as u}from"./components/Header.js";import{WithdrawFormReceiveSelectors as d}from"./components/ReceiveSelectors.js";import{WithdrawFormRecipientField as f}from"./components/RecipientField.js";import{useCallback as p,useMemo as m,useState as h}from"react";import{jsx as g}from"react/jsx-runtime";import*as _ from"@stylexjs/stylex";const v=()=>void 0;function y(e){let{recipientAddress:o=``,onRecipientChange:s,connectedAddress:c,amount:l=``,onAmountChange:u,onAmountMax:d,sourceAsset:f,sourceChain:y,receiveAsset:b,receiveChain:x,receiveAssetOptions:S,onReceiveAssetChange:C,receiveChainOptions:w,onReceiveChainChange:T,balance:E,amountUsd:D,receiveAmount:O,receiveAmountUsd:k,breakdown:A,quoteEstimating:j=!1,quoteRegenerating:M=!1,quoteSeconds:N,quoteTotalSeconds:P,submitting:F=!1,submitDisabled:I=!1,submitLabel:L,notice:R,onSubmit:z,defaultBreakdownOpen:B=!1,breakdownOpen:V,onBreakdownOpenChange:H,children:U}=e,[W,G]=h(B),K=V!==void 0,q=K?V:W,J=p(e=>{K||G(e),H?.(e)},[K,H]),Y=b??f,X=x??y;return g(r,{value:m(()=>({recipientAddress:o,onRecipientChange:s??v,connectedAddress:c,amount:l,onAmountChange:u??v,onAmountMax:d,sourceAsset:f,sourceChain:y,receiveAsset:Y,receiveChain:X,receiveAssetOptions:S,onReceiveAssetChange:C,receiveChainOptions:w,onReceiveChainChange:T,balance:E,amountUsd:D,receiveAmount:O,receiveAmountUsd:k,breakdown:A,quoteEstimating:j,quoteRegenerating:M,quoteSeconds:N,quoteTotalSeconds:P,submitting:F,submitDisabled:I,submitLabel:L,notice:R,onSubmit:z,breakdownOpen:q,onBreakdownOpenChange:J}),[o,s,c,l,u,d,f,y,Y,X,S,C,w,T,E,D,O,k,A,j,M,N,P,F,I,L,R,z,q,J]),children:g(t.Provider,{children:g(n,{"data-stridge-slot":i.root,..._.props(a.root),children:U})})})}function b({open:t,defaultOpen:n,onOpenChange:r,trigger:i,children:a,...o}){return g(e,{open:t,defaultOpen:n,onOpenChange:r,trigger:i,children:g(y,{...o,children:a})})}(function(e){e.Header=u,e.Body=s,e.RecipientField=f,e.AmountField=o,e.ReceiveSelectors=d,e.BreakdownCard=c,e.Footer=l,e.Dialog=b})(y||={});export{y as WithdrawForm};
+"use client";import{DialogShell as e}from"../../../../../shared/dialog/DialogShell.js";import{Tooltip as t}from"../../../../../shared/ui/Tooltip/Tooltip.js";import"../../../../../shared/ui/Tooltip/index.js";import{Frame as n}from"../../../../../shared/dialog/Frame.js";import{WithdrawFormContext as r}from"./context.js";import{WITHDRAW_FORM_SLOTS as i}from"./WithdrawForm.slots.js";import{styles as a}from"./WithdrawForm.styles.js";import{WithdrawFormAmountField as o}from"./components/AmountField.js";import{WithdrawFormBody as s}from"./components/Body.js";import{WithdrawFormBreakdownCard as c}from"./components/BreakdownCard.js";import{WithdrawFormFooter as l}from"./components/Footer.js";import{WithdrawFormHeader as u}from"./components/Header.js";import{WithdrawFormReceiveSelectors as d}from"./components/ReceiveSelectors.js";import{WithdrawFormRecipientField as f}from"./components/RecipientField.js";import{useCallback as p,useMemo as m,useState as h}from"react";import{jsx as g}from"react/jsx-runtime";import*as _ from"@stylexjs/stylex";const v=()=>void 0;function y(e){let{recipientAddress:o=``,onRecipientChange:s,recipientChainType:c=`evm`,suggestedRecipient:l,amount:u=``,onAmountChange:d,onAmountMax:f,sourceAsset:y,sourceChain:b,receiveAsset:x,receiveChain:S,receiveAssetOptions:C,onReceiveAssetChange:w,receiveChainOptions:T,onReceiveChainChange:E,balance:D,amountUsd:O,receiveAmount:k,receiveAmountUsd:A,breakdown:j,quoteEstimating:M=!1,quoteRegenerating:N=!1,quoteSeconds:P,quoteTotalSeconds:F,submitting:I=!1,submitDisabled:L=!1,submitLabel:R,notice:z,onSubmit:B,defaultBreakdownOpen:V=!1,breakdownOpen:H,onBreakdownOpenChange:U,children:W}=e,[G,K]=h(V),q=H!==void 0,J=q?H:G,Y=p(e=>{q||K(e),U?.(e)},[q,U]),X=x??y,Z=S??b;return g(r,{value:m(()=>({recipientAddress:o,onRecipientChange:s??v,recipientChainType:c,suggestedRecipient:l,amount:u,onAmountChange:d??v,onAmountMax:f,sourceAsset:y,sourceChain:b,receiveAsset:X,receiveChain:Z,receiveAssetOptions:C,onReceiveAssetChange:w,receiveChainOptions:T,onReceiveChainChange:E,balance:D,amountUsd:O,receiveAmount:k,receiveAmountUsd:A,breakdown:j,quoteEstimating:M,quoteRegenerating:N,quoteSeconds:P,quoteTotalSeconds:F,submitting:I,submitDisabled:L,submitLabel:R,notice:z,onSubmit:B,breakdownOpen:J,onBreakdownOpenChange:Y}),[o,s,c,l,u,d,f,y,b,X,Z,C,w,T,E,D,O,k,A,j,M,N,P,F,I,L,R,z,B,J,Y]),children:g(t.Provider,{children:g(n,{"data-stridge-slot":i.root,..._.props(a.root),children:W})})})}function b({open:t,defaultOpen:n,onOpenChange:r,trigger:i,children:a,...o}){return g(e,{open:t,defaultOpen:n,onOpenChange:r,trigger:i,children:g(y,{...o,children:a})})}(function(e){e.Header=u,e.Body=s,e.RecipientField=f,e.AmountField=o,e.ReceiveSelectors=d,e.BreakdownCard=c,e.Footer=l,e.Dialog=b})(y||={});export{y as WithdrawForm};

package/dist/flows/withdraw/widgets/withdraw-form/compound/components/RecipientField.d.ts

@@ -2,17 +2,19 @@ import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/flows/withdraw/widgets/withdraw-form/compound/components/RecipientField.d.ts
 /**
- * Recipient address field — label + auto-growing textarea + trailing wallet pill.
+ * Recipient address field — label + auto-growing textarea + trailing prefill chip.
  *
  * The textarea wraps long hex addresses up to `maxBlockSize`, then scrolls. Single-line semantics
  * are kept by stripping any `\r\n` in `onChange` — no `onKeyDown` Enter-blocker, since that would
  * also swallow IME composition keys for CJK input. The stripping handler lives here (not in
  * `InputGroup.Textarea`) so the kit primitive stays neutral on the single-vs-multi-line decision.
  *
- * The pill becomes an interactive button when `connectedAddress` is set; clicking it fills the
- * input. Omitted entirely when `connectedAddress` is absent. The pill renders the truncated
- * address (`0x70…79C8`) — the user recognizes their own address, making the action self-evident
- * while keeping pill width deterministic across locales.
+ * The chip is host-controlled via `suggestedRecipient` on `<WithdrawDialog>` (or the compound
+ * root prop). Clicking it fills the input. Hidden entirely when no suggestion is supplied. The
+ * chip's `aria-label` reads off the host-supplied `label` so screen readers describe which
+ * address is being prefilled; the visible text shows the truncated address so sighted users
+ * see "this is mine" recognition. The kit no longer auto-derives this from `wagmi.address` —
+ * that misled users on embedded-wallet integrations.
  */
 declare function WithdrawFormRecipientField(): _$react_jsx_runtime0.JSX.Element;
 //#endregion