@funkit/connect 0.0.0-20260710210119

package/dist/utils/flags/config.d.ts

@@ -0,0 +1,333 @@
+import type { Override } from './types';
+export declare const flagConfig: {
+    readonly blocked_countries: {
+        readonly type: "string";
+        readonly default_value: string;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["Y53dikxXdT4E3afI1l8BMBSWgyhKvf65k6Dut1k6", "di9ZSqn1Ya68Y2XpBPUV1rCtNGXh8Xe5MGWzb1Xe", "cGlmpTmNh657m8TiV5RFdwna6FG5pxM6ajiNHvw3", "57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG"];
+            }];
+            readonly value: "";
+        }];
+    };
+    readonly address_blacklist: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly show_powered_tagline: {
+        readonly type: "boolean";
+        readonly default_value: false;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["2hicPxo2vy2NMHcg2cEU9crOeKtDpc14NEfMCthc"];
+            }];
+            readonly value: true;
+        }];
+    };
+    readonly enable_token_transfer: {
+        readonly type: "boolean";
+        readonly default_value: true;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["di9ZSqn1Ya68Y2XpBPUV1rCtNGXh8Xe5MGWzb1Xe", "57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG"];
+            }];
+            readonly value: true;
+        }, Override<boolean>];
+    };
+    readonly enable_fiat_deposit: {
+        readonly type: "boolean";
+        readonly default_value: true;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["di9ZSqn1Ya68Y2XpBPUV1rCtNGXh8Xe5MGWzb1Xe", "57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG"];
+            }];
+            readonly value: true;
+        }, Override<boolean>];
+    };
+    readonly token_transfer_source_chains_and_assets: {
+        readonly type: "string";
+        readonly default_value: string;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["Y53dikxXdT4E3afI1l8BMBSWgyhKvf65k6Dut1k6"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["0IEOb9q4Kd9akgyPbIdW17HGYLY7MWEB2yRHyMxo"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["i6e1I8cfX625TTwRJlD2DshKyAoaUtO8aeoaR4i2"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["M3uox3cw0u8YCPV9cIREA6AugUMvPFTk6qOpm4um"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["2hicPxo2vy2NMHcg2cEU9crOeKtDpc14NEfMCthc"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["pLQBJsA6zS9tg990rbdBD6UdABkWRv5O60vlrVcW"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["clDebbfo9edXq1GydZ0CahSAfSimPj616lFa9p8e"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["5UzOrcAE2F3rcuMX2EeIlaYv5VUcDe6Lyh0PeZX2"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG"];
+            }];
+            readonly value: string;
+        }];
+    };
+    readonly withdrawal_chains_and_assets: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly enable_token_transfer_universal_deposit_address: {
+        readonly type: "boolean";
+        readonly default_value: true;
+    };
+    readonly max_checkout_usd: {
+        readonly type: "string";
+        readonly default_value: string;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "userId";
+                readonly type: "isAnyOf";
+                readonly values: ["0x7b97b46D35a28B561d47F50CFB9a2735E506e59d", "0x409ad08cc6CA757f69Fb80250a424B9eFeB99807"];
+            }];
+            readonly value: string;
+        }];
+    };
+    readonly checkout_time_estimate_overrides: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly token_transfer_default_chain_id: {
+        readonly type: "string";
+        readonly default_value: string;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["SMbBD7DS9b3EPcyBVg4a8az1rRWR9xB068chHoUN", "M3uox3cw0u8YCPV9cIREA6AugUMvPFTk6qOpm4um"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["6TUi99Tq3O9MWj1IFX8Pv6spmPXzcvhy9NvBoeW2"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["Y53dikxXdT4E3afI1l8BMBSWgyhKvf65k6Dut1k6"];
+            }];
+            readonly value: string;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["0IEOb9q4Kd9akgyPbIdW17HGYLY7MWEB2yRHyMxo"];
+            }];
+            readonly value: string;
+        }];
+    };
+    readonly is_checkout_activated: {
+        readonly type: "boolean";
+        readonly default_value: true;
+    };
+    readonly show_info_banner: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly checkout_notifications_refresh_interval: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly token_transfer_new_tokens: {
+        readonly type: "string";
+        readonly default_value: string;
+        readonly overrides: [];
+    };
+    readonly new_token_asset_selection_banner: {
+        readonly type: "string";
+        readonly default_value: "";
+    };
+    readonly is_relay_bypass_enabled: {
+        readonly type: "boolean";
+        readonly default_value: true;
+    };
+    readonly relay_bypass_source_chains_and_assets: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly relay_bypass_target_chains_and_assets: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly enable_card: {
+        readonly type: "boolean";
+        readonly default_value: false;
+        readonly overrides: [];
+    };
+    readonly enable_brokerage: {
+        readonly type: "boolean";
+        readonly default_value: false;
+    };
+    readonly enable_bluvo_brokerage: {
+        readonly type: "boolean";
+        readonly default_value: false;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "userId";
+                readonly type: "isAnyOf";
+                readonly values: string[];
+            }];
+            readonly value: true;
+        }, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["di9ZSqn1Ya68Y2XpBPUV1rCtNGXh8Xe5MGWzb1Xe", "57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG"];
+            }];
+            readonly value: true;
+        }, Override<boolean>, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["6TUi99Tq3O9MWj1IFX8Pv6spmPXzcvhy9NvBoeW2", "clDebbfo9edXq1GydZ0CahSAfSimPj616lFa9p8e", "57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG", "M3uox3cw0u8YCPV9cIREA6AugUMvPFTk6qOpm4um", "lI7amueGK94QtGa7sGGVf8n0XhIcn4sHFAZRu5Jj", "cGlmpTmNh657m8TiV5RFdwna6FG5pxM6ajiNHvw3", "USyZhcp7kB2mMsbRsaHDs3i52cE6srZw8KD8jZd0", "vte0gvTFGH7hPyPED46oV8TyJlyE8p6D7Q73TSx0", "ODW4jUppoG3H87YcY9GZhoGj4hX5W0w9mr24LEU8", "pLQBJsA6zS9tg990rbdBD6UdABkWRv5O60vlrVcW", "di9ZSqn1Ya68Y2XpBPUV1rCtNGXh8Xe5MGWzb1Xe", "53OWivH0fK2VIAuMZTycr52EnSEnPWj97Jy3Dpiz", "AH7lRIhbsL167nptv6eub9xDJXVHnYUm2vL7FLjK", "1cRIX8XoWP801OILra02i13IJ08IARBP5B6ydcnp", "i6e1I8cfX625TTwRJlD2DshKyAoaUtO8aeoaR4i2", "2hicPxo2vy2NMHcg2cEU9crOeKtDpc14NEfMCthc", "SMbBD7DS9b3EPcyBVg4a8az1rRWR9xB068chHoUN", "wQDLu86Qab61vbtru7thf8Yj0xaeqVUH4ohoXESu", "Y53dikxXdT4E3afI1l8BMBSWgyhKvf65k6Dut1k6", "iMTsSsgDdI2FC0FjeEejS9LMxuJgDhFO3OHlwVjT", "HKHvPSPDezaxsTohFgDuG4WpKW6hB4SFYyztm9vc", "5UzOrcAE2F3rcuMX2EeIlaYv5VUcDe6Lyh0PeZX2"];
+            }];
+            readonly value: true;
+        }];
+    };
+    readonly enable_meld_payment: {
+        readonly type: "boolean";
+        readonly default_value: false;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["di9ZSqn1Ya68Y2XpBPUV1rCtNGXh8Xe5MGWzb1Xe", "57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG"];
+            }];
+            readonly value: true;
+        }, Override<boolean>, {
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["6TUi99Tq3O9MWj1IFX8Pv6spmPXzcvhy9NvBoeW2", "clDebbfo9edXq1GydZ0CahSAfSimPj616lFa9p8e", "SLFrOWqgUK3XO8kVN11Is8QBXX9VnNjh3kKsCwy6", "57G91zNoew4nYxIoqSCpS1vWr8JT3gGVasNqMwgG", "M3uox3cw0u8YCPV9cIREA6AugUMvPFTk6qOpm4um", "cGlmpTmNh657m8TiV5RFdwna6FG5pxM6ajiNHvw3", "USyZhcp7kB2mMsbRsaHDs3i52cE6srZw8KD8jZd0", "vte0gvTFGH7hPyPED46oV8TyJlyE8p6D7Q73TSx0", "ODW4jUppoG3H87YcY9GZhoGj4hX5W0w9mr24LEU8", "pLQBJsA6zS9tg990rbdBD6UdABkWRv5O60vlrVcW", "53OWivH0fK2VIAuMZTycr52EnSEnPWj97Jy3Dpiz", "AH7lRIhbsL167nptv6eub9xDJXVHnYUm2vL7FLjK", "TY2G63jFfd7H29aHiJIzg5RqdXNdog2Q5jgb8tr7", "i6e1I8cfX625TTwRJlD2DshKyAoaUtO8aeoaR4i2", "1cRIX8XoWP801OILra02i13IJ08IARBP5B6ydcnp", "2hicPxo2vy2NMHcg2cEU9crOeKtDpc14NEfMCthc", "SMbBD7DS9b3EPcyBVg4a8az1rRWR9xB068chHoUN", "Y53dikxXdT4E3afI1l8BMBSWgyhKvf65k6Dut1k6", "wQDLu86Qab61vbtru7thf8Yj0xaeqVUH4ohoXESu", "iMTsSsgDdI2FC0FjeEejS9LMxuJgDhFO3OHlwVjT", "HKHvPSPDezaxsTohFgDuG4WpKW6hB4SFYyztm9vc", "5UzOrcAE2F3rcuMX2EeIlaYv5VUcDe6Lyh0PeZX2"];
+            }];
+            readonly value: true;
+        }, {
+            readonly if_any: [{
+                readonly key: "userId";
+                readonly type: "pctRollout";
+                readonly pct: 100;
+            }];
+            readonly value: false;
+        }];
+    };
+    readonly meld_quick_options: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly min_token_transfer_value: {
+        readonly type: "string";
+        readonly default_value: string;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["i6e1I8cfX625TTwRJlD2DshKyAoaUtO8aeoaR4i2"];
+            }];
+            readonly value: string;
+        }];
+    };
+    readonly withdrawal_exclude_tokens: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly token_transfer_default_tokens: {
+        readonly type: "string";
+        readonly default_value: "";
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["Y53dikxXdT4E3afI1l8BMBSWgyhKvf65k6Dut1k6"];
+            }];
+            readonly value: string;
+        }];
+    };
+    readonly chain_id_sort_order: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    readonly enable_bitcoin: {
+        readonly type: "boolean";
+        readonly default_value: false;
+        readonly overrides: [];
+    };
+    readonly chain_info_banners: {
+        readonly type: "string";
+        readonly default_value: string;
+    };
+    /** @deprecated Use frog quoteConfig */
+    readonly permit2_tokens: {
+        readonly type: "string";
+        readonly default_value: string;
+        readonly overrides: [{
+            readonly if_any: [{
+                readonly key: "apiKey";
+                readonly type: "isAnyOf";
+                readonly values: ["clDebbfo9edXq1GydZ0CahSAfSimPj616lFa9p8e"];
+            }];
+            readonly value: string;
+        }];
+    };
+};
+export type FlagConfig = typeof flagConfig;

package/dist/utils/flags/endpoint.d.ts

@@ -0,0 +1,22 @@
+import type { AbstractFlags } from './types';
+export declare const FLAG_ENDPOINT_HOST = "sdk-cdn.fun.xyz";
+export declare const FLAG_PROD_ENDPOINT_PATH = "flags/v0/config.json";
+export declare const FLAG_DEV_ENDPOINT_PATH = "flags/dev/config.json";
+export declare const FLAG_PROD_ENDPOINT = "https://sdk-cdn.fun.xyz/flags/v0/config.json";
+export type EndpointData<F extends AbstractFlags> = {
+    __meta__: {
+        build_time: string;
+        git_branch: string;
+        git_sha: string;
+        npm_version: string;
+    };
+    flags: F;
+};
+interface Env {
+    GIT_COMMIT_TIME: string;
+    GIT_BRANCH: string;
+    GIT_SHA: string;
+    npm_package_version: string;
+}
+export declare const generateEndpointJson: <F extends AbstractFlags>(env: Env, flags: F) => EndpointData<F>;
+export {};

package/dist/utils/flags/hash.d.ts

@@ -0,0 +1,13 @@
+/**
+    cyrb53 (c) 2018 bryc (github.com/bryc)
+    License: Public domain (or MIT if needed). Attribution appreciated.
+    A fast and simple 53-bit string hash function with decent collision resistance.
+    Largely inspired by MurmurHash2/3, but with a focus on speed/simplicity.
+*/
+export declare const cyrb53: (str: string, seed?: number) => number;
+/**
+ * Be careful changing this function, it will affect the rollout percentage.
+ * This hash function was picked because it's simple and fast and only needs
+ * to split across 100 buckets.
+ */
+export declare const hashPct: (flag_key: string, value: string, pct: number) => boolean;

package/dist/utils/flags/impl.d.ts

@@ -0,0 +1,10 @@
+import type { AbstractFlags, InferFlagType } from './types';
+export interface UserContext {
+    apiKey: string;
+    userId?: string;
+    ipCountry: string | undefined;
+}
+export declare function fetchConfigFromServer<F extends AbstractFlags>(): Promise<F>;
+export declare function deriveAllFlags<T extends AbstractFlags>(config: T, userContext: UserContext): {
+    [K in keyof T]?: InferFlagType<T[K]>;
+};

package/dist/utils/flags/resolver.d.ts

@@ -0,0 +1,34 @@
+type BaseCondition = {
+    type: 'country';
+    countryCodes: string[];
+};
+type Condition = BaseCondition | {
+    type: 'all';
+    conditions: Condition[];
+} | {
+    type: 'any';
+    conditions: Condition[];
+};
+interface Variant<T> {
+    condition?: Condition;
+    value: T;
+}
+interface VariantConfig<T> {
+    variants: Variant<T>[];
+    value: T;
+}
+interface EvaluationContext {
+    countryCode?: string;
+}
+/**
+ * Type guard to check if a value is a VariantConfig
+ * (used to distinguish from simple static configs)
+ */
+export declare function isVariantConfig<T>(value: unknown): value is VariantConfig<T>;
+/**
+ * Resolves the appropriate value from a VariantConfig based on runtime context.
+ * Evaluates variants in order and returns the first matching variant's value.
+ * Falls back to default value if no variants match.
+ */
+export declare function resolveValue<T>(config: VariantConfig<T>, ctx: EvaluationContext): T;
+export {};

package/dist/utils/flags/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * These are the data types that a feature flag can return.
+ * Note: they need to be values that can be expressed in JSON
+ */
+export type FlagConfig = BooleanFlagConfig | NumberFlagConfig | StringFlagConfig;
+export interface BooleanFlagConfig {
+    type: 'boolean';
+    default_value: boolean;
+    overrides?: Override<boolean>[];
+}
+export interface NumberFlagConfig {
+    type: 'number';
+    default_value: number;
+    overrides?: Override<number>[];
+}
+export interface StringFlagConfig {
+    type: 'string';
+    default_value: string;
+    overrides?: Override<string>[];
+}
+export type InferFlagType<F extends FlagConfig> = F['type'] extends 'number' ? number : F['type'] extends 'string' ? string : F['type'] extends 'boolean' ? boolean : never;
+export type Override<T> = {
+    /** non-empty list of conditions, any condition will cause the value to match */
+    if_any: Condition[];
+    /** non-empty list of conditions, all condition will cause the value to match */
+    if_all?: Condition[];
+    value: T;
+};
+type ConditionKey = 'userId' | 'apiKey' | 'ipCountry';
+export type Condition = {
+    type: 'pctRollout';
+    key: ConditionKey;
+    /** whole number from 0 - 100 inclusive */
+    pct: number;
+} | {
+    type: 'isAnyOf';
+    key: ConditionKey;
+    /** non-empty list of API keys */
+    values: string[];
+};
+export type AbstractFlags = Record<string, FlagConfig>;
+export type AssetSelectionBannerConfig = {
+    chainId: number;
+    symbol: string;
+    name: string;
+    isChainNew?: boolean;
+};
+export type TokenTransferNewBadgeConfig = Record<number, string[]>;
+export {};

package/dist/utils/freeUsdcBanner.d.ts

@@ -0,0 +1,3 @@
+export declare const STORAGE_KEY = "fkc-free-usdc-dismissed";
+export declare function isFreeUsdcBannerDismissed(): boolean;
+export declare function dismissFreeUsdcBanner(): void;

package/dist/utils/funLogger.d.ts

@@ -0,0 +1,3 @@
+import { FunLogger } from '@funkit/connect-core';
+declare const logger: FunLogger;
+export { logger, FunLogger };

package/dist/utils/funkitProvider.d.ts

@@ -0,0 +1,9 @@
+import type { FunkitCheckoutConfig } from '../providers/FunkitCheckoutContext';
+import type { FunkitProviderProps } from '../providers/FunkitProvider';
+export declare function getInitialChainIdFromFunkitProviderProps(props: FunkitProviderProps): number | undefined;
+export declare function generateSyntheticUserId(apiKey: string, externalUserId: string): string;
+/**
+ * Validates the passed in props of FunkitProvider. If there are any misconfigurations, an error will be thrown.
+ */
+export declare function validateFunkitProviderProps(props: FunkitProviderProps): void;
+export declare function getModalTitle(checkoutConfig: FunkitCheckoutConfig | undefined, fallbackTitle?: string): string;

package/dist/utils/getExchangeRate.d.ts

@@ -0,0 +1 @@
+export { getExchangeRate } from '@funkit/connect-core';

package/dist/utils/isMainnetUsdt.d.ts

@@ -0,0 +1,2 @@
+import type { Address } from 'viem';
+export declare function isMainnetUsdt(chainId: number | string, address: Address): boolean;

package/dist/utils/lighter.d.ts

@@ -0,0 +1,16 @@
+import { type Address } from 'viem';
+export declare const LIGHTER_DEPOSIT_ADDRESS: Address;
+export declare const LIGHTER_SLOW_DEPOSIT_TIME_ESTIMATE_SECONDS: number;
+export declare const LIGHTER_DELAYED_AUTO_TRIGGER_CUTOFF: number;
+export declare const LIGHTER_DYNAMIC_ROUTING_ID: {
+    ETH_SPOT: string;
+    USDC_PERPS: string;
+    ETH_SPOT_NEW_USER: string;
+    USDC_PERPS_NEW_USER: string;
+    LINK_SPOT_NEW_USER: string;
+    UNI_SPOT_NEW_USER: string;
+    AAVE_SPOT_NEW_USER: string;
+    SKY_SPOT_NEW_USER: string;
+    LDO_SPOT_NEW_USER: string;
+    LIT_SPOT_NEW_USER: string;
+};

package/dist/utils/openExternalFlowPopup.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Opens an external flow (e.g. Meld, Swapped) in a centered popup.
+ *
+ * iOS and Safari block window.open() calls that don't happen synchronously
+ * inside a user-gesture handler. Because the URL often isn't known until after
+ * an async fetch, we open about:blank immediately (within the gesture), show a
+ * spinner, and then set popup.location.href once the URL resolves. This keeps
+ * us inside the trusted-event window while still supporting async URL fetching.
+ *
+ * Returns true if the popup was opened, false if it was blocked.
+ */
+export declare function openExternalFlowPopup(linkGetter: () => Promise<{
+    widgetUrl: string;
+}>, options: {
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    loaderTheme: 'light' | 'dark';
+    loaderTitle: string;
+}): Promise<boolean>;

package/dist/utils/payment.d.ts

@@ -0,0 +1,10 @@
+import { LoginType } from '../providers/GeneralWalletProvider';
+import { type PaymentMethodInfo } from '../domains/paymentMethods';
+/**
+ * Generate a string for backend to indicate the source of a checkout funds
+ */
+export declare function generateSourceOfFundString({ paymentMethodInfo, loginType, walletAddress, }: {
+    paymentMethodInfo: PaymentMethodInfo;
+    loginType: LoginType;
+    walletAddress: string | undefined;
+}): string;

package/dist/utils/platforms.d.ts

@@ -0,0 +1,10 @@
+export declare enum PlatformType {
+    Windows = "Windows",
+    MacOS = "macOS",
+    Linux = "Linux",
+    Desktop = "Desktop"
+}
+export declare function isWindows(): boolean;
+export declare function isMacOS(): boolean;
+export declare function isLinux(): boolean;
+export declare function getPlatform(): PlatformType;

package/dist/utils/polygonRpcCheck.d.ts

@@ -0,0 +1,12 @@
+import type { Connector } from '../wagmi/hooks';
+export declare const POLYGON_CHAIN_ID = 137;
+/**
+ * Checks if the user's wallet RPC for Polygon is responsive by sending an eth_blockNumber call.
+ * We use eth_blockNumber instead of eth_chainId because eth_chainId can be intercepted
+ * by the wallet itself and may not actually hit the RPC.
+ *
+ * The default polygon-rpc.com stopped working in Feb 2026.
+ *
+ * @returns true if the RPC appears to be down/unreachable
+ */
+export declare function isPolygonRpcDown(fromChainId: string | undefined, connector: Connector | undefined): Promise<boolean>;

package/dist/utils/polymarket.d.ts

@@ -0,0 +1,6 @@
+import { type Address } from 'viem';
+/**
+ * Derives the Polymarket EOA proxy wallet address for a given wallet address
+ * using CREATE2 address derivation.
+ */
+export declare function derivePolymarketProxyAddress(address: Address): Address;

package/dist/utils/privyHelper.d.ts

@@ -0,0 +1,3 @@
+export declare const validateEmailString: (emailInput: string) => boolean;
+export declare const validatePhoneString: (phoneInput: string) => boolean;
+export declare const removeSpecificURLParameters: (paramsToRemove: string[]) => void;

package/dist/utils/purifyCheckoutHistoryItem.d.ts

@@ -0,0 +1,41 @@
+import { type CheckoutHistoryItem, type CheckoutState } from '@funkit/api-base';
+import type { ApiFunkitCheckoutActionParams } from '@funkit/utils';
+import type { Address, Hex } from 'viem';
+import type { MergedMultiStepDirectExecution } from '../domains/checkoutNotifications';
+export type PurifiedCheckoutHistoryItem = {
+    depositAddr?: Address;
+    directExecution: boolean;
+    id: Hex;
+    fromAmountBaseUnit: string;
+    fromChainId: string;
+    fromTokenAddress: Address;
+    state: CheckoutState;
+    toAmountBaseUnit: string;
+    toChainId: string;
+    toTokenAddress: Address;
+    createdTimeMs: number;
+    updatedTimeMs: number;
+    additionalActions: ApiFunkitCheckoutActionParams[];
+    isWithdrawal: boolean;
+    /**
+     * Customer-specific, presentation-only metadata. Kept in its own bag so
+     * customer concepts don't leak onto the shared top-level shape. Only present
+     * when there's something to surface for the item's customer.
+     */
+    customerMetadata?: {
+        /**
+         * For Lighter withdrawal direct executions: which route was used.
+         * `'secure'` is Lighter's native bridge to mainnet (recorded as
+         * `EXTERNALLY_FULFILLED`); `'fast'` routes through Fun + Relay.
+         */
+        lighterWithdrawalType?: 'fast' | 'secure';
+    };
+} & ({
+    depositAddr: Address;
+    directExecution: false;
+} | {
+    depositAddr?: never;
+    directExecution: true;
+    txHashes: Hex[];
+});
+export declare const purifyCheckoutHistoryItem: (item: CheckoutHistoryItem | MergedMultiStepDirectExecution) => PurifiedCheckoutHistoryItem;

package/dist/utils/safeBigInt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Convert a value to bigint without throwing. Accepts bigint, integer number,
+ * or an integer-valued string. Anything else returns the fallback.
+ */
+export declare function safeBigInt(value: unknown, fallback: bigint): bigint;

package/dist/utils/safeJSON.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This function is a wrapper around `safeParseJson()` from our `@funkit/utils` package with logging errors to our logger.
+ */
+export declare function safeJSONParse<T>(src?: string): T | null;
+export declare function useSafeJSONParse<T>(src?: string): T | null;

package/dist/utils/sanitizeHtml.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sanitizes a CSS string for injection into a `<style>` tag.
+ * Prevents breakout from the style element via `</style>` injection.
+ * This is defense-in-depth — cssStringFromTheme already strips
+ * `<`, `>`, `/` from theme values.
+ */
+export declare function sanitizeCssStyleContent(css: string): string;

package/dist/utils/sanitizeUrl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validates that a URL uses a safe protocol (http: or https:) and
+ * returns it, or returns undefined if the URL is invalid/unsafe.
+ */
+export declare function sanitizeUrl(url: string | undefined | null): string | undefined;
+/**
+ * Sanitizes a URL for use in CSS url() context by validating the protocol
+ * and percent-encoding characters that could break out of url('...').
+ */
+export declare function sanitizeCssUrl(url: string | undefined | null): string | undefined;

package/dist/utils/signature.d.ts

@@ -0,0 +1,2 @@
+export declare function isUserRejectedError(error: unknown): boolean;
+export declare function isSwitchChainError(error: unknown): boolean;