@b3dotfun/sdk 0.0.83-alpha.1 → 0.0.83-alpha.2

package/src/anyspend/react/components/common/InsufficientDepositPayment.tsx

@@ -4,8 +4,8 @@ import {
   ALL_CHAINS,
   getChainName,
   getPaymentUrl,
-  RELAY_ETH_ADDRESS,
   RELAY_SOLANA_MAINNET_CHAIN_ID,
+  ZERO_ADDRESS,
 } from "@b3dotfun/sdk/anyspend";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { Badge, CopyToClipboard, ShinyButton, TextLoop } from "@b3dotfun/sdk/global-account/react";
@@ -121,7 +121,7 @@ export function InsufficientDepositPayment({
               value={getPaymentUrl(
                 order.globalAddress,
                 BigInt(depositDeficit),
-                order.srcTokenAddress === RELAY_ETH_ADDRESS ? srcToken?.symbol || "ETH" : order.srcTokenAddress,
+                order.srcTokenAddress === ZERO_ADDRESS ? srcToken?.symbol || "ETH" : order.srcTokenAddress,
                 order.srcChain,
                 srcToken?.decimals,
               )}

package/src/anyspend/react/components/common/OrderDetails.tsx

@@ -8,8 +8,8 @@ import {
   getPaymentUrl,
   getStatusDisplay,
   isNativeToken,
-  RELAY_ETH_ADDRESS,
   RELAY_SOLANA_MAINNET_CHAIN_ID,
+  ZERO_ADDRESS,
 } from "@b3dotfun/sdk/anyspend";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import {
@@ -327,16 +327,17 @@ export const OrderDetails = memo(function OrderDetails({
   // Main payment handler that triggers chain switch and payment
   const handlePayment = useCallback(async () => {
     console.log("Initiating payment process. Target chain:", order.srcChain, "Current chain:", walletClient?.chain?.id);
+    const amountToSend = depositDeficit > BigInt(0) ? depositDeficit.toString() : order.srcAmount;
     if (order.srcChain === RELAY_SOLANA_MAINNET_CHAIN_ID) {
-      // Use the existing depositDeficit calculation to determine amount to send
-      const amountToSend = depositDeficit > BigInt(0) ? depositDeficit.toString() : order.srcAmount;
+      // Solana payment flow
       await initiatePhantomTransfer({
         amountLamports: amountToSend,
         tokenAddress: order.srcTokenAddress,
         recipientAddress: order.globalAddress,
       });
     } else {
-      // Use unified payment process for both EOA and AA wallets
+      // EVM payment flow (EOA and AA wallets)
+      // Note: Hyperliquid is NOT supported as source chain, only as destination chain
       await handleUnifiedPaymentProcess();
     }
   }, [order, walletClient?.chain?.id, depositDeficit, handleUnifiedPaymentProcess, initiatePhantomTransfer]);
@@ -1039,7 +1040,7 @@ export const OrderDetails = memo(function OrderDetails({
                       value={getPaymentUrl(
                         order.globalAddress,
                         BigInt(order.srcAmount),
-                        order.srcTokenAddress === RELAY_ETH_ADDRESS ? srcToken?.symbol || "ETH" : order.srcTokenAddress,
+                        order.srcTokenAddress === ZERO_ADDRESS ? srcToken?.symbol || "ETH" : order.srcTokenAddress,
                         order.srcChain,
                         srcToken?.decimals,
                       )}

package/src/anyspend/react/components/common/OrderToken.tsx

@@ -1,6 +1,7 @@
 "use client";
 
-import { ALL_CHAINS, RELAY_ETH_ADDRESS, RELAY_SOLANA_MAINNET_CHAIN_ID } from "@b3dotfun/sdk/anyspend";
+import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID, ZERO_ADDRESS, getAvailableChainIds } from "@b3dotfun/sdk/anyspend";
+import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { Button, useAccountWallet, useTokenBalancesByChain } from "@b3dotfun/sdk/global-account/react";
 import { cn } from "@b3dotfun/sdk/shared/utils";
 import { formatTokenAmount } from "@b3dotfun/sdk/shared/utils/number";
@@ -9,7 +10,6 @@ import { TokenSelector } from "@relayprotocol/relay-kit-ui";
 import { CheckCircle2, ChevronsUpDown } from "lucide-react";
 import { useMemo } from "react";
 import { ChainTokenIcon } from "./ChainTokenIcon";
-import { components } from "@b3dotfun/sdk/anyspend/types/api";
 
 export function OrderToken({
   context,
@@ -44,7 +44,7 @@ export function OrderToken({
     // Get balance for the selected token
     let balance: bigint | null = null;
     if (token && wallet?.address) {
-      if (token.address === RELAY_ETH_ADDRESS) {
+      if (token.address === ZERO_ADDRESS) {
         // Native token
         const nativeToken = nativeTokens?.find(t => t.chainId === chainId);
         balance = nativeToken?.value ?? null;
@@ -69,12 +69,12 @@ export function OrderToken({
   return (
     <TokenSelector
       address={address}
-      chainIdsFilter={Object.values(ALL_CHAINS).map(chain => chain.id)}
+      chainIdsFilter={getAvailableChainIds(context)}
       context={context}
       fromChainWalletVMSupported={true}
       isValidAddress={true}
       key={undefined}
-      lockedChainIds={Object.values(ALL_CHAINS).map(chain => chain.id)}
+      lockedChainIds={getAvailableChainIds(context)}
       multiWalletSupportEnabled={true}
       onAnalyticEvent={undefined}
       popularChainIds={[1, 8453, RELAY_SOLANA_MAINNET_CHAIN_ID]}

package/src/anyspend/react/components/common/OrderTokenAmount.tsx

@@ -5,7 +5,7 @@ import { useEffect, useRef } from "react";
 import { NumericFormat } from "react-number-format";
 import { formatUnits } from "viem";
 
-import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID } from "@b3dotfun/sdk/anyspend";
+import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID, getAvailableChainIds } from "@b3dotfun/sdk/anyspend";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { getNativeRequired } from "@b3dotfun/sdk/anyspend/utils/chain";
 import { isNativeToken } from "@b3dotfun/sdk/anyspend/utils/token";
@@ -163,12 +163,12 @@ export function OrderTokenAmount({
         {!hideTokenSelect && (
           <TokenSelector
             address={address}
-            chainIdsFilter={Object.values(ALL_CHAINS).map(chain => chain.id)}
+            chainIdsFilter={getAvailableChainIds(context)}
             context={context}
             fromChainWalletVMSupported={true}
             isValidAddress={true}
             key={`selector-${context}-${token.address}-${chainId}`}
-            lockedChainIds={Object.values(ALL_CHAINS).map(chain => chain.id)}
+            lockedChainIds={getAvailableChainIds(context)}
             multiWalletSupportEnabled={true}
             onAnalyticEvent={undefined}
             popularChainIds={[1, 8453, RELAY_SOLANA_MAINNET_CHAIN_ID]}

package/src/anyspend/react/components/common/OrderTokenAmountFiat.tsx

@@ -4,7 +4,7 @@ import { ChevronsUpDown } from "lucide-react";
 import { useEffect, useRef } from "react";
 import { NumericFormat } from "react-number-format";
 
-import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID } from "@b3dotfun/sdk/anyspend";
+import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID, getAvailableChainIds } from "@b3dotfun/sdk/anyspend";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { cn } from "@b3dotfun/sdk/shared/utils";
 import { TokenSelector } from "@relayprotocol/relay-kit-ui";
@@ -79,12 +79,12 @@ export function OrderTokenAmountFiat({
   return (
     <TokenSelector
       address={address}
-      chainIdsFilter={Object.values(ALL_CHAINS).map(chain => chain.id)}
+      chainIdsFilter={getAvailableChainIds(context)}
       context={context}
       fromChainWalletVMSupported={true}
       isValidAddress={true}
       key={`selector-${context}-${token.address}-${chainId}`}
-      lockedChainIds={Object.values(ALL_CHAINS).map(chain => chain.id)}
+      lockedChainIds={getAvailableChainIds(context)}
       multiWalletSupportEnabled={true}
       onAnalyticEvent={undefined}
       popularChainIds={[1, 8453, RELAY_SOLANA_MAINNET_CHAIN_ID]}

package/src/anyspend/react/components/common/OrderTokenAmountNew.tsx

@@ -4,12 +4,12 @@ import { ChevronsUpDown } from "lucide-react";
 import { useEffect, useRef } from "react";
 import { NumericFormat } from "react-number-format";
 
-import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID } from "@b3dotfun/sdk/anyspend";
+import { ALL_CHAINS, RELAY_SOLANA_MAINNET_CHAIN_ID, getAvailableChainIds } from "@b3dotfun/sdk/anyspend";
+import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { Button } from "@b3dotfun/sdk/global-account/react";
 import { cn } from "@b3dotfun/sdk/shared/utils";
 import { TokenSelector } from "@relayprotocol/relay-kit-ui";
 import { ChainTokenIcon } from "./ChainTokenIcon";
-import { components } from "@b3dotfun/sdk/anyspend/types/api";
 
 export function OrderTokenAmountFiat({
   disabled,
@@ -118,12 +118,12 @@ export function OrderTokenAmountFiat({
           {!hideTokenSelect && (
             <TokenSelector
               address={address}
-              chainIdsFilter={Object.values(ALL_CHAINS).map(chain => chain.id)}
+              chainIdsFilter={getAvailableChainIds(context)}
               context={context}
               fromChainWalletVMSupported={true}
               isValidAddress={true}
               key={`selector-${context}-${token.address}-${chainId}`}
-              lockedChainIds={Object.values(ALL_CHAINS).map(chain => chain.id)}
+              lockedChainIds={getAvailableChainIds(context)}
               multiWalletSupportEnabled={true}
               onAnalyticEvent={undefined}
               popularChainIds={[1, 8453, RELAY_SOLANA_MAINNET_CHAIN_ID]}
@@ -173,12 +173,12 @@ export function OrderTokenAmountFiat({
         {!hideTokenSelect && (
           <TokenSelector
             address={address}
-            chainIdsFilter={Object.values(ALL_CHAINS).map(chain => chain.id)}
+            chainIdsFilter={getAvailableChainIds(context)}
             context={context}
             fromChainWalletVMSupported={true}
             isValidAddress={true}
             key={`selector-${context}-${token.address}-${chainId}`}
-            lockedChainIds={Object.values(ALL_CHAINS).map(chain => chain.id)}
+            lockedChainIds={getAvailableChainIds(context)}
             multiWalletSupportEnabled={true}
             onAnalyticEvent={undefined}
             popularChainIds={[1, 8453, RELAY_SOLANA_MAINNET_CHAIN_ID]}

package/src/anyspend/react/components/common/TransferCryptoDetails.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { ALL_CHAINS, getChainName, getPaymentUrl, RELAY_ETH_ADDRESS } from "@b3dotfun/sdk/anyspend";
+import { ALL_CHAINS, getChainName, getPaymentUrl, ZERO_ADDRESS } from "@b3dotfun/sdk/anyspend";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { CopyToClipboard, ShinyButton, TextLoop, toast } from "@b3dotfun/sdk/global-account/react";
 import { cn } from "@b3dotfun/sdk/shared/utils";
@@ -206,7 +206,7 @@ export const TransferCryptoDetails = memo(function TransferCryptoDetails({
                   value={getPaymentUrl(
                     order.globalAddress,
                     BigInt(order.srcAmount),
-                    order.srcTokenAddress === RELAY_ETH_ADDRESS ? "ETH" : order.srcTokenAddress,
+                    order.srcTokenAddress === ZERO_ADDRESS ? "ETH" : order.srcTokenAddress,
                     order.srcChain,
                     srcToken?.decimals,
                   )}

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

@@ -8,6 +8,7 @@ export * from "./useCoinbaseOnrampOptions";
 export * from "./useConnectedUserProfile";
 export * from "./useGeoOnrampOptions";
 export * from "./useGetGeo";
+export * from "./useHyperliquidTransfer";
 export * from "./useRecipientAddressState";
 export * from "./useSigMint";
 export * from "./useStripeClientSecret";

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

@@ -0,0 +1,152 @@
+import { HYPERLIQUID_CHAIN_ID, HYPERLIQUID_MAINNET } from "@b3dotfun/sdk/anyspend";
+import { toast } from "@b3dotfun/sdk/global-account/react";
+import { formatUnits } from "@b3dotfun/sdk/shared/utils/number";
+import axios from "axios";
+import { useCallback } from "react";
+import { parseSignature } from "viem";
+import { useWalletClient } from "wagmi";
+
+interface HyperliquidTransferParams {
+  /** Amount in smallest unit (USDC has 6 decimals) */
+  amount: string;
+  /** Recipient address */
+  destination: string;
+}
+
+/**
+ * @deprecated This hook is NOT USED in production.
+ *
+ * Hyperliquid is only supported as DESTINATION CHAIN (not source chain).
+ * Users cannot send FROM Hyperliquid in our flow, so EIP-712 signing is not needed.
+ *
+ * This hook was created during initial planning but is kept for:
+ * - Reference if we need to support source chain in the future
+ * - Understanding how Hyperliquid EIP-712 transfers work
+ *
+ * DO NOT USE THIS HOOK IN PRODUCTION CODE.
+ *
+ * Custom hook for handling Hyperliquid transfers via EIP-712 signature.
+ * Based on Relay SDK's Hyperliquid implementation.
+ *
+ * @example
+ * ```tsx
+ * const { initiateTransfer } = useHyperliquidTransfer();
+ *
+ * await initiateTransfer({
+ *   amount: "1000000", // 1 USDC
+ *   destination: "0x..."
+ * });
+ * ```
+ */
+export function useHyperliquidTransfer() {
+  const { data: walletClient } = useWalletClient();
+
+  /**
+   * Get the connected wallet address if available.
+   */
+  const getConnectedAddress = useCallback(() => {
+    return walletClient?.account?.address || null;
+  }, [walletClient]);
+
+  /**
+   * Initiate Hyperliquid transfer by signing EIP-712 message and sending to Hyperliquid API.
+   */
+  const initiateTransfer = useCallback(
+    async ({ amount, destination }: HyperliquidTransferParams): Promise<void> => {
+      if (!walletClient?.account) {
+        toast.error("Please connect your wallet");
+        throw new Error("Wallet not connected");
+      }
+
+      try {
+        const currentTime = new Date().getTime();
+
+        // Convert amount from smallest unit (6 decimals) to display format.
+        // e.g., "11151533" -> "11.151533"
+        const displayAmount = formatUnits(amount, 6);
+
+        // Prepare EIP-712 typed data for Hyperliquid USD send.
+        const typedData = {
+          domain: {
+            name: "HyperliquidSignTransaction",
+            version: "1",
+            chainId: HYPERLIQUID_CHAIN_ID,
+            verifyingContract: "0x0000000000000000000000000000000000000000" as `0x${string}`,
+          },
+          types: {
+            "HyperliquidTransaction:UsdSend": [
+              { name: "hyperliquidChain", type: "string" },
+              { name: "destination", type: "string" },
+              { name: "amount", type: "string" },
+              { name: "time", type: "uint64" },
+            ],
+          },
+          primaryType: "HyperliquidTransaction:UsdSend" as const,
+          message: {
+            hyperliquidChain: "Mainnet",
+            destination: destination.toLowerCase(),
+            amount: displayAmount,
+            time: BigInt(currentTime),
+          },
+        };
+
+        toast.info("Please sign the message in your wallet");
+
+        // Sign EIP-712 message.
+        const signature = await walletClient.signTypedData(typedData);
+
+        // Parse signature to get r, s, v components.
+        const { r, s, v } = parseSignature(signature);
+
+        toast.info("Sending transaction to Hyperliquid...");
+
+        // Send signature to Hyperliquid API.
+        const response = await axios.post(HYPERLIQUID_MAINNET.apiUrl + "/exchange", {
+          signature: {
+            r,
+            s,
+            v: Number(v ?? 0n),
+          },
+          nonce: currentTime,
+          action: {
+            type: "usdSend",
+            signatureChainId: `0x${HYPERLIQUID_CHAIN_ID.toString(16)}`,
+            hyperliquidChain: "Mainnet",
+            destination: destination.toLowerCase(),
+            amount: displayAmount,
+            time: currentTime,
+          },
+        });
+
+        // Check response status.
+        if (!response || response.status !== 200 || response.data?.status !== "ok") {
+          const errorMsg = response?.data?.error || "Failed to send transaction to Hyperliquid";
+          toast.error(errorMsg);
+          throw new Error(errorMsg);
+        }
+
+        toast.success("Transaction sent to Hyperliquid successfully!");
+      } catch (error: any) {
+        console.error("Hyperliquid transfer error:", error);
+
+        // Handle user rejection.
+        if (error?.message?.includes("User rejected") || error?.code === 4001) {
+          toast.error("Transaction signature rejected");
+          throw new Error("User rejected signature");
+        }
+
+        // Handle other errors.
+        const errorMsg = error?.message || "Failed to complete Hyperliquid transfer";
+        toast.error(errorMsg);
+        throw error;
+      }
+    },
+    [walletClient],
+  );
+
+  return {
+    initiateTransfer,
+    getConnectedAddress,
+    isWalletConnected: !!walletClient?.account,
+  };
+}

package/src/anyspend/types/chain.ts

@@ -1,9 +1,10 @@
-import { Chain } from "viem";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
+import { Chain } from "viem";
 
 export enum ChainType {
   EVM = "evm",
   SOLANA = "solana",
+  HYPERLIQUID = "hyperliquid",
 }
 
 export interface IBaseChain {
@@ -29,3 +30,11 @@ export interface IEVMChain extends IBaseChain {
 export interface ISolanaChain extends IBaseChain {
   type: ChainType.SOLANA;
 }
+
+export interface IHyperliquidChain extends IBaseChain {
+  type: ChainType.HYPERLIQUID;
+  apiUrl: string;
+  blockExplorer: {
+    url: string;
+  };
+}

package/src/anyspend/utils/address.ts

@@ -1,4 +1,5 @@
 import { isAddress } from "viem";
+import { HYPERLIQUID_CHAIN_ID } from "./token";
 
 export function isSolanaAddress(address: string): boolean {
   // Solana addresses are 32-byte base58 strings (usually 32-44 characters)
@@ -10,6 +11,20 @@ export function isEvmOrSolanaAddress(address: string): boolean {
   return isAddress(address) || isSolanaAddress(address);
 }
 
+/**
+ * Check if an address is Hyperliquid's special USDC address.
+ * Hyperliquid USDC uses a special 34-character format (0x + 32 hex digits)
+ * instead of the standard 42-character Ethereum address format.
+ * This is required by Relay SDK for Hyperliquid integration.
+ *
+ * @param chainId - The chain ID to check
+ * @param address - The token address to validate
+ * @returns true if the address is Hyperliquid USDC's special format
+ */
+export function isHyperliquidUSDC(chainId: number, address: string): boolean {
+  return chainId === HYPERLIQUID_CHAIN_ID && address.toLowerCase() === "0x00000000000000000000000000000000";
+}
+
 export function normalizeAddress(address: string): string {
   if (isSolanaAddress(address)) {
     return address;

package/src/anyspend/utils/chain.ts

@@ -14,15 +14,17 @@ import {
   WalletClient,
 } from "viem";
 import { abstract, arbitrum, avalanche, b3, base, bsc, mainnet, optimism, polygon } from "viem/chains";
-import { ChainType, IBaseChain, IEVMChain, ISolanaChain } from "../types/chain";
+import { ChainType, IBaseChain, IEVMChain, IHyperliquidChain, ISolanaChain } from "../types/chain";
 import {
   getAvaxToken,
   getBnbToken,
   getEthToken,
   getHyperEVMNativeToken,
+  getHyperliquidUSDCToken,
   getPolToken,
   getSolanaToken,
   HYPEREVM_CHAIN_ID,
+  HYPERLIQUID_CHAIN_ID,
 } from "./token";
 
 function getCustomEvmChain(chain: Chain, rpcUrl: string): Chain {
@@ -283,11 +285,31 @@ export const SOLANA_MAINNET: ISolanaChain = {
   coingeckoName: "solana",
 };
 
+export const HYPERLIQUID_MAINNET: IHyperliquidChain = {
+  id: HYPERLIQUID_CHAIN_ID,
+  name: "Hyperliquid",
+  type: ChainType.HYPERLIQUID,
+  logoUrl: "https://s2.coinmarketcap.com/static/img/coins/64x64/32196.png",
+  nativeRequired: BigInt(0), // No native transfer needed - using Relay's useDepositAddress flow (USDC is native)
+  canDepositNative: true, // Can deposit USDC (native token)
+  defaultToken: getHyperliquidUSDCToken(),
+  nativeToken: getHyperliquidUSDCToken(),
+  coingeckoName: null,
+  apiUrl: "https://api.hyperliquid.xyz",
+  blockExplorer: {
+    url: "https://app.hyperliquid.xyz/explorer",
+  },
+};
+
 export const EVM_CHAINS: Record<number, IEVMChain> = { ...EVM_MAINNET, ...EVM_TESTNET };
 
 export const SOLANA_CHAINS: Record<number, ISolanaChain> = { [RELAY_SOLANA_MAINNET_CHAIN_ID]: SOLANA_MAINNET };
 
-export const ALL_CHAINS: Record<number, IBaseChain> = { ...EVM_CHAINS, ...SOLANA_CHAINS };
+export const HYPERLIQUID_CHAINS: Record<number, IHyperliquidChain> = {
+  [HYPERLIQUID_CHAIN_ID]: HYPERLIQUID_MAINNET,
+};
+
+export const ALL_CHAINS: Record<number, IBaseChain> = { ...EVM_CHAINS, ...SOLANA_CHAINS, ...HYPERLIQUID_CHAINS };
 
 export function getSolanaChains(network: "mainnet" | "testnet"): ISolanaChain {
   invariant(network === "mainnet", "Solana chain is only supported on mainnet");
@@ -335,7 +357,9 @@ export function canDepositNative(chainId: number): boolean {
 }
 
 export function isMainnet(chainId: number): boolean {
-  return EVM_MAINNET[chainId] !== undefined || RELAY_SOLANA_MAINNET_CHAIN_ID === chainId;
+  return (
+    EVM_MAINNET[chainId] !== undefined || RELAY_SOLANA_MAINNET_CHAIN_ID === chainId || HYPERLIQUID_CHAIN_ID === chainId
+  );
 }
 
 export function isTestnet(chainId: number): boolean {
@@ -349,7 +373,13 @@ export function getDefaultToken(chainId: number): components["schemas"]["Token"]
 
 export function getChainName(chainId: number): string {
   invariant(ALL_CHAINS[chainId], `Chain ${chainId} is not supported`);
-  return EVM_CHAINS[chainId] ? EVM_CHAINS[chainId].viem.name : "Solana";
+  const chain = ALL_CHAINS[chainId];
+
+  if (isEvmChain(chainId)) {
+    return (chain as IEVMChain).viem.name;
+  }
+
+  return chain.name;
 }
 
 export function getCoingeckoName(chainId: number): string | null {
@@ -511,6 +541,13 @@ export function getPaymentUrl(address: string, amount: bigint, currency: string,
       return url;
     }
 
+    case ChainType.HYPERLIQUID: {
+      // NOTE: Hyperliquid is only supported as destination chain (not source chain).
+      // Payment URLs are not needed since users cannot send FROM Hyperliquid in our flow.
+      // Return address as placeholder (this code path should not be reached).
+      return address;
+    }
+
     default:
       // Fallback to just the address if chain type is unknown
       return address;
@@ -524,6 +561,10 @@ export function getExplorerTxUrl(chainId: number, txHash: string) {
   if (EVM_CHAINS[chainId]) {
     return EVM_CHAINS[chainId].viem.blockExplorers?.default.url + "/tx/" + txHash;
   }
+  if (HYPERLIQUID_CHAINS[chainId]) {
+    return HYPERLIQUID_CHAINS[chainId].blockExplorer.url + "/tx/" + txHash;
+  }
+  // Default to Solscan for Solana transactions
   return "https://solscan.io/tx/" + txHash;
 }
 
@@ -531,6 +572,10 @@ export function getExplorerAddressUrl(chainId: number, address: string) {
   if (EVM_CHAINS[chainId]) {
     return EVM_CHAINS[chainId].viem.blockExplorers?.default.url + "/address/" + address;
   }
+  if (HYPERLIQUID_CHAINS[chainId]) {
+    return HYPERLIQUID_CHAINS[chainId].blockExplorer.url + "/address/" + address;
+  }
+  // Default to Solscan for Solana addresses
   return "https://solscan.io/account/" + address;
 }
 
@@ -550,3 +595,38 @@ export function getNativeToken(chainId: number): components["schemas"]["Token"]
 export function isEvmChain(chainId: number): boolean {
   return Boolean(EVM_CHAINS[chainId]);
 }
+
+export function isHyperliquidChain(chainId: number): boolean {
+  return HYPERLIQUID_CHAINS[chainId] !== undefined;
+}
+
+export function getHyperliquidChain(chainId: number): IHyperliquidChain {
+  invariant(HYPERLIQUID_CHAINS[chainId], `Chain ${chainId} is not a Hyperliquid chain`);
+  return HYPERLIQUID_CHAINS[chainId];
+}
+
+/**
+ * Get available chain IDs for AnySpend based on context (source or destination).
+ * Filters out chains that shouldn't be available for the given context.
+ *
+ * @param context - "from" for source chains, "to" for destination chains
+ * @returns Array of available chain IDs
+ *
+ * @example
+ * // Get source chains (excludes Hyperliquid)
+ * const sourceChains = getAvailableChainIds("from") // [1, 8453, 137, ...]
+ *
+ * // Get destination chains (includes Hyperliquid)
+ * const destChains = getAvailableChainIds("to") // [1, 8453, 137, ..., 1337]
+ */
+export function getAvailableChainIds(context: "from" | "to"): number[] {
+  const allChainIds = Object.values(ALL_CHAINS).map(chain => chain.id);
+
+  if (context === "from") {
+    // Hyperliquid is only supported as destination chain, not source chain
+    return allChainIds.filter(chainId => chainId !== HYPERLIQUID_CHAIN_ID);
+  }
+
+  // For destination ("to"), all chains are available including Hyperliquid
+  return allChainIds;
+}

package/src/anyspend/utils/token.ts

@@ -1,4 +1,4 @@
-import { RELAY_ETH_ADDRESS, RELAY_SOL_ADDRESS, RELAY_SOLANA_MAINNET_CHAIN_ID } from "@b3dotfun/sdk/anyspend/constants";
+import { RELAY_SOL_ADDRESS, RELAY_SOLANA_MAINNET_CHAIN_ID, ZERO_ADDRESS } from "@b3dotfun/sdk/anyspend/constants";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { avalanche, bsc, polygon } from "viem/chains";
 
@@ -6,7 +6,7 @@ export const HYPERLIQUID_CHAIN_ID = 1337;
 export const HYPEREVM_CHAIN_ID = 999;
 
 export function isNativeToken(address: string): boolean {
-  return address.toLowerCase() === RELAY_ETH_ADDRESS || address.toLowerCase() === RELAY_SOL_ADDRESS;
+  return address.toLowerCase() === ZERO_ADDRESS || address.toLowerCase() === RELAY_SOL_ADDRESS;
 }
 
 export function getSolanaToken(): components["schemas"]["Token"] {
@@ -25,7 +25,7 @@ export function getSolanaToken(): components["schemas"]["Token"] {
 export function getEthToken(chainId: number): components["schemas"]["Token"] {
   return {
     chainId: chainId,
-    address: RELAY_ETH_ADDRESS,
+    address: ZERO_ADDRESS,
     symbol: "ETH",
     name: "Ethereum",
     decimals: 18,
@@ -38,7 +38,7 @@ export function getEthToken(chainId: number): components["schemas"]["Token"] {
 export function getPolToken(): components["schemas"]["Token"] {
   return {
     chainId: polygon.id,
-    address: RELAY_ETH_ADDRESS,
+    address: ZERO_ADDRESS,
     symbol: "POL",
     name: "Polygon",
     decimals: 18,
@@ -51,7 +51,7 @@ export function getPolToken(): components["schemas"]["Token"] {
 export function getBnbToken(): components["schemas"]["Token"] {
   return {
     chainId: bsc.id,
-    address: RELAY_ETH_ADDRESS,
+    address: ZERO_ADDRESS,
     symbol: "BNB",
     name: "BNB",
     decimals: 18,
@@ -64,7 +64,7 @@ export function getBnbToken(): components["schemas"]["Token"] {
 export function getAvaxToken(): components["schemas"]["Token"] {
   return {
     chainId: avalanche.id,
-    address: RELAY_ETH_ADDRESS,
+    address: ZERO_ADDRESS,
     symbol: "AVAX",
     name: "AVAX",
     decimals: 18,
@@ -77,7 +77,7 @@ export function getAvaxToken(): components["schemas"]["Token"] {
 export function getHyperEVMNativeToken(): components["schemas"]["Token"] {
   return {
     chainId: HYPEREVM_CHAIN_ID,
-    address: RELAY_ETH_ADDRESS,
+    address: ZERO_ADDRESS,
     symbol: "HYPE",
     name: "HYPE",
     decimals: 18,
@@ -86,3 +86,16 @@ export function getHyperEVMNativeToken(): components["schemas"]["Token"] {
     },
   };
 }
+
+export function getHyperliquidUSDCToken(): components["schemas"]["Token"] {
+  return {
+    chainId: HYPERLIQUID_CHAIN_ID,
+    address: ZERO_ADDRESS,
+    symbol: "USDC",
+    name: "USD Coin",
+    decimals: 6,
+    metadata: {
+      logoURI: "https://ethereum-optimism.github.io/data/USDC/logo.png",
+    },
+  };
+}