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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAA;AAC7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAA;AAMnF,YAAY,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAA;AAC9F,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AACnF,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAGvE,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAG7C,YAAY,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA"}

package/dist/_types/pages/Deposit.d.ts

@@ -0,0 +1,12 @@
+import type { DepositedToken } from '@zerodev/smart-routing-address';
+export interface DepositProps {
+    onQrClick?: () => void;
+    /** Navigate to the "Past deposits" view. When omitted, the row is hidden. */
+    onViewPastDeposits?: () => void;
+    /** Fired when a pending-deposit row is tapped. Wires through to
+     * `PendingDeposits` so an in-flight deposit opens the transaction-details
+     * view, matching the past-deposits behaviour. */
+    onSelectDeposit?: (deposit: DepositedToken) => void;
+}
+export declare function Deposit({ onQrClick, onViewPastDeposits, onSelectDeposit, }: DepositProps): import("react").JSX.Element;
+//# sourceMappingURL=Deposit.d.ts.map

package/dist/_types/pages/Deposit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deposit.d.ts","sourceRoot":"","sources":["../../../src/pages/Deposit.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,gCAAgC,CAAA;AAiChF,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC/B;;qDAEiD;IACjD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;CACpD;AAYD,wBAAgB,OAAO,CAAC,EACtB,SAAS,EACT,kBAAkB,EAClB,eAAe,GAChB,EAAE,YAAY,+BA4fd"}

package/dist/_types/pages/PastDeposits.d.ts

@@ -0,0 +1,14 @@
+import type { DepositedToken } from '@zerodev/smart-routing-address';
+export interface PastDepositsProps {
+    /** 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;
+}
+/**
+ * Past deposits view — full history, grouped by day, newest first. Each row
+ * is a `TxnItem`; layout matches the deposit's `PendingDeposits` card so the
+ * two views share one visual language.
+ */
+export declare function PastDeposits({ onSelectDeposit }: PastDepositsProps): import("react").JSX.Element;
+//# sourceMappingURL=PastDeposits.d.ts.map

package/dist/_types/pages/PastDeposits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PastDeposits.d.ts","sourceRoot":"","sources":["../../../src/pages/PastDeposits.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAuEpE,MAAM,WAAW,iBAAiB;IAChC;;6CAEyC;IACzC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;CACpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,eAAe,EAAE,EAAE,iBAAiB,+BAmJlE"}

package/dist/_types/pages/TransactionDetails.d.ts

@@ -0,0 +1,11 @@
+import type { DepositWithTimestamp } from '../types';
+export interface TransactionDetailsProps {
+    deposit: DepositWithTimestamp;
+}
+/**
+ * Transaction details view (Figma `17634:105049`) — token hero pair via
+ * `ArrowCardPair` + `InfoCard`, a "Transaction details" `Section` with the
+ * route metadata, and a "Transaction Progress" `Section` with the step trail.
+ */
+export declare function TransactionDetails({ deposit: initialDeposit, }: TransactionDetailsProps): import("react").JSX.Element;
+//# sourceMappingURL=TransactionDetails.d.ts.map

package/dist/_types/pages/TransactionDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionDetails.d.ts","sourceRoot":"","sources":["../../../src/pages/TransactionDetails.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAapD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,CAAA;CAC9B;AAyCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EAAE,cAAc,GACxB,EAAE,uBAAuB,+BAqNzB"}

package/dist/_types/pages/index.d.ts

@@ -0,0 +1,25 @@
+import type { Address } from 'viem';
+/**
+ * Steps rendered by `SmartRoutingAddress`. Sub-views advance/rewind local
+ * step state; the widget owns navigation and the `TopNav` chrome accordingly.
+ */
+export type SmartRoutingAddressStep = 'deposit' | 'past' | 'transaction';
+/**
+ * The Figma "Deposit funds" flow (`17634:104268` / `18721:96092`).
+ *
+ * Owns the shared `Screen` + `TopNav` chrome and delegates the body to the
+ * current page in this directory. Mirrors the layout of `wallet-react-ui`'s
+ * `auth/index.tsx` and `signing/index.tsx`.
+ *
+ * Wrap the subtree with `<SmartRoutingAddressProvider config={…}>` first.
+ */
+export interface SmartRoutingAddressProps {
+    /** Recipient address the smart routing address is created for. */
+    recipient: Address;
+    /** Called when the top-right × close button is clicked. */
+    onClose: () => void;
+    className?: string;
+    size?: 'sm' | 'md' | 'lg';
+}
+export declare function SmartRoutingAddress({ recipient, onClose, className, size, }: SmartRoutingAddressProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/pages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pages/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAA;AA4CxE;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,OAAO,EACP,SAAS,EACT,IAAI,GACL,EAAE,wBAAwB,+BAmF1B"}

package/dist/_types/types.d.ts

@@ -0,0 +1,75 @@
+import type { CreateSmartRoutingAddressParams, DepositedToken, GetSmartRoutingAddressFeeEstimatesReturns, SmartRoutingAddressVersion, TOKEN_TYPE } from '@zerodev/smart-routing-address';
+import type { Address, Chain } from 'viem';
+/** `DepositedToken` with the optional `createdAt` some SRA servers ship
+ * alongside the response. The SDK's public type doesn't include it yet, so
+ * we model it as an optional augmentation here — one canonical shape shared
+ * by the pending/past/detail views. */
+export type DepositWithTimestamp = DepositedToken & {
+    createdAt?: string;
+};
+export type EstimatedFee = GetSmartRoutingAddressFeeEstimatesReturns['estimatedFees'][number];
+export type EstimatedFeeData = EstimatedFee['data'][number];
+/** Internal chain-object form of a source token */
+export type SourceToken = {
+    tokenType: TOKEN_TYPE;
+    chain: Chain;
+    minAmount?: bigint;
+};
+export type SmartRoutingAddressConfig = {
+    /**
+     * ZeroDev project id; when non-empty it is appended to the server URL
+     * for every request
+     */
+    projectId?: string;
+    /** Chain id where funds settle */
+    targetChainId: number;
+    /** Smart routing address version, defaults to the latest stable */
+    version?: SmartRoutingAddressVersion;
+    /**
+     * Destination actions per token type. When omitted, funds are simply
+     * transferred to the owner.
+     */
+    actions?: CreateSmartRoutingAddressParams['actions'];
+    /** Max slippage in basis points (50 = 0.5%) */
+    slippage?: number;
+    /**
+     * Override the smart routing address server root URL; the projectId is
+     * appended to it
+     */
+    baseUrl?: string;
+};
+export type AddressState = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'success';
+    address: Address;
+    estimatedFees: EstimatedFee[];
+} | {
+    status: 'error';
+    error: Error;
+};
+export type DepositStage = 'pending' | 'bridging' | 'completed' | 'failed';
+/**
+ * The route the deposit UI is currently showing (selected source token +
+ * chain + estimated fee), surfaced through context so hosts can mirror it —
+ * e.g. a demo "send" panel that matches the chosen token, or analytics.
+ */
+export type ActiveRoute = {
+    /** Source chain id the deposit would come from */
+    sourceChainId: number;
+    /** Source chain display name (e.g. "Base") */
+    sourceChainName: string;
+    /** On-chain address of the selected source token */
+    token: Address;
+    /** Display symbol of the selected source token (e.g. "USDC", "ETH") */
+    symbol: string;
+    /** Decimals of the selected source token */
+    decimals: number;
+    /** Estimated all-in fee amount in source-token atomic units, as a
+     * base-10 string (e.g. `"250000"` for 0.25 USDC). Consumers can pass it
+     * straight to `BigInt()` or `parseInt(x, 10)`. */
+    feeAmount: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,cAAc,EACd,yCAAyC,EACzC,0BAA0B,EAC1B,UAAU,EACX,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAE1C;;;uCAGuC;AACvC,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1E,MAAM,MAAM,YAAY,GACtB,yCAAyC,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,UAAU,CAAA;IACrB,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,OAAO,CAAC,EAAE,0BAA0B,CAAA;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,+BAA+B,CAAC,SAAS,CAAC,CAAA;IACpD,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IACE,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,YAAY,EAAE,CAAA;CAC9B,GACD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAErC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE1E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAA;IACrB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAA;IACd,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB;;sDAEkD;IAClD,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA"}

package/dist/_types/utils/chains.d.ts

@@ -0,0 +1,8 @@
+import type { Chain } from 'viem';
+/** Resolve a chain id to its viem chain object, throwing for unknown ids */
+export declare function getChainById(chainId: number): Chain;
+/** Block explorer URL for a transaction, or `undefined` when no explorer is
+ * known. Returns `undefined` (not `null`) so the value can be passed straight
+ * to optional link `href` props under `exactOptionalPropertyTypes`. */
+export declare function getTxUrl(chainId: number, transactionHash: string): string | undefined;
+//# sourceMappingURL=chains.d.ts.map

package/dist/_types/utils/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../src/utils/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAGjC,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CASnD;AAED;;uEAEuE;AACvE,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAIpB"}

package/dist/_types/utils/config.d.ts

@@ -0,0 +1,35 @@
+import type { CreateSmartRoutingAddressParams, SmartRoutingAddressVersion } from '@zerodev/smart-routing-address';
+import { type Address, type Chain } from 'viem';
+import type { EstimatedFee, SmartRoutingAddressConfig, SourceToken } from '../types';
+export declare function resolveVersion(config: SmartRoutingAddressConfig): SmartRoutingAddressVersion;
+/**
+ * Server URL for all smart routing address requests: the server root
+ * (default or `config.baseUrl`) with the ZeroDev project id appended.
+ * Without a project id the URL is only overridden when `config.baseUrl`
+ * is set; undefined leaves the SDK default in place.
+ */
+export declare function resolveBaseUrl(config: SmartRoutingAddressConfig): string | undefined;
+export declare function resolveDashboardUrl(address?: string): string;
+/** Chain where the routed funds settle */
+export declare function resolveDestChain(config: SmartRoutingAddressConfig): Chain;
+/**
+ * The DEFAULT_SOURCE_TOKENS, excluding token types that do not exist on the
+ * destination chain (the default actions deliver the deposited token type
+ * there, so a missing destination token would make the deposit unfulfillable).
+ */
+export declare function resolveSourceTokens(config: SmartRoutingAddressConfig): SourceToken[];
+/**
+ * Source tokens the server actually returned routes for, taken straight from
+ * the fee estimates. Each returned (chain, token address) pair is matched back
+ * to a DEFAULT_SOURCE_TOKENS entry to recover its TOKEN_TYPE.
+ */
+export declare function sourceTokensFromFees(estimatedFees: EstimatedFee[]): SourceToken[];
+/**
+ * Destination actions for every resolved source token type: ERC-20 deposits
+ * are transferred to the recipient and native deposits are forwarded as
+ * value. FLEX placeholders are resolved by the server per deposit.
+ */
+export declare function resolveActions(config: SmartRoutingAddressConfig, recipient: Address): CreateSmartRoutingAddressParams['actions'];
+/** Display symbol for a source token (native tokens use the chain symbol) */
+export declare function getSourceTokenSymbol(source: SourceToken): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/_types/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,0BAA0B,EAE3B,MAAM,gCAAgC,CAAA;AAQvC,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,MAAM,CAAA;AAEzD,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,WAAW,EACZ,MAAM,UAAU,CAAA;AAIjB,wBAAgB,cAAc,CAC5B,MAAM,EAAE,yBAAyB,GAChC,0BAA0B,CAE5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,yBAAyB,GAChC,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,yBAAyB,GAAG,KAAK,CAEzE;AAYD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,yBAAyB,GAChC,WAAW,EAAE,CAKf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,YAAY,EAAE,GAC5B,WAAW,EAAE,CAWf;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,yBAAyB,EACjC,SAAS,EAAE,OAAO,GACjB,+BAA+B,CAAC,SAAS,CAAC,CAsB5C;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQhE"}

package/dist/_types/utils/deposits.d.ts

@@ -0,0 +1,29 @@
+import type { DepositedToken } from '@zerodev/smart-routing-address';
+import type { DepositStage, EstimatedFee, SmartRoutingAddressConfig } from '../types';
+export declare const DEPOSIT_STAGE_LABELS: Record<DepositStage, string>;
+/**
+ * Newer SRA servers split a deposit into legs that each carry their own
+ * bridge/execution status; the published SDK types don't include the
+ * field yet, so it is modeled here as an optional extension.
+ */
+export type DepositSplitLeg = Pick<DepositedToken, 'bridge' | 'execution'> & {
+    splitIndex: number;
+    amount: string;
+};
+export type DepositWithSplits = DepositedToken & {
+    splits?: DepositSplitLeg[];
+};
+export declare function getDepositKey(deposit: DepositedToken): string;
+export declare function getDepositStage(deposit: DepositWithSplits): DepositStage;
+export declare function getNewDeposits(deposits: DepositedToken[], baseline: ReadonlySet<string>): DepositedToken[];
+export type DepositSummary = {
+    key: string;
+    stage: DepositStage;
+    stageLabel: string;
+    chainName: string;
+    symbol: string;
+    amount: string;
+    transactionHash: string;
+};
+export declare function summarizeDeposit(deposit: DepositedToken, estimatedFees: EstimatedFee[], config: SmartRoutingAddressConfig): DepositSummary;
+//# sourceMappingURL=deposits.d.ts.map

package/dist/_types/utils/deposits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposits.d.ts","sourceRoot":"","sources":["../../../src/utils/deposits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,yBAAyB,EAC1B,MAAM,UAAU,CAAA;AAKjB,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAK7D,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,WAAW,CAAC,GAAG;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG;IAC/C,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;CAC3B,CAAA;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE7D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAoBxE;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EAAE,EAC1B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,cAAc,EAAE,CAElB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAcD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,YAAY,EAAE,EAC7B,MAAM,EAAE,yBAAyB,GAChC,cAAc,CAehB"}

package/dist/_types/utils/fees.d.ts

@@ -0,0 +1,14 @@
+import type { TOKEN_TYPE } from '@zerodev/smart-routing-address';
+import type { Address } from 'viem';
+import type { EstimatedFee, EstimatedFeeData } from '../types';
+/**
+ * Resolve the on-chain token address used by the routing server for a given
+ * token type on a chain. Returns null when the type cannot be resolved
+ * (generic ERC20 or unknown token on that chain).
+ */
+export declare function resolveTokenAddress(tokenType: TOKEN_TYPE, chainId: number): Address | null;
+/** Whether the token type resolves to the given on-chain address on a chain. */
+export declare function tokenAddressMatches(tokenType: TOKEN_TYPE, chainId: number, token: Address): boolean;
+export declare function findFeeDataByToken(estimatedFees: EstimatedFee[], chainId: number, token: Address): EstimatedFeeData | null;
+export declare function findFeeData(estimatedFees: EstimatedFee[], chainId: number, tokenType: TOKEN_TYPE): EstimatedFeeData | null;
+//# sourceMappingURL=fees.d.ts.map

package/dist/_types/utils/fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.d.ts","sourceRoot":"","sources":["../../../src/utils/fees.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE9D;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,GAAG,IAAI,CAIhB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,OAAO,CAGT;AAED,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,IAAI,CAMzB;AAED,wBAAgB,WAAW,CACzB,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,GACpB,gBAAgB,GAAG,IAAI,CAIzB"}

package/dist/_types/utils/format.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Format a raw token amount (decimal string, hex string or bigint) into a
+ * human readable unit string. Falls back to the raw value if parsing fails.
+ */
+export declare function formatTokenAmount(value: string | bigint, decimals: number): string;
+/** Rounding direction for display amounts. `'up'` / `'down'` are ceil / floor
+ * — use them for values where over- or under-stating is unsafe (fees, min
+ * deposit). `'nearest'` is `Math.round` — use for values the user reads as a
+ * final quantity ("you received X") so 249.9996… reads as 250.00. */
+export type RoundDirection = 'up' | 'down' | 'nearest';
+/**
+ * Format a raw token amount for display: thousands grouping and a
+ * magnitude-aware precision (whole numbers above 1000, two decimals above 1,
+ * two significant digits below). Rounds in the given direction so limits and
+ * fees are never overstated/understated. Falls back to the raw value if
+ * parsing fails.
+ */
+export declare function formatDisplayAmount(value: string | bigint, decimals: number, round: RoundDirection): string;
+export declare function truncateAddress(address: string): string;
+export declare function formatSlippage(basisPoints: number): string;
+export declare function formatDuration(seconds: number): string;
+/** Symbols treated as ~$1, so a USD equivalent can be shown for their amounts */
+export declare const STABLE_SYMBOLS: Set<string>;
+/** ISO timestamp → compact "N unit ago" ("just now", "2 m ago", "3 h ago",
+ * "5 d ago", "2 mo ago", "1 y ago"). Returns `null` on invalid input. */
+export declare function formatRelativeTime(iso: string, now?: number): string | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/_types/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED;;;qEAGqE;AACrE,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;AAStD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GACpB,MAAM,CAmBR;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,aAMzB,CAAA;AAEF;yEACyE;AACzE,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAmB,GACvB,MAAM,GAAG,IAAI,CAgBf"}

package/dist/_types/utils/providerFees.d.ts

@@ -0,0 +1,103 @@
+import { z } from 'zod/mini';
+import type { EstimatedFeeData } from '../types';
+/**
+ * Standardised fee breakdown shared across routing providers. Each provider
+ * (Across, Relay, …) exposes fees in its own shape; the parsers below map
+ * them onto this single model so the fees view can render any of them
+ * identically.
+ *
+ * A leg is either a `rate` (proportional to the deposit, e.g. capital / LP)
+ * or `flat` (a fixed cost, e.g. destination gas). Because the deposit amount
+ * is not known up front, each leg is shown only in its amount-invariant
+ * form: a percentage for rates, a fixed USD value for flat costs.
+ */
+export type FeeKind = 'rate' | 'flat';
+export type FeeLine = {
+    key: string;
+    label: string;
+    kind: FeeKind;
+    /** Right-aligned accent: gas pump for gas legs, $ disc otherwise */
+    accent: 'gas' | 'usd';
+    /** Proportional rate as a percent (e.g. 0.01 for 0.01%); rate legs only */
+    pct: number | null;
+    /** USD value at the quoted amount; the display value for flat legs */
+    usd: number | null;
+    /** Raw fallback text (e.g. a token amount) when neither pct nor usd applies */
+    text?: string;
+    /** True when the leg is waived (shown as "Sponsored") */
+    sponsored?: boolean;
+};
+export type FeeBreakdown = {
+    /** Routing provider, or null when no itemised provider data is available */
+    provider: string | null;
+    lines: FeeLine[];
+    /** Combined proportional rate as a percent, e.g. 0.013 for "0.013%" */
+    ratePct: number | null;
+    /** Combined flat (fixed) cost in USD */
+    flatUsd: number | null;
+    /** Full cost in USD at the quoted amount — used to compare routes */
+    quotedTotalUsd: number | null;
+    /** Headline fallback when USD isn't derivable (e.g. "0.00002 ETH") */
+    totalText: string | null;
+    /** Estimated fill time in seconds, when the provider reports it */
+    fillTimeSec: number | null;
+};
+export declare const AcrossSuggestedFeesSchema: z.ZodMiniObject<{
+    totalRelayFee: z.ZodMiniObject<{
+        pct: z.ZodMiniString<string>;
+        total: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    relayerCapitalFee: z.ZodMiniObject<{
+        pct: z.ZodMiniString<string>;
+        total: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    relayerGasFee: z.ZodMiniObject<{
+        pct: z.ZodMiniString<string>;
+        total: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    lpFee: z.ZodMiniObject<{
+        pct: z.ZodMiniString<string>;
+        total: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    estimatedFillTimeSec: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strip>;
+export type AcrossSuggestedFees = z.infer<typeof AcrossSuggestedFeesSchema>;
+export declare function parseAcrossFees(res: AcrossSuggestedFees, symbol: string, decimals: number): FeeBreakdown;
+export declare const RelayQuoteSchema: z.ZodMiniObject<{
+    fees: z.ZodMiniOptional<z.ZodMiniObject<{
+        gas: z.ZodMiniOptional<z.ZodMiniObject<{
+            amountUsd: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>>;
+        relayer: z.ZodMiniOptional<z.ZodMiniObject<{
+            amountUsd: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>>;
+        relayerGas: z.ZodMiniOptional<z.ZodMiniObject<{
+            amountUsd: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>>;
+        relayerService: z.ZodMiniOptional<z.ZodMiniObject<{
+            amountUsd: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>>;
+        app: z.ZodMiniOptional<z.ZodMiniObject<{
+            amountUsd: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    details: z.ZodMiniOptional<z.ZodMiniObject<{
+        timeEstimate: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strip>>;
+    timeEstimate: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strip>;
+export type RelayQuote = z.infer<typeof RelayQuoteSchema>;
+export declare function parseRelayFees(res: RelayQuote): FeeBreakdown;
+/**
+ * Present the SRA fee as the actual all-in charge, with the provider's
+ * bridge legs as a breakdown *of* it (not added on top — the SRA server fee
+ * already covers bridging + execution). The execution portion is derived as
+ * `SRA fee − bridge cost` so the legs sum back to the SRA fee. Without
+ * provider data, the whole SRA fee is shown as a single execution line.
+ */
+export declare function buildFeeBreakdown(feeData: EstimatedFeeData, symbol: string, provider?: FeeBreakdown | null): FeeBreakdown;
+/** Format a percent number for display, trimming to a sensible precision */
+export declare function formatFeePct(pct: number): string;
+/** Format a USD number for display */
+export declare function formatFeeUsd(usd: number): string;
+//# sourceMappingURL=providerFees.d.ts.map

package/dist/_types/utils/providerFees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerFees.d.ts","sourceRoot":"","sources":["../../../src/utils/providerFees.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAA;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAErC,MAAM,MAAM,OAAO,GAAG;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb,oEAAoE;IACpE,MAAM,EAAE,KAAK,GAAG,KAAK,CAAA;IACrB,2EAA2E;IAC3E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,sEAAsE;IACtE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,wCAAwC;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,qEAAqE;IACrE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,sEAAsE;IACtE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AA4BD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;iBAMpC,CAAA;AAGF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AA6B3E,wBAAgB,eAAe,CAC7B,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,YAAY,CAkCd;AAaD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;iBAgB3B,CAAA;AAGF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAQzD,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CAgC5D;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,YAAY,GAAG,IAAW,GACnC,YAAY,CA4Cd;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhD"}