@stridge/kit 0.1.0-alpha.0

package/dist/drivers/stridge/rpc.d.ts

@@ -0,0 +1,77 @@
+//#region src/drivers/stridge/rpc.d.ts
+/**
+ * Internal Stridge driver RPC.
+ *
+ * Stridge nodes are used here ONLY for receipt polling of the tx the driver itself just
+ * broadcast. They are deliberately not exposed as a public helper / wagmi transport — host apps
+ * own their own wagmi config and generic RPC traffic. This boundary keeps Stridge from
+ * accidentally absorbing 200k+ unrelated requests/day from a host's full app.
+ *
+ * Future backend work will replace this browser-direct call with a payment-intent-scoped RPC
+ * token + per-intent rate limit; the current scope only addresses accidental abuse from global
+ * host traffic.
+ *
+ * Implementation note: HTTP + JSON-RPC mechanics ride on viem's `http()` transport and `Client`.
+ * We don't use viem's `waitForTransactionReceipt` — it doesn't accept an `AbortSignal` and would
+ * keep the underlying `watchBlockNumber` observer running after the caller stops awaiting. The
+ * tight abort semantics matter here (the kit cancels the wait when the dialog closes), so we
+ * keep our own poll loop on top of viem's typed actions.
+ */
+/**
+ * Subdomain slug for the Stridge nodes proxy. The proxy exposes every chain at two equivalent
+ * subdomains — both route through the same provider list with identical failover behavior. See
+ * `stridge-foundation/nodes-proxy`:
+ *
+ *   - **number** — the EIP-155 chain id (`1`, `56`, `137`, `42161`, `8453`, `11155111`, …).
+ *     Use this for EVM chains, where `chain_type === "EVM"` in the supportedAssets catalog.
+ *   - **string** — the proxy's chain-name slug (`"eth"`, `"solana"`, `"bsc"`, …). Required for
+ *     chains without an EIP-155 id (e.g. Solana — `chain_type === "SOL"`).
+ *
+ * The Stridge driver passes the EIP-155 id today (every supported flow is EVM). A future
+ * non-EVM driver passes the catalog's `network_symbol` instead.
+ */
+type StridgeChainSlug = number | string;
+interface StridgeRpcConfig {
+  /**
+   * Optional advanced override for tests / self-hosted proxy. Defaults to
+   * `https://${chain}.nodes.stridge.com`. Must contain the literal `${chain}` placeholder,
+   * which is replaced with the EIP-155 id (numeric form) or the chain-name slug (string form).
+   *
+   * Not a general host wagmi transport — only consumed by the Stridge driver's own payment-tx
+   * receipt polling.
+   */
+  template?: string;
+  /**
+   * Per-request fetch timeout in ms. Defaults to {@link DEFAULT_TIMEOUT_MS}. Each poll iteration
+   * uses this independently — `waitForTransactionReceipt` keeps retrying until the caller's
+   * `signal` aborts.
+   */
+  timeoutMs?: number;
+}
+interface StridgeRpcWaitInput {
+  /** EIP-155 id for EVM chains, or chain-name slug for non-EVM (see {@link StridgeChainSlug}). */
+  chain: StridgeChainSlug;
+  hash: `0x${string}`;
+  /** Confirmations to wait on before resolving. Defaults to 1. */
+  confirmations?: number;
+  /** Polling cadence between `eth_getTransactionReceipt` calls. Defaults to 1000ms. */
+  pollingIntervalMs?: number;
+  signal: AbortSignal;
+}
+interface StridgeRpc {
+  /**
+   * Poll Stridge nodes via JSON-RPC until the broadcast tx is mined to the requested
+   * confirmation depth. Resolves with the receipt's `transactionHash` (captures wallet
+   * replacements like speed-ups / cancels where the mined hash diverges from the broadcast hash).
+   */
+  waitForTransactionReceipt(input: StridgeRpcWaitInput): Promise<`0x${string}`>;
+}
+/**
+ * Build the Stridge driver's RPC client. Internal — surfaced via
+ * {@link import("./types").StridgeDriverConfig.rpc} for tests / advanced injection only. Not a
+ * general-purpose wagmi transport; the driver scopes Stridge nodes to receipt polling for txs it
+ * itself broadcast.
+ */
+declare function createStridgeRpc(config?: StridgeRpcConfig): StridgeRpc;
+//#endregion
+export { StridgeChainSlug, StridgeRpc, StridgeRpcConfig, StridgeRpcWaitInput, createStridgeRpc };

package/dist/drivers/stridge/rpc.js

@@ -0,0 +1 @@
+import{createClient as e,hexToNumber as t,http as n}from"viem";import{getTransactionReceipt as r}from"viem/actions";const i="${chain}";function a(t={}){let i=t.template,a=t.timeoutMs??1e4,l=new Map;function f(t){let r=c(t,i),o=l.get(r);return o||(o=e({transport:n(r,{timeout:a,retryCount:0})}),l.set(r,o)),o}return{async waitForTransactionReceipt(e){let{chain:t,hash:n,signal:i}=e,a=e.confirmations??1,c=e.pollingIntervalMs??1e3,l=f(t);for(u(i);;){let e=null;try{e=await r(l,{hash:n})}catch(e){if(!s(e))throw e}if(e){if(a<=1)return e.transactionHash??n;let t=await o(l),r=e.blockNumber;if((t>=r?t-r+1n:0n)>=BigInt(a))return e.transactionHash??n}await d(c,i)}}}}async function o(e){let n=await e.request({method:`eth_blockNumber`});return BigInt(t(n))}function s(e){return e instanceof Error&&e.name===`TransactionReceiptNotFoundError`}function c(e,t){let n=l(e);if(t!==void 0){if(!t.includes(i))throw Error(`Stridge RPC: template must contain the literal "${i}" placeholder.`);return t.replace(i,n)}return`https://${n}.nodes.stridge.com`}function l(e){if(typeof e==`number`){if(!Number.isInteger(e)||e<=0)throw Error(`Stridge RPC: numeric chain id must be a positive integer (got ${e}).`);return String(e)}if(typeof e!=`string`||!/^[a-z0-9][a-z0-9-]*$/.test(e))throw Error(`Stridge RPC: chain name slug must be lowercase letters, digits, or dashes (got ${JSON.stringify(e)}).`);return e}function u(e){if(e.aborted)throw new DOMException(`Aborted`,`AbortError`)}function d(e,t){return new Promise((n,r)=>{if(t.aborted){r(new DOMException(`Aborted`,`AbortError`));return}let i=setTimeout(()=>{t.removeEventListener(`abort`,a),n()},e),a=()=>{clearTimeout(i),t.removeEventListener(`abort`,a),r(new DOMException(`Aborted`,`AbortError`))};t.addEventListener(`abort`,a,{once:!0})})}export{a as createStridgeRpc};

package/dist/drivers/stridge/types.d.ts

@@ -0,0 +1,145 @@
+import { ConfirmTransferToken } from "../../shared/widgets/confirm-transfer/compound/types.js";
+import { StridgeRpc } from "./rpc.js";
+import * as _$react from "react";
+import { Config } from "wagmi";
+
+//#region src/drivers/stridge/types.d.ts
+/**
+ * Token metadata passed to {@link StridgeDriverConfig.resolveTokenIcon}.
+ */
+interface StridgeTokenIconResolverEntry {
+  chainId: number;
+  tokenAddress: string;
+  symbol: string;
+  isNative: boolean;
+}
+/**
+ * Optional polling cadence overrides for Stridge subscriptions.
+ */
+interface StridgePollIntervals {
+  /** While the kit is in `transferCrypto` waiting for the first deposit. Defaults to `2000`. */
+  detectionMs?: number;
+  /** While the kit is in `processing` and the settlement is not yet terminal. Defaults to `2000`. */
+  processingMs?: number;
+  /** Once the settlement has reached `completed` or `failed`. Defaults to `10_000`. */
+  terminalMs?: number;
+  /** Source-balance refresh cadence. Defaults to `60_000`. */
+  balancesMs?: number;
+}
+/**
+ * API host the driver targets. `"production"` (default) routes through `api.stridge.com`;
+ * `"staging"` routes through `api.stridge.dev`. The kit accepts these friendly names so hosts
+ * never have to thread the SDK's internal `"prod" | "dev"` terminology through their config.
+ */
+type StridgeEnvironment = "production" | "staging";
+/** Default {@link StridgeEnvironment} when {@link StridgeDriverConfig.environment} is omitted. */
+declare const STRIDGE_DEFAULT_ENVIRONMENT = "production";
+/**
+ * Default low-balance / amount-entry floor in USD used when {@link StridgeDriverConfig.minDepositUsd}
+ * is omitted. Hosts can override per project (some perp DEXes want a higher floor than $3).
+ */
+declare const STRIDGE_DEFAULT_MIN_DEPOSIT_USD = 3;
+/**
+ * Settlement destination for `gateway/start`. Mirrors the wire shape so hosts don't have to reach
+ * for the SDK's `GatewayStartRequest.destination` type — every field corresponds 1:1.
+ */
+interface StridgeDriverDestination {
+  /** Stridge network id (string-encoded). E.g. `"60"` for Ethereum mainnet, `"9006"` for BSC. */
+  network_id: string;
+  /** Destination asset symbol (e.g. `"USDC"`, `"USDT"`). */
+  asset_symbol: string;
+  /**
+   * Settlement recipient address. Defaults to {@link StridgeDriverConfig.userAddress} (same-owner
+   * pattern — the gateway enforces this server-side for projects without a destination override).
+   * Pass an explicit value when the host routes settlements to a different account than the
+   * connected wallet.
+   */
+  to_address?: string;
+}
+/**
+ * Configuration accepted by {@link createStridgeDriver}.
+ */
+interface StridgeDriverConfig {
+  /** Connected wallet EOA. Threaded as `gateway/start.owner` and (by default) as the settlement recipient. */
+  userAddress: string;
+  /**
+   * Stridge project key — sent as `X-Gateway-Key` by the SDK's HttpClient.
+   * Pull from your workspace dashboard (Developer → Gateway Kit → Connection).
+   */
+  projectKey: string;
+  /**
+   * Which Stridge API host to target. Defaults to {@link STRIDGE_DEFAULT_ENVIRONMENT}
+   * (`"production"` → `api.stridge.com`). Pass `"staging"` to route through `api.stridge.dev`
+   * for integration testing — note that staging gateway keys won't authenticate against
+   * production and vice versa.
+   */
+  environment?: StridgeEnvironment;
+  /**
+   * Settle destination for the wallet flow's `gateway/start` payload. The kit was hardcoded to
+   * `USDC` on Ethereum at first; making this required at the config layer lets each host pick
+   * its own pair (e.g. BSC USDC for a BSC-native merchant) without forking the driver.
+   */
+  destination: StridgeDriverDestination;
+  /**
+   * Low-balance / amount-entry USD floor. Drives the asset-picker's "Low balance" pill and the
+   * amount-entry hero's `min` / `initialAmount` (via {@link toKitTarget}). Defaults to
+   * {@link STRIDGE_DEFAULT_MIN_DEPOSIT_USD} when omitted.
+   */
+  minDepositUsd?: number;
+  /**
+   * Optional metadata persisted on the UDA at `gateway/start` time. Echoed back on
+   * `gateway/{owner}` and webhook payloads. Treat as untrusted display data.
+   */
+  metadata?: Record<string, unknown>;
+  /**
+   * Per-chain block-explorer base URL keyed by EIP-155 id. The driver appends `/tx/{hash}` to the
+   * matching entry when building `TxRef.explorerUrl`. Hosts typically derive this map from `viem`
+   * chain definitions; the driver itself doesn't bundle one.
+   */
+  explorers?: Record<number, string>;
+  /**
+   * Optional icon resolver for source assets. Returning `undefined` falls back to upstream logos.
+   */
+  resolveTokenIcon?: (entry: StridgeTokenIconResolverEntry) => string | undefined;
+  /** Polling cadence overrides. */
+  pollIntervals?: StridgePollIntervals;
+  /**
+   * Wagmi config used to sign and broadcast transfers. Receipt polling is intentionally NOT
+   * routed through this — the driver uses an internal Stridge RPC client (see `rpc.ts`) so
+   * deposits don't depend on the host's wagmi public client (which falls
+   * through to viem's hard-coded public defaults — unreliable for live tx flow).
+   */
+  wagmiConfig: Config;
+  /**
+   * Advanced escape hatch: inject a custom Stridge RPC client (e.g. for tests or a self-hosted
+   * proxy). Defaults to a client that targets `https://${chainId}.nodes.stridge.com`.
+   *
+   * This is driver-internal RPC — NOT a general-purpose host wagmi transport. Stridge nodes are
+   * scoped to receipt polling for the tx the driver itself just submitted; do not use this
+   * hatch to fan out arbitrary host-app reads.
+   */
+  rpc?: StridgeRpc;
+  /**
+   * Block confirmations to wait on before the kit treats the broadcast tx as mined. Defaults to `1`,
+   * which is appropriate for almost every chain the gateway supports. Forwarded to the Stridge
+   * RPC client.
+   */
+  receiptConfirmations?: number;
+  /**
+   * Receipt polling interval in milliseconds while waiting for mining. Forwarded to the Stridge
+   * RPC client.
+   */
+  receiptPollingIntervalMs?: number;
+  /**
+   * Optional display overrides for confirm-deposit labels and icons.
+   */
+  confirmDisplay?: {
+    sourceLabel?: string;
+    sourceIcon?: _$react.ReactNode;
+    destinationLabel?: string;
+    destinationIcon?: _$react.ReactNode;
+    receiveToken?: ConfirmTransferToken;
+  };
+}
+//#endregion
+export { STRIDGE_DEFAULT_ENVIRONMENT, STRIDGE_DEFAULT_MIN_DEPOSIT_USD, StridgeDriverConfig, StridgeDriverDestination, StridgeEnvironment, StridgePollIntervals, StridgeTokenIconResolverEntry };

package/dist/drivers/stridge/types.js

@@ -0,0 +1 @@
+const e=`production`,t=3;export{e as STRIDGE_DEFAULT_ENVIRONMENT,t as STRIDGE_DEFAULT_MIN_DEPOSIT_USD};

package/dist/drivers/stridge/wagmiSigner.js

@@ -0,0 +1 @@
+import{numberToHex as e}from"viem";import{getAccount as t,getConnectorClient as n,switchChain as r}from"wagmi/actions";function i(i){return{async signAndBroadcastStep(o,s){a(s);let c=t(i.wagmiConfig);if(!c.address)throw Error(`Connect a wallet to sign and submit the deposit.`);c.chainId!==o.chainId&&await r(i.wagmiConfig,{chainId:o.chainId}),a(s);let l=o.from??c.address;if(!l)throw Error(`Stridge driver: no connected wallet address available to broadcast the deposit tx.`);return await(await n(i.wagmiConfig,{chainId:o.chainId})).request({method:`eth_sendTransaction`,params:[{from:l,to:o.to,data:o.data,value:e(o.value),chainId:e(o.chainId)}]})}}}function a(e){if(e.aborted)throw new DOMException(`Aborted`,`AbortError`)}export{i as createWagmiSigner};

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

@@ -0,0 +1,120 @@
+import { WalletInfo } from "../../flows/deposit/driver/payloads.js";
+import { DepositDriver, DepositSnapshot } from "../../flows/deposit/driver/types.js";
+import { MockAssetSelection } from "./fixtures.js";
+import { MockTriggers } from "./triggers.js";
+import { I18n } from "@lingui/core";
+
+//#region src/drivers/stridge-mock/createStridgeMockDriver.d.ts
+/**
+ * Per-call latency budgets the mock driver imposes to mirror production cadence — a quote
+ * round-trip feels like ~1.4s, the wallet signature loop runs ~4s, the source-chain detection
+ * lands ~4s after submit, and the terminal settlement verdict resolves ~3s after pending. Hosts
+ * can override individual fields when scripting tests / Storybook scenarios that need
+ * tighter / longer windows.
+ */
+interface MockDriverLatency {
+  /** `requestQuote` resolves after this many ms. */
+  quote?: number;
+  /** `submitDeposit` (signature loop) resolves after this many ms. */
+  submit?: number;
+  /** Time between `submitDeposit` returning and the settlement entity flipping to `pending`. */
+  processingPendingDelay?: number;
+  /** Time between `pending` and the terminal verdict (`succeeded` / `failed`). */
+  processingTerminal?: number;
+  /** Path B — `watchSourceTx` listener fires after this many ms. */
+  transferDetected?: number;
+}
+/**
+ * Configuration for {@link createStridgeMockDriver}. Every field is optional — calling the
+ * factory with no arguments produces a fully seeded driver against the bundled captured-production
+ * fixtures.
+ */
+interface CreateStridgeMockDriverInput {
+  /**
+   * Stable `I18n` ref-getter. The driver re-runs transformers on read so locale flips don't
+   * re-bootstrap. When omitted, falls back to the kit's English-only {@link defaultI18n}
+   * — useful for tests that don't mount a `<KitProvider>`.
+   */
+  getI18n?: () => I18n;
+  /** Connected wallet info. When omitted, defaults to {@link DEFAULT_WALLET_INFO}. */
+  wallet?: WalletInfo;
+  /** Optional minimum-deposit USD floor surfaced on `target.payload.minDepositUsd`. */
+  minDepositUsd?: number;
+  /**
+   * Settlement-destination override — a `{ chain, symbol }` selector resolved against the
+   * mock's bundled catalog ({@link SAMPLE_DEPOSIT_CHAINS} via {@link resolveMockAsset}). Drives
+   * `target` / `quote.receiveAsset` / `settlement.creditedAsset` so the dialog renders against
+   * the chosen destination instead of the default USDC-on-BSC fixture. Unknown combinations
+   * fall back to USDC on BSC so the picker can never crash the playground.
+   */
+  asset?: MockAssetSelection;
+  /**
+   * Initial entity-store overrides. Merged per-key with a shallow spread — keys present here
+   * replace the bundled-fixture entity wholesale, so each value must be a complete
+   * {@link Entity} envelope (or one of the empty `{ status: "idle" | "loading" }` variants).
+   * Omitted keys keep the bundled fixture. Used by canvas cards / Storybook to seed a static
+   * state.
+   */
+  initialState?: Partial<DepositSnapshot>;
+  /**
+   * Per-call latency overrides — demos / Storybook scenarios that need tighter (or longer)
+   * windows can tweak individual fields. Defaults match production-feel cadence; tests should
+   * pass `{ quote: 0, submit: 0, … }` so the FSM walks through deterministically without
+   * `vi.useFakeTimers`.
+   */
+  latency?: MockDriverLatency;
+  /**
+   * Terminal verdict the driver auto-transitions to after the user submits a deposit. Defaults
+   * to `"succeeded"` so the happy path runs end-to-end. Set `"failed"` to exercise the failure
+   * branch, or `"none"` to leave the settlement in `pending` (callers drive terminals via
+   * `triggers` instead).
+   */
+  autoSettleTo?: "succeeded" | "failed" | "none";
+  /**
+   * When set, calling `triggers.triggerSettlementPending()` schedules a follow-up
+   * `triggers.triggerSettlementSuccess()` after this many ms — keeps the prototype loop short
+   * for the canvas / headless trigger panels. Defaults to 3500. Pass `null` to disable (tests
+   * that want to inspect the pending state in isolation should opt out).
+   */
+  pendingTriggerToSuccessMs?: number | null;
+}
+/**
+ * Result of {@link createStridgeMockDriver}. The `driver` value satisfies {@link DepositDriver} and is
+ * the only argument `<KitProvider deposit={…} />` cares about. The `triggers` value is mock-only —
+ * the canvas-mode panel and Storybook control surfaces use it to mutate entity state without
+ * driving the full happy path.
+ */
+interface MockDriverHandle {
+  driver: DepositDriver;
+  triggers: MockTriggers;
+}
+/**
+ * Build a programmatic {@link DepositDriver} backed by deterministic in-memory state. Used by demos,
+ * tests, Storybook, and any `<KitProvider />` mount that doesn't have a Stridge gateway key
+ * available. Realistic captured-production fixtures pre-seed every entity so widgets render
+ * straight away — no orchestrated walk-through required to populate the dialog.
+ *
+ * The factory's two return values separate the contract surface from the mock-specific
+ * affordances:
+ *
+ * - `driver` — a clean {@link DepositDriver}. Pass to `<KitProvider />`. Production code never sees
+ *   anything else.
+ * - `triggers` — mock-only {@link MockTriggers}. Pass to canvas / Storybook panels; never to
+ *   `<KitProvider />`.
+ *
+ * @example
+ *
+ * ```tsx
+ * import { createStridgeMockDriver } from "@stridge/kit/drivers/stridge-mock";
+ *
+ * const { driver, triggers } = createStridgeMockDriver({ getI18n: () => i18n });
+ *
+ * <KitProvider deposit={driver}>
+ *     <DepositDialog />
+ *     <DemoTriggerPanel triggers={triggers} />
+ * </KitProvider>;
+ * ```
+ */
+declare function createStridgeMockDriver(input?: CreateStridgeMockDriverInput): MockDriverHandle;
+//#endregion
+export { CreateStridgeMockDriverInput, MockDriverHandle, createStridgeMockDriver };

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

@@ -0,0 +1 @@
+import{defaultI18n as e}from"../../shared/i18n/defaultI18n.js";import{shortenAddress as t}from"../../shared/format/shortenAddress.js";import{createEntityStore as n}from"./store.js";import{DEFAULT_BRAND_PAYLOAD as r,DEFAULT_WALLET_INFO as i,STUB_DEPOSIT_ADDRESSES_RAW as a,STUB_GATEWAY_POLL_RESPONSE as o,STUB_GATEWAY_SETTLEMENT_DTO as s,STUB_GATEWAY_START_RESPONSE as c,STUB_ONCHAIN_BALANCE_RESPONSE as l,STUB_QUOTE_RESPONSE as u,STUB_SUPPORTED_ASSETS_RESPONSE as d,buildDefaultAddressesPayload as f,buildDefaultBalances as p,buildDefaultFailurePayload as m,buildDefaultPendingPayload as h,buildDefaultQuotePayload as g,buildDefaultSuccessPayload as _,buildDefaultTargetPayload as v,buildDefaultTargetRaw as y,buildDefaultWalletPayload as b,resolveMockAsset as x}from"./fixtures.js";const S={quote:1400,submit:4e3,processingPendingDelay:1500,processingTerminal:3e3,transferDetected:4e3};function C(r={}){let a=r.getI18n??(()=>e),c=r.wallet??i,l=x(r.asset),d=n(w(a(),c,r.minDepositUsd,l,r.initialState)),f={...S,...r.latency??{}},p=r.autoSettleTo??`succeeded`,v=r.pendingTriggerToSuccessMs===void 0?3500:r.pendingTriggerToSuccessMs,y=new Set,b=new Set,C=new Set,E=!1,D,O;function k(){D!==void 0&&(clearTimeout(D),D=void 0),O!==void 0&&(clearTimeout(O),O=void 0),E=!1}function A(){if(E)return;E=!0;let e=a();D=setTimeout(()=>{D=void 0;let t={status:`ready`,payload:h(e,l),raw:s,response:o};d.update({settlement:t});for(let e of y)e(t);O=setTimeout(()=>{if(O=void 0,p===`succeeded`){let t={status:`ready`,payload:_(e,l),raw:s,response:o};d.update({settlement:t});for(let e of y)e(t)}else if(p===`failed`){let t={status:`ready`,payload:m(e,void 0,l),raw:s,response:o};d.update({settlement:t});for(let e of y)e(t)}E=!1},f.processingTerminal)},f.processingPendingDelay)}let j={getSnapshot(){return d.getSnapshot()},subscribe(e){return d.subscribe(e)},async requestQuote(e,t){d.update({quote:{status:`loading`}}),await T(f.quote,t);let n=a(),r=Date.now()+3e4;d.update({quote:{status:`ready`,payload:g(n,r,l),raw:u,response:u}})},async submitDeposit(e,t){return await T(f.submit,t),p!==`none`&&A(),{hash:`0x1d72b900dd9b4f9fb0e11c14978d9cbbff7b47db0b820911839aad7081f6b72a`,explorerUrl:`https://etherscan.io/tx/0x1d72b900dd9b4f9fb0e11c14978d9cbbff7b47db0b820911839aad7081f6b72a`}},watchBalances(e,t,n){C.add(t);let r=d.getSnapshot().balances;queueMicrotask(()=>{n.aborted||t(r)}),n.addEventListener(`abort`,()=>C.delete(t),{once:!0})},watchSourceTx(e,t,n){b.add(t);let r=setTimeout(()=>{n.aborted||t({hash:`0x1d72b900dd9b4f9fb0e11c14978d9cbbff7b47db0b820911839aad7081f6b72a`,explorerUrl:`https://etherscan.io/tx/0x1d72b900dd9b4f9fb0e11c14978d9cbbff7b47db0b820911839aad7081f6b72a`})},f.transferDetected);n.addEventListener(`abort`,()=>{clearTimeout(r),b.delete(t)},{once:!0})},watchSettlement(e,t,n){y.add(t);let r=d.getSnapshot().settlement;queueMicrotask(()=>{n.aborted||t(r)}),n.addEventListener(`abort`,()=>y.delete(t),{once:!0})},async fetchActiveSettlement(e,t){let n=d.getSnapshot().settlement;return n.status!==`ready`||n.payload.kind!==`pending`?null:{payload:n.payload,raw:n.raw,response:n.response}}},M=0,N=null;function P(){N!==null&&(clearTimeout(N),N=null)}function F(e){M+=1;let n=`0x${M.toString(16).padStart(8,`0`)}${e.value.length>10?e.value.slice(10):`0`.repeat(56)}`;return{value:n,formatted:t(n)}}function I(e,t){if(e)return e.replace(/(\/tx\/|\/address\/)(0x[0-9a-fA-F]+)/,(e,n)=>`${n}${t}`)}let L={triggerSettlementPending(e){let t=h(a(),l),n=t.txHash?F(t.txHash):void 0,r=n?I(t.txExplorerUrl,n.value):void 0,i={status:`ready`,payload:{...t,...n?{txHash:n}:{},...r?{txExplorerUrl:r}:{},...e},raw:s,response:o};P(),d.update({settlement:i});for(let e of y)e(i);v!==null&&v>=0&&(N=setTimeout(()=>{N=null,L.triggerSettlementSuccess()},v))},triggerSettlementSuccess(e){P();let t=_(a(),l),n=F(t.depositTx.hash),r=I(t.depositTx.explorerUrl,n.value),i={status:`ready`,payload:{...t,depositTx:{...t.depositTx,hash:n,...r?{explorerUrl:r}:{}},...e},raw:s,response:o};d.update({settlement:i});for(let e of y)e(i)},triggerSettlementFailure(e,t){P();let n=m(a(),e,l),r=F(n.txHash),i=I(n.txExplorerUrl,r.value),c={status:`ready`,payload:{...n,txHash:r,...i?{txExplorerUrl:i}:{},...t},raw:s,response:o};d.update({settlement:c});for(let e of y)e(c)},triggerQuoteFailure(e){d.update({quote:{status:`error`,error:e}})},reset(){P(),k(),d.replace(w(a(),c,r.minDepositUsd,l,r.initialState))}};return{driver:j,triggers:L}}function w(e,t,n,i,o){let s={brand:{status:`ready`,payload:r,raw:c.metadata,response:c},target:{status:`ready`,payload:v(e,n,i),raw:y(i),response:d},addresses:{status:`ready`,payload:f(e,n),raw:a,response:c},balances:{status:`ready`,payload:p(e),raw:l,response:l},quote:{status:`idle`},settlement:{status:`idle`},wallet:{status:`ready`,payload:b(e,t),raw:t,response:t}};return o?{...s,...o}:s}function T(e,t){return new Promise((n,r)=>{if(t.aborted){r(E());return}let i=setTimeout(()=>{t.removeEventListener(`abort`,a),n()},e),a=()=>{clearTimeout(i),r(E())};t.addEventListener(`abort`,a,{once:!0})})}function E(){if(typeof DOMException==`function`)return new DOMException(`Aborted`,`AbortError`);let e=Error(`Aborted`);return e.name=`AbortError`,e}export{C as createStridgeMockDriver};

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

@@ -0,0 +1,118 @@
+import { SettlementFailureKind } from "../../shared/driver/types.js";
+import { WithdrawableBalanceItemPayload, WithdrawalQuotePayload, WithdrawalSettlementFailurePayload, WithdrawalSettlementPendingPayload, WithdrawalSettlementSuccessPayload } from "../../flows/withdraw/driver/payloads.js";
+import { WithdrawDriver, WithdrawSnapshot } from "../../flows/withdraw/driver/types.js";
+import { MockAsset, MockAssetSelection } from "./fixtures.js";
+import { I18n } from "@lingui/core";
+
+//#region src/drivers/stridge-mock/createStridgeMockWithdrawDriver.d.ts
+declare const DEFAULT_LATENCY: {
+  /** `requestQuote` resolves after this many ms. */quote: number; /** `submitWithdrawal` resolves after this many ms. */
+  submit: number; /** Time between `submitWithdrawal` returning and the settlement entity flipping to `pending`. */
+  processingPendingDelay: number; /** Time between `pending` and the terminal verdict. */
+  processingTerminal: number;
+};
+/**
+ * Bundled fixture: a single withdrawable USDC@BSC row matching the V2 mock + apps/demo currency.
+ * Hosts that need richer balances pass them through `initialState.withdrawableBalances`.
+ */
+declare function buildDefaultWithdrawableBalances(asset?: MockAsset): ReadonlyArray<WithdrawableBalanceItemPayload>;
+/**
+ * Bundled fixture: a static withdrawal quote shaped to the V2 mockup numbers ($0.00 network
+ * cost, 0.00% price impact). Mirrors deposit's confirm-deposit breakdown chrome — same items.
+ */
+declare function buildDefaultWithdrawalQuotePayload(amount?: number, asset?: MockAsset): WithdrawalQuotePayload;
+/**
+ * Bundled fixture: a pending settlement keyed off the V2 mockup recipient + tx hash. The
+ * `i18n` argument drives `formatTimestamp` so the row reads the same locale-aware short form
+ * deposit's mock uses (`May 7, 18:54`) instead of an ISO blob.
+ */
+declare function buildDefaultWithdrawalPendingPayload(i18n?: I18n, amount?: number, recipient?: string, txHashValue?: string, asset?: MockAsset): WithdrawalSettlementPendingPayload;
+/** Bundled fixture: a succeeded settlement matching V2-6 (14 seconds total time). */
+declare function buildDefaultWithdrawalSuccessPayload(i18n?: I18n, amount?: number, recipient?: string, totalTimeSeconds?: number, txHashValue?: string, asset?: MockAsset, completionTxValue?: string): WithdrawalSettlementSuccessPayload;
+/** Bundled fixture: a failed settlement of the requested kind. */
+declare function buildDefaultWithdrawalFailurePayload(i18n?: I18n, failureKind?: SettlementFailureKind, amount?: number, recipient?: string, txHashValue?: string, asset?: MockAsset): WithdrawalSettlementFailurePayload;
+/**
+ * Imperative trigger surface returned alongside the {@link WithdrawDriver} from
+ * {@link createStridgeMockWithdrawDriver}. Mock-specific affordances live here so the kit's
+ * `WithdrawDriver` interface stays untouched by demo / canvas-tile concerns.
+ */
+interface MockWithdrawTriggers {
+  /** Flip `settlement` to `pending`. Drives the V2-5 in-progress screen. */
+  triggerWithdrawalInProgress(partial?: Partial<WithdrawalSettlementPendingPayload>): void;
+  /** Flip `settlement` to `succeeded`. Drives the V2-6 success screen. */
+  triggerWithdrawalSuccess(partial?: Partial<WithdrawalSettlementSuccessPayload>): void;
+  /** Flip `settlement` to `failed`. Drives the temporary error screen. */
+  triggerWithdrawalFailed(failureKind: SettlementFailureKind, partial?: Partial<WithdrawalSettlementFailurePayload>): void;
+  /** Flip `quote` to `error`. */
+  triggerQuoteFailure(error: Error): void;
+  /** Restore the snapshot the factory was constructed with. Cancels any auto-settle timers. */
+  reset(): void;
+}
+/**
+ * Return value of {@link createStridgeMockWithdrawDriver} — the driver itself plus the mock
+ * trigger surface for canvas tiles / Storybook controls / tests.
+ */
+interface MockWithdrawDriverHandle {
+  driver: WithdrawDriver;
+  triggers: MockWithdrawTriggers;
+}
+interface CreateStridgeMockWithdrawDriverInput {
+  /**
+   * Initial entity-store overrides. Merged per-key — keys present here replace the bundled
+   * fixture wholesale, so each value must be a complete {@link Entity} envelope (or one of
+   * the empty `{ status: "idle" | "loading" }` variants). Omitted keys keep the bundled
+   * fixture (one withdrawable USDC@BSC row, the default receive-options catalog, idle quote,
+   * idle settlement). Used by canvas cards / Storybook to seed a static state.
+   */
+  initialState?: Partial<WithdrawSnapshot>;
+  /**
+   * Per-call latency overrides. Defaults match production-feel cadence; tests should pass
+   * `{ quote: 0, submit: 0, … }` so the FSM walks through deterministically without
+   * `vi.useFakeTimers`.
+   */
+  latency?: Partial<typeof DEFAULT_LATENCY>;
+  /**
+   * Terminal verdict the driver auto-transitions to after the user submits. Defaults to
+   * `"succeeded"` so the happy path runs end-to-end. Set `"failed"` to exercise the failure
+   * branch, or `"none"` to leave the settlement in `pending` and let `triggers` drive
+   * terminals.
+   */
+  autoSettleTo?: "succeeded" | "failed" | "none";
+  /**
+   * Demo affordance — when a canvas tile fires `triggers.triggerWithdrawalInProgress()`,
+   * schedule an automatic `triggerWithdrawalSuccess()` this many ms later. Pass `null` to
+   * disable. Defaults to {@link DEFAULT_PENDING_TRIGGER_TO_SUCCESS_MS}.
+   */
+  pendingTriggerToSuccessMs?: number | null;
+  /**
+   * Ref-getter for the active `I18n` instance. Read at payload-build time so timestamp /
+   * duration formatting (`formatTimestamp`, `formatDurationCompact`) tracks locale flips
+   * without re-bootstrapping the driver. Defaults to the kit's English-only `defaultI18n`.
+   */
+  getI18n?: () => I18n;
+  /**
+   * Settlement asset override — same shape as the deposit factory's `asset` field. Drives the
+   * withdrawable-balance row, the quote receive-side, and every settlement banner so the
+   * picker's `(chain, symbol)` is reflected end-to-end. Unknown combinations fall back to USDC
+   * on BSC via {@link resolveMockAsset}.
+   */
+  asset?: MockAssetSelection;
+}
+/**
+ * Deterministic in-memory {@link WithdrawDriver} backed by the V2 mockup fixtures. Used by
+ * canvas tiles, Storybook, tests, and any `<KitProvider />` mount that doesn't have a Stridge
+ * gateway. Returns the driver alongside the imperative trigger surface for canvas-only
+ * affordances.
+ *
+ * @example
+ * ```tsx
+ * import { createStridgeMockWithdrawDriver } from "@stridge/kit/drivers/stridge-mock";
+ *
+ * const { driver, triggers } = createStridgeMockWithdrawDriver();
+ * <KitProvider withdraw={driver}>...</KitProvider>;
+ * triggers.triggerWithdrawalInProgress();
+ * ```
+ */
+declare function createStridgeMockWithdrawDriver(input?: CreateStridgeMockWithdrawDriverInput): MockWithdrawDriverHandle;
+//#endregion
+export { CreateStridgeMockWithdrawDriverInput, MockWithdrawDriverHandle, MockWithdrawTriggers, buildDefaultWithdrawableBalances, buildDefaultWithdrawalFailurePayload, buildDefaultWithdrawalPendingPayload, buildDefaultWithdrawalQuotePayload, buildDefaultWithdrawalSuccessPayload, createStridgeMockWithdrawDriver };

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

@@ -0,0 +1 @@
+"use client";import{defaultI18n as e}from"../../shared/i18n/defaultI18n.js";import{formatDurationCompact as t}from"../../shared/format/formatDurationCompact.js";import{formatTimestamp as n}from"../../shared/format/formatTimestamp.js";import{shortenAddress as r}from"../../shared/format/shortenAddress.js";import{supportedAssetsToReceiveOptionsPayload as i}from"../../flows/withdraw/driver/transformers/supportedAssetsToReceiveOptionsPayload.js";import{DEFAULT_MOCK_ASSET as a,buildDefaultSupportedAssetsResponse as o,resolveMockAsset as s}from"./fixtures.js";const c=`0x32995Fb47918BD37133dB46F21c5Ed906140Dd41`,l=`0xd41f5e9e5b1c2c4d8e7a0bf3a9e6c1d2b8f5d4c3e2a1b0c9d8e7f6a5b4c3d2e1`;function u(e){return{symbol:e.symbol,decimals:e.decimals,address:e.address,isNative:e.isNative,assetLogoUrl:e.assetLogoUrl,networkName:e.networkName,eip155Id:e.eip155IdString,networkId:e.networkId,chainLogoUrl:e.chainLogoUrl}}function d(e){return`${e.explorerBase}/tx/`}const f={quote:1400,submit:4e3,processingPendingDelay:1500,processingTerminal:3e3},p=u(a),m=4.00613;function h(e=a){let t=u(e);return[{networkId:t.networkId,networkName:t.networkName,eip155Id:t.eip155Id,...t.chainLogoUrl?{chainLogoUrl:t.chainLogoUrl}:{},symbol:t.symbol,decimals:t.decimals,address:t.address,...t.assetLogoUrl?{assetLogoUrl:t.assetLogoUrl}:{},isNative:t.isNative,amount:{value:4.01,formatted:`4.01`},amountUsd:{value:4.01,formatted:`$4.01`}}]}function g(e=m,t=a){let n=D(e);return{receiveAsset:u(t),receiveAmount:{value:e,formatted:n},receiveAmountUsd:{value:e,formatted:`$${e.toFixed(2)}`},breakdown:{selectedRoute:{provider:`mock`,scenario:`same_chain_same_token`,label:`Mock · same chain same token`},networkCost:{value:0,formatted:`$0.00`},priceImpact:{value:0,formatted:`0.00%`}},quoteTotalSeconds:30,expiresAt:Date.now()+3e4}}function _(t=e,i=m,o=c,s=l,f=a){let p=Date.now();return{kind:`pending`,receiveAsset:u(f),receiveAmount:{value:i,formatted:D(i)},recipient:{value:o,formatted:r(o)},submittedAt:{value:p,formatted:n(p,t)},txHash:{value:s,formatted:r(s)},txExplorerUrl:`${d(f)}${s}`}}function v(i=e,o=m,s=c,f=14,p=l,h=a,g=`0xa17b4c9e2d68f0a5c3b91e7f4d52a86b09c1d7e3f8a4b2c5d6e9f0a1b2c3d4e5`){let _=Date.now(),v=f*1e3,y=_-v;return{kind:`succeeded`,receiveAsset:u(h),receiveAmount:{value:o,formatted:D(o)},recipient:{value:s,formatted:r(s)},submittedAt:{value:y,formatted:n(y,i)},filledAt:{value:_,formatted:n(_,i)},totalTime:{value:f,formatted:t(v,i)},txHash:{value:p,formatted:r(p)},txExplorerUrl:`${d(h)}${p}`,completionTx:{hash:{value:g,formatted:r(g)},explorerUrl:`${d(h)}${g}`}}}function y(t=e,i=`unknown`,o=m,s=c,f=l,p=a){let h=Date.now(),g=h-5e3;return{kind:`failed`,failureKind:i,receiveAsset:u(p),receiveAmount:{value:o,formatted:D(o)},recipient:{value:s,formatted:r(s)},submittedAt:{value:g,formatted:n(g,t)},failedAt:{value:h,formatted:n(h,t)},txHash:{value:f,formatted:r(f)},txExplorerUrl:`${d(p)}${f}`}}function b(t={}){let n={...f,...t.latency},r=t.autoSettleTo??`succeeded`,a=t.pendingTriggerToSuccessMs===void 0?3500:t.pendingTriggerToSuccessMs,p=t.getI18n??(()=>e),b=s(t.asset),S=u(b),D=d(b),O=h(b),k=x(O),A=o(),j=i(A),M={withdrawableBalances:t.initialState?.withdrawableBalances??{status:`ready`,payload:O,raw:k,response:k},receiveOptions:t.initialState?.receiveOptions??{status:`ready`,payload:j,raw:A.assets,response:A},quote:t.initialState?.quote??{status:`idle`},settlement:t.initialState?.settlement??{status:`idle`}},N=M,P=new Set,F=new Set,I=new Set,L=new Set,R=()=>{for(let e of P)e()},z=e=>{if(N={...N,...e},R(),e.settlement)for(let e of F)e(N.settlement);if(e.withdrawableBalances)for(let e of I)e(N.withdrawableBalances)},B=(e,t)=>{let n=setTimeout(()=>{L.delete(n),e()},t);L.add(n)},V=null,H=!1,U=0;function W(){return U+=1,`0x${U.toString(16).padStart(8,`0`)}${l.slice(10)}`}let G={getSnapshot:()=>N,subscribe(e){return P.add(e),()=>{P.delete(e)}},async requestQuote(e,t){z({quote:{status:`loading`}}),await E(n.quote,t);let r=g(e.amount,b),i=C(r,e.amount,S);z({quote:{status:`ready`,payload:r,raw:i,response:i}})},async submitWithdrawal(e,t){await E(n.submit,t),V={amount:e.amount,recipient:e.recipientAddress};let r=W(),i={hash:r,explorerUrl:`${D}${r}`};return K(e.amount,e.recipientAddress,r,t),i},watchSettlement(e,t,n){F.add(t);let r=N.settlement;queueMicrotask(()=>{n.aborted||t(r)}),n.addEventListener(`abort`,()=>F.delete(t),{once:!0})},watchWithdrawableBalances(e,t,n){I.add(t);let r=N.withdrawableBalances;queueMicrotask(()=>{n.aborted||t(r)}),n.addEventListener(`abort`,()=>I.delete(t),{once:!0})}};function K(e,t,i,a){H||(H=!0,B(()=>{if(a.aborted){H=!1;return}let o=_(p(),e,t,i,b),s=w(o,S);if(z({settlement:{status:`ready`,payload:o,raw:s,response:T(s,o)}}),r===`none`){H=!1;return}B(()=>{if(H=!1,a.aborted)return;let n=r===`succeeded`?v(p(),e,t,14,i,b):y(p(),`unknown`,e,t,i,b),o=w(n,S);z({settlement:{status:`ready`,payload:n,raw:o,response:T(o,n)}})},n.processingTerminal)},n.processingPendingDelay))}let q={triggerWithdrawalInProgress(e){let{amount:t,recipient:n}=J(),r={..._(p(),t,n,W(),b),...e},i=w(r,S);z({settlement:{status:`ready`,payload:r,raw:i,response:T(i,r)}}),a!==null&&B(()=>q.triggerWithdrawalSuccess(),a)},triggerWithdrawalSuccess(e){let{amount:t,recipient:n}=J(),r={...v(p(),t,n,14,W(),b),...e},i=w(r,S);z({settlement:{status:`ready`,payload:r,raw:i,response:T(i,r)}})},triggerWithdrawalFailed(e,t){let{amount:n,recipient:r}=J(),i={...y(p(),e,n,r,W(),b),...t},a=w(i,S);z({settlement:{status:`ready`,payload:i,raw:a,response:T(a,i)}})},triggerQuoteFailure(e){z({quote:{status:`error`,error:e}})},reset(){for(let e of L)clearTimeout(e);L.clear(),H=!1,V=null,U=0,N=M,R()}};function J(){return{amount:V?.amount??m,recipient:V?.recipient??c}}return{driver:G,triggers:q}}function x(e){let t=e.reduce((e,t)=>e+(t.amountUsd?.value??0),0);return{wallet_address:`0xMockWallet000000000000000000000000000000`,fetched_at:new Date(0).toISOString(),total_usd:t.toFixed(2),chains:e.map(e=>({eip155_id:e.eip155Id?Number(e.eip155Id):0,stridge_network_id:e.networkId??``,network_name:e.networkName.toLowerCase(),label:e.networkName,scanner_url:``,native_symbol:``,subtotal_usd:(e.amountUsd?.value??0).toFixed(2),tokens:[{token_address:e.address,symbol:e.symbol,name:e.symbol,decimals:e.decimals,logo:e.assetLogoUrl??``,is_native:e.isNative,is_spam:!1,raw_amount:S(e.amount.value,e.decimals).toString(),amount:e.amount.value.toString(),amount_usd:(e.amountUsd?.value??0).toFixed(2),usd_price:e.amount.value>0?((e.amountUsd?.value??0)/e.amount.value).toFixed(6):`0`,price_change_24h_pct:`0`}]}))}}function S(e,t){if(!Number.isFinite(e)||e<0)return 0n;let[n,r=``]=e.toFixed(t).split(`.`),i=r.padEnd(t,`0`).slice(0,t);return BigInt((n??`0`)+i)}function C(e,t,n=p){let r=S(e.receiveAmount.value,e.receiveAsset.decimals).toString(),i=S(t,n.decimals).toString(),a=t>0?(e.receiveAmount.value/t).toFixed(6):`1`;return{from:{network_id:Number(n.eip155Id??56),asset_address:n.address,amount:i},to:{network_id:Number(e.receiveAsset.eip155Id??56),asset_address:e.receiveAsset.address,amount:r},exchange_rate:a,fees:{total_fee:`0`},route:{provider:`mock`,scenario:`same_chain_same_token`,estimated_time_seconds:30},expires_at:new Date(e.expiresAt).toISOString()}}function w(e,t=p){let n=new Date(e.submittedAt.value).toISOString(),r=e.kind===`succeeded`?`completed`:e.kind===`failed`?`failed`:`routing`,i=e.kind===`succeeded`?e.filledAt.value:e.kind===`failed`?e.failedAt.value:e.submittedAt.value,a={tx_id:(e.kind===`succeeded`?e.txHash.value:e.txHash?.value)??``,asset_symbol:t.symbol,asset_address:t.address,eip155_id:t.eip155Id??`56`,network_id:t.networkId??`9006`,network_name:t.networkName.toLowerCase(),raw_amount:S(e.receiveAmount.value,t.decimals).toString(),amount:e.receiveAmount.value.toString(),confirmed_at:n},o={address:e.recipient.value,asset_address:e.receiveAsset.address,asset_symbol:e.receiveAsset.symbol,eip155_id:e.receiveAsset.eip155Id??``,network_id:e.receiveAsset.networkId??``,network_name:e.receiveAsset.networkName.toLowerCase(),raw_amount:S(e.receiveAmount.value,e.receiveAsset.decimals).toString(),amount:e.receiveAmount.value.toString(),...e.kind===`succeeded`?{settled_at:new Date(e.filledAt.value).toISOString(),...e.completionTx?{tx_id:e.completionTx.hash.value}:{}}:{}};return{id:`mock-settlement-${e.recipient.value}-${a.tx_id}`,status:r,created_at:n,updated_at:new Date(i).toISOString(),events:[],fees:{raw_amount:`0`},from:a,to:o,route:{provider:`mock`,scenario:`withdraw_v1`},...e.kind===`failed`?{error:e.failureKind}:{}}}function T(e,t){let n=t.kind!==`pending`;return{owner:`0xMockOwner`,uda_id:`mock-uda`,created_at:e.created_at,updated_at:e.updated_at,is_terminal:n,status:t.kind===`succeeded`?`completed`:t.kind===`failed`?`failed`:`to_pending`,destination:{address:t.recipient.value,asset_address:t.receiveAsset.address,asset_decimals:t.receiveAsset.decimals,asset_symbol:t.receiveAsset.symbol,eip155_id:t.receiveAsset.eip155Id??``,network_id:t.receiveAsset.networkId??``,network_name:t.receiveAsset.networkName},settlements:[e]}}function E(e,t){return new Promise((n,r)=>{if(t.aborted){r(new DOMException(`Aborted`,`AbortError`));return}let i=setTimeout(()=>{t.removeEventListener(`abort`,a),n()},e),a=()=>{clearTimeout(i),t.removeEventListener(`abort`,a),r(new DOMException(`Aborted`,`AbortError`))};t.addEventListener(`abort`,a)})}function D(e){return Number.isInteger(e)?e.toFixed(2):e.toFixed(5)}export{h as buildDefaultWithdrawableBalances,y as buildDefaultWithdrawalFailurePayload,_ as buildDefaultWithdrawalPendingPayload,g as buildDefaultWithdrawalQuotePayload,v as buildDefaultWithdrawalSuccessPayload,b as createStridgeMockWithdrawDriver};

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

@@ -0,0 +1,127 @@
+import { SettlementFailureKind } from "../../shared/driver/types.js";
+import { AddressItemPayload, BalanceItemPayload, BrandPayload, QuotePayload, SettlementFailurePayload, SettlementPayload, SettlementPendingPayload, SettlementSuccessPayload, TargetPayload, WalletInfo, WalletPayload } from "../../flows/deposit/driver/payloads.js";
+import { I18n } from "@lingui/core";
+import { DepositAddressDto, GatewayPollResponse, GatewaySettlementDto, GatewayStartResponse, OnchainBalanceResponse, QuoteResponse, SupportedAssetDto, SupportedAssetsResponse } from "@stridge/sdk";
+
+//#region src/drivers/stridge-mock/fixtures.d.ts
+/**
+ * Default {@link WalletInfo} the mock seeds the `wallet` entity with — the captured production
+ * EOA. Hosts override via `createStridgeMockDriver({ wallet })` when they want a different
+ * `…<last 4>` value or a disconnected mode.
+ */
+declare const DEFAULT_WALLET_INFO: WalletInfo;
+/**
+ * Default brand metadata the mock seeds the `brand` entity with.
+ */
+declare const DEFAULT_BRAND_PAYLOAD: BrandPayload;
+/**
+ * Resolved destination-asset record the mock driver seeds every entity from. Hosts that need
+ * to demo a non-default `(chain, symbol)` pass {@link MockAssetSelection} through the factory;
+ * the driver resolves it once via {@link resolveMockAsset} and threads this shape into every
+ * builder, so target / quote / settlement payloads all stay coherent against the same asset.
+ */
+interface MockAsset {
+  /** Stridge network id (e.g. `"9006"` for BSC, `"60"` for Ethereum). */
+  networkId: string;
+  /** Friendly chain name as it appears in payloads (e.g. `"BSC"`, `"Ethereum"`). */
+  networkName: string;
+  /** EIP-155 id as a string (matches `TargetPayload.eip155Id`'s wire shape). */
+  eip155IdString: string;
+  /** EIP-155 id as a number (matches `SupportedAssetDto.eip155_id` + `routeHops[].chainId`). */
+  eip155IdNumber: number;
+  chainLogoUrl: string;
+  /** Block explorer base URL for the chain (e.g. `"https://bscscan.com"`). */
+  explorerBase: string;
+  symbol: string;
+  decimals: number;
+  /** Contract address; `""` for native assets. */
+  address: string;
+  assetLogoUrl: string;
+  isNative: boolean;
+  /** The chain's native gas asset (BNB on BSC, ETH on Ethereum/Arbitrum, POL on Polygon, …). */
+  nativeSymbol: string;
+}
+/**
+ * Selector accepted by {@link resolveMockAsset}. `chain` is the gateway's `network_name`
+ * (case-insensitive, e.g. `"bsc"` / `"BSC"`), `symbol` the asset ticker (`"USDC"`).
+ */
+interface MockAssetSelection {
+  chain: string;
+  symbol: string;
+}
+/**
+ * Legacy export kept for unchanged consumers — same shape as
+ * {@link buildDefaultTargetRaw}() with no asset override.
+ */
+declare const DEFAULT_TARGET_RAW: SupportedAssetDto;
+declare function buildDefaultTargetPayload(i18n: I18n, minDepositUsd?: number, asset?: MockAsset): TargetPayload;
+/**
+ * Build the bundled deposit-address fixtures. When `minDepositUsd` is set, every row carries a
+ * formatted per-chain `minDepositUsd` so the transfer-crypto picker renders `Min $X` next to the
+ * Chains label and on each option row — the same display the captured-production payload showed.
+ */
+declare function buildDefaultAddressesPayload(i18n: I18n, minDepositUsd?: number): ReadonlyArray<AddressItemPayload>;
+/**
+ * Static-i18n form of {@link buildDefaultAddressesPayload} — kept for callers that pre-import the
+ * canonical mock list without a live `I18n` handle. Excludes per-row `minDepositUsd`; callers that
+ * want it must use the builder.
+ */
+declare const DEFAULT_ADDRESSES_PAYLOAD: ReadonlyArray<AddressItemPayload>;
+/**
+ * Default source-side balance list — derived from the captured `/v1/balance/onchain/{wallet}`
+ * response for `0xCA8779…685c` against the production UDA, filtered through routability +
+ * spam-drop + the kit's `minDepositUsd` floor (rows whose `amountUsd` is below the floor ride in
+ * as `lowBalance + disabled` so the picker dims them out instead of dropping them).
+ *
+ * Captured snapshot (chain × token, after routability filter):
+ *  - BSC USDC      42.806 ($42.81) — routable, top of the picker.
+ *  - BSC BNB       0.0167 ($10.86) — routable native.
+ *  - ETH BNB       0.0145  ($9.84) — wrapped BNB ERC-20.
+ *  - ETH USDT      0.7575  ($0.76) — sub-floor.
+ *  - BSC USDT      0.5952  ($0.60) — sub-floor.
+ *  - ETH ETH       0.000167 ($0.39) — sub-floor native.
+ *  - ETH USDC      0.10408  ($0.10) — sub-floor.
+ */
+declare function buildDefaultBalances(i18n: I18n): ReadonlyArray<BalanceItemPayload>;
+/**
+ * Default quote payload. Captured production scenario: 5 USDC on Ethereum routed to the
+ * destination asset (USDC on BSC by default) via LIFI cross-chain. Total time around 28m on
+ * the wire — same number {@link DEFAULT_SUCCESS_PAYLOAD} uses for `totalTime`. Pass `asset` to
+ * retarget the receive side at a different `(chain, symbol)` while keeping the same numeric
+ * route shape.
+ */
+declare function buildDefaultQuotePayload(i18n: I18n, expiresAt: number, asset?: MockAsset): QuotePayload;
+/**
+ * Pending settlement seed — captured production source-chain detection, no terminal verdict
+ * yet. The `creditedAsset` reflects `asset` so the in-progress banner shows the picker's
+ * destination tuple. Source-chain links stay on Etherscan since the captured scenario routes
+ * USDC@Ethereum into the chosen destination.
+ */
+declare function buildDefaultPendingPayload(i18n: I18n, asset?: MockAsset): SettlementPendingPayload;
+/**
+ * Successful settlement seed — captured production record `a9e7f2fc-…`. 5 USDC Ethereum →
+ * 4.983615 USDC BSC via LIFI cross-chain, settled in 28m 5s.
+ */
+declare function buildDefaultSuccessPayload(i18n: I18n, asset?: MockAsset): SettlementSuccessPayload;
+/**
+ * Failed settlement seed — sibling failure record (`3552b865-…`) from the same capture.
+ * Cross-chain LIFI route reverted on the destination tx with `execution reverted`.
+ */
+declare function buildDefaultFailurePayload(i18n: I18n, failureKind?: SettlementFailureKind, asset?: MockAsset): SettlementFailurePayload;
+/**
+ * Re-export for {@link WalletPayload} default. Constructed inline rather than via the transformer
+ * so the fixture stays self-contained — driver authors don't need to import a transformer to seed
+ * the wallet entity. Includes a pre-aggregated `balanceTotalUsd` derived from the bundled balance
+ * fixtures so the deposit-method picker's wallet tile renders the canonical `$24.50 · Instant`
+ * meta line straight from the seed (the live driver re-stamps this whenever its own balances
+ * poll lands).
+ */
+declare function buildDefaultWalletPayload(i18n: I18n, wallet?: WalletInfo): WalletPayload;
+/**
+ * Build a {@link SettlementPayload} of the requested kind off the bundled fixtures. Drivers and
+ * triggers compose this when seeding `settlement` to a specific terminal state.
+ */
+declare function buildSettlementPayload(i18n: I18n, kind: "pending" | "succeeded", asset?: MockAsset): SettlementPayload;
+declare function buildSettlementPayload(i18n: I18n, kind: "failed", failureKind?: SettlementFailureKind, asset?: MockAsset): SettlementPayload;
+//#endregion
+export { DEFAULT_ADDRESSES_PAYLOAD, DEFAULT_BRAND_PAYLOAD, DEFAULT_TARGET_RAW, DEFAULT_WALLET_INFO, MockAsset, MockAssetSelection, buildDefaultAddressesPayload, buildDefaultBalances, buildDefaultFailurePayload, buildDefaultPendingPayload, buildDefaultQuotePayload, buildDefaultSuccessPayload, buildDefaultTargetPayload, buildDefaultWalletPayload, buildSettlementPayload };