@b3dotfun/sdk 0.1.0 → 0.1.1-alpha.0

package/dist/types/anyspend/react/hooks/useWatchTransfer.d.ts

@@ -0,0 +1,41 @@
+export interface TransferResult {
+    amount: string;
+    formattedAmount: string;
+    txHash?: string;
+    timestamp: number;
+}
+export interface UseWatchTransferProps {
+    /** Address to watch for incoming transfers */
+    address: string;
+    /** Chain ID to watch on */
+    chainId: number;
+    /** Token address (use zero address for native token) */
+    tokenAddress: string;
+    /** Token decimals */
+    tokenDecimals: number;
+    /** Whether watching is enabled */
+    enabled?: boolean;
+    /** Callback when a transfer is detected */
+    onTransferDetected?: (result: TransferResult) => void;
+}
+/**
+ * Hook to watch for incoming transfers to an address by monitoring balance changes.
+ * When a transfer is detected (balance increases), it captures the amount and notifies.
+ */
+export declare function useWatchTransfer({ address, chainId, tokenAddress, tokenDecimals, enabled, onTransferDetected, }: UseWatchTransferProps): {
+    /** Whether currently watching for transfers */
+    isWatching: boolean;
+    /** The detected transfer result, if any */
+    transferResult: TransferResult | null;
+    /** Whether a transfer has been detected */
+    hasTransfer: boolean;
+    /** Reset and start watching again */
+    reset: () => void;
+    /** Manually refetch balance */
+    refetchBalance: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<{
+        decimals: number;
+        formatted: string;
+        symbol: string;
+        value: bigint;
+    }, import("viem").GetBalanceErrorType>>;
+};

package/dist/types/anyspend/utils/address.d.ts

@@ -13,3 +13,8 @@ export declare function isEvmOrSolanaAddress(address: string): boolean;
 export declare function isHyperliquidUSDC(chainId: number, address: string): boolean;
 export declare function normalizeAddress(address: string): string;
 export declare function eqci(a: string | null | undefined, b: string | null | undefined): boolean;
+/**
+ * Check if source and destination represent the same token on the same chain.
+ * When true, this is a pure transfer (no swap/bridge needed).
+ */
+export declare function isSameChainAndToken(sourceChainId: number, sourceTokenAddress: string, destinationChainId: number, destinationTokenAddress: string): boolean;

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

@@ -0,0 +1,31 @@
+import { CreateOnrampOrderParams } from "@b3dotfun/sdk/anyspend/react/hooks/useAnyspendCreateOnrampOrder";
+import { CreateOrderParams } from "@b3dotfun/sdk/anyspend/react/hooks/useAnyspendCreateOrder";
+import { PermissionsConfig } from "@b3dotfun/sdk/global-account/types/permissions";
+import { Account } from "thirdweb/wallets";
+import { ClientType } from "../../../client-manager";
+export interface B3ConfigContextType {
+    accountOverride?: Account;
+    automaticallySetFirstEoa: boolean;
+    environment: "development" | "production";
+    defaultPermissions: PermissionsConfig;
+    theme: "light" | "dark";
+    clientType: ClientType;
+    partnerId: string;
+    stripePublishableKey?: string;
+    createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
+    enableTurnkey: boolean;
+}
+export declare function B3ConfigProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, stripePublishableKey, createClientReferenceId, enableTurnkey, }: {
+    children: React.ReactNode;
+    accountOverride?: Account;
+    environment?: "development" | "production";
+    defaultPermissions?: PermissionsConfig;
+    automaticallySetFirstEoa?: boolean;
+    theme?: "light" | "dark";
+    clientType?: ClientType;
+    partnerId: string;
+    stripePublishableKey?: string;
+    createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
+    enableTurnkey?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useB3Config(): B3ConfigContextType;

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

@@ -8,7 +8,7 @@ import { ClientType } from "../../../client-manager";
 /**
  * Main B3Provider component
  */
-export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, connectors, overrideDefaultConnectors, createClientReferenceId, enableTurnkey, defaultPermissions, }: {
+export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, enableTurnkey, defaultPermissions, }: {
     theme: "light" | "dark";
     children: React.ReactNode;
     accountOverride?: Account;
@@ -25,6 +25,7 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     /** Partner-specific Stripe publishable key. If not provided, uses default B3 Stripe account. */
     stripePublishableKey?: string;
     onConnect?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
+    onLogout?: () => void | Promise<void>;
     connectors?: CreateConnectorFn[];
     overrideDefaultConnectors?: boolean;
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;

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

@@ -5,12 +5,14 @@ import { Wallet } from "thirdweb/wallets";
  */
 export interface LocalSDKContextType {
     onConnectCallback?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
+    onLogoutCallback?: () => void | Promise<void>;
 }
 export declare const LocalSDKContext: import("react").Context<LocalSDKContextType>;
 /**
  * Local SDK Provider that wraps the app and provides internal SDK state
  */
-export declare function LocalSDKProvider({ children, onConnectCallback, }: {
+export declare function LocalSDKProvider({ children, onConnectCallback, onLogoutCallback, }: {
     children: React.ReactNode;
     onConnectCallback?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
+    onLogoutCallback?: () => void | Promise<void>;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -2,15 +2,4 @@
  * Hook to access the B3 configuration
  * @deprecated This is just an alias for useB3Config. Use useB3Config directly instead.
  */
-export declare function useB3(): {
-    automaticallySetFirstEoa: boolean;
-    environment: "development" | "production";
-    theme: "light" | "dark";
-    clientType: import("../../../client-manager").ClientType;
-    partnerId: string;
-    createClientReferenceId: ((params: import("../../../../anyspend/react").CreateOrderParams | import("../../../../anyspend/react").CreateOnrampOrderParams) => Promise<string>) | undefined;
-    enableTurnkey: boolean;
-    stripePublishableKey: string | undefined;
-    defaultPermissions: import("../../../types/permissions").PermissionsConfig;
-    accountOverride: import("thirdweb/wallets").Account | undefined;
-};
+export declare function useB3(): import("./B3ConfigProvider").B3ConfigContextType;

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

@@ -1,17 +1 @@
-/**
- * Hook to access B3 configuration
- * Returns all config values from the Zustand store
- * Since config is static (set once at initialization), destructuring is fine here
- */
-export declare const useB3Config: () => {
-    automaticallySetFirstEoa: boolean;
-    environment: "development" | "production";
-    theme: "light" | "dark";
-    clientType: import("../../../client-manager").ClientType;
-    partnerId: string;
-    createClientReferenceId: ((params: import("../../../../anyspend/react").CreateOrderParams | import("../../../../anyspend/react").CreateOnrampOrderParams) => Promise<string>) | undefined;
-    enableTurnkey: boolean;
-    stripePublishableKey: string | undefined;
-    defaultPermissions: import("../../../types/permissions").PermissionsConfig;
-    accountOverride: import("thirdweb/wallets").Account | undefined;
-};
+export { useB3Config } from "./B3ConfigProvider";

package/dist/types/global-account/react/components/SingleUserSearchSelector/SingleUserSearchSelector.d.ts

@@ -0,0 +1,64 @@
+import type { CombinedProfile } from "../../hooks/useProfile";
+/**
+ * Profile type filter options for SingleUserSearchSelector
+ * - b3-ens: B3 ENS profiles
+ * - thirdweb-${string}: Thirdweb profiles (e.g., thirdweb-email, thirdweb-wallet)
+ * - ens-data: ENS data profiles
+ * - global-account: Global account profiles
+ */
+export type ProfileTypeFilter = "b3-ens" | `thirdweb-${string}` | "ens-data" | "global-account";
+export interface SingleUserSearchSelectorProps {
+    /**
+     * Callback function when a user is selected
+     * Returns the complete profile data including all profile types
+     */
+    onSelectUser: (profile: CombinedProfile) => void;
+    /**
+     * Optional: Filter results to only show profiles that include specific types
+     * If provided, only profiles containing at least one of these types will be shown
+     */
+    profileTypeFilter?: ProfileTypeFilter[];
+    /**
+     * Optional: Custom placeholder text for the search input
+     */
+    placeholder?: string;
+    /**
+     * Optional: Custom class name for the container
+     */
+    className?: string;
+    /**
+     * Optional: Show clear button when there's input
+     */
+    showClearButton?: boolean;
+    /**
+     * Optional: Show profile type badges in the result
+     */
+    showBadges?: boolean;
+    /**
+     * Optional: Minimum characters before triggering search
+     */
+    minSearchLength?: number;
+}
+/**
+ * SingleUserSearchSelector Component
+ *
+ * A specialized component for searching and selecting a single user profile.
+ * This component is designed specifically for single-user selection scenarios,
+ * not for multi-user or general profile browsing.
+ *
+ * Features:
+ * - Search by address or name
+ * - Filter results by profile type (b3-ens, thirdweb-*, ens-data, global-account)
+ * - Shows a single result in a dropdown
+ * - Callback with complete profile data on selection
+ *
+ * @example
+ * ```tsx
+ * <SingleUserSearchSelector
+ *   onSelectUser={(profile) => console.log('Selected:', profile)}
+ *   profileTypeFilter={['b3-ens', 'global-account']}
+ *   placeholder="Search by address or name..."
+ * />
+ * ```
+ */
+export declare function SingleUserSearchSelector({ onSelectUser, profileTypeFilter, placeholder, className, showClearButton, showBadges, minSearchLength, }: SingleUserSearchSelectorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { SingleUserSearchSelector } from "./SingleUserSearchSelector";
+export type { ProfileTypeFilter, SingleUserSearchSelectorProps } from "./SingleUserSearchSelector";

package/dist/types/global-account/react/components/WalletImage/WalletImage.d.ts

@@ -1,4 +1,4 @@
 declare const WalletImage: ({ fallback }: {
     fallback?: React.ReactNode;
-}) => string | number | bigint | true | import("react/jsx-runtime").JSX.Element | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | null;
+}) => string | number | bigint | true | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null;
 export default WalletImage;

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

@@ -24,6 +24,8 @@ export { AccountAssets } from "./AccountAssets/AccountAssets";
 export { MintButton } from "./MintButton/MintButton";
 export { SendETHButton } from "./SendETHButton/SendETHButton";
 export { SendERC20Button } from "./SendERC20Button/SendERC20Button";
+export { SingleUserSearchSelector } from "./SingleUserSearchSelector/SingleUserSearchSelector";
+export type { ProfileTypeFilter, SingleUserSearchSelectorProps, } from "./SingleUserSearchSelector/SingleUserSearchSelector";
 export { Button as CustomButton, buttonVariants as customButtonVariants } from "./custom/Button";
 export { ClientOnly } from "./custom/ClientOnly";
 export { CopyToClipboard } from "./custom/CopyToClipboard";

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

@@ -30,7 +30,8 @@ export { useQueryBSMNT } from "./useQueryBSMNT";
 export { useRemoveSessionKey } from "./useRemoveSessionKey";
 export { useRouter } from "./useRouter";
 export { useSearchParamsSSR } from "./useSearchParamsSSR";
-export { useSimBalance, useSimSvmBalance } from "./useSimBalance";
+export { useSimBalance, useSimSvmBalance, useSimTokenBalance } from "./useSimBalance";
+export { useSimCollectibles } from "./useSimCollectibles";
 export { useSiwe } from "./useSiwe";
 export { useTokenBalance } from "./useTokenBalance";
 export { useTokenBalanceDirect } from "./useTokenBalanceDirect";

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

@@ -50,3 +50,10 @@ export interface SvmBalanceResponse {
 }
 export declare function useSimBalance(address?: string, chainIdsParam?: number[]): import("@tanstack/react-query").UseQueryResult<SimBalanceResponse, Error>;
 export declare function useSimSvmBalance(address?: string, chains?: ("solana" | "eclipse")[], limit?: number): import("@tanstack/react-query").UseQueryResult<SvmBalanceResponse, Error>;
+/**
+ * Hook to fetch a single token balance for a wallet.
+ * @param walletAddress - The wallet address to fetch balance for
+ * @param tokenAddress - The token contract address, or "native" for native token (ETH, etc.)
+ * @param chainId - Chain ID to query (defaults to 1 for Ethereum mainnet)
+ */
+export declare function useSimTokenBalance(walletAddress?: string, tokenAddress?: string, chainId?: number): import("@tanstack/react-query").UseQueryResult<SimBalanceResponse, Error>;

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

@@ -0,0 +1,45 @@
+import type { SimpleHashNFTResponse } from "@b3dotfun/sdk/global-account/types/simplehash.types";
+export interface SimCollectibleMetadata {
+    uri: string;
+    attributes?: Array<{
+        trait_type: string;
+        value: string;
+        display_type?: string | null;
+    }>;
+}
+export interface SimCollectibleEntry {
+    contract_address: string;
+    token_standard: "ERC721" | "ERC1155";
+    token_id: string;
+    chain: string;
+    chain_id: number;
+    name?: string;
+    description?: string;
+    symbol?: string;
+    image_url?: string;
+    last_sale_price?: string;
+    metadata?: SimCollectibleMetadata;
+    is_spam?: boolean;
+    spam_score?: number;
+    explanations?: string[];
+    balance?: string;
+    last_acquired?: string;
+}
+export interface SimCollectiblesResponse {
+    address: string;
+    entries: SimCollectibleEntry[];
+    next_offset?: string;
+    request_time: string;
+    response_time: string;
+}
+/**
+ * Hook to fetch NFT collectibles from Simdune API.
+ * Returns data in SimpleHash format for compatibility with AccountAssets component.
+ * @param address - Wallet address to fetch collectibles for
+ * @param chainIdsParam - Optional array of chain IDs to filter by
+ * @param options - Optional parameters (limit, filterSpam)
+ */
+export declare function useSimCollectibles(address?: string, chainIdsParam?: number[], options?: {
+    limit?: number;
+    filterSpam?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<SimpleHashNFTResponse, Error>;

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

@@ -1,5 +1,4 @@
 export { useAuthStore } from "./useAuthStore";
-export { useB3ConfigStore } from "./configStore";
 export { useModalStore } from "./useModalStore";
 export { useRecentAddressesStore } from "./useRecentAddressesStore";
 export type { AnySpendBuySpinProps, AnySpendFundTournamentProps, AnySpendJoinTournamentProps, AnySpendModalProps, AnySpendNftProps, AnySpendOrderHistoryProps, AnySpendStakeB3Props, AnyspendOrderDetailsProps, ManageAccountModalProps, ModalContentType, RequestPermissionsModalProps, SignInWithB3ModalProps, } from "./useModalStore";

package/dist/types/global-account/react/stores/useModalStore.d.ts

@@ -482,10 +482,70 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
     /** Force fiat payment */
     forceFiatPayment?: boolean;
 }
+/**
+ * Props for the AnySpend Deposit modal
+ * Flexible deposit component with optional chain selection
+ */
+export interface AnySpendDepositModalProps extends BaseModalProps {
+    /** Modal type identifier */
+    type: "anySpendDeposit";
+    /** Order ID to load an existing order */
+    loadOrder?: string;
+    /** The recipient address for the deposit */
+    recipientAddress: string;
+    /** Payment type - crypto or fiat. If not set, shows chain selection first */
+    paymentType?: "crypto" | "fiat";
+    /** Source token address to pre-select */
+    sourceTokenAddress?: string;
+    /** Source chain ID to pre-select. If not provided, shows chain selection */
+    sourceTokenChainId?: number;
+    /** The destination token address */
+    destinationTokenAddress: string;
+    /** The destination chain ID */
+    destinationTokenChainId: number;
+    /** Callback when deposit succeeds */
+    onSuccess?: (amount: string) => void;
+    /** Callback for opening a custom modal (e.g., for special token handling) */
+    onOpenCustomModal?: () => void;
+    /** Custom footer content */
+    mainFooter?: React.ReactNode;
+    /** Called when a token is selected. Call event.preventDefault() to prevent default behavior */
+    onTokenSelect?: (token: components["schemas"]["Token"], event: {
+        preventDefault: () => void;
+    }) => void;
+    /** Custom USD input value presets for fiat payment */
+    customUsdInputValues?: string[];
+    /** Whether to prefer using connected EOA wallet */
+    preferEoa?: boolean;
+    /** Minimum destination amount required */
+    minDestinationAmount?: number;
+    /** Order type for the deposit */
+    orderType?: "hype_duel" | "custom_exact_in" | "swap";
+    /** Custom action label displayed on buttons */
+    actionLabel?: string;
+    /** Whether to show chain selection step. Defaults to true if sourceTokenChainId is not provided */
+    showChainSelection?: boolean;
+    /** Minimum pool size for filtering tokens (default: 1,000,000) */
+    minPoolSize?: number;
+    /** Custom title for chain selection step */
+    chainSelectionTitle?: string;
+    /** Custom description for chain selection step */
+    chainSelectionDescription?: string;
+    /** Number of top chains to show (default: 3) */
+    topChainsCount?: number;
+    /** Custom URL to redirect to when clicking "Return to Home" on complete order screen */
+    returnToHomeUrl?: string;
+    /** Custom label for recipient display (e.g., "OBSN Telegram Bot") */
+    customRecipientLabel?: string;
+    /** Custom label for the return home button (overrides "Return to Home" / "Close") */
+    returnHomeLabel?: string;
+    /** Whether the deposit requires a custom function (uses AnySpendCustomExactIn). Defaults to false. */
+    isCustomDeposit?: boolean;
+}
 /**
  * Union type of all possible modal content types
  */
-export type ModalContentType = SignInWithB3ModalProps | TurnkeyAuthModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | LinkNewAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | DepositModalProps | SendModalProps | NotificationsModalProps | AnySpendCollectorClubPurchaseProps;
+export type ModalContentType = SignInWithB3ModalProps | TurnkeyAuthModalProps | RequestPermissionsModalProps | ManageAccountModalProps | AnySpendModalProps | AnyspendOrderDetailsProps | AnySpendNftProps | AnySpendJoinTournamentProps | AnySpendFundTournamentProps | AnySpendOrderHistoryProps | AnySpendStakeB3Props | AnySpendStakeB3ExactInProps | AnySpendStakeUpsideProps | AnySpendStakeUpsideExactInProps | AnySpendDepositUpsideProps | AnySpendBuySpinProps | AnySpendSignatureMintProps | AnySpendBondKitProps | LinkAccountModalProps | LinkNewAccountModalProps | AnySpendDepositHypeProps | AvatarEditorModalProps | DepositModalProps | SendModalProps | NotificationsModalProps | AnySpendCollectorClubPurchaseProps | AnySpendDepositModalProps;
 /**
  * State interface for the modal store
  */
@@ -514,6 +574,8 @@ interface ModalState {
     linkingMethod: string | null;
     /** Function to set the linking state */
     setLinkingState: (isLinking: boolean, method?: string | null) => void;
+    /** Function to update closable property of current content without adding to history */
+    setClosable: (closable: boolean) => void;
 }
 /**
  * Zustand store for managing modal state

package/dist/types/global-account/react/utils/profileApi.d.ts

@@ -0,0 +1,13 @@
+import type { CombinedProfile } from "../hooks/useProfile";
+export declare const PROFILES_API_URL = "https://profiles.b3.fun";
+/**
+ * Fetch a user profile from the B3 Profiles API
+ * @param params - Search parameters (address, name, or b3GlobalId)
+ * @returns Promise resolving to CombinedProfile or null if not found
+ */
+export declare function fetchProfile({ address, name, b3GlobalId, fresh, }: {
+    address?: string;
+    name?: string;
+    b3GlobalId?: string;
+    fresh?: boolean;
+}): Promise<CombinedProfile>;

package/dist/types/global-account/react/utils/simdune.d.ts

@@ -0,0 +1,7 @@
+export declare const SIMDUNE_API_HOST = "https://simdune-api.sean-430.workers.dev";
+/**
+ * Builds a Simdune API URL with the proxy wrapper and optional dev mode key.
+ * @param endpoint - The Simdune API endpoint (e.g., "/v1/evm/balances/0x...")
+ * @param queryParams - Optional URLSearchParams to append
+ */
+export declare function buildSimduneUrl(endpoint: string, queryParams?: URLSearchParams): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1-alpha.0",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",
@@ -131,6 +131,11 @@
         "require": "./dist/cjs/global-account/react/components/*.js"
       }
     },
+    "./global-account/react/components/SingleUserSearchSelector": {
+      "types": "./dist/types/global-account/react/components/SingleUserSearchSelector/index.d.ts",
+      "import": "./dist/esm/global-account/react/components/SingleUserSearchSelector/index.js",
+      "require": "./dist/cjs/global-account/react/components/SingleUserSearchSelector/index.js"
+    },
     "./global-account/types": {
       "types": "./dist/types/global-account/types.d.ts",
       "import": "./dist/esm/global-account/types.js",

package/src/anyspend/react/components/AnySpend.tsx

@@ -1089,6 +1089,7 @@ function AnySpendInner({
             }}
             returnToHomeUrl={returnToHomeUrl}
             returnHomeLabel={returnHomeLabel}
+            disableUrlParamManagement={disableUrlParamManagement}
           />
         )}
         {/* {mode === "page" && <div className="h-12" />} */}