@stridge/kit 0.1.0-alpha.5 → 0.1.0-alpha.51

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

@@ -1,102 +1,66 @@
-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 { 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
 }?: 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;
     /**
-     * Terminal failure — either a settlement-driven failure (driver-emitted classification) or
-     * an FSM-derived failure (submission rejection escalated to the global error arm).
+     * 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.
      */
-    onFailed?: (failure: WithdrawalSettlementFailurePayload | FailureInfo) => void;
+    suggestedRecipient?: WithdrawSuggestedRecipient;
   }
 }
 //#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{Dialog as o}from"../../../shared/ui/Dialog/Dialog.js";import"../../../shared/ui/Dialog/index.js";import{Withdraw as s}from"../widgets/withdraw/compound/Withdraw.js";import"../../../withdraw/compound/index.js";import{WithdrawHistoryDetail as c}from"../widgets/activity-history/WithdrawHistoryDetail.js";import{WithdrawHistoryList as l}from"../widgets/activity-history/WithdrawHistoryList.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}={}){let S=n(),{close:C}=r(),w=t(),T=S.name!==`closed`;return i({state:S,settlement:w.settlement,quote:w.quote,metadata:_}),a(),e({...y===void 0?{}:{balance:y},...b?{onSubmit:b}:{},...x?{suggestedRecipient:x}:{}}),m(o,{open:T,onOpenChange:e=>e?void 0:C(),children:m(o.Content,{container:g,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:`historyList`,children:m(l,{})}),m(s.Step,{name:`historyDetail`,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,6 +1,9 @@
 import { Entity, SettlementFailureKind, TxRef } from "../../../shared/driver/types.js";
+import { FormattedField } from "../../../shared/format/types.js";
+import { ActivityHistoryPayload } from "../../../shared/widgets/activity-history/payloads.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";
+import { GatewayPollResponse, GatewayUdaDto } from "@stridge/sdk";
 
 //#region src/flows/withdraw/driver/types.d.ts
 /**
@@ -8,8 +11,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 +27,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 +41,27 @@ 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>;
+  /**
+   * Owner-scoped recent activity. Backed by the same multi-UDA envelope from
+   * `GET /gateway/{owner}` the deposit flow consumes — the list spans both deposit-direction
+   * and withdraw-direction settlements for the connected owner. Drives the kit's in-dialog
+   * `<ActivityHistory>` surface. `idle` when no fetch has run yet; `loading` during the first
+   * fetch; `ready` / `stale` once a list has landed; `error` when the initial fetch failed and
+   * the list is empty.
+   */
+  history: Entity<ActivityHistoryPayload, ReadonlyArray<GatewayUdaDto>, GatewayPollResponse>;
 }
 /**
  * Input to {@link WithdrawDriver.requestQuote}. The form widget builds this from current field
@@ -57,17 +82,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;
+/**
+ * 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}. Carries the broadcast tx ref so the watcher
- * can scope its poll to the in-flight withdraw.
+ * 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 +172,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
@@ -128,6 +202,29 @@ interface WithdrawDriver {
    * into its own snapshot. Hosts that surface a static brand-side balance can omit this.
    */
   watchWithdrawableBalances?(input: WatchWithdrawableBalancesInput, listener: (entity: WithdrawSnapshot["withdrawableBalances"]) => void, signal: AbortSignal): void;
+  /**
+   * Owner-scoped activity refresh. Calls `GET /gateway/{owner}` without a destination tuple,
+   * collapses the multi-UDA envelope into a row payload, and updates {@link
+   * WithdrawSnapshot.history} in place. Mirrors the deposit driver's contract — the kit's
+   * `<ActivityHistory>` surface is shared between the two dialogs, so both drivers expose the
+   * same refresh action. Used as the imperative one-shot trigger — the activity surface's
+   * error-view retry button calls this. Steady-state recurring fetches land via
+   * {@link watchHistory}. Optional — drivers that don't have a multi-UDA history concept can
+   * omit it, in which case the activity header icon is hidden.
+   */
+  refreshHistory?(signal: AbortSignal): void;
+  /**
+   * Long-running adaptive poll of `GET /gateway/{owner}` (unfiltered). Updates
+   * {@link WithdrawSnapshot.history} in place every tick. Cadence adapts to the
+   * current payload — short interval while any row is `pending`, long interval
+   * once all rows are terminal. Mounted by the controller while the FSM is on
+   * `history`; aborted on transition out.
+   *
+   * Optional — drivers that don't have a multi-UDA history concept can omit
+   * it. When omitted alongside {@link refreshHistory}, the activity surface
+   * stays cold (only the initial paint, no live updates).
+   */
+  watchHistory?(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,useEffect as f,useMemo as p,useReducer as m,useRef as h}from"react";import{jsx as g}from"react/jsx-runtime";const _={id:`ldK3jJ`,message:`Failed to submit withdrawal.`},v={id:`kUFhUv`,message:`Withdrawal failed.`},y={id:`srsA0x`,message:`Withdrawal declined.`},b=l(null);b.displayName=`WithdrawControllerContext`;function x(){let e=u(b);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 S(){return u(b)}function C(){return x().state}function w(){return x().effectiveState}function T(){return x().actions}function E({children:e}){let t=o(),[n,a]=m(c,s),l=O(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),k(t,n.name===`historyList`||n.name===`historyDetail`),A(n,a,t);let d=r(n),f=D(a,l,t);return g(b,{value:p(()=>({state:n,effectiveState:d,dispatch:a,controller:f,actions:l}),[n,d,f,l]),children:e})}function D(e,t,n){let r=h(n);r.current=n;let i=d(()=>{r.current.arm(),e({type:`OPEN`})},[e]),a=d(()=>{e({type:`CLOSE`})},[e]);return p(()=>({open:i,close:a,actions:t}),[i,a,t])}function O(n,r,i){let o=h(n);o.current=n;let s=h(i);s.current=i;let c=h(r);c.current=r;let{i18n:l}=e(),u=h(l);u.current=l;let f=a(),m=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._(y),code:`UserRejectedRequestError`},input:e})},succeed(){c.current({type:`MARK_SUCCEEDED`})}};n.prepareWithdrawal(i,r.signal).then(i=>{if(r.signal.aborted)return;let o=f.current.onSubmit;if(!o){c.current({type:`SUBMIT_FAILED`,failure:t(Error(`WithdrawDialog onSubmit is missing.`),u.current._(_)),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._(_)),input:e})})}catch(n){if(r.signal.aborted)return;c.current({type:`SUBMIT_FAILED`,failure:t(n,u.current._(_)),input:e})}}).catch(n=>{r.signal.aborted||c.current({type:`SUBMIT_FAILED`,failure:t(n,u.current._(_)),input:e})})},[]),g=d(()=>{c.current({type:`CLOSE`})},[]),v=d(()=>{c.current({type:`RESET`})},[]),b=d(()=>{c.current({type:`CLEAR_NOTICE`})},[]),x=d(()=>{c.current({type:`BACK`})},[]),S=d(()=>{o.current.name===`form`&&c.current({type:`OPEN_HISTORY`})},[]),C=d(e=>{c.current({type:`SELECT_SETTLEMENT`,settlementId:e})},[]);return p(()=>({submit:m,close:g,reset:v,clearNotice:b,back:x,openHistory:S,selectSettlement:C}),[m,g,v,b,x,S,C])}function k(e,t){f(()=>{if(!t||!e.watchHistory)return;let n=new AbortController;return e.watchHistory(n.signal),()=>n.abort()},[t,e])}function A(t,r,i){let a=h(t);a.current=t;let{i18n:o}=e(),s=h(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._(v),code:n.failureKind}:void 0;r({type:`SETTLEMENT_FAILED`,...i?{failure:i}:{}})}}})}export{E as WithdrawControllerProvider,x as useControllerContext,S as useOptionalControllerContext,T as useWithdrawActions,w as useWithdrawEffectiveState,C 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);case`historyList`:return l(e,t);case`historyDetail`:return u(e,t);default:return f(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`OPEN_HISTORY`:return{name:`historyList`,ctx:{backTarget:{kind:`form`,...e.ctx?.notice?{notice:e.ctx.notice}:{}}}};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,t){switch(t.type){case`SELECT_SETTLEMENT`:return{name:`historyDetail`,ctx:{settlementId:t.settlementId,backTarget:e.ctx.backTarget}};case`BACK`:return d(e.ctx.backTarget);case`CLOSE`:return{name:`closed`};default:return e}}function u(e,t){switch(t.type){case`BACK`:return{name:`historyList`,ctx:{backTarget:e.ctx.backTarget}};case`CLOSE`:return{name:`closed`};default:return e}}function d(e){return e.kind===`form`?e.notice?{name:`form`,ctx:{notice:e.notice}}:{name:`form`}:f(e.kind)}function f(e){throw Error(`Unhandled withdraw state: ${JSON.stringify(e)}`)}export{t as initialState,n as reducer};