@zerodev/smart-routing-address-react-ui 0.0.1

package/README.md

@@ -0,0 +1,117 @@
+# @zerodev/smart-routing-address-react-ui
+
+React UI kit for [ZeroDev Smart Routing Address](https://docs.zerodev.app/) —
+a drop-in **funding widget** that generates a single deposit address, routes
+whatever the user sends across chains and tokens, and reports live status.
+
+Mount one component, get a full deposit-funding experience: token & source
+chain picker, QR + copy card, live fee breakdown, pending/past deposit lists,
+and a per-transaction details view. UI styling comes from
+[`@zerodev/react-ui`](../react-ui/README.md).
+
+## Installation
+
+```bash
+pnpm add @zerodev/smart-routing-address-react-ui viem
+```
+
+> `react` (18 or 19), `react-dom`, and `viem` are **peer dependencies** —
+> install them alongside this package. `@zerodev/smart-routing-address` ships
+> as a regular dependency; install it directly only if you import from it
+> (e.g. `createCall` for custom `actions`).
+
+## Setup
+
+### 1. Import the stylesheet once at app entry
+
+```tsx
+import '@zerodev/smart-routing-address-react-ui/styles.css'
+```
+
+### 2. Wrap the subtree in `SmartRoutingAddressProvider`
+
+The provider holds the config and lazily creates the smart routing address
+for a recipient. It doesn't render the widget — mount `<SmartRoutingAddress
+/>` inline where you want the UI.
+
+```tsx
+import {
+  SmartRoutingAddress,
+  SmartRoutingAddressProvider,
+} from '@zerodev/smart-routing-address-react-ui'
+import { arbitrum } from 'viem/chains'
+
+function Funding({ recipient }: { recipient: `0x${string}` }) {
+  return (
+    <SmartRoutingAddressProvider
+      config={{
+        projectId: 'your-project-id', // from https://dashboard.zerodev.app
+        targetChainId: arbitrum.id,
+      }}
+    >
+      <SmartRoutingAddress recipient={recipient} onClose={() => {}} />
+    </SmartRoutingAddressProvider>
+  )
+}
+```
+
+## Usage
+
+`<SmartRoutingAddress />` renders the current step (deposit, past deposits,
+or a single transaction's details) inside its own card frame. Navigation is
+owned by the widget; `onClose` fires when the top-right ✕ is tapped so the
+host app can dismiss.
+
+```tsx
+<SmartRoutingAddress
+  recipient={recipient}
+  onClose={() => setOpen(false)}
+  size="lg" // 'sm' | 'md' | 'lg'
+/>
+```
+
+Address creation and deposit polling happen in the provider; host code can
+observe the widget's state via `useSmartRoutingAddress()` (e.g. drive a
+companion panel from the route the widget is showing) and pre-create the
+address via `useCreateSmartRoutingAddress().getOrCreateAddress` before the modal
+opens. To build a fully custom deposit UI, use the
+`@zerodev/smart-routing-address` SDK directly — this package's hooks are
+widget plumbing, not a UI kit.
+
+## Configuration
+
+Everything the widget needs is on the config passed to the provider.
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `projectId` | `string?` | ZeroDev project id; appended to the SRA server URL. |
+| `targetChainId` | `number` | Chain id where funds settle. **Required.** |
+| `version` | `SmartRoutingAddressVersion?` | SRA manager version. Defaults to the latest stable. |
+| `actions` | `CreateSmartRoutingAddressParams['actions']?` | Destination actions per token type. When omitted, deposits are simply transferred to the recipient. |
+| `slippage` | `number?` | Max slippage in basis points (50 = 0.5%). When omitted, the SRA server picks its default. |
+| `baseUrl` | `string?` | Override the SRA server root URL; the `projectId` is appended. |
+
+## API
+
+| Export | Description |
+| --- | --- |
+| `<SmartRoutingAddressProvider />` | Wraps the subtree; owns config, recipient, and the address lifecycle. |
+| `<SmartRoutingAddress />` | The funding widget UI. Props: `recipient`, `onClose`, `size?`, `className?`. |
+| `useSmartRoutingAddress()` | Read-only widget companion for hosts: address state and the `activeRoute` the widget is showing. |
+| `useCreateSmartRoutingAddress()` | Action counterpart: `getOrCreateAddress(recipient)` returns the deposit address, creating it if needed — idempotent per recipient, so it's safe to call on every hover/open. Creation params come from the provider config. |
+
+### Types
+
+`SmartRoutingAddressConfig`, `SmartRoutingAddressProps`,
+`SmartRoutingAddressStep`, `SmartRoutingAddressProviderProps`,
+`UseSmartRoutingAddressResult`, `UseCreateSmartRoutingAddressResult`.
+
+## Development
+
+```bash
+pnpm build       # build the package (dist + types + css)
+pnpm dev         # watch mode (types)
+pnpm typecheck
+pnpm test        # vitest
+pnpm storybook   # component catalog
+```

package/dist/_types/components/AddressDisplay/index.d.ts

@@ -0,0 +1,43 @@
+import type { AddressState } from '../../types';
+/**
+ * The card that renders the deposit address in the SRA "Deposit funds" screen.
+ *
+ * Two visual states, each mapped 1:1 to a Figma node:
+ *   - Loading (Figma 17634:104343, "Smart Funding" card): delegates to
+ *     `LoadingCard`, which is the shared spinner+text pill used elsewhere in
+ *     the SRA flow (e.g., SmartFunding's "Watching for deposit" state).
+ *   - Ready (Figma 17762:78875, address+QR row): 14px radius, 40% offWhite
+ *     surface, left-aligned address text + a 52×52 white QR button on the
+ *     right. Rendered when `address` is supplied.
+ *
+ * The two states have deliberately different visuals; they share this
+ * component because the parent renders the same slot in both cases.
+ */
+export interface AddressDisplayUIProps {
+    /** Deposit address to render; when omitted, the loading variant is shown. */
+    address?: string;
+    /**
+     * Message rendered in the loading variant. Include chain-specific context
+     * from the caller, e.g., `Watching for your deposit on Base…`.
+     */
+    loadingText?: string;
+    /** Handler for the QR icon button (ready variant). */
+    onQrClick?: (() => void) | undefined;
+    className?: string;
+}
+export declare function AddressDisplayUI({ address, loadingText, onQrClick, className, }: AddressDisplayUIProps): import("react").JSX.Element;
+export interface AddressDisplayProps {
+    /** Current address-generation state from the SRA context. */
+    status: AddressState['status'];
+    /** Deposit address, present when `status === 'success'`. */
+    address?: string | undefined;
+    /** Handler for the QR icon button (only meaningful once `address` resolves). */
+    onQrClick?: (() => void) | undefined;
+}
+/**
+ * State-driven wrapper around `AddressDisplayUI`. Picks the right variant
+ * (loading / ready) based on the SRA address-generation status; the parent
+ * page renders `ErrorRetryCard` in the error case instead of this component.
+ */
+export declare function AddressDisplay({ status, address, onQrClick, }: AddressDisplayProps): import("react").JSX.Element | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/components/AddressDisplay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/AddressDisplay/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,WAA0C,EAC1C,SAAS,EACT,SAAS,GACV,EAAE,qBAAqB,+BA6CvB;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC9B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;CACrC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,SAAS,GACV,EAAE,mBAAmB,sCAMrB"}

package/dist/_types/components/ErrorRetryCard/index.d.ts

@@ -0,0 +1,21 @@
+export interface ErrorRetryCardProps {
+    /** Error copy shown on the left side, e.g. "Failed to create deposit
+     * address…" — kept short (Figma design truncates on one line). */
+    message: string;
+    /** Called when the user clicks the refresh affordance. */
+    onRetry: () => void;
+    /** Marks the button as busy while a retry is in flight — disables clicks
+     * and spins the icon so back-to-back taps don't stack requests. */
+    busy?: boolean;
+    /** Accessible label for the icon-only refresh button. Defaults to "Retry". */
+    retryLabel?: string;
+    className?: string;
+}
+/**
+ * Error banner with an inline retry affordance. Renders as a compact pill
+ * matching the Figma spec (`bg-negative/10`, error-red text, right-hand
+ * 52×52 refresh button). Used above the "Min deposit" row in the deposit UI
+ * to surface address-creation, empty-route and polling failures.
+ */
+export declare function ErrorRetryCard({ message, onRetry, busy, retryLabel, className, }: ErrorRetryCardProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/components/ErrorRetryCard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ErrorRetryCard/index.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC;sEACkE;IAClE,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB;uEACmE;IACnE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,OAAO,EACP,IAAI,EACJ,UAAoB,EACpB,SAAS,GACV,EAAE,mBAAmB,+BAuCrB"}

package/dist/_types/components/FeeBreakdown/feeInfo.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Plain-language explanations for each fee/route line, surfaced as tooltips
+ * on the info icons in the fee section so users understand what they're
+ * charged.
+ */
+export declare const FEE_INFO: {
+    readonly minDeposit: "Smallest amount this route can process after fees.";
+    readonly maxSlippage: "Maximum price movement allowed during the swap.";
+    readonly estimatedFee: "Estimated swap, bridge, and network costs.";
+    readonly readyIn: "Estimated arrival after the deposit is detected.";
+    readonly provider: "Bridge provider selected for this route.";
+    readonly execution: "Cost to execute and deliver funds on the destination chain.";
+    readonly capital: "Relayer cost for fronting capital while bridging.";
+    readonly destGas: "Gas to complete delivery on the destination chain.";
+    readonly lp: "Bridge liquidity-provider fee.";
+    readonly service: "Solver fee for filling the route.";
+    readonly originGas: "Gas to submit from the source chain.";
+    readonly app: "Optional application fee.";
+    readonly detected: "Deposit detected on the source chain.";
+    readonly routing: "Bridge and swap are in progress.";
+    readonly completed: "Funds arrived in the delivery account.";
+    readonly failed: "Deposit could not be completed.";
+};
+//# sourceMappingURL=feeInfo.d.ts.map

package/dist/_types/components/FeeBreakdown/feeInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeInfo.d.ts","sourceRoot":"","sources":["../../../../src/components/FeeBreakdown/feeInfo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;CAmBX,CAAA"}

package/dist/_types/components/FeeBreakdown/index.d.ts

@@ -0,0 +1,28 @@
+import type { ReactNode } from 'react';
+import type { FeeBreakdown } from '../../utils/providerFees';
+export type LiveValueProps = {
+    /** While true, the value is being re-quoted: show a spinner */
+    loading: boolean;
+    /** Changes with the value so the flash-in animation re-triggers */
+    flashKey: string | number;
+    children: ReactNode;
+};
+/**
+ * A value that swaps to a spinner while its route is re-quoting, then flashes
+ * the fresh value in. Used so a route change visibly recalculates the min
+ * deposit / estimated fee rather than silently snapping to new numbers.
+ */
+export declare function LiveValue({ loading, flashKey, children }: LiveValueProps): import("react").JSX.Element;
+/** Combined fee value: proportional rate (emphasised) + fixed USD cost */
+export declare function FeeSummary({ breakdown }: {
+    breakdown: FeeBreakdown;
+}): import("react").JSX.Element;
+/** Provider name + brand icon, linked to the provider's site when known */
+export declare function ProviderValue({ provider }: {
+    provider: string;
+}): import("react").JSX.Element;
+/** Itemised fee rows: provider + each fee leg */
+export declare function FeeBreakdownRows({ breakdown }: {
+    breakdown: FeeBreakdown;
+}): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/components/FeeBreakdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/FeeBreakdown/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,0BAA0B,CAAA;AAUrE,MAAM,MAAM,cAAc,GAAG;IAC3B,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,cAAc,+BAwBxE;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,+BAsCpE;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,+BA+B/D;AAwED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,+BAmB1E"}

package/dist/_types/components/LoadingCard/index.d.ts

@@ -0,0 +1,6 @@
+import type { HTMLAttributes } from 'react';
+export interface LoadingCardProps extends HTMLAttributes<HTMLDivElement> {
+    text: string;
+}
+export declare function LoadingCard({ text, className, ...rest }: LoadingCardProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/components/LoadingCard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/LoadingCard/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C,MAAM,WAAW,gBAAiB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACtE,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,gBAAgB,+BAmBzE"}

package/dist/_types/components/PendingDeposits/index.d.ts

@@ -0,0 +1,14 @@
+import type { DepositedToken } from '@zerodev/smart-routing-address';
+import type { EstimatedFee, SmartRoutingAddressConfig } from '../../types';
+export interface PendingDepositsProps {
+    deposits: DepositedToken[];
+    estimatedFees: EstimatedFee[];
+    config: SmartRoutingAddressConfig;
+    /** Fired when a row is tapped — the widget uses this to open the
+     * transaction-details view for the selected deposit. When omitted, rows
+     * render as static (non-interactive). */
+    onSelectDeposit?: (deposit: DepositedToken) => void;
+    className?: string;
+}
+export declare function PendingDeposits({ deposits, estimatedFees, config, onSelectDeposit, className, }: PendingDepositsProps): import("react").JSX.Element | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/components/PendingDeposits/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/PendingDeposits/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAEpE,OAAO,KAAK,EAGV,YAAY,EACZ,yBAAyB,EAC1B,MAAM,aAAa,CAAA;AAgBpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,MAAM,EAAE,yBAAyB,CAAA;IACjC;;6CAEyC;IACzC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AASD,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,aAAa,EACb,MAAM,EACN,eAAe,EACf,SAAS,GACV,EAAE,oBAAoB,sCAuGtB"}

package/dist/_types/components/QrSheet/QrCode.d.ts

@@ -0,0 +1,28 @@
+interface QrCodeProps {
+    /** Data to encode. */
+    value: string;
+    /** Pixel size of the rendered SVG square. */
+    size: number;
+    /** Error correction level. Defaults to `'M'`. */
+    errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
+    /** Corner radius (in modules, scaled to px internally) for finder patterns. */
+    eyeRadius?: number;
+}
+/**
+ * Custom QR renderer that draws runs of horizontally-adjacent data modules as
+ * a single rounded pill. Finder patterns stay as sharp concentric squares
+ * (rounding them breaks the 1:1:3:1:1 corner ratio scanners use to locate the
+ * code). Isolated data modules render as pill-ish rects — visually close to
+ * circles at very small `PILL_PAD_RATIO`, still square-adjacent for scanners.
+ *
+ * Default `errorCorrectionLevel` is `'H'` (30% recovery) so the decorative
+ * rounding + shrinkage has plenty of headroom before scans fail.
+ *
+ * Quiet zone (spec: ≥4 modules of white around the code) is expected to be
+ * provided by the caller — e.g. via a white-background padded wrapper. This
+ * component fills the given `size` with the QR data area itself so the
+ * consumer controls the visual footprint.
+ */
+export declare function QrCode({ value, size, errorCorrectionLevel, eyeRadius, }: QrCodeProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=QrCode.d.ts.map

package/dist/_types/components/QrSheet/QrCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QrCode.d.ts","sourceRoot":"","sources":["../../../../src/components/QrSheet/QrCode.tsx"],"names":[],"mappings":"AAEA,UAAU,WAAW;IACnB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAC5C,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,IAAI,EACJ,oBAA0B,EAC1B,SAAa,GACd,EAAE,WAAW,+BAyHb"}

package/dist/_types/components/QrSheet/index.d.ts

@@ -0,0 +1,16 @@
+export interface QrSheetProps {
+    /** Whether the modal is open. Controlled. */
+    open: boolean;
+    /** Called when the modal requests to close (backdrop click, ESC,
+     * Cancel button). */
+    onOpenChange: (open: boolean) => void;
+    /** Address to encode in the QR code and display below it. */
+    address: string;
+    /** Called when the user taps "Copy address". */
+    onCopy: () => void;
+}
+/** Bottom-anchored modal showing the deposit address as a QR code. Composes
+ * `<BottomSheet>` (state) + `<BottomSheetContent>` (chrome); this file owns the
+ * QR / address / copy-cancel layout inside it. */
+export declare function QrSheet({ open, onOpenChange, address, onCopy }: QrSheetProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/components/QrSheet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/QrSheet/index.tsx"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAA;IACb;yBACqB;IACrB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;kDAEkD;AAClD,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,+BAsD5E"}

package/dist/_types/components/TxnItem/ExplorerLink.d.ts

@@ -0,0 +1,16 @@
+export interface ExplorerLinkProps {
+    /** Full block-explorer URL, e.g. `https://etherscan.io/tx/0x…`. */
+    href: string;
+    /** Short address / hash used for the accessible label. */
+    address: string;
+    className?: string;
+}
+/**
+ * Small icon-only anchor to a block-explorer entry — the trailing action on a
+ * `TxnItem` row. Kept as its own component so both `PendingDeposits` (renders
+ * it inline via `TxnItem`'s `trailingAction` slot) and `PastDeposits`
+ * (renders it as an absolute sibling of the row-select button) use identical
+ * markup and styling.
+ */
+export declare function ExplorerLink({ href, address, className }: ExplorerLinkProps): import("react").JSX.Element;
+//# sourceMappingURL=ExplorerLink.d.ts.map

package/dist/_types/components/TxnItem/ExplorerLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerLink.d.ts","sourceRoot":"","sources":["../../../../src/components/TxnItem/ExplorerLink.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,iBAAiB,+BAmB3E"}

package/dist/_types/components/TxnItem/index.d.ts

@@ -0,0 +1,19 @@
+export type TxnStatus = 'Routing' | 'Detected' | 'Received' | 'Failed';
+export interface TxnItemProps {
+    /** Pre-formatted amount, e.g. `"$248.00 USD"`. */
+    amount: string;
+    /** Short address/hash display, e.g. `"0x4d2a…ba99"`. */
+    address: string;
+    /** Optional block-explorer URL. Address row becomes a link when supplied. */
+    href?: string;
+    /** Pre-formatted relative timestamp, e.g. `"2 mo ago"`. */
+    timestamp: string;
+    status: TxnStatus;
+    sourceTokenIconUrl?: string;
+    sourceChainIconUrl?: string;
+    destTokenIconUrl?: string;
+    destChainIconUrl?: string;
+    className?: string;
+}
+export declare function TxnItem({ amount, address, href, timestamp, status, sourceTokenIconUrl, sourceChainIconUrl, destTokenIconUrl, destChainIconUrl, className, }: TxnItemProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/components/TxnItem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/TxnItem/index.tsx"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEtE,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AASD,wBAAgB,OAAO,CAAC,EACtB,MAAM,EACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,GACV,EAAE,YAAY,+BA4Bd"}

package/dist/_types/constants.d.ts

@@ -0,0 +1,20 @@
+import type { Chain } from 'viem';
+import type { SourceToken } from './types';
+export declare const DEFAULT_POLLING_INTERVAL_MS = 5000;
+export declare const DEFAULT_FILL_TIME_SECONDS = 30;
+export declare const DEFAULT_DASHBOARD_URL = "https://smart-routing-address.zerodev.app";
+/**
+ * Chains supported by the smart routing address SDK; mirrors the
+ * smart-account-plus core `supportedChainIds` list.
+ */
+export declare const SUPPORTED_CHAINS: readonly Chain[];
+export declare const CHAINS_BY_ID: ReadonlyMap<number, Chain>;
+/**
+ * Source tokens offered for deposits: every supported mainnet token the SDK
+ * exposes (NATIVE plus each ERC-20, with wrapped native surfaced as WETH),
+ * mapped to its viem chain object. Testnets are excluded from the default;
+ * chains this package cannot resolve to a viem chain are skipped, and token
+ * types the server can't route yet are filtered via `UNSUPPORTED_TOKEN_TYPES`.
+ */
+export declare const DEFAULT_SOURCE_TOKENS: SourceToken[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/_types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAyBjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,eAAO,MAAM,2BAA2B,OAAQ,CAAA;AAEhD,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAE3C,eAAO,MAAM,qBAAqB,8CAA8C,CAAA;AAEhF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,KAAK,EAuB5C,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAEnD,CAAA;AAgBD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,EAY7C,CAAA"}

package/dist/_types/context/SmartRoutingAddressContext.d.ts

@@ -0,0 +1,32 @@
+import type { Address } from 'viem';
+import type { ActiveRoute, AddressState, SmartRoutingAddressConfig } from '../types';
+export type SmartRoutingAddressContextValue = {
+    config: SmartRoutingAddressConfig;
+    addressState: AddressState;
+    /** Recipient of the active (or last requested) smart routing address */
+    recipient?: Address | undefined;
+    /**
+     * Return the smart routing address for the recipient, creating it if it
+     * has not been created yet. Safe to call multiple times; concurrent calls
+     * for the same recipient share one request, while a new recipient
+     * triggers a fresh creation. Rejects when creation fails (the failure
+     * also lands in `addressState`).
+     */
+    getOrCreateAddress: (recipient: Address) => Promise<Address>;
+    /**
+     * Re-run address creation for the current recipient. No-op if no recipient
+     * has been set yet. Wired to the "Failed to create deposit address" retry
+     * button in the deposit UI.
+     */
+    retry: () => Promise<void>;
+    /**
+     * The route currently shown in the deposit UI. `null` until the picker
+     * seeds a selection. Hosts can read this to mirror the widget's state.
+     */
+    activeRoute: ActiveRoute | null;
+    /** Deposit UI internal — writes the current picker selection to context. */
+    setActiveRoute: (route: ActiveRoute | null) => void;
+};
+export declare const SmartRoutingAddressContext: import("react").Context<SmartRoutingAddressContextValue | null>;
+export declare function useSmartRoutingAddressContext(): SmartRoutingAddressContextValue;
+//# sourceMappingURL=SmartRoutingAddressContext.d.ts.map

package/dist/_types/context/SmartRoutingAddressContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartRoutingAddressContext.d.ts","sourceRoot":"","sources":["../../../src/context/SmartRoutingAddressContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,yBAAyB,EAC1B,MAAM,UAAU,CAAA;AAEjB,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,yBAAyB,CAAA;IACjC,YAAY,EAAE,YAAY,CAAA;IAC1B,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B;;;;;;OAMG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5D;;;;OAIG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B;;;OAGG;IACH,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CACpD,CAAA;AAED,eAAO,MAAM,0BAA0B,iEACsB,CAAA;AAE7D,wBAAgB,6BAA6B,IAAI,+BAA+B,CAQ/E"}

package/dist/_types/context/SmartRoutingAddressProvider.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+import type { SmartRoutingAddressConfig } from '../types';
+export type SmartRoutingAddressProviderProps = {
+    config: SmartRoutingAddressConfig;
+    children: ReactNode;
+};
+/**
+ * Holds the config and the lazily created routing address. Wrap the subtree
+ * that renders <SmartRoutingAddress /> with this provider — the deposit UI
+ * itself is rendered inline by the consumer, not by this provider.
+ */
+export declare function SmartRoutingAddressProvider({ config, children, }: SmartRoutingAddressProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=SmartRoutingAddressProvider.d.ts.map

package/dist/_types/context/SmartRoutingAddressProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartRoutingAddressProvider.d.ts","sourceRoot":"","sources":["../../../src/context/SmartRoutingAddressProvider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA0C,MAAM,OAAO,CAAA;AAE9E,OAAO,KAAK,EAGV,yBAAyB,EAC1B,MAAM,UAAU,CAAA;AAUjB,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,yBAAyB,CAAA;IACjC,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,QAAQ,GACT,EAAE,gCAAgC,+BAkHlC"}

package/dist/_types/hooks/useCreateSmartRoutingAddress.d.ts

@@ -0,0 +1,23 @@
+import type { Address } from 'viem';
+export type UseCreateSmartRoutingAddressResult = {
+    /**
+     * Return the deposit address for the recipient, creating it if it doesn't
+     * exist yet. Idempotent per recipient — concurrent and repeated calls
+     * share one request, so it's safe to call on every hover/focus/mount.
+     * Rejects when creation fails (the failure also lands in the read hook's
+     * `addressState`). Creation params (`actions`, `slippage`, …) come from
+     * the provider config so the address always matches what the widget
+     * displays — there are no per-call overrides. To create addresses with
+     * bespoke params, use `createSmartRoutingAddress` from
+     * `@zerodev/smart-routing-address`.
+     */
+    getOrCreateAddress: (recipient: Address) => Promise<Address>;
+};
+/**
+ * Action counterpart to `useSmartRoutingAddress` (which is read-only): lets
+ * hosts embedding the `<SmartRoutingAddress />` widget pre-create the
+ * deposit address — e.g. on hover or route entry, before the modal opens —
+ * so the widget renders instantly.
+ */
+export declare function useCreateSmartRoutingAddress(): UseCreateSmartRoutingAddressResult;
+//# sourceMappingURL=useCreateSmartRoutingAddress.d.ts.map

package/dist/_types/hooks/useCreateSmartRoutingAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateSmartRoutingAddress.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCreateSmartRoutingAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,MAAM,MAAM,kCAAkC,GAAG;IAC/C;;;;;;;;;;OAUG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7D,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,kCAAkC,CAGjF"}

package/dist/_types/hooks/useDepositStatus.d.ts

@@ -0,0 +1,25 @@
+import type { DepositedToken } from '@zerodev/smart-routing-address';
+import type { Address } from 'viem';
+export type UseDepositStatusParams = {
+    address: Address | undefined;
+    enabled?: boolean | undefined;
+    pollingInterval?: number | undefined;
+    baseUrl?: string | undefined;
+};
+export type UseDepositStatusResult = {
+    deposits: DepositedToken[];
+    totalCount: number;
+    /** True once at least one status response has been received */
+    hasLoaded: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    /** Trigger an immediate poll — used by the "Retry" button after a fetch
+     * error. No-op while no address is set. */
+    refetch: () => void;
+};
+/**
+ * Polls the smart routing address status endpoint while enabled, returning
+ * the current list of deposits.
+ */
+export declare function useDepositStatus({ address, enabled, pollingInterval, baseUrl, }: UseDepositStatusParams): UseDepositStatusResult;
+//# sourceMappingURL=useDepositStatus.d.ts.map

package/dist/_types/hooks/useDepositStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDepositStatus.d.ts","sourceRoot":"","sources":["../../../src/hooks/useDepositStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAGpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB;+CAC2C;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,OAAc,EACd,eAA6C,EAC7C,OAAO,GACR,EAAE,sBAAsB,GAAG,sBAAsB,CAmEjD"}

package/dist/_types/hooks/useNewDeposits.d.ts

@@ -0,0 +1,8 @@
+import type { DepositedToken } from '@zerodev/smart-routing-address';
+/**
+ * Tracks deposits that arrived after the first loaded status snapshot.
+ * The snapshot taken when `ready` first becomes true acts as the baseline,
+ * so pre-existing deposits are not reported as new.
+ */
+export declare function useNewDeposits(deposits: DepositedToken[], ready: boolean): DepositedToken[];
+//# sourceMappingURL=useNewDeposits.d.ts.map

package/dist/_types/hooks/useNewDeposits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNewDeposits.d.ts","sourceRoot":"","sources":["../../../src/hooks/useNewDeposits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAIpE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EAAE,EAC1B,KAAK,EAAE,OAAO,GACb,cAAc,EAAE,CAYlB"}

package/dist/_types/hooks/useProviderFees.d.ts

@@ -0,0 +1,22 @@
+import type { Chain } from 'viem';
+import type { EstimatedFeeData, SourceToken } from '../types';
+import { type FeeBreakdown } from '../utils/providerFees';
+export type ProviderFeesState = {
+    /** Cheapest normalised quote, or null while loading / unquotable */
+    fees: FeeBreakdown | null;
+    /** True from the moment the route changes until the quotes resolve */
+    loading: boolean;
+};
+/**
+ * Fetch live fee quotes for the selected route from every supported provider
+ * (Across + Relay), normalise them, and return the cheapest. Across and Relay
+ * expose the itemised bridge legs the SRA fee estimate alone does not, so this
+ * enriches the breakdown with how the user is actually charged and which route
+ * is currently best.
+ *
+ * Returns null while loading, for routes that can't be quoted (native /
+ * unresolvable tokens), or when every request fails — callers fall back to
+ * the SRA execution fee on their own.
+ */
+export declare function useProviderFees(source: SourceToken | null, destChain: Chain, feeData: EstimatedFeeData | null, recipient?: string): ProviderFeesState;
+//# sourceMappingURL=useProviderFees.d.ts.map

package/dist/_types/hooks/useProviderFees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProviderFees.d.ts","sourceRoot":"","sources":["../../../src/hooks/useProviderFees.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,KAAK,EAAE,MAAM,MAAM,CAAA;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE7D,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,uBAAuB,CAAA;AAmH9B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oEAAoE;IACpE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IACzB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,SAAS,EAAE,KAAK,EAChB,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,CAoFnB"}

package/dist/_types/hooks/useSmartRoutingAddress.d.ts

@@ -0,0 +1,20 @@
+import type { ActiveRoute, AddressState } from '../types';
+export type UseSmartRoutingAddressResult = {
+    addressState: AddressState;
+    /**
+     * The route the widget's deposit UI is currently showing (source token +
+     * chain + estimated fee). `null` until the picker has seeded a selection.
+     * Read-only by design: the widget's picker owns this value; hosts mirror
+     * it (e.g. to drive a companion send panel), they don't set it.
+     */
+    activeRoute: ActiveRoute | null;
+};
+/**
+ * Read-only companion hook for hosts embedding the `<SmartRoutingAddress />`
+ * widget: observe the address state and mirror the route the widget is
+ * showing, from anywhere inside the provider. Its action counterpart is
+ * `useCreateSmartRoutingAddress`. Not a kit for building a custom deposit
+ * UI — for that, use `@zerodev/smart-routing-address` directly.
+ */
+export declare function useSmartRoutingAddress(): UseSmartRoutingAddressResult;
+//# sourceMappingURL=useSmartRoutingAddress.d.ts.map

package/dist/_types/hooks/useSmartRoutingAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSmartRoutingAddress.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSmartRoutingAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEzD,MAAM,MAAM,4BAA4B,GAAG;IACzC,YAAY,EAAE,YAAY,CAAA;IAC1B;;;;;OAKG;IACH,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;CAChC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CAGrE"}

package/dist/_types/iconAssets.d.ts

@@ -0,0 +1,7 @@
+/** Chain icon by chain id; testnets reuse their mainnet icon */
+export declare const CHAIN_ICONS: Record<number, string>;
+/** Token icon by display symbol; wrapped variants reuse the base icon */
+export declare const TOKEN_ICONS: Record<string, string>;
+/** Provider brand icon by `FeeBreakdown.provider` value ("Across" / "Relay"). */
+export declare const PROVIDER_ICONS: Record<string, string>;
+//# sourceMappingURL=iconAssets.d.ts.map

package/dist/_types/iconAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconAssets.d.ts","sourceRoot":"","sources":["../../src/iconAssets.ts"],"names":[],"mappings":"AA+EA,gEAAgE;AAChE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuB9C,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY9C,CAAA;AAOD,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGjD,CAAA"}

package/dist/_types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @zerodev/smart-routing-address-react-ui
+ * React hooks, provider, and UI for ZeroDev Smart Routing Address deposits.
+ */
+export type { SmartRoutingAddressProviderProps } from './context/SmartRoutingAddressProvider';
+export { SmartRoutingAddressProvider } from './context/SmartRoutingAddressProvider';
+export type { UseCreateSmartRoutingAddressResult } from './hooks/useCreateSmartRoutingAddress';
+export { useCreateSmartRoutingAddress } from './hooks/useCreateSmartRoutingAddress';
+export type { UseSmartRoutingAddressResult } from './hooks/useSmartRoutingAddress';
+export { useSmartRoutingAddress } from './hooks/useSmartRoutingAddress';
+export type { SmartRoutingAddressProps, SmartRoutingAddressStep, } from './pages';
+export { SmartRoutingAddress } from './pages';
+export type { SmartRoutingAddressConfig } from './types';
+//# sourceMappingURL=index.d.ts.map