keynesol-shared 1.0.0

package/dist/components/Wallet/WalletConnectionModal.jsx

@@ -0,0 +1,170 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import React from 'react';
+import styled from 'styled-components';
+import { useWallet } from '@solana/wallet-adapter-react';
+const ModalOverlay = styled.div `
+  display: ${props => props.isOpen ? 'flex' : 'none'};
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.8);
+  backdrop-filter: blur(4px);
+  z-index: 1000;
+  align-items: center;
+  justify-content: center;
+  animation: fadeIn 0.2s ease-in-out;
+  
+  @keyframes fadeIn {
+    from { opacity: 0; }
+    to { opacity: 1; }
+  }
+`;
+const ModalContent = styled.div `
+  background: var(--color-surface, #f9fafb);
+  border: 1px solid var(--color-primary, #6a8102);
+  border-radius: 1rem;
+  padding: 2rem;
+  max-width: 400px;
+  width: 90%;
+  animation: slideUp 0.3s ease-out;
+  
+  @keyframes slideUp {
+    from {
+      transform: translateY(20px);
+      opacity: 0;
+    }
+    to {
+      transform: translateY(0);
+      opacity: 1;
+    }
+  }
+`;
+const ModalHeader = styled.div `
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 1.5rem;
+`;
+const ModalTitle = styled.h2 `
+  font-size: 1.5rem;
+  color: var(--color-text, #1a1a1a);
+  margin: 0;
+`;
+const CloseButton = styled.button `
+  background: none;
+  border: none;
+  color: var(--color-text-secondary, #6b7280);
+  font-size: 1.5rem;
+  cursor: pointer;
+  padding: 0;
+  width: 32px;
+  height: 32px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 0.5rem;
+  transition: all 0.2s;
+  
+  &:hover {
+    background: var(--color-background, #ffffff);
+    color: var(--color-text, #1a1a1a);
+  }
+`;
+const WalletList = styled.div `
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+`;
+const WalletButton = styled.button `
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  padding: 1rem;
+  background: var(--color-background, #ffffff);
+  border: 1px solid var(--color-primary, #6a8102);
+  border-radius: 0.5rem;
+  color: var(--color-text, #1a1a1a);
+  font-size: 1rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s;
+  
+  &:hover {
+    background: var(--color-primary, #6a8102);
+    color: var(--color-background, #ffffff);
+    transform: translateX(4px);
+  }
+  
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+    transform: none;
+  }
+`;
+const WalletIcon = styled.div `
+  width: 32px;
+  height: 32px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 1.5rem;
+`;
+const WalletName = styled.span `
+  flex: 1;
+  text-align: left;
+`;
+const Description = styled.p `
+  color: var(--color-text-secondary, #6b7280);
+  font-size: 0.875rem;
+  margin-bottom: 1.5rem;
+  line-height: 1.5;
+`;
+const WalletConnectionModal = ({ isOpen, onClose }) => {
+    const { wallets, select, connecting } = useWallet();
+    const handleWalletSelect = (walletName) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            select(walletName);
+            onClose();
+        }
+        catch (error) {
+            console.error('Failed to select wallet:', error);
+        }
+    });
+    const handleOverlayClick = (e) => {
+        if (e.target === e.currentTarget) {
+            onClose();
+        }
+    };
+    return (<ModalOverlay isOpen={isOpen} onClick={handleOverlayClick}>
+      <ModalContent>
+        <ModalHeader>
+          <ModalTitle>Connect Wallet</ModalTitle>
+          <CloseButton onClick={onClose}>×</CloseButton>
+        </ModalHeader>
+        
+        <Description>
+          Select a wallet to connect to the Web3 Prediction Platform and start staking.
+        </Description>
+        
+        <WalletList>
+          {wallets.map((wallet) => (<WalletButton key={wallet.adapter.name} onClick={() => handleWalletSelect(wallet.adapter.name)} disabled={connecting}>
+              <WalletIcon>
+                {wallet.adapter.icon ? (<img src={wallet.adapter.icon} alt={wallet.adapter.name} width={32} height={32}/>) : ('👛')}
+              </WalletIcon>
+              <WalletName>{wallet.adapter.name}</WalletName>
+            </WalletButton>))}
+        </WalletList>
+      </ModalContent>
+    </ModalOverlay>);
+};
+export default WalletConnectionModal;

package/dist/components/Wallet/WalletProvider.d.ts

@@ -0,0 +1,9 @@
+import React, { ReactNode } from 'react';
+interface WalletProviderProps {
+    children: ReactNode;
+    network?: 'devnet' | 'mainnet-beta' | 'testnet';
+    rpcEndpoint?: string;
+}
+export declare const WalletProvider: ({ children, network: networkProp, rpcEndpoint: rpcEndpointProp }: WalletProviderProps) => React.JSX.Element;
+export {};
+//# sourceMappingURL=WalletProvider.d.ts.map

package/dist/components/Wallet/WalletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletProvider.d.ts","sourceRoot":"","sources":["../../../src/components/Wallet/WalletProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAW,SAAS,EAAE,MAAM,OAAO,CAAC;AASlD,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,GAAI,kEAI5B,mBAAmB,sBAoFrB,CAAC"}

package/dist/components/Wallet/WalletProvider.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { ConnectionProvider, WalletProvider as SolanaWalletProvider } from '@solana/wallet-adapter-react';
+import { WalletAdapterNetwork } from '@solana/wallet-adapter-base';
+import { PhantomWalletAdapter, SolflareWalletAdapter } from '@solana/wallet-adapter-wallets';
+import { WalletModalProvider } from '@solana/wallet-adapter-react-ui';
+import { clusterApiUrl } from '@solana/web3.js';
+require('@solana/wallet-adapter-react-ui/styles.css');
+export const WalletProvider = ({ children, network: networkProp, rpcEndpoint: rpcEndpointProp }) => {
+    var _a;
+    // Get network from prop, environment variable, or default to devnet
+    const networkEnv = networkProp ||
+        (typeof process !== 'undefined' && ((_a = process.env) === null || _a === void 0 ? void 0 : _a.NEXT_PUBLIC_SOLANA_NETWORK)) ||
+        'devnet';
+    const network = networkEnv === 'mainnet-beta'
+        ? WalletAdapterNetwork.Mainnet
+        : networkEnv === 'testnet'
+            ? WalletAdapterNetwork.Testnet
+            : WalletAdapterNetwork.Devnet;
+    // Use custom RPC endpoint if provided, otherwise use cluster API URL
+    const endpoint = useMemo(() => {
+        var _a;
+        const customEndpoint = rpcEndpointProp ||
+            (typeof process !== 'undefined' && ((_a = process.env) === null || _a === void 0 ? void 0 : _a.NEXT_PUBLIC_RPC_ENDPOINT));
+        if (customEndpoint) {
+            return customEndpoint;
+        }
+        return clusterApiUrl(network);
+    }, [network, rpcEndpointProp]);
+    const wallets = useMemo(() => {
+        const walletAdapters = [];
+        // Only add Phantom if it's not already registered as Standard Wallet
+        try {
+            const phantom = new PhantomWalletAdapter();
+            walletAdapters.push(phantom);
+        }
+        catch (error) {
+            console.warn('Phantom wallet adapter already registered or error:', error);
+        }
+        // Add Solflare
+        try {
+            const solflare = new SolflareWalletAdapter();
+            walletAdapters.push(solflare);
+        }
+        catch (error) {
+            console.warn('Solflare wallet adapter error:', error);
+        }
+        return walletAdapters;
+    }, []);
+    // Disable WebSocket for custom RPC endpoints that may not support it
+    // Solana SDK will automatically fallback to HTTP polling
+    const connectionConfig = useMemo(() => {
+        var _a;
+        const customEndpoint = rpcEndpointProp ||
+            (typeof process !== 'undefined' && ((_a = process.env) === null || _a === void 0 ? void 0 : _a.NEXT_PUBLIC_RPC_ENDPOINT));
+        // If using custom endpoint (not public Solana RPC), disable WebSocket
+        const isCustomEndpoint = customEndpoint &&
+            !customEndpoint.includes('api.devnet.solana.com') &&
+            !customEndpoint.includes('api.mainnet-beta.solana.com') &&
+            !customEndpoint.includes('api.testnet.solana.com');
+        return Object.assign({ commitment: 'confirmed' }, (isCustomEndpoint ? {
+            wsEndpoint: undefined,
+            disableRetryOnRateLimit: false,
+        } : {}));
+    }, [rpcEndpointProp]);
+    // Type assertion to fix React 18/19 compatibility
+    const ConnectionProviderComponent = ConnectionProvider;
+    // Type assertion to fix React 18/19 compatibility
+    return (_jsx(ConnectionProviderComponent, { endpoint: endpoint, config: connectionConfig, children: _jsx(SolanaWalletProvider, { wallets: wallets, autoConnect: true, children: _jsx(WalletModalProvider, { children: children }) }) }));
+};

package/dist/components/Wallet/WalletProvider.jsx

@@ -0,0 +1,75 @@
+import React, { useMemo } from 'react';
+import { ConnectionProvider, WalletProvider as SolanaWalletProvider } from '@solana/wallet-adapter-react';
+import { WalletAdapterNetwork } from '@solana/wallet-adapter-base';
+import { PhantomWalletAdapter, SolflareWalletAdapter } from '@solana/wallet-adapter-wallets';
+import { WalletModalProvider } from '@solana/wallet-adapter-react-ui';
+import { clusterApiUrl } from '@solana/web3.js';
+require('@solana/wallet-adapter-react-ui/styles.css');
+export const WalletProvider = ({ children, network: networkProp, rpcEndpoint: rpcEndpointProp }) => {
+    var _a;
+    // Get network from prop, environment variable, or default to devnet
+    const networkEnv = networkProp ||
+        (typeof process !== 'undefined' && ((_a = process.env) === null || _a === void 0 ? void 0 : _a.NEXT_PUBLIC_SOLANA_NETWORK)) ||
+        'devnet';
+    const network = networkEnv === 'mainnet-beta'
+        ? WalletAdapterNetwork.Mainnet
+        : networkEnv === 'testnet'
+            ? WalletAdapterNetwork.Testnet
+            : WalletAdapterNetwork.Devnet;
+    // Use custom RPC endpoint if provided, otherwise use cluster API URL
+    const endpoint = useMemo(() => {
+        var _a;
+        const customEndpoint = rpcEndpointProp ||
+            (typeof process !== 'undefined' && ((_a = process.env) === null || _a === void 0 ? void 0 : _a.NEXT_PUBLIC_RPC_ENDPOINT));
+        if (customEndpoint) {
+            return customEndpoint;
+        }
+        return clusterApiUrl(network);
+    }, [network, rpcEndpointProp]);
+    const wallets = useMemo(() => {
+        const walletAdapters = [];
+        // Only add Phantom if it's not already registered as Standard Wallet
+        try {
+            const phantom = new PhantomWalletAdapter();
+            walletAdapters.push(phantom);
+        }
+        catch (error) {
+            console.warn('Phantom wallet adapter already registered or error:', error);
+        }
+        // Add Solflare
+        try {
+            const solflare = new SolflareWalletAdapter();
+            walletAdapters.push(solflare);
+        }
+        catch (error) {
+            console.warn('Solflare wallet adapter error:', error);
+        }
+        return walletAdapters;
+    }, []);
+    // Disable WebSocket for custom RPC endpoints that may not support it
+    // Solana SDK will automatically fallback to HTTP polling
+    const connectionConfig = useMemo(() => {
+        var _a;
+        const customEndpoint = rpcEndpointProp ||
+            (typeof process !== 'undefined' && ((_a = process.env) === null || _a === void 0 ? void 0 : _a.NEXT_PUBLIC_RPC_ENDPOINT));
+        // If using custom endpoint (not public Solana RPC), disable WebSocket
+        const isCustomEndpoint = customEndpoint &&
+            !customEndpoint.includes('api.devnet.solana.com') &&
+            !customEndpoint.includes('api.mainnet-beta.solana.com') &&
+            !customEndpoint.includes('api.testnet.solana.com');
+        return Object.assign({ commitment: 'confirmed' }, (isCustomEndpoint ? {
+            wsEndpoint: undefined,
+            disableRetryOnRateLimit: false,
+        } : {}));
+    }, [rpcEndpointProp]);
+    // Type assertion to fix React 18/19 compatibility
+    const ConnectionProviderComponent = ConnectionProvider;
+    // Type assertion to fix React 18/19 compatibility
+    return (<ConnectionProviderComponent endpoint={endpoint} config={connectionConfig}>
+      <SolanaWalletProvider wallets={wallets} autoConnect>
+        <WalletModalProvider>
+          {children}
+        </WalletModalProvider>
+      </SolanaWalletProvider>
+    </ConnectionProviderComponent>);
+};

package/dist/components/Wallet/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wallet Components Index
+ */
+export * from './WalletProvider';
+export * from './WalletButton';
+export { default as WalletBalance } from './WalletBalance';
+export { default as TransactionStatus } from './TransactionStatus';
+export { default as WalletConnectionModal } from './WalletConnectionModal';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Wallet/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/components/Wallet/index.js

@@ -0,0 +1,8 @@
+/**
+ * Wallet Components Index
+ */
+export * from './WalletProvider';
+export * from './WalletButton';
+export { default as WalletBalance } from './WalletBalance';
+export { default as TransactionStatus } from './TransactionStatus';
+export { default as WalletConnectionModal } from './WalletConnectionModal';

package/dist/components/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Components Index
+ * Export all shared components
+ */
+export * from './Common';
+export * from './Wallet';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,6 @@
+/**
+ * Components Index
+ * Export all shared components
+ */
+export * from './Common';
+export * from './Wallet';

package/dist/hooks/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Hooks Index
+ * Export all shared hooks
+ */
+export * from './useProgram';
+export * from './useVaults';
+export * from './useTokenBalance';
+export * from './useCache';
+export * from './usePolling';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,9 @@
+/**
+ * Hooks Index
+ * Export all shared hooks
+ */
+export * from './useProgram';
+export * from './useVaults';
+export * from './useTokenBalance';
+export * from './useCache';
+export * from './usePolling';

package/dist/hooks/useCache.d.ts

@@ -0,0 +1,16 @@
+export interface CacheOptions {
+    ttl?: number;
+    key?: string;
+    namespace?: string;
+}
+/**
+ * Custom hook for caching data with automatic invalidation
+ */
+export declare const useCache: <T>(fetchFn: () => Promise<T>, options?: CacheOptions) => {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    invalidate: () => void;
+};
+//# sourceMappingURL=useCache.d.ts.map

package/dist/hooks/useCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCache.d.ts","sourceRoot":"","sources":["../../src/hooks/useCache.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,SAAS,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,UAAS,YAAiB,KACzB;IACD,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;CAwDxB,CAAC"}

package/dist/hooks/useCache.js

@@ -0,0 +1,67 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Caching Hook for Blockchain Data
+ * Requirements: 12.1 - Multi-level caching for blockchain data with cache invalidation
+ */
+import React from 'react';
+import { cacheManager } from '../utils/cacheManager';
+/**
+ * Custom hook for caching data with automatic invalidation
+ */
+export const useCache = (fetchFn, options = {}) => {
+    const { ttl, key, namespace = 'default' } = options;
+    const cacheKey = key || `cache_${fetchFn.toString()}`;
+    const [data, setData] = React.useState(() => {
+        return cacheManager.get(namespace, cacheKey);
+    });
+    const [loading, setLoading] = React.useState(!data);
+    const [error, setError] = React.useState(null);
+    const fetchData = React.useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
+        // Check cache first
+        const cached = cacheManager.get(namespace, cacheKey);
+        if (cached) {
+            setData(cached);
+            setLoading(false);
+            return;
+        }
+        try {
+            setLoading(true);
+            setError(null);
+            const result = yield fetchFn();
+            // Store in cache (using default TTL from namespace config if not provided)
+            const cacheTtl = ttl || 5000; // Default 5 seconds
+            cacheManager.set(namespace, cacheKey, result, cacheTtl);
+            setData(result);
+        }
+        catch (err) {
+            setError(err);
+            setData(null);
+        }
+        finally {
+            setLoading(false);
+        }
+    }), [fetchFn, namespace, cacheKey, ttl]);
+    React.useEffect(() => {
+        fetchData();
+    }, [fetchData]);
+    const invalidate = React.useCallback(() => {
+        cacheManager.invalidate(namespace, cacheKey);
+        setData(null);
+        fetchData();
+    }, [namespace, cacheKey, fetchData]);
+    return {
+        data,
+        loading,
+        error,
+        refetch: fetchData,
+        invalidate,
+    };
+};

package/dist/hooks/usePolling.d.ts

@@ -0,0 +1,16 @@
+export interface PollingOptions {
+    interval?: number;
+    enabled?: boolean;
+    onError?: (error: Error) => void;
+    immediate?: boolean;
+}
+/**
+ * Hook for polling data at regular intervals
+ * Implements Requirement 10.1: 5-second data synchronization
+ */
+export declare const usePolling: (callback: () => Promise<void> | void, options?: PollingOptions) => {
+    start: () => void;
+    stop: () => void;
+    isActive: boolean;
+};
+//# sourceMappingURL=usePolling.d.ts.map

package/dist/hooks/usePolling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolling.d.ts","sourceRoot":"","sources":["../../src/hooks/usePolling.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EACpC,UAAS,cAAmB,KAC3B;IACD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CA0EnB,CAAC"}

package/dist/hooks/usePolling.js

@@ -0,0 +1,79 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Polling Hook for Real-Time Data Synchronization
+ * Requirements: 10.1 - 5-second blockchain data synchronization
+ */
+import { useEffect, useRef, useCallback } from 'react';
+/**
+ * Hook for polling data at regular intervals
+ * Implements Requirement 10.1: 5-second data synchronization
+ */
+export const usePolling = (callback, options = {}) => {
+    const { interval = 5000, // 5 seconds default
+    enabled = true, onError, immediate = true, } = options;
+    const intervalRef = useRef(null);
+    const isActiveRef = useRef(false);
+    const callbackRef = useRef(callback);
+    // Update callback ref when it changes
+    useEffect(() => {
+        callbackRef.current = callback;
+    }, [callback]);
+    const execute = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            yield callbackRef.current();
+        }
+        catch (error) {
+            console.error('Polling error:', error);
+            if (onError) {
+                onError(error);
+            }
+        }
+    }), [onError]);
+    const start = useCallback(() => {
+        if (isActiveRef.current) {
+            return; // Already running
+        }
+        isActiveRef.current = true;
+        // Execute immediately if requested
+        if (immediate) {
+            execute();
+        }
+        // Set up interval
+        intervalRef.current = setInterval(() => {
+            execute();
+        }, interval);
+    }, [interval, immediate, execute]);
+    const stop = useCallback(() => {
+        if (intervalRef.current) {
+            clearInterval(intervalRef.current);
+            intervalRef.current = null;
+        }
+        isActiveRef.current = false;
+    }, []);
+    // Auto-start/stop based on enabled flag
+    useEffect(() => {
+        if (enabled) {
+            start();
+        }
+        else {
+            stop();
+        }
+        // Cleanup on unmount
+        return () => {
+            stop();
+        };
+    }, [enabled, start, stop]);
+    return {
+        start,
+        stop,
+        isActive: isActiveRef.current,
+    };
+};

package/dist/hooks/useProgram.d.ts

@@ -0,0 +1,14 @@
+import { AnchorProvider, Idl } from '@coral-xyz/anchor';
+import { PublicKey } from '@solana/web3.js';
+export interface UseProgramOptions {
+    idlPath?: string;
+    programId?: PublicKey;
+}
+export declare const useProgram: (options?: UseProgramOptions) => {
+    program: any;
+    provider: AnchorProvider;
+    idl: Idl;
+    idlError: string;
+    programId: PublicKey;
+};
+//# sourceMappingURL=useProgram.d.ts.map

package/dist/hooks/useProgram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProgram.d.ts","sourceRoot":"","sources":["../../src/hooks/useProgram.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,cAAc,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAmB5C,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,eAAO,MAAM,UAAU,GAAI,UAAS,iBAAsB;;;;;;CAiEzD,CAAC"}