@b3dotfun/sdk 0.1.0 → 0.1.1-alpha.1

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

@@ -16,7 +16,7 @@ import { useTWAuth } from "./useTWAuth.js";
 import { useUserQuery } from "./useUserQuery.js";
 const debug = debugB3React("useAuthentication");
 export function useAuthentication(partnerId) {
-    const { onConnectCallback } = useContext(LocalSDKContext);
+    const { onConnectCallback, onLogoutCallback } = useContext(LocalSDKContext);
     const { disconnect } = useDisconnect();
     const wallets = useConnectedWallets();
     const activeWallet = useActiveWallet();
@@ -150,7 +150,10 @@ export function useAuthentication(partnerId) {
         setIsConnected(false);
         setUser();
         callback?.();
-    }, [activeWallet, disconnect, wallets, setIsAuthenticated, setUser, setIsConnected]);
+        if (onLogoutCallback) {
+            await onLogoutCallback();
+        }
+    }, [activeWallet, disconnect, wallets, setIsAuthenticated, setUser, setIsConnected, onLogoutCallback]);
     const onConnect = useCallback(async (_walleAutoConnectedWith, allConnectedWallets) => {
         debug("@@useAuthentication:onConnect", { _walleAutoConnectedWith, allConnectedWallets });
         try {

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

@@ -1,24 +1,5 @@
 import { useQuery } from "@tanstack/react-query";
-const PROFILES_API_URL = "https://profiles.b3.fun";
-async function fetchProfile({ address, name, b3GlobalId, fresh = false, }) {
-    if (!address && !name && !b3GlobalId) {
-        throw new Error("Either address or name or b3GlobalId must be provided");
-    }
-    const params = new URLSearchParams();
-    if (address)
-        params.append("address", address);
-    if (name)
-        params.append("name", name);
-    if (b3GlobalId)
-        params.append("b3GlobalId", b3GlobalId);
-    if (fresh)
-        params.append("fresh", "true");
-    const response = await fetch(`${PROFILES_API_URL}?${params.toString()}`);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch profile: ${response.statusText}`);
-    }
-    return response.json();
-}
+import { fetchProfile, PROFILES_API_URL } from "../utils/profileApi.js";
 async function setProfilePreference({ key, preferredType, signature, signer, timestamp, }) {
     const response = await fetch(`${PROFILES_API_URL}/preference`, {
         method: "POST",

package/dist/esm/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/esm/global-account/react/hooks/useSimBalance.js

@@ -1,12 +1,14 @@
 import { useQuery } from "@tanstack/react-query";
+import { buildSimduneUrl } from "../utils/simdune.js";
 async function fetchSimBalance(address, chainIdsParam) {
     if (!address)
         throw new Error("Address is required");
     const chainIds = chainIdsParam.length === 0 ? "mainnet" : chainIdsParam.join(",");
-    let url = `https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/v1/evm/balances/${address}?metadata=logo&chain_ids=${chainIds}&exclude_spam_tokens=true`;
-    if (process.env.NEXT_PUBLIC_DEVMODE_SHARED_SECRET) {
-        url += `&localkey=${process.env.NEXT_PUBLIC_DEVMODE_SHARED_SECRET}`;
-    }
+    const queryParams = new URLSearchParams();
+    queryParams.append("metadata", "logo");
+    queryParams.append("chain_ids", chainIds);
+    queryParams.append("exclude_spam_tokens", "true");
+    const url = buildSimduneUrl(`/v1/evm/balances/${address}`, queryParams);
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`Failed to fetch balance: ${response.statusText}`);
@@ -14,6 +16,23 @@ async function fetchSimBalance(address, chainIdsParam) {
     const balanceData = await response.json();
     return balanceData;
 }
+async function fetchSimTokenBalance(walletAddress, tokenAddress, chainId) {
+    if (!walletAddress)
+        throw new Error("Wallet address is required");
+    if (!tokenAddress)
+        throw new Error("Token address is required");
+    if (!chainId)
+        throw new Error("Chain ID is required");
+    const queryParams = new URLSearchParams();
+    queryParams.append("chain_ids", chainId.toString());
+    const url = buildSimduneUrl(`/v1/evm/balances/${walletAddress}/token/${tokenAddress}`, queryParams);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch token balance: ${response.statusText}`);
+    }
+    const balanceData = await response.json();
+    return balanceData;
+}
 async function fetchSimSvmBalance(address, chains, limit) {
     if (!address)
         throw new Error("Address is required");
@@ -24,13 +43,7 @@ async function fetchSimSvmBalance(address, chains, limit) {
     if (limit) {
         queryParams.append("limit", limit.toString());
     }
-    let url = `https://simdune-api.sean-430.workers.dev/?url=https://api.sim.dune.com/beta/svm/balances/${address}`;
-    if (queryParams.toString()) {
-        url += `?${queryParams.toString()}`;
-    }
-    if (process.env.NEXT_PUBLIC_LOCAL_SIMDUNE_KEY) {
-        url += `${queryParams.toString() ? "&" : "?"}localkey=${process.env.NEXT_PUBLIC_LOCAL_SIMDUNE_KEY}`;
-    }
+    const url = buildSimduneUrl(`/beta/svm/balances/${address}`, queryParams.toString() ? queryParams : undefined);
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`Failed to fetch SVM balance: ${response.statusText}`);
@@ -60,3 +73,21 @@ export function useSimSvmBalance(address, chains, limit) {
         enabled: Boolean(address),
     });
 }
+/**
+ * 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 function useSimTokenBalance(walletAddress, tokenAddress, chainId) {
+    return useQuery({
+        queryKey: ["simTokenBalance", walletAddress, tokenAddress, chainId],
+        queryFn: () => {
+            if (!walletAddress || !tokenAddress || !chainId) {
+                throw new Error("Missing required parameters");
+            }
+            return fetchSimTokenBalance(walletAddress, tokenAddress, chainId);
+        },
+        enabled: Boolean(walletAddress) && Boolean(tokenAddress),
+    });
+}

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

@@ -0,0 +1,45 @@
+import type { SimpleHashNFTResponse } from "../../../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/esm/global-account/react/hooks/useSimCollectibles.js

@@ -0,0 +1,187 @@
+import { useQuery } from "@tanstack/react-query";
+import { buildSimduneUrl } from "../utils/simdune.js";
+/**
+ * Safely parse a balance string to a number, capping at MAX_SAFE_INTEGER
+ * to prevent overflow issues with large ERC1155 balances.
+ */
+function safeParseBalance(balance) {
+    if (!balance)
+        return 1;
+    const parsed = parseInt(balance, 10);
+    if (Number.isNaN(parsed))
+        return 1;
+    return Math.min(parsed, Number.MAX_SAFE_INTEGER);
+}
+async function fetchSimCollectibles(address, chainIdsParam, options) {
+    if (!address)
+        throw new Error("Address is required");
+    const queryParams = new URLSearchParams();
+    if (chainIdsParam && chainIdsParam.length > 0) {
+        queryParams.append("chain_ids", chainIdsParam.join(","));
+    }
+    if (options?.limit) {
+        queryParams.append("limit", options.limit.toString());
+    }
+    if (options?.filterSpam !== undefined) {
+        queryParams.append("filter_spam", options.filterSpam.toString());
+    }
+    const url = buildSimduneUrl(`/v1/evm/collectibles/${address}`, queryParams);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch collectibles: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data;
+}
+/**
+ * Transforms Simdune collectibles response to SimpleHash NFT format
+ * for compatibility with existing AccountAssets component
+ */
+function transformToSimpleHashFormat(data) {
+    const nfts = data.entries.map(entry => ({
+        nft_id: `${entry.chain}.${entry.contract_address}.${entry.token_id}`,
+        chain: entry.chain,
+        contract_address: entry.contract_address,
+        token_id: entry.token_id,
+        name: entry.name || "",
+        description: entry.description || "",
+        previews: {
+            image_small_url: entry.image_url || "",
+            image_medium_url: entry.image_url || "",
+            image_large_url: entry.image_url || "",
+            image_opengraph_url: entry.image_url || "",
+            blurhash: "",
+            predominant_color: "",
+        },
+        image_url: entry.image_url || "",
+        image_properties: {
+            width: 0,
+            height: 0,
+            size: 0,
+            mime_type: "",
+            exif_orientation: null,
+        },
+        video_url: null,
+        video_properties: null,
+        audio_url: null,
+        audio_properties: null,
+        model_url: null,
+        model_properties: null,
+        other_url: null,
+        other_properties: null,
+        background_color: null,
+        external_url: null,
+        created_date: "",
+        status: "minted",
+        token_count: 1,
+        owner_count: 1,
+        owners: [
+            {
+                owner_address: data.address,
+                quantity: safeParseBalance(entry.balance),
+                quantity_string: entry.balance || "1",
+                first_acquired_date: entry.last_acquired || "",
+                last_acquired_date: entry.last_acquired || "",
+            },
+        ],
+        contract: {
+            type: entry.token_standard,
+            name: entry.name || "",
+            symbol: entry.symbol || null,
+            deployed_by: "",
+            deployed_via_contract: "",
+            owned_by: "",
+            has_multiple_collections: false,
+        },
+        collection: {
+            collection_id: entry.contract_address,
+            name: entry.symbol || "Unknown Collection",
+            description: null,
+            image_url: entry.image_url || "",
+            image_properties: {
+                width: 0,
+                height: 0,
+                mime_type: "",
+            },
+            banner_image_url: null,
+            category: null,
+            is_nsfw: null,
+            external_url: null,
+            twitter_username: null,
+            discord_url: null,
+            instagram_username: null,
+            medium_username: null,
+            telegram_url: null,
+            marketplace_pages: [],
+            metaplex_mint: null,
+            metaplex_candy_machine: null,
+            metaplex_first_verified_creator: null,
+            floor_prices: [],
+            top_bids: [],
+            distinct_owner_count: 0,
+            distinct_nft_count: 0,
+            total_quantity: 0,
+            chains: [entry.chain],
+            top_contracts: [entry.contract_address],
+            collection_royalties: [],
+        },
+        last_sale: entry.last_sale_price
+            ? {
+                price: entry.last_sale_price,
+            }
+            : null,
+        primary_sale: null,
+        first_created: {
+            minted_to: data.address,
+            quantity: 1,
+            quantity_string: "1",
+            timestamp: "",
+            block_number: 0,
+            transaction: "",
+            transaction_initiator: "",
+        },
+        rarity: {
+            rank: null,
+            score: null,
+            unique_attributes: null,
+        },
+        royalty: [],
+        extra_metadata: {
+            attributes: (entry.metadata?.attributes || []).map(attr => ({
+                trait_type: attr.trait_type,
+                value: attr.value,
+                display_type: attr.display_type ?? null,
+            })),
+            image_original_url: entry.image_url || "",
+            animation_original_url: null,
+            metadata_original_url: entry.metadata?.uri || "",
+        },
+    }));
+    return {
+        next_cursor: data.next_offset || null,
+        next: null,
+        previous: null,
+        nfts,
+    };
+}
+/**
+ * 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 function useSimCollectibles(address, chainIdsParam, options) {
+    return useQuery({
+        queryKey: ["simCollectibles", address, chainIdsParam, options],
+        queryFn: async () => {
+            if (!address)
+                throw new Error("Address is required");
+            const data = await fetchSimCollectibles(address, chainIdsParam, options);
+            return transformToSimpleHashFormat(data);
+        },
+        enabled: Boolean(address),
+        staleTime: 30 * 1000,
+        gcTime: 5 * 60 * 1000,
+    });
+}

package/dist/esm/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/esm/global-account/react/stores/index.js

@@ -1,4 +1,3 @@
 export { useAuthStore } from "./useAuthStore.js";
-export { useB3ConfigStore } from "./configStore.js";
 export { useModalStore } from "./useModalStore.js";
 export { useRecentAddressesStore } from "./useRecentAddressesStore.js";

package/dist/esm/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/esm/global-account/react/stores/useModalStore.js

@@ -33,4 +33,7 @@ export const useModalStore = create(set => ({
     isLinking: false,
     linkingMethod: null,
     setLinkingState: (isLinking, method = null) => set({ isLinking, linkingMethod: isLinking ? method : null }),
+    setClosable: (closable) => set(state => ({
+        contentType: state.contentType ? { ...state.contentType, closable } : null,
+    })),
 }));

package/dist/esm/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/esm/global-account/react/utils/profileApi.js

@@ -0,0 +1,25 @@
+export 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 async function fetchProfile({ address, name, b3GlobalId, fresh = false, }) {
+    if (!address && !name && !b3GlobalId) {
+        throw new Error("Either address or name or b3GlobalId must be provided");
+    }
+    const params = new URLSearchParams();
+    if (address)
+        params.append("address", address);
+    if (name)
+        params.append("name", name);
+    if (b3GlobalId)
+        params.append("b3GlobalId", b3GlobalId);
+    if (fresh)
+        params.append("fresh", "true");
+    const response = await fetch(`${PROFILES_API_URL}?${params.toString()}`);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch profile: ${response.statusText}`);
+    }
+    return response.json();
+}

package/dist/esm/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/dist/esm/global-account/react/utils/simdune.js

@@ -0,0 +1,17 @@
+export 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 function buildSimduneUrl(endpoint, queryParams) {
+    const baseUrl = `${SIMDUNE_API_HOST}/?url=https://api.sim.dune.com${endpoint}`;
+    let url = baseUrl;
+    if (queryParams && queryParams.toString()) {
+        url += `?${queryParams.toString()}`;
+    }
+    if (process.env.NEXT_PUBLIC_DEVMODE_SHARED_SECRET) {
+        url += `${queryParams?.toString() ? "&" : "?"}localkey=${process.env.NEXT_PUBLIC_DEVMODE_SHARED_SECRET}`;
+    }
+    return url;
+}