@stridge/kit 0.1.0-alpha.0

package/dist/drivers/stridge-mock/fixtures.js

@@ -0,0 +1 @@
+import{formatDurationCompact as e}from"../../shared/format/formatDurationCompact.js";import{formatPercent as t}from"../../shared/format/formatPercent.js";import{formatTimestamp as n}from"../../shared/format/formatTimestamp.js";import{formatTokenAmount as r}from"../../shared/format/formatTokenAmount.js";import{formatUsd as i}from"../../shared/format/formatUsd.js";import{shortenAddress as a}from"../../shared/format/shortenAddress.js";const o=`Stridge ACME`,s=`0xCA8779a5FD7cEAf54211177A2b22dB5E0480685c`,c=`0x1d72b900dd9b4f9fb0e11c14978d9cbbff7b47db0b820911839aad7081f6b72a`,l=`0x268a11a1002eb7026e3a77999872695ee3a920e5c46172a43aa396da10ac5296`,u=`0xcae135e02df387bba14e231988126295a663c8d9f8e90c1ead5876cc2fee036d`,d=1778167499e3,f=1778169184e3,p=1778086787e3,m=1778087105e3,h=`0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d`,g=`https://cdn.stridge.com/assets/usdc.svg`,_=`https://cdn.stridge.com/assets/usdt.svg`,v={1:`https://cdn.stridge.com/networks/60.svg`,8453:`https://cdn.stridge.com/networks/8453.svg`,42161:`https://cdn.stridge.com/networks/9001.svg`},y=`https://cdn.stridge.com/networks/9006.svg`,b=`https://cdn.stridge.com/networks/966.svg`,x=`0x166872371d1EB43B62c25861Bb7B1be4d5f09F56`,S={address:s,chainId:56},C={name:o},w={networkId:`9006`,networkName:`BSC`,eip155IdString:`56`,eip155IdNumber:56,chainLogoUrl:y,explorerBase:`https://bscscan.com`,symbol:`USDC`,decimals:18,address:h,assetLogoUrl:g,isNative:!1,nativeSymbol:`BNB`};function T(e){if(!e)return w;let t=e.chain.toLowerCase(),n=k.find(e=>e.networkName.toLowerCase()===t);if(!n)return w;let r=n.acceptedAssets.find(t=>t.symbol.toUpperCase()===e.symbol.toUpperCase());if(!r)return w;let i=n.acceptedAssets.find(e=>e.isNative);return{networkId:M[n.eip155Id]??n.eip155Id,networkName:n.networkName,eip155IdString:n.eip155Id,eip155IdNumber:Number(n.eip155Id),chainLogoUrl:n.chainLogoUrl,explorerBase:n.explorerBase,symbol:r.symbol,decimals:r.decimals,address:r.address,assetLogoUrl:r.assetLogoUrl??n.chainLogoUrl,isNative:r.isNative,nativeSymbol:i?.symbol??r.symbol}}function E(e=w){return{network_id:e.networkId,network_name:e.networkName,network_symbol:e.networkName.toLowerCase(),eip155_id:e.eip155IdNumber,native_currency:{symbol:e.nativeSymbol,name:e.nativeSymbol,decimals:18,logo:e.chainLogoUrl},assets:[{symbol:e.symbol,decimals:e.decimals,address:e.address,logo:e.assetLogoUrl}]}}const D=E();function O(e,t,n=w){return{networkId:n.networkId,networkName:n.networkName,eip155Id:n.eip155IdString,chainLogoUrl:n.chainLogoUrl,symbol:n.symbol,decimals:n.decimals,address:n.address,assetLogoUrl:n.assetLogoUrl,isNative:n.isNative,...t===void 0?{}:{minDepositUsd:{value:t,formatted:i(t,e)}}}}const k=[{eip155Id:`1`,networkName:`Ethereum`,chainLogoUrl:v[1],explorerBase:`https://etherscan.io`,acceptedAssets:[{symbol:`ETH`,address:``,decimals:18,isNative:!0,assetLogoUrl:v[1]},{symbol:`TUSD`,address:`0x0000000000085d4780B73119b644AE5ecd22b376`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/tusd.svg`},{symbol:`PAXG`,address:`0x45804880De22913dAFE09f4980848ECE6EcbAf78`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/paxg.svg`},{symbol:`DAI`,address:`0x6B175474E89094C44Da98b954EedeAC495271d0F`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/dai.svg`},{symbol:`PYUSD`,address:`0x6c3ea9036406852006290770BEdFcAbA0e23A0e8`,decimals:6,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/pyusd.svg`},{symbol:`USDC`,address:`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`,decimals:6,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/usdc.svg`},{symbol:`WETH`,address:`0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/weth.svg`},{symbol:`USDT`,address:`0xdAC17F958D2ee523a2206206994597C13D831ec7`,decimals:6,isNative:!1,assetLogoUrl:_}]},{eip155Id:`56`,networkName:`BSC`,chainLogoUrl:y,explorerBase:`https://bscscan.com`,acceptedAssets:[{symbol:`BNB`,address:``,decimals:18,isNative:!0,assetLogoUrl:y},{symbol:`WETH`,address:`0x2170Ed0880ac9A755fd29B2688956BD959F933F8`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/weth.svg`},{symbol:`TUSD`,address:`0x40af3827F39D0EAcBF4A168f8D4ee67c121D11c9`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/tusd.svg`},{symbol:`USDT`,address:`0x55d398326f99059fF775485246999027B3197955`,decimals:18,isNative:!1,assetLogoUrl:_},{symbol:`USDC`,address:h,decimals:18,isNative:!1,assetLogoUrl:g}]},{eip155Id:`8453`,networkName:`Base`,chainLogoUrl:v[8453],explorerBase:`https://basescan.org`,acceptedAssets:[{symbol:`ETH`,address:``,decimals:18,isNative:!0,assetLogoUrl:v[8453]},{symbol:`WETH`,address:`0x4200000000000000000000000000000000000006`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/weth.svg`},{symbol:`DAI`,address:`0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/dai.svg`},{symbol:`USDC`,address:`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`,decimals:6,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/usdc.svg`},{symbol:`USDT`,address:`0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2`,decimals:6,isNative:!1,assetLogoUrl:_}]},{eip155Id:`42161`,networkName:`Arbitrum`,chainLogoUrl:v[42161],explorerBase:`https://arbiscan.io`,acceptedAssets:[{symbol:`ETH`,address:``,decimals:18,isNative:!0,assetLogoUrl:v[42161]},{symbol:`TUSD`,address:`0x4D15a3A2286D883AF0AA1B3f21367843FAc63E07`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/tusd.svg`},{symbol:`WETH`,address:`0x82aF49447D8a07e3bd95BD0d56f35241523fBab1`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/weth.svg`},{symbol:`USDC`,address:`0xaf88d065e77c8cC2239327C5EDb3A432268e5831`,decimals:6,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/usdc.svg`},{symbol:`DAI`,address:`0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/dai.svg`},{symbol:`USDT`,address:`0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9`,decimals:6,isNative:!1,assetLogoUrl:_}]},{eip155Id:`137`,networkName:`Polygon`,chainLogoUrl:b,explorerBase:`https://polygonscan.com`,acceptedAssets:[{symbol:`POL`,address:``,decimals:18,isNative:!0,assetLogoUrl:b},{symbol:`TUSD`,address:`0x2e1AD108fF1D8C782fcBbB89AAd783aC49586756`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/tusd.svg`},{symbol:`USDC`,address:`0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359`,decimals:6,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/usdc.svg`},{symbol:`WETH`,address:`0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/weth.svg`},{symbol:`DAI`,address:`0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063`,decimals:18,isNative:!1,assetLogoUrl:`https://cdn.stridge.com/assets/dai.svg`},{symbol:`USDT`,address:`0xc2132D05D31c914a87C6611C10748AEb04B58e8F`,decimals:6,isNative:!1,assetLogoUrl:_}]}];function A(e,t){let n=t===void 0?{}:{minDepositUsd:{value:t,formatted:i(t,e)}};return k.map(({eip155Id:e,networkName:t,chainLogoUrl:r,explorerBase:i,acceptedAssets:o})=>({eip155Id:e,networkName:t,chainLogoUrl:r,address:{value:x,formatted:a(x)},explorerUrl:`${i}/address/${x}`,acceptedAssets:o,...n}))}const j=k.map(({eip155Id:e,networkName:t,chainLogoUrl:n,explorerBase:r,acceptedAssets:i})=>({eip155Id:e,networkName:t,chainLogoUrl:n,address:{value:x,formatted:a(x)},explorerUrl:`${r}/address/${x}`,acceptedAssets:i})),M={1:`60`,56:`9006`,137:`9001`,8453:`8453`,42161:`42161`};function N(){return{assets:k.map(e=>{let t=e.acceptedAssets.find(e=>e.isNative),n=e.acceptedAssets.filter(e=>!e.isNative);return{eip155_id:Number(e.eip155Id),network_id:M[e.eip155Id]??e.eip155Id,network_name:e.networkName.toLowerCase(),network_symbol:e.networkName.toLowerCase(),assets:n.map(e=>({address:e.address,decimals:e.decimals,logo:e.assetLogoUrl??``,name:e.symbol,symbol:e.symbol})),native_currency:{symbol:t?.symbol??``,name:t?.symbol??``,decimals:t?.decimals??18,logo:t?.assetLogoUrl??e.chainLogoUrl}}})}}function P(e){return[{networkId:`9006`,networkName:`BSC`,eip155Id:`56`,symbol:`USDC`,decimals:18,address:h,assetLogoUrl:g,chainLogoUrl:y,isNative:!1,amount:{value:42.805864,formatted:r(42.805864,e,{compact:!0})},amountUsd:{value:42.81,formatted:i(42.81,e)},priceUsd:1},{networkId:`9006`,networkName:`BSC`,eip155Id:`56`,symbol:`BNB`,decimals:18,address:``,assetLogoUrl:y,chainLogoUrl:y,isNative:!0,amount:{value:.016699,formatted:r(.016699,e,{compact:!0})},amountUsd:{value:10.86,formatted:i(10.86,e)},priceUsd:650.41},{networkId:`60`,networkName:`Ethereum`,eip155Id:`1`,symbol:`USDT`,decimals:6,address:`0xdAC17F958D2ee523a2206206994597C13D831ec7`,assetLogoUrl:_,chainLogoUrl:v[1],isNative:!1,amount:{value:.757479,formatted:r(.757479,e,{compact:!0})},amountUsd:{value:.76,formatted:i(.76,e)},priceUsd:1,lowBalance:!0,disabled:!0},{networkId:`9006`,networkName:`BSC`,eip155Id:`56`,symbol:`USDT`,decimals:18,address:`0x55d398326f99059fF775485246999027B3197955`,assetLogoUrl:_,chainLogoUrl:y,isNative:!1,amount:{value:.595218,formatted:r(.595218,e,{compact:!0})},amountUsd:{value:.6,formatted:i(.6,e)},priceUsd:1,lowBalance:!0,disabled:!0},{networkId:`60`,networkName:`Ethereum`,eip155Id:`1`,symbol:`ETH`,decimals:18,address:``,assetLogoUrl:v[1],chainLogoUrl:v[1],isNative:!0,amount:{value:167e-6,formatted:r(167e-6,e,{compact:!0})},amountUsd:{value:.39,formatted:i(.39,e)},priceUsd:2316.86,lowBalance:!0,disabled:!0},{networkId:`60`,networkName:`Ethereum`,eip155Id:`1`,symbol:`USDC`,decimals:6,address:`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`,assetLogoUrl:`https://cdn.stridge.com/assets/usdc.svg`,chainLogoUrl:v[1],isNative:!1,amount:{value:.10408,formatted:r(.10408,e,{compact:!0})},amountUsd:{value:.1,formatted:i(.1,e)},priceUsd:1,lowBalance:!0,disabled:!0}]}function F(e,n,a=w){return{heroAmountUsd:{value:1.999758,formatted:i(1.999758,e)},sendAsset:{symbol:`USDC`,decimals:6,address:`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`,assetLogoUrl:`https://cdn.stridge.com/assets/usdc.svg`,isNative:!1,chainId:1,networkName:`Ethereum`,eip155Id:`1`,chainLogoUrl:v[1]},sendAmount:{value:2,formatted:r(2,e)},receiveAsset:{symbol:a.symbol,decimals:a.decimals,address:a.address,assetLogoUrl:a.assetLogoUrl,isNative:a.isNative,chainId:a.eip155IdNumber,networkName:a.networkName,eip155Id:a.eip155IdString,chainLogoUrl:a.chainLogoUrl},receiveAmount:{value:1.9958,formatted:r(1.9958,e)},quoteTotalSeconds:30,expiresAt:n,etaSeconds:30,breakdown:{selectedRoute:{provider:`lifi`,scenario:`cross_chain_diff_token`,label:`LIFI · cross chain diff token`},networkCost:{value:.0042,formatted:i(.0042,e)},priceImpact:{value:.21,formatted:t(.21,e)}}}}function I(e,t=w){return{kind:`pending`,sourceWallet:{name:`Wallet`,address:{value:s,formatted:a(s)},explorerUrl:`https://etherscan.io/address/${s}`},creditedAsset:{symbol:t.symbol,decimals:t.decimals,address:t.address,assetLogoUrl:t.assetLogoUrl,isNative:t.isNative},creditedTo:o,txHash:{value:c,formatted:a(c)},txExplorerUrl:`https://etherscan.io/tx/${c}`,detectedAt:{value:d,formatted:n(d,e)},submittedAt:{value:d,formatted:n(d,e)},receiveAmount:{value:4.983615,formatted:r(4.983615,e)}}}function L(t,i=w){let u=f-d;return{kind:`succeeded`,sourceWallet:{name:`Wallet`,address:{value:s,formatted:a(s)},explorerUrl:`https://etherscan.io/address/${s}`},destination:{name:o,address:{value:s,formatted:a(s)}},creditedAsset:{symbol:i.symbol,decimals:i.decimals,address:i.address,assetLogoUrl:i.assetLogoUrl,isNative:i.isNative},receiveAmount:{value:4.983615,formatted:r(4.983615,t)},routeHops:[{provider:`LIFI`,chainId:1},{provider:`LIFI`,chainId:i.eip155IdNumber}],totalTime:{value:u,formatted:e(u,t)},depositTx:{hash:{value:c,formatted:a(c)},explorerUrl:`https://etherscan.io/tx/${c}`},completionTx:{hash:{value:l,formatted:a(l)},explorerUrl:`${i.explorerBase}/tx/${l}`},submittedAt:{value:d,formatted:n(d,t)},filledAt:{value:f,formatted:n(f,t)}}}function R(e,t=`execution-reverted`,i=w){return{kind:`failed`,failureKind:t,sourceWallet:{name:`Wallet`,address:{value:s,formatted:a(s)},explorerUrl:`https://etherscan.io/address/${s}`},destination:{name:o,address:{value:s,formatted:a(s)}},creditedAsset:{symbol:i.symbol,decimals:i.decimals,address:i.address,assetLogoUrl:i.assetLogoUrl,isNative:i.isNative},receiveAmount:{value:0,formatted:r(0,e)},txHash:{value:u,formatted:a(u)},txExplorerUrl:`https://etherscan.io/tx/${u}`,submittedAt:{value:p,formatted:n(p,e)},failedAt:{value:m,formatted:n(m,e)}}}function z(e,t=S){let n=P(e).reduce((e,t)=>e+(t.amountUsd?.value??0),0);return{address:{value:t.address,formatted:a(t.address)},...t.chainId===void 0?{}:{chainId:t.chainId},balanceTotalUsd:{value:n,formatted:i(n,e)}}}const B={deposit_addresses:[],metadata:{brand_name:o}},V=[],H={assets:[]},U={chains:[]},W={},G={id:`mock-settlement`,status:`completed`,created_at:new Date(d).toISOString(),updated_at:new Date(f).toISOString()},K={settlements:[],is_terminal:!1};function q(e,t,n,r){return t===`pending`?I(e,n&&typeof n!=`string`?n:void 0):t===`succeeded`?L(e,n&&typeof n!=`string`?n:void 0):R(e,typeof n==`string`?n:void 0,r)}export{j as DEFAULT_ADDRESSES_PAYLOAD,C as DEFAULT_BRAND_PAYLOAD,w as DEFAULT_MOCK_ASSET,D as DEFAULT_TARGET_RAW,S as DEFAULT_WALLET_INFO,V as STUB_DEPOSIT_ADDRESSES_RAW,K as STUB_GATEWAY_POLL_RESPONSE,G as STUB_GATEWAY_SETTLEMENT_DTO,B as STUB_GATEWAY_START_RESPONSE,U as STUB_ONCHAIN_BALANCE_RESPONSE,W as STUB_QUOTE_RESPONSE,H as STUB_SUPPORTED_ASSETS_RESPONSE,A as buildDefaultAddressesPayload,P as buildDefaultBalances,R as buildDefaultFailurePayload,I as buildDefaultPendingPayload,F as buildDefaultQuotePayload,L as buildDefaultSuccessPayload,N as buildDefaultSupportedAssetsResponse,O as buildDefaultTargetPayload,E as buildDefaultTargetRaw,z as buildDefaultWalletPayload,q as buildSettlementPayload,T as resolveMockAsset};

package/dist/drivers/stridge-mock/store.js

@@ -0,0 +1 @@
+function e(e){let t=e,n=new Set;function r(){for(let e of n)e()}return{getSnapshot(){return t},subscribe(e){return n.add(e),()=>{n.delete(e)}},update(e){t={...t,...e},r()},replace(e){t=e,r()}}}export{e as createEntityStore};

package/dist/drivers/stridge-mock/triggers.d.ts

@@ -0,0 +1,41 @@
+import { SettlementFailureKind } from "../../shared/driver/types.js";
+import { SettlementFailurePayload, SettlementPendingPayload, SettlementSuccessPayload } from "../../flows/deposit/driver/payloads.js";
+//#region src/drivers/stridge-mock/triggers.d.ts
+/**
+ * Mock-specific imperative trigger surface returned alongside the {@link DepositDriver} from
+ * {@link createStridgeMockDriver}. Drivers separate this surface from the contract types so the
+ * kit's `DepositDriver` interface stays untouched by mock-specific affordances — production code
+ * never sees these triggers.
+ *
+ * Triggers mutate the driver's internal entity store, then notify subscribers. Calling a trigger
+ * is the mock equivalent of a backend response landing on the live driver: the entity flips to
+ * `ready` with the new payload and any orchestrator effect that was awaiting the transition
+ * dispatches its FSM event on the next render.
+ */
+interface MockTriggers {
+  /**
+   * Flips `settlement` to `ready` with a `pending` payload. Optional `partial` overrides any
+   * field on the bundled fixture (use it to vary the tx hash, detected timestamp, etc.).
+   */
+  triggerSettlementPending(partial?: Partial<SettlementPendingPayload>): void;
+  /**
+   * Flips `settlement` to `ready` with a `succeeded` payload. Useful for canvas cards
+   * pre-seeding the success card and for tests asserting `<SuccessState>` rendering.
+   */
+  triggerSettlementSuccess(partial?: Partial<SettlementSuccessPayload>): void;
+  /**
+   * Flips `settlement` to `ready` with a `failed` payload of the given `failureKind`. The
+   * widget translates `failureKind` to localized headline + reason copy via `useT()`.
+   */
+  triggerSettlementFailure(failureKind: SettlementFailureKind, partial?: Partial<SettlementFailurePayload>): void;
+  /**
+   * Flips `quote` to `error` with the supplied `Error`. Drives the confirm-deposit "Try again"
+   * fallback path so canvas / Storybook surfaces can render the error chrome without a live
+   * gateway failure.
+   */
+  triggerQuoteFailure(error: Error): void;
+  /** Restores every entity to the snapshot the factory was constructed with. */
+  reset(): void;
+}
+//#endregion
+export { MockTriggers };

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

@@ -0,0 +1 @@
+"use client";import{useDepositSnapshot as e}from"../driver/context.js";import{Trans as t}from"../../../shared/i18n/Trans.js";import{useLingui as n}from"../../../shared/i18n/useLingui.js";import"../../../i18n/index.js";import{useDepositActions as r}from"../orchestrator/controller.js";import{ChevronDownIcon as i}from"../../../shared/icons/ChevronDownIcon.js";import"../../../icons/index.js";import{Button as a}from"../../../shared/ui/Button/Button.js";import{Dialog as o}from"../../../shared/ui/Dialog/Dialog.js";import"../../../shared/ui/Dialog/index.js";import{Card as s}from"../../../shared/ui/Card/Card.js";import{Collapsible as c}from"../../../shared/ui/Collapsible/Collapsible.js";import"../../../shared/ui/Collapsible/index.js";import{text as l}from"../../../shared/ui/Text/Text.js";import"../../../ui/index.js";import{Frame as u}from"../../../shared/dialog/Frame.js";import{styles as d}from"./DepositBootstrapErrorState.styles.js";import{jsx as f,jsxs as p}from"react/jsx-runtime";import*as m from"@stylexjs/stylex";const h=process.env.NODE_ENV!==`production`;function g(){return p(`svg`,{"aria-hidden":!0,viewBox:`0 0 64 64`,xmlns:`http://www.w3.org/2000/svg`,fill:`none`,...m.props(d.heroRing),children:[f(`circle`,{cx:`32`,cy:`32`,r:`28`,strokeWidth:`2`,style:{stroke:`color-mix(in oklab, var(--stridge-kit-warning) 55%, transparent)`}}),f(`circle`,{cx:`32`,cy:`32`,r:`20`,style:{fill:`var(--stridge-kit-warning)`}}),f(`path`,{d:`M32 22V34`,strokeWidth:`2.8`,strokeLinecap:`round`,style:{stroke:`var(--stridge-kit-warning-foreground)`}}),f(`circle`,{cx:`32`,cy:`40.5`,r:`1.8`,style:{fill:`var(--stridge-kit-warning-foreground)`}})]})}function _(){let _=e(),{close:y}=r(),{_:b}=n(),x=(_.target.status===`error`?_.target.error:void 0)??(_.brand.status===`error`?_.brand.error:void 0)??(_.addresses.status===`error`?_.addresses.error:void 0),S=x?.name??`DepositBootstrapError`,C=x?.message??b({id:`3yd3IL`,message:`The deposit driver failed to load gateway configuration.`}),w=x?.stack;return p(u,{"data-stridge-slot":`deposit-bootstrap-error`,"data-testid":`deposit-bootstrap-error`,...m.props(d.root),children:[p(s.Header,{...m.props(d.header),children:[f(l.span,{size:`base`,fontWeight:`semibold`,leading:`tight`,tracking:`tight`,children:f(t,{id:`OLF0i7`,message:`Couldn't load deposit options`})}),f(o.CloseButton,{})]}),p(s.Body,{children:[p(`div`,{"data-stridge-slot":`deposit-bootstrap-error-hero`,...m.props(d.hero),children:[f(g,{}),f(l.span,{size:`lg`,fontWeight:`semibold`,leading:`tight`,tracking:`tight`,align:`center`,...m.props(d.heroHeadline),children:f(t,{id:`qQ5VJt`,message:`We can't reach the gateway right now`})}),f(l.span,{size:`sm`,leading:`normal`,align:`center`,color:`subdued`,...m.props(d.heroReason),children:f(t,{id:`02NghK`,message:`Close this dialog and try again in a moment. If the problem persists, double-check the gateway key on your integration.`})})]}),p(c,{"data-stridge-slot":`deposit-bootstrap-error-details`,...m.props(d.details),children:[p(c.Trigger,{render:f(`button`,{type:`button`}),"aria-label":b({id:`c6Bl9M`,message:`Toggle technical details`}),...m.props(d.detailsTrigger),children:[f(l.span,{size:`xs`,fontWeight:`medium`,leading:`tight`,color:`subdued`,children:f(t,{id:`69Gavs`,message:`Technical details`})}),f(i,{"aria-hidden":!0,...m.props(d.detailsChevron)})]}),f(c.Panel,{children:p(`div`,{...m.props(d.detailsPanel),children:[f(v,{label:b({id:`SlfejT`,message:`Error`}),value:S}),f(v,{label:b({id:`xDAtGP`,message:`Message`}),value:C}),h&&w?p(`div`,{...m.props(d.detailsRow),children:[f(l.span,{size:`2xs`,fontWeight:`medium`,leading:`tight`,tracking:`widest`,transform:`uppercase`,color:`subdued`,children:f(t,{id:`P9fBwv`,message:`Stack`})}),f(`pre`,{...m.props(d.stack),children:w})]}):null]})})]})]}),f(s.Footer,{...m.props(d.footer),children:f(a,{variant:`default`,size:`cta`,onClick:y,"data-stridge-slot":`deposit-bootstrap-error-close`,...m.props(d.cta),children:f(t,{id:`yz7wBu`,message:`Close`})})})]})}function v({label:e,value:t}){return p(`div`,{...m.props(d.detailsRow),children:[f(l.span,{size:`2xs`,fontWeight:`medium`,leading:`tight`,tracking:`widest`,transform:`uppercase`,color:`subdued`,children:e}),f(l.span,{size:`xs`,fontWeight:`normal`,leading:`normal`,...m.props(d.detailsValue),children:t})]})}export{_ as DepositBootstrapErrorState};

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

@@ -0,0 +1 @@
+const e={root:{"DepositBootstrapErrorState__styles.root":`DepositBootstrapErrorState__styles.root`,"position-kVAEAm":`x1n2onr6`,"width-kzqmXN":`xh8yej3`,"maxWidth-ks0D6T":`x17fpy1y`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:24`},header:{"DepositBootstrapErrorState__styles.header":`DepositBootstrapErrorState__styles.header`,"justifyContent-kjj79g":`x1qughib`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:33`},hero:{"DepositBootstrapErrorState__styles.hero":`DepositBootstrapErrorState__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/DepositBootstrapErrorState.styles.ts:42`},heroRing:{"DepositBootstrapErrorState__styles.heroRing":`DepositBootstrapErrorState__styles.heroRing`,"display-k1xSpc":`x1lliihq`,"width-kzqmXN":`x1fu8urw`,"height-kZKoxP":`x1peatla`,"flexShrink-kmuXW":`x2lah0s`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:58`},heroHeadline:{"DepositBootstrapErrorState__styles.heroHeadline":`DepositBootstrapErrorState__styles.heroHeadline`,"marginTop-keoZOQ":`x1k70j0n`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:64`},heroReason:{"DepositBootstrapErrorState__styles.heroReason":`DepositBootstrapErrorState__styles.heroReason`,"maxWidth-ks0D6T":`x1va8c73`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:67`},details:{"DepositBootstrapErrorState__styles.details":`DepositBootstrapErrorState__styles.details`,"marginTop-keoZOQ":`x1hmvnq2`,"marginInline-kUOVxO":`x10bka1u`,"marginBottom-k1K539":`x91k8ka`,"borderRadius-kaIpWk":`x12ur2as`,"borderWidth-kMzoRj":`xmkeg23`,"borderStyle-ksu8eU":`x1y0btm7`,"borderColor-kVAM5u":`x1bue7yx`,"backgroundColor-kWkggS":`x407w7c`,"overflow-kVQacm":`xb3r6kr`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:76`},detailsTrigger:{"DepositBootstrapErrorState__styles.detailsTrigger":`DepositBootstrapErrorState__styles.detailsTrigger`,"display-k1xSpc":`x78zum5`,"alignItems-kGNEyG":`x6s0dn4`,"justifyContent-kjj79g":`x1qughib`,"gap-kOIVth":`x167g77z`,"width-kzqmXN":`xh8yej3`,"paddingBlock-k8WAf4":`xp59q4u`,"paddingInline-kg3NbH":`xqin4a2`,"borderWidth-kMzoRj":`xc342km`,"backgroundColor-kWkggS":`xjbqb8w`,"color-kMwMTN":`xzn0pkc`,"cursor-kkrTdU":`x1ypdohk`,"outline-kI3sdo":`x1a2a7pz`,"WebkitTapHighlightColor-kQizK7":`x1i10hfl`,"textAlign-k9WMMc":`x1yc453h`,"fontFamily-kMv6JI":`xjb2p0i`,":focus-visible_boxShadow-kEtg5x":`xf4a2cz`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:87`},detailsChevron:{"DepositBootstrapErrorState__styles.detailsChevron":`DepositBootstrapErrorState__styles.detailsChevron`,"width-kzqmXN":`x6jxa94`,"height-kZKoxP":`x1v9usgg`,"flexShrink-kmuXW":`x2lah0s`,"color-kMwMTN":`x137ha3m`,"strokeWidth-kfJifR":`xhr4kjn`,"transformOrigin-k3nNDw":`x1g0ag68`,"transitionProperty-k1ekBW":`x11xpdln`,"transitionDuration-kIyJzY":`x1vhb3u9 x12w9bfk`,"transitionTimingFunction-kAMwcw":`x1xv5090`,"[data-panel-open] &_transform-kSnp38":`xtqhfa`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:107`},detailsPanel:{"DepositBootstrapErrorState__styles.detailsPanel":`DepositBootstrapErrorState__styles.detailsPanel`,"display-k1xSpc":`x78zum5`,"flexDirection-kXwgrk":`xdt5ytf`,"gap-kOIVth":`x883omv`,"paddingInline-kg3NbH":`xqin4a2`,"paddingTop-kLKAdn":`x1nn3v0j`,"paddingBottom-kGO01o":`xsag5q8`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:124`},detailsRow:{"DepositBootstrapErrorState__styles.detailsRow":`DepositBootstrapErrorState__styles.detailsRow`,"display-k1xSpc":`x78zum5`,"flexDirection-kXwgrk":`xdt5ytf`,"gap-kOIVth":`x1jnr06f`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:132`},detailsValue:{"DepositBootstrapErrorState__styles.detailsValue":`DepositBootstrapErrorState__styles.detailsValue`,"wordBreak-kTgw9":`x13faqbe`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:137`},stack:{"DepositBootstrapErrorState__styles.stack":`DepositBootstrapErrorState__styles.stack`,"margin-kogj98":`x1ghz6dp`,"maxHeight-kskxy":`x19aweqf`,"overflow-kVQacm":`xysyzu8`,"padding-kmVPX3":`xvaa05t`,"borderRadius-kaIpWk":`x143j3yi`,"backgroundColor-kWkggS":`x19u6ldj`,"fontFamily-kMv6JI":`x47j52l`,"fontSize-kGuDYH":`x1r4ghiz`,"lineHeight-kLWn49":`x1ppnlvb`,"color-kMwMTN":`xi96bwj`,"whiteSpace-khDVqt":`x126k92a`,"wordBreak-kTgw9":`x13faqbe`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:140`},footer:{"DepositBootstrapErrorState__styles.footer":`DepositBootstrapErrorState__styles.footer`,"display-k1xSpc":`x78zum5`,"flexDirection-kXwgrk":`xdt5ytf`,"alignItems-kGNEyG":`x1qjc9v5`,"paddingTop-kLKAdn":`x109j2v6`,"paddingInline-kg3NbH":`x65v0h`,"paddingBottom-kGO01o":`x1t4gjm`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:158`},cta:{"DepositBootstrapErrorState__styles.cta":`DepositBootstrapErrorState__styles.cta`,"width-kzqmXN":`xh8yej3`,"alignSelf-kSGwAc":`xkh2ocl`,$$css:`@stridge/kit:src/flows/deposit/dialog/DepositBootstrapErrorState.styles.ts:166`}};export{e as styles};

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

@@ -0,0 +1,112 @@
+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 { ErrorInfo } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/dialog/DepositDialog.d.ts
+/**
+ * Orchestrated deposit dialog. Mount inside `<StridgeProvider>` wherever the integrator wants
+ * the dialog to live in the React tree (typically once at the layout root). Open state is
+ * 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.
+ *
+ * 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.
+ */
+declare function DepositDialog({
+  container,
+  onOpened,
+  onClosed,
+  onStepChanged,
+  onError,
+  events
+}: DepositDialog.Props): _$react_jsx_runtime0.JSX.Element;
+declare namespace DepositDialog {
+  interface Props {
+    /**
+     * Element the dialog portals into. Defaults to `document.body` (full-page overlay). Pass a
+     * transformed ancestor with `overflow: clip` — e.g. a mobile mockup frame — to scope the
+     * dialog's width, height, and backdrop to that rect.
+     */
+    container?: HTMLElement | null;
+    /** 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.
+     */
+    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;
+    /**
+     * Terminal failure — either a settlement failure (driver-emitted classification) or an
+     * FSM-derived failure (quote / submission rejection escalated to the global error arm).
+     */
+    onFailed?: (failure: SettlementFailurePayload | FailureInfo) => void;
+    /**
+     * Background `fetchActiveSettlement` probe surfaced a pending deposit — the driver's
+     * `settlement` entity transitioned from `idle` / `loading` straight to a pending payload.
+     */
+    onPendingSnapshotDetected?: (snapshot: SettlementPendingPayload) => void;
+  }
+}
+/** Convenience union — the `ctx` payload on `onStepChanged`. */
+type GatewayContext = Exclude<DepositState, {
+  name: "closed";
+}>["ctx"];
+//#endregion
+export { DepositDialog };

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

@@ -0,0 +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};

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

@@ -0,0 +1,37 @@
+import { DepositDriver, DepositSnapshot } from "./types.js";
+import * as _$react from "react";
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/flows/deposit/driver/context.d.ts
+declare const KitDriverContext: _$react.Context<DepositDriver | null>;
+interface DepositDriverProviderProps {
+  driver: DepositDriver;
+  children: ReactNode;
+}
+/**
+ * Publishes a {@link DepositDriver} into kit context. Mounted internally by `<KitProvider />` in
+ * `driver`-mode; tests can mount it directly to drive widgets against a mock driver without
+ * spinning up the full kit provider chain.
+ */
+declare function DepositDriverProvider({
+  driver,
+  children
+}: DepositDriverProviderProps): _$react_jsx_runtime0.JSX.Element;
+/**
+ * Reads the active {@link DepositDriver}. Throws when called outside `<DepositDriverProvider>` /
+ * `<KitProvider deposit={…}>`.
+ */
+declare function useDepositDriverInstance(): DepositDriver;
+/**
+ * Subscribes the calling component to driver entity transitions and returns the live
+ * {@link DepositSnapshot}. Backed by `useSyncExternalStore` — re-renders are scheduled by the
+ * driver's `subscribe` listener.
+ *
+ * Wraps `subscribe` / `getSnapshot` in lambdas so the call resolves through the driver instance.
+ * Class-based BYO drivers would otherwise lose their `this` binding when React invokes the
+ * methods detached from the instance.
+ */
+declare function useDepositSnapshot(): DepositSnapshot;
+//#endregion
+export { DepositDriverProvider, KitDriverContext, useDepositDriverInstance, useDepositSnapshot };

package/dist/flows/deposit/driver/context.js

@@ -0,0 +1 @@
+"use client";import{createContext as e,use as t,useSyncExternalStore as n}from"react";import{jsx as r}from"react/jsx-runtime";const i=e(null);i.displayName=`KitDriverContext`;function a({driver:e,children:t}){return r(i,{value:e,children:t})}function o(){let e=t(i);if(!e)throw Error("useDepositSnapshot must be used inside a `<StridgeProvider>` with `flows.deposit` enabled.");return e}function s(){let e=o();return n(t=>e.subscribe(t),()=>e.getSnapshot(),()=>e.getSnapshot())}export{a as DepositDriverProvider,i as KitDriverContext,o as useDepositDriverInstance,s as useDepositSnapshot};

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

@@ -0,0 +1,342 @@
+import { SettlementFailureKind } from "../../../shared/driver/types.js";
+import { FormattedField } from "../../../shared/format/types.js";
+//#region src/flows/deposit/driver/payloads.d.ts
+/**
+ * Host-supplied identity record for the connected wallet. Drivers receive this from the host
+ * (live driver: from wagmi or `<StridgeProvider userAddress>`; mock driver: from factory args)
+ * and pass it through {@link import("./transformers").walletAddressToWalletPayload} to produce
+ * the {@link WalletPayload}. The same shape sits in the entity envelope's `raw` and `response`
+ * slots so headless integrators reading the connected wallet see the unscaled inputs.
+ */
+interface WalletInfo {
+  /** Connected wallet hex address (full, unshortened). */
+  address: string;
+  /** EIP-155 chain id of the active network. */
+  chainId?: number;
+}
+/**
+ * Connected-wallet identity surfaced across kit chrome that needs `…<last 4>` truncation before
+ * any settlement exists — the deposit-method tile's title adornment, the amount-entry source
+ * pill, the confirm-deposit "Wallet (…<last 4>)" label, and the deposit-status banner's
+ * disconnected-state copy. Settlement-scoped wallet rows continue to read
+ * {@link SourceWalletPayload} (which carries the historical `sourceWallet` captured at submit
+ * time, distinct from the currently-connected EOA).
+ *
+ * Lifecycle is encoded by the entity envelope: `idle` when no wallet is connected, `ready` once
+ * the host has supplied an address. Components flip on `entity.status`; they never inspect a
+ * `connected` flag on the payload.
+ */
+interface WalletPayload {
+  /** Connected wallet hex address. `value` is the full hex, `formatted` is `0x…<last 4>`. */
+  address: FormattedField<string>;
+  /** EIP-155 chain id of the active network. */
+  chainId?: number;
+  /**
+   * Aggregated USD balance across every routable source-side asset the wallet holds. Drivers
+   * compute the total as `sum(balances[i].amountUsd.value)` and pass it through `formatUsd`.
+   * Surfaced on the deposit-method picker's wallet tile (`$24.50 · Instant`) so the user sees
+   * what they have to deposit before entering the flow. Optional — the picker hides the meta
+   * line when this isn't available (e.g. before the first `balance/onchain` poll lands).
+   */
+  balanceTotalUsd?: FormattedField<number>;
+}
+/**
+ * Brand context surfaced across the kit's chrome — `<DialogShell>` title, `<ConfirmDeposit>`
+ * destination row, `<ProcessingState>` header pill, `<SuccessState>` "credited to" line. The host
+ * may carry its own brand on `gateway/start`'s metadata; this entity exposes the canonical name +
+ * optional checkout-item title.
+ */
+interface BrandPayload {
+  /** Display name of the merchant / project receiving the deposit (e.g. `"Stridge ACME"`). */
+  name?: string;
+  /** Optional secondary line shown alongside the brand name on richer chrome (e.g. order title). */
+  checkoutItemTitle?: string;
+}
+/**
+ * Shared chain-chrome subset reused across payloads that reference a network — picker rows,
+ * settled-on indicator, processing destination tile. Distinct field names from {@link AssetPayload}
+ * so payloads composing both (e.g. {@link TargetPayload}, {@link BalanceItemPayload}) keep chain
+ * and asset metadata cleanly separated.
+ */
+interface ChainPayload {
+  /**
+   * Stridge network id (string-encoded — e.g. `"60"` for Ethereum mainnet, `"9006"` for BSC).
+   * Optional because some upstream DTOs (deposit addresses) only carry the EIP-155 id.
+   */
+  networkId?: string;
+  /** Human-readable network name (e.g. `"Ethereum"`, `"BSC"`). */
+  networkName: string;
+  /** EIP-155 chain id when applicable (numeric chain id as a string, e.g. `"1"`, `"56"`). */
+  eip155Id?: string;
+  /** Resolved chain icon URL (CDN-served by the kit's logo registry). */
+  chainLogoUrl?: string;
+}
+/**
+ * Shared asset-chrome subset — symbol + decimals + optional logo. Used inside settlement /
+ * balance / target payloads anywhere a token is referenced. Field names are distinct from
+ * {@link ChainPayload} so the two interfaces compose without name collision.
+ */
+interface AssetPayload {
+  /** Token symbol as displayed (e.g. `"USDC"`, `"BNB"`). */
+  symbol: string;
+  /** On-chain decimal precision (e.g. `6` for USDC on Ethereum, `18` for ETH). */
+  decimals: number;
+  /** ERC-20 contract address. Empty string for native assets. */
+  address: string;
+  /** Resolved token icon URL. */
+  assetLogoUrl?: string;
+  /** True for the chain's native gas token (e.g. ETH on Ethereum, BNB on BSC). */
+  isNative: boolean;
+}
+/**
+ * Settlement destination receive asset — the (network × asset) tuple the host configured at
+ * `<StridgeProvider />` mount. Drives the amount-entry "You receive" pill and the destination
+ * tile across the flow.
+ */
+interface TargetPayload extends ChainPayload, AssetPayload {
+  /** Optional minimum-deposit USD floor surfaced on amount-entry / asset-picker chrome. */
+  minDepositUsd?: FormattedField<number>;
+}
+/**
+ * Per-chain deposit address provisioned by `gateway/start`. The kit ships one envelope item per
+ * supported source chain; the user copies the address that matches the chain they intend to fund
+ * the deposit from.
+ */
+interface AddressItemPayload extends ChainPayload {
+  /** The deposit address for this chain. `value` is the full hex; `formatted` is `0x…tail`. */
+  address: FormattedField<string>;
+  /** Block-explorer URL for `address.value` (when the kit knows an explorer for this chain). */
+  explorerUrl?: string;
+  /**
+   * 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.
+   */
+  minDepositUsd?: 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
+   * narrows to that chain's accepted set (e.g. on Ethereum: ETH, TUSD, PAXG, DAI, PYUSD,
+   * USDC, WETH, USDT). Optional — drivers that haven't surfaced the accepted-asset list (or
+   * mock fixtures from before the feature shipped) leave it undefined and the widget falls
+   * back to the destination asset only.
+   */
+  acceptedAssets?: ReadonlyArray<AcceptedAssetPayload>;
+}
+/**
+ * One token the gateway accepts on a given source chain. Mirrors the shape of
+ * `gateway/start.deposit_addresses[i].accepted_assets[j]` after the driver transformer maps it
+ * through to the kit's display fields.
+ */
+interface AcceptedAssetPayload {
+  /** Token symbol as displayed (`"USDC"`, `"WETH"`, `"BNB"`). */
+  symbol: string;
+  /** ERC-20 contract address. Empty string for the chain's native token. */
+  address: string;
+  /** On-chain decimal precision. */
+  decimals: number;
+  /** Resolved token icon URL (passed through from the wire when present). */
+  assetLogoUrl?: string;
+  /** True for the chain's native gas token (synthesized from an empty `address`). */
+  isNative: boolean;
+}
+/**
+ * Source-side per-asset balance — what the connected wallet holds across supported chains. Drives
+ * the asset-picker rows in Path A (wallet flow).
+ */
+interface BalanceItemPayload extends ChainPayload, AssetPayload {
+  /** Wallet balance in display units (post-decimals). */
+  amount: FormattedField<number>;
+  /** USD value of `amount` at the most recent price snapshot. Omitted when no price is known. */
+  amountUsd?: FormattedField<number>;
+  /** Per-token unit price in USD at the most recent snapshot, kept raw for sorting / range checks. */
+  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
+   * picker; the row remains visible so the user knows the asset exists in the wallet.
+   */
+  lowBalance?: boolean;
+  /**
+   * `true` when the row should not be selectable. Independent of {@link lowBalance} — drivers
+   * may set both for sub-floor balances, or set just `disabled` for assets that are catalog-
+   * present but not currently routable.
+   */
+  disabled?: boolean;
+}
+/**
+ * Discriminator for breakdown row "Selected route". The string identifies the routing protocol
+ * the gateway chose (e.g. LIFI + an underlying DEX); component code maps this to a logo + label.
+ */
+interface QuoteRoutePayload {
+  /** The bridge / aggregator the gateway selected (e.g. `"lifi"`). */
+  provider: string;
+  /** Routing scenario classification (e.g. `"same_chain_diff_token"`, `"cross_chain_diff_token"`). */
+  scenario: string;
+  /** Human-readable label the route row renders (e.g. `"LIFI · SushiSwap"`). */
+  label: string;
+}
+/**
+ * Quote breakdown rows — the four optional rows displayed on the confirm-deposit panel. Each
+ * field is independently optional so the row hides when the gateway didn't surface that detail.
+ */
+interface QuoteBreakdownPayload {
+  /** Selected routing provider + label, when known. */
+  selectedRoute?: QuoteRoutePayload;
+  /** Estimated network cost in USD. */
+  networkCost?: FormattedField<number>;
+  /** Price impact in percent units (`0.21` means `0.21%`). */
+  priceImpact?: FormattedField<number>;
+  /**
+   * Maximum acceptable slippage. `auto` is `true` when the gateway picked it automatically; the
+   * widget renders `"Auto · 0.50%"` instead of just `"0.50%"` in that case.
+   */
+  maxSlippage?: {
+    auto: boolean;
+    value: FormattedField<number>;
+  };
+}
+/**
+ * Quote payload — the formatted result of a `requestQuote` round-trip. Drives the confirm-deposit
+ * widget's hero amount, transfer summary, and breakdown rows.
+ */
+interface QuotePayload {
+  /** Hero USD amount displayed at the top of the confirm-deposit panel. */
+  heroAmountUsd: FormattedField<number>;
+  /** Source-side asset the user is sending — carries chain chrome too so the widget renders the network pill without reaching back into `target`. */
+  sendAsset: AssetPayload & ChainPayload & {
+    chainId: number;
+  };
+  /** Send amount in display units. */
+  sendAmount: FormattedField<number>;
+  /** Destination-side asset the user is receiving — see {@link sendAsset} for the chain-chrome rationale. */
+  receiveAsset: AssetPayload & ChainPayload & {
+    chainId: number;
+  };
+  /** Receive amount in display units (after fees / route conversion). */
+  receiveAmount: FormattedField<number>;
+  /**
+   * Total seconds the quote window starts at — used to draw the confirm-deposit timer ring.
+   * Defaults to `30` when the gateway does not surface a per-quote freshness window.
+   */
+  quoteTotalSeconds: number;
+  /** Unix-ms timestamp at which the quote expires and the entity transitions to `stale`. */
+  expiresAt: number;
+  /**
+   * Estimated total settlement time in seconds (`route.estimated_time_seconds` from the wire).
+   * Drives the confirm-deposit "Estimated time" row — `< 1 min`, `2 min`, `~ 5 min`, etc. The
+   * raw seconds are kept so widgets can format them locally with the kit's
+   * {@link import("#/shared/format").formatDurationCoarse} helper.
+   */
+  etaSeconds: number;
+  /** Optional breakdown rows (route, network cost, price impact, slippage). */
+  breakdown?: QuoteBreakdownPayload;
+}
+/**
+ * Source-wallet pill rendered on every receipt row that references the EOA the deposit came
+ * from. `name` is the localized affordance label the widget chooses (e.g. `"Wallet"`); `address`
+ * carries both the hex value (for explorer hrefs) and the truncated display form.
+ */
+interface SourceWalletPayload {
+  /** Optional display label (e.g. `"Wallet"`). When omitted the widget renders the address only. */
+  name?: string;
+  /** Wallet hex address. */
+  address: FormattedField<string>;
+  /** Block-explorer URL for `address.value`, when known. */
+  explorerUrl?: string;
+}
+/**
+ * Pending variant — a settlement has been observed but has not yet reached a terminal verdict.
+ * Drives `<ProcessingState>` and `<DepositStatusBanner>` "in-flight" rendering.
+ */
+interface SettlementPendingPayload {
+  kind: "pending";
+  sourceWallet: SourceWalletPayload;
+  creditedAsset: AssetPayload;
+  /** Brand label or destination address the deposit credits to. */
+  creditedTo: string;
+  /** Source-chain deposit tx hash, populated as soon as the indexer records `from.confirmed_at`. */
+  txHash?: FormattedField<string>;
+  /** Block-explorer URL for `txHash.value`. */
+  txExplorerUrl?: string;
+  /** Unix-ms timestamp the tx was detected on the source chain. */
+  detectedAt?: FormattedField<number>;
+  /**
+   * Unix-ms when the order was submitted to the gateway. Populates the "Order submitted" row on
+   * `<ProcessingState>` and the expanded `<DepositStatusBanner>`. Falls back to the settlement
+   * record's `created_at` when the indexer has not yet surfaced the source-chain confirmation.
+   */
+  submittedAt: FormattedField<number>;
+  /** Quoted receive amount captured at submit time, displayed during the pending window. */
+  receiveAmount: FormattedField<number>;
+}
+/**
+ * Succeeded variant — a settlement has reached the `completed` terminal verdict. Drives
+ * `<SuccessState>` and the success copy on `<DepositStatusBanner>`.
+ */
+interface SettlementSuccessPayload {
+  kind: "succeeded";
+  sourceWallet: SourceWalletPayload;
+  /** Destination receive descriptor — brand label + destination address. */
+  destination: {
+    name?: string;
+    address: FormattedField<string>;
+  };
+  creditedAsset: AssetPayload;
+  /** Final receive amount in display units. */
+  receiveAmount: FormattedField<number>;
+  /** Per-hop route metadata as a list of `(provider, chainId)` pairs the success widget renders. */
+  routeHops: ReadonlyArray<{
+    provider: string;
+    chainId: number;
+  }>;
+  /** Total time from submit to terminal verdict (formatted via {@link formatDurationCompact}). */
+  totalTime: FormattedField<number>;
+  /** Optional aggregator-provided explorer URL for the settlement (e.g. LIFI / Sushiswap link). */
+  aggregatorExplorerUrl?: string;
+  /** Source-chain deposit tx — what the user broadcast. */
+  depositTx: {
+    hash: FormattedField<string>;
+    explorerUrl?: string;
+  };
+  /** Destination-chain completion tx — populated once the bridge submits the receive leg. */
+  completionTx?: {
+    hash: FormattedField<string>;
+    explorerUrl?: string;
+  };
+  /** Unix-ms when the deposit was submitted. */
+  submittedAt: FormattedField<number>;
+  /** Unix-ms when the settlement reached `completed`. */
+  filledAt: FormattedField<number>;
+}
+/**
+ * Failed variant — a settlement reached the `failed` terminal verdict (often after retries).
+ * Drives `<ErrorState>` and the failure copy on `<DepositStatusBanner>`.
+ */
+interface SettlementFailurePayload {
+  kind: "failed";
+  /**
+   * Stable failure classification. The widget translates this into localized headline + reason
+   * copy via `useT()` — the driver does not emit free-text strings here.
+   */
+  failureKind: SettlementFailureKind;
+  sourceWallet: SourceWalletPayload;
+  destination: {
+    name?: string;
+    address: FormattedField<string>;
+  };
+  creditedAsset: AssetPayload;
+  receiveAmount: FormattedField<number>;
+  txHash: FormattedField<string>;
+  txExplorerUrl?: string;
+  submittedAt: FormattedField<number>;
+  failedAt: FormattedField<number>;
+}
+/**
+ * Discriminated union for the settlement entity. The same envelope drives `<ProcessingState>`
+ * (when `kind === "pending"`), `<SuccessState>` (`"succeeded"`), and `<ErrorState>` (`"failed"`).
+ */
+type SettlementPayload = SettlementPendingPayload | SettlementSuccessPayload | SettlementFailurePayload;
+//#endregion
+export { AcceptedAssetPayload, AddressItemPayload, AssetPayload, BalanceItemPayload, BrandPayload, ChainPayload, QuoteBreakdownPayload, QuotePayload, QuoteRoutePayload, SettlementFailurePayload, SettlementPayload, SettlementPendingPayload, SettlementSuccessPayload, SourceWalletPayload, TargetPayload, WalletInfo, WalletPayload };

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

@@ -0,0 +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};

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

@@ -0,0 +1 @@
+import{computeQuoteAttrs as e,formatRouteLabel as t}from"../../../shared/transformers/computeQuoteAttrs.js";import{formatNetworkName as n}from"../../../../shared/format/formatNetworkName.js";import{formatPercent as r}from"../../../../shared/format/formatPercent.js";import{formatTokenAmount as i}from"../../../../shared/format/formatTokenAmount.js";import{formatUsd as a}from"../../../../shared/format/formatUsd.js";function o(o,s){let c=e(o,{sourceAmount:s.sourceAmount,sendDecimals:s.sendSide.decimals,sendSymbol:s.sendSide.symbol,receiveDecimals:s.receiveSide.decimals,receiveSymbol:s.receiveSide.symbol,...s.sendPriceUsd===void 0?{}:{sendPriceUsd:s.sendPriceUsd},...s.receivePriceUsd===void 0?{}:{receivePriceUsd:s.receivePriceUsd},now:s.now}),l=c.sendAmountUsd??s.sourceAmount,u={};o.route.provider&&(u.selectedRoute={provider:o.route.provider,scenario:o.route.scenario??``,label:t(o.route.provider,o.route.scenario)}),c.networkCostUsd!==void 0&&(u.networkCost={value:c.networkCostUsd,formatted:a(c.networkCostUsd,s.i18n)}),c.priceImpactPercent!==void 0&&(u.priceImpact={value:c.priceImpactPercent,formatted:r(c.priceImpactPercent,s.i18n)});let d={...s.sendSide,networkName:n(s.sendSide.networkName)},f={...s.receiveSide,networkName:n(s.receiveSide.networkName)};return{heroAmountUsd:{value:l,formatted:a(l,s.i18n)},sendAsset:d,sendAmount:{value:s.sourceAmount,formatted:i(s.sourceAmount,s.i18n,{maxDecimals:s.sendSide.decimals})},receiveAsset:f,receiveAmount:{value:c.receiveAmount,formatted:i(c.receiveAmount,s.i18n,{maxDecimals:s.receiveSide.decimals})},quoteTotalSeconds:30,expiresAt:Math.min(c.expiresAt,s.now+30*1e3),etaSeconds:c.etaSeconds,...Object.keys(u).length>0?{breakdown:u}:{}}}export{o as quoteToPayload};