@b3dotfun/sdk 0.1.70-alpha.1 → 0.1.70-alpha.10

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

@@ -35,6 +35,7 @@ export function AnySpendDepositUpside({
   token,
   onSuccess,
   senderAddress,
+  showFiatOption,
   slots,
   content,
   theme,
@@ -49,6 +50,7 @@ export function AnySpendDepositUpside({
   onSuccess?: (amount: string) => void;
   /** Optional sender (payer) address — pre-fills token balances when the user address is known ahead of time */
   senderAddress?: string;
+  showFiatOption?: boolean;
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
@@ -87,6 +89,7 @@ export function AnySpendDepositUpside({
       header={header}
       onSuccess={onSuccess}
       senderAddress={senderAddress}
+      showFiatOption={showFiatOption}
       slots={slots}
       content={content}
       theme={theme}

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

@@ -54,6 +54,7 @@ export function AnySpendStakeB3({
   slots,
   content,
   theme,
+  showFiatOption,
 }: {
   loadOrder?: string;
   mode?: "modal" | "page";
@@ -65,6 +66,7 @@ export function AnySpendStakeB3({
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
+  showFiatOption?: boolean;
 }) {
   const hasMounted = useHasMounted();
   const { setB3ModalOpen } = useModalStore();
@@ -521,6 +523,7 @@ export function AnySpendStakeB3({
       slots={slots}
       content={content}
       theme={theme}
+      showFiatOption={showFiatOption}
     />
   );
 }

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

@@ -56,6 +56,7 @@ export function AnySpendStakeB3ExactIn({
   stakeAmount,
   onSuccess,
   senderAddress,
+  showFiatOption,
   slots,
   content,
   theme,
@@ -69,6 +70,7 @@ export function AnySpendStakeB3ExactIn({
   onSuccess?: (amount: string) => void;
   /** Optional sender (payer) address — pre-fills token balances when the user address is known ahead of time */
   senderAddress?: string;
+  showFiatOption?: boolean;
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
@@ -529,6 +531,7 @@ export function AnySpendStakeB3ExactIn({
       header={header}
       onSuccess={onSuccess}
       senderAddress={senderAddress}
+      showFiatOption={showFiatOption}
       slots={slots}
       content={content}
       theme={theme}

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

@@ -28,6 +28,7 @@ export function AnySpendStakeUpsideExactIn({
   token,
   onSuccess,
   senderAddress,
+  showFiatOption,
   slots,
   content,
   theme,
@@ -43,6 +44,7 @@ export function AnySpendStakeUpsideExactIn({
   onSuccess?: (amount: string) => void;
   /** Optional sender (payer) address — pre-fills token balances when the user address is known ahead of time */
   senderAddress?: string;
+  showFiatOption?: boolean;
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
@@ -82,6 +84,7 @@ export function AnySpendStakeUpsideExactIn({
       header={header}
       onSuccess={onSuccess}
       senderAddress={senderAddress}
+      showFiatOption={showFiatOption}
       slots={slots}
       content={content}
       theme={theme}

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

@@ -30,6 +30,8 @@ export interface AnySpendWorkflowTriggerProps {
   actionLabel?: string;
   /** Custom class names */
   classes?: AnySpendAllClasses;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 export function AnySpendWorkflowTrigger({
@@ -45,6 +47,7 @@ export function AnySpendWorkflowTrigger({
   mode,
   actionLabel,
   classes,
+  showFiatOption,
 }: AnySpendWorkflowTriggerProps) {
   const metadata = useMemo(
     () => ({
@@ -68,6 +71,7 @@ export function AnySpendWorkflowTrigger({
       actionLabel={actionLabel}
       classes={classes}
       allowDirectTransfer
+      showFiatOption={showFiatOption}
     />
   );
 }

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

@@ -32,6 +32,7 @@ export interface AnySpendDepositHypeProps {
   customRecipientLabel?: string;
   /** Optional sender (payer) address — pre-fills token balances when the user address is known ahead of time */
   senderAddress?: string;
+  showFiatOption?: boolean;
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
@@ -51,6 +52,7 @@ export function AnySpendDepositHype({
   customUsdInputValues,
   preferEoa,
   senderAddress,
+  showFiatOption,
   slots,
   content,
   theme,
@@ -97,6 +99,7 @@ export function AnySpendDepositHype({
       customUsdInputValues={customUsdInputValues}
       preferEoa={preferEoa}
       senderAddress={senderAddress}
+      showFiatOption={showFiatOption}
       slots={slots}
       content={content}
       theme={theme}

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

@@ -48,6 +48,7 @@ export function AnyspendSignatureMint({
   signatureData,
   imageUrl,
   onSuccess,
+  showFiatOption,
   slots,
   content,
   theme,
@@ -57,6 +58,7 @@ export function AnyspendSignatureMint({
   signatureData: GenerateSigMintResponse;
   imageUrl?: string;
   onSuccess?: (txHash?: string) => void;
+  showFiatOption?: boolean;
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
@@ -156,6 +158,7 @@ export function AnyspendSignatureMint({
       header={header}
       onSuccess={onSuccess}
       showRecipient={true}
+      showFiatOption={showFiatOption}
       slots={slots}
       content={content}
       theme={theme}

package/src/anyspend/react/components/checkout/AnySpendCheckout.tsx

@@ -140,6 +140,8 @@ export interface AnySpendCheckoutProps {
   kycEnabled?: boolean;
   /** Extra metadata included under the 'callbackMetadata' key in the order's callbackMetadata (e.g. workflowId, orgId from checkout session) */
   callbackMetadata?: Record<string, unknown>;
+  /** Whether to show fiat payment options (card + coinbase). Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 const emptyAddress: AddressData = { street: "", city: "", state: "", zip: "", country: "" };
@@ -190,6 +192,7 @@ export function AnySpendCheckout({
   feeOnTop,
   kycEnabled = false,
   callbackMetadata: callbackMetadataProp,
+  showFiatOption,
 }: AnySpendCheckoutProps) {
   // ===== Variable pricing state =====
   const [variablePricingAmount, setVariablePricingAmount] = useState<string>("0");
@@ -452,6 +455,7 @@ export function AnySpendCheckout({
                 isFormValid={isFormValid}
                 feeOnTop={feeOnTop}
                 kycEnabled={kycEnabled}
+                showFiatOption={showFiatOption}
               />
             </>
           }

package/src/anyspend/react/components/checkout/AnySpendCheckoutTrigger.tsx

@@ -75,6 +75,8 @@ export interface AnySpendCheckoutTriggerProps {
   summaryLines?: CheckoutSummaryLine[];
   /** When true, identity verification (KYC) is required before card payment. Defaults to false. */
   kycEnabled?: boolean;
+  /** Whether to show fiat payment options (card + coinbase). Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 export function AnySpendCheckoutTrigger({
@@ -106,6 +108,7 @@ export function AnySpendCheckoutTrigger({
   discount,
   summaryLines,
   kycEnabled = false,
+  showFiatOption,
 }: AnySpendCheckoutTriggerProps) {
   // Merge workflowId + orgId into callbackMetadata
   const mergedMetadata = useMemo(() => {
@@ -216,6 +219,7 @@ export function AnySpendCheckoutTrigger({
               defaultPaymentMethod={defaultPaymentMethod}
               senderAddress={senderAddress}
               kycEnabled={kycEnabled}
+              showFiatOption={showFiatOption}
             />
           </div>
         </div>

package/src/anyspend/react/components/checkout/CheckoutPaymentPanel.tsx

@@ -41,6 +41,8 @@ interface CheckoutPaymentPanelProps {
   feeOnTop?: boolean;
   /** When true, identity verification (KYC) is required before card payment. Defaults to false. */
   kycEnabled?: boolean;
+  /** Whether to show fiat payment options (card + coinbase). Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 function RadioCircle({ selected, themeColor }: { selected: boolean; themeColor?: string }) {
@@ -138,8 +140,20 @@ export function CheckoutPaymentPanel({
   isFormValid = true,
   feeOnTop,
   kycEnabled = false,
+  showFiatOption = true,
 }: CheckoutPaymentPanelProps) {
-  const [paymentMethod, setPaymentMethod] = useState<PaymentMethod | null>(defaultPaymentMethod ?? null);
+  const [paymentMethod, setPaymentMethod] = useState<PaymentMethod | null>(() => {
+    if (!showFiatOption && (defaultPaymentMethod === "card" || defaultPaymentMethod === "coinbase")) {
+      return "crypto";
+    }
+    return defaultPaymentMethod ?? null;
+  });
+
+  useEffect(() => {
+    if (!showFiatOption && (paymentMethod === "card" || paymentMethod === "coinbase")) {
+      setPaymentMethod("crypto");
+    }
+  }, [showFiatOption, paymentMethod]);
 
   // Restore activeOrderId from sessionStorage (handles page refresh / Coinbase return)
   const [activeOrderId, setActiveOrderId] = useState<string | null>(() => {
@@ -259,88 +273,92 @@ export function CheckoutPaymentPanel({
           </AnimatePresence>
         </div>
 
-        {/* Credit or Debit Card */}
-        <div className="anyspend-method-card">
-          <button
-            onClick={() => setPaymentMethod(paymentMethod === "card" ? null : "card")}
-            className={accordionButtonClass(paymentMethod === "card")}
-          >
-            <RadioCircle selected={paymentMethod === "card"} themeColor={themeColor} />
-            <CreditCard className="h-5 w-5 text-gray-700 dark:text-gray-300" />
-            <span className="text-sm font-medium text-gray-900 dark:text-gray-100">Credit or debit card</span>
-            <div className="ml-auto flex items-center gap-1">
-              <VisaLogo />
-              <MastercardLogo />
-              <AmexLogo />
-            </div>
-          </button>
-          <AnimatePresence initial={false}>
-            {paymentMethod === "card" && (
-              <motion.div
-                key="card-panel"
-                initial={{ height: 0, opacity: 0 }}
-                animate={{ height: "auto", opacity: 1 }}
-                exit={{ height: 0, opacity: 0 }}
-                transition={{ duration: 0.2, ease: "easeOut" }}
-                style={{ overflow: "hidden" }}
+        {showFiatOption && (
+          <>
+            {/* Credit or Debit Card */}
+            <div className="anyspend-method-card">
+              <button
+                onClick={() => setPaymentMethod(paymentMethod === "card" ? null : "card")}
+                className={accordionButtonClass(paymentMethod === "card")}
               >
-                <div className={expandedPanelClass}>
-                  <FiatCheckoutPanel
-                    recipientAddress={recipientAddress}
-                    destinationTokenAddress={destinationTokenAddress}
-                    destinationTokenChainId={destinationTokenChainId}
-                    totalAmount={totalAmount}
-                    themeColor={themeColor}
-                    onOrderCreated={handleOrderCreated}
-                    onError={onError}
-                    callbackMetadata={callbackMetadata}
-                    classes={classes}
-                    feeOnTop={feeOnTop}
-                    kycEnabled={kycEnabled}
-                  />
+                <RadioCircle selected={paymentMethod === "card"} themeColor={themeColor} />
+                <CreditCard className="h-5 w-5 text-gray-700 dark:text-gray-300" />
+                <span className="text-sm font-medium text-gray-900 dark:text-gray-100">Credit or debit card</span>
+                <div className="ml-auto flex items-center gap-1">
+                  <VisaLogo />
+                  <MastercardLogo />
+                  <AmexLogo />
                 </div>
-              </motion.div>
-            )}
-          </AnimatePresence>
-        </div>
+              </button>
+              <AnimatePresence initial={false}>
+                {paymentMethod === "card" && (
+                  <motion.div
+                    key="card-panel"
+                    initial={{ height: 0, opacity: 0 }}
+                    animate={{ height: "auto", opacity: 1 }}
+                    exit={{ height: 0, opacity: 0 }}
+                    transition={{ duration: 0.2, ease: "easeOut" }}
+                    style={{ overflow: "hidden" }}
+                  >
+                    <div className={expandedPanelClass}>
+                      <FiatCheckoutPanel
+                        recipientAddress={recipientAddress}
+                        destinationTokenAddress={destinationTokenAddress}
+                        destinationTokenChainId={destinationTokenChainId}
+                        totalAmount={totalAmount}
+                        themeColor={themeColor}
+                        onOrderCreated={handleOrderCreated}
+                        onError={onError}
+                        callbackMetadata={callbackMetadata}
+                        classes={classes}
+                        feeOnTop={feeOnTop}
+                        kycEnabled={kycEnabled}
+                      />
+                    </div>
+                  </motion.div>
+                )}
+              </AnimatePresence>
+            </div>
 
-        {/* Coinbase Pay */}
-        <div className="anyspend-method-coinbase">
-          <button
-            onClick={() => setPaymentMethod(paymentMethod === "coinbase" ? null : "coinbase")}
-            className={accordionButtonClass(paymentMethod === "coinbase")}
-          >
-            <RadioCircle selected={paymentMethod === "coinbase"} themeColor={themeColor} />
-            <CoinbaseLogo />
-            <span className="text-sm font-medium text-gray-900 dark:text-gray-100">Coinbase Pay</span>
-          </button>
-          <AnimatePresence initial={false}>
-            {paymentMethod === "coinbase" && (
-              <motion.div
-                key="coinbase-panel"
-                initial={{ height: 0, opacity: 0 }}
-                animate={{ height: "auto", opacity: 1 }}
-                exit={{ height: 0, opacity: 0 }}
-                transition={{ duration: 0.2, ease: "easeOut" }}
-                style={{ overflow: "hidden" }}
+            {/* Coinbase Pay */}
+            <div className="anyspend-method-coinbase">
+              <button
+                onClick={() => setPaymentMethod(paymentMethod === "coinbase" ? null : "coinbase")}
+                className={accordionButtonClass(paymentMethod === "coinbase")}
               >
-                <div className={expandedPanelClass}>
-                  <CoinbaseCheckoutPanel
-                    recipientAddress={recipientAddress}
-                    destinationTokenAddress={destinationTokenAddress}
-                    destinationTokenChainId={destinationTokenChainId}
-                    totalAmount={totalAmount}
-                    themeColor={themeColor}
-                    onOrderCreated={handleOrderCreated}
-                    onError={onError}
-                    callbackMetadata={callbackMetadata}
-                    classes={classes}
-                  />
-                </div>
-              </motion.div>
-            )}
-          </AnimatePresence>
-        </div>
+                <RadioCircle selected={paymentMethod === "coinbase"} themeColor={themeColor} />
+                <CoinbaseLogo />
+                <span className="text-sm font-medium text-gray-900 dark:text-gray-100">Coinbase Pay</span>
+              </button>
+              <AnimatePresence initial={false}>
+                {paymentMethod === "coinbase" && (
+                  <motion.div
+                    key="coinbase-panel"
+                    initial={{ height: 0, opacity: 0 }}
+                    animate={{ height: "auto", opacity: 1 }}
+                    exit={{ height: 0, opacity: 0 }}
+                    transition={{ duration: 0.2, ease: "easeOut" }}
+                    style={{ overflow: "hidden" }}
+                  >
+                    <div className={expandedPanelClass}>
+                      <CoinbaseCheckoutPanel
+                        recipientAddress={recipientAddress}
+                        destinationTokenAddress={destinationTokenAddress}
+                        destinationTokenChainId={destinationTokenChainId}
+                        totalAmount={totalAmount}
+                        themeColor={themeColor}
+                        onOrderCreated={handleOrderCreated}
+                        onError={onError}
+                        callbackMetadata={callbackMetadata}
+                        classes={classes}
+                      />
+                    </div>
+                  </motion.div>
+                )}
+              </AnimatePresence>
+            </div>
+          </>
+        )}
       </div>
     </div>
   );

package/src/anyspend/react/hooks/useAnyspendQuote.ts

@@ -26,20 +26,20 @@ export function useAnyspendQuote(req: GetQuoteRequest): UseAnyspendQuoteResult {
     },
     enabled: Boolean(
       req.srcChain &&
-        req.dstChain &&
-        req.srcTokenAddress &&
-        req.dstTokenAddress &&
-        BigInt(
-          req.type === "swap" || req.type === "hype_duel" || req.type === "x402_swap" || req.type === "custom_exact_in"
-            ? req.amount
-            : req.type === "mint_nft"
+      req.dstChain &&
+      req.srcTokenAddress &&
+      req.dstTokenAddress &&
+      BigInt(
+        req.type === "swap" || req.type === "hype_duel" || req.type === "x402_swap" || req.type === "custom_exact_in"
+          ? req.amount
+          : req.type === "mint_nft"
+            ? req.price
+            : req.type === "join_tournament"
               ? req.price
-              : req.type === "join_tournament"
-                ? req.price
-                : req.type === "fund_tournament"
-                  ? req.fundAmount
-                  : req.payload.amount,
-        ) !== BigInt(0),
+              : req.type === "fund_tournament"
+                ? req.fundAmount
+                : req.payload.amount,
+      ) !== BigInt(0),
     ),
     refetchInterval: 10000,
     retry: false,

package/src/anyspend/react/hooks/useCreateDepositFirstOrder.ts

@@ -1,13 +1,13 @@
 import { anyspendService } from "@b3dotfun/sdk/anyspend/services/anyspend";
-import { components } from "@b3dotfun/sdk/anyspend/types/api";
-import { CreateOrderResponse } from "@b3dotfun/sdk/anyspend/types/api_req_res";
-import { VisitorData } from "@b3dotfun/sdk/anyspend/types/fingerprint";
+import type { components } from "@b3dotfun/sdk/anyspend/types/api";
+import type { CreateOrderResponse } from "@b3dotfun/sdk/anyspend/types/api_req_res";
+import type { VisitorData } from "@b3dotfun/sdk/anyspend/types/fingerprint";
 import { normalizeAddress } from "@b3dotfun/sdk/anyspend/utils";
 import { useB3Config } from "@b3dotfun/sdk/global-account/react";
 import { useVisitorData } from "@fingerprintjs/fingerprintjs-pro-react";
 import { useMutation } from "@tanstack/react-query";
 import { useMemo } from "react";
-import { DepositContractConfig } from "../components/AnySpendDeposit";
+import type { DepositContractConfig } from "../components/AnySpendDeposit";
 
 export type CreateDepositFirstOrderParams = {
   recipientAddress: string;

package/src/anyspend/types/api_req_res.ts

@@ -1,12 +1,17 @@
 import { paths } from "./api";
 
-export type GetOrderAndTxsResponse = paths["/orders/{orderId}"]["get"]["responses"]["200"]["content"]["application/json"];
+export type GetOrderAndTxsResponse =
+  paths["/orders/{orderId}"]["get"]["responses"]["200"]["content"]["application/json"];
 export type GetQuoteRequest = paths["/orders/quote"]["post"]["requestBody"]["content"]["application/json"];
 export type GetQuoteResponse = paths["/orders/quote"]["post"]["responses"]["200"]["content"]["application/json"];
 
-export type GetCoinbaseOnrampOptionsResponse = paths["/onramp/coinbase/options"]["get"]["responses"]["200"]["content"]["application/json"];
+export type GetCoinbaseOnrampOptionsResponse =
+  paths["/onramp/coinbase/options"]["get"]["responses"]["200"]["content"]["application/json"];
 export type GetOrderHistoryResponse = paths["/orders"]["get"]["responses"]["200"]["content"]["application/json"];
-export type GetTokenListResponse = paths["/chains/{chainId}/tokens"]["get"]["responses"]["200"]["content"]["application/json"];
+export type GetTokenListResponse =
+  paths["/chains/{chainId}/tokens"]["get"]["responses"]["200"]["content"]["application/json"];
 export type CreateOrderResponse = paths["/orders"]["post"]["responses"]["200"]["content"]["application/json"];
-export type GetStripeSupportedResponse = paths["/onramp/stripe/supported"]["get"]["responses"]["200"]["content"]["application/json"];
-export type GetStripeClientSecret = paths["/stripe/clientSecret"]["get"]["responses"]["200"]["content"]["application/json"];
+export type GetStripeSupportedResponse =
+  paths["/onramp/stripe/supported"]["get"]["responses"]["200"]["content"]["application/json"];
+export type GetStripeClientSecret =
+  paths["/stripe/clientSecret"]["get"]["responses"]["200"]["content"]["application/json"];

package/src/anyspend/utils/chain.ts

@@ -8,6 +8,7 @@ import {
   ETHEREUM_PUBLIC_RPC,
   HYPEREVM_PUBLIC_RPC,
   OPTIMISM_PUBLIC_RPC,
+  PLUME_PUBLIC_RPC,
   POLYGON_PUBLIC_RPC,
 } from "@b3dotfun/sdk/anyspend/constants/rpc";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
@@ -33,10 +34,12 @@ import {
   getEthToken,
   getHyperEVMNativeToken,
   getHyperliquidUSDCToken,
+  getPlumeNativeToken,
   getPolToken,
   getSolanaToken,
   HYPEREVM_CHAIN_ID,
   HYPERLIQUID_CHAIN_ID,
+  PLUME_CHAIN_ID,
 } from "./token";
 
 function getCustomEvmChain(chain: Chain, rpcUrl: string): Chain {
@@ -84,11 +87,19 @@ export function clearChainRpcOverrides(): void {
 export const hyperEVM = defineChain({
   id: HYPEREVM_CHAIN_ID,
   name: "HyperEVM",
-  nativeCurrency: { name: "HyperEVM", symbol: "HYPE", decimals: 18 },
+  nativeCurrency: { name: "Hyperliquid", symbol: "HYPE", decimals: 18 },
   rpcUrls: { default: { http: [HYPEREVM_PUBLIC_RPC] } },
   blockExplorers: { default: { name: "HyperEVM Explorer", url: "https://hyperevmscan.io/" } },
 });
 
+export const plume = defineChain({
+  id: PLUME_CHAIN_ID,
+  name: "Plume",
+  nativeCurrency: { name: "Plume", symbol: "PLUME", decimals: 18 },
+  rpcUrls: { default: { http: [PLUME_PUBLIC_RPC] } },
+  blockExplorers: { default: { name: "Plume Explorer", url: "https://explorer.plume.org" } },
+});
+
 // export const b4testnet = defineChain({
 //   id: 19934,
 //   name: "B4 Testnet",
@@ -247,6 +258,20 @@ export const EVM_MAINNET: Record<number, IEVMChain> = {
     coingeckoName: "hyperevm",
     wethAddress: "0x5555555555555555555555555555555555555555",
   },
+  [plume.id]: {
+    id: plume.id,
+    name: plume.name,
+    logoUrl: "https://cdn.b3.fun/b3os-icons/plume.svg",
+    type: ChainType.EVM,
+    nativeRequired: parseEther("5"), // 5 PLUME ≈ $0.06 — gas reserve; Plume gasPrice ~1000 gwei × 2.2M gas (approve+deposit) needs ~2.2 PLUME, +headroom for spikes
+    canDepositNative: true,
+    defaultToken: getPlumeNativeToken(),
+    nativeToken: getPlumeNativeToken(),
+    viem: plume,
+    pollingInterval: 1000, // 1 second for Plume (L2 fast blocks)
+    coingeckoName: "plume-network",
+    wethAddress: "0xea237441c92cae6fc17caaf9a7acb3f953be4bd1", // WPLUME (wrapped native)
+  },
 };
 
 export const EVM_TESTNET: Record<number, IEVMChain> = {

package/src/anyspend/utils/token.ts

@@ -4,6 +4,7 @@ import { avalanche, bsc, polygon } from "viem/chains";
 
 export const HYPERLIQUID_CHAIN_ID = 1337;
 export const HYPEREVM_CHAIN_ID = 999;
+export const PLUME_CHAIN_ID = 98866;
 
 /**
  * Hyperliquid uses a special 34-character USDC address format (0x + 32 hex digits)
@@ -106,3 +107,16 @@ export function getHyperliquidUSDCToken(): components["schemas"]["Token"] {
     },
   };
 }
+
+export function getPlumeNativeToken(): components["schemas"]["Token"] {
+  return {
+    chainId: PLUME_CHAIN_ID,
+    address: ZERO_ADDRESS,
+    symbol: "PLUME",
+    name: "Plume",
+    decimals: 18,
+    metadata: {
+      logoURI: "https://cdn.b3.fun/b3os-icons/plume.svg",
+    },
+  };
+}

package/src/app.shared.ts

@@ -4,15 +4,35 @@ import Cookies from "js-cookie";
 import { B3_AUTH_COOKIE_NAME } from "./shared/constants";
 import { getSessionDurationDays } from "./shared/utils/session-duration";
 
+/** Default API URL derived from environment variables. */
 export const B3_API_URL =
   process.env.EXPO_PUBLIC_B3_API || process.env.NEXT_PUBLIC_B3_API || process.env.PUBLIC_B3_API || "https://api.b3.fun";
 
+/**
+ * Runtime-overridable API URL. Set by `B3Provider` when an `apiUrl` prop
+ * is provided. Falls back to the env-var-derived `B3_API_URL`.
+ */
+let _apiUrlOverride: string | null = null;
+
+/**
+ * Override the B3 API URL at runtime. Called by `B3Provider` when an
+ * `apiUrl` prop is provided. Pass `null` to revert to the default.
+ */
+export function setB3ApiUrl(url: string | null): void {
+  _apiUrlOverride = url;
+}
+
+/** Get the current B3 API URL (prefers runtime override, then env var). */
+export function getB3ApiUrl(): string {
+  return _apiUrlOverride || B3_API_URL;
+}
+
 export const authenticate = async (
   app: ClientApplication,
   accessToken: string,
   identityToken: string,
   params?: Record<string, any>,
-) => {
+): Promise<Record<string, any> | null> => {
   const fullToken = `${accessToken}+${identityToken}`;
 
   // Do not authenticate if there is no token

package/src/global-account/app.native.ts

@@ -77,7 +77,11 @@ const app = createClient(socketio(socket), {
   storageKey: B3_AUTH_COOKIE_NAME,
 });
 
-export const authenticate = async (accessToken: string, identityToken: string, params?: Record<string, any>) => {
+export const authenticate = async (
+  accessToken: string,
+  identityToken: string,
+  params?: Record<string, any>,
+): Promise<Record<string, any> | null> => {
   const fullToken = `${accessToken}+${identityToken}`;
 
   // Do not authenticate if there is no token