@rhinestone/deposit-modal 0.15.0 → 0.16.0

package/README.md

@@ -5,7 +5,6 @@ React modal for cross-chain deposits and withdrawals via Rhinestone smart accoun
 **[Documentation](https://docs.rhinestone.dev/deposits/widget/quickstart)** ·
 [Deposit modal](https://docs.rhinestone.dev/deposits/widget/deposit-modal) ·
 [Withdraw modal](https://docs.rhinestone.dev/deposits/widget/withdraw-modal) ·
-[Claim modal](https://docs.rhinestone.dev/deposits/widget/claim-modal) ·
 [Backend proxy](https://docs.rhinestone.dev/deposits/widget/backend) ·
 [Migration guide](https://docs.rhinestone.dev/deposits/widget/migration)
 
@@ -149,33 +148,27 @@ Once the form holds a valid recipient, the header offers that **destination's**
 
 Pass the optional `signRecovery` to let the user recover a failed row from the panel; omit it and the panel is read-only. The signer is the address the user is withdrawing **to**, so only supply it if your users can sign for their withdrawal destinations.
 
-## Claim a failed deposit
+## Recovering a failed deposit
 
-`ClaimModal` lets a user get a failed or rejected EVM deposit sent back to them on its source chain. They paste the deposit's transaction hash and name a destination, and there is no chain to pick: the hash is looked up across every chain, including ones the deposit flow itself doesn't list.
+A failed or rejected EVM deposit can be sent back to the user on its source
+chain, and **deposit history is the only surface that offers it**. In the
+deposit modal a failed row expands to a Recover action; in the withdraw modal
+the same panel does, for the destination being withdrawn to. A deposit history
+never lists at all — a spam-flagged one, say — is reachable through the panel's
+"deposit not listed" transaction-hash lookup.
 
-**The modal never runs a connect step** — it has no wallet UI and asks for no provider. It does need a signature from the deposit's `recipient`, which it requests through `signRecovery` using whatever wallet your app already holds for that user. For an embedded wallet that is headless and the user sees nothing but the confirmation your own SDK shows.
-
-```tsx
-import { ClaimModal } from "@rhinestone/deposit-modal/claim";
-
-<ClaimModal
-  isOpen={claimOpen}
-  onClose={() => setClaimOpen(false)}
-  signRecovery={({ typedData }) => wallet.signTypedData(typedData)}
-  backendUrl={process.env.NEXT_PUBLIC_DEPOSIT_PROXY_URL}
-  // Optional prefills:
-  defaultTxHash={depositTxHash}
-  defaultRefundDestination={knownSelfCustodialAddress}
-  onLifecycle={(event) => console.log(event)}
-/>;
-```
+Both modals gate the action on the optional `signRecovery` prop: pass it and a
+failed row offers recovery, omit it and the panel is read-only. There is no
+standalone modal to mount ([removed in 0.16.0](./MIGRATION.md)).
 
 ### Why the user signs
 
 Deposit accounts are owned by the Rhinestone service, so the account holding the
 funds has no user key and cannot sign for its own refund. But the deposit's
 `recipient` — the in-app wallet the funds were headed to — _is_ a key your user
-holds. So that is what authorizes the recovery.
+holds. So that is what authorizes the recovery. In the withdraw modal the signer
+is therefore the address the user is withdrawing **to**, so only supply
+`signRecovery` if your users can sign for their withdrawal destinations.
 
 `signRecovery` is handed the exact typed data to sign plus the `signer` address the
 processor will verify against, and returns a signature. Return whatever that
@@ -199,17 +192,17 @@ signature, so there is no privilege for a page to borrow.
 **Your proxy must forward `POST /deposits/recover`**, alongside the `GET /deposits`
 used for the lookup. Both are in the
 [reference proxy](https://docs.rhinestone.dev/deposits/widget/backend); a proxy
-missing the recover route 404s the claim rather than degrading.
+missing the recover route 404s the recovery rather than degrading.
 
 Two properties fall out of signing that are worth knowing:
 
 - **The destination is inside the signed struct.** The processor cannot pay anywhere
   else, so the success screen states what the user signed rather than trusting the
-  endpoint to report where the money went. `defaultRefundDestination` only _seeds_
-  the field; whatever the user submits is what they sign.
+  endpoint to report where the money went. Whatever the user submits is what they
+  sign.
 - **Failures carry a structured code**, so the modal knows when a retry helps. A
   verification outage is retryable; a rejected signature or a deposit already
-  claimed is not. HTTP status alone can't separate those.
+  recovered is not. HTTP status alone can't separate those.
 
 ### If your users can't sign
 
@@ -233,7 +226,7 @@ export const POST = createRefundHandler({
 });
 ```
 
-The modal does not drive this path — you'd build that UI yourself, or route the user
+No modal drives this path — you'd build that UI yourself, or route the user
 to support. Do **not** proxy `POST /deposits/refund`: unlike recover it carries no
 proof of who is asking, so forwarding it with your API key attached would let anyone
 return any of your recoverable deposits to an address they chose.
@@ -309,7 +302,7 @@ Flow: user picks Fund from Exchange → backend returns supported exchanges + lo
 
 ## Analytics
 
-`onEvent` receives the deposit, withdraw and claim funnels as a session-scoped
+`onEvent` receives the deposit, withdraw and recovery funnels as a session-scoped
 stream:
 every event carries the session id, the modal, the widget version and a snapshot
 of the session's configuration.
@@ -334,6 +327,9 @@ far.
 
 ## Upgrading
 
+0.16.0 removes the standalone claim modal, including the `./claim` subpath and
+the embed page's claim mode. Recovery is reached from deposit history instead.
+
 Upgrading from 0.13.x changes what `onEvent` delivers: the deposit events are
 replaced by a method-aware taxonomy, the five flat claim events are replaced by
 a claim funnel, and every event gains a session envelope. A claim-only

package/dist/{DepositModalReown-R37SSHUF.cjs → DepositModalReown-IFN6YLZJ.cjs}

@@ -1,8 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } 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; }
 
 
-var _chunkVPDCGD2Dcjs = require('./chunk-VPDCGD2D.cjs');
-require('./chunk-X4D52IZK.cjs');
+var _chunkV466XQSGcjs = require('./chunk-V466XQSG.cjs');
 
 
 
@@ -11,8 +10,8 @@ require('./chunk-X4D52IZK.cjs');
 
 
 
-var _chunk3OOY67VJcjs = require('./chunk-3OOY67VJ.cjs');
-require('./chunk-5P2PVLS4.cjs');
+var _chunkH4O22O7Ycjs = require('./chunk-H4O22O7Y.cjs');
+require('./chunk-5CM3ZQ5U.cjs');
 require('./chunk-LVCD6RHF.cjs');
 
 
@@ -45,7 +44,7 @@ var {
   unichain,
   katana,
   hyperEvm
-} = _chunkVPDCGD2Dcjs.getReownDependencies.call(void 0, )[1];
+} = _chunkV466XQSGcjs.getReownDependencies.call(void 0, )[1];
 var APPKIT_NETWORK_BY_ID = {
   [mainnet.id]: mainnet,
   [optimism.id]: optimism,
@@ -77,7 +76,7 @@ function getAppKitNetwork(chainId) {
 
 // src/core/reown-theme.ts
 function mapTheme(theme) {
-  const themeMode = _chunk3OOY67VJcjs.resolveThemeMode.call(void 0, _optionalChain([theme, 'optionalAccess', _ => _.mode])) === "light" ? "light" : "dark";
+  const themeMode = _chunkH4O22O7Ycjs.resolveThemeMode.call(void 0, _optionalChain([theme, 'optionalAccess', _ => _.mode])) === "light" ? "light" : "dark";
   const themeVariables = {
     "--apkt-accent": _optionalChain([theme, 'optionalAccess', _2 => _2.ctaColor])
   };
@@ -94,7 +93,7 @@ function setAppKitTheme(appKit, theme) {
 
 // src/core/reown.tsx
 var _jsxruntime = require('react/jsx-runtime');
-var [appKitReact, appKitNetworks, wagmiAdapter, solanaAdapter] = _chunkVPDCGD2Dcjs.getReownDependencies.call(void 0, );
+var [appKitReact, appKitNetworks, wagmiAdapter, solanaAdapter] = _chunkV466XQSGcjs.getReownDependencies.call(void 0, );
 var {
   createAppKit,
   useAppKit,
@@ -110,14 +109,14 @@ function buildTransports(rpcUrls, networks = EVM_NETWORKS) {
   const transports = {};
   for (const network of networks) {
     const id = Number(network.id);
-    transports[id] = _viem.http.call(void 0, _chunk3OOY67VJcjs.rpcUrlFor.call(void 0, rpcUrls, id));
+    transports[id] = _viem.http.call(void 0, _chunkH4O22O7Ycjs.rpcUrlFor.call(void 0, rpcUrls, id));
   }
   return transports;
 }
 function getEvmRpcFingerprint(rpcUrls, networks) {
   return networks.map((network) => {
     const id = Number(network.id);
-    return `${id}=${_nullishCoalesce(_chunk3OOY67VJcjs.rpcUrlFor.call(void 0, rpcUrls, id), () => ( ""))}`;
+    return `${id}=${_nullishCoalesce(_chunkH4O22O7Ycjs.rpcUrlFor.call(void 0, rpcUrls, id), () => ( ""))}`;
   }).join("|");
 }
 var cachedAdapter = null;
@@ -188,7 +187,7 @@ function ReownWalletProvider({
   backendUrl,
   children
 }) {
-  const rpcUrls = _chunk3OOY67VJcjs.useStableRpcUrls.call(void 0, rpcUrlsProp);
+  const rpcUrls = _chunkH4O22O7Ycjs.useStableRpcUrls.call(void 0, rpcUrlsProp);
   const [queryClient] = _react.useState.call(void 0, () => new (0, _reactquery.QueryClient)());
   const overrides = _react.useMemo.call(void 0, () => {
     if (!rpcUrls) return void 0;
@@ -200,14 +199,14 @@ function ReownWalletProvider({
     return out;
   }, [rpcUrls]);
   const [state, setState] = _react.useState.call(void 0, () => {
-    const primed = _chunk3OOY67VJcjs.peekRuntimeChains.call(void 0, backendUrl, overrides);
+    const primed = _chunkH4O22O7Ycjs.peekRuntimeChains.call(void 0, backendUrl, overrides);
     return { ready: primed !== null, chains: _nullishCoalesce(primed, () => ( [])) };
   });
   _react.useEffect.call(void 0, () => {
     let active = true;
-    const primed = _chunk3OOY67VJcjs.peekRuntimeChains.call(void 0, backendUrl, overrides);
+    const primed = _chunkH4O22O7Ycjs.peekRuntimeChains.call(void 0, backendUrl, overrides);
     setState({ ready: primed !== null, chains: _nullishCoalesce(primed, () => ( [])) });
-    _chunk3OOY67VJcjs.primeRuntimeChains.call(void 0, backendUrl, overrides).then((chains) => {
+    _chunkH4O22O7Ycjs.primeRuntimeChains.call(void 0, backendUrl, overrides).then((chains) => {
       if (active) setState({ ready: true, chains });
     });
     return () => {
@@ -216,7 +215,7 @@ function ReownWalletProvider({
   }, [backendUrl, overrides]);
   _react.useEffect.call(void 0, () => {
     setAppKitTheme(appKitReact.modal, theme);
-    return _chunk3OOY67VJcjs.followSystemAppearance.call(void 0, 
+    return _chunkH4O22O7Ycjs.followSystemAppearance.call(void 0, 
       _optionalChain([theme, 'optionalAccess', _7 => _7.mode]),
       () => setAppKitTheme(appKitReact.modal, theme)
     );
@@ -280,7 +279,7 @@ function useReownWalletSession() {
           await switchChainAsync({ chainId });
         }
       } catch (err) {
-        if (_chunk3OOY67VJcjs.isUnsupportedChainSwitchError.call(void 0, err)) {
+        if (_chunkH4O22O7Ycjs.isUnsupportedChainSwitchError.call(void 0, err)) {
           throw new Error(
             `Switch to ${chainDisplayName(chainId)} in your wallet to continue`
           );
@@ -293,7 +292,7 @@ function useReownWalletSession() {
 
 // src/DepositModalReown.tsx
 
-var [appKitReact2, , , , solanaAdapterReact] = _chunkVPDCGD2Dcjs.getReownDependencies.call(void 0, );
+var [appKitReact2, , , , solanaAdapterReact] = _chunkV466XQSGcjs.getReownDependencies.call(void 0, );
 var { useAppKitProvider } = appKitReact2;
 var { useAppKitConnection } = solanaAdapterReact;
 function DepositModalWithReown(props) {
@@ -315,7 +314,7 @@ function DepositModalWithReown(props) {
     reown.disconnect();
   }, [reown.disconnect]);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkVPDCGD2Dcjs.DepositModalInner,
+    _chunkV466XQSGcjs.DepositModalInner,
     {
       ...props,
       walletSession: reownWithSolana,

package/dist/{DepositModalReown-KOJ7VEY7.mjs → DepositModalReown-R7UROJPJ.mjs}

@@ -1,8 +1,7 @@
 import {
   DepositModalInner,
   getReownDependencies
-} from "./chunk-IKUYZA7A.mjs";
-import "./chunk-UCBUCX2W.mjs";
+} from "./chunk-F6ROQ6RJ.mjs";
 import {
   followSystemAppearance,
   isUnsupportedChainSwitchError,
@@ -11,8 +10,8 @@ import {
   resolveThemeMode,
   rpcUrlFor,
   useStableRpcUrls
-} from "./chunk-5VONFVQN.mjs";
-import "./chunk-CXBMIZUF.mjs";
+} from "./chunk-EA5CE2UZ.mjs";
+import "./chunk-3HCCR54R.mjs";
 import "./chunk-FTWKAJGN.mjs";
 import {
   SUPPORTED_CHAIN_IDS,

package/dist/WithdrawModal-SZEAI473.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk24N4KMJXcjs = require('./chunk-24N4KMJX.cjs');
+require('./chunk-H4O22O7Y.cjs');
+require('./chunk-5CM3ZQ5U.cjs');
+require('./chunk-OY5N3E6L.cjs');
+
+
+
+exports.WithdrawModal = _chunk24N4KMJXcjs.WithdrawModal; exports.buildWithdrawAnalyticsSessionProperties = _chunk24N4KMJXcjs.buildWithdrawAnalyticsSessionProperties;

package/dist/{WithdrawModal-QVXHMH43.mjs → WithdrawModal-XKSSHVEJ.mjs}

@@ -1,10 +1,9 @@
 import {
   WithdrawModal,
   buildWithdrawAnalyticsSessionProperties
-} from "./chunk-7UQ6OUEE.mjs";
-import "./chunk-UCBUCX2W.mjs";
-import "./chunk-5VONFVQN.mjs";
-import "./chunk-CXBMIZUF.mjs";
+} from "./chunk-HMB2XQGD.mjs";
+import "./chunk-EA5CE2UZ.mjs";
+import "./chunk-3HCCR54R.mjs";
 import "./chunk-EAGMY3QE.mjs";
 export {
   WithdrawModal,