@b3dotfun/sdk 0.1.69-alpha.11 → 0.1.69-alpha.13

package/dist/cjs/wallet/react/hooks/useWalletState.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWalletState = useWalletState;
+const react_1 = require("react");
+const wagmi_1 = require("wagmi");
+/**
+ * Unified wallet state from both thirdweb and wagmi layers.
+ * Provides available connectors with install status and connect functions.
+ */
+function useWalletState() {
+    const { address, isConnected, chain } = (0, wagmi_1.useAccount)();
+    const { connectAsync, isPending } = (0, wagmi_1.useConnect)();
+    const wagmiConnectors = (0, wagmi_1.useConnectors)();
+    // Ref to avoid connectAsync in useMemo deps — wagmi returns a new reference on state
+    // changes, which would recreate the connectors array on every render.
+    const connectAsyncRef = (0, react_1.useRef)(connectAsync);
+    (0, react_1.useEffect)(() => {
+        connectAsyncRef.current = connectAsync;
+    });
+    const connectors = (0, react_1.useMemo)(() => {
+        const seen = new Set();
+        const mapped = wagmiConnectors
+            .filter(c => {
+            // Hide generic "Injected" — it duplicates the actual wallet (MetaMask, Rabby, etc.)
+            if (c.name === "Injected")
+                return false;
+            if (seen.has(c.name))
+                return false;
+            seen.add(c.name);
+            return true;
+        })
+            .map(connector => ({
+            name: connector.name,
+            uid: connector.uid,
+            isInstalled: isConnectorInstalled(connector),
+            connect: async () => {
+                await connectAsyncRef.current({ connector });
+            },
+            connector,
+        }));
+        // Sort: installed connectors first
+        return mapped.sort((a, b) => (a.isInstalled === b.isInstalled ? 0 : a.isInstalled ? -1 : 1));
+    }, [wagmiConnectors]);
+    return { address, isConnected, chain, isPending, connectors };
+}
+/** Check if a wallet connector's provider is available in the browser. */
+function isConnectorInstalled(connector) {
+    // WalletConnect is always "available" (uses QR code, no extension needed)
+    if (connector.id === "walletConnect")
+        return true;
+    // For injected connectors, check if any provider exists. This may report
+    // false positives (e.g., Rabby shows as installed when only MetaMask is)
+    // because multiple injected connectors share window.ethereum. This is
+    // intentional — we surface all options and let the wallet handle conflicts.
+    if (connector.type === "injected") {
+        return typeof window !== "undefined" && !!window.ethereum;
+    }
+    // Coinbase Wallet SDK works without extension (has mobile/QR fallback)
+    if (connector.id === "coinbaseWalletSDK")
+        return true;
+    // Default: assume available (better UX than hiding connectors)
+    return true;
+}

package/dist/cjs/wallet/react/index.d.ts

@@ -0,0 +1,5 @@
+export { WalletProvider, type WalletProviderProps } from "./components/WalletProvider";
+export { createWalletConfig, type CreateWalletConfigOptions } from "../utils/createWalletConfig";
+export { useWalletDisconnect } from "./hooks/useWalletDisconnect";
+export { useWalletState, type WalletConnector, type WalletState } from "./hooks/useWalletState";
+export { ConnectWallet, type ConnectWalletProps } from "./components/ConnectWallet";

package/dist/cjs/wallet/react/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectWallet = exports.useWalletState = exports.useWalletDisconnect = exports.createWalletConfig = exports.WalletProvider = void 0;
+// Provider
+var WalletProvider_1 = require("./components/WalletProvider");
+Object.defineProperty(exports, "WalletProvider", { enumerable: true, get: function () { return WalletProvider_1.WalletProvider; } });
+var createWalletConfig_1 = require("../utils/createWalletConfig");
+Object.defineProperty(exports, "createWalletConfig", { enumerable: true, get: function () { return createWalletConfig_1.createWalletConfig; } });
+// Hooks
+var useWalletDisconnect_1 = require("./hooks/useWalletDisconnect");
+Object.defineProperty(exports, "useWalletDisconnect", { enumerable: true, get: function () { return useWalletDisconnect_1.useWalletDisconnect; } });
+var useWalletState_1 = require("./hooks/useWalletState");
+Object.defineProperty(exports, "useWalletState", { enumerable: true, get: function () { return useWalletState_1.useWalletState; } });
+// Components
+var ConnectWallet_1 = require("./components/ConnectWallet");
+Object.defineProperty(exports, "ConnectWallet", { enumerable: true, get: function () { return ConnectWallet_1.ConnectWallet; } });

package/dist/cjs/wallet/utils/createWalletConfig.d.ts

@@ -0,0 +1,21 @@
+import { type CreateConnectorFn } from "wagmi";
+import type { Chain } from "viem";
+export interface CreateWalletConfigOptions {
+    /** Chains to support. Defaults to SDK's supportedChains. Must be non-empty. */
+    chains?: Chain[];
+    /**
+     * Wagmi connectors. Defaults to injected + Coinbase Wallet.
+     * Must be memoized if passed to WalletProvider — inline arrays
+     * will cause the config to rebuild on every render, losing wallet connection state.
+     */
+    connectors?: CreateConnectorFn[];
+    /** Optional RPC URL overrides per chain ID. */
+    rpcUrls?: Record<number, string>;
+}
+/**
+ * Creates a generic wagmi config with sensible defaults.
+ * No ecosystem wallet, no B3-specific concerns.
+ */
+export declare function createWalletConfig(options?: CreateWalletConfigOptions): import("wagmi").Config<readonly [Chain, ...Chain[]], {
+    [k: string]: import("viem").HttpTransport<undefined, false>;
+}, CreateConnectorFn[]>;

package/dist/cjs/wallet/utils/createWalletConfig.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWalletConfig = createWalletConfig;
+const supported_1 = require("../../shared/constants/chains/supported");
+const viem_1 = require("viem");
+const wagmi_1 = require("wagmi");
+const connectors_1 = require("wagmi/connectors");
+/** Default connectors: injected (MetaMask, Rabby, Brave, etc.) + Coinbase Wallet. */
+const DEFAULT_CONNECTORS = [(0, connectors_1.injected)(), (0, connectors_1.coinbaseWallet)({ appName: "B3" })];
+/**
+ * Creates a generic wagmi config with sensible defaults.
+ * No ecosystem wallet, no B3-specific concerns.
+ */
+function createWalletConfig(options = {}) {
+    const { chains = supported_1.supportedChains, connectors = DEFAULT_CONNECTORS, rpcUrls } = options;
+    if (chains.length === 0) {
+        throw new Error("createWalletConfig: at least one chain must be provided");
+    }
+    return (0, wagmi_1.createConfig)({
+        chains: [chains[0], ...chains.slice(1)],
+        transports: Object.fromEntries(chains.map(chain => [chain.id, (0, viem_1.http)(rpcUrls?.[chain.id])])),
+        connectors,
+    });
+}

package/dist/esm/anyspend/react/components/checkout/AnySpendCheckout.d.ts

@@ -121,5 +121,7 @@ export interface AnySpendCheckoutProps {
     feeOnTop?: boolean;
     /** When true, identity verification (KYC) is required before card payment. Defaults to false. */
     kycEnabled?: boolean;
+    /** Extra metadata included under the 'callbackMetadata' key in the order's callbackMetadata (e.g. workflowId, orgId from checkout session) */
+    callbackMetadata?: Record<string, unknown>;
 }
-export declare function AnySpendCheckout({ mode, recipientAddress, destinationTokenAddress, destinationTokenChainId, items, totalAmount: totalAmountOverride, organizationName, organizationLogo, themeColor, buttonText, checkoutSessionId, onSuccess, onError, returnUrl, returnLabel, classes, footer, defaultPaymentMethod, senderAddress, slots, content, theme, showPoints, showOrderId, shipping: shippingProp, tax, discount: discountProp, summaryLines, formSchema, formComponent, onFormSubmit, shippingOptions, collectShippingAddress, onShippingChange: onShippingChangeProp, enableDiscountCode, onDiscountApplied: onDiscountAppliedProp, validateDiscount, variablePricing, feeOnTop, kycEnabled, }: AnySpendCheckoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnySpendCheckout({ mode, recipientAddress, destinationTokenAddress, destinationTokenChainId, items, totalAmount: totalAmountOverride, organizationName, organizationLogo, themeColor, buttonText, checkoutSessionId, onSuccess, onError, returnUrl, returnLabel, classes, footer, defaultPaymentMethod, senderAddress, slots, content, theme, showPoints, showOrderId, shipping: shippingProp, tax, discount: discountProp, summaryLines, formSchema, formComponent, onFormSubmit, shippingOptions, collectShippingAddress, onShippingChange: onShippingChangeProp, enableDiscountCode, onDiscountApplied: onDiscountAppliedProp, validateDiscount, variablePricing, feeOnTop, kycEnabled, callbackMetadata: callbackMetadataProp, }: AnySpendCheckoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/checkout/AnySpendCheckout.js

@@ -21,7 +21,7 @@ shippingOptions, collectShippingAddress, onShippingChange: onShippingChangeProp,
 // New discount props
 enableDiscountCode, onDiscountApplied: onDiscountAppliedProp, validateDiscount, 
 // Variable pricing
-variablePricing, feeOnTop, kycEnabled = false, }) {
+variablePricing, feeOnTop, kycEnabled = false, callbackMetadata: callbackMetadataProp, }) {
     // ===== Variable pricing state =====
     const [variablePricingAmount, setVariablePricingAmount] = useState("0");
     const isVariablePricingActive = variablePricing?.enabled === true;
@@ -173,8 +173,12 @@ variablePricing, feeOnTop, kycEnabled = false, }) {
         if (isVariablePricingActive && variablePricingAmount !== "0") {
             meta.variablePricingAmount = variablePricingAmount;
         }
+        // Namespace caller-supplied metadata to avoid collisions with internal keys
+        if (callbackMetadataProp)
+            meta.callbackMetadata = callbackMetadataProp;
         return Object.keys(meta).length > 0 ? meta : undefined;
     }, [
+        callbackMetadataProp,
         formData,
         selectedShipping,
         shippingAddress,

package/dist/esm/global-account/react/components/B3Provider/B3Provider.d.ts

@@ -2,13 +2,14 @@ import { CreateOnrampOrderParams } from "../../../../anyspend/react/hooks/useAny
 import { CreateOrderParams } from "../../../../anyspend/react/hooks/useAnyspendCreateOrder";
 import { PermissionsConfig } from "../../../../global-account/types/permissions";
 import "@relayprotocol/relay-kit-ui/styles.css";
+import { QueryClient } from "@tanstack/react-query";
 import { Account, EIP1193, Wallet } from "thirdweb/wallets";
 import { CreateConnectorFn } from "wagmi";
 import { ClientType } from "../../../client-manager";
 /**
  * Main B3Provider component
  */
-export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication, }: {
+export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication, queryClient, }: {
     theme: "light" | "dark";
     children: React.ReactNode;
     accountOverride?: Account;
@@ -33,4 +34,6 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
     defaultPermissions?: PermissionsConfig;
     disableBSMNTAuthentication?: boolean;
+    /** Provide your own QueryClient for React Query. If omitted, WalletProvider creates one internally. */
+    queryClient?: QueryClient;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -2,25 +2,21 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { RelayKitProviderWrapper, TooltipProvider } from "../../../../global-account/react/index.js";
 import { createWagmiConfig } from "../../../../global-account/react/utils/createWagmiConfig.js";
 import { loadGA4Script } from "../../../../global-account/utils/analytics.js";
+import { WalletProvider } from "../../../../wallet/react/index.js";
 import "@relayprotocol/relay-kit-ui/styles.css";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { useEffect, useMemo } from "react";
-import { ThirdwebProvider } from "thirdweb/react";
-import { WagmiProvider } from "wagmi";
 import { setClientType } from "../../../client-manager.js";
 import { StyleRoot } from "../StyleRoot.js";
 import { setToastContext, ToastProvider, useToastContext } from "../Toast/index.js";
 import AuthenticationProvider from "./AuthenticationProvider.js";
 import { B3ConfigProvider } from "./B3ConfigProvider.js";
 import { LocalSDKProvider } from "./LocalSDKProvider.js";
-// Create queryClient instance
-const queryClient = new QueryClient();
 /**
  * Main B3Provider component
  */
 export function B3Provider({ theme = "light", children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, 
 // deprecated since v0.0.87
-toaster: _toaster, clientType = "rest", rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors = false, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication = false, }) {
+toaster: _toaster, clientType = "rest", rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors = false, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication = false, queryClient, }) {
     // Initialize Google Analytics on mount
     useEffect(() => {
         loadGA4Script();
@@ -30,7 +26,7 @@ toaster: _toaster, clientType = "rest", rpcUrls, partnerId, stripePublishableKey
         setClientType(clientType);
     }, [clientType]);
     const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId, rpcUrls, connectors, overrideDefaultConnectors }), [partnerId, rpcUrls, connectors, overrideDefaultConnectors]);
-    return (_jsx(ThirdwebProvider, { children: _jsx(WagmiProvider, { config: wagmiConfig, reconnectOnMount: false, children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(TooltipProvider, { children: _jsx(ToastProvider, { children: _jsx(LocalSDKProvider, { onConnectCallback: onConnect, onLogoutCallback: onLogout, disableBSMNTAuthentication: disableBSMNTAuthentication, children: _jsxs(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: !!automaticallySetFirstEoa, theme: theme, clientType: clientType, partnerId: partnerId, stripePublishableKey: stripePublishableKey, createClientReferenceId: createClientReferenceId, defaultPermissions: defaultPermissions, children: [_jsx(ToastContextConnector, {}), _jsxs(RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, _jsx(StyleRoot, { id: "b3-root" })] }), _jsx(AuthenticationProvider, { partnerId: partnerId, automaticallySetFirstEoa: !!automaticallySetFirstEoa, defaultEoaProvider: defaultEoaProvider })] }) }) }) }) }) }) }));
+    return (_jsx(WalletProvider, { wagmiConfig: wagmiConfig, queryClient: queryClient, children: _jsx(TooltipProvider, { children: _jsx(ToastProvider, { children: _jsx(LocalSDKProvider, { onConnectCallback: onConnect, onLogoutCallback: onLogout, disableBSMNTAuthentication: disableBSMNTAuthentication, children: _jsxs(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: !!automaticallySetFirstEoa, theme: theme, clientType: clientType, partnerId: partnerId, stripePublishableKey: stripePublishableKey, createClientReferenceId: createClientReferenceId, defaultPermissions: defaultPermissions, children: [_jsx(ToastContextConnector, {}), _jsxs(RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, _jsx(StyleRoot, { id: "b3-root" })] }), _jsx(AuthenticationProvider, { partnerId: partnerId, automaticallySetFirstEoa: !!automaticallySetFirstEoa, defaultEoaProvider: defaultEoaProvider })] }) }) }) }) }));
 }
 /**
  * Component to connect the toast context to the global toast API

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

@@ -1,14 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { WalletProvider } from "../../../../wallet/react/index.js";
 import { ThirdwebProvider } from "thirdweb/react";
 import { useMemo } from "react";
-import { WagmiProvider } from "wagmi";
 import { createWagmiConfig } from "../../utils/createWagmiConfig.js";
 import AuthenticationProvider from "./AuthenticationProvider.js";
 import { B3ConfigProvider } from "./B3ConfigProvider.js";
 import { LocalSDKProvider } from "./LocalSDKProvider.js";
-// Create queryClient instance
-const queryClient = new QueryClient();
 /**
  * Main B3Provider component
  */
@@ -20,5 +17,5 @@ export function B3Provider({ theme = "light", children, accountOverride, environ
  */
 export function InnerProvider({ children, accountOverride, environment, defaultPermissions, theme = "light", clientType = "socket", partnerId, rpcUrls, }) {
     const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId, rpcUrls }), [partnerId, rpcUrls]);
-    return (_jsx(WagmiProvider, { config: wagmiConfig, children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: false, theme: theme, clientType: clientType, partnerId: partnerId, defaultPermissions: defaultPermissions, children: children }) }) }));
+    return (_jsx(WalletProvider, { wagmiConfig: wagmiConfig, children: _jsx(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: false, theme: theme, clientType: clientType, partnerId: partnerId, defaultPermissions: defaultPermissions, children: children }) }));
 }

package/dist/esm/global-account/react/utils/createWagmiConfig.d.ts

@@ -1,4 +1,4 @@
-import { type CreateConnectorFn } from "wagmi";
+import type { CreateConnectorFn } from "wagmi";
 export interface CreateWagmiConfigOptions {
     partnerId: string;
     rpcUrls?: Record<number, string>;
@@ -6,7 +6,8 @@ export interface CreateWagmiConfigOptions {
     overrideDefaultConnectors?: boolean;
 }
 /**
- * Creates a wagmi config with optional custom RPC URLs and connectors
+ * Creates a wagmi config with the B3 ecosystem wallet connector.
+ * Delegates to createWalletConfig and adds the ecosystem connector on top.
  * @param options.partnerId - Partner ID for the ecosystem wallet
  * @param options.rpcUrls - Optional mapping of chain IDs to RPC URLs
  * @param options.connectors - Additional connectors to include
@@ -14,14 +15,4 @@ export interface CreateWagmiConfigOptions {
  */
 export declare function createWagmiConfig(options: CreateWagmiConfigOptions): import("wagmi").Config<readonly [import("viem").Chain, ...import("viem").Chain[]], {
     [k: string]: import("viem").HttpTransport<undefined, false>;
-}, (CreateConnectorFn | CreateConnectorFn<import("thirdweb/dist/types/adapters/eip1193").EIP1193Provider | undefined, {
-    connect<withCapabilities extends boolean = false>(parameters?: import("@thirdweb-dev/wagmi-adapter").ConnectionOptions<withCapabilities> | undefined): Promise<{
-        accounts: withCapabilities extends true ? readonly {
-            address: `0x${string}`;
-            capabilities: Record<string, unknown>;
-        }[] : readonly `0x${string}`[];
-        chainId: number;
-    }>;
-}, {
-    "thirdweb:lastChainId": number;
-}>)[]>;
+}, CreateConnectorFn[]>;

package/dist/esm/global-account/react/utils/createWagmiConfig.js

@@ -1,11 +1,10 @@
+import { createWalletConfig } from "../../../wallet/utils/createWalletConfig.js";
 import { ecosystemWalletId } from "../../../shared/constants/index.js";
-import { supportedChains } from "../../../shared/constants/chains/supported.js";
 import { client } from "../../../shared/utils/thirdweb.js";
 import { inAppWalletConnector } from "@thirdweb-dev/wagmi-adapter";
-import { http } from "viem";
-import { createConfig } from "wagmi";
 /**
- * Creates a wagmi config with optional custom RPC URLs and connectors
+ * Creates a wagmi config with the B3 ecosystem wallet connector.
+ * Delegates to createWalletConfig and adds the ecosystem connector on top.
  * @param options.partnerId - Partner ID for the ecosystem wallet
  * @param options.rpcUrls - Optional mapping of chain IDs to RPC URLs
  * @param options.connectors - Additional connectors to include
@@ -21,9 +20,8 @@ export function createWagmiConfig(options) {
         }),
     ];
     const finalConnectors = overrideDefaultConnectors ? connectors : [...defaultConnectors, ...connectors];
-    return createConfig({
-        chains: [supportedChains[0], ...supportedChains.slice(1)],
-        transports: Object.fromEntries(supportedChains.map(chain => [chain.id, http(rpcUrls?.[chain.id])])),
+    return createWalletConfig({
         connectors: finalConnectors,
+        rpcUrls,
     });
 }

package/dist/esm/wallet/react/components/ConnectWallet.d.ts

@@ -0,0 +1,11 @@
+export interface ConnectWalletProps {
+    /** Theme for the modal and button. Defaults to "light". */
+    theme?: "light" | "dark";
+    /** Label for the connect button. Defaults to "Connect Wallet". */
+    buttonLabel?: string;
+}
+/**
+ * Drop-in wallet connection component styled to match the B3 design system.
+ * Uses inline styles — works in any app without tailwind configuration.
+ */
+export declare function ConnectWallet({ theme: themeProp, buttonLabel }: ConnectWalletProps): import("react/jsx-runtime").JSX.Element;