@iamgame/wallet-sdk 0.1.4 → 0.1.5

package/dist/index.cjs

@@ -1,9 +1,13 @@
 'use strict';
 
-var react = require('react');
+var React = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var reactDom = require('react-dom');
 
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
 // ../../solven/sdk-client/src/errors.ts
 var SolvenSdkError = class _SolvenSdkError extends Error {
   constructor(args) {
@@ -268,22 +272,48 @@ function notifyTelegramReady() {
   } catch {
   }
 }
-var SolvenContext = react.createContext(null);
+var SolvenContext = React.createContext(null);
 function useSolvenContext() {
-  const ctx = react.useContext(SolvenContext);
+  const ctx = React.useContext(SolvenContext);
   if (!ctx) throw new Error("useSolvenContext must be inside a <SolvenProvider />");
   return ctx;
 }
-function SolvenProvider({ children, autoTelegram = true, ...opts }) {
-  const client = react.useMemo(() => new SolvenClient(opts), [
+function useSolvenReportError() {
+  return useSolvenContext().reportError;
+}
+var SolvenErrorBoundary = class extends React__default.default.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    this.props.onError(error, { operation: "render" });
+  }
+  render() {
+    return this.state.hasError ? null : this.props.children;
+  }
+};
+function SolvenProvider({ children, autoTelegram = true, onError, ...opts }) {
+  const client = React.useMemo(() => new SolvenClient(opts), [
     opts.publishableKey,
     opts.baseUrl,
     opts.storage,
     opts.fetchImpl
   ]);
-  const [session, setSession] = react.useState(client.getSession());
-  const [status, setStatus] = react.useState("loading");
-  react.useEffect(() => {
+  const [session, setSession] = React.useState(client.getSession());
+  const [status, setStatus] = React.useState("loading");
+  const onErrorRef = React.useRef(onError);
+  onErrorRef.current = onError;
+  const reportError = React.useCallback((error, context) => {
+    try {
+      onErrorRef.current?.(error, context);
+    } catch {
+    }
+  }, []);
+  React.useEffect(() => {
     let cancelled = false;
     (async () => {
       const stored = client.getSession();
@@ -315,8 +345,8 @@ function SolvenProvider({ children, autoTelegram = true, ...opts }) {
       cancelled = true;
     };
   }, [client]);
-  const triedTelegram = react.useRef(false);
-  react.useEffect(() => {
+  const triedTelegram = React.useRef(false);
+  React.useEffect(() => {
     if (!autoTelegram || status !== "anonymous" || triedTelegram.current) return;
     triedTelegram.current = true;
     let cancelled = false;
@@ -348,15 +378,16 @@ function SolvenProvider({ children, autoTelegram = true, ...opts }) {
     setSession: (s) => {
       setSession(s);
       setStatus(s ? "authenticated" : "anonymous");
-    }
+    },
+    reportError
   };
-  return /* @__PURE__ */ jsxRuntime.jsx(SolvenContext.Provider, { value, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(SolvenContext.Provider, { value, children: /* @__PURE__ */ jsxRuntime.jsx(SolvenErrorBoundary, { onError: reportError, children }) });
 }
 
 // ../../solven/sdk-client/src/hooks.ts
 function useSolvenAuth() {
   const { client, session, status, setSession } = useSolvenContext();
-  const connectExternal = react.useCallback(
+  const connectExternal = React.useCallback(
     async (adapter) => {
       const { publicKey } = await adapter.connect();
       const challenge = await client.requestSiwsChallenge(publicKey);
@@ -367,27 +398,27 @@ function useSolvenAuth() {
     },
     [client, setSession]
   );
-  const connectTelegram = react.useCallback(async () => {
+  const connectTelegram = React.useCallback(async () => {
     const initData = getTelegramInitData();
     if (!initData) throw new Error("Not running inside a Telegram Mini App.");
     const session2 = await client.verifyTelegram({ initData });
     setSession(session2);
   }, [client, setSession]);
-  const requestEmailOtp = react.useCallback(
+  const requestEmailOtp = React.useCallback(
     async (email) => {
       const { expiresAt } = await client.initiateEmail(email);
       return { expiresAt };
     },
     [client]
   );
-  const connectEmail = react.useCallback(
+  const connectEmail = React.useCallback(
     async (email, code) => {
       const session2 = await client.verifyEmail(email, code);
       setSession(session2);
     },
     [client, setSession]
   );
-  const logout = react.useCallback(async () => {
+  const logout = React.useCallback(async () => {
     await client.logout();
     setSession(null);
   }, [client, setSession]);
@@ -403,25 +434,29 @@ function useSolvenAuth() {
   };
 }
 function useSolvenWallet() {
-  const { client, status } = useSolvenContext();
-  const [wallet, setWallet] = react.useState(null);
-  react.useEffect(() => {
+  const { client, status, reportError } = useSolvenContext();
+  const [wallet, setWallet] = React.useState(null);
+  React.useEffect(() => {
     if (status !== "authenticated") {
       setWallet(null);
       return;
     }
     let cancelled = false;
-    client.getMyWallet().then((w) => !cancelled && setWallet(w)).catch(() => !cancelled && setWallet(null));
+    client.getMyWallet().then((w) => !cancelled && setWallet(w)).catch((e) => {
+      if (cancelled) return;
+      reportError(e, { operation: "wallet:load" });
+      setWallet(null);
+    });
     return () => {
       cancelled = true;
     };
-  }, [client, status]);
+  }, [client, status, reportError]);
   return wallet;
 }
 function useSolvenBalance(walletId, pollMs = 15e3) {
   const { client, status } = useSolvenContext();
-  const [balance, setBalance] = react.useState(null);
-  react.useEffect(() => {
+  const [balance, setBalance] = React.useState(null);
+  React.useEffect(() => {
     if (status !== "authenticated" || !walletId) {
       setBalance(null);
       return;
@@ -444,25 +479,32 @@ function useSolvenBalance(walletId, pollMs = 15e3) {
   return balance;
 }
 function useSolvenSign() {
-  const { client } = useSolvenContext();
-  const signAction = react.useCallback(
-    ({ walletId, txBase64, label, idempotencyKey }) => client.signAction({ walletId, txBase64, label }, idempotencyKey),
-    [client]
+  const { client, reportError } = useSolvenContext();
+  const signAction = React.useCallback(
+    async ({ walletId, txBase64, label, idempotencyKey }) => {
+      try {
+        return await client.signAction({ walletId, txBase64, label }, idempotencyKey);
+      } catch (e) {
+        reportError(e, { operation: "sign" });
+        throw e;
+      }
+    },
+    [client, reportError]
   );
   return { signAction };
 }
 function useSolvenExport(walletId) {
   const { client } = useSolvenContext();
-  const [preflight, setPreflight] = react.useState(null);
-  const refreshPreflight = react.useCallback(async () => {
+  const [preflight, setPreflight] = React.useState(null);
+  const refreshPreflight = React.useCallback(async () => {
     if (!walletId) return;
     const p = await client.exportPreflight(walletId);
     setPreflight(p);
   }, [client, walletId]);
-  react.useEffect(() => {
+  React.useEffect(() => {
     if (walletId) void refreshPreflight();
   }, [walletId, refreshPreflight]);
-  const exportKey = react.useCallback(
+  const exportKey = React.useCallback(
     async (idempotencyKey) => {
       if (!walletId) throw new Error("No wallet selected for export");
       return client.exportWallet(walletId, idempotencyKey);
@@ -476,8 +518,8 @@ function useSolvenTransferIn() {
   return { destinationAddress: wallet?.address ?? null };
 }
 function useIsTelegram() {
-  const [inTelegram, setInTelegram] = react.useState(false);
-  react.useEffect(() => {
+  const [inTelegram, setInTelegram] = React.useState(false);
+  React.useEffect(() => {
     setInTelegram(isTelegramMiniApp());
   }, []);
   return inTelegram;
@@ -598,20 +640,21 @@ var defaultTheme = {
 };
 function SolvenLoginContent(props) {
   const { connectExternal, connectTelegram, requestEmailOtp, connectEmail, status, user } = useSolvenAuth();
-  const [busy, setBusy] = react.useState(null);
-  const [error, setError] = react.useState(null);
-  const [email, setEmail] = react.useState("");
-  const [otp, setOtp] = react.useState("");
-  const [otpSent, setOtpSent] = react.useState(false);
+  const reportError = useSolvenReportError();
+  const [busy, setBusy] = React.useState(null);
+  const [error, setError] = React.useState(null);
+  const [email, setEmail] = React.useState("");
+  const [otp, setOtp] = React.useState("");
+  const [otpSent, setOtpSent] = React.useState(false);
   const showEmail = props.showEmail ?? true;
-  const theme = react.useMemo(
+  const theme = React.useMemo(
     () => ({ ...defaultTheme, ...props.theme ?? {} }),
     [props.theme]
   );
-  const inTma = react.useMemo(() => isTelegramMiniApp(), []);
+  const inTma = React.useMemo(() => isTelegramMiniApp(), []);
   const autoTelegram = props.autoTelegram ?? true;
-  const wallets = react.useMemo(listSupportedWallets, []);
-  react.useEffect(() => {
+  const wallets = React.useMemo(listSupportedWallets, []);
+  React.useEffect(() => {
     notifyTelegramReady();
     if (!inTma || !autoTelegram) return;
     if (status === "authenticated") return;
@@ -626,6 +669,7 @@ function SolvenLoginContent(props) {
         props.onCloseAfterSignIn?.();
       } catch (e) {
         if (!cancelled) {
+          reportError(e, { operation: "login:telegram" });
           setError(e instanceof Error ? e.message : "Telegram sign-in failed");
         }
       } finally {
@@ -652,6 +696,7 @@ function SolvenLoginContent(props) {
       props.onSignIn?.();
       props.onCloseAfterSignIn?.();
     } catch (e) {
+      reportError(e, { operation: "login:wallet" });
       setError(e instanceof Error ? e.message : "Wallet sign-in failed");
     } finally {
       setBusy(null);
@@ -665,6 +710,7 @@ function SolvenLoginContent(props) {
       props.onSignIn?.();
       props.onCloseAfterSignIn?.();
     } catch (e) {
+      reportError(e, { operation: "login:telegram" });
       setError(e instanceof Error ? e.message : "Telegram sign-in failed");
     } finally {
       setBusy(null);
@@ -677,6 +723,7 @@ function SolvenLoginContent(props) {
       await requestEmailOtp(email.trim());
       setOtpSent(true);
     } catch (e) {
+      reportError(e, { operation: "login:email" });
       setError(e instanceof Error ? e.message : "Couldn't send the code");
     } finally {
       setBusy(null);
@@ -690,6 +737,7 @@ function SolvenLoginContent(props) {
       props.onSignIn?.();
       props.onCloseAfterSignIn?.();
     } catch (e) {
+      reportError(e, { operation: "login:email" });
       setError(e instanceof Error ? e.message : "Couldn't verify the code");
     } finally {
       setBusy(null);
@@ -927,7 +975,7 @@ function SolvenLoginContent(props) {
   ] });
 }
 function SolvenLogin(props) {
-  const theme = react.useMemo(
+  const theme = React.useMemo(
     () => ({ ...defaultTheme, ...props.theme ?? {} }),
     [props.theme]
   );
@@ -960,17 +1008,17 @@ function SolvenLoginModal(props) {
     closeOnEscape = true,
     ...content
   } = props;
-  const theme = react.useMemo(
+  const theme = React.useMemo(
     () => ({ ...defaultTheme, ...props.theme ?? {} }),
     [props.theme]
   );
-  const dialogRef = react.useRef(null);
-  const previouslyFocused = react.useRef(null);
-  const [mounted, setMounted] = react.useState(false);
-  react.useEffect(() => {
+  const dialogRef = React.useRef(null);
+  const previouslyFocused = React.useRef(null);
+  const [mounted, setMounted] = React.useState(false);
+  React.useEffect(() => {
     setMounted(true);
   }, []);
-  react.useEffect(() => {
+  React.useEffect(() => {
     if (!isOpen || !closeOnEscape) return;
     const onKey = (e) => {
       if (e.key === "Escape") {
@@ -981,7 +1029,7 @@ function SolvenLoginModal(props) {
     window.addEventListener("keydown", onKey);
     return () => window.removeEventListener("keydown", onKey);
   }, [isOpen, closeOnEscape, onClose]);
-  react.useEffect(() => {
+  React.useEffect(() => {
     if (!isOpen) return;
     previouslyFocused.current = document.activeElement ?? null;
     queueMicrotask(() => {
@@ -1017,7 +1065,7 @@ function SolvenLoginModal(props) {
       previouslyFocused.current?.focus?.();
     };
   }, [isOpen]);
-  const handleBackdropClick = react.useCallback(
+  const handleBackdropClick = React.useCallback(
     (e) => {
       if (!closeOnBackdrop) return;
       if (e.target === e.currentTarget) onClose();
@@ -1119,12 +1167,12 @@ function truncateAddress(address, chars) {
 }
 function SolvenAddress(props) {
   const wallet = useSolvenWallet();
-  const theme = react.useMemo(() => ({ ...defaultTheme2, ...props.theme ?? {} }), [props.theme]);
+  const theme = React.useMemo(() => ({ ...defaultTheme2, ...props.theme ?? {} }), [props.theme]);
   const truncateChars = props.truncateChars ?? 6;
   const showCopy = props.showCopy ?? true;
   const label = props.label ?? "Wallet Address";
-  const [copied, setCopied] = react.useState(false);
-  const handleCopy = react.useCallback(async () => {
+  const [copied, setCopied] = React.useState(false);
+  const handleCopy = React.useCallback(async () => {
     if (!wallet?.address) return;
     try {
       await navigator.clipboard.writeText(wallet.address);
@@ -1254,18 +1302,18 @@ function getTokenLabel(token) {
 function SolvenBalance(props) {
   const wallet = useSolvenWallet();
   const balance = useSolvenBalance(wallet?.id ?? null, props.pollMs);
-  const theme = react.useMemo(() => ({ ...defaultTheme3, ...props.theme ?? {} }), [props.theme]);
+  const theme = React.useMemo(() => ({ ...defaultTheme3, ...props.theme ?? {} }), [props.theme]);
   const showRefresh = props.showRefresh ?? true;
   const label = props.label ?? "Balance";
   const compact = props.compact ?? false;
-  const [refreshing, setRefreshing] = react.useState(false);
-  const tokens = react.useMemo(() => {
+  const [refreshing, setRefreshing] = React.useState(false);
+  const tokens = React.useMemo(() => {
     if (!balance?.tokens) return [];
     if (!props.filterMints) return balance.tokens;
     const set = new Set(props.filterMints);
     return balance.tokens.filter((t) => set.has(t.mint));
   }, [balance?.tokens, props.filterMints]);
-  const handleRefresh = react.useCallback(() => {
+  const handleRefresh = React.useCallback(() => {
     setRefreshing(true);
     setTimeout(() => setRefreshing(false), 1500);
   }, []);
@@ -1465,26 +1513,26 @@ function isValidSolanaAddress(address) {
 function SolvenWithdraw(props) {
   const wallet = useSolvenWallet();
   const balance = useSolvenBalance(wallet?.id ?? null);
-  const { client } = useSolvenContext();
-  const theme = react.useMemo(() => ({ ...defaultTheme4, ...props.theme ?? {} }), [props.theme]);
+  const { client, reportError } = useSolvenContext();
+  const theme = React.useMemo(() => ({ ...defaultTheme4, ...props.theme ?? {} }), [props.theme]);
   const label = props.label ?? "Withdraw";
-  const [toAddress, setToAddress] = react.useState("");
-  const [amount, setAmount] = react.useState("");
-  const [selectedMint, setSelectedMint] = react.useState(props.mint ?? "SOL");
-  const [busy, setBusy] = react.useState(false);
-  const [error, setError] = react.useState(null);
-  const [successSig, setSuccessSig] = react.useState(null);
-  const tokens = react.useMemo(() => {
+  const [toAddress, setToAddress] = React.useState("");
+  const [amount, setAmount] = React.useState("");
+  const [selectedMint, setSelectedMint] = React.useState(props.mint ?? "SOL");
+  const [busy, setBusy] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const [successSig, setSuccessSig] = React.useState(null);
+  const tokens = React.useMemo(() => {
     if (!balance?.tokens) return [];
     if (props.mint) return balance.tokens.filter((t) => t.mint === props.mint);
     return balance.tokens;
   }, [balance?.tokens, props.mint]);
-  const selectedToken = react.useMemo(
+  const selectedToken = React.useMemo(
     () => tokens.find((t) => t.mint === selectedMint) ?? null,
     [tokens, selectedMint]
   );
   const availableFormatted = selectedToken ? formatTokenAmount2(selectedToken) : "0";
-  const handleMax = react.useCallback(() => {
+  const handleMax = React.useCallback(() => {
     if (!selectedToken) return;
     if (selectedToken.mint === "SOL") {
       const raw = BigInt(selectedToken.amount);
@@ -1500,7 +1548,7 @@ function SolvenWithdraw(props) {
       setAmount(formatTokenAmount2(selectedToken));
     }
   }, [selectedToken]);
-  const handleSubmit = react.useCallback(async () => {
+  const handleSubmit = React.useCallback(async () => {
     setError(null);
     setSuccessSig(null);
     if (!wallet) {
@@ -1543,6 +1591,7 @@ function SolvenWithdraw(props) {
       props.onSuccess?.(result.signature);
     } catch (e) {
       const msg = e instanceof Error ? e.message : "Withdrawal failed";
+      reportError(e, { operation: "withdraw" });
       setError(msg);
       props.onError?.(e instanceof Error ? e : new Error(msg));
     } finally {
@@ -1781,16 +1830,17 @@ function formatLamports(lamports) {
 function SolvenExport(props) {
   const wallet = useSolvenWallet();
   const { preflight, refreshPreflight, exportKey } = useSolvenExport(wallet?.id ?? null);
-  const theme = react.useMemo(() => ({ ...defaultTheme5, ...props.theme ?? {} }), [props.theme]);
+  const reportError = useSolvenReportError();
+  const theme = React.useMemo(() => ({ ...defaultTheme5, ...props.theme ?? {} }), [props.theme]);
   const label = props.label ?? "Export Wallet";
-  const [step, setStep] = react.useState("preflight");
-  const [busy, setBusy] = react.useState(false);
-  const [error, setError] = react.useState(null);
-  const [exportedKey, setExportedKey] = react.useState(null);
-  const [newAddress, setNewAddress] = react.useState(null);
-  const [bootstrapSig, setBootstrapSig] = react.useState(null);
-  const [keyCopied, setKeyCopied] = react.useState(false);
-  const handleExport = react.useCallback(async () => {
+  const [step, setStep] = React.useState("preflight");
+  const [busy, setBusy] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const [exportedKey, setExportedKey] = React.useState(null);
+  const [newAddress, setNewAddress] = React.useState(null);
+  const [bootstrapSig, setBootstrapSig] = React.useState(null);
+  const [keyCopied, setKeyCopied] = React.useState(false);
+  const handleExport = React.useCallback(async () => {
     setError(null);
     setBusy(true);
     try {
@@ -1802,13 +1852,14 @@ function SolvenExport(props) {
       props.onSuccess?.(result.newWalletAddress);
     } catch (e) {
       const msg = e instanceof Error ? e.message : "Export failed";
+      reportError(e, { operation: "export" });
       setError(msg);
       props.onError?.(e instanceof Error ? e : new Error(msg));
     } finally {
       setBusy(false);
     }
   }, [wallet, exportKey, props]);
-  const handleCopyKey = react.useCallback(async () => {
+  const handleCopyKey = React.useCallback(async () => {
     if (!exportedKey) return;
     try {
       await navigator.clipboard.writeText(exportedKey);
@@ -2215,8 +2266,8 @@ function detectPlatform() {
   return "web";
 }
 function usePlatform() {
-  const [platform, setPlatform] = react.useState("web");
-  react.useEffect(() => {
+  const [platform, setPlatform] = React.useState("web");
+  React.useEffect(() => {
     setPlatform(detectPlatform());
   }, []);
   return platform;
@@ -2254,5 +2305,6 @@ exports.useWallet = useSolvenWallet;
 exports.useWalletAuth = useSolvenAuth;
 exports.useWalletBalance = useSolvenBalance;
 exports.useWalletExport = useSolvenExport;
+exports.useWalletReportError = useSolvenReportError;
 exports.useWalletSign = useSolvenSign;
 exports.useWalletTransferIn = useSolvenTransferIn;

package/dist/index.d.cts

@@ -310,6 +310,15 @@ declare function useIAMGameTransferIn(): IUseIAMGameTransferIn;
  */
 declare function useIsTelegram(): boolean;
 
+/** Context passed to onError describing which wallet operation failed. */
+interface IAMGameErrorContext {
+    /** e.g. "login:telegram" | "login:wallet" | "login:email" | "sign" | "withdraw" | "export" | "wallet:load" | "render". */
+    operation: string;
+}
+type IAMGameErrorReporter = (error: unknown, context: IAMGameErrorContext) => void;
+/** Report a wallet failure from inside SDK components/hooks (wired to the provider's onError). */
+declare function useIAMGameReportError(): IAMGameErrorReporter;
+
 interface IAMGameLoginTheme {
     primary?: string;
     background?: string;
@@ -551,7 +560,15 @@ declare function usePlatform(): Platform;
 
 interface IAMGameWalletProviderProps extends IAMGameClientOptions {
     children: React.ReactNode;
+    /** Zero-tap Telegram login inside a Mini App. Defaults to true. */
+    autoTelegram?: boolean;
+    /**
+     * Called whenever a wallet operation fails in the UI — login, sign, withdraw,
+     * export, wallet load, or a render crash. Wire to your error tracker, e.g.
+     * `onError={(err, { operation }) => Sentry.captureException(err, { tags: { wallet_op: operation } })}`.
+     */
+    onError?: IAMGameErrorReporter;
 }
 declare const IAMGameWalletProvider: React.FC<IAMGameWalletProviderProps>;
 
-export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type Platform, type PlatformDetector, type TelegramWebApp, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };
+export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type Platform, type PlatformDetector, type TelegramWebApp, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, type IAMGameErrorContext as WalletErrorContext, type IAMGameErrorReporter as WalletErrorReporter, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameReportError as useWalletReportError, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };

package/dist/index.d.ts

@@ -310,6 +310,15 @@ declare function useIAMGameTransferIn(): IUseIAMGameTransferIn;
  */
 declare function useIsTelegram(): boolean;
 
+/** Context passed to onError describing which wallet operation failed. */
+interface IAMGameErrorContext {
+    /** e.g. "login:telegram" | "login:wallet" | "login:email" | "sign" | "withdraw" | "export" | "wallet:load" | "render". */
+    operation: string;
+}
+type IAMGameErrorReporter = (error: unknown, context: IAMGameErrorContext) => void;
+/** Report a wallet failure from inside SDK components/hooks (wired to the provider's onError). */
+declare function useIAMGameReportError(): IAMGameErrorReporter;
+
 interface IAMGameLoginTheme {
     primary?: string;
     background?: string;
@@ -551,7 +560,15 @@ declare function usePlatform(): Platform;
 
 interface IAMGameWalletProviderProps extends IAMGameClientOptions {
     children: React.ReactNode;
+    /** Zero-tap Telegram login inside a Mini App. Defaults to true. */
+    autoTelegram?: boolean;
+    /**
+     * Called whenever a wallet operation fails in the UI — login, sign, withdraw,
+     * export, wallet load, or a render crash. Wire to your error tracker, e.g.
+     * `onError={(err, { operation }) => Sentry.captureException(err, { tags: { wallet_op: operation } })}`.
+     */
+    onError?: IAMGameErrorReporter;
 }
 declare const IAMGameWalletProvider: React.FC<IAMGameWalletProviderProps>;
 
-export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type Platform, type PlatformDetector, type TelegramWebApp, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };
+export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type Platform, type PlatformDetector, type TelegramWebApp, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, type IAMGameErrorContext as WalletErrorContext, type IAMGameErrorReporter as WalletErrorReporter, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameReportError as useWalletReportError, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createContext, useMemo, useState, useEffect, useRef, useCallback, useContext } from 'react';
+import React, { createContext, useMemo, useState, useRef, useCallback, useEffect, useContext } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
 
@@ -272,7 +272,25 @@ function useSolvenContext() {
   if (!ctx) throw new Error("useSolvenContext must be inside a <SolvenProvider />");
   return ctx;
 }
-function SolvenProvider({ children, autoTelegram = true, ...opts }) {
+function useSolvenReportError() {
+  return useSolvenContext().reportError;
+}
+var SolvenErrorBoundary = class extends React.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    this.props.onError(error, { operation: "render" });
+  }
+  render() {
+    return this.state.hasError ? null : this.props.children;
+  }
+};
+function SolvenProvider({ children, autoTelegram = true, onError, ...opts }) {
   const client = useMemo(() => new SolvenClient(opts), [
     opts.publishableKey,
     opts.baseUrl,
@@ -281,6 +299,14 @@ function SolvenProvider({ children, autoTelegram = true, ...opts }) {
   ]);
   const [session, setSession] = useState(client.getSession());
   const [status, setStatus] = useState("loading");
+  const onErrorRef = useRef(onError);
+  onErrorRef.current = onError;
+  const reportError = useCallback((error, context) => {
+    try {
+      onErrorRef.current?.(error, context);
+    } catch {
+    }
+  }, []);
   useEffect(() => {
     let cancelled = false;
     (async () => {
@@ -346,9 +372,10 @@ function SolvenProvider({ children, autoTelegram = true, ...opts }) {
     setSession: (s) => {
       setSession(s);
       setStatus(s ? "authenticated" : "anonymous");
-    }
+    },
+    reportError
   };
-  return /* @__PURE__ */ jsx(SolvenContext.Provider, { value, children });
+  return /* @__PURE__ */ jsx(SolvenContext.Provider, { value, children: /* @__PURE__ */ jsx(SolvenErrorBoundary, { onError: reportError, children }) });
 }
 
 // ../../solven/sdk-client/src/hooks.ts
@@ -401,7 +428,7 @@ function useSolvenAuth() {
   };
 }
 function useSolvenWallet() {
-  const { client, status } = useSolvenContext();
+  const { client, status, reportError } = useSolvenContext();
   const [wallet, setWallet] = useState(null);
   useEffect(() => {
     if (status !== "authenticated") {
@@ -409,11 +436,15 @@ function useSolvenWallet() {
       return;
     }
     let cancelled = false;
-    client.getMyWallet().then((w) => !cancelled && setWallet(w)).catch(() => !cancelled && setWallet(null));
+    client.getMyWallet().then((w) => !cancelled && setWallet(w)).catch((e) => {
+      if (cancelled) return;
+      reportError(e, { operation: "wallet:load" });
+      setWallet(null);
+    });
     return () => {
       cancelled = true;
     };
-  }, [client, status]);
+  }, [client, status, reportError]);
   return wallet;
 }
 function useSolvenBalance(walletId, pollMs = 15e3) {
@@ -442,10 +473,17 @@ function useSolvenBalance(walletId, pollMs = 15e3) {
   return balance;
 }
 function useSolvenSign() {
-  const { client } = useSolvenContext();
+  const { client, reportError } = useSolvenContext();
   const signAction = useCallback(
-    ({ walletId, txBase64, label, idempotencyKey }) => client.signAction({ walletId, txBase64, label }, idempotencyKey),
-    [client]
+    async ({ walletId, txBase64, label, idempotencyKey }) => {
+      try {
+        return await client.signAction({ walletId, txBase64, label }, idempotencyKey);
+      } catch (e) {
+        reportError(e, { operation: "sign" });
+        throw e;
+      }
+    },
+    [client, reportError]
   );
   return { signAction };
 }
@@ -596,6 +634,7 @@ var defaultTheme = {
 };
 function SolvenLoginContent(props) {
   const { connectExternal, connectTelegram, requestEmailOtp, connectEmail, status, user } = useSolvenAuth();
+  const reportError = useSolvenReportError();
   const [busy, setBusy] = useState(null);
   const [error, setError] = useState(null);
   const [email, setEmail] = useState("");
@@ -624,6 +663,7 @@ function SolvenLoginContent(props) {
         props.onCloseAfterSignIn?.();
       } catch (e) {
         if (!cancelled) {
+          reportError(e, { operation: "login:telegram" });
           setError(e instanceof Error ? e.message : "Telegram sign-in failed");
         }
       } finally {
@@ -650,6 +690,7 @@ function SolvenLoginContent(props) {
       props.onSignIn?.();
       props.onCloseAfterSignIn?.();
     } catch (e) {
+      reportError(e, { operation: "login:wallet" });
       setError(e instanceof Error ? e.message : "Wallet sign-in failed");
     } finally {
       setBusy(null);
@@ -663,6 +704,7 @@ function SolvenLoginContent(props) {
       props.onSignIn?.();
       props.onCloseAfterSignIn?.();
     } catch (e) {
+      reportError(e, { operation: "login:telegram" });
       setError(e instanceof Error ? e.message : "Telegram sign-in failed");
     } finally {
       setBusy(null);
@@ -675,6 +717,7 @@ function SolvenLoginContent(props) {
       await requestEmailOtp(email.trim());
       setOtpSent(true);
     } catch (e) {
+      reportError(e, { operation: "login:email" });
       setError(e instanceof Error ? e.message : "Couldn't send the code");
     } finally {
       setBusy(null);
@@ -688,6 +731,7 @@ function SolvenLoginContent(props) {
       props.onSignIn?.();
       props.onCloseAfterSignIn?.();
     } catch (e) {
+      reportError(e, { operation: "login:email" });
       setError(e instanceof Error ? e.message : "Couldn't verify the code");
     } finally {
       setBusy(null);
@@ -1463,7 +1507,7 @@ function isValidSolanaAddress(address) {
 function SolvenWithdraw(props) {
   const wallet = useSolvenWallet();
   const balance = useSolvenBalance(wallet?.id ?? null);
-  const { client } = useSolvenContext();
+  const { client, reportError } = useSolvenContext();
   const theme = useMemo(() => ({ ...defaultTheme4, ...props.theme ?? {} }), [props.theme]);
   const label = props.label ?? "Withdraw";
   const [toAddress, setToAddress] = useState("");
@@ -1541,6 +1585,7 @@ function SolvenWithdraw(props) {
       props.onSuccess?.(result.signature);
     } catch (e) {
       const msg = e instanceof Error ? e.message : "Withdrawal failed";
+      reportError(e, { operation: "withdraw" });
       setError(msg);
       props.onError?.(e instanceof Error ? e : new Error(msg));
     } finally {
@@ -1779,6 +1824,7 @@ function formatLamports(lamports) {
 function SolvenExport(props) {
   const wallet = useSolvenWallet();
   const { preflight, refreshPreflight, exportKey } = useSolvenExport(wallet?.id ?? null);
+  const reportError = useSolvenReportError();
   const theme = useMemo(() => ({ ...defaultTheme5, ...props.theme ?? {} }), [props.theme]);
   const label = props.label ?? "Export Wallet";
   const [step, setStep] = useState("preflight");
@@ -1800,6 +1846,7 @@ function SolvenExport(props) {
       props.onSuccess?.(result.newWalletAddress);
     } catch (e) {
       const msg = e instanceof Error ? e.message : "Export failed";
+      reportError(e, { operation: "export" });
       setError(msg);
       props.onError?.(e instanceof Error ? e : new Error(msg));
     } finally {
@@ -2223,4 +2270,4 @@ function usePlatform() {
 // src/provider.tsx
 var IAMGameWalletProvider = SolvenProvider;
 
-export { SolvenClient as IAMGameWalletClient, IAMGameWalletProvider, SolvenAddress as WalletAddress, SolvenBalance as WalletBalance, SolvenExport as WalletExport, SolvenLogin as WalletLogin, SolvenLoginModal as WalletLoginModal, SolvenSdkError as WalletSdkError, SolvenWithdraw as WalletWithdraw, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useSolvenWallet as useWallet, useSolvenAuth as useWalletAuth, useSolvenBalance as useWalletBalance, useSolvenExport as useWalletExport, useSolvenSign as useWalletSign, useSolvenTransferIn as useWalletTransferIn };
+export { SolvenClient as IAMGameWalletClient, IAMGameWalletProvider, SolvenAddress as WalletAddress, SolvenBalance as WalletBalance, SolvenExport as WalletExport, SolvenLogin as WalletLogin, SolvenLoginModal as WalletLoginModal, SolvenSdkError as WalletSdkError, SolvenWithdraw as WalletWithdraw, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useSolvenWallet as useWallet, useSolvenAuth as useWalletAuth, useSolvenBalance as useWalletBalance, useSolvenExport as useWalletExport, useSolvenReportError as useWalletReportError, useSolvenSign as useWalletSign, useSolvenTransferIn as useWalletTransferIn };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamgame/wallet-sdk",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "IAMGame Wallet browser SDK — Telegram & Solana wallet auth, balances, server-side signing, and key export. Drop-in React provider for game frontends.",
   "license": "MIT",
   "homepage": "https://wallet.iamgame.com",