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

package/dist/esm/anyspend/react/hooks/useHyperliquidTransfer.js

@@ -0,0 +1,127 @@
+import { HYPERLIQUID_CHAIN_ID, HYPERLIQUID_MAINNET } from "../../../anyspend/index.js";
+import { toast } from "../../../global-account/react/index.js";
+import { formatUnits } from "../../../shared/utils/number.js";
+import axios from "axios";
+import { useCallback } from "react";
+import { parseSignature } from "viem";
+import { useWalletClient } from "wagmi";
+/**
+ * @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 }) => {
+        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",
+                },
+                types: {
+                    "HyperliquidTransaction:UsdSend": [
+                        { name: "hyperliquidChain", type: "string" },
+                        { name: "destination", type: "string" },
+                        { name: "amount", type: "string" },
+                        { name: "time", type: "uint64" },
+                    ],
+                },
+                primaryType: "HyperliquidTransaction:UsdSend",
+                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 ?? BigInt(0)),
+                },
+                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) {
+            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/dist/esm/anyspend/types/chain.d.ts

@@ -1,8 +1,9 @@
-import { Chain } from "viem";
 import { components } from "../../anyspend/types/api";
+import { Chain } from "viem";
 export declare enum ChainType {
     EVM = "evm",
-    SOLANA = "solana"
+    SOLANA = "solana",
+    HYPERLIQUID = "hyperliquid"
 }
 export interface IBaseChain {
     id: number;
@@ -25,3 +26,10 @@ 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/dist/esm/anyspend/types/chain.js

@@ -2,4 +2,5 @@ export var ChainType;
 (function (ChainType) {
     ChainType["EVM"] = "evm";
     ChainType["SOLANA"] = "solana";
+    ChainType["HYPERLIQUID"] = "hyperliquid";
 })(ChainType || (ChainType = {}));

package/dist/esm/anyspend/utils/address.d.ts

@@ -1,4 +1,15 @@
 export declare function isSolanaAddress(address: string): boolean;
 export declare function isEvmOrSolanaAddress(address: string): boolean;
+/**
+ * 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 declare function isHyperliquidUSDC(chainId: number, address: string): boolean;
 export declare function normalizeAddress(address: string): string;
 export declare function eqci(a: string | null | undefined, b: string | null | undefined): boolean;

package/dist/esm/anyspend/utils/address.js

@@ -1,4 +1,5 @@
 import { isAddress } from "viem";
+import { HYPERLIQUID_CHAIN_ID } from "./token.js";
 export function isSolanaAddress(address) {
     // Solana addresses are 32-byte base58 strings (usually 32-44 characters)
     const solanaAddressRegex = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
@@ -7,6 +8,19 @@ export function isSolanaAddress(address) {
 export function isEvmOrSolanaAddress(address) {
     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, address) {
+    return chainId === HYPERLIQUID_CHAIN_ID && address.toLowerCase() === "0x00000000000000000000000000000000";
+}
 export function normalizeAddress(address) {
     if (isSolanaAddress(address)) {
         return address;

package/dist/esm/anyspend/utils/chain.d.ts

@@ -1,6 +1,6 @@
 import { components } from "../../anyspend/types/api";
 import { Account, Chain, PublicClient, Transport, WalletClient } from "viem";
-import { ChainType, IBaseChain, IEVMChain, ISolanaChain } from "../types/chain";
+import { ChainType, IBaseChain, IEVMChain, IHyperliquidChain, ISolanaChain } from "../types/chain";
 export declare const hyperEVM: {
     blockExplorers: {
         readonly default: {
@@ -42,8 +42,10 @@ export declare const hyperEVM: {
 export declare const EVM_MAINNET: Record<number, IEVMChain>;
 export declare const EVM_TESTNET: Record<number, IEVMChain>;
 export declare const SOLANA_MAINNET: ISolanaChain;
+export declare const HYPERLIQUID_MAINNET: IHyperliquidChain;
 export declare const EVM_CHAINS: Record<number, IEVMChain>;
 export declare const SOLANA_CHAINS: Record<number, ISolanaChain>;
+export declare const HYPERLIQUID_CHAINS: Record<number, IHyperliquidChain>;
 export declare const ALL_CHAINS: Record<number, IBaseChain>;
 export declare function getSolanaChains(network: "mainnet" | "testnet"): ISolanaChain;
 export declare function getAllEvmChains(network: "mainnet" | "testnet"): Record<number, IEVMChain>;
@@ -63,3 +65,20 @@ export declare function getExplorerAddressUrl(chainId: number, address: string):
 export declare function getMulticall3Address(chainId: number): string;
 export declare function getNativeToken(chainId: number): components["schemas"]["Token"];
 export declare function isEvmChain(chainId: number): boolean;
+export declare function isHyperliquidChain(chainId: number): boolean;
+export declare function getHyperliquidChain(chainId: number): IHyperliquidChain;
+/**
+ * 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 declare function getAvailableChainIds(context: "from" | "to"): number[];

package/dist/esm/anyspend/utils/chain.js

@@ -3,7 +3,7 @@ import invariant from "invariant";
 import { createPublicClient, createWalletClient, defineChain, http, parseEther, } from "viem";
 import { abstract, arbitrum, avalanche, b3, base, bsc, mainnet, optimism, polygon } from "viem/chains";
 import { ChainType } from "../types/chain.js";
-import { getAvaxToken, getBnbToken, getEthToken, getHyperEVMNativeToken, getPolToken, getSolanaToken, HYPEREVM_CHAIN_ID, } from "./token.js";
+import { getAvaxToken, getBnbToken, getEthToken, getHyperEVMNativeToken, getHyperliquidUSDCToken, getPolToken, getSolanaToken, HYPEREVM_CHAIN_ID, HYPERLIQUID_CHAIN_ID, } from "./token.js";
 function getCustomEvmChain(chain, rpcUrl) {
     return defineChain({ ...chain, rpcUrls: { default: { http: [rpcUrl] } } });
 }
@@ -232,9 +232,27 @@ export const SOLANA_MAINNET = {
     nativeToken: getSolanaToken(),
     coingeckoName: "solana",
 };
+export const HYPERLIQUID_MAINNET = {
+    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 = { ...EVM_MAINNET, ...EVM_TESTNET };
 export const SOLANA_CHAINS = { [RELAY_SOLANA_MAINNET_CHAIN_ID]: SOLANA_MAINNET };
-export const ALL_CHAINS = { ...EVM_CHAINS, ...SOLANA_CHAINS };
+export const HYPERLIQUID_CHAINS = {
+    [HYPERLIQUID_CHAIN_ID]: HYPERLIQUID_MAINNET,
+};
+export const ALL_CHAINS = { ...EVM_CHAINS, ...SOLANA_CHAINS, ...HYPERLIQUID_CHAINS };
 export function getSolanaChains(network) {
     invariant(network === "mainnet", "Solana chain is only supported on mainnet");
     return SOLANA_MAINNET;
@@ -272,7 +290,7 @@ export function canDepositNative(chainId) {
     return ALL_CHAINS[chainId].canDepositNative;
 }
 export function isMainnet(chainId) {
-    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) {
     return EVM_TESTNET[chainId] !== undefined;
@@ -283,7 +301,11 @@ export function getDefaultToken(chainId) {
 }
 export function getChainName(chainId) {
     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.viem.name;
+    }
+    return chain.name;
 }
 export function getCoingeckoName(chainId) {
     invariant(ALL_CHAINS[chainId], `Chain ${chainId} is not supported`);
@@ -432,6 +454,12 @@ export function getPaymentUrl(address, amount, currency, chainId, decimals) {
             console.log("Solana URL (isNativeSOL:", isNativeSOL, "):", url);
             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;
@@ -444,12 +472,20 @@ export function getExplorerTxUrl(chainId, txHash) {
     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;
 }
 export function getExplorerAddressUrl(chainId, address) {
     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;
 }
 export function getMulticall3Address(chainId) {
@@ -466,3 +502,33 @@ export function getNativeToken(chainId) {
 export function isEvmChain(chainId) {
     return Boolean(EVM_CHAINS[chainId]);
 }
+export function isHyperliquidChain(chainId) {
+    return HYPERLIQUID_CHAINS[chainId] !== undefined;
+}
+export function getHyperliquidChain(chainId) {
+    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) {
+    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/dist/esm/anyspend/utils/token.d.ts

@@ -8,3 +8,4 @@ export declare function getPolToken(): components["schemas"]["Token"];
 export declare function getBnbToken(): components["schemas"]["Token"];
 export declare function getAvaxToken(): components["schemas"]["Token"];
 export declare function getHyperEVMNativeToken(): components["schemas"]["Token"];
+export declare function getHyperliquidUSDCToken(): components["schemas"]["Token"];

package/dist/esm/anyspend/utils/token.js

@@ -1,9 +1,9 @@
-import { RELAY_ETH_ADDRESS, RELAY_SOL_ADDRESS, RELAY_SOLANA_MAINNET_CHAIN_ID } from "../../anyspend/constants/index.js";
+import { RELAY_SOL_ADDRESS, RELAY_SOLANA_MAINNET_CHAIN_ID, ZERO_ADDRESS } from "../../anyspend/constants/index.js";
 import { avalanche, bsc, polygon } from "viem/chains";
 export const HYPERLIQUID_CHAIN_ID = 1337;
 export const HYPEREVM_CHAIN_ID = 999;
 export function isNativeToken(address) {
-    return address.toLowerCase() === RELAY_ETH_ADDRESS || address.toLowerCase() === RELAY_SOL_ADDRESS;
+    return address.toLowerCase() === ZERO_ADDRESS || address.toLowerCase() === RELAY_SOL_ADDRESS;
 }
 export function getSolanaToken() {
     return {
@@ -20,7 +20,7 @@ export function getSolanaToken() {
 export function getEthToken(chainId) {
     return {
         chainId: chainId,
-        address: RELAY_ETH_ADDRESS,
+        address: ZERO_ADDRESS,
         symbol: "ETH",
         name: "Ethereum",
         decimals: 18,
@@ -32,7 +32,7 @@ export function getEthToken(chainId) {
 export function getPolToken() {
     return {
         chainId: polygon.id,
-        address: RELAY_ETH_ADDRESS,
+        address: ZERO_ADDRESS,
         symbol: "POL",
         name: "Polygon",
         decimals: 18,
@@ -44,7 +44,7 @@ export function getPolToken() {
 export function getBnbToken() {
     return {
         chainId: bsc.id,
-        address: RELAY_ETH_ADDRESS,
+        address: ZERO_ADDRESS,
         symbol: "BNB",
         name: "BNB",
         decimals: 18,
@@ -56,7 +56,7 @@ export function getBnbToken() {
 export function getAvaxToken() {
     return {
         chainId: avalanche.id,
-        address: RELAY_ETH_ADDRESS,
+        address: ZERO_ADDRESS,
         symbol: "AVAX",
         name: "AVAX",
         decimals: 18,
@@ -68,7 +68,7 @@ export function getAvaxToken() {
 export function getHyperEVMNativeToken() {
     return {
         chainId: HYPEREVM_CHAIN_ID,
-        address: RELAY_ETH_ADDRESS,
+        address: ZERO_ADDRESS,
         symbol: "HYPE",
         name: "HYPE",
         decimals: 18,
@@ -77,3 +77,15 @@ export function getHyperEVMNativeToken() {
         },
     };
 }
+export function getHyperliquidUSDCToken() {
+    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",
+        },
+    };
+}

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

@@ -1,6 +1,6 @@
 import { components } from "../types/api";
 export declare const ANYSPEND_MAINNET_BASE_URL: string;
-export declare const RELAY_ETH_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 export declare const RELAY_SOL_ADDRESS = "11111111111111111111111111111111";
 export declare const RELAY_SOLANA_MAINNET_CHAIN_ID = 792703809;
 export declare const SOLANA_ASSOCIATED_TOKEN_ACCOUNT_PROGRAM_ID = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";

package/dist/types/anyspend/react/hooks/index.d.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/dist/types/anyspend/react/hooks/useHyperliquidTransfer.d.ts

@@ -0,0 +1,37 @@
+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 declare function useHyperliquidTransfer(): {
+    initiateTransfer: ({ amount, destination }: HyperliquidTransferParams) => Promise<void>;
+    getConnectedAddress: () => `0x${string}` | null;
+    isWalletConnected: boolean;
+};
+export {};

package/dist/types/anyspend/types/chain.d.ts

@@ -1,8 +1,9 @@
-import { Chain } from "viem";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
+import { Chain } from "viem";
 export declare enum ChainType {
     EVM = "evm",
-    SOLANA = "solana"
+    SOLANA = "solana",
+    HYPERLIQUID = "hyperliquid"
 }
 export interface IBaseChain {
     id: number;
@@ -25,3 +26,10 @@ 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/dist/types/anyspend/utils/address.d.ts

@@ -1,4 +1,15 @@
 export declare function isSolanaAddress(address: string): boolean;
 export declare function isEvmOrSolanaAddress(address: string): boolean;
+/**
+ * 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 declare function isHyperliquidUSDC(chainId: number, address: string): boolean;
 export declare function normalizeAddress(address: string): string;
 export declare function eqci(a: string | null | undefined, b: string | null | undefined): boolean;

package/dist/types/anyspend/utils/chain.d.ts

@@ -1,6 +1,6 @@
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { Account, Chain, PublicClient, Transport, WalletClient } from "viem";
-import { ChainType, IBaseChain, IEVMChain, ISolanaChain } from "../types/chain";
+import { ChainType, IBaseChain, IEVMChain, IHyperliquidChain, ISolanaChain } from "../types/chain";
 export declare const hyperEVM: {
     blockExplorers: {
         readonly default: {
@@ -42,8 +42,10 @@ export declare const hyperEVM: {
 export declare const EVM_MAINNET: Record<number, IEVMChain>;
 export declare const EVM_TESTNET: Record<number, IEVMChain>;
 export declare const SOLANA_MAINNET: ISolanaChain;
+export declare const HYPERLIQUID_MAINNET: IHyperliquidChain;
 export declare const EVM_CHAINS: Record<number, IEVMChain>;
 export declare const SOLANA_CHAINS: Record<number, ISolanaChain>;
+export declare const HYPERLIQUID_CHAINS: Record<number, IHyperliquidChain>;
 export declare const ALL_CHAINS: Record<number, IBaseChain>;
 export declare function getSolanaChains(network: "mainnet" | "testnet"): ISolanaChain;
 export declare function getAllEvmChains(network: "mainnet" | "testnet"): Record<number, IEVMChain>;
@@ -63,3 +65,20 @@ export declare function getExplorerAddressUrl(chainId: number, address: string):
 export declare function getMulticall3Address(chainId: number): string;
 export declare function getNativeToken(chainId: number): components["schemas"]["Token"];
 export declare function isEvmChain(chainId: number): boolean;
+export declare function isHyperliquidChain(chainId: number): boolean;
+export declare function getHyperliquidChain(chainId: number): IHyperliquidChain;
+/**
+ * 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 declare function getAvailableChainIds(context: "from" | "to"): number[];

package/dist/types/anyspend/utils/token.d.ts

@@ -8,3 +8,4 @@ export declare function getPolToken(): components["schemas"]["Token"];
 export declare function getBnbToken(): components["schemas"]["Token"];
 export declare function getAvaxToken(): components["schemas"]["Token"];
 export declare function getHyperEVMNativeToken(): components["schemas"]["Token"];
+export declare function getHyperliquidUSDCToken(): components["schemas"]["Token"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.0.83-alpha.1",
+  "version": "0.0.83-alpha.3",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",

package/src/anyspend/constants/index.ts

@@ -3,7 +3,7 @@ import { components } from "../types/api";
 
 export const ANYSPEND_MAINNET_BASE_URL = process.env.NEXT_PUBLIC_ANYSPEND_BASE_URL || "https://mainnet.anyspend.com";
 
-export const RELAY_ETH_ADDRESS = "0x0000000000000000000000000000000000000000";
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
 export const RELAY_SOL_ADDRESS = "11111111111111111111111111111111";
 
 export const RELAY_SOLANA_MAINNET_CHAIN_ID = 792703809;

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

@@ -1,6 +1,6 @@
 "use client";
 
-import { getDefaultToken, USDC_BASE } from "@b3dotfun/sdk/anyspend";
+import { getDefaultToken, HYPERLIQUID_CHAIN_ID, USDC_BASE } from "@b3dotfun/sdk/anyspend";
 import {
   useAnyspendCreateOnrampOrder,
   useAnyspendCreateOrder,
@@ -1126,12 +1126,18 @@ function AnySpendInner({
               "border-as-stroke bg-as-surface-primary absolute left-1/2 top-1/2 z-10 h-10 w-10 -translate-x-1/2 -translate-y-1/2 rounded-xl border-2 sm:h-8 sm:w-8 sm:rounded-xl",
               isBuyMode && "top-[calc(50%+56px)] cursor-default",
               activeTab === "fiat" && "hidden",
+              selectedDstChainId === HYPERLIQUID_CHAIN_ID && "cursor-not-allowed opacity-50",
             )}
             onClick={() => {
               if (activeTab === "fiat" || isBuyMode) {
                 return;
               }
 
+              // Prevent swapping if destination is Hyperliquid (only supported as destination, not source)
+              if (selectedDstChainId === HYPERLIQUID_CHAIN_ID) {
+                return;
+              }
+
               // Swap chain selections
               const tempSrcChainId = selectedSrcChainId;
               const tempDstChainId = selectedDstChainId;

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

@@ -1,5 +1,5 @@
 import { eqci, getDefaultToken, roundUpUSDCBaseAmountToNearest } from "@b3dotfun/sdk/anyspend";
-import { RELAY_ETH_ADDRESS, USDC_BASE } from "@b3dotfun/sdk/anyspend/constants";
+import { USDC_BASE, ZERO_ADDRESS } from "@b3dotfun/sdk/anyspend/constants";
 import {
   CreateOrderParams,
   useAnyspendCreateOnrampOrder,
@@ -295,7 +295,7 @@ function AnySpendCustomInner({
     // First check native tokens (ETH, etc.)
     const nativeToken = nativeTokens?.find(t => t.chainId === srcChainId && Number(t.displayValue) > 0);
     if (nativeToken) {
-      const matchingToken = tokenList.find(t => t.address === RELAY_ETH_ADDRESS);
+      const matchingToken = tokenList.find(t => t.address === ZERO_ADDRESS);
       if (matchingToken) return matchingToken;
     }