@rhinestone/deposit-modal 0.0.0-dev-20260608080045

package/README.md

@@ -0,0 +1,134 @@
+# @rhinestone/deposit-modal
+
+React modal for cross-chain deposits and withdrawals via Rhinestone smart accounts.
+
+## Install
+
+```bash
+npm install @rhinestone/deposit-modal viem
+```
+
+## Example
+
+```tsx
+import { useState } from "react";
+import { DepositModal } from "@rhinestone/deposit-modal/deposit";
+import "@rhinestone/deposit-modal/styles.css";
+
+export function DepositButton({ walletClient, publicClient, address }) {
+  const [open, setOpen] = useState(false);
+
+  return (
+    <>
+      <button onClick={() => setOpen(true)}>Deposit</button>
+      <DepositModal
+        isOpen={open}
+        onClose={() => setOpen(false)}
+        dappWalletClient={walletClient}
+        dappPublicClient={publicClient}
+        dappAddress={address}
+        targetChain={8453}
+        targetToken="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+        onLifecycle={(event) => {
+          switch (event.type) {
+            case "connected":
+              console.log("smart account ready", event.smartAccount);
+              break;
+            case "submitted":
+              console.log("source tx", event.txHash);
+              break;
+            case "complete":
+              console.log("done", event.destinationTxHash);
+              break;
+            case "failed":
+              console.error("failed", event.error);
+              break;
+          }
+        }}
+      />
+    </>
+  );
+}
+```
+
+`WithdrawModal` lives at `@rhinestone/deposit-modal/withdraw` and takes the same shape (`onLifecycle` + `onError`).
+
+## Fiat on-ramp (Swapped)
+
+Pass `enableFiatOnramp` to expose Swapped's iframe as a funding option alongside Transfer Crypto:
+
+```tsx
+<DepositModal
+  enableFiatOnramp
+  // Optionally render one row per Swapped payment method instead of a generic
+  // "Pay with Card" row. `method` must be the `payment_group` value from
+  // Swapped's GET /api/v1/merchant/get_payment_methods — that exact string is
+  // what the widget prepopulates from. Note Apple Pay is `apple-pay` (hyphen),
+  // not `applepay`.
+  fiatOnrampMethods={[
+    { method: "creditcard", label: "Pay with Card", icon: "card" },
+    { method: "apple-pay", label: "Apple Pay", icon: "apple" },
+    { method: "bank-transfer", label: "Bank Transfer", icon: "bank" },
+  ]}
+  // Hide the Transfer Crypto QR row if you only want fiat options:
+  // enableQrTransfer={false}
+  // ...
+/>
+```
+
+The flow: user picks a fiat option → modal registers a Rhinestone smart account → backend mints a server-signed Swapped iframe URL → user completes purchase → Swapped sends crypto on-chain to the smart account → the existing on-chain detection fires `onLifecycle({ type: "complete" })`.
+
+**Destination guarantees.** The user picks the fiat amount inside Swapped's widget, but the destination is fixed server-side: every order receives **USDC on Base** delivered to the **registered Rhinestone smart account**. The frontend cannot override these; the backend signs the Swapped URL with `currencyCode=USDC_BASE` and `walletAddress=<smartAccount>`.
+
+**Fees.** Rhinestone does not charge a markup by default. The client (dapp) controls the user-facing experience via the orchestrator's sponsorship config:
+- **Sponsored** (client has a funded sponsor pool for the source chain): user receives 1:1 — the on-ramped amount lands on the target chain exactly.
+- **Unsponsored**: the bridging cost is deducted from the on-ramped amount and shown as a "Bridging cost" line on the success screen.
+
+Host CSP must allow Swapped's domains:
+
+```
+frame-src https://widget.swapped.com https://sandbox.swapped.com https://connect.swapped.com;
+```
+
+**Submerchant attribution.** Swapped orders are tagged with a `submerchant` for multi-tenant reporting. This is derived automatically server-side from the embedding page's domain (the request `Origin` header) — no configuration is required. In local development the domain resolves to `localhost`.
+
+| Prop                 | Type                          | Default | Description |
+| -------------------- | ----------------------------- | ------- | ----------- |
+| `enableFiatOnramp`   | `boolean`                     | `false` | Show fiat on-ramp option(s). Requires `dappAddress` and backend Swapped keys. |
+| `enableQrTransfer`   | `boolean`                     | `true`  | Show the Transfer Crypto / QR row. Set false for fiat-only. |
+| `fiatOnrampMethods`  | `FiatPaymentMethodOption[]`   | —       | One row per method, each preselects Swapped's payment method via the `method` URL param. |
+
+## Fund from Exchange (Swapped Connect)
+
+Pass `enableExchangeConnect` to expose a "Fund from Exchange" row alongside the existing options. Clicking it opens an exchange picker backed by `/onramp/swapped/connect-exchanges`; after the user picks an exchange, the modal embeds Swapped's Connect iframe for that selected `connection`, signs in, and Swapped pulls the crypto on-chain to the smart account.
+
+```tsx
+<DepositModal
+  enableExchangeConnect
+  // ...
+/>
+```
+
+Flow: user picks Fund from Exchange → backend returns supported exchanges + logos from Swapped using a 24-hour cache → user picks an exchange → modal registers a Rhinestone smart account → backend mints a server-signed Swapped Connect URL with the selected `connection` → user authenticates with their CEX inside the iframe → Swapped pushes crypto on-chain → existing on-chain detection fires `onLifecycle({ type: "complete" })`.
+
+| Prop                     | Type      | Default | Description |
+| ------------------------ | --------- | ------- | ----------- |
+| `enableExchangeConnect`  | `boolean` | `false` | Show the "Fund from Exchange" row. Requires `dappAddress` and backend Swapped keys. Can be combined with `enableFiatOnramp`. |
+
+## Releasing
+
+Releases are driven by [changesets](https://github.com/changesets/changesets) and two GitHub Actions workflows (`.github/workflows/`).
+
+- **Every PR** that changes published behaviour should include a changeset: run `bun run changeset`, pick the bump, and commit the generated `.changeset/*.md`.
+- **Merge to `main` → `@dev` snapshot.** The `Release` workflow publishes a snapshot to npm under the `dev` tag (`npm install @rhinestone/deposit-modal@dev`). Snapshots are only published when there are pending changesets.
+- **Stable release → `release` branch.** Merge `main` into `release`. The `changesets/action` opens a "Release" PR that bumps the version, writes the changelog, and consumes the changeset files. Merging that PR publishes `@latest` to npm and creates the git tag.
+
+Publishing uses npm [OIDC trusted publishing](https://docs.npmjs.com/trusted-publishers) (no stored token). Prerequisites in the `rhinestonewtf/deposit-modal` repo / npm package:
+
+- `@rhinestone/deposit-modal` configured as a trusted publisher on npmjs.com (GitHub Actions, repo `rhinestonewtf/deposit-modal`, workflow `release.yaml`).
+- `APP_ID` / `APP_PRIVATE_KEY` secrets for the `rhinestone-automations` GitHub App (opens the Release PR).
+- A `release` branch and a `ship` label.
+
+## License
+
+MIT

package/dist/DepositModalReown-6SUEC5IU.mjs

@@ -0,0 +1,60 @@
+import {
+  DepositModalInner
+} from "./chunk-KJ2RR2D4.mjs";
+import {
+  ReownWalletProvider,
+  useReownWallet
+} from "./chunk-GPSBM66J.mjs";
+import "./chunk-KAWJABTW.mjs";
+import "./chunk-6YRDD462.mjs";
+
+// src/DepositModalReown.tsx
+import { useCallback, useMemo } from "react";
+import { useAppKitProvider } from "@reown/appkit/react";
+import { useAppKitConnection } from "@reown/appkit-adapter-solana/react";
+import { jsx } from "react/jsx-runtime";
+function DepositModalWithReown(props) {
+  const reown = useReownWallet();
+  const enableSolana = props.enableSolana ?? true;
+  const { walletProvider: solanaWalletProvider } = useAppKitProvider(
+    enableSolana ? "solana" : "eip155"
+  );
+  const { connection: solanaConnection } = useAppKitConnection();
+  const reownWithSolana = useMemo(
+    () => ({
+      ...reown,
+      solanaProvider: enableSolana && reown.isSolana ? solanaWalletProvider : void 0,
+      solanaConnection: enableSolana && reown.isSolana ? solanaConnection : void 0
+    }),
+    [enableSolana, reown, solanaWalletProvider, solanaConnection]
+  );
+  const handleConnect = useCallback(() => {
+    reown.openConnect();
+  }, [reown.openConnect]);
+  const handleDisconnect = useCallback(() => {
+    reown.disconnect();
+  }, [reown.disconnect]);
+  return /* @__PURE__ */ jsx(
+    DepositModalInner,
+    {
+      ...props,
+      reownWallet: reownWithSolana,
+      onConnect: handleConnect,
+      onDisconnect: handleDisconnect
+    }
+  );
+}
+function DepositModalReown(props) {
+  return /* @__PURE__ */ jsx(
+    ReownWalletProvider,
+    {
+      projectId: props.reownAppId,
+      theme: props.theme,
+      enableSolana: props.enableSolana,
+      children: /* @__PURE__ */ jsx(DepositModalWithReown, { ...props })
+    }
+  );
+}
+export {
+  DepositModalReown
+};

package/dist/DepositModalReown-DNW4GH6L.cjs

@@ -0,0 +1,60 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkVVJAIMKBcjs = require('./chunk-VVJAIMKB.cjs');
+
+
+
+var _chunk33H6O5UUcjs = require('./chunk-33H6O5UU.cjs');
+require('./chunk-RABZINV3.cjs');
+require('./chunk-MILJQWPT.cjs');
+
+// src/DepositModalReown.tsx
+var _react = require('react');
+var _react3 = require('@reown/appkit/react');
+var _react5 = require('@reown/appkit-adapter-solana/react');
+var _jsxruntime = require('react/jsx-runtime');
+function DepositModalWithReown(props) {
+  const reown = _chunk33H6O5UUcjs.useReownWallet.call(void 0, );
+  const enableSolana = _nullishCoalesce(props.enableSolana, () => ( true));
+  const { walletProvider: solanaWalletProvider } = _react3.useAppKitProvider.call(void 0, 
+    enableSolana ? "solana" : "eip155"
+  );
+  const { connection: solanaConnection } = _react5.useAppKitConnection.call(void 0, );
+  const reownWithSolana = _react.useMemo.call(void 0, 
+    () => ({
+      ...reown,
+      solanaProvider: enableSolana && reown.isSolana ? solanaWalletProvider : void 0,
+      solanaConnection: enableSolana && reown.isSolana ? solanaConnection : void 0
+    }),
+    [enableSolana, reown, solanaWalletProvider, solanaConnection]
+  );
+  const handleConnect = _react.useCallback.call(void 0, () => {
+    reown.openConnect();
+  }, [reown.openConnect]);
+  const handleDisconnect = _react.useCallback.call(void 0, () => {
+    reown.disconnect();
+  }, [reown.disconnect]);
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _chunkVVJAIMKBcjs.DepositModalInner,
+    {
+      ...props,
+      reownWallet: reownWithSolana,
+      onConnect: handleConnect,
+      onDisconnect: handleDisconnect
+    }
+  );
+}
+function DepositModalReown(props) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _chunk33H6O5UUcjs.ReownWalletProvider,
+    {
+      projectId: props.reownAppId,
+      theme: props.theme,
+      enableSolana: props.enableSolana,
+      children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DepositModalWithReown, { ...props })
+    }
+  );
+}
+
+
+exports.DepositModalReown = DepositModalReown;

package/dist/QRCode-5DXFNKI2.cjs

@@ -0,0 +1,58 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/components/ui/QRCode.tsx
+var _react = require('react');
+var _reactqrcodelogo = require('react-qrcode-logo');
+var _jsxruntime = require('react/jsx-runtime');
+function resolveSurfaceColor(node) {
+  if (!node) return { bg: "#ffffff", fg: "#000000" };
+  const themed = node.closest("[data-theme]");
+  const styles = themed ? getComputedStyle(themed) : getComputedStyle(document.documentElement);
+  const bg = styles.getPropertyValue("--rs-surface-subtle").trim() || "#ffffff";
+  const isDark = _optionalChain([themed, 'optionalAccess', _ => _.dataset, 'access', _2 => _2.theme]) === "dark";
+  const fg = isDark ? "#ffffff" : "#000000";
+  return { bg, fg };
+}
+function QRCode({ value, size = 200, iconSrc, className }) {
+  const wrapperRef = _react.useRef.call(void 0, null);
+  const [colors, setColors] = _react.useState.call(void 0, {
+    bg: "#ffffff",
+    fg: "#000000"
+  });
+  _react.useEffect.call(void 0, () => {
+    const node = wrapperRef.current;
+    if (!node) return;
+    const sync = () => setColors(resolveSurfaceColor(node));
+    sync();
+    const themed = node.closest("[data-theme]");
+    if (!themed) return;
+    const observer = new MutationObserver(sync);
+    observer.observe(themed, {
+      attributes: true,
+      attributeFilter: ["data-theme"]
+    });
+    return () => observer.disconnect();
+  }, []);
+  const { bg: bgColor, fg: fgColor } = colors;
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: wrapperRef, className, role: "img", "aria-label": "QR Code", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _reactqrcodelogo.QRCode,
+    {
+      value,
+      size,
+      qrStyle: "dots",
+      eyeRadius: 50,
+      ecLevel: "H",
+      logoImage: iconSrc,
+      logoWidth: size * 0.22,
+      logoHeight: size * 0.22,
+      logoPaddingStyle: "circle",
+      logoPadding: 5,
+      removeQrCodeBehindLogo: true,
+      quietZone: 0,
+      bgColor,
+      fgColor
+    }
+  ) });
+}
+QRCode.displayName = "QRCode";
+
+
+exports.QRCode = QRCode;

package/dist/QRCode-WUC652SH.mjs

@@ -0,0 +1,58 @@
+// src/components/ui/QRCode.tsx
+import { useEffect, useRef, useState } from "react";
+import { QRCode as QRCodeCanvas } from "react-qrcode-logo";
+import { jsx } from "react/jsx-runtime";
+function resolveSurfaceColor(node) {
+  if (!node) return { bg: "#ffffff", fg: "#000000" };
+  const themed = node.closest("[data-theme]");
+  const styles = themed ? getComputedStyle(themed) : getComputedStyle(document.documentElement);
+  const bg = styles.getPropertyValue("--rs-surface-subtle").trim() || "#ffffff";
+  const isDark = themed?.dataset.theme === "dark";
+  const fg = isDark ? "#ffffff" : "#000000";
+  return { bg, fg };
+}
+function QRCode({ value, size = 200, iconSrc, className }) {
+  const wrapperRef = useRef(null);
+  const [colors, setColors] = useState({
+    bg: "#ffffff",
+    fg: "#000000"
+  });
+  useEffect(() => {
+    const node = wrapperRef.current;
+    if (!node) return;
+    const sync = () => setColors(resolveSurfaceColor(node));
+    sync();
+    const themed = node.closest("[data-theme]");
+    if (!themed) return;
+    const observer = new MutationObserver(sync);
+    observer.observe(themed, {
+      attributes: true,
+      attributeFilter: ["data-theme"]
+    });
+    return () => observer.disconnect();
+  }, []);
+  const { bg: bgColor, fg: fgColor } = colors;
+  return /* @__PURE__ */ jsx("div", { ref: wrapperRef, className, role: "img", "aria-label": "QR Code", children: /* @__PURE__ */ jsx(
+    QRCodeCanvas,
+    {
+      value,
+      size,
+      qrStyle: "dots",
+      eyeRadius: 50,
+      ecLevel: "H",
+      logoImage: iconSrc,
+      logoWidth: size * 0.22,
+      logoHeight: size * 0.22,
+      logoPaddingStyle: "circle",
+      logoPadding: 5,
+      removeQrCodeBehindLogo: true,
+      quietZone: 0,
+      bgColor,
+      fgColor
+    }
+  ) });
+}
+QRCode.displayName = "QRCode";
+export {
+  QRCode
+};

package/dist/WithdrawModalReown-7UAGSOSU.mjs

@@ -0,0 +1,37 @@
+import {
+  WithdrawModalInner
+} from "./chunk-TKQYTBU6.mjs";
+import {
+  ReownWalletProvider,
+  useReownWallet
+} from "./chunk-GPSBM66J.mjs";
+import "./chunk-KAWJABTW.mjs";
+import "./chunk-6YRDD462.mjs";
+
+// src/WithdrawModalReown.tsx
+import { useCallback } from "react";
+import { jsx } from "react/jsx-runtime";
+function WithdrawModalWithReown(props) {
+  const reown = useReownWallet();
+  const handleConnect = useCallback(() => {
+    reown.openConnect();
+  }, [reown.openConnect]);
+  const handleDisconnect = useCallback(() => {
+    reown.disconnect();
+  }, [reown.disconnect]);
+  return /* @__PURE__ */ jsx(
+    WithdrawModalInner,
+    {
+      ...props,
+      reownWallet: reown,
+      onConnect: handleConnect,
+      onDisconnect: handleDisconnect
+    }
+  );
+}
+function WithdrawModalReown(props) {
+  return /* @__PURE__ */ jsx(ReownWalletProvider, { projectId: props.reownAppId, theme: props.theme, children: /* @__PURE__ */ jsx(WithdrawModalWithReown, { ...props }) });
+}
+export {
+  WithdrawModalReown
+};

package/dist/WithdrawModalReown-OUWBSKSM.cjs

@@ -0,0 +1,37 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk2SMS542Qcjs = require('./chunk-2SMS542Q.cjs');
+
+
+
+var _chunk33H6O5UUcjs = require('./chunk-33H6O5UU.cjs');
+require('./chunk-RABZINV3.cjs');
+require('./chunk-MILJQWPT.cjs');
+
+// src/WithdrawModalReown.tsx
+var _react = require('react');
+var _jsxruntime = require('react/jsx-runtime');
+function WithdrawModalWithReown(props) {
+  const reown = _chunk33H6O5UUcjs.useReownWallet.call(void 0, );
+  const handleConnect = _react.useCallback.call(void 0, () => {
+    reown.openConnect();
+  }, [reown.openConnect]);
+  const handleDisconnect = _react.useCallback.call(void 0, () => {
+    reown.disconnect();
+  }, [reown.disconnect]);
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _chunk2SMS542Qcjs.WithdrawModalInner,
+    {
+      ...props,
+      reownWallet: reown,
+      onConnect: handleConnect,
+      onDisconnect: handleDisconnect
+    }
+  );
+}
+function WithdrawModalReown(props) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk33H6O5UUcjs.ReownWalletProvider, { projectId: props.reownAppId, theme: props.theme, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, WithdrawModalWithReown, { ...props }) });
+}
+
+
+exports.WithdrawModalReown = WithdrawModalReown;

package/dist/caip-CsslyHGL.d.cts

@@ -0,0 +1,62 @@
+import { Chain } from 'viem/chains';
+import { Address } from 'viem';
+
+declare function getChainIcon(chainId: number | "solana"): string | undefined;
+declare function getTokenIcon(symbol: string): string | undefined;
+
+declare const DEFAULT_BACKEND_URL = "https://v1.orchestrator.rhinestone.dev/deposit-widget";
+declare const DEFAULT_SIGNER_ADDRESS: Address;
+declare const NATIVE_TOKEN_ADDRESS: Address;
+declare const CHAIN_BY_ID: Record<number, Chain>;
+declare const SOURCE_CHAINS: Chain[];
+declare const SUPPORTED_CHAINS: Chain[];
+type ChainRegistryToken = {
+    symbol: string;
+    address: Address;
+    decimals: number;
+};
+type ChainRegistryEntry = {
+    name: string;
+    tokens: readonly ChainRegistryToken[];
+};
+declare const chainRegistry: Record<string, ChainRegistryEntry>;
+type SupportedTokenOption = {
+    symbol: string;
+    address: Address;
+    decimals: number;
+};
+declare function getChainId(chain: Chain | number): number;
+declare function getChainObject(chain: Chain | number): Chain | undefined;
+declare function getUsdcAddress(chainId: number): Address | undefined;
+declare function getUsdcDecimals(chainId: number): number;
+declare function getTokenAddress(symbol: string, chainId: number): Address | undefined;
+declare function getTokenDecimals(symbol: string, chainId: number): number;
+declare function getTargetTokenSymbolsForChain(chainId: number): string[];
+declare function getSupportedTokenSymbolsForChain(chainId: number): string[];
+declare function getSupportedChainIds(): number[];
+declare function isSupportedTokenAddressForChain(token: Address, chainId: number): boolean;
+declare function getSupportedTargetTokens(chainId: number): SupportedTokenOption[];
+declare function getTokenDecimalsByAddress(token: Address, chainId?: number): number;
+declare function findChainIdForToken(address: Address): number | undefined;
+declare function getTokenSymbol(token: Address, chainId?: number): string;
+declare function getChainName(chainId: number | "solana"): string;
+declare function getChainBadge(chainId: number | "solana"): {
+    shortLabel: string;
+    color: string;
+    bg: string;
+};
+declare function getExplorerUrl(chainId: number | "solana"): string | undefined;
+declare function getExplorerTxUrl(chainId: number | "solana", txHash: string): string | undefined;
+declare function getExplorerName(chainId: number | "solana"): string;
+
+/**
+ * HyperCore — Hyperliquid's virtual trading L1 (chain id 1337), settling on
+ * HyperEVM (999). It is USDC-only and requires an EOA recipient. It has no node
+ * of its own, so `targetChainToCaip2(1337)` still emits `eip155:1337` (the
+ * backend maps 1337 → 999), but it must never be used as an EVM RPC target.
+ */
+declare const HYPERCORE_CHAIN_ID = 1337;
+/** Canonical USDC on HyperEVM (999), the HyperCore settlement chain. */
+declare const HYPERCORE_USDC_ADDRESS = "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
+
+export { CHAIN_BY_ID as C, DEFAULT_BACKEND_URL as D, HYPERCORE_CHAIN_ID as H, NATIVE_TOKEN_ADDRESS as N, SOURCE_CHAINS as S, DEFAULT_SIGNER_ADDRESS as a, HYPERCORE_USDC_ADDRESS as b, SUPPORTED_CHAINS as c, type SupportedTokenOption as d, chainRegistry as e, findChainIdForToken as f, getChainBadge as g, getChainIcon as h, getChainId as i, getChainName as j, getChainObject as k, getExplorerName as l, getExplorerTxUrl as m, getExplorerUrl as n, getSupportedChainIds as o, getSupportedTargetTokens as p, getSupportedTokenSymbolsForChain as q, getTargetTokenSymbolsForChain as r, getTokenAddress as s, getTokenDecimals as t, getTokenDecimalsByAddress as u, getTokenIcon as v, getTokenSymbol as w, getUsdcAddress as x, getUsdcDecimals as y, isSupportedTokenAddressForChain as z };

package/dist/caip-CsslyHGL.d.ts

@@ -0,0 +1,62 @@
+import { Chain } from 'viem/chains';
+import { Address } from 'viem';
+
+declare function getChainIcon(chainId: number | "solana"): string | undefined;
+declare function getTokenIcon(symbol: string): string | undefined;
+
+declare const DEFAULT_BACKEND_URL = "https://v1.orchestrator.rhinestone.dev/deposit-widget";
+declare const DEFAULT_SIGNER_ADDRESS: Address;
+declare const NATIVE_TOKEN_ADDRESS: Address;
+declare const CHAIN_BY_ID: Record<number, Chain>;
+declare const SOURCE_CHAINS: Chain[];
+declare const SUPPORTED_CHAINS: Chain[];
+type ChainRegistryToken = {
+    symbol: string;
+    address: Address;
+    decimals: number;
+};
+type ChainRegistryEntry = {
+    name: string;
+    tokens: readonly ChainRegistryToken[];
+};
+declare const chainRegistry: Record<string, ChainRegistryEntry>;
+type SupportedTokenOption = {
+    symbol: string;
+    address: Address;
+    decimals: number;
+};
+declare function getChainId(chain: Chain | number): number;
+declare function getChainObject(chain: Chain | number): Chain | undefined;
+declare function getUsdcAddress(chainId: number): Address | undefined;
+declare function getUsdcDecimals(chainId: number): number;
+declare function getTokenAddress(symbol: string, chainId: number): Address | undefined;
+declare function getTokenDecimals(symbol: string, chainId: number): number;
+declare function getTargetTokenSymbolsForChain(chainId: number): string[];
+declare function getSupportedTokenSymbolsForChain(chainId: number): string[];
+declare function getSupportedChainIds(): number[];
+declare function isSupportedTokenAddressForChain(token: Address, chainId: number): boolean;
+declare function getSupportedTargetTokens(chainId: number): SupportedTokenOption[];
+declare function getTokenDecimalsByAddress(token: Address, chainId?: number): number;
+declare function findChainIdForToken(address: Address): number | undefined;
+declare function getTokenSymbol(token: Address, chainId?: number): string;
+declare function getChainName(chainId: number | "solana"): string;
+declare function getChainBadge(chainId: number | "solana"): {
+    shortLabel: string;
+    color: string;
+    bg: string;
+};
+declare function getExplorerUrl(chainId: number | "solana"): string | undefined;
+declare function getExplorerTxUrl(chainId: number | "solana", txHash: string): string | undefined;
+declare function getExplorerName(chainId: number | "solana"): string;
+
+/**
+ * HyperCore — Hyperliquid's virtual trading L1 (chain id 1337), settling on
+ * HyperEVM (999). It is USDC-only and requires an EOA recipient. It has no node
+ * of its own, so `targetChainToCaip2(1337)` still emits `eip155:1337` (the
+ * backend maps 1337 → 999), but it must never be used as an EVM RPC target.
+ */
+declare const HYPERCORE_CHAIN_ID = 1337;
+/** Canonical USDC on HyperEVM (999), the HyperCore settlement chain. */
+declare const HYPERCORE_USDC_ADDRESS = "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
+
+export { CHAIN_BY_ID as C, DEFAULT_BACKEND_URL as D, HYPERCORE_CHAIN_ID as H, NATIVE_TOKEN_ADDRESS as N, SOURCE_CHAINS as S, DEFAULT_SIGNER_ADDRESS as a, HYPERCORE_USDC_ADDRESS as b, SUPPORTED_CHAINS as c, type SupportedTokenOption as d, chainRegistry as e, findChainIdForToken as f, getChainBadge as g, getChainIcon as h, getChainId as i, getChainName as j, getChainObject as k, getExplorerName as l, getExplorerTxUrl as m, getExplorerUrl as n, getSupportedChainIds as o, getSupportedTargetTokens as p, getSupportedTokenSymbolsForChain as q, getTargetTokenSymbolsForChain as r, getTokenAddress as s, getTokenDecimals as t, getTokenDecimalsByAddress as u, getTokenIcon as v, getTokenSymbol as w, getUsdcAddress as x, getUsdcDecimals as y, isSupportedTokenAddressForChain as z };