@b3dotfun/sdk 0.0.30-alpha.6 → 0.0.30-alpha.8

package/dist/cjs/global-account/react/components/B3Provider/B3Provider.js

@@ -5,6 +5,7 @@ exports.B3Provider = B3Provider;
 exports.InnerProvider = InnerProvider;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("../../../../global-account/react");
+const analytics_1 = require("../../../../global-account/utils/analytics");
 const supported_1 = require("../../../../shared/constants/chains/supported");
 const react_query_1 = require("@tanstack/react-query");
 const react_2 = require("react");
@@ -33,6 +34,10 @@ const queryClient = new react_query_1.QueryClient();
  * Main B3Provider component
  */
 function B3Provider({ theme = "light", children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster, }) {
+    // Initialize Google Analytics on mount
+    (0, react_2.useEffect)(() => {
+        (0, analytics_1.loadGA4Script)();
+    }, []);
     return ((0, jsx_runtime_1.jsx)(wagmi_1.WagmiProvider, { config: exports.wagmiConfig, children: (0, jsx_runtime_1.jsx)(react_query_1.QueryClientProvider, { client: queryClient, children: (0, jsx_runtime_1.jsx)(react_3.ThirdwebProvider, { children: (0, jsx_runtime_1.jsx)(react_1.TooltipProvider, { children: (0, jsx_runtime_1.jsx)(InnerProvider, { accountOverride: accountOverride, environment: environment, theme: theme, automaticallySetFirstEoa: !!automaticallySetFirstEoa, children: (0, jsx_runtime_1.jsxs)(react_1.RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, (0, jsx_runtime_1.jsx)(StyleRoot_1.StyleRoot, { id: "b3-root" }), (0, jsx_runtime_1.jsx)(sonner_1.Toaster, { theme: theme, position: toaster?.position, style: toaster?.style })] }) }) }) }) }) }));
 }
 /**

package/dist/cjs/global-account/react/components/ManageAccount/ContentTokens.js

@@ -47,6 +47,8 @@ function ContentTokens({ activeTab }) {
     const { data: simBalance, refetch: refetchSimBalance, isLoading: isLoadingBalance } = (0, react_1.useSimBalance)(account?.address);
     // === BLOCKCHAIN INTERACTION ===
     const { switchChainAndExecute } = (0, react_1.useUnifiedChainSwitchAndExecute)();
+    // === ANALYTICS ===
+    const { sendAnalyticsEvent } = (0, react_1.useAnalytics)();
     // === ADDRESS VALIDATION ===
     // Handle recipient address change with real-time validation using viem
     const handleRecipientAddressChange = (value) => {
@@ -133,6 +135,13 @@ function ContentTokens({ activeTab }) {
             }
             setIsSending(true);
             const amountInWei = (0, viem_1.parseUnits)(sendAmount, displayToken.decimals);
+            // Prepare analytics event data
+            const analyticsData = {
+                amount: sendAmount,
+                symbol: displayToken.symbol,
+                chain_id: displayToken.chain_id,
+                address: displayToken.address,
+            };
             try {
                 const sendTokenData = (0, viem_1.encodeFunctionData)({
                     abi: viem_1.erc20Abi,
@@ -145,11 +154,23 @@ function ContentTokens({ activeTab }) {
                     value: displayToken.address === "native" ? amountInWei : BigInt(0),
                 });
                 if (tx) {
+                    // Track successful send
+                    sendAnalyticsEvent("send_token_button_click", {
+                        ...analyticsData,
+                        success: true,
+                        tx: (0, anyspend_1.getExplorerTxUrl)(displayToken.chain_id, tx),
+                    });
                     // Reset form
                     setSendAmount("");
                 }
             }
             catch (error) {
+                // Track failed send
+                sendAnalyticsEvent("send_token_button_click", {
+                    ...analyticsData,
+                    success: false,
+                    reason: error.message || "Unknown error",
+                });
                 // Error
                 sonner_1.toast.error(`Failed to send ${displayToken.symbol}: ${error.message || "Unknown error"}`);
             }

package/dist/cjs/global-account/react/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export { useAccountAssets } from "./useAccountAssets";
 export { useAccountWallet } from "./useAccountWallet";
 export { useAddTWSessionKey } from "./useAddTWSessionKey";
+export { useAnalytics } from "./useAnalytics";
 export { useAuthentication } from "./useAuthentication";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses";
 export { useB3EnsName } from "./useB3EnsName";
@@ -18,13 +19,13 @@ export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect";
 export { useMediaQuery } from "./useMediaQuery";
 export { useNativeBalance, useNativeBalanceFromRPC } from "./useNativeBalance";
 export { useOneBalance } from "./useOneBalance";
-export { useSimBalance } from "./useSimBalance";
 export { useProfile, useProfilePreference, type CombinedProfile, type PreferenceRequestBody, type Profile, } from "./useProfile";
 export { useQueryB3 } from "./useQueryB3";
 export { useQueryBSMNT } from "./useQueryBSMNT";
 export { useRemoveSessionKey } from "./useRemoveSessionKey";
 export { useRouter } from "./useRouter";
 export { useSearchParamsSSR } from "./useSearchParamsSSR";
+export { useSimBalance } from "./useSimBalance";
 export { useSiwe } from "./useSiwe";
 export { useTokenBalance } from "./useTokenBalance";
 export { useTokenBalancesByChain } from "./useTokenBalancesByChain";

package/dist/cjs/global-account/react/hooks/index.js

@@ -14,13 +14,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useURLParams = exports.useUnifiedChainSwitchAndExecute = exports.useTokensFromAddress = exports.useTokenPriceWithFallback = exports.useTokenPrice = exports.useTokenFromUrl = exports.useTokenData = exports.useTokenBalancesByChain = exports.useTokenBalance = exports.useSiwe = exports.useSearchParamsSSR = exports.useRouter = exports.useRemoveSessionKey = exports.useQueryBSMNT = exports.useQueryB3 = exports.useProfilePreference = exports.useProfile = exports.useSimBalance = exports.useOneBalance = exports.useNativeBalanceFromRPC = exports.useNativeBalance = exports.useMediaQuery = exports.useIsomorphicLayoutEffect = exports.useIsMobile = exports.useHasMounted = exports.useHandleConnectWithPrivy = exports.useGetGeo = exports.useGetAllTWSigners = exports.useExchangeRate = exports.useConnect = exports.useChainSwitchWithAction = exports.useBestTransactionPath = exports.useB3EnsName = exports.useB3BalanceFromAddresses = exports.useAuthentication = exports.useAddTWSessionKey = exports.useAccountWallet = exports.useAccountAssets = void 0;
+exports.useURLParams = exports.useUnifiedChainSwitchAndExecute = exports.useTokensFromAddress = exports.useTokenPriceWithFallback = exports.useTokenPrice = exports.useTokenFromUrl = exports.useTokenData = exports.useTokenBalancesByChain = exports.useTokenBalance = exports.useSiwe = exports.useSimBalance = exports.useSearchParamsSSR = exports.useRouter = exports.useRemoveSessionKey = exports.useQueryBSMNT = exports.useQueryB3 = exports.useProfilePreference = exports.useProfile = exports.useOneBalance = exports.useNativeBalanceFromRPC = exports.useNativeBalance = exports.useMediaQuery = exports.useIsomorphicLayoutEffect = exports.useIsMobile = exports.useHasMounted = exports.useHandleConnectWithPrivy = exports.useGetGeo = exports.useGetAllTWSigners = exports.useExchangeRate = exports.useConnect = exports.useChainSwitchWithAction = exports.useBestTransactionPath = exports.useB3EnsName = exports.useB3BalanceFromAddresses = exports.useAuthentication = exports.useAnalytics = exports.useAddTWSessionKey = exports.useAccountWallet = exports.useAccountAssets = void 0;
 var useAccountAssets_1 = require("./useAccountAssets");
 Object.defineProperty(exports, "useAccountAssets", { enumerable: true, get: function () { return useAccountAssets_1.useAccountAssets; } });
 var useAccountWallet_1 = require("./useAccountWallet");
 Object.defineProperty(exports, "useAccountWallet", { enumerable: true, get: function () { return useAccountWallet_1.useAccountWallet; } });
 var useAddTWSessionKey_1 = require("./useAddTWSessionKey");
 Object.defineProperty(exports, "useAddTWSessionKey", { enumerable: true, get: function () { return useAddTWSessionKey_1.useAddTWSessionKey; } });
+var useAnalytics_1 = require("./useAnalytics");
+Object.defineProperty(exports, "useAnalytics", { enumerable: true, get: function () { return useAnalytics_1.useAnalytics; } });
 var useAuthentication_1 = require("./useAuthentication");
 Object.defineProperty(exports, "useAuthentication", { enumerable: true, get: function () { return useAuthentication_1.useAuthentication; } });
 var useB3BalanceFromAddresses_1 = require("./useB3BalanceFromAddresses");
@@ -55,8 +57,6 @@ Object.defineProperty(exports, "useNativeBalance", { enumerable: true, get: func
 Object.defineProperty(exports, "useNativeBalanceFromRPC", { enumerable: true, get: function () { return useNativeBalance_1.useNativeBalanceFromRPC; } });
 var useOneBalance_1 = require("./useOneBalance");
 Object.defineProperty(exports, "useOneBalance", { enumerable: true, get: function () { return useOneBalance_1.useOneBalance; } });
-var useSimBalance_1 = require("./useSimBalance");
-Object.defineProperty(exports, "useSimBalance", { enumerable: true, get: function () { return useSimBalance_1.useSimBalance; } });
 var useProfile_1 = require("./useProfile");
 Object.defineProperty(exports, "useProfile", { enumerable: true, get: function () { return useProfile_1.useProfile; } });
 Object.defineProperty(exports, "useProfilePreference", { enumerable: true, get: function () { return useProfile_1.useProfilePreference; } });
@@ -70,6 +70,8 @@ var useRouter_1 = require("./useRouter");
 Object.defineProperty(exports, "useRouter", { enumerable: true, get: function () { return useRouter_1.useRouter; } });
 var useSearchParamsSSR_1 = require("./useSearchParamsSSR");
 Object.defineProperty(exports, "useSearchParamsSSR", { enumerable: true, get: function () { return useSearchParamsSSR_1.useSearchParamsSSR; } });
+var useSimBalance_1 = require("./useSimBalance");
+Object.defineProperty(exports, "useSimBalance", { enumerable: true, get: function () { return useSimBalance_1.useSimBalance; } });
 var useSiwe_1 = require("./useSiwe");
 Object.defineProperty(exports, "useSiwe", { enumerable: true, get: function () { return useSiwe_1.useSiwe; } });
 var useTokenBalance_1 = require("./useTokenBalance");

package/dist/cjs/global-account/react/hooks/useAnalytics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Analytics hook that provides sendAnalyticsEvent function
+ * Automatically includes user address from useAccountWallet
+ */
+export declare function useAnalytics(): {
+    sendAnalyticsEvent: (eventName: string, parameters?: Record<string, any>) => void;
+};

package/dist/cjs/global-account/react/hooks/useAnalytics.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAnalytics = useAnalytics;
+const analytics_1 = require("../../../global-account/utils/analytics");
+const useAccountWallet_1 = require("./useAccountWallet");
+/**
+ * Analytics hook that provides sendAnalyticsEvent function
+ * Automatically includes user address from useAccountWallet
+ */
+function useAnalytics() {
+    const { address } = (0, useAccountWallet_1.useAccountWallet)();
+    /**
+     * Sends an analytics event to Google Analytics 4
+     * @param eventName - The name of the event to track
+     * @param parameters - Additional parameters to include with the event
+     */
+    const sendAnalyticsEvent = (eventName, parameters) => {
+        // Merge user address with custom parameters
+        const eventData = {
+            user_address: address,
+            ...parameters,
+        };
+        // Send event to GA4 using utility function
+        (0, analytics_1.sendGA4Event)(eventName, eventData);
+    };
+    return {
+        sendAnalyticsEvent,
+    };
+}

package/dist/cjs/global-account/react/hooks/useSimBalance.js

@@ -5,7 +5,11 @@ const react_query_1 = require("@tanstack/react-query");
 async function fetchSimBalance(address) {
     if (!address)
         throw new Error("Address is required");
-    const response = await fetch(`https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/v1/evm/balances/${address}?metadata=logo&localkey=${process.env.PUBLIC_LOCAL_KEY}`);
+    let url = `https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/v1/evm/balances/${address}?metadata=logo&chain_ids=mainnet`;
+    if (process.env.PUBLIC_LOCAL_KEY) {
+        url += `&localkey=${process.env.PUBLIC_LOCAL_KEY}`;
+    }
+    const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`Failed to fetch balance: ${response.statusText}`);
     }

package/dist/cjs/global-account/utils/analytics.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load Google Analytics 4 script and initialize
+ */
+export declare const loadGA4Script: () => void;
+/**
+ * Send an analytics event to Google Analytics 4
+ * @param eventName - The name of the event to track
+ * @param parameters - Additional parameters to include with the event
+ */
+export declare const sendGA4Event: (eventName: string, parameters?: Record<string, any>) => void;

package/dist/cjs/global-account/utils/analytics.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendGA4Event = exports.loadGA4Script = void 0;
+const GA4_MEASUREMENT_ID = "G-Z67JCLMNZE";
+/**
+ * Initialize Google Analytics 4
+ */
+const initializeGA4 = () => {
+    // Only initialize in browser environment
+    if (typeof window === "undefined")
+        return;
+    // Create gtag function if it doesn't exist
+    if (!window.gtag) {
+        window.dataLayer = window.dataLayer || [];
+        window.gtag = function gtag() {
+            window.dataLayer.push(arguments);
+        };
+    }
+    // Configure GA4
+    window.gtag("js", new Date());
+    window.gtag("config", GA4_MEASUREMENT_ID, {
+        page_location: window.location.href,
+        page_hostname: window.location.hostname,
+    });
+};
+/**
+ * Load Google Analytics 4 script and initialize
+ */
+const loadGA4Script = () => {
+    if (typeof window === "undefined")
+        return;
+    // Check if script is already loaded
+    if (document.querySelector(`script[src*="${GA4_MEASUREMENT_ID}"]`))
+        return;
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = `https://www.googletagmanager.com/gtag/js?id=${GA4_MEASUREMENT_ID}`;
+    document.head.appendChild(script);
+    script.onload = initializeGA4;
+};
+exports.loadGA4Script = loadGA4Script;
+/**
+ * Send an analytics event to Google Analytics 4
+ * @param eventName - The name of the event to track
+ * @param parameters - Additional parameters to include with the event
+ */
+const sendGA4Event = (eventName, parameters) => {
+    // Only send events in browser environment
+    if (typeof window === "undefined" || !window.gtag)
+        return;
+    // Send event to GA4
+    window.gtag("event", eventName, parameters || {});
+};
+exports.sendGA4Event = sendGA4Event;

package/dist/esm/global-account/react/components/B3Provider/B3Provider.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { RelayKitProviderWrapper, TooltipProvider, useAuthStore } from "../../../../global-account/react/index.js";
+import { loadGA4Script } from "../../../../global-account/utils/analytics.js";
 import { supportedChains } from "../../../../shared/constants/chains/supported.js";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { useCallback, useEffect, useState } from "react";
@@ -28,6 +29,10 @@ const queryClient = new QueryClient();
  * Main B3Provider component
  */
 export function B3Provider({ theme = "light", children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster, }) {
+    // Initialize Google Analytics on mount
+    useEffect(() => {
+        loadGA4Script();
+    }, []);
     return (_jsx(WagmiProvider, { config: wagmiConfig, children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(ThirdwebProvider, { children: _jsx(TooltipProvider, { children: _jsx(InnerProvider, { accountOverride: accountOverride, environment: environment, theme: theme, automaticallySetFirstEoa: !!automaticallySetFirstEoa, children: _jsxs(RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, _jsx(StyleRoot, { id: "b3-root" }), _jsx(Toaster, { theme: theme, position: toaster?.position, style: toaster?.style })] }) }) }) }) }) }));
 }
 /**

package/dist/esm/global-account/react/components/ManageAccount/ContentTokens.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { ALL_CHAINS } from "../../../../anyspend/index.js";
+import { ALL_CHAINS, getExplorerTxUrl } from "../../../../anyspend/index.js";
 import { ChainTokenIcon } from "../../../../anyspend/react/components/common/ChainTokenIcon.js";
-import { Button, TransitionPanel, useSimBalance, useUnifiedChainSwitchAndExecute, } from "../../../../global-account/react/index.js";
+import { Button, TransitionPanel, useAnalytics, useSimBalance, useUnifiedChainSwitchAndExecute, } from "../../../../global-account/react/index.js";
 import { formatDisplayNumber, formatTokenAmount } from "../../../../shared/utils/number.js";
 import { ArrowLeft, CircleHelp, Copy, Loader2, Send } from "lucide-react";
 import { useEffect, useMemo, useRef, useState } from "react";
@@ -44,6 +44,8 @@ export function ContentTokens({ activeTab }) {
     const { data: simBalance, refetch: refetchSimBalance, isLoading: isLoadingBalance } = useSimBalance(account?.address);
     // === BLOCKCHAIN INTERACTION ===
     const { switchChainAndExecute } = useUnifiedChainSwitchAndExecute();
+    // === ANALYTICS ===
+    const { sendAnalyticsEvent } = useAnalytics();
     // === ADDRESS VALIDATION ===
     // Handle recipient address change with real-time validation using viem
     const handleRecipientAddressChange = (value) => {
@@ -130,6 +132,13 @@ export function ContentTokens({ activeTab }) {
             }
             setIsSending(true);
             const amountInWei = parseUnits(sendAmount, displayToken.decimals);
+            // Prepare analytics event data
+            const analyticsData = {
+                amount: sendAmount,
+                symbol: displayToken.symbol,
+                chain_id: displayToken.chain_id,
+                address: displayToken.address,
+            };
             try {
                 const sendTokenData = encodeFunctionData({
                     abi: erc20Abi,
@@ -142,11 +151,23 @@ export function ContentTokens({ activeTab }) {
                     value: displayToken.address === "native" ? amountInWei : BigInt(0),
                 });
                 if (tx) {
+                    // Track successful send
+                    sendAnalyticsEvent("send_token_button_click", {
+                        ...analyticsData,
+                        success: true,
+                        tx: getExplorerTxUrl(displayToken.chain_id, tx),
+                    });
                     // Reset form
                     setSendAmount("");
                 }
             }
             catch (error) {
+                // Track failed send
+                sendAnalyticsEvent("send_token_button_click", {
+                    ...analyticsData,
+                    success: false,
+                    reason: error.message || "Unknown error",
+                });
                 // Error
                 toast.error(`Failed to send ${displayToken.symbol}: ${error.message || "Unknown error"}`);
             }

package/dist/esm/global-account/react/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export { useAccountAssets } from "./useAccountAssets";
 export { useAccountWallet } from "./useAccountWallet";
 export { useAddTWSessionKey } from "./useAddTWSessionKey";
+export { useAnalytics } from "./useAnalytics";
 export { useAuthentication } from "./useAuthentication";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses";
 export { useB3EnsName } from "./useB3EnsName";
@@ -18,13 +19,13 @@ export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect";
 export { useMediaQuery } from "./useMediaQuery";
 export { useNativeBalance, useNativeBalanceFromRPC } from "./useNativeBalance";
 export { useOneBalance } from "./useOneBalance";
-export { useSimBalance } from "./useSimBalance";
 export { useProfile, useProfilePreference, type CombinedProfile, type PreferenceRequestBody, type Profile, } from "./useProfile";
 export { useQueryB3 } from "./useQueryB3";
 export { useQueryBSMNT } from "./useQueryBSMNT";
 export { useRemoveSessionKey } from "./useRemoveSessionKey";
 export { useRouter } from "./useRouter";
 export { useSearchParamsSSR } from "./useSearchParamsSSR";
+export { useSimBalance } from "./useSimBalance";
 export { useSiwe } from "./useSiwe";
 export { useTokenBalance } from "./useTokenBalance";
 export { useTokenBalancesByChain } from "./useTokenBalancesByChain";

package/dist/esm/global-account/react/hooks/index.js

@@ -1,6 +1,7 @@
 export { useAccountAssets } from "./useAccountAssets.js";
 export { useAccountWallet } from "./useAccountWallet.js";
 export { useAddTWSessionKey } from "./useAddTWSessionKey.js";
+export { useAnalytics } from "./useAnalytics.js";
 export { useAuthentication } from "./useAuthentication.js";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses.js";
 export { useB3EnsName } from "./useB3EnsName.js";
@@ -18,13 +19,13 @@ export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";
 export { useMediaQuery } from "./useMediaQuery.js";
 export { useNativeBalance, useNativeBalanceFromRPC } from "./useNativeBalance.js";
 export { useOneBalance } from "./useOneBalance.js";
-export { useSimBalance } from "./useSimBalance.js";
 export { useProfile, useProfilePreference, } from "./useProfile.js";
 export { useQueryB3 } from "./useQueryB3.js";
 export { useQueryBSMNT } from "./useQueryBSMNT.js";
 export { useRemoveSessionKey } from "./useRemoveSessionKey.js";
 export { useRouter } from "./useRouter.js";
 export { useSearchParamsSSR } from "./useSearchParamsSSR.js";
+export { useSimBalance } from "./useSimBalance.js";
 export { useSiwe } from "./useSiwe.js";
 export { useTokenBalance } from "./useTokenBalance.js";
 export { useTokenBalancesByChain } from "./useTokenBalancesByChain.js";

package/dist/esm/global-account/react/hooks/useAnalytics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Analytics hook that provides sendAnalyticsEvent function
+ * Automatically includes user address from useAccountWallet
+ */
+export declare function useAnalytics(): {
+    sendAnalyticsEvent: (eventName: string, parameters?: Record<string, any>) => void;
+};

package/dist/esm/global-account/react/hooks/useAnalytics.js

@@ -0,0 +1,26 @@
+import { sendGA4Event } from "../../../global-account/utils/analytics.js";
+import { useAccountWallet } from "./useAccountWallet.js";
+/**
+ * Analytics hook that provides sendAnalyticsEvent function
+ * Automatically includes user address from useAccountWallet
+ */
+export function useAnalytics() {
+    const { address } = useAccountWallet();
+    /**
+     * Sends an analytics event to Google Analytics 4
+     * @param eventName - The name of the event to track
+     * @param parameters - Additional parameters to include with the event
+     */
+    const sendAnalyticsEvent = (eventName, parameters) => {
+        // Merge user address with custom parameters
+        const eventData = {
+            user_address: address,
+            ...parameters,
+        };
+        // Send event to GA4 using utility function
+        sendGA4Event(eventName, eventData);
+    };
+    return {
+        sendAnalyticsEvent,
+    };
+}

package/dist/esm/global-account/react/hooks/useSimBalance.js

@@ -2,7 +2,11 @@ import { useQuery } from "@tanstack/react-query";
 async function fetchSimBalance(address) {
     if (!address)
         throw new Error("Address is required");
-    const response = await fetch(`https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/v1/evm/balances/${address}?metadata=logo&localkey=${process.env.PUBLIC_LOCAL_KEY}`);
+    let url = `https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/v1/evm/balances/${address}?metadata=logo&chain_ids=mainnet`;
+    if (process.env.PUBLIC_LOCAL_KEY) {
+        url += `&localkey=${process.env.PUBLIC_LOCAL_KEY}`;
+    }
+    const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`Failed to fetch balance: ${response.statusText}`);
     }

package/dist/esm/global-account/utils/analytics.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load Google Analytics 4 script and initialize
+ */
+export declare const loadGA4Script: () => void;
+/**
+ * Send an analytics event to Google Analytics 4
+ * @param eventName - The name of the event to track
+ * @param parameters - Additional parameters to include with the event
+ */
+export declare const sendGA4Event: (eventName: string, parameters?: Record<string, any>) => void;

package/dist/esm/global-account/utils/analytics.js

@@ -0,0 +1,49 @@
+const GA4_MEASUREMENT_ID = "G-Z67JCLMNZE";
+/**
+ * Initialize Google Analytics 4
+ */
+const initializeGA4 = () => {
+    // Only initialize in browser environment
+    if (typeof window === "undefined")
+        return;
+    // Create gtag function if it doesn't exist
+    if (!window.gtag) {
+        window.dataLayer = window.dataLayer || [];
+        window.gtag = function gtag() {
+            window.dataLayer.push(arguments);
+        };
+    }
+    // Configure GA4
+    window.gtag("js", new Date());
+    window.gtag("config", GA4_MEASUREMENT_ID, {
+        page_location: window.location.href,
+        page_hostname: window.location.hostname,
+    });
+};
+/**
+ * Load Google Analytics 4 script and initialize
+ */
+export const loadGA4Script = () => {
+    if (typeof window === "undefined")
+        return;
+    // Check if script is already loaded
+    if (document.querySelector(`script[src*="${GA4_MEASUREMENT_ID}"]`))
+        return;
+    const script = document.createElement("script");
+    script.async = true;
+    script.src = `https://www.googletagmanager.com/gtag/js?id=${GA4_MEASUREMENT_ID}`;
+    document.head.appendChild(script);
+    script.onload = initializeGA4;
+};
+/**
+ * Send an analytics event to Google Analytics 4
+ * @param eventName - The name of the event to track
+ * @param parameters - Additional parameters to include with the event
+ */
+export const sendGA4Event = (eventName, parameters) => {
+    // Only send events in browser environment
+    if (typeof window === "undefined" || !window.gtag)
+        return;
+    // Send event to GA4
+    window.gtag("event", eventName, parameters || {});
+};

package/dist/types/global-account/react/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export { useAccountAssets } from "./useAccountAssets";
 export { useAccountWallet } from "./useAccountWallet";
 export { useAddTWSessionKey } from "./useAddTWSessionKey";
+export { useAnalytics } from "./useAnalytics";
 export { useAuthentication } from "./useAuthentication";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses";
 export { useB3EnsName } from "./useB3EnsName";
@@ -18,13 +19,13 @@ export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect";
 export { useMediaQuery } from "./useMediaQuery";
 export { useNativeBalance, useNativeBalanceFromRPC } from "./useNativeBalance";
 export { useOneBalance } from "./useOneBalance";
-export { useSimBalance } from "./useSimBalance";
 export { useProfile, useProfilePreference, type CombinedProfile, type PreferenceRequestBody, type Profile, } from "./useProfile";
 export { useQueryB3 } from "./useQueryB3";
 export { useQueryBSMNT } from "./useQueryBSMNT";
 export { useRemoveSessionKey } from "./useRemoveSessionKey";
 export { useRouter } from "./useRouter";
 export { useSearchParamsSSR } from "./useSearchParamsSSR";
+export { useSimBalance } from "./useSimBalance";
 export { useSiwe } from "./useSiwe";
 export { useTokenBalance } from "./useTokenBalance";
 export { useTokenBalancesByChain } from "./useTokenBalancesByChain";

package/dist/types/global-account/react/hooks/useAnalytics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Analytics hook that provides sendAnalyticsEvent function
+ * Automatically includes user address from useAccountWallet
+ */
+export declare function useAnalytics(): {
+    sendAnalyticsEvent: (eventName: string, parameters?: Record<string, any>) => void;
+};

package/dist/types/global-account/utils/analytics.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load Google Analytics 4 script and initialize
+ */
+export declare const loadGA4Script: () => void;
+/**
+ * Send an analytics event to Google Analytics 4
+ * @param eventName - The name of the event to track
+ * @param parameters - Additional parameters to include with the event
+ */
+export declare const sendGA4Event: (eventName: string, parameters?: Record<string, any>) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.0.30-alpha.6",
+  "version": "0.0.30-alpha.8",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",

package/src/global-account/react/components/B3Provider/B3Provider.tsx

@@ -1,6 +1,7 @@
 import { RelayKitProviderWrapper, TooltipProvider, useAuthStore } from "@b3dotfun/sdk/global-account/react";
 import { User } from "@b3dotfun/sdk/global-account/types/b3-api.types";
 import { PermissionsConfig } from "@b3dotfun/sdk/global-account/types/permissions";
+import { loadGA4Script } from "@b3dotfun/sdk/global-account/utils/analytics";
 import { supportedChains } from "@b3dotfun/sdk/shared/constants/chains/supported";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { useCallback, useEffect, useState } from "react";
@@ -60,6 +61,11 @@ export function B3Provider({
     style?: React.CSSProperties;
   };
 }) {
+  // Initialize Google Analytics on mount
+  useEffect(() => {
+    loadGA4Script();
+  }, []);
+
   return (
     <WagmiProvider config={wagmiConfig}>
       <QueryClientProvider client={queryClient}>

package/src/global-account/react/components/ManageAccount/ContentTokens.tsx

@@ -1,8 +1,9 @@
-import { ALL_CHAINS } from "@b3dotfun/sdk/anyspend";
+import { ALL_CHAINS, getExplorerTxUrl } from "@b3dotfun/sdk/anyspend";
 import { ChainTokenIcon } from "@b3dotfun/sdk/anyspend/react/components/common/ChainTokenIcon";
 import {
   Button,
   TransitionPanel,
+  useAnalytics,
   useSimBalance,
   useUnifiedChainSwitchAndExecute,
 } from "@b3dotfun/sdk/global-account/react";
@@ -60,6 +61,9 @@ export function ContentTokens({ activeTab }: ContentTokensProps) {
   // === BLOCKCHAIN INTERACTION ===
   const { switchChainAndExecute } = useUnifiedChainSwitchAndExecute();
 
+  // === ANALYTICS ===
+  const { sendAnalyticsEvent } = useAnalytics();
+
   // === ADDRESS VALIDATION ===
   // Handle recipient address change with real-time validation using viem
   const handleRecipientAddressChange = (value: string) => {
@@ -159,6 +163,14 @@ export function ContentTokens({ activeTab }: ContentTokensProps) {
 
       const amountInWei = parseUnits(sendAmount, displayToken.decimals);
 
+      // Prepare analytics event data
+      const analyticsData = {
+        amount: sendAmount,
+        symbol: displayToken.symbol,
+        chain_id: displayToken.chain_id,
+        address: displayToken.address,
+      };
+
       try {
         const sendTokenData = encodeFunctionData({
           abi: erc20Abi,
@@ -173,10 +185,24 @@ export function ContentTokens({ activeTab }: ContentTokensProps) {
         });
 
         if (tx) {
+          // Track successful send
+          sendAnalyticsEvent("send_token_button_click", {
+            ...analyticsData,
+            success: true,
+            tx: getExplorerTxUrl(displayToken.chain_id, tx),
+          });
+
           // Reset form
           setSendAmount("");
         }
       } catch (error: any) {
+        // Track failed send
+        sendAnalyticsEvent("send_token_button_click", {
+          ...analyticsData,
+          success: false,
+          reason: error.message || "Unknown error",
+        });
+
         // Error
         toast.error(`Failed to send ${displayToken.symbol}: ${error.message || "Unknown error"}`);
       } finally {

package/src/global-account/react/hooks/index.ts

@@ -1,6 +1,7 @@
 export { useAccountAssets } from "./useAccountAssets";
 export { useAccountWallet } from "./useAccountWallet";
 export { useAddTWSessionKey } from "./useAddTWSessionKey";
+export { useAnalytics } from "./useAnalytics";
 export { useAuthentication } from "./useAuthentication";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses";
 export { useB3EnsName } from "./useB3EnsName";
@@ -18,7 +19,6 @@ export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect";
 export { useMediaQuery } from "./useMediaQuery";
 export { useNativeBalance, useNativeBalanceFromRPC } from "./useNativeBalance";
 export { useOneBalance } from "./useOneBalance";
-export { useSimBalance } from "./useSimBalance";
 export {
   useProfile,
   useProfilePreference,
@@ -31,6 +31,7 @@ export { useQueryBSMNT } from "./useQueryBSMNT";
 export { useRemoveSessionKey } from "./useRemoveSessionKey";
 export { useRouter } from "./useRouter";
 export { useSearchParamsSSR } from "./useSearchParamsSSR";
+export { useSimBalance } from "./useSimBalance";
 export { useSiwe } from "./useSiwe";
 export { useTokenBalance } from "./useTokenBalance";
 export { useTokenBalancesByChain } from "./useTokenBalancesByChain";

package/src/global-account/react/hooks/useAnalytics.tsx

@@ -0,0 +1,30 @@
+import { sendGA4Event } from "@b3dotfun/sdk/global-account/utils/analytics";
+import { useAccountWallet } from "./useAccountWallet";
+
+/**
+ * Analytics hook that provides sendAnalyticsEvent function
+ * Automatically includes user address from useAccountWallet
+ */
+export function useAnalytics() {
+  const { address } = useAccountWallet();
+
+  /**
+   * Sends an analytics event to Google Analytics 4
+   * @param eventName - The name of the event to track
+   * @param parameters - Additional parameters to include with the event
+   */
+  const sendAnalyticsEvent = (eventName: string, parameters?: Record<string, any>) => {
+    // Merge user address with custom parameters
+    const eventData = {
+      user_address: address,
+      ...parameters,
+    };
+
+    // Send event to GA4 using utility function
+    sendGA4Event(eventName, eventData);
+  };
+
+  return {
+    sendAnalyticsEvent,
+  };
+}

package/src/global-account/react/hooks/useSimBalance.ts

@@ -29,9 +29,12 @@ export interface SimBalanceResponse {
 async function fetchSimBalance(address: string): Promise<SimBalanceResponse> {
   if (!address) throw new Error("Address is required");
 
-  const response = await fetch(
-    `https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/v1/evm/balances/${address}?metadata=logo&localkey=${process.env.PUBLIC_LOCAL_KEY}`,
-  );
+  let url = `https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/v1/evm/balances/${address}?metadata=logo&chain_ids=mainnet`;
+  if (process.env.PUBLIC_LOCAL_KEY) {
+    url += `&localkey=${process.env.PUBLIC_LOCAL_KEY}`;
+  }
+
+  const response = await fetch(url);
 
   if (!response.ok) {
     throw new Error(`Failed to fetch balance: ${response.statusText}`);

package/src/global-account/utils/analytics.ts

@@ -0,0 +1,54 @@
+const GA4_MEASUREMENT_ID = "G-Z67JCLMNZE";
+
+/**
+ * Initialize Google Analytics 4
+ */
+const initializeGA4 = () => {
+  // Only initialize in browser environment
+  if (typeof window === "undefined") return;
+
+  // Create gtag function if it doesn't exist
+  if (!window.gtag) {
+    window.dataLayer = window.dataLayer || [];
+    window.gtag = function gtag() {
+      window.dataLayer.push(arguments);
+    };
+  }
+
+  // Configure GA4
+  window.gtag("js", new Date());
+  window.gtag("config", GA4_MEASUREMENT_ID, {
+    page_location: window.location.href,
+    page_hostname: window.location.hostname,
+  });
+};
+
+/**
+ * Load Google Analytics 4 script and initialize
+ */
+export const loadGA4Script = () => {
+  if (typeof window === "undefined") return;
+
+  // Check if script is already loaded
+  if (document.querySelector(`script[src*="${GA4_MEASUREMENT_ID}"]`)) return;
+
+  const script = document.createElement("script");
+  script.async = true;
+  script.src = `https://www.googletagmanager.com/gtag/js?id=${GA4_MEASUREMENT_ID}`;
+  document.head.appendChild(script);
+
+  script.onload = initializeGA4;
+};
+
+/**
+ * Send an analytics event to Google Analytics 4
+ * @param eventName - The name of the event to track
+ * @param parameters - Additional parameters to include with the event
+ */
+export const sendGA4Event = (eventName: string, parameters?: Record<string, any>) => {
+  // Only send events in browser environment
+  if (typeof window === "undefined" || !window.gtag) return;
+
+  // Send event to GA4
+  window.gtag("event", eventName, parameters || {});
+};

package/src/{anyspend/types → types}/window.d.ts

@@ -1,7 +1,8 @@
-// Global window interface augmentations for AnySpend wallet providers
+// Global window interface augmentations for B3 SDK
 
 declare global {
   interface Window {
+    // AnySpend wallet providers
     phantom?: {
       solana?: {
         isPhantom?: boolean;
@@ -9,6 +10,9 @@ declare global {
         signAndSendTransaction: (transaction: any) => Promise<{ signature: string }>;
       };
     };
+    // Google Analytics 4
+    gtag: (...args: any[]) => void;
+    dataLayer: any[];
   }
 }