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

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

@@ -1 +1 @@
-"use client";import{useDepositDriverInstance as e}from"../driver/context.js";import{useLingui as t}from"../../../shared/i18n/useLingui.js";import"../../../i18n/index.js";import{toFailure as n}from"../../../shared/orchestrator/toFailure.js";import{useDriverSettlementListener as r}from"../../../shared/orchestrator/useDriverSettlementListener.js";import{useEffectiveState as i}from"../../../shared/orchestrator/useEffectiveState.js";import{isUserRejectionFailure as a}from"../../../shared/orchestrator/userRejection.js";import{useSettlementWatcher as o}from"../../../shared/orchestrator/useSettlementWatcher.js";import"../../../shared/orchestrator/index.js";import{initialState as s,reducer as c}from"./reducer.js";import{resolveAssetById as l}from"./resolveAssetById.js";import{createContext as u,use as d,useCallback as f,useEffect as p,useMemo as m,useReducer as h,useRef as g}from"react";import{jsx as _}from"react/jsx-runtime";const v={id:`ELhVSL`,message:`Failed to submit deposit.`},y={id:`Ej5HL9`,message:`Signature declined. Please try again.`},b=u(null);b.displayName=`GatewayControllerContext`;function x(){let e=d(b);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e}function S(){return x().state}function C(){return x().effectiveState}function w(){return x().actions}function T({children:t}){let n=e(),[r,a]=h(c,s),o=D(r,a,n);O(r,a,n),k(r,a,n);let l=i(r),u=E(r,a,n,o);return _(b,{value:m(()=>({state:r,effectiveState:l,dispatch:a,controller:u,actions:o}),[r,l,u,o]),children:t})}function E(e,t,n,r){let i=g(n);i.current=n;let a=f(e=>{if(!e)return t({type:`OPEN`,input:void 0}),!0;if(e.method===`transfer`)return t({type:`OPEN`,input:{method:`transfer`}}),!0;if(e.method===`wallet`&&e.assetId!==void 0){let n=l(i.current.getSnapshot(),e.assetId);return n?(t({type:`OPEN`,input:{method:`wallet`,asset:n}}),!0):!1}return t({type:`OPEN`,input:{method:`wallet`}}),!0},[t]),o=f(()=>{t({type:`CLOSE`})},[t]);return m(()=>({open:a,close:o,actions:r}),[a,o,r])}function D(e,r,i){let o=g(e);o.current=e;let s=g(i);s.current=i;let c=g(r);c.current=r;let{i18n:l}=t(),u=g(l);u.current=l;let d=f((e,t)=>{let r=s.current,i=new AbortController,o=j(e,t);r.submitDeposit(o,i.signal).then(e=>{i.signal.aborted||c.current({type:`DEPOSIT_SUBMITTED`,tx:e})}).catch(e=>{if(i.signal.aborted)return;let t=n(e,u.current._(v));if(a(t)){c.current({type:`DEPOSIT_SIGNATURE_DECLINED`,notice:u.current._(y)});return}c.current({type:`DEPOSIT_SUBMISSION_FAILED`,failure:t})})},[]),p=f(e=>{c.current({type:`DEPOSIT_METHOD_SELECTED`,method:e})},[]),h=f(e=>{c.current({type:`ASSET_CONFIRMED`,asset:e})},[]),_=f(e=>{o.current.name===`amountEntry`&&c.current({type:`AMOUNT_CONFIRMED`,amount:e})},[]),b=f(()=>{let e=o.current;if(e.name!==`confirmDeposit`)return;let t=e.ctx.phase;if(t.kind===`failed`){c.current({type:`QUOTE_RETRY`});return}if(t.kind!==`ready`)return;let{asset:n,amount:r}=e.ctx;c.current({type:`DEPOSIT_CONFIRMED`}),d(n,r)},[d]),x=f(()=>{c.current({type:`BACK`})},[]),S=f(()=>{c.current({type:`CLOSE`})},[]),C=f(()=>{c.current({type:`SUCCESS_DONE`})},[]),w=f(()=>{c.current({type:`ERROR_TRY_AGAIN`})},[]),T=f((e,t)=>{c.current({type:`RESUME_TO_PROCESSING`,method:e,tx:t})},[]),E=f((e,t)=>{c.current({type:`RESUME_TO_SUCCESS`,method:e,tx:t})},[]),D=f(e=>{c.current({type:`RESUME_TO_ERROR`,...e?{tx:e}:{}})},[]);return m(()=>({selectMethod:p,confirmAsset:h,confirmAmount:_,confirmDeposit:b,back:x,close:S,successDone:C,tryAgain:w,resumeToProcessing:T,resumeToSuccess:E,resumeToError:D}),[p,h,_,b,x,S,C,w,T,E,D])}function O(e,t,r){p(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`loading`&&e.ctx.phase.kind!==`regenerating`)return;let i=new AbortController,a=A(e.ctx.asset,e.ctx.amount);return r.requestQuote(a,i.signal).catch(e=>{i.signal.aborted||t({type:`QUOTE_FAILED`,failure:n(e,`Failed to fetch quote.`)})}),()=>i.abort()},[e.name,e.name===`confirmDeposit`?e.ctx.phase.kind:void 0,e.name===`confirmDeposit`?e.ctx.asset:void 0,e.name===`confirmDeposit`?e.ctx.amount:void 0,r,t]),p(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`ready`)return;let n=e.ctx.phase.quoteExpiresAt,r=Math.max(0,n-Date.now()),i=setTimeout(()=>{t({type:`QUOTE_EXPIRED`})},r);return()=>clearTimeout(i)},[e.name,e.name===`confirmDeposit`&&e.ctx.phase.kind===`ready`?e.ctx.phase.quoteExpiresAt:void 0,t])}function k(e,t,n){o(n,e.name===`processing`?e.ctx.tx:void 0),p(()=>{if(e.name!==`transferCrypto`||!n.watchSourceTx)return;let t=new AbortController,r;return n.watchSourceTx({},e=>{t.signal.aborted||r||(r=new AbortController,n.watchSettlement({tx:e},()=>{},r.signal))},t.signal),()=>{t.abort(),r?.abort()}},[e.name,n]),p(()=>{if(e.name===`closed`||e.name===`transferCrypto`||e.name===`processing`||!n.fetchActiveSettlement)return;let t=new AbortController,r,i,a=!1,o=async()=>{try{let e=await n.fetchActiveSettlement({},t.signal);if(a)return;if(e&&!r&&e.payload.kind===`pending`){let t=e.payload.txHash?.value;t&&(r=new AbortController,n.watchSettlement({tx:{hash:t}},()=>{},r.signal))}}catch{}a||(i=setTimeout(o,5e3))};return o(),()=>{a=!0,t.abort(),r?.abort(),i&&clearTimeout(i)}},[e.name,n]);let i=g(e);i.current=e,r(n,e=>{i.current.name===`processing`&&(e===`succeeded`?t({type:`PROCESSING_SUCCEEDED`}):e===`failed`&&t({type:`PROCESSING_FAILED`}))});let a=g(null);p(()=>{let e=()=>{let e=n.getSnapshot(),r=i.current,o=e.quote;o.status!==a.current&&(a.current=o.status,o.status===`ready`&&r.name===`confirmDeposit`?(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_RESOLVED`,expiresAt:o.payload.expiresAt}):o.status===`error`&&r.name===`confirmDeposit`&&(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_FAILED`,failure:{reason:o.error.message,code:o.error.name}}))},r=n.subscribe(e);return e(),r},[n,t])}function A(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build quote input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceTokenSymbol:e.symbol,sourceIsNative:e.isNative,amount:t,...e.priceUsd===void 0?{}:{sourcePriceUsd:e.priceUsd}}}function j(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build submit input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceIsNative:e.isNative,amount:t}}export{T as GatewayController,x as useControllerContext,w as useDepositActions,C as useDepositEffectiveState,S as useDepositState};
+"use client";import{useOptionalActivityDriverInstance as e}from"../../activity/driver/context.js";import{useLingui as t}from"../../../shared/i18n/useLingui.js";import"../../../i18n/index.js";import{toFailure as n}from"../../../shared/orchestrator/toFailure.js";import{useDriverSettlementListener as r}from"../../../shared/orchestrator/useDriverSettlementListener.js";import{useEffectiveState as i}from"../../../shared/orchestrator/useEffectiveState.js";import{useOnrampSessionWatcher as a}from"../../../shared/orchestrator/useOnrampSessionWatcher.js";import{isUserRejectionFailure as o}from"../../../shared/orchestrator/userRejection.js";import{useSettlementWatcher as s}from"../../../shared/orchestrator/useSettlementWatcher.js";import"../../../shared/orchestrator/index.js";import{useDepositDriverInstance as c}from"../driver/context.js";import{openCheckoutPopup as l}from"../shared/checkoutPopup.js";import{initialState as u,reducer as d}from"./reducer.js";import{resolveAssetById as f}from"./resolveAssetById.js";import{createContext as p,use as m,useCallback as h,useEffect as g,useMemo as _,useReducer as v,useRef as y}from"react";import{jsx as b}from"react/jsx-runtime";const x={id:`ELhVSL`,message:`Failed to submit deposit.`},S={id:`Ej5HL9`,message:`Signature declined. Please try again.`},C={id:`Z0UMar`,message:`Failed to fetch quote.`},w={id:`9d3cBd`,message:`Failed to open the payment window. Please try again.`},T=p(null);T.displayName=`GatewayControllerStateContext`;const E=p(null);E.displayName=`GatewayControllerStableContext`;function D(){let e=m(T),t=m(E);if(!e||!t)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return{...e,...t}}function O(){let e=m(E);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e}function k(){return m(E)}const A=p(void 0);A.displayName=`DepositMethodsConfigContext`;function j(){return m(A)}function M(e){let t=j();return _(()=>t?e.filter(e=>e.value===`onramp`?t.onrampRail?.disabled!==!0:!0):e,[e,t])}function N(){let e=m(T);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e.state}function P(){let e=m(T);if(!e)throw Error(`useDeposit / GatewayController must be used inside <KitProvider deposit={…} />. Mount KitProvider once at the host's app root.`);return e.effectiveState}function F(){return O().actions}function I({methodsConfig:t,children:n}){let r=c(),a=e(),[o,s]=v(d,u),l=R(o,s,r,a);z(o,s,r),B(o,s,r,a);let f=i(o),p=L(o,s,r,l,t);return b(A,{value:t,children:b(E,{value:_(()=>({dispatch:s,controller:p,actions:l}),[s,p,l]),children:b(T,{value:_(()=>({state:o,effectiveState:f}),[o,f]),children:n})})})}function L(e,t,n,r,i){let a=y(n);a.current=n;let o=y(i);o.current=i;let s=h(e=>{if(!e)return a.current.arm(),t({type:`OPEN`,input:void 0}),!0;if(o.current?.[e.method]?.disabled)return!1;if(e.method===`transfer`)return a.current.arm(),t({type:`OPEN`,input:{method:`transfer`}}),!0;if(e.method===`wallet`&&e.assetId!==void 0){let n=f(a.current.getSnapshot(),e.assetId);return a.current.arm(),n?(t({type:`OPEN`,input:{method:`wallet`,asset:n}}),!0):(t({type:`OPEN`,input:{method:`wallet`}}),!0)}return a.current.arm(),t({type:`OPEN`,input:{method:`wallet`}}),!0},[t]),c=h(()=>{t({type:`CLOSE`})},[t]);return _(()=>({open:s,close:c,actions:r}),[s,c,r])}function R(e,r,i,a){let s=y(e);s.current=e;let c=y(i);c.current=i;let l=y(a);l.current=a;let u=y(r);u.current=r;let{i18n:d}=t(),f=y(d);f.current=d;let p=h((e,t)=>{let r=c.current,i=new AbortController,a=H(e,t);r.submitDeposit(a,i.signal).then(e=>{if(!i.signal.aborted){try{r.invalidateBalances?.()}catch{}try{l.current?.invalidateActivity?.()}catch{}u.current({type:`DEPOSIT_SUBMITTED`,tx:e})}}).catch(e=>{if(i.signal.aborted)return;let t=n(e,f.current._(x));if(o(t)){u.current({type:`DEPOSIT_SIGNATURE_DECLINED`,notice:f.current._(S)});return}u.current({type:`DEPOSIT_SUBMISSION_FAILED`,failure:t})})},[]),m=h(e=>{u.current({type:`DEPOSIT_METHOD_SELECTED`,method:e})},[]),g=h(()=>{u.current({type:`ONRAMP_SELECTED`})},[]),v=h(e=>{s.current.name===`onrampAmountEntry`&&u.current({type:`ONRAMP_AMOUNT_CHANGED`,amount:e})},[]),b=h(e=>{u.current({type:`ONRAMP_AMOUNT_CONFIRMED`,amount:e})},[]),C=h(()=>{let e=s.current;if(e.name!==`onrampConfirm`)return;let t=e.ctx.phase;t.kind!==`ready`&&t.kind!==`failed`||u.current({type:`ONRAMP_CONFIRMED`})},[]),w=h(e=>{u.current({type:`ASSET_CONFIRMED`,asset:e})},[]),T=h(e=>{s.current.name===`amountEntry`&&u.current({type:`AMOUNT_CONFIRMED`,amount:e})},[]),E=h(()=>{let e=s.current;if(e.name!==`confirmDeposit`)return;let t=e.ctx.phase;if(t.kind===`failed`){u.current({type:`QUOTE_RETRY`});return}if(t.kind!==`ready`)return;let{asset:n,amount:r}=e.ctx;u.current({type:`DEPOSIT_CONFIRMED`}),p(n,r)},[p]),D=h(()=>{u.current({type:`BACK`})},[]),O=h(()=>{u.current({type:`CLOSE`})},[]),k=h(()=>{u.current({type:`SUCCESS_DONE`})},[]),A=h(()=>{u.current({type:`ERROR_TRY_AGAIN`})},[]),j=h((e,t)=>{u.current({type:`RESUME_TO_PROCESSING`,method:e,tx:t})},[]),M=h((e,t)=>{u.current({type:`RESUME_TO_SUCCESS`,method:e,tx:t})},[]),N=h(e=>{u.current({type:`RESUME_TO_ERROR`,...e?{tx:e}:{}})},[]),P=h(()=>{if(l.current==null){process.env.NODE_ENV!==`production`&&console.warn("[@stridge/kit] useDepositActions().openActivity() was called but no activity driver is mounted. Wrap the host with `<KitProvider activity={…}>` (or `<StridgeProvider>` with any flow enabled) to enable the activity surface.");return}let e=s.current;e.name!==`deposit`&&e.name!==`assetPicker`&&e.name!==`amountEntry`&&e.name!==`transferCrypto`||u.current({type:`OPEN_ACTIVITY`})},[]),F=h(e=>{u.current({type:`SELECT_SETTLEMENT`,settlementId:e})},[]);return _(()=>({selectMethod:m,selectOnramp:g,setOnrampAmount:v,confirmOnrampAmount:b,confirmOnramp:C,confirmAsset:w,confirmAmount:T,confirmDeposit:E,back:D,close:O,successDone:k,tryAgain:A,resumeToProcessing:j,resumeToSuccess:M,resumeToError:N,openActivity:P,selectSettlement:F}),[m,g,v,b,C,w,T,E,D,O,k,A,j,M,N,P,F])}function z(e,r,i){let{i18n:a}=t(),o=y(a);o.current=a;let s=e.name===`onrampAmountEntry`?e.ctx.amount:void 0;g(()=>{if(e.name!==`onrampAmountEntry`||!i.requestOnrampQuote)return;let t=s;if(t==null||!Number.isFinite(t)||t<=0)return;let n=new AbortController,r=setTimeout(()=>{i.requestOnrampQuote?.({amount:t},n.signal).catch(()=>{})},400);return()=>{clearTimeout(r),n.abort()}},[e.name,s,i]);let c=e.name===`onrampConfirm`&&e.ctx.phase.kind===`loading`,u=e.name===`onrampConfirm`?e.ctx.amount:void 0;g(()=>{if(!c||!i.requestOnrampQuote||u==null)return;let e=new AbortController;return i.requestOnrampQuote({amount:u},e.signal).catch(t=>{e.signal.aborted||r({type:`ONRAMP_QUOTE_FAILED`,failure:n(t,o.current._(C))})}),()=>e.abort()},[c,u,i,r]);let d=e.name===`onrampConfirm`&&e.ctx.phase.kind===`creating`,f=e.name===`onrampConfirm`?e.ctx.amount:void 0;g(()=>{if(!d||f==null)return;if(!i.createOnrampSession){r({type:`ONRAMP_SESSION_FAILED`,failure:{reason:o.current._(w)}});return}let e=new AbortController;return i.createOnrampSession({amount:f},e.signal).then(t=>{if(!e.signal.aborted){if(!t.checkoutUrl){r({type:`ONRAMP_SESSION_FAILED`,failure:{reason:o.current._(w)}});return}l(t.checkoutUrl),r({type:`ONRAMP_SESSION_CREATED`,sessionId:t.sessionId,checkoutUrl:t.checkoutUrl})}}).catch(t=>{e.signal.aborted||r({type:`ONRAMP_SESSION_FAILED`,failure:n(t,o.current._(w))})}),()=>e.abort()},[d,f,i,r]),g(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`loading`&&e.ctx.phase.kind!==`regenerating`)return;let t=new AbortController,a=V(e.ctx.asset,e.ctx.amount);return i.requestQuote(a,t.signal).catch(e=>{t.signal.aborted||r({type:`QUOTE_FAILED`,failure:n(e,`Failed to fetch quote.`)})}),()=>t.abort()},[e.name,e.name===`confirmDeposit`?e.ctx.phase.kind:void 0,e.name===`confirmDeposit`?e.ctx.asset:void 0,e.name===`confirmDeposit`?e.ctx.amount:void 0,i,r]),g(()=>{if(e.name!==`confirmDeposit`||e.ctx.phase.kind!==`ready`)return;let t=e.ctx.phase.quoteExpiresAt,n=Math.max(0,t-Date.now()),i=setTimeout(()=>{r({type:`QUOTE_EXPIRED`})},n);return()=>clearTimeout(i)},[e.name,e.name===`confirmDeposit`&&e.ctx.phase.kind===`ready`?e.ctx.phase.quoteExpiresAt:void 0,r])}function B(e,t,n,i){let o=y(i);o.current=i;let c=e.name===`processing`?e.ctx.tx:void 0;s(n,c?{tx:c}:void 0,c?.hash);let l=e.name===`onrampPaymentPending`?e.ctx.sessionId:void 0;a(n,l?{sessionId:l}:void 0,l),g(()=>{if(e.name!==`transferCrypto`||!n.watchSourceTx)return;let t=new AbortController,r;return n.watchSourceTx({},e=>{if(!t.signal.aborted&&!r){r=new AbortController,n.watchSettlement({tx:e},()=>{},r.signal);try{o.current?.invalidateActivity?.()}catch{}}},t.signal),()=>{t.abort(),r?.abort()}},[e.name,n]);let u=e.name===`activityList`||e.name===`activityDetail`;g(()=>{if(!u||!i)return;let e=new AbortController;return i.watchActivity(e.signal),()=>e.abort()},[u,i]),g(()=>{if(e.name===`closed`||e.name===`transferCrypto`||e.name===`processing`||u||!n.fetchActiveSettlement)return;let t=new AbortController,r,i,a=!1,o=async()=>{try{let e=await n.fetchActiveSettlement({},t.signal);if(a)return;if(e&&!r&&e.payload.kind===`pending`){let t=e.payload.txHash?.value;t&&(r=new AbortController,n.watchSettlement({tx:{hash:t}},()=>{},r.signal))}}catch{}a||(i=setTimeout(o,5e3))};return o(),()=>{a=!0,t.abort(),r?.abort(),i&&clearTimeout(i)}},[e.name,u,n]);let d=y(e);d.current=e,r(n,e=>{if(e===`pending`||e===`succeeded`||e===`failed`)try{n.invalidateBalances?.()}catch{}d.current.name===`processing`&&(e===`succeeded`?t({type:`PROCESSING_SUCCEEDED`}):e===`failed`&&t({type:`PROCESSING_FAILED`}))});let f=y(null);g(()=>{let e=()=>{let e=n.getSnapshot(),r=d.current,i=e.quote;i.status!==f.current&&(f.current=i.status,i.status===`ready`&&r.name===`confirmDeposit`?(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_RESOLVED`,expiresAt:i.payload.expiresAt}):i.status===`error`&&r.name===`confirmDeposit`&&(r.ctx.phase.kind===`loading`||r.ctx.phase.kind===`regenerating`)&&t({type:`QUOTE_FAILED`,failure:{reason:i.error.message,code:i.error.name,cause:i.error}}))},r=n.subscribe(e);return e(),r},[n,t]);let p=y(null);g(()=>{let e=()=>{let e=n.getSnapshot(),r=d.current,i=e.onrampQuote,a=i?.status??`idle`;a!==p.current&&(p.current=a,!(r.name!==`onrampConfirm`||r.ctx.phase.kind!==`loading`)&&(a===`ready`||a===`stale`?t({type:`ONRAMP_QUOTE_RESOLVED`}):a===`error`&&i?.status===`error`&&t({type:`ONRAMP_QUOTE_FAILED`,failure:{reason:i.error.message,code:i.error.name,cause:i.error}})))},r=n.subscribe(e);return e(),r},[n,t]);let m=y(null);g(()=>{let e=()=>{let e=n.getSnapshot(),r=d.current,i=e.onrampSession,a=i?.status===`ready`||i?.status===`stale`?i.payload.state:i?.status??`idle`;if(a!==m.current&&(m.current=a,r.name===`onrampPaymentPending`)){if(a===`SESSION_COMPLETED`)t({type:`ONRAMP_SESSION_COMPLETED`});else if(a===`SESSION_EXPIRED`)t({type:`ONRAMP_SESSION_EXPIRED`});else if(a===`SESSION_FAILED`){let e=i?.status===`ready`||i?.status===`stale`?i.payload.failureCode:void 0;t({type:`ONRAMP_SESSION_FAILED`,failure:{reason:e??`Payment failed.`,...e?{code:e}:{}}})}}},r=n.subscribe(e);return e(),r},[n,t])}function V(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build quote input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceTokenSymbol:e.symbol,sourceIsNative:e.isNative,amount:t,...e.priceUsd===void 0?{}:{sourcePriceUsd:e.priceUsd}}}function H(e,t){let n=e.eip155Id;if(!n)throw Error(`Asset ${e.symbol} is missing eip155Id; cannot build submit input.`);return{sourceChainId:Number(n),sourceTokenAddress:e.address,sourceTokenDecimals:e.decimals,sourceIsNative:e.isNative,amount:t}}export{I as GatewayController,D as useControllerContext,F as useDepositActions,P as useDepositEffectiveState,j as useDepositMethodsConfig,N as useDepositState,M as useEnabledRails,k as useOptionalStableControllerContext,O as useStableControllerContext};

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

@@ -0,0 +1,5 @@
+import { FailureInfo } from "../../../shared/orchestrator/types.js";
+import { ConfirmDepositPhase, DepositActions, DepositController, DepositMethod, DepositMethodConfig, DepositMethodsConfig, DepositRailConfig, DepositState, DepositStateName, GatewayEvent, OnrampConfirmPhase, OpenInput, ResolvedOpenInput, RetryTargetSpec } from "./types.js";
+import { useDepositState } from "./controller.js";
+import { STEPS_WITH_OWN_SETTLEMENT_VIEW, stepRendersSettlement } from "./steps.js";
+import { useDeposit } from "./useDeposit.js";

package/dist/flows/deposit/orchestrator/reducer.d.ts

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

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

@@ -1 +1 @@
-const e={name:`closed`};function t(e,t){if(t.type===`RESUME_TO_PROCESSING`)return e.name===`closed`?e:{name:`processing`,ctx:{method:t.method,tx:t.tx,retryTargetForFailure:{kind:`fresh`}}};if(t.type===`RESUME_TO_SUCCESS`)return e.name===`closed`?e:{name:`success`,ctx:{method:t.method,tx:t.tx}};if(t.type===`RESUME_TO_ERROR`)return e.name===`closed`?e:{name:`error`,ctx:{retryTarget:{kind:`fresh`},...t.tx?{tx:t.tx}:{}}};switch(e.name){case`closed`:return n(t);case`deposit`:return r(e,t);case`assetPicker`:return i(e,t);case`amountEntry`:return a(e,t);case`confirmDeposit`:return o(e,t);case`transferCrypto`:return s(e,t);case`processing`:return c(e,t);case`success`:return l(e,t);case`error`:return u(e,t);default:return f(e)}}function n(e){if(e.type!==`OPEN`)return{name:`closed`};let t=e.input;return t?t.method===`transfer`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`closed`}}:t.asset?{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`closed`}}:{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`closed`}}:{name:`deposit`,ctx:{backTarget:`closed`}}}function r(e,t){switch(t.type){case`DEPOSIT_METHOD_SELECTED`:return t.method===`wallet`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`deposit`}};case`BACK`:case`CLOSE`:return{name:`closed`};default:return e}}function i(e,t){switch(t.type){case`ASSET_CONFIRMED`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`assetPicker`}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function a(e,t){switch(t.type){case`AMOUNT_CONFIRMED`:return{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.ctx.asset,amount:t.amount,phase:{kind:`loading`},backTarget:`amountEntry`}};case`BACK`:return e.ctx.backTarget===`assetPicker`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function o(e,t){let n=e.ctx.phase;switch(t.type){case`QUOTE_RESOLVED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`ready`,quoteExpiresAt:t.expiresAt}}}:e;case`QUOTE_FAILED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`quote`}}}:e;case`QUOTE_RETRY`:return n.kind===`failed`?{...e,ctx:{...e.ctx,phase:{kind:`loading`}}}:e;case`QUOTE_EXPIRED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`}}}:e;case`DEPOSIT_CONFIRMED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`submitting`}}}:e;case`DEPOSIT_SUBMITTED`:if(n.kind===`submitting`){let n={kind:`confirmDepositReady`,method:`wallet`,asset:e.ctx.asset,amount:e.ctx.amount};return{name:`processing`,ctx:{method:`wallet`,tx:t.tx,retryTargetForFailure:n}}}return e;case`DEPOSIT_SUBMISSION_FAILED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`submission`}}}:e;case`DEPOSIT_SIGNATURE_DECLINED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`,...t.notice?{notice:t.notice}:{}}}}:e;case`BACK`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:e.ctx.asset,backTarget:`assetPicker`}};case`CLOSE`:return{name:`closed`};default:return e}}function s(e,t){switch(t.type){case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function c(e,t){switch(t.type){case`PROCESSING_SUCCEEDED`:return{name:`success`,ctx:{method:e.ctx.method,tx:e.ctx.tx}};case`PROCESSING_FAILED`:return{name:`error`,ctx:{retryTarget:e.ctx.retryTargetForFailure,tx:e.ctx.tx}};case`CLOSE`:return{name:`closed`};default:return e}}function l(e,t){return t.type===`SUCCESS_DONE`||t.type===`CLOSE`?{name:`closed`}:e}function u(e,t){return t.type===`ERROR_TRY_AGAIN`?d(e.ctx.retryTarget):t.type===`CLOSE`?{name:`closed`}:e}function d(e){return e.kind===`fresh`?{name:`deposit`,ctx:{backTarget:`closed`}}:e.kind===`transferCrypto`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:e.backTarget}}:{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.asset,amount:e.amount,phase:{kind:`loading`},backTarget:`amountEntry`}}}function f(e){throw Error(`Unhandled state: ${JSON.stringify(e)}`)}export{e as initialState,t as reducer};
+import{createActivityReducers as e}from"../../../shared/orchestrator/createActivityReducers.js";import"../../../shared/orchestrator/index.js";import{assertNever as t}from"../../../shared/utils/assertNever.js";const n={name:`closed`},{reduceFromActivityList:r,reduceFromActivityDetail:i}=e({activityList:e=>({name:`activityList`,ctx:{backTarget:e}}),activityDetail:(e,t,n)=>({name:`activityDetail`,ctx:{settlementId:e,backTarget:t,viaList:n}}),closed:()=>({name:`closed`}),restoreFromBackTarget:e=>v(e)});function a(e,n){if(n.type===`RESUME_TO_PROCESSING`)return e.name===`closed`?e:{name:`processing`,ctx:{method:n.method,tx:n.tx,retryTargetForFailure:{kind:`fresh`}}};if(n.type===`RESUME_TO_SUCCESS`)return e.name===`closed`?e:{name:`success`,ctx:{method:n.method,tx:n.tx}};if(n.type===`RESUME_TO_ERROR`)return e.name===`closed`?e:{name:`error`,ctx:{retryTarget:{kind:`fresh`},...n.tx?{tx:n.tx}:{}}};switch(e.name){case`closed`:return o(n);case`deposit`:return s(e,n);case`assetPicker`:return c(e,n);case`amountEntry`:return l(e,n);case`onrampAmountEntry`:return u(e,n);case`onrampConfirm`:return d(e,n);case`onrampPaymentPending`:return f(e,n);case`confirmDeposit`:return p(e,n);case`transferCrypto`:return m(e,n);case`processing`:return h(e,n);case`success`:return g(e,n);case`error`:return _(e,n);case`activityList`:return r(e,n);case`activityDetail`:return i(e,n);default:return t(e)}}function o(e){if(e.type!==`OPEN`)return{name:`closed`};let t=e.input;return t?t.method===`transfer`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`closed`}}:t.asset?{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`closed`}}:{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`closed`}}:{name:`deposit`,ctx:{backTarget:`closed`}}}function s(e,t){switch(t.type){case`DEPOSIT_METHOD_SELECTED`:return t.method===`wallet`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:`deposit`}};case`ONRAMP_SELECTED`:return{name:`onrampAmountEntry`,ctx:{method:`onramp`,backTarget:`deposit`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`deposit`,backTarget:`closed`}}};case`BACK`:case`CLOSE`:return{name:`closed`};default:return e}}function c(e,t){switch(t.type){case`ASSET_CONFIRMED`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:t.asset,backTarget:`assetPicker`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`assetPicker`,method:`wallet`,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function l(e,t){switch(t.type){case`AMOUNT_CONFIRMED`:return{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.ctx.asset,amount:t.amount,phase:{kind:`loading`},backTarget:`amountEntry`}};case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`amountEntry`,method:`wallet`,asset:e.ctx.asset,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`assetPicker`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:`deposit`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function u(e,t){switch(t.type){case`ONRAMP_AMOUNT_CHANGED`:return t.amount===null?{...e,ctx:{...e.ctx,amount:void 0}}:{...e,ctx:{...e.ctx,amount:t.amount}};case`ONRAMP_AMOUNT_CONFIRMED`:return{name:`onrampConfirm`,ctx:{method:`onramp`,amount:t.amount,phase:{kind:`loading`},backTarget:`onrampAmountEntry`}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function d(e,t){let n=e.ctx.phase;switch(t.type){case`ONRAMP_QUOTE_RESOLVED`:return n.kind===`loading`?{...e,ctx:{...e.ctx,phase:{kind:`ready`}}}:e;case`ONRAMP_QUOTE_FAILED`:return n.kind===`loading`||n.kind===`creating`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure}}}:e;case`ONRAMP_CONFIRMED`:return n.kind===`ready`||n.kind===`failed`?{...e,ctx:{...e.ctx,phase:{kind:`creating`}}}:e;case`ONRAMP_SESSION_CREATED`:return n.kind===`creating`?{name:`onrampPaymentPending`,ctx:{method:`onramp`,amount:e.ctx.amount,sessionId:t.sessionId,checkoutUrl:t.checkoutUrl,backTarget:`onrampConfirm`}}:e;case`ONRAMP_SESSION_FAILED`:return n.kind===`creating`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure}}}:e;case`BACK`:return{name:`onrampAmountEntry`,ctx:{method:`onramp`,backTarget:`deposit`,amount:e.ctx.amount}};case`CLOSE`:return{name:`closed`};default:return e}}function f(e,t){switch(t.type){case`ONRAMP_SESSION_COMPLETED`:return{name:`success`,ctx:{method:`onramp`,sessionId:e.ctx.sessionId}};case`ONRAMP_SESSION_EXPIRED`:return{name:`error`,ctx:{retryTarget:{kind:`onrampAmountEntry`},sessionId:e.ctx.sessionId,...t.failure?{failure:t.failure}:{}}};case`ONRAMP_SESSION_FAILED`:return{name:`error`,ctx:{retryTarget:{kind:`onrampAmountEntry`},sessionId:e.ctx.sessionId,failure:t.failure}};case`BACK`:return{name:`onrampConfirm`,ctx:{method:`onramp`,amount:e.ctx.amount,phase:{kind:`ready`},backTarget:`onrampAmountEntry`}};case`CLOSE`:return{name:`closed`};default:return e}}function p(e,t){let n=e.ctx.phase;switch(t.type){case`QUOTE_RESOLVED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`ready`,quoteExpiresAt:t.expiresAt}}}:e;case`QUOTE_FAILED`:return n.kind===`loading`||n.kind===`regenerating`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`quote`}}}:e;case`QUOTE_RETRY`:return n.kind===`failed`?{...e,ctx:{...e.ctx,phase:{kind:`loading`}}}:e;case`QUOTE_EXPIRED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`}}}:e;case`DEPOSIT_CONFIRMED`:return n.kind===`ready`?{...e,ctx:{...e.ctx,phase:{kind:`submitting`}}}:e;case`DEPOSIT_SUBMITTED`:if(n.kind===`submitting`){let n={kind:`confirmDepositReady`,method:`wallet`,asset:e.ctx.asset,amount:e.ctx.amount};return{name:`processing`,ctx:{method:`wallet`,tx:t.tx,retryTargetForFailure:n}}}return e;case`DEPOSIT_SUBMISSION_FAILED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`failed`,failure:t.failure,recoverFrom:`submission`}}}:e;case`DEPOSIT_SIGNATURE_DECLINED`:return n.kind===`submitting`?{...e,ctx:{...e.ctx,phase:{kind:`regenerating`,...t.notice?{notice:t.notice}:{}}}}:e;case`BACK`:return{name:`amountEntry`,ctx:{method:`wallet`,asset:e.ctx.asset,backTarget:`assetPicker`}};case`CLOSE`:return{name:`closed`};default:return e}}function m(e,t){switch(t.type){case`OPEN_ACTIVITY`:return{name:`activityList`,ctx:{backTarget:{kind:`transferCrypto`,method:`transfer`,backTarget:e.ctx.backTarget}}};case`BACK`:return e.ctx.backTarget===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:{name:`closed`};case`CLOSE`:return{name:`closed`};default:return e}}function h(e,t){switch(t.type){case`PROCESSING_SUCCEEDED`:return{name:`success`,ctx:{method:e.ctx.method,tx:e.ctx.tx}};case`PROCESSING_FAILED`:return{name:`error`,ctx:{retryTarget:e.ctx.retryTargetForFailure,tx:e.ctx.tx}};case`CLOSE`:return{name:`closed`};default:return e}}function g(e,t){return t.type===`SUCCESS_DONE`||t.type===`CLOSE`?{name:`closed`}:e}function _(e,t){return t.type===`ERROR_TRY_AGAIN`?y(e.ctx.retryTarget):t.type===`CLOSE`?{name:`closed`}:e}function v(e){return e.kind===`deposit`?{name:`deposit`,ctx:{backTarget:`closed`}}:e.kind===`assetPicker`?{name:`assetPicker`,ctx:{method:`wallet`,backTarget:e.backTarget}}:e.kind===`amountEntry`?{name:`amountEntry`,ctx:{method:`wallet`,asset:e.asset,backTarget:e.backTarget}}:{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:e.backTarget}}}function y(e){return e.kind===`fresh`?{name:`deposit`,ctx:{backTarget:`closed`}}:e.kind===`onrampAmountEntry`?{name:`onrampAmountEntry`,ctx:{method:`onramp`,backTarget:`deposit`}}:e.kind===`transferCrypto`?{name:`transferCrypto`,ctx:{method:`transfer`,backTarget:e.backTarget}}:{name:`confirmDeposit`,ctx:{method:`wallet`,asset:e.asset,amount:e.amount,phase:{kind:`loading`},backTarget:`amountEntry`}}}export{n as initialState,a as reducer};

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

@@ -1,14 +1,70 @@
 import { TxRef } from "../../../shared/driver/types.js";
 import { BalanceItemPayload } from "../driver/payloads.js";
 import { FailureInfo } from "../../../shared/orchestrator/types.js";
-
 //#region src/flows/deposit/orchestrator/types.d.ts
 /**
  * Deposit method picked on the `Deposit` widget. `wallet` enters Path A
  * (asset → amount → confirm → process), `transfer` enters Path B
  * (transfer-crypto → process).
  */
-type DepositMethod = "wallet" | "transfer";
+type DepositMethod = "wallet" | "transfer" | "onramp";
+/**
+ * Host-supplied disable lever for a single payment method on the deposit-method picker. The host
+ * decides eligibility — the kit ships no per-host inference (embedded vs. external wallet,
+ * region, KYC tier, …). When `disabled` is true the tile stays in the picker (preserves
+ * discoverability), renders natively disabled, can't be selected, and shows `disabledHint` as
+ * the inline meta line below the title (also folded into the tile's accessible name so screen
+ * readers convey the reason).
+ */
+interface DepositMethodConfig {
+  /** When true, the method is rendered disabled and can't be selected. */
+  disabled?: boolean;
+  /**
+   * Plain-text reason shown inline as the tile's meta line — replaces the address+balance
+   * reading on the wallet tile and the `"No limit · Instant"` reading on the transfer tile so
+   * the explanation is unmissable and the auto-derived signals (which can read misleadingly,
+   * e.g. an embedded wallet's $0.00) are suppressed. Also folded into the tile's accessible
+   * name so screen readers convey it alongside the title. Ignored when `disabled` is falsy.
+   */
+  disabledHint?: string;
+}
+/**
+ * Per-rail host configuration for the deposit picker. Distinct from
+ * {@link DepositMethodConfig} — a rail toggle removes the rail tab entirely
+ * from the `RailPicker` rather than disabling a single tile, so there is no
+ * `disabledHint` slot (there is no tile to surface the hint on). When only
+ * one rail remains after filtering, the orchestrated widget's default
+ * composition collapses the `RailPicker` chrome and renders the surviving
+ * rail's content directly at the body root.
+ */
+interface DepositRailConfig {
+  /**
+   * Opt-IN gate for the rail. The onramp rail is hidden by default — hosts that want
+   * the "Cash" tab in their picker must set `enabled: true` and have a driver that
+   * surfaces the matching entity (e.g. `onrampMethods`). Crypto-only integrators upgrade
+   * transparently because the default is `enabled !== true`. Set explicitly to `false`
+   * is equivalent to leaving it unset.
+   */
+  enabled?: boolean;
+  /**
+   * Legacy opt-OUT toggle. Kept for back-compatibility with the brief window where the
+   * rail shipped on by default and integrators had to set this to hide it. New code
+   * should prefer {@link DepositRailConfig.enabled}; setting `disabled: true` continues
+   * to hide the rail regardless of `enabled`.
+   */
+  disabled?: boolean;
+}
+/**
+ * Per-method host configuration for the deposit picker. Omitting a method (or the whole object)
+ * keeps default behavior; supply `{ disabled: true, disabledHint: "…" }` to mark an option as
+ * unavailable for the current user. `onrampRail` is a rail-level toggle — see
+ * {@link DepositRailConfig}.
+ */
+interface DepositMethodsConfig {
+  wallet?: DepositMethodConfig;
+  transfer?: DepositMethodConfig;
+  onrampRail?: DepositRailConfig;
+}
 /**
  * Confirm-deposit phase sub-union. Drives the confirm-deposit widget's hero / footer chrome.
  * Phase data is pure navigation; the actual quote payload comes from the driver's `quote` entity.
@@ -28,6 +84,23 @@ type ConfirmDepositPhase = {
   failure: FailureInfo;
   recoverFrom: "quote" | "submission";
 };
+/**
+ * Onramp-confirm phase sub-union. Drives the onramp confirm widget's CTA chrome — `loading` paints
+ * the quote skeleton while `requestOnrampQuote` resolves, `ready` renders the priced summary + the
+ * "Continue to payment" CTA, `creating` shows the spinner while `createOnrampSession` runs and the
+ * checkout tab opens, and `failed` surfaces an inline retry. Phase is pure navigation; the quote
+ * payload comes from the driver's `onrampQuote` entity.
+ */
+type OnrampConfirmPhase = {
+  kind: "loading";
+} | {
+  kind: "ready";
+} | {
+  kind: "creating";
+} | {
+  kind: "failed";
+  failure: FailureInfo;
+};
 /**
  * Where `ERROR_TRY_AGAIN` lands. Encoded once at error-entry time so retry is deterministic.
  */
@@ -39,6 +112,12 @@ type RetryTargetSpec = {
 } | {
   kind: "transferCrypto";
   backTarget: "closed" | "deposit";
+} | {
+  /**
+   * Onramp ("Cash") retry — `ERROR_TRY_AGAIN` routes the user back to
+   * `onrampAmountEntry` so they can re-enter an amount and create a fresh checkout session.
+   */
+  kind: "onrampAmountEntry";
 } | {
   /**
    * No re-runnable target — used when `ERROR_TRY_AGAIN` should route the user back to the
@@ -47,6 +126,33 @@ type RetryTargetSpec = {
    */
   kind: "fresh";
 };
+/**
+ * Where `BACK` lands when the user exits the activity surface. Encoded once at `OPEN_ACTIVITY`
+ * time so the back chevron can restore each pre-commit source state lossless — same precedent
+ * as {@link RetryTargetSpec}, just for the activity-exit path instead of the error-retry path.
+ *
+ * The discriminant `kind` mirrors the source-state name. The remaining fields carry exactly the
+ * ctx slots needed to rebuild that state (method, asset, inner backTarget). Direct-entry into
+ * the per-flow activity is no longer possible — that path migrated to the standalone
+ * `useActivity()` hook — so every reachable backTarget identifies a concrete source step.
+ */
+type ActivityBackTarget = {
+  kind: "deposit";
+  backTarget: "closed";
+} | {
+  kind: "assetPicker";
+  method: "wallet";
+  backTarget: "closed" | "deposit";
+} | {
+  kind: "amountEntry";
+  method: "wallet";
+  asset: BalanceItemPayload;
+  backTarget: "closed" | "assetPicker";
+} | {
+  kind: "transferCrypto";
+  method: "transfer";
+  backTarget: "closed" | "deposit";
+};
 /**
  * State machine state nodes. Per-state discriminated ctx narrows what is available — illegal
  * states (e.g. `confirmDeposit` without an asset) are unrepresentable.
@@ -75,6 +181,35 @@ type DepositState = {
     asset: BalanceItemPayload;
     backTarget: "closed" | "assetPicker";
   };
+} | {
+  name: "onrampAmountEntry";
+  ctx: {
+    method: "onramp";
+    backTarget: "closed" | "deposit";
+    /**
+     * Optional initial amount, restored when the user backs out of `onrampConfirm` so the
+     * fiat band keeps the value they entered before continuing. Absent on first entry
+     * (the widget falls back to the first preset).
+     */
+    amount?: number;
+  };
+} | {
+  name: "onrampConfirm";
+  ctx: {
+    method: "onramp";
+    amount: number;
+    phase: OnrampConfirmPhase;
+    backTarget: "onrampAmountEntry";
+  };
+} | {
+  name: "onrampPaymentPending";
+  ctx: {
+    method: "onramp";
+    amount: number;
+    sessionId: string;
+    checkoutUrl: string;
+    backTarget: "onrampConfirm";
+  };
 } | {
   name: "confirmDeposit";
   ctx: {
@@ -101,7 +236,13 @@ type DepositState = {
   name: "success";
   ctx: {
     method: DepositMethod;
-    tx: TxRef;
+    /**
+     * Source-chain broadcast tx for crypto deposits. Optional because the onramp branch
+     * has no on-chain tx of its own at terminal time — it reads the completed
+     * `onrampSession` entity instead and carries {@link sessionId}.
+     */
+    tx?: TxRef; /** Onramp checkout session id — set only when `method === "onramp"`. */
+    sessionId?: string;
   };
 } | {
   name: "error";
@@ -109,11 +250,38 @@ type DepositState = {
     retryTarget: RetryTargetSpec;
     /**
      * Set for non-settlement failures (quote / submission rejections that escalate via
-     * the orchestrated `error` arm). Settlement failures leave this `undefined` — the
-     * widget renders from the driver's `settlement` entity (`kind: "failed"`) instead.
+     * the orchestrated `error` arm, and onramp session failures). Crypto settlement
+     * failures leave this `undefined` — the widget renders from the driver's `settlement`
+     * entity (`kind: "failed"`) instead.
      */
     failure?: FailureInfo; /** Source-chain tx hash when the error followed a successful broadcast. */
-    tx?: TxRef;
+    tx?: TxRef; /** Onramp checkout session id — set only when the failure came from the onramp rail. */
+    sessionId?: string;
+  };
+} | {
+  /**
+   * Activity list — reachable from any pre-commit state via the header icon.
+   * `backTarget` snapshots the source state at `OPEN_ACTIVITY` time so the back chevron
+   * can restore it lossless.
+   */
+  name: "activityList";
+  ctx: {
+    backTarget: ActivityBackTarget;
+  };
+} | {
+  /**
+   * Activity per-settlement detail — reached from `activityList` via
+   * `SELECT_SETTLEMENT`. Carries the selected row's id, the same `backTarget` so `BACK`
+   * collapses through `activityList` to the original source step, and a `viaList` flag
+   * that disambiguates "reached via the list" from "reached imperatively"; the latter
+   * skips the list interlude on `BACK`. For direct-entry into the activity surface,
+   * see {@link useActivity}.
+   */
+  name: "activityDetail";
+  ctx: {
+    settlementId: string;
+    backTarget: ActivityBackTarget;
+    viaList: boolean;
   };
 };
 type DepositStateName = DepositState["name"];
@@ -142,6 +310,40 @@ type GatewayEvent = {
 } | {
   type: "DEPOSIT_METHOD_SELECTED";
   method: DepositMethod;
+} | {
+  type: "ONRAMP_SELECTED";
+} | {
+  /**
+   * Live fiat amount the user is typing on `onrampAmountEntry`, mirrored into `ctx.amount`
+   * so the controller's debounced quote effect can fetch a fresh `onrampQuote` for the
+   * on-screen breakdown. `null` while the field is empty (no quote fires). Distinct from
+   * {@link GatewayEvent} `ONRAMP_AMOUNT_CONFIRMED`, which commits the amount and advances
+   * the FSM to `onrampConfirm`.
+   */
+  type: "ONRAMP_AMOUNT_CHANGED";
+  amount: number | null;
+} | {
+  type: "ONRAMP_AMOUNT_CONFIRMED";
+  amount: number;
+} | {
+  type: "ONRAMP_QUOTE_RESOLVED";
+} | {
+  type: "ONRAMP_QUOTE_FAILED";
+  failure: FailureInfo;
+} | {
+  type: "ONRAMP_CONFIRMED";
+} | {
+  type: "ONRAMP_SESSION_CREATED";
+  sessionId: string;
+  checkoutUrl: string;
+} | {
+  type: "ONRAMP_SESSION_COMPLETED";
+} | {
+  type: "ONRAMP_SESSION_EXPIRED";
+  failure?: FailureInfo;
+} | {
+  type: "ONRAMP_SESSION_FAILED";
+  failure: FailureInfo;
 } | {
   type: "ASSET_CONFIRMED";
   asset: BalanceItemPayload;
@@ -205,11 +407,30 @@ type GatewayEvent = {
    */
   type: "RESUME_TO_ERROR";
   tx?: TxRef;
+} | {
+  /**
+   * User tapped the header activity icon. Legal from every pre-commit state
+   * (`deposit | assetPicker | amountEntry | transferCrypto`); ignored elsewhere. The
+   * reducer snapshots the source state into a {@link ActivityBackTarget} so the back
+   * chevron can restore it lossless.
+   */
+  type: "OPEN_ACTIVITY";
+} | {
+  /**
+   * User tapped a row in the activity list. Legal only from `activityList`; transitions
+   * to `activityDetail` carrying the selected `settlementId` and the same `backTarget`,
+   * so a later `BACK` from the list step restores the original source state.
+   */
+  type: "SELECT_SETTLEMENT";
+  settlementId: string;
 };
 /**
  * Public open-input variant accepted by `useDeposit().open()`. Hosts pass the small ID-based
- * shape; the controller resolves IDs against the driver's `balances` entity and rejects when the
- * lookup fails.
+ * shape; the controller resolves `assetId` against the driver's `balances` entity before
+ * dispatching. Lookup misses fall through to the asset picker — the host's click never silently
+ * no-ops.
+ *
+ * For direct-entry into the activity surface, see {@link useActivity}.
  */
 type OpenInput = undefined | {
   method: "wallet";
@@ -226,11 +447,14 @@ interface DepositController {
    *
    * - `open()` → `deposit` (method picker)
    * - `open({ method: "wallet" })` → `assetPicker`
-   * - `open({ method: "wallet", assetId })` → `amountEntry` (rejects if `assetId` doesn't resolve)
+   * - `open({ method: "wallet", assetId })` → `amountEntry` when `assetId` resolves, otherwise
+   *   falls through to `assetPicker`
    * - `open({ method: "transfer" })` → `transferCrypto`
    *
-   * Returns `false` when `assetId` is provided but doesn't match any asset on the kit's
-   * `balances` entity.
+   * Returns `false` only when the requested `method` is disabled via
+   * {@link DepositMethodsConfig}.
+   *
+   * For direct-entry into the activity surface, see {@link useActivity}.
    */
   open(input?: OpenInput): boolean;
   /** Close the deposit dialog. Idempotent. */
@@ -248,6 +472,32 @@ interface DepositController {
  */
 interface DepositActions {
   selectMethod(method: DepositMethod): void;
+  /**
+   * Promotes the FSM from `deposit` (method picker) into `onrampAmountEntry`. The onramp rail is
+   * single-method (the hosted-checkout provider collects the payment instrument), so this takes
+   * no argument — selecting "Cash" goes straight to amount entry.
+   */
+  selectOnramp(): void;
+  /**
+   * Mirrors the live fiat amount the user is typing on `onrampAmountEntry` into the FSM's
+   * `ctx.amount`. The controller's debounced quote effect keys off that value to fetch a fresh
+   * `onrampQuote` for the on-screen breakdown — without this sync the amount-entry screen would
+   * never quote (the field's local state is invisible to the controller). Pass `null` when the
+   * field is cleared. No FSM transition; `onrampAmountEntry` stays current.
+   */
+  setOnrampAmount(amount: number | null): void;
+  /**
+   * Promotes the FSM from `onrampAmountEntry` into `onrampConfirm{loading}` carrying the entered
+   * fiat amount. The controller's quote effect resolves the `onrampQuote` entity and the bridge
+   * flips the phase to `ready`.
+   */
+  confirmOnrampAmount(amount: number): void;
+  /**
+   * Flips `onrampConfirm{ready}` → `onrampConfirm{creating}`. The controller's session effect
+   * calls `createOnrampSession`, opens the hosted checkout in a new tab, and dispatches
+   * `ONRAMP_SESSION_CREATED` to advance to `onrampPaymentPending`.
+   */
+  confirmOnramp(): void;
   confirmAsset(asset: BalanceItemPayload): void;
   confirmAmount(amount: number): void;
   confirmDeposit(): void;
@@ -261,6 +511,20 @@ interface DepositActions {
   resumeToSuccess(method: DepositMethod, tx: TxRef): void;
   /** Banner-driven jump into the error widget. */
   resumeToError(tx?: TxRef): void;
+  /**
+   * Header-icon entry into the activity surface. Legal only from the pre-quote states
+   * (`deposit | assetPicker | amountEntry | transferCrypto`); ignored from `confirmDeposit`
+   * onwards and from terminal states. Snapshots the current state into a
+   * {@link ActivityBackTarget} so `back()` can restore it lossless. No-ops with a dev-mode
+   * warning when no activity driver is mounted (host wired the action without
+   * `<KitProvider activity={…}>`).
+   */
+  openActivity(): void;
+  /**
+   * Open the detail view for a settlement listed on the activity surface. Legal only from
+   * `activityList`; transitions the FSM to `activityDetail`.
+   */
+  selectSettlement(settlementId: string): void;
 }
 //#endregion
-export { ConfirmDepositPhase, DepositActions, DepositController, DepositMethod, DepositState, DepositStateName, GatewayEvent, OpenInput, ResolvedOpenInput, RetryTargetSpec };
+export { ConfirmDepositPhase, DepositActions, DepositController, DepositMethod, DepositMethodConfig, DepositMethodsConfig, DepositRailConfig, DepositState, DepositStateName, GatewayEvent, OnrampConfirmPhase, OpenInput, ResolvedOpenInput, RetryTargetSpec };

package/dist/flows/deposit/orchestrator/useDeposit.d.ts

@@ -31,5 +31,49 @@ import { DepositController } from "./types.js";
  * ```
  */
 declare function useDeposit(): DepositController;
+/**
+ * Non-throwing variant of {@link useDeposit} — returns `null` when called outside a
+ * `<KitProvider deposit={…} />`. Lets hosts mount `<StridgeProvider />` conditionally
+ * (e.g. only after a wallet is connected) without descendants crashing the moment they render
+ * before the provider exists.
+ *
+ * @example
+ * ```tsx
+ * const deposit = useOptionalDeposit();
+ * return (
+ *     <button onClick={() => deposit?.open()} disabled={!deposit}>
+ *         Deposit
+ *     </button>
+ * );
+ * ```
+ */
+declare function useOptionalDeposit(): DepositController | null;
+/**
+ * Headless prefetch handle for the deposit driver. Returns a stable function that arms the
+ * driver — kicks off the deferred `gateway/start` + `supportedAssets` + initial `balance/onchain`
+ * bootstrap. Calling it before the user opens the dialog warms the cache so the subsequent
+ * `useDeposit().open()` lands on populated data without a perceptible loading window.
+ *
+ * The function is fire-and-forget: returns `void`. To observe bootstrap state, read
+ * `useDepositSnapshot().target.status` directly — the snapshot is the single source of truth.
+ *
+ * The most common use is hover-to-warm:
+ *
+ * ```tsx
+ * const deposit = useDeposit();
+ * const prefetchDeposit = usePrefetchDeposit();
+ * <button onMouseEnter={prefetchDeposit} onClick={() => deposit.open()}>Deposit</button>;
+ * ```
+ *
+ * Headless balance widgets that need data on render call this in an effect:
+ *
+ * ```tsx
+ * const prefetchDeposit = usePrefetchDeposit();
+ * useEffect(() => { prefetchDeposit(); }, [prefetchDeposit]);
+ * ```
+ *
+ * Idempotent — subsequent calls are no-ops while the driver is already armed.
+ */
+declare function usePrefetchDeposit(): () => void;
 //#endregion
-export { useDeposit };
+export { useDeposit, useOptionalDeposit, usePrefetchDeposit };

package/dist/flows/deposit/orchestrator/useDeposit.js

@@ -1 +1 @@
-"use client";import{useControllerContext as e}from"./controller.js";function t(){return e().controller}export{t as useDeposit};
+"use client";import{useDepositDriverInstance as e}from"../driver/context.js";import{useOptionalStableControllerContext as t,useStableControllerContext as n}from"./controller.js";import{useCallback as r}from"react";function i(){return n().controller}function a(){return t()?.controller??null}function o(){let t=e();return r(()=>{t.arm()},[t])}export{i as useDeposit,a as useOptionalDeposit,o as usePrefetchDeposit};

package/dist/flows/deposit/shared/checkoutPopup.js

@@ -0,0 +1 @@
+function e(e){if(typeof window>`u`)return;let t;try{t=new URL(e,window.location.href)}catch{return}if(t.protocol!==`http:`&&t.protocol!==`https:`)return;let n=window.screenLeft??0,r=window.screenTop??0,i=window.outerWidth||window.innerWidth||460,a=window.outerHeight||window.innerHeight||760,o=Math.max(0,n+(i-460)/2),s=Math.max(0,r+(a-760)/2),c=`popup=yes,width=460,height=760,left=${Math.round(o)},top=${Math.round(s)},noopener,noreferrer`;window.open(e,`_blank`,c)}export{e as openCheckoutPopup};

package/dist/flows/deposit/shared/onramp.js

@@ -0,0 +1 @@
+const e=[{value:200,label:`$200`},{value:500,label:`$500`},{value:1e3,label:`$1k`},{value:2e3,label:`$2k`}];export{e as ONRAMP_AMOUNT_PRESETS};

package/dist/flows/deposit/widgets/activity/DepositActivityDetail.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/activity/DepositActivityDetail.d.ts
+interface DepositActivityDetailOwnProps {
+  /**
+   * Optional custom composition forwarded to the underlying `<ActivityDetail>`
+   * compound. Defaults to mounting all three per-kind parts; each gates internally on the
+   * resolved payload's `kind`.
+   */
+  children?: ReactNode;
+}
+/**
+ * Orchestrated activity detail wrapper for the deposit dialog. Mounts the cross-flow
+ * `<ActivityDetail>` compound and exposes per-kind parts (`Processing`, `Succeeded`,
+ * `Failed`) as namespace members. Renders `null` while the FSM is not on `activityDetail`.
+ */
+declare function DepositActivityDetail({
+  children
+}: DepositActivityDetailOwnProps): _$react_jsx_runtime0.JSX.Element | null;
+declare namespace DepositActivityDetail {
+  type Props = DepositActivityDetailOwnProps;
+  const Processing: ({
+    children
+  }: {
+    children?: ReactNode;
+  }) => _$react_jsx_runtime0.JSX.Element | null;
+  const Succeeded: ({
+    children
+  }: {
+    children?: ReactNode;
+  }) => _$react_jsx_runtime0.JSX.Element | null;
+  const Failed: ({
+    children
+  }: {
+    children?: ReactNode;
+  }) => _$react_jsx_runtime0.JSX.Element | null;
+}
+//#endregion
+export { DepositActivityDetail };

package/dist/flows/deposit/widgets/activity/DepositActivityDetail.js

@@ -0,0 +1 @@
+"use client";import{ActivitySourceProvider as e}from"../../../../shared/widgets/activity/compound/context.js";import{ActivityDetail as t}from"../../../../shared/widgets/activity/compound/ActivityDetail.js";import"../../../../shared/widgets/activity/compound/index.js";import{useDepositActivitySource as n}from"./useDepositActivitySource.js";import{jsx as r}from"react/jsx-runtime";function i({children:i}){let{sourceValue:a,step:o}=n();return o!==`activityDetail`||!a?null:r(e,{value:a,children:r(t,{children:i})})}(function(e){e.Processing=t.Processing,e.Succeeded=t.Succeeded,e.Failed=t.Failed})(i||={});export{i as DepositActivityDetail};

package/dist/flows/deposit/widgets/activity/DepositActivityList.d.ts

@@ -0,0 +1,38 @@
+import { ActivityHeader, ActivityListHeader } from "../../../../shared/widgets/activity/compound/components/ActivityHeader.js";
+import { ActivityEmpty } from "../../../../shared/widgets/activity/compound/components/Empty.js";
+import { ActivityErrorView } from "../../../../shared/widgets/activity/compound/components/ErrorView.js";
+import { ActivityList } from "../../../../shared/widgets/activity/compound/components/List.js";
+import { ActivityRow } from "../../../../shared/widgets/activity/compound/components/Row.js";
+import { ComponentProps, ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/widgets/activity/DepositActivityList.d.ts
+interface DepositActivityListOwnProps {
+  /**
+   * Optional custom composition forwarded to the underlying `<Activity>` compound.
+   * Defaults to the compound's `<Header /> + <List />` shape.
+   */
+  children?: ReactNode;
+}
+/**
+ * Orchestrated activity list wrapper for the deposit dialog. Bridges the deposit
+ * flow's snapshot + actions + FSM state into the cross-flow `<Activity>` compound's
+ * source value. Renders `null` while the FSM is not on `activityList` — the dialog's step
+ * router only matches the active step, but the no-op guard keeps the component safe to mount
+ * in custom dialog compositions that skip the step router.
+ */
+declare function DepositActivityList({
+  children,
+  ...props
+}: ComponentProps<"div"> & DepositActivityListOwnProps): _$react_jsx_runtime0.JSX.Element | null;
+declare namespace DepositActivityList {
+  type Props = ComponentProps<"div"> & DepositActivityListOwnProps;
+  const Header: typeof ActivityHeader;
+  const ListHeader: typeof ActivityListHeader;
+  const List: typeof ActivityList;
+  const Row: typeof ActivityRow;
+  const Empty: typeof ActivityEmpty;
+  const ErrorView: typeof ActivityErrorView;
+}
+//#endregion
+export { DepositActivityList };

package/dist/flows/deposit/widgets/activity/DepositActivityList.js

@@ -0,0 +1 @@
+"use client";import{ActivitySourceProvider as e}from"../../../../shared/widgets/activity/compound/context.js";import{Activity as t}from"../../../../shared/widgets/activity/compound/Activity.js";import"../../../../shared/widgets/activity/compound/index.js";import{useDepositActivitySource as n}from"./useDepositActivitySource.js";import{jsx as r}from"react/jsx-runtime";function i({children:i,...a}){let{sourceValue:o,step:s}=n();return s!==`activityList`||!o?null:r(e,{value:o,children:r(t,{...a,children:i})})}(function(e){e.Header=t.Header,e.ListHeader=t.ListHeader,e.List=t.List,e.Row=t.Row,e.Empty=t.Empty,e.ErrorView=t.ErrorView})(i||={});export{i as DepositActivityList};

package/dist/flows/deposit/widgets/activity/index.d.ts

@@ -0,0 +1,2 @@
+import { DepositActivityDetail } from "./DepositActivityDetail.js";
+import { DepositActivityList } from "./DepositActivityList.js";

package/dist/flows/deposit/widgets/activity/index.js

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

package/dist/flows/deposit/widgets/activity/useDepositActivitySource.js

@@ -0,0 +1 @@
+"use client";import{useOptionalActivityDriverInstance as e,useOptionalActivitySnapshot as t}from"../../../activity/driver/context.js";import{useLingui as n}from"../../../../shared/i18n/useLingui.js";import"../../../../i18n/index.js";import{useDepositSnapshot as r}from"../../driver/context.js";import{useDepositActions as i,useDepositEffectiveState as a}from"../../orchestrator/controller.js";import{defaultBlockExplorers as o}from"../../../../shared/utils/explorers.js";import{useCallback as s,useMemo as c}from"react";function l(){let l=r(),u=i(),d=e(),f=t(),p=a(),{i18n:m}=n(),h=s(e=>{d?.refreshActivity(e)},[d]),g=p.name===`activityList`||p.name===`activityDetail`,_=p.name===`activityDetail`?p.ctx.settlementId:void 0,v=g;return{sourceValue:c(()=>{if(!g||!f)return null;let e=l.wallet,t=f.activity,n=e.status===`ready`||e.status===`stale`?e.payload.address.value:t.status===`ready`||t.status===`stale`?t.response.owner:`0x0000000000000000000000000000000000000000`,r=t.status===`ready`||t.status===`stale`?t.payload.brandName:void 0,i=l.brand,a=i.status===`ready`||i.status===`stale`?i.payload.name:void 0,s=r??a,c={i18n:m,sourceWallet:{name:`Wallet`,address:n},explorers:o(),...s?{brandName:s}:{}};return{entity:f.activity,refresh:h,selectSettlement:u.selectSettlement,...v?{back:u.back}:{},..._===void 0?{}:{settlementId:_},settlementContext:c}},[f,l,u,g,_,m,h,v]),settlementId:_,step:p.name===`activityList`?`activityList`:p.name===`activityDetail`?`activityDetail`:`other`}}export{l as useDepositActivitySource};