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

package/dist/flows/deposit/dialog/DepositDialog.d.ts

@@ -1,7 +1,4 @@
-import { TxRef } from "../../../shared/driver/types.js";
-import { BalanceItemPayload, QuotePayload, SettlementFailurePayload, SettlementPendingPayload, SettlementSuccessPayload } from "../driver/payloads.js";
-import { FailureInfo } from "../../../shared/orchestrator/types.js";
-import { DepositMethod, DepositState, DepositStateName, ResolvedOpenInput } from "../orchestrator/types.js";
+import { Presentation } from "../../../shared/presentation/types.js";
 import { ErrorInfo } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
@@ -12,23 +9,23 @@ import * as _$react_jsx_runtime0 from "react/jsx-runtime";
  * bound to the controller's `state.name !== "closed"`, so the dialog appears / disappears
  * automatically as descendants call `useDeposit().open()` / `.close()`.
  *
- * Each widget gates rendering on its own FSM state, so the dialog stacks them and only one
- * renders content per state. Skip the dialog entirely for fully custom UI — render against
- * `useDeposit()` / `useDepositState()` / `useDepositSnapshot()` directly.
+ * The dialog is a pure composition of compound parts — `<Deposit.Boundary>` for crash
+ * recovery, `<Deposit.Guards>` for the wallet-required / bootstrap-fatal / bootstrap-loading
+ * cascade, `<Deposit.Steps>` for FSM-driven screen routing, and `<DepositStatusBanner />` for
+ * the inline settlement banner. Each piece is independently overrideable via the compound
+ * surface; this is the canonical shape integrators can copy verbatim.
  *
- * Three top-level callbacks (`onOpened`, `onClosed`, `onStepChanged`) describe the dialog as a
- * stateful component. The grouped `events={{ … }}` prop carries the operational lifecycle —
- * user actions, async outcomes from the orchestrator, and settlement-entity transitions for
- * pending / succeeded / failed deposits.
+ * Lifecycle observability is delivered by the unified event bus exported from
+ * `@stridge/kit/events`. The dialog itself takes no `on*` callback props — subscribe via
+ * `useStridgeFlowEvents` / `useStridgeEvents` (or the single-event variants) anywhere in
+ * the provider subtree.
  */
 declare function DepositDialog({
   container,
-  onOpened,
-  onClosed,
-  onStepChanged,
+  metadata,
   onError,
-  events
-}: DepositDialog.Props): _$react_jsx_runtime0.JSX.Element;
+  presentation
+}?: DepositDialog.Props): _$react_jsx_runtime0.JSX.Element;
 declare namespace DepositDialog {
   interface Props {
     /**
@@ -37,76 +34,26 @@ declare namespace DepositDialog {
      * dialog's width, height, and backdrop to that rect.
      */
     container?: HTMLElement | null;
-    /** 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. Receives the
-     * resolved open input derived from the entry state.
+     * Consumer-attached metadata that rides along on every bus event emitted from this
+     * dialog's session. Snapshotted at `deposit.opened` and frozen for the session —
+     * mid-flow prop changes are ignored to keep correlation consistent from `opened` to
+     * the terminal event. The kit does not validate or normalise the shape.
      */
-    onOpened?: (input: ResolvedOpenInput) => void;
-    /** Fires once when the dialog transitions back to `closed`. `atStep` is the last open step. */
-    onClosed?: (atStep: DepositStateName) => void;
-    /** Fires on every logical step transition. */
-    onStepChanged?: (event: {
-      from: DepositStateName;
-      to: DepositStateName;
-      ctx: GatewayContext | null;
-    }) => void;
-    /** Operational events — user actions, async outcomes, settlement-entity transitions. */
-    events?: Events;
-  }
-  /**
-   * Operational lifecycle hooks. Fire after the controller has acted (state machine has
-   * transitioned, driver entity has settled), so payloads are guaranteed valid for the named
-   * event.
-   */
-  interface Events {
-    /** User picked a deposit method on the `Deposit` step. */
-    onMethodSelected?: (method: DepositMethod) => void;
-    /** User confirmed an asset on the `AssetPicker` step. The asset is the driver-shaped balance row. */
-    onAssetSelected?: (asset: BalanceItemPayload) => void;
-    /** User submitted an amount on the `AmountEntry` step. */
-    onAmountSubmitted?: (amount: number) => void;
-    /** User confirmed the deposit on the `ConfirmDeposit` step (wallet prompt is about to fire). */
-    onDepositConfirmed?: () => void;
-    /** User pressed Back on a non-root step. */
-    onBackPressed?: (fromStep: DepositStateName) => void;
-    /** Orchestrator requested a quote (`confirmDeposit` entered `loading` or `regenerating`). */
-    onQuoteRequested?: (input: {
-      asset: BalanceItemPayload;
-      amount: number;
-    }) => void;
-    /** Orchestrator received a successful quote — fires when the driver's `quote` entity transitions to `ready`. */
-    onQuoteResolved?: (quote: QuotePayload) => void;
-    /** Quote fetch failed (FSM `confirmDeposit{phase: failed, recoverFrom: "quote"}`). */
-    onQuoteFailed?: (failure: FailureInfo) => void;
-    /** A quote silently expired and a regeneration started (no user interaction). */
-    onQuoteExpired?: () => void;
-    /** Wallet broadcast a deposit tx; the orchestrator transitioned into `processing`. */
-    onDepositSubmitted?: (tx: TxRef) => void;
-    /** User declined the wallet signature prompt; orchestrator regenerated the quote. */
-    onSignatureDeclined?: () => void;
-    /** Deposit submission failed for a non-rejection reason. */
-    onSubmissionFailed?: (failure: FailureInfo) => void;
-    /** The driver's `settlement` entity emitted a progressive pending update. */
-    onProcessingProgress?: (update: SettlementPendingPayload) => void;
-    /** Terminal success — settlement entity reached `ready{kind: "succeeded"}`. */
-    onSucceeded?: (result: SettlementSuccessPayload) => void;
+    metadata?: Record<string, unknown>;
     /**
-     * Terminal failure — either a settlement failure (driver-emitted classification) or an
-     * FSM-derived failure (quote / submission rejection escalated to the global error arm).
+     * Forwarded to the dialog's internal `<Deposit.Boundary>` for crash reporting. The
+     * boundary's `onReset` is wired automatically through `useDeposit().close()`.
      */
-    onFailed?: (failure: SettlementFailurePayload | FailureInfo) => void;
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
     /**
-     * Background `fetchActiveSettlement` probe surfaced a pending deposit — the driver's
-     * `settlement` entity transitioned from `idle` / `loading` straight to a pending payload.
+     * Per-dialog surface override. `"auto"` (default) renders a centred dialog on wide
+     * containers and a bottom-sheet drawer below the breakpoint; `"dialog"` / `"drawer"`
+     * force one surface. Pass `{ mode, breakpoint }` to tune the px threshold (default 600).
+     * Wins over the provider's `appearance.presentation`; omit to inherit it.
      */
-    onPendingSnapshotDetected?: (snapshot: SettlementPendingPayload) => void;
+    presentation?: Presentation;
   }
 }
-/** Convenience union — the `ctx` payload on `onStepChanged`. */
-type GatewayContext = Exclude<DepositState, {
-  name: "closed";
-}>["ctx"];
 //#endregion
 export { DepositDialog };

package/dist/flows/deposit/dialog/DepositDialog.js

@@ -1 +1 @@
-"use client";import{useDepositSnapshot as e}from"../driver/context.js";import{useDialogLifecycle as t}from"../../../shared/orchestrator/useDialogLifecycle.js";import"../../../shared/orchestrator/index.js";import{useControllerContext as n}from"../orchestrator/controller.js";import{Dialog as r}from"../../../shared/ui/Dialog/Dialog.js";import"../../../shared/ui/Dialog/index.js";import{AmountEntry as i}from"../widgets/amount-entry/AmountEntry.js";import"../widgets/amount-entry/index.js";import{AssetPicker as a}from"../widgets/asset-picker/AssetPicker.js";import"../widgets/asset-picker/index.js";import{ConfirmDeposit as o}from"../widgets/confirm-deposit/ConfirmDeposit.js";import"../widgets/confirm-deposit/index.js";import{Deposit as s}from"../widgets/deposit/Deposit.js";import"../widgets/deposit/index.js";import{DepositStatusBanner as c}from"../widgets/deposit-status-banner/DepositStatusBanner.js";import"../widgets/deposit-status-banner/index.js";import{ErrorState as l}from"../widgets/error-state/ErrorState.js";import"../widgets/error-state/index.js";import{ProcessingState as u}from"../widgets/processing-state/ProcessingState.js";import"../widgets/processing-state/index.js";import{SuccessState as d}from"../widgets/success-state/SuccessState.js";import"../widgets/success-state/index.js";import{TransferCrypto as f}from"../widgets/transfer-crypto/TransferCrypto.js";import"../widgets/transfer-crypto/index.js";import{StepTransition as p}from"../../../shared/dialog/StepTransition.js";import{GatewayKitBoundary as m}from"../../../shared/error-handling/components/GatewayKitBoundary.js";import"../../../shared/error-handling/index.js";import{DepositBootstrapErrorState as h}from"./DepositBootstrapErrorState.js";import{useRef as g}from"react";import{jsx as _,jsxs as v}from"react/jsx-runtime";const y=new Set([`deposit`,`assetPicker`,`amountEntry`,`confirmDeposit`,`transferCrypto`]);function b({container:t,onOpened:g,onClosed:b,onStepChanged:S,onError:C,events:w}){let{state:T,effectiveState:E,controller:D}=n(),O=e(),k=T.name!==`closed`;x(T,O.settlement,O.quote,{onOpened:g,onClosed:b,onStepChanged:S,events:w});let A=E,j=O.target.status===`error`&&y.has(A.name);return _(r,{open:k,onOpenChange:e=>{e||D.close()},children:_(r.Content,{container:t,children:v(m,{onError:C,onReset:D.close,children:[j?_(h,{}):v(p,{stateKey:A.name,children:[A.name===`deposit`?_(s,{}):null,A.name===`assetPicker`?_(a,{}):null,A.name===`amountEntry`?_(i,{}):null,A.name===`confirmDeposit`?_(o,{}):null,A.name===`transferCrypto`?_(f,{}):null,A.name===`processing`?_(u,{}):null,A.name===`success`?_(d,{}):null,A.name===`error`?_(l,{}):null]}),_(c,{})]})})})}function x(e,n,r,i){let a=g(i);a.current=i,t({state:e,settlement:n,quote:r,fireFsm:(e,t)=>S(e,t,a.current),fireSettlement:(e,t)=>T(e,t,a.current),fireQuote:(e,t)=>{t.status===`ready`&&e!==`ready`&&a.current.events?.onQuoteResolved?.(t.payload)}})}function S(e,t,n){let{onOpened:r,onClosed:i,onStepChanged:a,events:o}=n;if(e.name===t.name){t.name===`confirmDeposit`&&e.name===`confirmDeposit`&&w(e.ctx.phase,t.ctx.phase,t,o);return}e.name===`closed`&&t.name!==`closed`&&r?.(C(t)),e.name!==`closed`&&t.name===`closed`&&i?.(e.name),a?.({from:e.name,to:t.name,ctx:t.name===`closed`?null:t.ctx}),e.name===`deposit`&&t.name===`assetPicker`&&o?.onMethodSelected?.(`wallet`),e.name===`deposit`&&t.name===`transferCrypto`&&o?.onMethodSelected?.(`transfer`),e.name===`assetPicker`&&t.name===`amountEntry`&&o?.onAssetSelected?.(t.ctx.asset),e.name===`amountEntry`&&t.name===`confirmDeposit`&&o?.onAmountSubmitted?.(t.ctx.amount),t.name===`confirmDeposit`&&(e.name!==`confirmDeposit`||e.ctx.phase.kind!==t.ctx.phase.kind)&&w(e.name===`confirmDeposit`?e.ctx.phase:void 0,t.ctx.phase,t,o),e.name===`confirmDeposit`&&t.name===`processing`&&o?.onDepositSubmitted?.(t.ctx.tx),e.name!==`error`&&t.name===`error`&&t.ctx.failure&&(o?.onFailed?.(t.ctx.failure),(e.name===`confirmDeposit`?e.ctx.phase:void 0)?.kind===`submitting`&&o?.onSubmissionFailed?.(t.ctx.failure)),t.name!==`closed`&&e.name!==`closed`&&`backTarget`in e.ctx&&t.name===e.ctx.backTarget&&o?.onBackPressed?.(e.name)}function C(e){if(e.name!==`deposit`){if(e.name===`transferCrypto`)return{method:`transfer`};if(e.name===`assetPicker`)return{method:`wallet`};if(e.name===`amountEntry`||e.name===`confirmDeposit`)return{method:`wallet`,asset:e.ctx.asset};if(e.name===`processing`||e.name===`success`)return e.ctx.method===`transfer`?{method:`transfer`}:{method:`wallet`}}}function w(e,t,n,r){r&&e?.kind!==t.kind&&((t.kind===`loading`||t.kind===`regenerating`)&&(r.onQuoteRequested?.({asset:n.ctx.asset,amount:n.ctx.amount}),t.kind===`regenerating`&&(e?.kind===`submitting`?r.onSignatureDeclined?.():e?.kind===`ready`&&r.onQuoteExpired?.())),t.kind===`failed`&&r.onQuoteFailed?.(t.failure),t.kind===`submitting`&&r.onDepositConfirmed?.())}function T(e,t,n){if(t.status!==`ready`&&t.status!==`stale`)return;let r=t.payload,i=n.events;if(i){if(r.kind===`pending`){e===null?i.onPendingSnapshotDetected?.(r):i.onProcessingProgress?.(r);return}if(r.kind===`succeeded`){i.onSucceeded?.(r);return}r.kind===`failed`&&i.onFailed?.(r)}}export{b as DepositDialog};
+"use client";import{useDepositSnapshot as e}from"../driver/context.js";import{useControllerContext as t}from"../orchestrator/controller.js";import{useDepositEmissions as n}from"../../../events/emit/useDepositEmissions.js";import"../../../events/emit/index.js";import{useIntercomShutdownOnUnmount as r}from"../../../shared/support/useIntercomShutdownOnUnmount.js";import"../../../shared/support/index.js";import{AdaptiveSurface as i}from"../../../shared/ui/AdaptiveSurface/AdaptiveSurface.js";import"../../../shared/ui/AdaptiveSurface/index.js";import{Deposit as a}from"../widgets/deposit/compound/Deposit.js";import"../widgets/deposit/compound/index.js";import{DepositActivityDetail as o}from"../widgets/activity/DepositActivityDetail.js";import{DepositActivityList as s}from"../widgets/activity/DepositActivityList.js";import"../widgets/activity/index.js";import{AmountEntry as c}from"../widgets/amount-entry/AmountEntry.js";import"../widgets/amount-entry/index.js";import{AssetPicker as l}from"../widgets/asset-picker/AssetPicker.js";import"../widgets/asset-picker/index.js";import{ConfirmDeposit as u}from"../widgets/confirm-deposit/ConfirmDeposit.js";import"../widgets/confirm-deposit/index.js";import{Deposit as d}from"../widgets/deposit/Deposit.js";import"../widgets/deposit/index.js";import{DepositStatusBanner as f}from"../widgets/deposit-status-banner/DepositStatusBanner.js";import"../widgets/deposit-status-banner/index.js";import{ErrorState as p}from"../widgets/error-state/ErrorState.js";import"../widgets/error-state/index.js";import{OnrampAmountEntry as m}from"../widgets/onramp-amount-entry/OnrampAmountEntry.js";import"../widgets/onramp-amount-entry/index.js";import{OnrampConfirm as h}from"../widgets/onramp-confirm/OnrampConfirm.js";import"../widgets/onramp-confirm/index.js";import{OnrampPaymentPending as g}from"../widgets/onramp-payment-pending/OnrampPaymentPending.js";import"../widgets/onramp-payment-pending/index.js";import{ProcessingState as _}from"../widgets/processing-state/ProcessingState.js";import"../widgets/processing-state/index.js";import{SuccessState as v}from"../widgets/success-state/SuccessState.js";import"../widgets/success-state/index.js";import{TransferCrypto as y}from"../widgets/transfer-crypto/TransferCrypto.js";import"../widgets/transfer-crypto/index.js";import{jsx as b,jsxs as x}from"react/jsx-runtime";function S({container:S,metadata:C,onError:w,presentation:T}={}){let{state:E,controller:D}=t(),O=e(),k=E.name!==`closed`;return n({state:E,settlement:O.settlement,quote:O.quote,metadata:C}),r(),b(i,{open:k,onOpenChange:e=>{e||D.close()},container:S,...T?{presentation:T}:{},children:x(a.Boundary,{...w?{onError:w}:{},children:[b(a.Guards,{children:x(a.Steps,{children:[b(a.Step,{name:`deposit`,children:b(d,{})}),b(a.Step,{name:`assetPicker`,children:b(l,{})}),b(a.Step,{name:`amountEntry`,children:b(c,{})}),b(a.Step,{name:`onrampAmountEntry`,children:b(m,{})}),b(a.Step,{name:`onrampConfirm`,children:b(h,{})}),b(a.Step,{name:`onrampPaymentPending`,children:b(g,{})}),b(a.Step,{name:`confirmDeposit`,children:b(u,{})}),b(a.Step,{name:`transferCrypto`,children:b(y,{})}),b(a.Step,{name:`processing`,children:b(_,{})}),b(a.Step,{name:`success`,children:b(v,{})}),b(a.Step,{name:`error`,children:b(p,{})}),b(a.Step,{name:`activityList`,children:b(s,{})}),b(a.Step,{name:`activityDetail`,children:b(o,{})})]})}),b(f,{})]})})}export{S as DepositDialog};

package/dist/flows/deposit/dialog/WalletRequiredState.js

@@ -0,0 +1 @@
+"use client";import{Trans as e}from"../../../shared/i18n/Trans.js";import"../../../i18n/index.js";import{useDepositActions as t}from"../orchestrator/controller.js";import{WalletIcon as n}from"../../../shared/icons/WalletIcon.js";import"../../../icons/index.js";import{useConnectWallet as r}from"../../../shared/wallet/ConnectWalletContext.js";import{Button as i}from"../../../shared/ui/Button/Button.js";import{Dialog as a}from"../../../shared/ui/Dialog/Dialog.js";import"../../../shared/ui/Dialog/index.js";import{Card as o}from"../../../shared/ui/Card/Card.js";import{text as s}from"../../../shared/ui/Text/Text.js";import"../../../ui/index.js";import{Frame as c}from"../../../shared/dialog/Frame.js";import{styles as l}from"./WalletRequiredState.styles.js";import{jsx as u,jsxs as d}from"react/jsx-runtime";import*as f from"@stylexjs/stylex";function p(){return d(`div`,{"aria-hidden":!0,...f.props(l.heroRing),children:[d(`svg`,{viewBox:`0 0 64 64`,xmlns:`http://www.w3.org/2000/svg`,fill:`none`,...f.props(l.heroRingSvg),children:[u(`circle`,{cx:`32`,cy:`32`,r:`28`,strokeWidth:`2`,style:{stroke:`color-mix(in oklab, var(--stridge-kit-info) 55%, transparent)`}}),u(`circle`,{cx:`32`,cy:`32`,r:`20`,style:{fill:`var(--stridge-kit-info)`}})]}),u(n,{style:{color:`var(--stridge-kit-info-foreground)`},...f.props(l.heroRingGlyph)})]})}function m(){let{close:n}=t(),m=r();return d(c,{"data-stridge-slot":`deposit-wallet-required`,"data-testid":`deposit-wallet-required`,...f.props(l.root),children:[d(o.Header,{...f.props(l.header),children:[u(s.span,{size:`base`,fontWeight:`semibold`,leading:`tight`,tracking:`tight`,children:u(e,{id:`5AApJw`,message:`Connect a wallet to continue`})}),u(a.CloseButton,{})]}),u(o.Body,{children:d(`div`,{"data-stridge-slot":`deposit-wallet-required-hero`,...f.props(l.hero),children:[u(p,{}),u(s.span,{size:`lg`,fontWeight:`semibold`,leading:`tight`,tracking:`tight`,align:`center`,...f.props(l.heroHeadline),children:u(e,{id:`BoQOH3`,message:`A wallet is required to deposit`})}),u(s.span,{size:`sm`,leading:`normal`,align:`center`,color:`subdued`,...f.props(l.heroReason),children:u(e,{id:`mF_ucv`,message:`Connect a wallet so the gateway can provision a deposit address and route your transfer.`})})]})}),d(o.Footer,{...f.props(l.footer),children:[m?u(i,{variant:`default`,size:`cta`,onClick:()=>{m.onClick()},"data-stridge-slot":`deposit-wallet-required-connect`,...f.props(l.cta),children:m.label??u(e,{id:`VHOVEJ`,message:`Connect wallet`})}):null,u(i,{variant:m?`ghost`:`default`,size:`cta`,onClick:n,"data-stridge-slot":`deposit-wallet-required-close`,...f.props(l.cta),children:u(e,{id:`yz7wBu`,message:`Close`})})]})]})}export{m as WalletRequiredState};

package/dist/flows/deposit/dialog/WalletRequiredState.styles.js

@@ -0,0 +1 @@
+const e={root:{"WalletRequiredState__styles.root":`WalletRequiredState__styles.root`,"position-kVAEAm":`x1n2onr6`,"width-kzqmXN":`xh8yej3`,"maxWidth-ks0D6T":`x17fpy1y`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:25`},header:{"WalletRequiredState__styles.header":`WalletRequiredState__styles.header`,"justifyContent-kjj79g":`x1qughib`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:34`},hero:{"WalletRequiredState__styles.hero":`WalletRequiredState__styles.hero`,"display-k1xSpc":`x78zum5`,"flexDirection-kXwgrk":`xdt5ytf`,"alignItems-kGNEyG":`x6s0dn4`,"gap-kOIVth":`x883omv`,"paddingTop-kLKAdn":`x9desvi`,"paddingInline-kg3NbH":`x65v0h`,"paddingBottom-kGO01o":`x1hhzuzn`,"animationName-kKVMdj":`xv305lp`,"animationDuration-k44tkh":`xmprevt x1s1fvk8`,"animationTimingFunction-kyAemX":`xrkt6z0`,"animationFillMode-kWV6AL":`x1u6ievf`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:42`},heroRing:{"WalletRequiredState__styles.heroRing":`WalletRequiredState__styles.heroRing`,"position-kVAEAm":`x1n2onr6`,"width-kzqmXN":`x1fu8urw`,"height-kZKoxP":`x1peatla`,"flexShrink-kmuXW":`x2lah0s`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:64`},heroRingSvg:{"WalletRequiredState__styles.heroRingSvg":`WalletRequiredState__styles.heroRingSvg`,"display-k1xSpc":`x1lliihq`,"width-kzqmXN":`xh8yej3`,"height-kZKoxP":`x5yr21d`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:73`},heroRingGlyph:{"WalletRequiredState__styles.heroRingGlyph":`WalletRequiredState__styles.heroRingGlyph`,"position-kVAEAm":`x10l6tqk`,"insetInlineStart-kLqNvP":`xbudbmw`,"top-k87sOh":`xwa60dl`,"transform-k3aq6I":`x11lhmoz`,"width-kzqmXN":`xgd8bvy`,"height-kZKoxP":`x1fgtraw`,"strokeWidth-kfJifR":`xvlca1e`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:87`},heroHeadline:{"WalletRequiredState__styles.heroHeadline":`WalletRequiredState__styles.heroHeadline`,"marginTop-keoZOQ":`x1k70j0n`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:96`},heroReason:{"WalletRequiredState__styles.heroReason":`WalletRequiredState__styles.heroReason`,"maxWidth-ks0D6T":`x1va8c73`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:99`},footer:{"WalletRequiredState__styles.footer":`WalletRequiredState__styles.footer`,"display-k1xSpc":`x78zum5`,"flexDirection-kXwgrk":`xdt5ytf`,"alignItems-kGNEyG":`x1qjc9v5`,"gap-kOIVth":`x1a6yh9e`,"paddingTop-kLKAdn":`x109j2v6`,"paddingInline-kg3NbH":`x65v0h`,"paddingBottom-kGO01o":`x1t4gjm`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:107`},cta:{"WalletRequiredState__styles.cta":`WalletRequiredState__styles.cta`,"width-kzqmXN":`xh8yej3`,"alignSelf-kSGwAc":`xkh2ocl`,$$css:`@stridge/kit:src/flows/deposit/dialog/WalletRequiredState.styles.ts:116`}};export{e as styles};

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

@@ -40,6 +40,97 @@ interface WalletPayload {
    */
   balanceTotalUsd?: FormattedField<number>;
 }
+/**
+ * Capability descriptor for the onramp ("Cash") rail. The rail is single-method — the
+ * provider's hosted checkout collects the payment instrument — so drivers populate one capability
+ * bag with the limit + processing-time the deposit-method picker surfaces on the row's meta line
+ * (`"$116,000.00 limit · Instant"`). Both fields are optional so the meta line drops segments
+ * gracefully when the driver doesn't surface them yet.
+ */
+interface OnrampMethodCapability {
+  /**
+   * Maximum deposit, in USD. `value` is the raw ceiling for sorting / range checks; `formatted`
+   * is the localized currency string (`"$116,000.00"`). The widget composes the meta segment
+   * from the formatted string plus a localized `" limit"` suffix.
+   */
+  limit?: FormattedField<number>;
+  /**
+   * Estimated time from confirmation to credit. `value` is seconds (`0` = instant); `formatted`
+   * is the localized display label the widget renders verbatim (`"Instant"`, `"5 min"`, …).
+   * Drivers pre-format because the kit's i18n macros do not have driver-thread access.
+   */
+  processingTime?: FormattedField<number>;
+}
+/**
+ * Onramp-rail capability bag surfaced on `DepositSnapshot.onrampMethods`. The rail is single-method
+ * (the hosted-checkout provider collects the payment instrument), so this carries one capability
+ * directly rather than a per-method map. The orchestrated `Deposit` widget reads the `limit` +
+ * `processingTime` and maps them into the "Cash" row's meta line; the onramp amount-entry
+ * reads `limit` for its over-limit / unavailable notices.
+ */
+type OnrampMethodsPayload = OnrampMethodCapability;
+/**
+ * Receive-asset descriptor for the onramp rail — the crypto the user ends up with after the fiat
+ * purchase settles. Mirrors {@link AssetPayload} plus the `chainId` the kit's `TokenLogo` resolver
+ * needs, so the onramp amount-entry / confirm screens render the destination token without reaching
+ * into another entity.
+ */
+interface OnrampReceiveAssetPayload extends AssetPayload {
+  /** EIP-155 chain id of the receive asset (drives the token-logo resolver). */
+  chainId: number;
+}
+/**
+ * Formatted onramp-quote result surfaced on `DepositSnapshot.onrampQuote` — the fiat→crypto pricing
+ * the onramp amount-entry hero, receive chip, and fee-breakdown rows read. Backed by the SDK's
+ * `OnrampQuoteResponse`. Raw numeric `value`s are kept on the {@link FormattedField}s so widgets can
+ * re-derive (e.g. net-of-fees) locally.
+ */
+interface OnrampQuotePayload {
+  /** Fiat amount the user pays (USD). */
+  amountUsd: FormattedField<number>;
+  /** Crypto amount the user receives after fees. Drives the Receive chip + hero sub-line. */
+  receiveAmount: FormattedField<number>;
+  /** The crypto asset the user receives. */
+  receiveAsset: OnrampReceiveAssetPayload;
+  /** Crypto-per-fiat rate (e.g. USDC per USD). Drives the price row. */
+  rate: FormattedField<number>;
+  /** Provider processing fee (USD). Omitted when the provider doesn't surface it. */
+  processingFeeUsd?: FormattedField<number>;
+  /** Network/settlement fee (USD). Omitted when zero / unknown. */
+  networkFeeUsd?: FormattedField<number>;
+  /** Total fee charged on top of the received crypto (USD). */
+  totalFeeUsd: FormattedField<number>;
+  /** Resolved hosted-checkout provider name. */
+  provider?: string;
+}
+/**
+ * Lifecycle state of an onramp checkout session, mirrored 1:1 from the SDK's
+ * `OnrampSessionState`. The kit's reducer maps the three terminal values onto its shared
+ * `processing` / `success` / `error` screens.
+ */
+type OnrampSessionStateName = "SESSION_PENDING" | "SESSION_COMPLETED" | "SESSION_EXPIRED" | "SESSION_FAILED";
+/**
+ * Onramp checkout-session payload surfaced on `DepositSnapshot.onrampSession`. Created by
+ * {@link import("./types").DepositDriver.createOnrampSession} and advanced by
+ * {@link import("./types").DepositDriver.watchOnrampSession}. The `checkoutUrl` is the provider-hosted
+ * page the kit redirects (or pops out) to; `state` drives the redirect → poll → terminal UI.
+ */
+interface OnrampSessionPayload {
+  /** Provider session id (UUID). */
+  sessionId: string;
+  /** Current session state. */
+  state: OnrampSessionStateName;
+  /** Provider-hosted checkout URL the user completes payment on. Present once the session is created. */
+  checkoutUrl?: string;
+  /** Provider order id, once allocated. */
+  providerOrderId?: string;
+  /** Crypto amount the user receives, captured at create time (display units). */
+  receiveAmount?: FormattedField<number>;
+  /** Failure code when `state === "SESSION_FAILED"` (e.g. `"payment_declined"`). */
+  failureCode?: string;
+  /** Session/checkout expiry timestamp (Unix-ms). */
+  expiresAt?: number;
+}
 /**
  * Brand context surfaced across the kit's chrome — `<DialogShell>` title, `<ConfirmDeposit>`
  * destination row, `<ProcessingState>` header pill, `<SuccessState>` "credited to" line. The host
@@ -95,7 +186,13 @@ interface AssetPayload {
  */
 interface TargetPayload extends ChainPayload, AssetPayload {
   /** Optional minimum-deposit USD floor surfaced on amount-entry / asset-picker chrome. */
-  minDepositUsd?: FormattedField<number>;
+  minAmountUsd?: FormattedField<number>;
+  /**
+   * Optional upper USD bound on the deposit amount. When set, the amount-entry treats
+   * `min(walletBalanceUsd, maxAmountUsd.value)` as the effective ceiling. Omitted when the
+   * host did not configure `flows.deposit.maxAmountUsd`.
+   */
+  maxAmountUsd?: FormattedField<number>;
 }
 /**
  * Per-chain deposit address provisioned by `gateway/start`. The kit ships one envelope item per
@@ -111,9 +208,9 @@ interface AddressItemPayload extends ChainPayload {
    * Per-chain minimum-deposit USD floor surfaced next to the chain row in the transfer-crypto
    * picker (`"Min $5"`). Drivers populate this from `supportedAssets`'s per-(chain × asset)
    * floors so the user sees the right number for the chain they're funding from. Optional —
-   * the picker falls back to {@link TargetPayload.minDepositUsd} when this isn't available.
+   * the picker falls back to {@link TargetPayload.minAmountUsd} when this isn't available.
    */
-  minDepositUsd?: FormattedField<number>;
+  minAmountUsd?: FormattedField<number>;
   /**
    * Tokens the gateway accepts on this chain (`gateway/start.deposit_addresses[i].accepted_assets`).
    * Drives the transfer-crypto Tokens dropdown — when the user picks a chain, the dropdown
@@ -140,6 +237,13 @@ interface AcceptedAssetPayload {
   assetLogoUrl?: string;
   /** True for the chain's native gas token (synthesized from an empty `address`). */
   isNative: boolean;
+  /**
+   * Estimated price impact of depositing this asset, as a percentage decimal string
+   * (`"0.5"`, `"1.25"`). Joined from the `gateway/assets` catalog by (chain × contract address)
+   * — the wire's `accepted_assets` doesn't carry it. Drives the price-impact hint on the
+   * transfer-crypto disclosure row. Omitted when the catalog has no estimate for this asset.
+   */
+  priceImpact?: string;
 }
 /**
  * Source-side per-asset balance — what the connected wallet holds across supported chains. Drives
@@ -154,7 +258,7 @@ interface BalanceItemPayload extends ChainPayload, AssetPayload {
   priceUsd?: number;
   /**
    * `true` when this row's USD value is below the kit's deposit floor
-   * ({@link TargetPayload.minDepositUsd}). Drives the muted "Low Balance" badge in the asset
+   * ({@link TargetPayload.minAmountUsd}). Drives the muted "Low Balance" badge in the asset
    * picker; the row remains visible so the user knows the asset exists in the wallet.
    */
   lowBalance?: boolean;
@@ -339,4 +443,4 @@ interface SettlementFailurePayload {
  */
 type SettlementPayload = SettlementPendingPayload | SettlementSuccessPayload | SettlementFailurePayload;
 //#endregion
-export { AcceptedAssetPayload, AddressItemPayload, AssetPayload, BalanceItemPayload, BrandPayload, ChainPayload, QuoteBreakdownPayload, QuotePayload, QuoteRoutePayload, SettlementFailurePayload, SettlementPayload, SettlementPendingPayload, SettlementSuccessPayload, SourceWalletPayload, TargetPayload, WalletInfo, WalletPayload };
+export { AcceptedAssetPayload, AddressItemPayload, AssetPayload, BalanceItemPayload, BrandPayload, ChainPayload, OnrampMethodCapability, OnrampMethodsPayload, OnrampQuotePayload, OnrampReceiveAssetPayload, OnrampSessionPayload, OnrampSessionStateName, QuoteBreakdownPayload, QuotePayload, QuoteRoutePayload, SettlementFailurePayload, SettlementPayload, SettlementPendingPayload, SettlementSuccessPayload, SourceWalletPayload, TargetPayload, WalletInfo, WalletPayload };

package/dist/flows/deposit/driver/transformers/balanceToBalancesPayload.d.ts

@@ -0,0 +1,2 @@
+import { I18n } from "@lingui/core";
+import { OnchainBalanceResponse, SupportedAssetsResponse } from "@stridge/sdk";

package/dist/flows/deposit/driver/transformers/balanceToBalancesPayload.js

@@ -1 +1 @@
-import{parseDecimalSafe as e}from"../../../shared/transformers/parseSmallestUnit.js";import{formatTokenAmount as t}from"../../../../shared/format/formatTokenAmount.js";import{formatUsd as n}from"../../../../shared/format/formatUsd.js";function r(e){let t=new Set,n=new Set;for(let r of e.assets){let e=String(r.eip155_id);t.add(e);for(let t of r.assets)t.address&&n.add(`${e}:${t.address.toLowerCase()}`)}return{nativeChains:t,tokens:n}}function i(e,t){let n=t.routable!==void 0&&(t.routable.nativeChains.size>0||t.routable.tokens.size>0),r=[];for(let i of e.chains)for(let e of i.tokens)e.is_spam||n&&t.routable&&!o(i.eip155_id,e,t.routable)||r.push(a(i.label,i.eip155_id,i.stridge_network_id,e,t));return r.sort(s),r}function a(r,i,a,o,s){let c=e(o.amount),l=e(o.amount_usd),u=e(o.usd_price),d=s.resolveTokenIcon?.({chainId:i,tokenAddress:o.token_address,symbol:o.symbol,isNative:o.is_native})??s.logos?.(i,o.token_address,o.is_native)??o.logo??void 0,f=s.minDepositUsd!==void 0&&s.minDepositUsd>0&&l<s.minDepositUsd;return{networkId:a,networkName:r,eip155Id:String(i),symbol:o.symbol,decimals:o.decimals,address:o.token_address||`0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee`,isNative:o.is_native,...d?{assetLogoUrl:d}:{},amount:{value:c,formatted:t(c,s.i18n,{compact:!0})},...l>0?{amountUsd:{value:l,formatted:n(l,s.i18n)}}:{},...u>0?{priceUsd:u}:{},...f?{lowBalance:!0,disabled:!0}:{}}}function o(e,t,n){let r=String(e);return t.is_native?n.nativeChains.has(r):t.token_address?n.tokens.has(`${r}:${t.token_address.toLowerCase()}`):!1}function s(e,t){return(t.amountUsd?.value??0)-(e.amountUsd?.value??0)}export{i as balanceToBalancesPayload,r as buildRoutableAllowlist};
+import{parseDecimalSafe as e}from"../../../shared/transformers/parseSmallestUnit.js";import{formatTokenAmount as t}from"../../../../shared/format/formatTokenAmount.js";import{formatUsd as n}from"../../../../shared/format/formatUsd.js";function r(e){let t=new Set,n=new Set;for(let r of e.assets){let e=String(r.eip155_id);t.add(e);for(let t of r.assets)t.address&&n.add(`${e}:${t.address.toLowerCase()}`)}return{nativeChains:t,tokens:n}}function i(e,t){let n=t.routable!==void 0&&(t.routable.nativeChains.size>0||t.routable.tokens.size>0),r=[];for(let i of e.chains)for(let e of i.tokens)e.is_spam||n&&t.routable&&!o(i.eip155_id,e,t.routable)||r.push(a(i.label,i.eip155_id,i.stridge_network_id,e,t));return r.sort(s),r}function a(r,i,a,o,s){let c=e(o.amount),l=e(o.amount_usd),u=e(o.usd_price),d=s.resolveTokenIcon?.({chainId:i,tokenAddress:o.token_address,symbol:o.symbol,isNative:o.is_native})??s.logos?.(i,o.token_address,o.is_native)??o.logo??void 0,f=s.minAmountUsd!==void 0&&s.minAmountUsd>0&&l<s.minAmountUsd;return{networkId:a,networkName:r,eip155Id:String(i),symbol:o.symbol,decimals:o.decimals,address:o.token_address||`0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee`,isNative:o.is_native,...d?{assetLogoUrl:d}:{},amount:{value:c,formatted:t(c,s.i18n,{compact:!0})},...l>0?{amountUsd:{value:l,formatted:n(l,s.i18n)}}:{},...u>0?{priceUsd:u}:{},...f?{lowBalance:!0,disabled:!0}:{}}}function o(e,t,n){let r=String(e);return t.is_native?n.nativeChains.has(r):t.token_address?n.tokens.has(`${r}:${t.token_address.toLowerCase()}`):!1}function s(e,t){return(t.amountUsd?.value??0)-(e.amountUsd?.value??0)}export{i as balanceToBalancesPayload,r as buildRoutableAllowlist};

package/dist/flows/deposit/driver/transformers/index.d.ts

@@ -0,0 +1 @@
+import { SettlementPayloadContext } from "./settlementToPayload.js";

package/dist/flows/deposit/driver/transformers/quoteToPayload.d.ts

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

package/dist/flows/deposit/driver/transformers/settlementToPayload.d.ts

@@ -0,0 +1,25 @@
+import { I18n } from "@lingui/core";
+import { GatewaySettlementDto, GatewayUdaDto } from "@stridge/sdk";
+
+//#region src/flows/deposit/driver/transformers/settlementToPayload.d.ts
+/**
+ * Inputs the {@link settlementToPayload} transformer needs from the driver. The driver carries
+ * connected-wallet metadata and explorer info; the transformer composes the per-leg URLs and
+ * shortened address forms that the widget renders.
+ */
+interface SettlementPayloadContext {
+  /** Lingui i18n instance — drives every formatter call. */
+  i18n: I18n;
+  /** Connected wallet's source-side metadata — name + address (full hex). */
+  sourceWallet: {
+    name?: string;
+    address: string;
+    explorerUrl?: string;
+  };
+  /** Per-EIP-155 block-explorer base URLs (e.g. `{ 1: "https://etherscan.io" }`). */
+  explorers?: Record<number, string>;
+  /** Optional brand label rendered in place of the destination address (`gateway/start.metadata.brand_name`). */
+  brandName?: string;
+}
+//#endregion
+export { SettlementPayloadContext };

package/dist/flows/deposit/driver/transformers/settlementToPayload.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"../../../shared/transformers/pickRelevantSettlement.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=i(r?.confirmed_at)??i(e.created_at),l=i(r?.confirmed_at)??i(e.created_at)??Date.now(),u=m(e.to,t.destination.asset_decimals);return{kind:`pending`,sourceWallet:p(n),creditedAsset:{symbol:t.destination.asset_symbol,decimals:t.destination.asset_decimals,address:t.destination.asset_address??``,isNative:!t.destination.asset_address},creditedTo:n.brandName??t.destination.address,...r?.tx_id?{txHash:{value:r.tx_id,formatted:c(r.tx_id)},...h(r,n,r.tx_id)?{txExplorerUrl:h(r,n,r.tx_id)}:{}}:{},...a===void 0?{}:{detectedAt:{value:a,formatted:o(a,n.i18n)}},submittedAt:{value:l,formatted:o(l,n.i18n)},receiveAmount:{value:u,formatted:s(u,n.i18n,{maxDecimals:t.destination.asset_decimals})}}}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),_=m(l,t.destination.asset_decimals),v=t.destination.address;return{kind:`succeeded`,sourceWallet:p(n),destination:{...n.brandName?{name:n.brandName}:{},address:{value:v,formatted:c(v)}},creditedAsset:{symbol:t.destination.asset_symbol,decimals:t.destination.asset_decimals,address:t.destination.asset_address??``,isNative:!t.destination.asset_address},receiveAmount:{value:_,formatted:s(_,n.i18n,{maxDecimals:t.destination.asset_decimals})},routeHops:g(e),totalTime:{value:f,formatted:a(f,n.i18n)},...r?.tx_id?{depositTx:{hash:{value:r.tx_id,formatted:c(r.tx_id)},...h(r,n,r.tx_id)?{explorerUrl:h(r,n,r.tx_id)}:{}}}:{depositTx:{hash:{value:``,formatted:``}}},...l?.tx_id?{completionTx:{hash:{value:l.tx_id,formatted:c(l.tx_id)},...h(l,n,l.tx_id)?{explorerUrl:h(l,n,l.tx_id)}:{}}}:{},submittedAt:{value:u,formatted:o(u,n.i18n)},filledAt:{value:d,formatted:o(d,n.i18n)}}}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=a?.tx_id??``,f=n.destination.address;return{kind:`failed`,failureKind:e(t.error),sourceWallet:p(r),destination:{...r.brandName?{name:r.brandName}:{},address:{value:f,formatted:c(f)}},creditedAsset:{symbol:n.destination.asset_symbol,decimals:n.destination.asset_decimals,address:n.destination.asset_address??``,isNative:!n.destination.asset_address},receiveAmount:{value:0,formatted:s(0,r.i18n)},txHash:{value:d,formatted:d?c(d):``},...h(a,r,d)?{txExplorerUrl:h(a,r,d)}:{},submittedAt:{value:l,formatted:o(l,r.i18n)},failedAt:{value:u,formatted:o(u,r.i18n)}}}function p(e){return{...e.sourceWallet.name?{name:e.sourceWallet.name}:{},address:{value:e.sourceWallet.address,formatted:c(e.sourceWallet.address)},...e.sourceWallet.explorerUrl?{explorerUrl:e.sourceWallet.explorerUrl}:{}}}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(!e||!n)return;let r=e.eip155_id===void 0?void 0:Number(e.eip155_id);if(r===void 0||!t.explorers)return;let i=t.explorers[r];if(i)return`${i.replace(/\/+$/,``)}/tx/${n}`}function g(e){let t=e.from,n=e.to,r=e.route?.provider??``,i=[];return t?.eip155_id!==void 0&&i.push({provider:r,chainId:Number(t.eip155_id)}),n?.eip155_id!==void 0&&n.eip155_id!==t?.eip155_id&&i.push({provider:r,chainId:Number(n.eip155_id)}),i}export{l as settlementToPayload};
+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"../../../shared/transformers/pickRelevantSettlement.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=i(r?.confirmed_at)??i(e.created_at),l=i(r?.confirmed_at)??i(e.created_at)??Date.now(),u=m(e.to,t.destination.asset_decimals);return{kind:`pending`,sourceWallet:p(n),creditedAsset:{symbol:t.destination.asset_symbol,decimals:t.destination.asset_decimals,address:t.destination.asset_address??``,isNative:!t.destination.asset_address},creditedTo:n.brandName??c(t.destination.address),...r?.tx_id?{txHash:{value:r.tx_id,formatted:c(r.tx_id)},...h(r,n,r.tx_id)?{txExplorerUrl:h(r,n,r.tx_id)}:{}}:{},...a===void 0?{}:{detectedAt:{value:a,formatted:o(a,n.i18n)}},submittedAt:{value:l,formatted:o(l,n.i18n)},receiveAmount:{value:u,formatted:s(u,n.i18n,{maxDecimals:t.destination.asset_decimals})}}}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),_=m(l,t.destination.asset_decimals),v=t.destination.address;return{kind:`succeeded`,sourceWallet:p(n),destination:{...n.brandName?{name:n.brandName}:{},address:{value:v,formatted:c(v)}},creditedAsset:{symbol:t.destination.asset_symbol,decimals:t.destination.asset_decimals,address:t.destination.asset_address??``,isNative:!t.destination.asset_address},receiveAmount:{value:_,formatted:s(_,n.i18n,{maxDecimals:t.destination.asset_decimals})},routeHops:g(e),totalTime:{value:f,formatted:a(f,n.i18n)},...r?.tx_id?{depositTx:{hash:{value:r.tx_id,formatted:c(r.tx_id)},...h(r,n,r.tx_id)?{explorerUrl:h(r,n,r.tx_id)}:{}}}:{depositTx:{hash:{value:``,formatted:``}}},...l?.tx_id?{completionTx:{hash:{value:l.tx_id,formatted:c(l.tx_id)},...h(l,n,l.tx_id)?{explorerUrl:h(l,n,l.tx_id)}:{}}}:{},submittedAt:{value:u,formatted:o(u,n.i18n)},filledAt:{value:d,formatted:o(d,n.i18n)}}}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=a?.tx_id??``,f=n.destination.address;return{kind:`failed`,failureKind:e(t.error),sourceWallet:p(r),destination:{...r.brandName?{name:r.brandName}:{},address:{value:f,formatted:c(f)}},creditedAsset:{symbol:n.destination.asset_symbol,decimals:n.destination.asset_decimals,address:n.destination.asset_address??``,isNative:!n.destination.asset_address},receiveAmount:{value:0,formatted:s(0,r.i18n)},txHash:{value:d,formatted:d?c(d):``},...h(a,r,d)?{txExplorerUrl:h(a,r,d)}:{},submittedAt:{value:l,formatted:o(l,r.i18n)},failedAt:{value:u,formatted:o(u,r.i18n)}}}function p(e){return{...e.sourceWallet.name?{name:e.sourceWallet.name}:{},address:{value:e.sourceWallet.address,formatted:c(e.sourceWallet.address)},...e.sourceWallet.explorerUrl?{explorerUrl:e.sourceWallet.explorerUrl}:{}}}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(!e||!n)return;let r=e.eip155_id===void 0?void 0:Number(e.eip155_id);if(r===void 0||!t.explorers)return;let i=t.explorers[r];if(i)return`${i.replace(/\/+$/,``)}/tx/${n}`}function g(e){let t=e.from,n=e.to,r=e.route?.provider??``,i=[];return t?.eip155_id!==void 0&&i.push({provider:r,chainId:Number(t.eip155_id)}),n?.eip155_id!==void 0&&n.eip155_id!==t?.eip155_id&&i.push({provider:r,chainId:Number(n.eip155_id)}),i}export{l as settlementToPayload};

package/dist/flows/deposit/driver/transformers/startToAddressesPayload.d.ts

@@ -0,0 +1,2 @@
+import { I18n } from "@lingui/core";
+import { DepositAddressDto } from "@stridge/sdk";

package/dist/flows/deposit/driver/transformers/startToAddressesPayload.js

@@ -1 +1 @@
-import{formatNetworkName as e}from"../../../../shared/format/formatNetworkName.js";import{formatUsd as t}from"../../../../shared/format/formatUsd.js";import{shortenAddress as n}from"../../../../shared/format/shortenAddress.js";const r=new Set([11155111,5,80001,80002,84532,421614,11155420,97]);function i(i,o={}){let s=o.includeTestnets??!1;return i.flatMap(i=>{let c=String(i.eip155_id??``),l=Number(c);if(!s&&Number.isFinite(l)&&r.has(l))return[];let u=o.explorers?.[l],d=o.i18n&&c?o.minDepositUsdByEip155Id?.[c]:void 0,f=a(i.accepted_assets,c?o.nativeAssetByEip155Id?.[c]:void 0);return[{networkName:e(i.network_name??``),...c?{eip155Id:c}:{},...o.chainLogos?.[c]?{chainLogoUrl:o.chainLogos[c]}:{},address:{value:i.address,formatted:n(i.address)},...u?{explorerUrl:`${u.replace(/\/+$/,``)}/address/${i.address}`}:{},...d!==void 0&&o.i18n?{minDepositUsd:{value:d,formatted:t(d,o.i18n)}}:{},...f.length>0?{acceptedAssets:f}:{}}]})}function a(e,t){let n=Array.isArray(e)?e.map(o):[];return!t||new Set(n.map(e=>e.symbol.toUpperCase())).has(t.symbol.toUpperCase())?n:[t,...n]}function o(e){let t=e.logo,n=!e.address;return{symbol:e.symbol,address:e.address,decimals:e.decimals,...typeof t==`string`&&t.length>0?{assetLogoUrl:t}:{},isNative:n}}export{i as startToAddressesPayload};
+import{KNOWN_TESTNET_EIP155_IDS as e}from"../../../shared/transformers/testnets.js";import{formatNetworkName as t}from"../../../../shared/format/formatNetworkName.js";import{formatUsd as n}from"../../../../shared/format/formatUsd.js";import{shortenAddress as r}from"../../../../shared/format/shortenAddress.js";function i(i,o={}){let s=o.includeTestnets??!1;return i.flatMap(i=>{let c=String(i.eip155_id??``),l=Number(c);if(!s&&Number.isFinite(l)&&e.has(l))return[];let u=o.explorers?.[l],d=o.i18n&&c?o.minAmountUsdByEip155Id?.[c]:void 0,f=a(i.accepted_assets,c?o.nativeAssetByEip155Id?.[c]:void 0,c?o.priceImpactByEip155Id?.[c]:void 0);return[{networkName:t(i.network_name??``),...c?{eip155Id:c}:{},...o.chainLogos?.[c]?{chainLogoUrl:o.chainLogos[c]}:{},address:{value:i.address,formatted:r(i.address)},...u?{explorerUrl:`${u.replace(/\/+$/,``)}/address/${i.address}`}:{},...d!==void 0&&o.i18n?{minAmountUsd:{value:d,formatted:n(d,o.i18n)}}:{},...f.length>0?{acceptedAssets:f}:{}}]})}function a(e,t,n){let r=Array.isArray(e)?e.map(e=>o(e,n)):[];if(!t)return r;let i=r.findIndex(e=>e.symbol.toUpperCase()===t.symbol.toUpperCase());if(i>=0){let e=r[i];return e&&!e.priceImpact&&t.priceImpact&&(r[i]={...e,priceImpact:t.priceImpact}),r}return[t,...r]}function o(e,t){let n=e.logo,r=!e.address,i=e.address?t?.[e.address.toLowerCase()]:void 0;return{symbol:e.symbol,address:e.address,decimals:e.decimals,...typeof n==`string`&&n.length>0?{assetLogoUrl:n}:{},isNative:r,...i?{priceImpact:i}:{}}}export{i as startToAddressesPayload};

package/dist/flows/deposit/driver/transformers/startToBrandPayload.d.ts

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

package/dist/flows/deposit/driver/transformers/startToTargetPayload.d.ts

@@ -0,0 +1,2 @@
+import { I18n } from "@lingui/core";
+import { SupportedAssetsResponse } from "@stridge/sdk";

package/dist/flows/deposit/driver/transformers/startToTargetPayload.js

@@ -1 +1 @@
-import{formatNetworkName as e}from"../../../../shared/format/formatNetworkName.js";import{formatUsd as t}from"../../../../shared/format/formatUsd.js";function n(n,r){let i=n.assets.find(e=>String(e.network_id)===r.networkId);if(!i)return;let a=i.assets.find(e=>e.symbol.toUpperCase()===r.assetSymbol.toUpperCase());if(!a)return;let o=i.native_currency?.logo;return{networkId:r.networkId,networkName:e(i.network_name),eip155Id:String(i.eip155_id),...o?{chainLogoUrl:o}:{},symbol:a.symbol,decimals:a.decimals,address:a.address??``,isNative:!a.address,...a.logo?{assetLogoUrl:a.logo}:{},...r.minDepositUsd===void 0?{}:{minDepositUsd:{value:r.minDepositUsd,formatted:t(r.minDepositUsd,r.i18n)}}}}export{n as startToTargetPayload};
+import{formatNetworkName as e}from"../../../../shared/format/formatNetworkName.js";import{formatUsd as t}from"../../../../shared/format/formatUsd.js";function n(n,r){let i=n.assets.find(e=>String(e.network_id)===r.networkId);if(!i)return;let a=i.assets.find(e=>e.symbol.toUpperCase()===r.assetSymbol.toUpperCase());if(!a)return;let o=i.native_currency?.logo;return{networkId:r.networkId,networkName:e(i.network_name),eip155Id:String(i.eip155_id),...o?{chainLogoUrl:o}:{},symbol:a.symbol,decimals:a.decimals,address:a.address??``,isNative:!a.address,...a.logo?{assetLogoUrl:a.logo}:{},...r.minAmountUsd===void 0?{}:{minAmountUsd:{value:r.minAmountUsd,formatted:t(r.minAmountUsd,r.i18n)}},...r.maxAmountUsd===void 0?{}:{maxAmountUsd:{value:r.maxAmountUsd,formatted:t(r.maxAmountUsd,r.i18n)}}}}export{n as startToTargetPayload};

package/dist/flows/deposit/driver/transformers/walletAddressToWalletPayload.d.ts

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

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

@@ -1,6 +1,6 @@
 import { Entity, SettlementFailureKind, TxRef } from "../../../shared/driver/types.js";
-import { AcceptedAssetPayload, AddressItemPayload, AssetPayload, BalanceItemPayload, BrandPayload, ChainPayload, QuoteBreakdownPayload, QuotePayload, QuoteRoutePayload, SettlementFailurePayload, SettlementPayload, SettlementPendingPayload, SettlementSuccessPayload, SourceWalletPayload, TargetPayload, WalletInfo, WalletPayload } from "./payloads.js";
-import { DepositAddressDto, GatewayPollResponse, GatewaySettlementDto, GatewayStartResponse, OnchainBalanceResponse, QuoteResponse, SupportedAssetDto, SupportedAssetsResponse } from "@stridge/sdk";
+import { AcceptedAssetPayload, AddressItemPayload, AssetPayload, BalanceItemPayload, BrandPayload, ChainPayload, OnrampMethodCapability, OnrampMethodsPayload, OnrampQuotePayload, OnrampReceiveAssetPayload, OnrampSessionPayload, OnrampSessionStateName, QuoteBreakdownPayload, QuotePayload, QuoteRoutePayload, SettlementFailurePayload, SettlementPayload, SettlementPendingPayload, SettlementSuccessPayload, SourceWalletPayload, TargetPayload, WalletInfo, WalletPayload } from "./payloads.js";
+import { DepositAddressDto, GatewaySettlementDto, GatewayStartResponse, GatewayUdaDto, OnchainBalanceResponse, OnrampQuoteResponse, OnrampSessionResponse, QuoteResponse, SupportedAssetDto, SupportedAssetsResponse } from "@stridge/sdk";
 
 //#region src/flows/deposit/driver/types.d.ts
 /**
@@ -39,7 +39,7 @@ interface DepositSnapshot {
    * the payload (`pending` / `succeeded` / `failed`) drives whether `<ProcessingState>`,
    * `<SuccessState>`, or `<ErrorState>` is shown.
    */
-  settlement: Entity<SettlementPayload, GatewaySettlementDto, GatewayPollResponse>;
+  settlement: Entity<SettlementPayload, GatewaySettlementDto, GatewayUdaDto>;
   /**
    * Connected-wallet identity. `idle` when no wallet is connected; `ready` once the host has
    * supplied an address. The `payload.address.formatted` field is the canonical
@@ -47,6 +47,27 @@ interface DepositSnapshot {
    * settlement (deposit-method tile, amount-entry source pill, banner disconnected-state copy).
    */
   wallet: Entity<WalletPayload, WalletInfo, WalletInfo>;
+  /**
+   * Onramp-rail capability bag — the limit + processing time surfaced on the "Cash"
+   * method row's meta line and read by the onramp amount-entry for its over-limit / unavailable
+   * notices. Optional so BYO drivers shipped before the onramp rail existed keep type-checking
+   * against the contract; readers null-coalesce a missing entity to `idle`, which means "no
+   * onramp backend wired up yet". The live stridge driver leaves this `idle` until the rail is
+   * exercised; the mock driver seeds a fixture today.
+   */
+  onrampMethods?: Entity<OnrampMethodsPayload, OnrampMethodsPayload, OnrampMethodsPayload>;
+  /**
+   * Formatted fiat→crypto onramp quote backing the onramp amount-entry hero / receive chip / fee
+   * rows. Optional (same back-compat rationale as {@link onrampMethods}); `idle` until
+   * {@link DepositDriver.requestOnrampQuote} runs. Backed by the SDK's `OnrampQuoteResponse`.
+   */
+  onrampQuote?: Entity<OnrampQuotePayload, OnrampQuoteResponse, OnrampQuoteResponse>;
+  /**
+   * The active onramp checkout session — carries the provider-hosted `checkoutUrl` and the
+   * session state the kit polls to a terminal verdict. Optional; `idle` until
+   * {@link DepositDriver.createOnrampSession} runs. Backed by the SDK's `OnrampSessionResponse`.
+   */
+  onrampSession?: Entity<OnrampSessionPayload, OnrampSessionResponse, OnrampSessionResponse>;
 }
 /**
  * Input to {@link DepositDriver.requestQuote}.
@@ -80,6 +101,29 @@ interface SubmitDepositInput {
   /** Send amount in display units. */
   amount: number;
 }
+/**
+ * Input to {@link DepositDriver.requestOnrampQuote}. The fiat side is all the backend needs — the
+ * receive crypto is derived from the tenant's deposit preferences. The onramp rail is single-method
+ * (the provider's hosted checkout collects the payment instrument), so there is no method selector.
+ */
+interface RequestOnrampQuoteInput {
+  /** Fiat amount the user wants to spend (display units, e.g. dollars). */
+  amount: number;
+}
+/**
+ * Input to {@link DepositDriver.createOnrampSession}. Binds the priced amount to a provider checkout.
+ */
+interface CreateOnrampSessionInput {
+  /** Fiat amount to charge (display units). */
+  amount: number;
+}
+/**
+ * Input to {@link DepositDriver.watchOnrampSession}. Scopes the poll to a single created session.
+ */
+interface WatchOnrampSessionInput {
+  /** The session id returned by {@link DepositDriver.createOnrampSession}. */
+  sessionId: string;
+}
 /**
  * Input to {@link DepositDriver.watchSourceTx}. Path B — kit waits for an inbound transfer to the
  * deposit address.
@@ -107,7 +151,7 @@ type FetchActiveSettlementInput = Record<string, never>;
 interface SettlementSnapshot {
   payload: SettlementPayload;
   raw: GatewaySettlementDto;
-  response: GatewayPollResponse;
+  response: GatewayUdaDto;
 }
 /**
  * Unified driver contract. A `DepositDriver` is the single host-supplied source of both reactive
@@ -139,6 +183,17 @@ interface DepositDriver {
   getSnapshot(): DepositSnapshot;
   /** Lets you subscribe to entity transitions outside React (analytics, headless integrations). */
   subscribe(listener: () => void): () => void;
+  /**
+   * Idempotent bootstrap trigger. The kit calls this from `useDeposit().open()` and the
+   * headless `usePrefetchDeposit()` hook. First call kicks off any deferred network work
+   * (`gateway/start`, `supportedAssets`, the initial `balance/onchain` fetch); subsequent
+   * calls are no-ops while bootstrap is in flight or completed.
+   *
+   * BYO drivers that bootstrap eagerly can implement this as a no-op — the contract is "after
+   * `arm()` returns, the driver's entities are either already populated or will populate as
+   * soon as the first network round-trips land".
+   */
+  arm(): void;
   /**
    * Fetches a fresh quote for `input` and updates the `quote` entity through its lifecycle
    * (`idle | loading → ready | error`). The optional `signal` cancels in-flight work.
@@ -154,6 +209,19 @@ interface DepositDriver {
    * — when omitted, the asset-picker hides its USD-balance overlay.
    */
   watchBalances?(input: Record<string, never>, listener: (entity: DepositSnapshot["balances"]) => void, signal: AbortSignal): void;
+  /**
+   * Invalidate any cached `balances` and force the driver to fetch fresh on its next tick. The
+   * orchestrator calls this after `submitDeposit` resolves and on every `settlement` kind
+   * transition (`pending` / `succeeded` / `failed`) so the user never advances on stale
+   * source-chain balance numbers — the `balance/onchain` SWR window otherwise hides the
+   * just-sent funds until it elapses.
+   *
+   * Drivers that do not cache balances (no SWR layer, no in-memory snapshot) can omit this; the
+   * kit calls it via optional chaining. When implemented, drivers should both invalidate the
+   * cache stamp and kick off an immediate refetch so `useDepositSnapshot().balances` reflects
+   * post-deposit reality without waiting for the next scheduled watcher tick.
+   */
+  invalidateBalances?(): void;
   /**
    * Path B watcher — observes the deposit address until an inbound source-chain tx is detected,
    * then fires the listener with the {@link TxRef}. Optional — when omitted, the orchestrator
@@ -172,6 +240,25 @@ interface DepositDriver {
    * method picker.
    */
   fetchActiveSettlement?(input: FetchActiveSettlementInput, signal: AbortSignal): Promise<SettlementSnapshot | null>;
+  /**
+   * Onramp rail — fetches a fiat→crypto quote and updates the `onrampQuote` entity through its
+   * lifecycle (`idle | loading → ready | error`). Optional: drivers without an onramp backend
+   * omit it, and the onramp amount-entry falls back to its empty-quote surface. Mirrors
+   * {@link requestQuote} for the fiat side.
+   */
+  requestOnrampQuote?(input: RequestOnrampQuoteInput, signal: AbortSignal): Promise<void>;
+  /**
+   * Onramp rail — binds the priced amount to a provider checkout session, populates the
+   * `onrampSession` entity, and resolves with the created session (carrying `checkoutUrl`). The kit
+   * opens `checkoutUrl` in a new tab, then calls {@link watchOnrampSession} to poll. Optional.
+   */
+  createOnrampSession?(input: CreateOnrampSessionInput, signal: AbortSignal): Promise<OnrampSessionPayload>;
+  /**
+   * Onramp rail — polls a created session until it reaches a terminal state, firing the listener on
+   * every transition (the kit maps `SESSION_COMPLETED` / `SESSION_EXPIRED` / `SESSION_FAILED` onto
+   * its shared success / error screens). Mirrors {@link watchSettlement}. Optional.
+   */
+  watchOnrampSession?(input: WatchOnrampSessionInput, listener: (entity: DepositSnapshot["onrampSession"]) => void, signal: AbortSignal): void;
 }
 //#endregion
-export { DepositDriver, DepositSnapshot, FetchActiveSettlementInput, RequestQuoteInput, SettlementSnapshot, SubmitDepositInput, WatchSettlementInput, WatchSourceTxInput };
+export { CreateOnrampSessionInput, DepositDriver, DepositSnapshot, FetchActiveSettlementInput, RequestOnrampQuoteInput, RequestQuoteInput, SettlementSnapshot, SubmitDepositInput, WatchOnrampSessionInput, WatchSettlementInput, WatchSourceTxInput };