@b3dotfun/sdk 0.1.70-alpha.2 → 0.1.70-alpha.21

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

@@ -0,0 +1,15 @@
+import { type B3TokenBalance } from "@b3dotfun/sdk/shared/utils/zerionPositions";
+/**
+ * Holdings for a wallet, optionally narrowed to specific chains.
+ *
+ * Read `isError` before reading `data`: a failed read and an empty wallet are different facts, and
+ * rendering the first as the second tells the user they hold nothing when nobody knows.
+ */
+export declare function usePortfolioBalance(address?: string, chainIds?: number[]): import("@tanstack/react-query").UseQueryResult<B3TokenBalance[], Error>;
+/**
+ * One token's balance for a wallet, served from the same per-wallet fetch as {@link usePortfolioBalance}.
+ *
+ * `tokenAddress` may be a contract address or the chain's native sentinel; matching is
+ * case-insensitive because callers pass addresses in whatever casing their source used.
+ */
+export declare function usePortfolioTokenBalance(walletAddress?: string, tokenAddress?: string, chainId?: number): import("@tanstack/react-query").UseQueryResult<B3TokenBalance | undefined, Error>;

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

@@ -0,0 +1,12 @@
+import type { SimpleHashNFTResponse } from "@b3dotfun/sdk/global-account/types/simplehash.types";
+/**
+ * NFTs held by a wallet, in the SimpleHash shape `AccountAssets` already renders.
+ *
+ * Chain narrowing happens here rather than in the request: the upstream rejects some valid chain
+ * slugs outright and fails the whole request when one is present, so asking for a subset can cost
+ * you the whole answer.
+ */
+export declare function usePortfolioCollectibles(address?: string, chainIds?: number[], options?: {
+    limit?: number;
+    filterSpam?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<SimpleHashNFTResponse, Error>;

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

@@ -1,4 +1,4 @@
 import { Account } from "thirdweb/wallets";
 export declare function useSiwe(): {
-    authenticate: (account: Account, partnerId: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    authenticate: (account: Account, partnerId: string) => Promise<Record<string, any>>;
 };

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

@@ -1,4 +1,4 @@
 import { Account } from "thirdweb/wallets";
 export declare function useSiwe(): {
-    authenticate: (account: Account, partnerId: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    authenticate: (account: Account, partnerId: string) => Promise<Record<string, any>>;
 };

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

@@ -3,5 +3,5 @@ import { Wallet } from "thirdweb/wallets";
  * @deprecated Use useAuth() instead
  */
 export declare function useTWAuth(): {
-    authenticate: (wallet: Wallet, partnerId: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    authenticate: (wallet: Wallet, partnerId: string) => Promise<Record<string, any>>;
 };

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

@@ -5,6 +5,7 @@ export interface UnifiedTransactionParams {
 }
 export declare function useUnifiedChainSwitchAndExecute(): {
     switchChainAndExecute: (targetChainId: number, params: UnifiedTransactionParams) => Promise<string | undefined>;
+    switchChainAndExecuteWithGlobalAccount: (targetChainId: number, params: UnifiedTransactionParams, expectedGlobalAccountAddress?: string) => Promise<string | undefined>;
     switchChainAndExecuteWithEOA: (targetChainId: number, params: UnifiedTransactionParams) => Promise<string | undefined>;
     isSwitchingOrExecuting: boolean;
     isActiveSmartWallet: boolean | undefined;

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

@@ -617,8 +617,16 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
     destinationTokenAddress: string;
     /** The destination chain ID */
     destinationTokenChainId: number;
+    /**
+     * When false, the destination token is user-selectable even though a default destination token is
+     * provided (the provided destination is used only as the initial/default value). Used by the
+     * wallet-funding deposit flow so the user can change the receive token away from the default
+     * (Base USDC). Defaults to true (locked destination). Does not affect the QR/pure-transfer path. */
+    lockDestinationToken?: boolean;
     /** Callback when deposit succeeds */
     onSuccess?: (amount: string) => void;
+    /** Callback when the modal's close control is pressed. */
+    onClose?: () => void;
     /** Callback for opening a custom modal (e.g., for special token handling) */
     onOpenCustomModal?: () => void;
     /** Custom footer content */
@@ -641,8 +649,6 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
     showChainSelection?: boolean;
     /** Whether to show the "Fund with Fiat" option in the deposit options list. Defaults to true */
     showFiatOption?: 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 */
@@ -661,6 +667,12 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
     classes?: AnySpendAllClasses;
     /** Whether to allow direct transfer without swap */
     allowDirectTransfer?: boolean;
+    /**
+     * When true, the QR-deposit path is a PURE TRANSFER: the destination token/chain
+     * mirror the user's selected source token, so the exact token they send lands in
+     * their wallet on the same chain (no swap/bridge).
+     */
+    pureTransferOnly?: boolean;
     /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
     callbackMetadata?: Record<string, unknown>;
 }

package/dist/types/global-account/types/b3-api.types.d.ts

@@ -3,9 +3,13 @@
  */
 type ObjectId = string;
 interface PartnerIds {
+    /** @deprecated Privy is no longer used for authentication. This field exists for legacy data compatibility only. */
     privyId?: string;
     thirdwebId?: string;
 }
+/**
+ * @deprecated Privy is no longer used for authentication. This type exists for legacy data compatibility only.
+ */
 interface PrivyLinkedAccount {
     type: string;
     address?: string;
@@ -45,6 +49,7 @@ interface User {
     createdAt: number;
     updatedAt: number;
     partnerIds: PartnerIds;
+    /** @deprecated Privy is no longer used for authentication. This field exists for legacy data compatibility only. */
     privyLinkedAccounts?: PrivyLinkedAccount[];
     twProfiles?: TWProfile[];
 }

package/dist/types/global-account/types/feature-flags.d.ts

@@ -1,8 +1,8 @@
 import { Static } from "@feathersjs/typebox";
-export declare const featureFlagsSchema: import("@feathersjs/typebox").TObject<{
-    _id: import("@feathersjs/typebox").TUnion<[import("@feathersjs/typebox").TString<string>, import("@feathersjs/typebox").TObject<{}>]>;
-    id: import("@feathersjs/typebox").TString<string>;
-    enabled: import("@feathersjs/typebox").TBoolean;
-    description: import("@feathersjs/typebox").TString<string>;
+export declare const featureFlagsSchema: import("@sinclair/typebox").TObject<{
+    _id: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString<string>, import("@sinclair/typebox").TObject<{}>]>;
+    id: import("@sinclair/typebox").TString<string>;
+    enabled: import("@sinclair/typebox").TBoolean;
+    description: import("@sinclair/typebox").TString<string>;
 }>;
 export type FeatureFlags = Static<typeof featureFlagsSchema>;

package/dist/types/shared/constants/chains/b3Chain.d.ts

@@ -1,4 +1,3 @@
-import { ChainNetworks } from "@b3dotfun/sdk/global-account/types/chain-networks";
 import { Chain as ThirdwebChain } from "thirdweb";
 import { Chain } from "viem";
 export declare const nullAddress = "0x0000000000000000000000000000000000000000";
@@ -33,17 +32,29 @@ export declare const b3Mainnet: {
     experimental_preconfirmationTime?: number | undefined | undefined;
     rpcUrls: {
         readonly default: {
-            readonly http: readonly ["https://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2"];
-            readonly ws: readonly ["wss://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2"];
+            readonly http: readonly ["https://mainnet-rpc.b3.fun"];
+            readonly ws: readonly ["wss://mainnet-rpc.b3.fun/ws"];
         };
     };
     sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | undefined | undefined;
     testnet?: boolean | undefined | undefined;
     custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
     fees?: import("viem").ChainFees<undefined> | undefined;
     formatters?: undefined;
+    prepareTransactionRequest?: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        client: import("viem").Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | [fn: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        client: import("viem").Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
     serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
-    readonly rpc: "https://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2";
+    verifyHash?: ((client: import("viem").Client, parameters: import("viem").VerifyHashActionParameters) => Promise<import("viem").VerifyHashActionReturnType>) | undefined;
+    readonly rpc: "https://mainnet-rpc.b3.fun";
     readonly icon: {
         readonly url: "https://cdn.b3.fun/b3_logo.svg";
         readonly width: 32;
@@ -51,55 +62,8 @@ export declare const b3Mainnet: {
         readonly format: "svg";
     };
 };
-export declare const getViemChainConfig: (config: ChainNetworks) => {
-    blockExplorers: {
-        readonly default: {
-            readonly name: string;
-            readonly url: string;
-        };
-    };
-    blockTime?: number | undefined | undefined;
-    contracts?: {
-        [x: string]: import("viem").ChainContract | {
-            [sourceId: number]: import("viem").ChainContract | undefined;
-        } | undefined;
-        ensRegistry?: import("viem").ChainContract | undefined;
-        ensUniversalResolver?: import("viem").ChainContract | undefined;
-        multicall3?: import("viem").ChainContract | undefined;
-        erc6492Verifier?: import("viem").ChainContract | undefined;
-    } | undefined;
-    ensTlds?: readonly string[] | undefined;
-    id: number;
-    name: string;
-    nativeCurrency: {
-        symbol: string;
-        name: string;
-        decimals: number;
-    };
-    experimental_preconfirmationTime?: number | undefined | undefined;
-    rpcUrls: {
-        readonly default: {
-            readonly http: readonly [string];
-            readonly ws: readonly [string];
-        };
-    };
-    sourceId?: number | undefined | undefined;
-    testnet: true | undefined;
-    custom?: Record<string, unknown> | undefined;
-    fees?: import("viem").ChainFees<undefined> | undefined;
-    formatters?: undefined;
-    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
-    readonly rpc: string;
-    readonly icon: {
-        format: string;
-        url: string;
-        width: number;
-        height: number;
-    };
-};
 export declare const thirdwebB3Testnet: ThirdwebChain;
 export declare const thirdwebB3Mainnet: ThirdwebChain;
-export declare const getThirdwebChainConfig: (config: ChainNetworks) => ThirdwebChain;
 export declare const b3Chain: Chain | {
     blockExplorers: {
         readonly default: {
@@ -128,17 +92,29 @@ export declare const b3Chain: Chain | {
     experimental_preconfirmationTime?: number | undefined | undefined;
     rpcUrls: {
         readonly default: {
-            readonly http: readonly ["https://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2"];
-            readonly ws: readonly ["wss://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2"];
+            readonly http: readonly ["https://mainnet-rpc.b3.fun"];
+            readonly ws: readonly ["wss://mainnet-rpc.b3.fun/ws"];
         };
     };
     sourceId?: number | undefined | undefined;
+    supportsTransactionReplacementDetection?: boolean | undefined | undefined;
     testnet?: boolean | undefined | undefined;
     custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
     fees?: import("viem").ChainFees<undefined> | undefined;
     formatters?: undefined;
+    prepareTransactionRequest?: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        client: import("viem").Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | [fn: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        client: import("viem").Client;
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
     serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
-    readonly rpc: "https://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2";
+    verifyHash?: ((client: import("viem").Client, parameters: import("viem").VerifyHashActionParameters) => Promise<import("viem").VerifyHashActionReturnType>) | undefined;
+    readonly rpc: "https://mainnet-rpc.b3.fun";
     readonly icon: {
         readonly url: "https://cdn.b3.fun/b3_logo.svg";
         readonly width: 32;

package/dist/types/shared/constants/chains/supported.d.ts

@@ -1,48 +1,7 @@
 import type { Chain as ThirdwebChain } from "thirdweb";
 export declare const supportedChains: import("viem").Chain[];
 export declare const supportedChainsTW: ThirdwebChain[];
-export declare const supportedChainNetworks: {
-    formatters?: Record<string, any> | undefined;
-    contracts?: Record<string, {
-        blockCreated?: number | undefined;
-        address: string;
-    }> | undefined;
-    sourceId?: number | undefined;
-    testnet?: boolean | undefined;
-    fees?: Record<string, any> | undefined;
-    color?: string | undefined;
-    testnetConfigID?: number | undefined;
-    badge?: string | undefined;
-    enabledFeatures?: string[] | undefined;
-    blockExplorers: {
-        default: string;
-        explorerTitle: string;
-    };
-    id: number;
-    name: string;
-    nativeCurrency: {
-        symbol: string;
-        name: string;
-        decimals: number;
-    };
-    rpcUrls: {
-        default: {
-            http: string;
-            ws: string;
-        };
-        backups: {
-            type: "http" | "ws";
-            uri: string;
-        }[];
-    };
-    _id: string | {};
-    icon: {
-        format: string;
-        url: string;
-        width: number;
-        height: number;
-    };
-}[];
+export declare const supportedChainNetworks: import("@b3/chain-registry/runtime").ChainDefinition[];
 export declare const coingeckoChains: Record<number, {
     coingecko_id: string;
     name: string;
@@ -56,14 +15,7 @@ export declare function getCoingeckoChainInfo(chainId: number): {
 export declare const b3MainnetThirdWeb: Readonly<import("thirdweb/chains").ChainOptions & {
     rpc: string;
 }>;
-export declare const b3TestnetThirdWeb: Readonly<import("thirdweb/chains").ChainOptions & {
-    rpc: string;
-}>;
 export declare const b3Mainnet: import("viem").Chain;
-export declare const b3Testnet: import("viem").Chain;
 export declare const baseMainnet: import("viem").Chain;
-/**
- * Get a Thirdweb chain by chain ID from supportedChainsTW
- */
 export declare function getThirdwebChain(chainId: number): ThirdwebChain;
 export declare function getChainLogo(chainId: number): string;

package/dist/types/shared/constants/index.d.ts

@@ -1,7 +1,11 @@
+import type { Wallet } from "thirdweb/wallets";
 export * from "./currency";
 export declare const siteURL = "https://basement.fun";
 export declare const b3CoinIcon = "https://cdn.b3.fun/b3-coin-3d.png";
 export declare const ecosystemWalletId: `ecosystem.${string}`;
+export type EcosystemWallet = Wallet<`ecosystem.${string}`> & {
+    getAuthToken: () => string | null;
+};
 export declare const tokenIcons: {
     ETH: string;
     WETH: string;

package/dist/types/shared/utils/chain-transformers.d.ts

@@ -1,5 +1,5 @@
-import type { ChainNetworks } from "@b3dotfun/sdk/global-account/types/chain-networks";
+import type { ChainDefinition } from "@b3/chain-registry";
 import type { Chain as ThirdwebChain } from "thirdweb";
-import { Chain } from "viem";
-export declare function toViemChain(network: ChainNetworks): Chain;
-export declare function toThirdwebChain(network: ChainNetworks): ThirdwebChain;
+import type { Chain } from "viem";
+export declare function toViemChain(chain: ChainDefinition): Chain;
+export declare function toThirdwebChain(chain: ChainDefinition): ThirdwebChain;

package/dist/types/shared/utils/upload.d.ts

@@ -0,0 +1,9 @@
+interface UploadOptions {
+    baseUrl?: string;
+}
+/**
+ * Upload a file to the B3 uploads service (Cloudflare R2).
+ * Returns the public URL of the uploaded asset.
+ */
+export declare function uploadFile(file: File, options?: UploadOptions): Promise<string>;
+export {};

package/dist/types/shared/utils/zerionPositions.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Canonical browser-side translation of Zerion wallet positions into B3 balance rows.
+ *
+ * This lives in the published SDK because every browser consumer needs it — the apps in this repo
+ * and the sites that install `@b3dotfun/sdk` from npm — and the in-repo Zerion client is a private
+ * workspace package that a published package cannot depend on. Backend services keep their own
+ * translation: pulling a browser SDK into a Node service to share one function is a worse trade
+ * than the second copy.
+ *
+ * Only the HTTP layer differs between callers. The rules below — which row counts as the chain's
+ * native coin, and which rows have no usable identity — must not be re-derived anywhere else.
+ */
+/** Address B3 uses for a chain's native coin on EVM. Matches NATIVE_TOKEN_ADDRESSES. */
+export declare const EVM_NATIVE_TOKEN_ADDRESS = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+export declare const SOLANA_NATIVE_TOKEN_ADDRESS: "So11111111111111111111111111111111111111112";
+export declare const SOLANA_ZERION_SLUG: "solana";
+/** Solana's chain id as the chain registry defines it — the id every balance row is keyed by. */
+export declare const SOLANA_CHAIN_ID: 7565164;
+export declare function zerionSlugToChainId(slug: string): number | undefined;
+export declare function chainIdToZerionSlug(chainId: number): string | undefined;
+export interface ZerionPositionQuantity {
+    int?: string;
+    decimals?: number;
+}
+export interface ZerionPositionImplementation {
+    chain_id?: string;
+    address?: string | null;
+    decimals?: number;
+}
+export interface ZerionPositionFungibleInfo {
+    name?: string;
+    symbol?: string;
+    icon?: {
+        url?: string;
+    } | null;
+    implementations?: ZerionPositionImplementation[];
+}
+export interface ZerionPositionLike {
+    id?: string;
+    attributes?: {
+        quantity?: ZerionPositionQuantity;
+        value?: number | null;
+        price?: number | null;
+        fungible_info?: ZerionPositionFungibleInfo;
+        flags?: {
+            displayable?: boolean;
+            is_trash?: boolean;
+        };
+    };
+    relationships?: {
+        chain?: {
+            data?: {
+                id?: string;
+            };
+        };
+    };
+}
+/** One spendable holding. `amount` is the raw integer; pair it with `decimals` to display. */
+export interface B3TokenBalance {
+    chain: string;
+    chain_id: number;
+    address: string;
+    amount: string;
+    symbol: string;
+    decimals: number;
+    /**
+     * Whether `address` is the native-coin sentinel rather than a real contract. Callers deciding
+     * between a value-bearing send and an ERC-20 `transfer` MUST branch on this, never on the
+     * sentinel string: getting it backwards spends gas and moves nothing.
+     */
+    is_native: boolean;
+    name?: string;
+    price_usd?: number;
+    value_usd?: number;
+    token_metadata?: {
+        logo: string;
+    };
+}
+export declare function nativeTokenAddressForChain(slug: string): string;
+/**
+ * Whether `balance` is the token identified by `tokenAddress`.
+ *
+ * Native coins are matched on the row's `is_native` flag rather than its printed address, because
+ * the caller and the adapter rarely spell the native coin the same way.
+ */
+export declare function balanceMatchesToken(balance: B3TokenBalance, tokenAddress: string): boolean;
+/**
+ * Adapt raw Zerion positions into balance rows, dropping any row we cannot describe honestly.
+ *
+ * A row is dropped when its chain slug is absent or unmapped, or when neither the quantity nor the
+ * chain implementation carries decimals — an amount rendered against a guessed scale is a wrong
+ * number presented as a real one, which is worse for the reader than a missing row.
+ *
+ * @param slugToChainId overrides slug resolution; return undefined to skip a chain entirely.
+ */
+export declare function adaptZerionPositions(positions: ZerionPositionLike[], slugToChainId?: (slug: string) => number | undefined): B3TokenBalance[];