@rotateprotocol/sdk 1.0.0

package/src/react.ts

@@ -0,0 +1,459 @@
+/**
+ * Rotate Protocol React Hooks
+ * 
+ * React hooks for easy integration with Solana wallet adapters.
+ * 
+ * @packageDocumentation
+ */
+
+import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
+import { useConnection, useWallet } from '@solana/wallet-adapter-react';
+import { PublicKey } from '@solana/web3.js';
+import RotateSDK, {
+  PaymentLink,
+  Platform,
+  Merchant,
+  Protocol,
+  calculateFees,
+  generateSampleId,
+  isValidId,
+  getLinkDescription,
+  MEMO_PROGRAM_ID,
+  Network,
+  MIN_RANDOM_ID,
+  MAX_RANDOM_ID,
+} from './index';
+
+// ==================== TYPES ====================
+
+export interface UseRotateOptions {
+  network?: Network;
+  rpcEndpoint?: string;
+}
+
+export interface PaymentStatus {
+  linkId: number;
+  status: PaymentLink['status'];
+  amountPaid: bigint;
+  amountTotal: bigint;
+  isPaid: boolean;
+  isExpired: boolean;
+}
+
+// ==================== MAIN HOOK ====================
+
+/**
+ * Main hook for Rotate Protocol
+ */
+export function useRotate(options: UseRotateOptions = {}) {
+  const { connection } = useConnection();
+  const wallet = useWallet();
+  
+  const sdk = useMemo(() => {
+    return new RotateSDK({
+      network: options.network || 'mainnet-beta',
+      rpcEndpoint: options.rpcEndpoint,
+    });
+  }, [options.network, options.rpcEndpoint]);
+  
+  const [protocol, setProtocol] = useState<Protocol | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  
+  // Load protocol on mount
+  useEffect(() => {
+    async function load() {
+      try {
+        const data = await sdk.getProtocol();
+        setProtocol(data);
+      } catch (e: any) {
+        setError(e.message);
+      } finally {
+        setLoading(false);
+      }
+    }
+    load();
+  }, [sdk]);
+  
+  return {
+    sdk,
+    protocol,
+    loading,
+    error,
+    connected: wallet.connected,
+    publicKey: wallet.publicKey,
+    signTransaction: wallet.signTransaction,
+  };
+}
+
+// ==================== PAYMENT LINK HOOK ====================
+
+/**
+ * Hook for working with a specific payment link
+ */
+export function usePaymentLink(linkId: number, options: UseRotateOptions = {}) {
+  const { sdk } = useRotate(options);
+  const [link, setLink] = useState<PaymentLink | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  
+  // Load link data
+  const refresh = useCallback(async () => {
+    setLoading(true);
+    try {
+      const data = await sdk.getPaymentLink(linkId);
+      setLink(data);
+      setError(null);
+    } catch (e: any) {
+      setError(e.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [sdk, linkId]);
+  
+  useEffect(() => {
+    refresh();
+  }, [refresh]);
+  
+  // Poll for updates
+  const [polling, setPolling] = useState(false);
+  const pollIntervalRef = useRef(2000);
+  
+  const startPolling = useCallback((intervalMs: number = 2000) => {
+    pollIntervalRef.current = intervalMs;
+    setPolling(true);
+  }, []);
+  
+  const stopPolling = useCallback(() => {
+    setPolling(false);
+  }, []);
+  
+  useEffect(() => {
+    if (!polling) return;
+    
+    const interval = setInterval(refresh, pollIntervalRef.current);
+    return () => clearInterval(interval);
+  }, [polling, refresh]);
+  
+  // Status helpers
+  const status: PaymentStatus | null = link ? {
+    linkId: link.id,
+    status: link.status,
+    amountPaid: link.amountPaid,
+    amountTotal: link.amount,
+    isPaid: link.status === 'Paid',
+    isExpired: link.expiresAt > 0 && Date.now() / 1000 > link.expiresAt,
+  } : null;
+  
+  return {
+    link,
+    status,
+    loading,
+    error,
+    refresh,
+    startPolling,
+    stopPolling,
+    isPolling: polling,
+    paymentUrl: sdk.getPaymentUrl(linkId),
+  };
+}
+
+// ==================== MERCHANT HOOK ====================
+
+/**
+ * Hook for merchant operations
+ */
+export function useMerchant(merchantId: number, options: UseRotateOptions = {}) {
+  const { sdk } = useRotate(options);
+  const [merchant, setMerchant] = useState<Merchant | null>(null);
+  const [platform, setPlatform] = useState<Platform | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  
+  useEffect(() => {
+    async function load() {
+      try {
+        const merchantData = await sdk.getMerchant(merchantId);
+        setMerchant(merchantData);
+        
+        if (merchantData) {
+          const platformData = await sdk.getPlatform(merchantData.platformId);
+          setPlatform(platformData);
+        }
+      } catch (e: any) {
+        setError(e.message);
+      } finally {
+        setLoading(false);
+      }
+    }
+    load();
+  }, [sdk, merchantId]);
+  
+  // Calculate fees helper
+  const getFees = useCallback((amountUsd: number) => {
+    return calculateFees(amountUsd, platform?.feeBps || 0);
+  }, [platform]);
+  
+  return {
+    merchant,
+    platform,
+    loading,
+    error,
+    getFees,
+  };
+}
+
+// ==================== SOL PRICE HOOK ====================
+
+/**
+ * Hook for SOL price.
+ * `priceApiUrl` can be overridden to use a custom price feed (default: CoinGecko).
+ */
+export function useSolPrice(
+  refreshIntervalMs: number = 30000,
+  priceApiUrl: string = 'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd'
+) {
+  const [price, setPrice] = useState<number | null>(null);
+  const [loading, setLoading] = useState(true);
+  
+  const refresh = useCallback(async () => {
+    try {
+      const response = await fetch(priceApiUrl);
+      const data = await response.json() as { solana?: { usd?: number } };
+      setPrice(data.solana?.usd || null);
+    } catch {
+      // Ignore errors
+    } finally {
+      setLoading(false);
+    }
+  }, [priceApiUrl]);
+  
+  useEffect(() => {
+    refresh();
+    const interval = setInterval(refresh, refreshIntervalMs);
+    return () => clearInterval(interval);
+  }, [refresh, refreshIntervalMs]);
+  
+  const usdToSol = useCallback((usd: number) => {
+    if (!price) return null;
+    return usd / price;
+  }, [price]);
+  
+  const solToUsd = useCallback((sol: number) => {
+    if (!price) return null;
+    return sol * price;
+  }, [price]);
+  
+  return {
+    price,
+    loading,
+    refresh,
+    usdToSol,
+    solToUsd,
+  };
+}
+
+// ==================== TOKEN BALANCE HOOK ====================
+
+/**
+ * Hook for token balances
+ */
+export function useTokenBalances(options: UseRotateOptions = {}) {
+  const { sdk } = useRotate(options);
+  const { publicKey, connected } = useWallet();
+  const { connection } = useConnection();
+  
+  const [balances, setBalances] = useState<{
+    sol: number;
+    usdc: number;
+    usdt: number;
+  }>({ sol: 0, usdc: 0, usdt: 0 });
+  const [loading, setLoading] = useState(true);
+  
+  const refresh = useCallback(async () => {
+    if (!publicKey) return;
+    
+    setLoading(true);
+    try {
+      const [solBalance, usdcBalance, usdtBalance] = await Promise.all([
+        connection.getBalance(publicKey),
+        sdk.getTokenBalance(publicKey, 'USDC'),
+        sdk.getTokenBalance(publicKey, 'USDT'),
+      ]);
+      
+      setBalances({
+        sol: solBalance / 1e9,
+        usdc: usdcBalance,
+        usdt: usdtBalance,
+      });
+    } catch {
+      // Ignore errors
+    } finally {
+      setLoading(false);
+    }
+  }, [connection, publicKey, sdk]);
+  
+  useEffect(() => {
+    if (connected && publicKey) {
+      refresh();
+    }
+  }, [connected, publicKey, refresh]);
+  
+  return {
+    balances,
+    loading,
+    refresh,
+    hasEnough: (amount: number, currency: 'SOL' | 'USDC' | 'USDT') => {
+      const balance = currency === 'SOL' ? balances.sol : 
+                      currency === 'USDC' ? balances.usdc : 
+                      balances.usdt;
+      return balance >= amount;
+    },
+  };
+}
+
+// ==================== PAYMENT FLOW HOOK ====================
+
+/**
+ * Complete payment flow hook
+ */
+export function usePaymentFlow(linkId: number, options: UseRotateOptions = {}) {
+  const { sdk, connected, publicKey } = useRotate(options);
+  const { link, status, refresh, startPolling, stopPolling } = usePaymentLink(linkId, options);
+  const { price: solPrice } = useSolPrice();
+  const { balances } = useTokenBalances(options);
+  
+  const [selectedCurrency, setSelectedCurrency] = useState<'SOL' | 'USDC' | 'USDT'>('USDC');
+  const [paying, setPaying] = useState(false);
+  const [paymentError, setPaymentError] = useState<string | null>(null);
+  
+  // Calculate amount in selected currency, accounting for link token type
+  const amountInCurrency = useMemo(() => {
+    if (!link) return null;
+    
+    // SOL-denominated links store lamports (9 decimals)
+    if (link.tokenType === 'Sol') {
+      return Number(link.amount) / 1_000_000_000;
+    }
+    
+    // USD / USDC / USDT links store micro-units (6 decimals)
+    const amountUsd = Number(link.amount) / 1_000_000;
+    
+    if (selectedCurrency === 'SOL' && solPrice) {
+      return amountUsd / solPrice;
+    }
+    
+    // USDC/USDT are 1:1 with USD
+    return amountUsd;
+  }, [link, selectedCurrency, solPrice]);
+  
+  // Check if user can pay
+  const canPay = useMemo(() => {
+    if (!connected || !link || !amountInCurrency) return false;
+    if (link.status !== 'Pending' && link.status !== 'PartiallyPaid') return false;
+    
+    const balance = selectedCurrency === 'SOL' ? balances.sol :
+                    selectedCurrency === 'USDC' ? balances.usdc :
+                    balances.usdt;
+    
+    return balance >= amountInCurrency;
+  }, [connected, link, amountInCurrency, selectedCurrency, balances]);
+  
+  return {
+    link,
+    status,
+    connected,
+    publicKey,
+    selectedCurrency,
+    setSelectedCurrency,
+    amountInCurrency,
+    canPay,
+    paying,
+    paymentError,
+    refresh,
+    startPolling,
+    stopPolling,
+    balances,
+    solPrice,
+  };
+}
+
+// ==================== PLATFORM/MERCHANT CREATION HOOK ====================
+
+/**
+ * Hook for creating platforms and merchants with random IDs
+ */
+export function useCreateEntities(options: UseRotateOptions = {}) {
+  const { sdk, connected, publicKey } = useRotate(options);
+  const [creating, setCreating] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const createPlatform = useCallback(async (feeBps: number, wallet: PublicKey) => {
+    if (!connected) throw new Error('Wallet not connected');
+    
+    setCreating(true);
+    setError(null);
+    
+    try {
+      const result = await sdk.createPlatform({ feeBps, wallet });
+      return result;
+    } catch (e: any) {
+      setError(e.message);
+      throw e;
+    } finally {
+      setCreating(false);
+    }
+  }, [sdk, connected]);
+
+  const createMerchant = useCallback(async (platformId: number, wallet: PublicKey) => {
+    if (!connected) throw new Error('Wallet not connected');
+    
+    setCreating(true);
+    setError(null);
+    
+    try {
+      const result = await sdk.createMerchant({ platformId, wallet });
+      return result;
+    } catch (e: any) {
+      setError(e.message);
+      throw e;
+    } finally {
+      setCreating(false);
+    }
+  }, [sdk, connected]);
+
+  return {
+    createPlatform,
+    createMerchant,
+    creating,
+    error,
+    generateSampleId,
+    isValidId,
+    MIN_RANDOM_ID,
+    MAX_RANDOM_ID,
+  };
+}
+
+// ==================== STORE & MARKETPLACE HOOKS ====================
+
+// Re-export from hooks module for convenience
+export { useProducts, useCart, useMarketplace, useMarketplaceCart } from './hooks';
+export type { UseProductsReturn, UseCartReturn, UseMarketplaceReturn, UseMarketplaceCartReturn } from './hooks';
+
+// ==================== EXPORTS ====================
+
+export {
+  RotateSDK,
+  calculateFees,
+  generateSampleId,
+  isValidId,
+  getLinkDescription,
+  MEMO_PROGRAM_ID,
+  MIN_RANDOM_ID,
+  MAX_RANDOM_ID,
+};
+
+// Re-export store, marketplace & platform classes
+export { RotateStore, RotateCart } from './store';
+export { RotateMarketplace, MarketplaceCart } from './marketplace';
+export { RotatePlatformManager } from './platform';