@0xobelisk/react 1.2.0-pre.91 → 1.2.0-pre.93

package/README.md

@@ -106,13 +106,16 @@ function App() {
     packageId: '0x123...',
     metadata: contractMetadata,
     // Optional features
+    dubheSchemaId: '0xabc...', // Optional: Dubhe Schema ID
     dubheMetadata: dubheConfigMetadata, // Enables GraphQL + ECS
     credentials: {
       secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY // ⚠️ LOCAL DEVELOPMENT ONLY  // ⚠️ LOCAL DEVELOPMENT ONLY
     },
     endpoints: {
+      fullnodeUrls: ['https://fullnode.devnet.sui.io:443'], // Optional: Custom RPC endpoints
       graphql: process.env.NEXT_PUBLIC_GRAPHQL_URL,
-      websocket: process.env.NEXT_PUBLIC_GRAPHQL_WS_URL
+      websocket: process.env.NEXT_PUBLIC_GRAPHQL_WS_URL,
+      grpc: 'http://localhost:8080' // Optional: Custom gRPC endpoint
     },
     options: {
       enableBatchOptimization: true,
@@ -468,6 +471,7 @@ function ErrorHandlingExample() {
 import type {
   NetworkType,
   DubheConfig,
+  ClientConfig, // Alias for DubheConfig (for consistency with @0xobelisk/client)
   DubheReturn,
   ContractReturn // Alias for DubheReturn
 } from '@0xobelisk/react/sui';
@@ -516,6 +520,7 @@ npm run format
 interface DubheReturn {
   contract: Dubhe; // Enhanced contract instance
   graphqlClient: DubheGraphqlClient | null; // GraphQL client (if enabled)
+  grpcClient: DubheGrpcClient; // gRPC client
   ecsWorld: DubheECSWorld | null; // ECS World (if enabled)
   metadata: SuiMoveNormalizedModules; // Contract metadata
   network: NetworkType; // Current network
@@ -527,6 +532,48 @@ interface DubheReturn {
 }
 ```
 
+### DubheConfig Interface
+
+Configuration aligned with `@0xobelisk/client` for consistency:
+
+```typescript
+interface DubheConfig {
+  // Required fields
+  network: NetworkType; // 'mainnet' | 'testnet' | 'devnet' | 'localnet'
+  packageId: string; // Contract package ID
+  metadata: any; // Contract metadata (from dubhe schemagen)
+
+  // Optional fields
+  dubheSchemaId?: string; // Dubhe Schema ID for enhanced features
+  dubheMetadata?: any; // Dubhe metadata for GraphQL/ECS features
+
+  // Credentials
+  credentials?: {
+    secretKey?: string; // Private key (base64 or hex)
+    mnemonics?: string; // 12 or 24 word mnemonic phrase
+  };
+
+  // Endpoints
+  endpoints?: {
+    fullnodeUrls?: string[]; // Full node RPC URLs (multiple for redundancy)
+    graphql?: string; // GraphQL endpoint (default: http://localhost:4000/graphql)
+    websocket?: string; // WebSocket endpoint (default: ws://localhost:4000/graphql)
+    grpc?: string; // gRPC endpoint (default: http://localhost:8080)
+  };
+
+  // Options
+  options?: {
+    enableBatchOptimization?: boolean; // Default: true
+    cacheTimeout?: number; // Default: 5000 (ms)
+    debounceMs?: number; // Default: 100 (ms)
+    reconnectOnError?: boolean; // Default: true
+  };
+}
+
+// Type alias for consistency with @0xobelisk/client
+type ClientConfig = DubheConfig;
+```
+
 ### Available Hooks
 
 - `useDubhe()` → `DubheReturn` - Complete Dubhe ecosystem

package/dist/{chunk-YQUGWGOF.mjs → chunk-Q5VWR7TU.mjs}

@@ -80,6 +80,22 @@ function validateConfig(config) {
   if (config.endpoints?.websocket && !isValidUrl(config.endpoints.websocket)) {
     errors.push("endpoints.websocket must be a valid URL");
   }
+  if (config.endpoints?.grpc && !isValidUrl(config.endpoints.grpc)) {
+    errors.push("endpoints.grpc must be a valid URL");
+  }
+  if (config.endpoints?.fullnodeUrls) {
+    if (!Array.isArray(config.endpoints.fullnodeUrls)) {
+      errors.push("endpoints.fullnodeUrls must be an array");
+    } else if (config.endpoints.fullnodeUrls.length === 0) {
+      errors.push("endpoints.fullnodeUrls cannot be empty if provided");
+    } else {
+      config.endpoints.fullnodeUrls.forEach((url, index) => {
+        if (!isValidUrl(url)) {
+          errors.push(`endpoints.fullnodeUrls[${index}] must be a valid URL: ${url}`);
+        }
+      });
+    }
+  }
   if (config.options?.cacheTimeout !== void 0 && (typeof config.options.cacheTimeout !== "number" || config.options.cacheTimeout < 0)) {
     errors.push("options.cacheTimeout must be a non-negative number");
   }
@@ -181,7 +197,9 @@ function DubheProvider({ config, children }) {
           networkType: finalConfig.network,
           packageId: finalConfig.packageId,
           metadata: finalConfig.metadata,
-          secretKey: finalConfig.credentials?.secretKey
+          secretKey: finalConfig.credentials?.secretKey,
+          mnemonics: finalConfig.credentials?.mnemonics,
+          fullnodeUrls: finalConfig.endpoints?.fullnodeUrls
         });
       } catch (error) {
         console.error("Contract initialization failed:", error);
@@ -216,7 +234,7 @@ function DubheProvider({ config, children }) {
       try {
         console.log("Initializing gRPC client instance (one-time)");
         grpcClientRef.current = new DubheGrpcClient({
-          baseUrl: finalConfig.endpoints?.grpc || "http://localhost:50051"
+          baseUrl: finalConfig.endpoints?.grpc || "http://localhost:8080"
         });
         hasInitializedGrpc.current = true;
       } catch (error) {
@@ -313,7 +331,8 @@ function DubheProvider({ config, children }) {
         packageId: finalConfig.packageId,
         metadata: finalConfig.metadata,
         secretKey: finalConfig.credentials?.secretKey,
-        mnemonics: finalConfig.credentials?.mnemonics
+        mnemonics: finalConfig.credentials?.mnemonics,
+        fullnodeUrls: finalConfig.endpoints?.fullnodeUrls
       });
     }
   }, [
@@ -321,7 +340,8 @@ function DubheProvider({ config, children }) {
     finalConfig.packageId,
     finalConfig.metadata,
     finalConfig.credentials?.secretKey,
-    finalConfig.credentials?.mnemonics
+    finalConfig.credentials?.mnemonics,
+    finalConfig.endpoints?.fullnodeUrls
   ]);
   useEffect(() => {
     if (graphqlClientRef.current) {
@@ -463,4 +483,4 @@ export {
   useDubheConfigUpdate2 as useDubheConfigUpdate,
   useContract
 };
-//# sourceMappingURL=chunk-YQUGWGOF.mjs.map
+//# sourceMappingURL=chunk-Q5VWR7TU.mjs.map

package/dist/chunk-Q5VWR7TU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sui/config.ts","../src/sui/utils.ts","../src/sui/provider.tsx","../src/sui/hooks.ts"],"sourcesContent":["/**\n * Configuration Management for Dubhe React Integration\n *\n * Features:\n * - Type-safe configuration interface\n * - Configuration validation and error handling\n * - Smart merging of defaults and explicit config\n * - No environment variable handling (developers should handle environment variables themselves)\n */\n\nimport { useMemo } from 'react';\nimport type { DubheConfig } from './types';\nimport { mergeConfigurations, validateConfig } from './utils';\n\n/**\n * Default configuration object with sensible defaults\n */\nexport const DEFAULT_CONFIG: Partial<DubheConfig> = {\n  endpoints: {\n    graphql: 'http://localhost:4000/graphql',\n    websocket: 'ws://localhost:4000/graphql'\n  },\n  options: {\n    enableBatchOptimization: true,\n    cacheTimeout: 5000,\n    debounceMs: 100,\n    reconnectOnError: true\n  }\n};\n\n/**\n * Configuration Hook: useDubheConfig\n *\n * Merges defaults with explicit configuration provided by the developer\n *\n * Note: Environment variables should be handled by the developer before passing to this hook\n *\n * @param config - Complete or partial configuration object\n * @returns Complete, validated DubheConfig\n *\n * @example\n * ```typescript\n * // Basic usage with explicit config\n * const config = useDubheConfig({\n *   network: 'testnet',\n *   packageId: '0x123...',\n *   metadata: contractMetadata,\n *   credentials: {\n *     secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY // Handle env vars yourself\n *   }\n * });\n *\n * // With helper function to handle environment variables\n * const getConfigFromEnv = () => ({\n *   network: process.env.NEXT_PUBLIC_NETWORK as NetworkType,\n *   packageId: process.env.NEXT_PUBLIC_PACKAGE_ID,\n *   credentials: {\n *     secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *   }\n * });\n *\n * const config = useDubheConfig({\n *   ...getConfigFromEnv(),\n *   metadata: contractMetadata\n * });\n * ```\n */\nexport function useDubheConfig(config: Partial<DubheConfig>): DubheConfig {\n  // Memoize the stringified config to detect actual changes\n  const configKey = useMemo(() => {\n    return JSON.stringify(config);\n  }, [config]);\n\n  return useMemo(() => {\n    // Merge configurations: defaults -> user provided config\n    const mergedConfig = mergeConfigurations(DEFAULT_CONFIG, config);\n\n    // Validate the final configuration\n    const validatedConfig = validateConfig(mergedConfig);\n\n    // if (process.env.NODE_ENV === 'development') {\n    //   console.log('🔧 Dubhe Config:', {\n    //     ...validatedConfig,\n    //     credentials: validatedConfig.credentials?.secretKey ? '[REDACTED]' : undefined\n    //   });\n    // }\n\n    return validatedConfig;\n  }, [configKey]);\n}\n","/**\n * Utility Functions for Dubhe Configuration Management\n *\n * Features:\n * - Configuration validation and error handling\n * - Smart configuration merging with proper type safety\n * - Type-safe configuration validation\n */\n\nimport type { DubheConfig } from './types';\n\n/**\n * Merge multiple configuration objects with proper deep merging\n * Later configurations override earlier ones\n *\n * @param baseConfig - Base configuration (usually defaults)\n * @param overrideConfig - Override configuration (user provided)\n * @returns Merged configuration\n */\nexport function mergeConfigurations(\n  baseConfig: Partial<DubheConfig>,\n  overrideConfig?: Partial<DubheConfig>\n): Partial<DubheConfig> {\n  if (!overrideConfig) {\n    return { ...baseConfig };\n  }\n\n  const result: Partial<DubheConfig> = { ...baseConfig };\n\n  // Merge top-level properties\n  Object.assign(result, overrideConfig);\n\n  // Deep merge nested objects\n  if (overrideConfig.credentials || baseConfig.credentials) {\n    result.credentials = {\n      ...baseConfig.credentials,\n      ...overrideConfig.credentials\n    };\n  }\n\n  if (overrideConfig.endpoints || baseConfig.endpoints) {\n    result.endpoints = {\n      ...baseConfig.endpoints,\n      ...overrideConfig.endpoints\n    };\n  }\n\n  if (overrideConfig.options || baseConfig.options) {\n    result.options = {\n      ...baseConfig.options,\n      ...overrideConfig.options\n    };\n  }\n\n  return result;\n}\n\n/**\n * Validate configuration and ensure required fields are present\n * Throws descriptive errors for missing required fields\n *\n * @param config - Configuration to validate\n * @returns Validated and typed configuration\n * @throws Error if required fields are missing or invalid\n */\nexport function validateConfig(config: Partial<DubheConfig>): DubheConfig {\n  const errors: string[] = [];\n\n  // Check required fields\n  if (!config.network) {\n    errors.push('network is required');\n  }\n\n  if (!config.packageId) {\n    errors.push('packageId is required');\n  }\n\n  if (!config.metadata) {\n    errors.push('metadata is required');\n  } else {\n    // Basic metadata validation\n    if (typeof config.metadata !== 'object') {\n      errors.push('metadata must be an object');\n    } else if (Object.keys(config.metadata).length === 0) {\n      errors.push('metadata cannot be empty');\n    }\n  }\n\n  // Validate network type\n  if (config.network && !['mainnet', 'testnet', 'devnet', 'localnet'].includes(config.network)) {\n    errors.push(\n      `invalid network: ${config.network}. Must be one of: mainnet, testnet, devnet, localnet`\n    );\n  }\n\n  // Validate package ID format (enhanced check)\n  if (config.packageId) {\n    if (!config.packageId.startsWith('0x')) {\n      errors.push('packageId must start with 0x');\n    } else if (config.packageId.length < 3) {\n      errors.push('packageId must be longer than 0x');\n    } else if (!/^0x[a-fA-F0-9]+$/.test(config.packageId)) {\n      errors.push('packageId must contain only hexadecimal characters after 0x');\n    }\n  }\n\n  // Validate dubheMetadata if provided\n  if (config.dubheMetadata !== undefined) {\n    if (typeof config.dubheMetadata !== 'object' || config.dubheMetadata === null) {\n      errors.push('dubheMetadata must be an object');\n    } else if (!config.dubheMetadata.components && !config.dubheMetadata.resources) {\n      errors.push('dubheMetadata must contain components or resources');\n    }\n  }\n\n  // Validate credentials if provided\n  if (config.credentials) {\n    if (config.credentials.secretKey && typeof config.credentials.secretKey !== 'string') {\n      errors.push('credentials.secretKey must be a string');\n    }\n    if (config.credentials.mnemonics && typeof config.credentials.mnemonics !== 'string') {\n      errors.push('credentials.mnemonics must be a string');\n    }\n  }\n\n  // Validate URLs if provided\n  if (config.endpoints?.graphql && !isValidUrl(config.endpoints.graphql)) {\n    errors.push('endpoints.graphql must be a valid URL');\n  }\n\n  if (config.endpoints?.websocket && !isValidUrl(config.endpoints.websocket)) {\n    errors.push('endpoints.websocket must be a valid URL');\n  }\n\n  if (config.endpoints?.grpc && !isValidUrl(config.endpoints.grpc)) {\n    errors.push('endpoints.grpc must be a valid URL');\n  }\n\n  // Validate fullnodeUrls if provided\n  if (config.endpoints?.fullnodeUrls) {\n    if (!Array.isArray(config.endpoints.fullnodeUrls)) {\n      errors.push('endpoints.fullnodeUrls must be an array');\n    } else if (config.endpoints.fullnodeUrls.length === 0) {\n      errors.push('endpoints.fullnodeUrls cannot be empty if provided');\n    } else {\n      config.endpoints.fullnodeUrls.forEach((url, index) => {\n        if (!isValidUrl(url)) {\n          errors.push(`endpoints.fullnodeUrls[${index}] must be a valid URL: ${url}`);\n        }\n      });\n    }\n  }\n\n  // Validate numeric options\n  if (\n    config.options?.cacheTimeout !== undefined &&\n    (typeof config.options.cacheTimeout !== 'number' || config.options.cacheTimeout < 0)\n  ) {\n    errors.push('options.cacheTimeout must be a non-negative number');\n  }\n\n  if (\n    config.options?.debounceMs !== undefined &&\n    (typeof config.options.debounceMs !== 'number' || config.options.debounceMs < 0)\n  ) {\n    errors.push('options.debounceMs must be a non-negative number');\n  }\n\n  if (errors.length > 0) {\n    const errorMessage = `Invalid Dubhe configuration (${errors.length} error${\n      errors.length > 1 ? 's' : ''\n    }):\\n${errors.map((e) => `- ${e}`).join('\\n')}`;\n    console.error('Configuration validation failed:', { errors, config });\n    throw new Error(errorMessage);\n  }\n\n  return config as DubheConfig;\n}\n\n/**\n * Simple URL validation helper\n *\n * @param url - URL string to validate\n * @returns true if URL is valid, false otherwise\n */\nfunction isValidUrl(url: string): boolean {\n  try {\n    new URL(url);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Generate a configuration summary for debugging\n * Hides sensitive information like private keys\n *\n * @param config - Configuration to summarize\n * @returns Safe configuration summary\n */\nexport function getConfigSummary(config: DubheConfig): object {\n  return {\n    network: config.network,\n    packageId: config.packageId,\n    dubheSchemaId: config.dubheSchemaId,\n    hasMetadata: !!config.metadata,\n    hasDubheMetadata: !!config.dubheMetadata,\n    hasCredentials: !!config.credentials?.secretKey,\n    endpoints: config.endpoints,\n    options: config.options\n  };\n}\n","/**\n * Dubhe Provider - useRef Pattern for Client Management\n *\n * Features:\n * - 🎯 Single client instances across application lifecycle\n * - ⚡ useRef-based storage (no re-initialization on re-renders)\n * - 🔧 Provider pattern for dependency injection\n * - 🛡️ Complete type safety with strict TypeScript\n * - 📦 Context-based client sharing\n */\n\nimport {\n  createContext,\n  useContext,\n  useRef,\n  ReactNode,\n  useState,\n  useCallback,\n  useEffect\n} from 'react';\nimport { Dubhe } from '@0xobelisk/sui-client';\nimport { createDubheGraphqlClient, DubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport { createECSWorld, DubheECSWorld } from '@0xobelisk/ecs';\nimport { DubheGrpcClient } from '@0xobelisk/grpc-client';\nimport { useDubheConfig } from './config';\nimport type { DubheConfig, DubheReturn } from './types';\n\n/**\n * Context interface for Dubhe client instances\n * All clients are stored using useRef to ensure single initialization\n */\ninterface DubheContextValue {\n  getContract: () => Dubhe;\n  getGraphqlClient: () => DubheGraphqlClient;\n  getGrpcClient: () => DubheGrpcClient;\n  getEcsWorld: () => DubheECSWorld;\n  getAddress: () => string;\n  getMetrics: () => {\n    initTime: number;\n    requestCount: number;\n    lastActivity: number;\n  };\n  config: DubheConfig;\n  updateConfig: (newConfig: Partial<DubheConfig>) => void;\n  resetClients: (options?: {\n    resetContract?: boolean;\n    resetGraphql?: boolean;\n    resetGrpc?: boolean;\n    resetEcs?: boolean;\n  }) => void;\n}\n\n/**\n * Context for sharing Dubhe clients across the application\n * Uses useRef pattern to ensure clients are created only once\n */\nconst DubheContext = createContext<DubheContextValue | null>(null);\n\n/**\n * Props interface for DubheProvider component\n */\ninterface DubheProviderProps {\n  /** Configuration for Dubhe initialization */\n  config: Partial<DubheConfig>;\n  /** Child components that will have access to Dubhe clients */\n  children: ReactNode;\n}\n\n/**\n * DubheProvider Component - useRef Pattern Implementation\n *\n * This Provider uses useRef to store client instances, ensuring they are:\n * 1. Created only once during component lifecycle\n * 2. Persisted across re-renders without re-initialization\n * 3. Shared efficiently via React Context\n *\n * Key advantages over useMemo:\n * - useRef guarantees single initialization (useMemo can re-run on dependency changes)\n * - No dependency array needed (eliminates potential re-initialization bugs)\n * - Better performance for heavy client objects\n * - Clearer separation of concerns via Provider pattern\n *\n * @param props - Provider props containing config and children\n * @returns Provider component wrapping children with Dubhe context\n *\n * @example\n * ```typescript\n * // App root setup\n * function App() {\n *   const dubheConfig = {\n *     network: 'devnet',\n *     packageId: '0x123...',\n *     metadata: contractMetadata,\n *     credentials: {\n *       secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *     }\n *   };\n *\n *   return (\n *     <DubheProvider config={dubheConfig}>\n *       <MyApplication />\n *     </DubheProvider>\n *   );\n * }\n * ```\n */\nexport function DubheProvider({ config, children }: DubheProviderProps) {\n  // Use state to manage config for dynamic updates with persistence\n  const [currentConfig, setCurrentConfig] = useState<Partial<DubheConfig>>(() => {\n    // Try to restore config from localStorage\n    if (typeof window !== 'undefined') {\n      try {\n        const saved = localStorage.getItem('dubhe-config');\n        if (saved) {\n          const parsedConfig = JSON.parse(saved);\n          console.log('Restored Dubhe configuration from localStorage');\n          // Important: Explicit config takes precedence over localStorage\n          return { ...parsedConfig, ...config };\n        }\n      } catch (error) {\n        console.warn('Failed to restore Dubhe configuration from localStorage', error);\n      }\n    }\n    return config;\n  });\n\n  // Merge configuration with defaults\n  const finalConfig = useDubheConfig(currentConfig);\n\n  // Track initialization start time (useRef ensures single timestamp)\n  const startTimeRef = useRef<number>(performance.now());\n\n  // useRef for contract instance - guarantees single initialization\n  // Unlike useMemo, useRef.current is never re-calculated\n  const contractRef = useRef<Dubhe | undefined>(undefined);\n  const getContract = (): Dubhe => {\n    if (!contractRef.current) {\n      try {\n        console.log('Initializing Dubhe contract instance (one-time)');\n        contractRef.current = new Dubhe({\n          networkType: finalConfig.network,\n          packageId: finalConfig.packageId,\n          metadata: finalConfig.metadata,\n          secretKey: finalConfig.credentials?.secretKey,\n          mnemonics: finalConfig.credentials?.mnemonics,\n          fullnodeUrls: finalConfig.endpoints?.fullnodeUrls\n        });\n      } catch (error) {\n        console.error('Contract initialization failed:', error);\n        throw error;\n      }\n    }\n    return contractRef.current;\n  };\n\n  // useRef for GraphQL client instance - single initialization guaranteed\n  const graphqlClientRef = useRef<DubheGraphqlClient | null>(null);\n  const hasInitializedGraphql = useRef(false);\n  const getGraphqlClient = (): DubheGraphqlClient => {\n    if (!hasInitializedGraphql.current) {\n      try {\n        console.log('Initializing GraphQL client instance (one-time)');\n        graphqlClientRef.current = createDubheGraphqlClient({\n          endpoint: finalConfig.endpoints?.graphql || 'http://localhost:4000/graphql',\n          subscriptionEndpoint: finalConfig.endpoints?.websocket || 'ws://localhost:4000/graphql',\n          dubheMetadata: finalConfig.dubheMetadata\n        });\n        hasInitializedGraphql.current = true;\n      } catch (error) {\n        console.error('GraphQL client initialization failed:', error);\n        throw error;\n      }\n    }\n    return graphqlClientRef.current!;\n  };\n\n  // useRef for gRPC client instance - single initialization guaranteed\n  const grpcClientRef = useRef<DubheGrpcClient | null>(null);\n  const hasInitializedGrpc = useRef(false);\n  const getGrpcClient = (): DubheGrpcClient => {\n    if (!hasInitializedGrpc.current) {\n      try {\n        console.log('Initializing gRPC client instance (one-time)');\n        grpcClientRef.current = new DubheGrpcClient({\n          baseUrl: finalConfig.endpoints?.grpc || 'http://localhost:8080'\n        });\n        hasInitializedGrpc.current = true;\n      } catch (error) {\n        console.error('gRPC client initialization failed:', error);\n        throw error;\n      }\n    }\n    return grpcClientRef.current!;\n  };\n\n  // useRef for ECS World instance - depends on GraphQL client\n  const ecsWorldRef = useRef<DubheECSWorld | null>(null);\n  const hasInitializedEcs = useRef(false);\n  const getEcsWorld = (): DubheECSWorld => {\n    const graphqlClient = getGraphqlClient();\n    if (!hasInitializedEcs.current) {\n      try {\n        console.log('Initializing ECS World instance (one-time)');\n        ecsWorldRef.current = createECSWorld(graphqlClient, {\n          dubheMetadata: finalConfig.dubheMetadata,\n          queryConfig: {\n            enableBatchOptimization: finalConfig.options?.enableBatchOptimization ?? true,\n            defaultCacheTimeout: finalConfig.options?.cacheTimeout ?? 5000\n          },\n          subscriptionConfig: {\n            defaultDebounceMs: finalConfig.options?.debounceMs ?? 100,\n            reconnectOnError: finalConfig.options?.reconnectOnError ?? true\n          }\n        });\n        hasInitializedEcs.current = true;\n      } catch (error) {\n        console.error('ECS World initialization failed:', error);\n        throw error;\n      }\n    }\n    return ecsWorldRef.current!;\n  };\n\n  // Address getter - calculated from contract\n  const getAddress = (): string => {\n    return getContract().getAddress();\n  };\n\n  // Metrics getter - performance tracking\n  const getMetrics = () => ({\n    initTime: performance.now() - (startTimeRef.current || 0),\n    requestCount: 0, // Can be enhanced with actual tracking\n    lastActivity: Date.now()\n  });\n\n  // Selective reset client instances\n  const resetClients = useCallback(\n    (options?: {\n      resetContract?: boolean;\n      resetGraphql?: boolean;\n      resetGrpc?: boolean;\n      resetEcs?: boolean;\n    }) => {\n      const opts = {\n        resetContract: true,\n        resetGraphql: true,\n        resetGrpc: true,\n        resetEcs: true,\n        ...options\n      };\n\n      console.log('Resetting Dubhe client instances', opts);\n\n      if (opts.resetContract) {\n        contractRef.current = undefined;\n      }\n      if (opts.resetGraphql) {\n        graphqlClientRef.current = null;\n        hasInitializedGraphql.current = false;\n      }\n      if (opts.resetGrpc) {\n        grpcClientRef.current = null;\n        hasInitializedGrpc.current = false;\n      }\n      if (opts.resetEcs) {\n        ecsWorldRef.current = null;\n        hasInitializedEcs.current = false;\n      }\n\n      startTimeRef.current = performance.now();\n    },\n    []\n  );\n\n  // Update config without resetting clients (reactive update)\n  const updateConfig = useCallback((newConfig: Partial<DubheConfig>) => {\n    console.log('Updating Dubhe configuration (reactive)');\n    setCurrentConfig((prev) => {\n      const updated = { ...prev, ...newConfig };\n      // Persist to localStorage\n      if (typeof window !== 'undefined') {\n        try {\n          localStorage.setItem('dubhe-config', JSON.stringify(updated));\n          console.log('Persisted Dubhe configuration to localStorage');\n        } catch (error) {\n          console.warn('Failed to persist Dubhe configuration', error);\n        }\n      }\n      return updated;\n    });\n  }, []);\n\n  // Reactive configuration updates via useEffect\n\n  // Monitor Contract configuration changes\n  useEffect(() => {\n    if (contractRef.current) {\n      console.log('Contract config dependencies changed, updating...');\n      contractRef.current.updateConfig({\n        networkType: finalConfig.network,\n        packageId: finalConfig.packageId,\n        metadata: finalConfig.metadata,\n        secretKey: finalConfig.credentials?.secretKey,\n        mnemonics: finalConfig.credentials?.mnemonics,\n        fullnodeUrls: finalConfig.endpoints?.fullnodeUrls\n      });\n    }\n  }, [\n    finalConfig.network,\n    finalConfig.packageId,\n    finalConfig.metadata,\n    finalConfig.credentials?.secretKey,\n    finalConfig.credentials?.mnemonics,\n    finalConfig.endpoints?.fullnodeUrls\n  ]);\n\n  // Monitor GraphQL endpoint changes\n  useEffect(() => {\n    if (graphqlClientRef.current) {\n      console.log('GraphQL endpoint dependencies changed, updating...');\n      graphqlClientRef.current.updateConfig({\n        endpoint: finalConfig.endpoints?.graphql,\n        subscriptionEndpoint: finalConfig.endpoints?.websocket\n      });\n      // Reset ECS World when GraphQL endpoints change (needs new connection)\n      ecsWorldRef.current = null;\n      hasInitializedEcs.current = false;\n    }\n  }, [finalConfig.endpoints?.graphql, finalConfig.endpoints?.websocket]);\n\n  // Monitor GraphQL metadata changes\n  useEffect(() => {\n    if (graphqlClientRef.current && finalConfig.dubheMetadata) {\n      console.log('GraphQL metadata changed, updating...');\n      graphqlClientRef.current.updateConfig({\n        dubheMetadata: finalConfig.dubheMetadata\n      });\n      // Note: ECS will handle its own metadata update via its useEffect\n    }\n  }, [finalConfig.dubheMetadata]);\n\n  // Monitor gRPC configuration changes\n  useEffect(() => {\n    if (grpcClientRef.current && finalConfig.endpoints?.grpc) {\n      console.log('gRPC config dependencies changed, updating...');\n      grpcClientRef.current.updateConfig({ baseUrl: finalConfig.endpoints.grpc });\n    }\n  }, [finalConfig.endpoints?.grpc]);\n\n  // Monitor ECS configuration changes\n  useEffect(() => {\n    if (ecsWorldRef.current) {\n      console.log('ECS config dependencies changed, updating...');\n      ecsWorldRef.current.updateConfig({\n        dubheMetadata: finalConfig.dubheMetadata,\n        queryConfig: {\n          enableBatchOptimization: finalConfig.options?.enableBatchOptimization,\n          defaultCacheTimeout: finalConfig.options?.cacheTimeout\n        },\n        subscriptionConfig: {\n          defaultDebounceMs: finalConfig.options?.debounceMs,\n          reconnectOnError: finalConfig.options?.reconnectOnError\n        }\n      });\n    }\n  }, [\n    finalConfig.dubheMetadata,\n    finalConfig.options?.enableBatchOptimization,\n    finalConfig.options?.cacheTimeout,\n    finalConfig.options?.debounceMs,\n    finalConfig.options?.reconnectOnError\n  ]);\n\n  // Context value - stable reference (no re-renders for consumers)\n  const contextValue: DubheContextValue = {\n    getContract,\n    getGraphqlClient,\n    getGrpcClient,\n    getEcsWorld,\n    getAddress,\n    getMetrics,\n    config: finalConfig,\n    updateConfig,\n    resetClients\n  };\n\n  return <DubheContext.Provider value={contextValue}>{children}</DubheContext.Provider>;\n}\n\n/**\n * Custom hook to access Dubhe context\n * Provides type-safe access to all Dubhe client instances\n *\n * @returns DubheContextValue with all client getters and config\n * @throws Error if used outside of DubheProvider\n *\n * @example\n * ```typescript\n * function MyComponent() {\n *   const dubheContext = useDubheContext();\n *\n *   const contract = dubheContext.getContract();\n *   const graphqlClient = dubheContext.getGraphqlClient();\n *   const ecsWorld = dubheContext.getEcsWorld();\n *   const address = dubheContext.getAddress();\n *\n *   return <div>Connected as {address}</div>;\n * }\n * ```\n */\nexport function useDubheContext(): DubheContextValue {\n  const context = useContext(DubheContext);\n\n  if (!context) {\n    throw new Error(\n      'useDubheContext must be used within a DubheProvider. ' +\n        'Make sure to wrap your app with <DubheProvider config={...}>'\n    );\n  }\n\n  return context;\n}\n\n/**\n * Enhanced hook that mimics the original useDubhe API\n * Uses the Provider pattern internally but maintains backward compatibility\n *\n * @returns DubheReturn object with all instances and metadata\n *\n * @example\n * ```typescript\n * function MyComponent() {\n *   const { contract, graphqlClient, ecsWorld, address } = useDubheFromProvider();\n *\n *   const handleTransaction = async () => {\n *     const tx = new Transaction();\n *     await contract.tx.my_system.my_method({ tx });\n *   };\n *\n *   return <button onClick={handleTransaction}>Execute</button>;\n * }\n * ```\n */\nexport function useDubheFromProvider(): DubheReturn {\n  const context = useDubheContext();\n\n  // Get instances (lazy initialization via getters)\n  const contract = context.getContract();\n  const graphqlClient = context.getGraphqlClient();\n  const grpcClient = context.getGrpcClient();\n  const ecsWorld = context.getEcsWorld();\n  const address = context.getAddress();\n  const metrics = context.getMetrics();\n\n  return {\n    contract,\n    graphqlClient,\n    grpcClient,\n    ecsWorld,\n    metadata: context.config.metadata,\n    network: context.config.network,\n    packageId: context.config.packageId,\n    dubheSchemaId: context.config.dubheSchemaId,\n    address,\n    options: context.config.options,\n    metrics\n  };\n}\n\n/**\n * Individual client hooks for components that only need specific instances\n * These are more efficient than useDubheFromProvider for single-client usage\n */\n\n/**\n * Hook for accessing only the Dubhe contract instance\n */\nexport function useDubheContractFromProvider(): Dubhe {\n  const { contract } = useDubheFromProvider();\n  return contract;\n}\n\n/**\n * Hook for accessing only the GraphQL client instance\n */\nexport function useDubheGraphQLFromProvider(): DubheGraphqlClient {\n  const { getGraphqlClient } = useDubheContext();\n  return getGraphqlClient();\n}\n\n/**\n * Hook for accessing only the ECS World instance\n */\nexport function useDubheECSFromProvider(): DubheECSWorld {\n  const { getEcsWorld } = useDubheContext();\n  return getEcsWorld();\n}\n\n/**\n * Hook for accessing only the gRPC client instance\n */\nexport function useDubheGrpcFromProvider(): DubheGrpcClient {\n  const { getGrpcClient } = useDubheContext();\n  return getGrpcClient();\n}\n\n/**\n * Hook for accessing configuration update methods\n *\n * @returns Object with updateConfig and resetClients methods\n *\n * @example\n * ```typescript\n * function ConfigUpdater() {\n *   const { updateConfig, resetClients, config } = useDubheConfigUpdate();\n *\n *   const switchNetwork = () => {\n *     updateConfig({\n *       network: 'testnet',\n *       packageId: '0xnew...'\n *     });\n *   };\n *\n *   return (\n *     <div>\n *       <p>Current network: {config.network}</p>\n *       <button onClick={switchNetwork}>Switch to Testnet</button>\n *       <button onClick={resetClients}>Reset Clients</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDubheConfigUpdate() {\n  const { updateConfig, resetClients, config } = useDubheContext();\n  return { updateConfig, resetClients, config };\n}\n","/**\n * Modern Dubhe React Hooks - Provider Pattern\n *\n * Features:\n * - 🎯 Simple API design with Provider pattern\n * - ⚡ Single client initialization with useRef\n * - 🔧 Configuration-driven setup (developers handle environment variables themselves)\n * - 🛡️ Complete type safety with strict TypeScript\n * - 📦 Context-based client sharing across components\n */\nimport { Dubhe } from '@0xobelisk/sui-client';\nimport type { DubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport type { DubheECSWorld } from '@0xobelisk/ecs';\n\nimport {\n  useDubheFromProvider,\n  useDubheContractFromProvider,\n  useDubheGraphQLFromProvider,\n  useDubheECSFromProvider,\n  useDubheConfigUpdate as useDubheConfigUpdateFromProvider\n} from './provider';\nimport type { DubheReturn } from './types';\n\n/**\n * Primary Hook: useDubhe\n *\n * Uses Provider pattern to access shared Dubhe clients with guaranteed single initialization.\n * Must be used within a DubheProvider.\n *\n * @returns Complete Dubhe ecosystem with contract, GraphQL, ECS, and metadata\n *\n * @example\n * ```typescript\n * // App setup with Provider\n * function App() {\n *   const config = {\n *     network: 'devnet',\n *     packageId: '0x123...',\n *     metadata: contractMetadata,\n *     credentials: {\n *       secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *     }\n *   };\n *\n *   return (\n *     <DubheProvider config={config}>\n *       <MyDApp />\n *     </DubheProvider>\n *   );\n * }\n *\n * // Component usage\n * function MyDApp() {\n *   const { contract, address } = useDubhe();\n *   return <div>Connected as {address}</div>;\n * }\n * ```\n */\nexport function useDubhe(): DubheReturn {\n  return useDubheFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheContract\n *\n * Returns only the Dubhe contract instance from Provider context.\n * More efficient than useDubhe() when only contract access is needed.\n *\n * @returns Dubhe contract instance\n *\n * @example\n * ```typescript\n * function TransactionComponent() {\n *   const contract = useDubheContract();\n *\n *   const handleTransaction = async () => {\n *     const tx = new Transaction();\n *     await contract.tx.my_system.my_method({ tx });\n *   };\n *\n *   return <button onClick={handleTransaction}>Execute</button>;\n * }\n * ```\n */\nexport function useDubheContract(): Dubhe {\n  return useDubheContractFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheGraphQL\n *\n * Returns only the GraphQL client from Provider context.\n * More efficient than useDubhe() when only GraphQL access is needed.\n *\n * @returns GraphQL client instance (always available with default localhost endpoint)\n *\n * @example\n * ```typescript\n * function DataComponent() {\n *   const graphqlClient = useDubheGraphQL();\n *\n *   useEffect(() => {\n *     graphqlClient.query({ ... }).then(setData);\n *   }, [graphqlClient]);\n *\n *   return <div>{data && JSON.stringify(data)}</div>;\n * }\n * ```\n */\nexport function useDubheGraphQL(): DubheGraphqlClient {\n  return useDubheGraphQLFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheECS\n *\n * Returns only the ECS World instance from Provider context.\n * More efficient than useDubhe() when only ECS access is needed.\n *\n * @returns ECS World instance (always available, depends on GraphQL client)\n *\n * @example\n * ```typescript\n * function ECSComponent() {\n *   const ecsWorld = useDubheECS();\n *\n *   useEffect(() => {\n *     ecsWorld.getComponent('MyComponent').then(setComponent);\n *   }, [ecsWorld]);\n *\n *   return <div>ECS Component Data</div>;\n * }\n * ```\n */\nexport function useDubheECS(): DubheECSWorld {\n  return useDubheECSFromProvider();\n}\n\n/**\n * Hook for dynamic configuration updates\n *\n * Provides methods to update provider configuration at runtime\n *\n * @returns Object with updateConfig, resetClients methods and current config\n *\n * @example\n * ```typescript\n * function NetworkSwitcher() {\n *   const { updateConfig, config } = useDubheConfigUpdate();\n *\n *   const switchToTestnet = () => {\n *     updateConfig({\n *       network: 'testnet',\n *       packageId: '0xTestnetPackageId...'\n *     });\n *   };\n *\n *   return (\n *     <div>\n *       <p>Network: {config.network}</p>\n *       <button onClick={switchToTestnet}>Switch to Testnet</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDubheConfigUpdate() {\n  return useDubheConfigUpdateFromProvider();\n}\n\n/**\n * Compatibility alias for useDubhe\n */\nexport const useContract = useDubhe;\n"],"mappings":"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","names":["useDubheConfigUpdate"]}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { ContractReturn, DEFAULT_CONFIG, DubheConfig, DubheProvider, DubheReturn, NetworkType, getConfigSummary, mergeConfigurations, useContract, useDubhe, useDubheConfig, useDubheConfigUpdate, useDubheContract, useDubheECS, useDubheGraphQL, validateConfig } from './sui/index.mjs';
+export { ClientConfig, ContractReturn, DEFAULT_CONFIG, DubheConfig, DubheProvider, DubheReturn, NetworkType, getConfigSummary, mergeConfigurations, useContract, useDubhe, useDubheConfig, useDubheConfigUpdate, useDubheContract, useDubheECS, useDubheGraphQL, validateConfig } from './sui/index.mjs';
 import '@0xobelisk/sui-client';
 import '@0xobelisk/graphql-client';
 import '@0xobelisk/ecs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { ContractReturn, DEFAULT_CONFIG, DubheConfig, DubheProvider, DubheReturn, NetworkType, getConfigSummary, mergeConfigurations, useContract, useDubhe, useDubheConfig, useDubheConfigUpdate, useDubheContract, useDubheECS, useDubheGraphQL, validateConfig } from './sui/index.js';
+export { ClientConfig, ContractReturn, DEFAULT_CONFIG, DubheConfig, DubheProvider, DubheReturn, NetworkType, getConfigSummary, mergeConfigurations, useContract, useDubhe, useDubheConfig, useDubheConfigUpdate, useDubheContract, useDubheECS, useDubheGraphQL, validateConfig } from './sui/index.js';
 import '@0xobelisk/sui-client';
 import '@0xobelisk/graphql-client';
 import '@0xobelisk/ecs';

package/dist/index.js

@@ -117,6 +117,22 @@ function validateConfig(config) {
   if (config.endpoints?.websocket && !isValidUrl(config.endpoints.websocket)) {
     errors.push("endpoints.websocket must be a valid URL");
   }
+  if (config.endpoints?.grpc && !isValidUrl(config.endpoints.grpc)) {
+    errors.push("endpoints.grpc must be a valid URL");
+  }
+  if (config.endpoints?.fullnodeUrls) {
+    if (!Array.isArray(config.endpoints.fullnodeUrls)) {
+      errors.push("endpoints.fullnodeUrls must be an array");
+    } else if (config.endpoints.fullnodeUrls.length === 0) {
+      errors.push("endpoints.fullnodeUrls cannot be empty if provided");
+    } else {
+      config.endpoints.fullnodeUrls.forEach((url, index) => {
+        if (!isValidUrl(url)) {
+          errors.push(`endpoints.fullnodeUrls[${index}] must be a valid URL: ${url}`);
+        }
+      });
+    }
+  }
   if (config.options?.cacheTimeout !== void 0 && (typeof config.options.cacheTimeout !== "number" || config.options.cacheTimeout < 0)) {
     errors.push("options.cacheTimeout must be a non-negative number");
   }
@@ -211,7 +227,9 @@ function DubheProvider({ config, children }) {
           networkType: finalConfig.network,
           packageId: finalConfig.packageId,
           metadata: finalConfig.metadata,
-          secretKey: finalConfig.credentials?.secretKey
+          secretKey: finalConfig.credentials?.secretKey,
+          mnemonics: finalConfig.credentials?.mnemonics,
+          fullnodeUrls: finalConfig.endpoints?.fullnodeUrls
         });
       } catch (error) {
         console.error("Contract initialization failed:", error);
@@ -246,7 +264,7 @@ function DubheProvider({ config, children }) {
       try {
         console.log("Initializing gRPC client instance (one-time)");
         grpcClientRef.current = new import_grpc_client.DubheGrpcClient({
-          baseUrl: finalConfig.endpoints?.grpc || "http://localhost:50051"
+          baseUrl: finalConfig.endpoints?.grpc || "http://localhost:8080"
         });
         hasInitializedGrpc.current = true;
       } catch (error) {
@@ -343,7 +361,8 @@ function DubheProvider({ config, children }) {
         packageId: finalConfig.packageId,
         metadata: finalConfig.metadata,
         secretKey: finalConfig.credentials?.secretKey,
-        mnemonics: finalConfig.credentials?.mnemonics
+        mnemonics: finalConfig.credentials?.mnemonics,
+        fullnodeUrls: finalConfig.endpoints?.fullnodeUrls
       });
     }
   }, [
@@ -351,7 +370,8 @@ function DubheProvider({ config, children }) {
     finalConfig.packageId,
     finalConfig.metadata,
     finalConfig.credentials?.secretKey,
-    finalConfig.credentials?.mnemonics
+    finalConfig.credentials?.mnemonics,
+    finalConfig.endpoints?.fullnodeUrls
   ]);
   (0, import_react2.useEffect)(() => {
     if (graphqlClientRef.current) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/sui/config.ts","../src/sui/utils.ts","../src/sui/provider.tsx","../src/sui/hooks.ts"],"sourcesContent":["/**\n * @0xobelisk/react - Modern Dubhe React Integration\n *\n * 🚀 Provides simple, powerful React experience for multi-chain blockchain development\n *\n * Currently supported:\n * - Sui blockchain ✅\n * - Aptos blockchain (coming soon)\n * - Initia blockchain (coming soon)\n */\n\n// Sui integration\nexport * from './sui/index';\n// TODO: Future extensions\n// export * from './aptos/index';\n// export * from './initia/index';\n","/**\n * Configuration Management for Dubhe React Integration\n *\n * Features:\n * - Type-safe configuration interface\n * - Configuration validation and error handling\n * - Smart merging of defaults and explicit config\n * - No environment variable handling (developers should handle environment variables themselves)\n */\n\nimport { useMemo } from 'react';\nimport type { DubheConfig } from './types';\nimport { mergeConfigurations, validateConfig } from './utils';\n\n/**\n * Default configuration object with sensible defaults\n */\nexport const DEFAULT_CONFIG: Partial<DubheConfig> = {\n  endpoints: {\n    graphql: 'http://localhost:4000/graphql',\n    websocket: 'ws://localhost:4000/graphql'\n  },\n  options: {\n    enableBatchOptimization: true,\n    cacheTimeout: 5000,\n    debounceMs: 100,\n    reconnectOnError: true\n  }\n};\n\n/**\n * Configuration Hook: useDubheConfig\n *\n * Merges defaults with explicit configuration provided by the developer\n *\n * Note: Environment variables should be handled by the developer before passing to this hook\n *\n * @param config - Complete or partial configuration object\n * @returns Complete, validated DubheConfig\n *\n * @example\n * ```typescript\n * // Basic usage with explicit config\n * const config = useDubheConfig({\n *   network: 'testnet',\n *   packageId: '0x123...',\n *   metadata: contractMetadata,\n *   credentials: {\n *     secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY // Handle env vars yourself\n *   }\n * });\n *\n * // With helper function to handle environment variables\n * const getConfigFromEnv = () => ({\n *   network: process.env.NEXT_PUBLIC_NETWORK as NetworkType,\n *   packageId: process.env.NEXT_PUBLIC_PACKAGE_ID,\n *   credentials: {\n *     secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *   }\n * });\n *\n * const config = useDubheConfig({\n *   ...getConfigFromEnv(),\n *   metadata: contractMetadata\n * });\n * ```\n */\nexport function useDubheConfig(config: Partial<DubheConfig>): DubheConfig {\n  // Memoize the stringified config to detect actual changes\n  const configKey = useMemo(() => {\n    return JSON.stringify(config);\n  }, [config]);\n\n  return useMemo(() => {\n    // Merge configurations: defaults -> user provided config\n    const mergedConfig = mergeConfigurations(DEFAULT_CONFIG, config);\n\n    // Validate the final configuration\n    const validatedConfig = validateConfig(mergedConfig);\n\n    // if (process.env.NODE_ENV === 'development') {\n    //   console.log('🔧 Dubhe Config:', {\n    //     ...validatedConfig,\n    //     credentials: validatedConfig.credentials?.secretKey ? '[REDACTED]' : undefined\n    //   });\n    // }\n\n    return validatedConfig;\n  }, [configKey]);\n}\n","/**\n * Utility Functions for Dubhe Configuration Management\n *\n * Features:\n * - Configuration validation and error handling\n * - Smart configuration merging with proper type safety\n * - Type-safe configuration validation\n */\n\nimport type { DubheConfig } from './types';\n\n/**\n * Merge multiple configuration objects with proper deep merging\n * Later configurations override earlier ones\n *\n * @param baseConfig - Base configuration (usually defaults)\n * @param overrideConfig - Override configuration (user provided)\n * @returns Merged configuration\n */\nexport function mergeConfigurations(\n  baseConfig: Partial<DubheConfig>,\n  overrideConfig?: Partial<DubheConfig>\n): Partial<DubheConfig> {\n  if (!overrideConfig) {\n    return { ...baseConfig };\n  }\n\n  const result: Partial<DubheConfig> = { ...baseConfig };\n\n  // Merge top-level properties\n  Object.assign(result, overrideConfig);\n\n  // Deep merge nested objects\n  if (overrideConfig.credentials || baseConfig.credentials) {\n    result.credentials = {\n      ...baseConfig.credentials,\n      ...overrideConfig.credentials\n    };\n  }\n\n  if (overrideConfig.endpoints || baseConfig.endpoints) {\n    result.endpoints = {\n      ...baseConfig.endpoints,\n      ...overrideConfig.endpoints\n    };\n  }\n\n  if (overrideConfig.options || baseConfig.options) {\n    result.options = {\n      ...baseConfig.options,\n      ...overrideConfig.options\n    };\n  }\n\n  return result;\n}\n\n/**\n * Validate configuration and ensure required fields are present\n * Throws descriptive errors for missing required fields\n *\n * @param config - Configuration to validate\n * @returns Validated and typed configuration\n * @throws Error if required fields are missing or invalid\n */\nexport function validateConfig(config: Partial<DubheConfig>): DubheConfig {\n  const errors: string[] = [];\n\n  // Check required fields\n  if (!config.network) {\n    errors.push('network is required');\n  }\n\n  if (!config.packageId) {\n    errors.push('packageId is required');\n  }\n\n  if (!config.metadata) {\n    errors.push('metadata is required');\n  } else {\n    // Basic metadata validation\n    if (typeof config.metadata !== 'object') {\n      errors.push('metadata must be an object');\n    } else if (Object.keys(config.metadata).length === 0) {\n      errors.push('metadata cannot be empty');\n    }\n  }\n\n  // Validate network type\n  if (config.network && !['mainnet', 'testnet', 'devnet', 'localnet'].includes(config.network)) {\n    errors.push(\n      `invalid network: ${config.network}. Must be one of: mainnet, testnet, devnet, localnet`\n    );\n  }\n\n  // Validate package ID format (enhanced check)\n  if (config.packageId) {\n    if (!config.packageId.startsWith('0x')) {\n      errors.push('packageId must start with 0x');\n    } else if (config.packageId.length < 3) {\n      errors.push('packageId must be longer than 0x');\n    } else if (!/^0x[a-fA-F0-9]+$/.test(config.packageId)) {\n      errors.push('packageId must contain only hexadecimal characters after 0x');\n    }\n  }\n\n  // Validate dubheMetadata if provided\n  if (config.dubheMetadata !== undefined) {\n    if (typeof config.dubheMetadata !== 'object' || config.dubheMetadata === null) {\n      errors.push('dubheMetadata must be an object');\n    } else if (!config.dubheMetadata.components && !config.dubheMetadata.resources) {\n      errors.push('dubheMetadata must contain components or resources');\n    }\n  }\n\n  // Validate credentials if provided\n  if (config.credentials) {\n    if (config.credentials.secretKey && typeof config.credentials.secretKey !== 'string') {\n      errors.push('credentials.secretKey must be a string');\n    }\n    if (config.credentials.mnemonics && typeof config.credentials.mnemonics !== 'string') {\n      errors.push('credentials.mnemonics must be a string');\n    }\n  }\n\n  // Validate URLs if provided\n  if (config.endpoints?.graphql && !isValidUrl(config.endpoints.graphql)) {\n    errors.push('endpoints.graphql must be a valid URL');\n  }\n\n  if (config.endpoints?.websocket && !isValidUrl(config.endpoints.websocket)) {\n    errors.push('endpoints.websocket must be a valid URL');\n  }\n\n  // Validate numeric options\n  if (\n    config.options?.cacheTimeout !== undefined &&\n    (typeof config.options.cacheTimeout !== 'number' || config.options.cacheTimeout < 0)\n  ) {\n    errors.push('options.cacheTimeout must be a non-negative number');\n  }\n\n  if (\n    config.options?.debounceMs !== undefined &&\n    (typeof config.options.debounceMs !== 'number' || config.options.debounceMs < 0)\n  ) {\n    errors.push('options.debounceMs must be a non-negative number');\n  }\n\n  if (errors.length > 0) {\n    const errorMessage = `Invalid Dubhe configuration (${errors.length} error${\n      errors.length > 1 ? 's' : ''\n    }):\\n${errors.map((e) => `- ${e}`).join('\\n')}`;\n    console.error('Configuration validation failed:', { errors, config });\n    throw new Error(errorMessage);\n  }\n\n  return config as DubheConfig;\n}\n\n/**\n * Simple URL validation helper\n *\n * @param url - URL string to validate\n * @returns true if URL is valid, false otherwise\n */\nfunction isValidUrl(url: string): boolean {\n  try {\n    new URL(url);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Generate a configuration summary for debugging\n * Hides sensitive information like private keys\n *\n * @param config - Configuration to summarize\n * @returns Safe configuration summary\n */\nexport function getConfigSummary(config: DubheConfig): object {\n  return {\n    network: config.network,\n    packageId: config.packageId,\n    dubheSchemaId: config.dubheSchemaId,\n    hasMetadata: !!config.metadata,\n    hasDubheMetadata: !!config.dubheMetadata,\n    hasCredentials: !!config.credentials?.secretKey,\n    endpoints: config.endpoints,\n    options: config.options\n  };\n}\n","/**\n * Dubhe Provider - useRef Pattern for Client Management\n *\n * Features:\n * - 🎯 Single client instances across application lifecycle\n * - ⚡ useRef-based storage (no re-initialization on re-renders)\n * - 🔧 Provider pattern for dependency injection\n * - 🛡️ Complete type safety with strict TypeScript\n * - 📦 Context-based client sharing\n */\n\nimport {\n  createContext,\n  useContext,\n  useRef,\n  ReactNode,\n  useState,\n  useCallback,\n  useEffect\n} from 'react';\nimport { Dubhe } from '@0xobelisk/sui-client';\nimport { createDubheGraphqlClient, DubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport { createECSWorld, DubheECSWorld } from '@0xobelisk/ecs';\nimport { DubheGrpcClient } from '@0xobelisk/grpc-client';\nimport { useDubheConfig } from './config';\nimport type { DubheConfig, DubheReturn } from './types';\n\n/**\n * Context interface for Dubhe client instances\n * All clients are stored using useRef to ensure single initialization\n */\ninterface DubheContextValue {\n  getContract: () => Dubhe;\n  getGraphqlClient: () => DubheGraphqlClient;\n  getGrpcClient: () => DubheGrpcClient;\n  getEcsWorld: () => DubheECSWorld;\n  getAddress: () => string;\n  getMetrics: () => {\n    initTime: number;\n    requestCount: number;\n    lastActivity: number;\n  };\n  config: DubheConfig;\n  updateConfig: (newConfig: Partial<DubheConfig>) => void;\n  resetClients: (options?: {\n    resetContract?: boolean;\n    resetGraphql?: boolean;\n    resetGrpc?: boolean;\n    resetEcs?: boolean;\n  }) => void;\n}\n\n/**\n * Context for sharing Dubhe clients across the application\n * Uses useRef pattern to ensure clients are created only once\n */\nconst DubheContext = createContext<DubheContextValue | null>(null);\n\n/**\n * Props interface for DubheProvider component\n */\ninterface DubheProviderProps {\n  /** Configuration for Dubhe initialization */\n  config: Partial<DubheConfig>;\n  /** Child components that will have access to Dubhe clients */\n  children: ReactNode;\n}\n\n/**\n * DubheProvider Component - useRef Pattern Implementation\n *\n * This Provider uses useRef to store client instances, ensuring they are:\n * 1. Created only once during component lifecycle\n * 2. Persisted across re-renders without re-initialization\n * 3. Shared efficiently via React Context\n *\n * Key advantages over useMemo:\n * - useRef guarantees single initialization (useMemo can re-run on dependency changes)\n * - No dependency array needed (eliminates potential re-initialization bugs)\n * - Better performance for heavy client objects\n * - Clearer separation of concerns via Provider pattern\n *\n * @param props - Provider props containing config and children\n * @returns Provider component wrapping children with Dubhe context\n *\n * @example\n * ```typescript\n * // App root setup\n * function App() {\n *   const dubheConfig = {\n *     network: 'devnet',\n *     packageId: '0x123...',\n *     metadata: contractMetadata,\n *     credentials: {\n *       secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *     }\n *   };\n *\n *   return (\n *     <DubheProvider config={dubheConfig}>\n *       <MyApplication />\n *     </DubheProvider>\n *   );\n * }\n * ```\n */\nexport function DubheProvider({ config, children }: DubheProviderProps) {\n  // Use state to manage config for dynamic updates with persistence\n  const [currentConfig, setCurrentConfig] = useState<Partial<DubheConfig>>(() => {\n    // Try to restore config from localStorage\n    if (typeof window !== 'undefined') {\n      try {\n        const saved = localStorage.getItem('dubhe-config');\n        if (saved) {\n          const parsedConfig = JSON.parse(saved);\n          console.log('Restored Dubhe configuration from localStorage');\n          // Important: Explicit config takes precedence over localStorage\n          return { ...parsedConfig, ...config };\n        }\n      } catch (error) {\n        console.warn('Failed to restore Dubhe configuration from localStorage', error);\n      }\n    }\n    return config;\n  });\n\n  // Merge configuration with defaults\n  const finalConfig = useDubheConfig(currentConfig);\n\n  // Track initialization start time (useRef ensures single timestamp)\n  const startTimeRef = useRef<number>(performance.now());\n\n  // useRef for contract instance - guarantees single initialization\n  // Unlike useMemo, useRef.current is never re-calculated\n  const contractRef = useRef<Dubhe | undefined>(undefined);\n  const getContract = (): Dubhe => {\n    if (!contractRef.current) {\n      try {\n        console.log('Initializing Dubhe contract instance (one-time)');\n        contractRef.current = new Dubhe({\n          networkType: finalConfig.network,\n          packageId: finalConfig.packageId,\n          metadata: finalConfig.metadata,\n          secretKey: finalConfig.credentials?.secretKey\n        });\n      } catch (error) {\n        console.error('Contract initialization failed:', error);\n        throw error;\n      }\n    }\n    return contractRef.current;\n  };\n\n  // useRef for GraphQL client instance - single initialization guaranteed\n  const graphqlClientRef = useRef<DubheGraphqlClient | null>(null);\n  const hasInitializedGraphql = useRef(false);\n  const getGraphqlClient = (): DubheGraphqlClient => {\n    if (!hasInitializedGraphql.current) {\n      try {\n        console.log('Initializing GraphQL client instance (one-time)');\n        graphqlClientRef.current = createDubheGraphqlClient({\n          endpoint: finalConfig.endpoints?.graphql || 'http://localhost:4000/graphql',\n          subscriptionEndpoint: finalConfig.endpoints?.websocket || 'ws://localhost:4000/graphql',\n          dubheMetadata: finalConfig.dubheMetadata\n        });\n        hasInitializedGraphql.current = true;\n      } catch (error) {\n        console.error('GraphQL client initialization failed:', error);\n        throw error;\n      }\n    }\n    return graphqlClientRef.current!;\n  };\n\n  // useRef for gRPC client instance - single initialization guaranteed\n  const grpcClientRef = useRef<DubheGrpcClient | null>(null);\n  const hasInitializedGrpc = useRef(false);\n  const getGrpcClient = (): DubheGrpcClient => {\n    if (!hasInitializedGrpc.current) {\n      try {\n        console.log('Initializing gRPC client instance (one-time)');\n        grpcClientRef.current = new DubheGrpcClient({\n          baseUrl: finalConfig.endpoints?.grpc || 'http://localhost:50051'\n        });\n        hasInitializedGrpc.current = true;\n      } catch (error) {\n        console.error('gRPC client initialization failed:', error);\n        throw error;\n      }\n    }\n    return grpcClientRef.current!;\n  };\n\n  // useRef for ECS World instance - depends on GraphQL client\n  const ecsWorldRef = useRef<DubheECSWorld | null>(null);\n  const hasInitializedEcs = useRef(false);\n  const getEcsWorld = (): DubheECSWorld => {\n    const graphqlClient = getGraphqlClient();\n    if (!hasInitializedEcs.current) {\n      try {\n        console.log('Initializing ECS World instance (one-time)');\n        ecsWorldRef.current = createECSWorld(graphqlClient, {\n          dubheMetadata: finalConfig.dubheMetadata,\n          queryConfig: {\n            enableBatchOptimization: finalConfig.options?.enableBatchOptimization ?? true,\n            defaultCacheTimeout: finalConfig.options?.cacheTimeout ?? 5000\n          },\n          subscriptionConfig: {\n            defaultDebounceMs: finalConfig.options?.debounceMs ?? 100,\n            reconnectOnError: finalConfig.options?.reconnectOnError ?? true\n          }\n        });\n        hasInitializedEcs.current = true;\n      } catch (error) {\n        console.error('ECS World initialization failed:', error);\n        throw error;\n      }\n    }\n    return ecsWorldRef.current!;\n  };\n\n  // Address getter - calculated from contract\n  const getAddress = (): string => {\n    return getContract().getAddress();\n  };\n\n  // Metrics getter - performance tracking\n  const getMetrics = () => ({\n    initTime: performance.now() - (startTimeRef.current || 0),\n    requestCount: 0, // Can be enhanced with actual tracking\n    lastActivity: Date.now()\n  });\n\n  // Selective reset client instances\n  const resetClients = useCallback(\n    (options?: {\n      resetContract?: boolean;\n      resetGraphql?: boolean;\n      resetGrpc?: boolean;\n      resetEcs?: boolean;\n    }) => {\n      const opts = {\n        resetContract: true,\n        resetGraphql: true,\n        resetGrpc: true,\n        resetEcs: true,\n        ...options\n      };\n\n      console.log('Resetting Dubhe client instances', opts);\n\n      if (opts.resetContract) {\n        contractRef.current = undefined;\n      }\n      if (opts.resetGraphql) {\n        graphqlClientRef.current = null;\n        hasInitializedGraphql.current = false;\n      }\n      if (opts.resetGrpc) {\n        grpcClientRef.current = null;\n        hasInitializedGrpc.current = false;\n      }\n      if (opts.resetEcs) {\n        ecsWorldRef.current = null;\n        hasInitializedEcs.current = false;\n      }\n\n      startTimeRef.current = performance.now();\n    },\n    []\n  );\n\n  // Update config without resetting clients (reactive update)\n  const updateConfig = useCallback((newConfig: Partial<DubheConfig>) => {\n    console.log('Updating Dubhe configuration (reactive)');\n    setCurrentConfig((prev) => {\n      const updated = { ...prev, ...newConfig };\n      // Persist to localStorage\n      if (typeof window !== 'undefined') {\n        try {\n          localStorage.setItem('dubhe-config', JSON.stringify(updated));\n          console.log('Persisted Dubhe configuration to localStorage');\n        } catch (error) {\n          console.warn('Failed to persist Dubhe configuration', error);\n        }\n      }\n      return updated;\n    });\n  }, []);\n\n  // Reactive configuration updates via useEffect\n\n  // Monitor Contract configuration changes\n  useEffect(() => {\n    if (contractRef.current) {\n      console.log('Contract config dependencies changed, updating...');\n      contractRef.current.updateConfig({\n        networkType: finalConfig.network,\n        packageId: finalConfig.packageId,\n        metadata: finalConfig.metadata,\n        secretKey: finalConfig.credentials?.secretKey,\n        mnemonics: finalConfig.credentials?.mnemonics\n      });\n    }\n  }, [\n    finalConfig.network,\n    finalConfig.packageId,\n    finalConfig.metadata,\n    finalConfig.credentials?.secretKey,\n    finalConfig.credentials?.mnemonics\n  ]);\n\n  // Monitor GraphQL endpoint changes\n  useEffect(() => {\n    if (graphqlClientRef.current) {\n      console.log('GraphQL endpoint dependencies changed, updating...');\n      graphqlClientRef.current.updateConfig({\n        endpoint: finalConfig.endpoints?.graphql,\n        subscriptionEndpoint: finalConfig.endpoints?.websocket\n      });\n      // Reset ECS World when GraphQL endpoints change (needs new connection)\n      ecsWorldRef.current = null;\n      hasInitializedEcs.current = false;\n    }\n  }, [finalConfig.endpoints?.graphql, finalConfig.endpoints?.websocket]);\n\n  // Monitor GraphQL metadata changes\n  useEffect(() => {\n    if (graphqlClientRef.current && finalConfig.dubheMetadata) {\n      console.log('GraphQL metadata changed, updating...');\n      graphqlClientRef.current.updateConfig({\n        dubheMetadata: finalConfig.dubheMetadata\n      });\n      // Note: ECS will handle its own metadata update via its useEffect\n    }\n  }, [finalConfig.dubheMetadata]);\n\n  // Monitor gRPC configuration changes\n  useEffect(() => {\n    if (grpcClientRef.current && finalConfig.endpoints?.grpc) {\n      console.log('gRPC config dependencies changed, updating...');\n      grpcClientRef.current.updateConfig({ baseUrl: finalConfig.endpoints.grpc });\n    }\n  }, [finalConfig.endpoints?.grpc]);\n\n  // Monitor ECS configuration changes\n  useEffect(() => {\n    if (ecsWorldRef.current) {\n      console.log('ECS config dependencies changed, updating...');\n      ecsWorldRef.current.updateConfig({\n        dubheMetadata: finalConfig.dubheMetadata,\n        queryConfig: {\n          enableBatchOptimization: finalConfig.options?.enableBatchOptimization,\n          defaultCacheTimeout: finalConfig.options?.cacheTimeout\n        },\n        subscriptionConfig: {\n          defaultDebounceMs: finalConfig.options?.debounceMs,\n          reconnectOnError: finalConfig.options?.reconnectOnError\n        }\n      });\n    }\n  }, [\n    finalConfig.dubheMetadata,\n    finalConfig.options?.enableBatchOptimization,\n    finalConfig.options?.cacheTimeout,\n    finalConfig.options?.debounceMs,\n    finalConfig.options?.reconnectOnError\n  ]);\n\n  // Context value - stable reference (no re-renders for consumers)\n  const contextValue: DubheContextValue = {\n    getContract,\n    getGraphqlClient,\n    getGrpcClient,\n    getEcsWorld,\n    getAddress,\n    getMetrics,\n    config: finalConfig,\n    updateConfig,\n    resetClients\n  };\n\n  return <DubheContext.Provider value={contextValue}>{children}</DubheContext.Provider>;\n}\n\n/**\n * Custom hook to access Dubhe context\n * Provides type-safe access to all Dubhe client instances\n *\n * @returns DubheContextValue with all client getters and config\n * @throws Error if used outside of DubheProvider\n *\n * @example\n * ```typescript\n * function MyComponent() {\n *   const dubheContext = useDubheContext();\n *\n *   const contract = dubheContext.getContract();\n *   const graphqlClient = dubheContext.getGraphqlClient();\n *   const ecsWorld = dubheContext.getEcsWorld();\n *   const address = dubheContext.getAddress();\n *\n *   return <div>Connected as {address}</div>;\n * }\n * ```\n */\nexport function useDubheContext(): DubheContextValue {\n  const context = useContext(DubheContext);\n\n  if (!context) {\n    throw new Error(\n      'useDubheContext must be used within a DubheProvider. ' +\n        'Make sure to wrap your app with <DubheProvider config={...}>'\n    );\n  }\n\n  return context;\n}\n\n/**\n * Enhanced hook that mimics the original useDubhe API\n * Uses the Provider pattern internally but maintains backward compatibility\n *\n * @returns DubheReturn object with all instances and metadata\n *\n * @example\n * ```typescript\n * function MyComponent() {\n *   const { contract, graphqlClient, ecsWorld, address } = useDubheFromProvider();\n *\n *   const handleTransaction = async () => {\n *     const tx = new Transaction();\n *     await contract.tx.my_system.my_method({ tx });\n *   };\n *\n *   return <button onClick={handleTransaction}>Execute</button>;\n * }\n * ```\n */\nexport function useDubheFromProvider(): DubheReturn {\n  const context = useDubheContext();\n\n  // Get instances (lazy initialization via getters)\n  const contract = context.getContract();\n  const graphqlClient = context.getGraphqlClient();\n  const grpcClient = context.getGrpcClient();\n  const ecsWorld = context.getEcsWorld();\n  const address = context.getAddress();\n  const metrics = context.getMetrics();\n\n  return {\n    contract,\n    graphqlClient,\n    grpcClient,\n    ecsWorld,\n    metadata: context.config.metadata,\n    network: context.config.network,\n    packageId: context.config.packageId,\n    dubheSchemaId: context.config.dubheSchemaId,\n    address,\n    options: context.config.options,\n    metrics\n  };\n}\n\n/**\n * Individual client hooks for components that only need specific instances\n * These are more efficient than useDubheFromProvider for single-client usage\n */\n\n/**\n * Hook for accessing only the Dubhe contract instance\n */\nexport function useDubheContractFromProvider(): Dubhe {\n  const { contract } = useDubheFromProvider();\n  return contract;\n}\n\n/**\n * Hook for accessing only the GraphQL client instance\n */\nexport function useDubheGraphQLFromProvider(): DubheGraphqlClient {\n  const { getGraphqlClient } = useDubheContext();\n  return getGraphqlClient();\n}\n\n/**\n * Hook for accessing only the ECS World instance\n */\nexport function useDubheECSFromProvider(): DubheECSWorld {\n  const { getEcsWorld } = useDubheContext();\n  return getEcsWorld();\n}\n\n/**\n * Hook for accessing only the gRPC client instance\n */\nexport function useDubheGrpcFromProvider(): DubheGrpcClient {\n  const { getGrpcClient } = useDubheContext();\n  return getGrpcClient();\n}\n\n/**\n * Hook for accessing configuration update methods\n *\n * @returns Object with updateConfig and resetClients methods\n *\n * @example\n * ```typescript\n * function ConfigUpdater() {\n *   const { updateConfig, resetClients, config } = useDubheConfigUpdate();\n *\n *   const switchNetwork = () => {\n *     updateConfig({\n *       network: 'testnet',\n *       packageId: '0xnew...'\n *     });\n *   };\n *\n *   return (\n *     <div>\n *       <p>Current network: {config.network}</p>\n *       <button onClick={switchNetwork}>Switch to Testnet</button>\n *       <button onClick={resetClients}>Reset Clients</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDubheConfigUpdate() {\n  const { updateConfig, resetClients, config } = useDubheContext();\n  return { updateConfig, resetClients, config };\n}\n","/**\n * Modern Dubhe React Hooks - Provider Pattern\n *\n * Features:\n * - 🎯 Simple API design with Provider pattern\n * - ⚡ Single client initialization with useRef\n * - 🔧 Configuration-driven setup (developers handle environment variables themselves)\n * - 🛡️ Complete type safety with strict TypeScript\n * - 📦 Context-based client sharing across components\n */\nimport { Dubhe } from '@0xobelisk/sui-client';\nimport type { DubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport type { DubheECSWorld } from '@0xobelisk/ecs';\n\nimport {\n  useDubheFromProvider,\n  useDubheContractFromProvider,\n  useDubheGraphQLFromProvider,\n  useDubheECSFromProvider,\n  useDubheConfigUpdate as useDubheConfigUpdateFromProvider\n} from './provider';\nimport type { DubheReturn } from './types';\n\n/**\n * Primary Hook: useDubhe\n *\n * Uses Provider pattern to access shared Dubhe clients with guaranteed single initialization.\n * Must be used within a DubheProvider.\n *\n * @returns Complete Dubhe ecosystem with contract, GraphQL, ECS, and metadata\n *\n * @example\n * ```typescript\n * // App setup with Provider\n * function App() {\n *   const config = {\n *     network: 'devnet',\n *     packageId: '0x123...',\n *     metadata: contractMetadata,\n *     credentials: {\n *       secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *     }\n *   };\n *\n *   return (\n *     <DubheProvider config={config}>\n *       <MyDApp />\n *     </DubheProvider>\n *   );\n * }\n *\n * // Component usage\n * function MyDApp() {\n *   const { contract, address } = useDubhe();\n *   return <div>Connected as {address}</div>;\n * }\n * ```\n */\nexport function useDubhe(): DubheReturn {\n  return useDubheFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheContract\n *\n * Returns only the Dubhe contract instance from Provider context.\n * More efficient than useDubhe() when only contract access is needed.\n *\n * @returns Dubhe contract instance\n *\n * @example\n * ```typescript\n * function TransactionComponent() {\n *   const contract = useDubheContract();\n *\n *   const handleTransaction = async () => {\n *     const tx = new Transaction();\n *     await contract.tx.my_system.my_method({ tx });\n *   };\n *\n *   return <button onClick={handleTransaction}>Execute</button>;\n * }\n * ```\n */\nexport function useDubheContract(): Dubhe {\n  return useDubheContractFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheGraphQL\n *\n * Returns only the GraphQL client from Provider context.\n * More efficient than useDubhe() when only GraphQL access is needed.\n *\n * @returns GraphQL client instance (always available with default localhost endpoint)\n *\n * @example\n * ```typescript\n * function DataComponent() {\n *   const graphqlClient = useDubheGraphQL();\n *\n *   useEffect(() => {\n *     graphqlClient.query({ ... }).then(setData);\n *   }, [graphqlClient]);\n *\n *   return <div>{data && JSON.stringify(data)}</div>;\n * }\n * ```\n */\nexport function useDubheGraphQL(): DubheGraphqlClient {\n  return useDubheGraphQLFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheECS\n *\n * Returns only the ECS World instance from Provider context.\n * More efficient than useDubhe() when only ECS access is needed.\n *\n * @returns ECS World instance (always available, depends on GraphQL client)\n *\n * @example\n * ```typescript\n * function ECSComponent() {\n *   const ecsWorld = useDubheECS();\n *\n *   useEffect(() => {\n *     ecsWorld.getComponent('MyComponent').then(setComponent);\n *   }, [ecsWorld]);\n *\n *   return <div>ECS Component Data</div>;\n * }\n * ```\n */\nexport function useDubheECS(): DubheECSWorld {\n  return useDubheECSFromProvider();\n}\n\n/**\n * Hook for dynamic configuration updates\n *\n * Provides methods to update provider configuration at runtime\n *\n * @returns Object with updateConfig, resetClients methods and current config\n *\n * @example\n * ```typescript\n * function NetworkSwitcher() {\n *   const { updateConfig, config } = useDubheConfigUpdate();\n *\n *   const switchToTestnet = () => {\n *     updateConfig({\n *       network: 'testnet',\n *       packageId: '0xTestnetPackageId...'\n *     });\n *   };\n *\n *   return (\n *     <div>\n *       <p>Network: {config.network}</p>\n *       <button onClick={switchToTestnet}>Switch to Testnet</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDubheConfigUpdate() {\n  return useDubheConfigUpdateFromProvider();\n}\n\n/**\n * Compatibility alias for useDubhe\n */\nexport const useContract = useDubhe;\n"],"mappings":"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","names":["useDubheConfigUpdate","import_react","useDubheConfigUpdate"]}
+{"version":3,"sources":["../src/index.ts","../src/sui/config.ts","../src/sui/utils.ts","../src/sui/provider.tsx","../src/sui/hooks.ts"],"sourcesContent":["/**\n * @0xobelisk/react - Modern Dubhe React Integration\n *\n * 🚀 Provides simple, powerful React experience for multi-chain blockchain development\n *\n * Currently supported:\n * - Sui blockchain ✅\n * - Aptos blockchain (coming soon)\n * - Initia blockchain (coming soon)\n */\n\n// Sui integration\nexport * from './sui/index';\n// TODO: Future extensions\n// export * from './aptos/index';\n// export * from './initia/index';\n","/**\n * Configuration Management for Dubhe React Integration\n *\n * Features:\n * - Type-safe configuration interface\n * - Configuration validation and error handling\n * - Smart merging of defaults and explicit config\n * - No environment variable handling (developers should handle environment variables themselves)\n */\n\nimport { useMemo } from 'react';\nimport type { DubheConfig } from './types';\nimport { mergeConfigurations, validateConfig } from './utils';\n\n/**\n * Default configuration object with sensible defaults\n */\nexport const DEFAULT_CONFIG: Partial<DubheConfig> = {\n  endpoints: {\n    graphql: 'http://localhost:4000/graphql',\n    websocket: 'ws://localhost:4000/graphql'\n  },\n  options: {\n    enableBatchOptimization: true,\n    cacheTimeout: 5000,\n    debounceMs: 100,\n    reconnectOnError: true\n  }\n};\n\n/**\n * Configuration Hook: useDubheConfig\n *\n * Merges defaults with explicit configuration provided by the developer\n *\n * Note: Environment variables should be handled by the developer before passing to this hook\n *\n * @param config - Complete or partial configuration object\n * @returns Complete, validated DubheConfig\n *\n * @example\n * ```typescript\n * // Basic usage with explicit config\n * const config = useDubheConfig({\n *   network: 'testnet',\n *   packageId: '0x123...',\n *   metadata: contractMetadata,\n *   credentials: {\n *     secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY // Handle env vars yourself\n *   }\n * });\n *\n * // With helper function to handle environment variables\n * const getConfigFromEnv = () => ({\n *   network: process.env.NEXT_PUBLIC_NETWORK as NetworkType,\n *   packageId: process.env.NEXT_PUBLIC_PACKAGE_ID,\n *   credentials: {\n *     secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *   }\n * });\n *\n * const config = useDubheConfig({\n *   ...getConfigFromEnv(),\n *   metadata: contractMetadata\n * });\n * ```\n */\nexport function useDubheConfig(config: Partial<DubheConfig>): DubheConfig {\n  // Memoize the stringified config to detect actual changes\n  const configKey = useMemo(() => {\n    return JSON.stringify(config);\n  }, [config]);\n\n  return useMemo(() => {\n    // Merge configurations: defaults -> user provided config\n    const mergedConfig = mergeConfigurations(DEFAULT_CONFIG, config);\n\n    // Validate the final configuration\n    const validatedConfig = validateConfig(mergedConfig);\n\n    // if (process.env.NODE_ENV === 'development') {\n    //   console.log('🔧 Dubhe Config:', {\n    //     ...validatedConfig,\n    //     credentials: validatedConfig.credentials?.secretKey ? '[REDACTED]' : undefined\n    //   });\n    // }\n\n    return validatedConfig;\n  }, [configKey]);\n}\n","/**\n * Utility Functions for Dubhe Configuration Management\n *\n * Features:\n * - Configuration validation and error handling\n * - Smart configuration merging with proper type safety\n * - Type-safe configuration validation\n */\n\nimport type { DubheConfig } from './types';\n\n/**\n * Merge multiple configuration objects with proper deep merging\n * Later configurations override earlier ones\n *\n * @param baseConfig - Base configuration (usually defaults)\n * @param overrideConfig - Override configuration (user provided)\n * @returns Merged configuration\n */\nexport function mergeConfigurations(\n  baseConfig: Partial<DubheConfig>,\n  overrideConfig?: Partial<DubheConfig>\n): Partial<DubheConfig> {\n  if (!overrideConfig) {\n    return { ...baseConfig };\n  }\n\n  const result: Partial<DubheConfig> = { ...baseConfig };\n\n  // Merge top-level properties\n  Object.assign(result, overrideConfig);\n\n  // Deep merge nested objects\n  if (overrideConfig.credentials || baseConfig.credentials) {\n    result.credentials = {\n      ...baseConfig.credentials,\n      ...overrideConfig.credentials\n    };\n  }\n\n  if (overrideConfig.endpoints || baseConfig.endpoints) {\n    result.endpoints = {\n      ...baseConfig.endpoints,\n      ...overrideConfig.endpoints\n    };\n  }\n\n  if (overrideConfig.options || baseConfig.options) {\n    result.options = {\n      ...baseConfig.options,\n      ...overrideConfig.options\n    };\n  }\n\n  return result;\n}\n\n/**\n * Validate configuration and ensure required fields are present\n * Throws descriptive errors for missing required fields\n *\n * @param config - Configuration to validate\n * @returns Validated and typed configuration\n * @throws Error if required fields are missing or invalid\n */\nexport function validateConfig(config: Partial<DubheConfig>): DubheConfig {\n  const errors: string[] = [];\n\n  // Check required fields\n  if (!config.network) {\n    errors.push('network is required');\n  }\n\n  if (!config.packageId) {\n    errors.push('packageId is required');\n  }\n\n  if (!config.metadata) {\n    errors.push('metadata is required');\n  } else {\n    // Basic metadata validation\n    if (typeof config.metadata !== 'object') {\n      errors.push('metadata must be an object');\n    } else if (Object.keys(config.metadata).length === 0) {\n      errors.push('metadata cannot be empty');\n    }\n  }\n\n  // Validate network type\n  if (config.network && !['mainnet', 'testnet', 'devnet', 'localnet'].includes(config.network)) {\n    errors.push(\n      `invalid network: ${config.network}. Must be one of: mainnet, testnet, devnet, localnet`\n    );\n  }\n\n  // Validate package ID format (enhanced check)\n  if (config.packageId) {\n    if (!config.packageId.startsWith('0x')) {\n      errors.push('packageId must start with 0x');\n    } else if (config.packageId.length < 3) {\n      errors.push('packageId must be longer than 0x');\n    } else if (!/^0x[a-fA-F0-9]+$/.test(config.packageId)) {\n      errors.push('packageId must contain only hexadecimal characters after 0x');\n    }\n  }\n\n  // Validate dubheMetadata if provided\n  if (config.dubheMetadata !== undefined) {\n    if (typeof config.dubheMetadata !== 'object' || config.dubheMetadata === null) {\n      errors.push('dubheMetadata must be an object');\n    } else if (!config.dubheMetadata.components && !config.dubheMetadata.resources) {\n      errors.push('dubheMetadata must contain components or resources');\n    }\n  }\n\n  // Validate credentials if provided\n  if (config.credentials) {\n    if (config.credentials.secretKey && typeof config.credentials.secretKey !== 'string') {\n      errors.push('credentials.secretKey must be a string');\n    }\n    if (config.credentials.mnemonics && typeof config.credentials.mnemonics !== 'string') {\n      errors.push('credentials.mnemonics must be a string');\n    }\n  }\n\n  // Validate URLs if provided\n  if (config.endpoints?.graphql && !isValidUrl(config.endpoints.graphql)) {\n    errors.push('endpoints.graphql must be a valid URL');\n  }\n\n  if (config.endpoints?.websocket && !isValidUrl(config.endpoints.websocket)) {\n    errors.push('endpoints.websocket must be a valid URL');\n  }\n\n  if (config.endpoints?.grpc && !isValidUrl(config.endpoints.grpc)) {\n    errors.push('endpoints.grpc must be a valid URL');\n  }\n\n  // Validate fullnodeUrls if provided\n  if (config.endpoints?.fullnodeUrls) {\n    if (!Array.isArray(config.endpoints.fullnodeUrls)) {\n      errors.push('endpoints.fullnodeUrls must be an array');\n    } else if (config.endpoints.fullnodeUrls.length === 0) {\n      errors.push('endpoints.fullnodeUrls cannot be empty if provided');\n    } else {\n      config.endpoints.fullnodeUrls.forEach((url, index) => {\n        if (!isValidUrl(url)) {\n          errors.push(`endpoints.fullnodeUrls[${index}] must be a valid URL: ${url}`);\n        }\n      });\n    }\n  }\n\n  // Validate numeric options\n  if (\n    config.options?.cacheTimeout !== undefined &&\n    (typeof config.options.cacheTimeout !== 'number' || config.options.cacheTimeout < 0)\n  ) {\n    errors.push('options.cacheTimeout must be a non-negative number');\n  }\n\n  if (\n    config.options?.debounceMs !== undefined &&\n    (typeof config.options.debounceMs !== 'number' || config.options.debounceMs < 0)\n  ) {\n    errors.push('options.debounceMs must be a non-negative number');\n  }\n\n  if (errors.length > 0) {\n    const errorMessage = `Invalid Dubhe configuration (${errors.length} error${\n      errors.length > 1 ? 's' : ''\n    }):\\n${errors.map((e) => `- ${e}`).join('\\n')}`;\n    console.error('Configuration validation failed:', { errors, config });\n    throw new Error(errorMessage);\n  }\n\n  return config as DubheConfig;\n}\n\n/**\n * Simple URL validation helper\n *\n * @param url - URL string to validate\n * @returns true if URL is valid, false otherwise\n */\nfunction isValidUrl(url: string): boolean {\n  try {\n    new URL(url);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Generate a configuration summary for debugging\n * Hides sensitive information like private keys\n *\n * @param config - Configuration to summarize\n * @returns Safe configuration summary\n */\nexport function getConfigSummary(config: DubheConfig): object {\n  return {\n    network: config.network,\n    packageId: config.packageId,\n    dubheSchemaId: config.dubheSchemaId,\n    hasMetadata: !!config.metadata,\n    hasDubheMetadata: !!config.dubheMetadata,\n    hasCredentials: !!config.credentials?.secretKey,\n    endpoints: config.endpoints,\n    options: config.options\n  };\n}\n","/**\n * Dubhe Provider - useRef Pattern for Client Management\n *\n * Features:\n * - 🎯 Single client instances across application lifecycle\n * - ⚡ useRef-based storage (no re-initialization on re-renders)\n * - 🔧 Provider pattern for dependency injection\n * - 🛡️ Complete type safety with strict TypeScript\n * - 📦 Context-based client sharing\n */\n\nimport {\n  createContext,\n  useContext,\n  useRef,\n  ReactNode,\n  useState,\n  useCallback,\n  useEffect\n} from 'react';\nimport { Dubhe } from '@0xobelisk/sui-client';\nimport { createDubheGraphqlClient, DubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport { createECSWorld, DubheECSWorld } from '@0xobelisk/ecs';\nimport { DubheGrpcClient } from '@0xobelisk/grpc-client';\nimport { useDubheConfig } from './config';\nimport type { DubheConfig, DubheReturn } from './types';\n\n/**\n * Context interface for Dubhe client instances\n * All clients are stored using useRef to ensure single initialization\n */\ninterface DubheContextValue {\n  getContract: () => Dubhe;\n  getGraphqlClient: () => DubheGraphqlClient;\n  getGrpcClient: () => DubheGrpcClient;\n  getEcsWorld: () => DubheECSWorld;\n  getAddress: () => string;\n  getMetrics: () => {\n    initTime: number;\n    requestCount: number;\n    lastActivity: number;\n  };\n  config: DubheConfig;\n  updateConfig: (newConfig: Partial<DubheConfig>) => void;\n  resetClients: (options?: {\n    resetContract?: boolean;\n    resetGraphql?: boolean;\n    resetGrpc?: boolean;\n    resetEcs?: boolean;\n  }) => void;\n}\n\n/**\n * Context for sharing Dubhe clients across the application\n * Uses useRef pattern to ensure clients are created only once\n */\nconst DubheContext = createContext<DubheContextValue | null>(null);\n\n/**\n * Props interface for DubheProvider component\n */\ninterface DubheProviderProps {\n  /** Configuration for Dubhe initialization */\n  config: Partial<DubheConfig>;\n  /** Child components that will have access to Dubhe clients */\n  children: ReactNode;\n}\n\n/**\n * DubheProvider Component - useRef Pattern Implementation\n *\n * This Provider uses useRef to store client instances, ensuring they are:\n * 1. Created only once during component lifecycle\n * 2. Persisted across re-renders without re-initialization\n * 3. Shared efficiently via React Context\n *\n * Key advantages over useMemo:\n * - useRef guarantees single initialization (useMemo can re-run on dependency changes)\n * - No dependency array needed (eliminates potential re-initialization bugs)\n * - Better performance for heavy client objects\n * - Clearer separation of concerns via Provider pattern\n *\n * @param props - Provider props containing config and children\n * @returns Provider component wrapping children with Dubhe context\n *\n * @example\n * ```typescript\n * // App root setup\n * function App() {\n *   const dubheConfig = {\n *     network: 'devnet',\n *     packageId: '0x123...',\n *     metadata: contractMetadata,\n *     credentials: {\n *       secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *     }\n *   };\n *\n *   return (\n *     <DubheProvider config={dubheConfig}>\n *       <MyApplication />\n *     </DubheProvider>\n *   );\n * }\n * ```\n */\nexport function DubheProvider({ config, children }: DubheProviderProps) {\n  // Use state to manage config for dynamic updates with persistence\n  const [currentConfig, setCurrentConfig] = useState<Partial<DubheConfig>>(() => {\n    // Try to restore config from localStorage\n    if (typeof window !== 'undefined') {\n      try {\n        const saved = localStorage.getItem('dubhe-config');\n        if (saved) {\n          const parsedConfig = JSON.parse(saved);\n          console.log('Restored Dubhe configuration from localStorage');\n          // Important: Explicit config takes precedence over localStorage\n          return { ...parsedConfig, ...config };\n        }\n      } catch (error) {\n        console.warn('Failed to restore Dubhe configuration from localStorage', error);\n      }\n    }\n    return config;\n  });\n\n  // Merge configuration with defaults\n  const finalConfig = useDubheConfig(currentConfig);\n\n  // Track initialization start time (useRef ensures single timestamp)\n  const startTimeRef = useRef<number>(performance.now());\n\n  // useRef for contract instance - guarantees single initialization\n  // Unlike useMemo, useRef.current is never re-calculated\n  const contractRef = useRef<Dubhe | undefined>(undefined);\n  const getContract = (): Dubhe => {\n    if (!contractRef.current) {\n      try {\n        console.log('Initializing Dubhe contract instance (one-time)');\n        contractRef.current = new Dubhe({\n          networkType: finalConfig.network,\n          packageId: finalConfig.packageId,\n          metadata: finalConfig.metadata,\n          secretKey: finalConfig.credentials?.secretKey,\n          mnemonics: finalConfig.credentials?.mnemonics,\n          fullnodeUrls: finalConfig.endpoints?.fullnodeUrls\n        });\n      } catch (error) {\n        console.error('Contract initialization failed:', error);\n        throw error;\n      }\n    }\n    return contractRef.current;\n  };\n\n  // useRef for GraphQL client instance - single initialization guaranteed\n  const graphqlClientRef = useRef<DubheGraphqlClient | null>(null);\n  const hasInitializedGraphql = useRef(false);\n  const getGraphqlClient = (): DubheGraphqlClient => {\n    if (!hasInitializedGraphql.current) {\n      try {\n        console.log('Initializing GraphQL client instance (one-time)');\n        graphqlClientRef.current = createDubheGraphqlClient({\n          endpoint: finalConfig.endpoints?.graphql || 'http://localhost:4000/graphql',\n          subscriptionEndpoint: finalConfig.endpoints?.websocket || 'ws://localhost:4000/graphql',\n          dubheMetadata: finalConfig.dubheMetadata\n        });\n        hasInitializedGraphql.current = true;\n      } catch (error) {\n        console.error('GraphQL client initialization failed:', error);\n        throw error;\n      }\n    }\n    return graphqlClientRef.current!;\n  };\n\n  // useRef for gRPC client instance - single initialization guaranteed\n  const grpcClientRef = useRef<DubheGrpcClient | null>(null);\n  const hasInitializedGrpc = useRef(false);\n  const getGrpcClient = (): DubheGrpcClient => {\n    if (!hasInitializedGrpc.current) {\n      try {\n        console.log('Initializing gRPC client instance (one-time)');\n        grpcClientRef.current = new DubheGrpcClient({\n          baseUrl: finalConfig.endpoints?.grpc || 'http://localhost:8080'\n        });\n        hasInitializedGrpc.current = true;\n      } catch (error) {\n        console.error('gRPC client initialization failed:', error);\n        throw error;\n      }\n    }\n    return grpcClientRef.current!;\n  };\n\n  // useRef for ECS World instance - depends on GraphQL client\n  const ecsWorldRef = useRef<DubheECSWorld | null>(null);\n  const hasInitializedEcs = useRef(false);\n  const getEcsWorld = (): DubheECSWorld => {\n    const graphqlClient = getGraphqlClient();\n    if (!hasInitializedEcs.current) {\n      try {\n        console.log('Initializing ECS World instance (one-time)');\n        ecsWorldRef.current = createECSWorld(graphqlClient, {\n          dubheMetadata: finalConfig.dubheMetadata,\n          queryConfig: {\n            enableBatchOptimization: finalConfig.options?.enableBatchOptimization ?? true,\n            defaultCacheTimeout: finalConfig.options?.cacheTimeout ?? 5000\n          },\n          subscriptionConfig: {\n            defaultDebounceMs: finalConfig.options?.debounceMs ?? 100,\n            reconnectOnError: finalConfig.options?.reconnectOnError ?? true\n          }\n        });\n        hasInitializedEcs.current = true;\n      } catch (error) {\n        console.error('ECS World initialization failed:', error);\n        throw error;\n      }\n    }\n    return ecsWorldRef.current!;\n  };\n\n  // Address getter - calculated from contract\n  const getAddress = (): string => {\n    return getContract().getAddress();\n  };\n\n  // Metrics getter - performance tracking\n  const getMetrics = () => ({\n    initTime: performance.now() - (startTimeRef.current || 0),\n    requestCount: 0, // Can be enhanced with actual tracking\n    lastActivity: Date.now()\n  });\n\n  // Selective reset client instances\n  const resetClients = useCallback(\n    (options?: {\n      resetContract?: boolean;\n      resetGraphql?: boolean;\n      resetGrpc?: boolean;\n      resetEcs?: boolean;\n    }) => {\n      const opts = {\n        resetContract: true,\n        resetGraphql: true,\n        resetGrpc: true,\n        resetEcs: true,\n        ...options\n      };\n\n      console.log('Resetting Dubhe client instances', opts);\n\n      if (opts.resetContract) {\n        contractRef.current = undefined;\n      }\n      if (opts.resetGraphql) {\n        graphqlClientRef.current = null;\n        hasInitializedGraphql.current = false;\n      }\n      if (opts.resetGrpc) {\n        grpcClientRef.current = null;\n        hasInitializedGrpc.current = false;\n      }\n      if (opts.resetEcs) {\n        ecsWorldRef.current = null;\n        hasInitializedEcs.current = false;\n      }\n\n      startTimeRef.current = performance.now();\n    },\n    []\n  );\n\n  // Update config without resetting clients (reactive update)\n  const updateConfig = useCallback((newConfig: Partial<DubheConfig>) => {\n    console.log('Updating Dubhe configuration (reactive)');\n    setCurrentConfig((prev) => {\n      const updated = { ...prev, ...newConfig };\n      // Persist to localStorage\n      if (typeof window !== 'undefined') {\n        try {\n          localStorage.setItem('dubhe-config', JSON.stringify(updated));\n          console.log('Persisted Dubhe configuration to localStorage');\n        } catch (error) {\n          console.warn('Failed to persist Dubhe configuration', error);\n        }\n      }\n      return updated;\n    });\n  }, []);\n\n  // Reactive configuration updates via useEffect\n\n  // Monitor Contract configuration changes\n  useEffect(() => {\n    if (contractRef.current) {\n      console.log('Contract config dependencies changed, updating...');\n      contractRef.current.updateConfig({\n        networkType: finalConfig.network,\n        packageId: finalConfig.packageId,\n        metadata: finalConfig.metadata,\n        secretKey: finalConfig.credentials?.secretKey,\n        mnemonics: finalConfig.credentials?.mnemonics,\n        fullnodeUrls: finalConfig.endpoints?.fullnodeUrls\n      });\n    }\n  }, [\n    finalConfig.network,\n    finalConfig.packageId,\n    finalConfig.metadata,\n    finalConfig.credentials?.secretKey,\n    finalConfig.credentials?.mnemonics,\n    finalConfig.endpoints?.fullnodeUrls\n  ]);\n\n  // Monitor GraphQL endpoint changes\n  useEffect(() => {\n    if (graphqlClientRef.current) {\n      console.log('GraphQL endpoint dependencies changed, updating...');\n      graphqlClientRef.current.updateConfig({\n        endpoint: finalConfig.endpoints?.graphql,\n        subscriptionEndpoint: finalConfig.endpoints?.websocket\n      });\n      // Reset ECS World when GraphQL endpoints change (needs new connection)\n      ecsWorldRef.current = null;\n      hasInitializedEcs.current = false;\n    }\n  }, [finalConfig.endpoints?.graphql, finalConfig.endpoints?.websocket]);\n\n  // Monitor GraphQL metadata changes\n  useEffect(() => {\n    if (graphqlClientRef.current && finalConfig.dubheMetadata) {\n      console.log('GraphQL metadata changed, updating...');\n      graphqlClientRef.current.updateConfig({\n        dubheMetadata: finalConfig.dubheMetadata\n      });\n      // Note: ECS will handle its own metadata update via its useEffect\n    }\n  }, [finalConfig.dubheMetadata]);\n\n  // Monitor gRPC configuration changes\n  useEffect(() => {\n    if (grpcClientRef.current && finalConfig.endpoints?.grpc) {\n      console.log('gRPC config dependencies changed, updating...');\n      grpcClientRef.current.updateConfig({ baseUrl: finalConfig.endpoints.grpc });\n    }\n  }, [finalConfig.endpoints?.grpc]);\n\n  // Monitor ECS configuration changes\n  useEffect(() => {\n    if (ecsWorldRef.current) {\n      console.log('ECS config dependencies changed, updating...');\n      ecsWorldRef.current.updateConfig({\n        dubheMetadata: finalConfig.dubheMetadata,\n        queryConfig: {\n          enableBatchOptimization: finalConfig.options?.enableBatchOptimization,\n          defaultCacheTimeout: finalConfig.options?.cacheTimeout\n        },\n        subscriptionConfig: {\n          defaultDebounceMs: finalConfig.options?.debounceMs,\n          reconnectOnError: finalConfig.options?.reconnectOnError\n        }\n      });\n    }\n  }, [\n    finalConfig.dubheMetadata,\n    finalConfig.options?.enableBatchOptimization,\n    finalConfig.options?.cacheTimeout,\n    finalConfig.options?.debounceMs,\n    finalConfig.options?.reconnectOnError\n  ]);\n\n  // Context value - stable reference (no re-renders for consumers)\n  const contextValue: DubheContextValue = {\n    getContract,\n    getGraphqlClient,\n    getGrpcClient,\n    getEcsWorld,\n    getAddress,\n    getMetrics,\n    config: finalConfig,\n    updateConfig,\n    resetClients\n  };\n\n  return <DubheContext.Provider value={contextValue}>{children}</DubheContext.Provider>;\n}\n\n/**\n * Custom hook to access Dubhe context\n * Provides type-safe access to all Dubhe client instances\n *\n * @returns DubheContextValue with all client getters and config\n * @throws Error if used outside of DubheProvider\n *\n * @example\n * ```typescript\n * function MyComponent() {\n *   const dubheContext = useDubheContext();\n *\n *   const contract = dubheContext.getContract();\n *   const graphqlClient = dubheContext.getGraphqlClient();\n *   const ecsWorld = dubheContext.getEcsWorld();\n *   const address = dubheContext.getAddress();\n *\n *   return <div>Connected as {address}</div>;\n * }\n * ```\n */\nexport function useDubheContext(): DubheContextValue {\n  const context = useContext(DubheContext);\n\n  if (!context) {\n    throw new Error(\n      'useDubheContext must be used within a DubheProvider. ' +\n        'Make sure to wrap your app with <DubheProvider config={...}>'\n    );\n  }\n\n  return context;\n}\n\n/**\n * Enhanced hook that mimics the original useDubhe API\n * Uses the Provider pattern internally but maintains backward compatibility\n *\n * @returns DubheReturn object with all instances and metadata\n *\n * @example\n * ```typescript\n * function MyComponent() {\n *   const { contract, graphqlClient, ecsWorld, address } = useDubheFromProvider();\n *\n *   const handleTransaction = async () => {\n *     const tx = new Transaction();\n *     await contract.tx.my_system.my_method({ tx });\n *   };\n *\n *   return <button onClick={handleTransaction}>Execute</button>;\n * }\n * ```\n */\nexport function useDubheFromProvider(): DubheReturn {\n  const context = useDubheContext();\n\n  // Get instances (lazy initialization via getters)\n  const contract = context.getContract();\n  const graphqlClient = context.getGraphqlClient();\n  const grpcClient = context.getGrpcClient();\n  const ecsWorld = context.getEcsWorld();\n  const address = context.getAddress();\n  const metrics = context.getMetrics();\n\n  return {\n    contract,\n    graphqlClient,\n    grpcClient,\n    ecsWorld,\n    metadata: context.config.metadata,\n    network: context.config.network,\n    packageId: context.config.packageId,\n    dubheSchemaId: context.config.dubheSchemaId,\n    address,\n    options: context.config.options,\n    metrics\n  };\n}\n\n/**\n * Individual client hooks for components that only need specific instances\n * These are more efficient than useDubheFromProvider for single-client usage\n */\n\n/**\n * Hook for accessing only the Dubhe contract instance\n */\nexport function useDubheContractFromProvider(): Dubhe {\n  const { contract } = useDubheFromProvider();\n  return contract;\n}\n\n/**\n * Hook for accessing only the GraphQL client instance\n */\nexport function useDubheGraphQLFromProvider(): DubheGraphqlClient {\n  const { getGraphqlClient } = useDubheContext();\n  return getGraphqlClient();\n}\n\n/**\n * Hook for accessing only the ECS World instance\n */\nexport function useDubheECSFromProvider(): DubheECSWorld {\n  const { getEcsWorld } = useDubheContext();\n  return getEcsWorld();\n}\n\n/**\n * Hook for accessing only the gRPC client instance\n */\nexport function useDubheGrpcFromProvider(): DubheGrpcClient {\n  const { getGrpcClient } = useDubheContext();\n  return getGrpcClient();\n}\n\n/**\n * Hook for accessing configuration update methods\n *\n * @returns Object with updateConfig and resetClients methods\n *\n * @example\n * ```typescript\n * function ConfigUpdater() {\n *   const { updateConfig, resetClients, config } = useDubheConfigUpdate();\n *\n *   const switchNetwork = () => {\n *     updateConfig({\n *       network: 'testnet',\n *       packageId: '0xnew...'\n *     });\n *   };\n *\n *   return (\n *     <div>\n *       <p>Current network: {config.network}</p>\n *       <button onClick={switchNetwork}>Switch to Testnet</button>\n *       <button onClick={resetClients}>Reset Clients</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDubheConfigUpdate() {\n  const { updateConfig, resetClients, config } = useDubheContext();\n  return { updateConfig, resetClients, config };\n}\n","/**\n * Modern Dubhe React Hooks - Provider Pattern\n *\n * Features:\n * - 🎯 Simple API design with Provider pattern\n * - ⚡ Single client initialization with useRef\n * - 🔧 Configuration-driven setup (developers handle environment variables themselves)\n * - 🛡️ Complete type safety with strict TypeScript\n * - 📦 Context-based client sharing across components\n */\nimport { Dubhe } from '@0xobelisk/sui-client';\nimport type { DubheGraphqlClient } from '@0xobelisk/graphql-client';\nimport type { DubheECSWorld } from '@0xobelisk/ecs';\n\nimport {\n  useDubheFromProvider,\n  useDubheContractFromProvider,\n  useDubheGraphQLFromProvider,\n  useDubheECSFromProvider,\n  useDubheConfigUpdate as useDubheConfigUpdateFromProvider\n} from './provider';\nimport type { DubheReturn } from './types';\n\n/**\n * Primary Hook: useDubhe\n *\n * Uses Provider pattern to access shared Dubhe clients with guaranteed single initialization.\n * Must be used within a DubheProvider.\n *\n * @returns Complete Dubhe ecosystem with contract, GraphQL, ECS, and metadata\n *\n * @example\n * ```typescript\n * // App setup with Provider\n * function App() {\n *   const config = {\n *     network: 'devnet',\n *     packageId: '0x123...',\n *     metadata: contractMetadata,\n *     credentials: {\n *       secretKey: process.env.NEXT_PUBLIC_PRIVATE_KEY\n *     }\n *   };\n *\n *   return (\n *     <DubheProvider config={config}>\n *       <MyDApp />\n *     </DubheProvider>\n *   );\n * }\n *\n * // Component usage\n * function MyDApp() {\n *   const { contract, address } = useDubhe();\n *   return <div>Connected as {address}</div>;\n * }\n * ```\n */\nexport function useDubhe(): DubheReturn {\n  return useDubheFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheContract\n *\n * Returns only the Dubhe contract instance from Provider context.\n * More efficient than useDubhe() when only contract access is needed.\n *\n * @returns Dubhe contract instance\n *\n * @example\n * ```typescript\n * function TransactionComponent() {\n *   const contract = useDubheContract();\n *\n *   const handleTransaction = async () => {\n *     const tx = new Transaction();\n *     await contract.tx.my_system.my_method({ tx });\n *   };\n *\n *   return <button onClick={handleTransaction}>Execute</button>;\n * }\n * ```\n */\nexport function useDubheContract(): Dubhe {\n  return useDubheContractFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheGraphQL\n *\n * Returns only the GraphQL client from Provider context.\n * More efficient than useDubhe() when only GraphQL access is needed.\n *\n * @returns GraphQL client instance (always available with default localhost endpoint)\n *\n * @example\n * ```typescript\n * function DataComponent() {\n *   const graphqlClient = useDubheGraphQL();\n *\n *   useEffect(() => {\n *     graphqlClient.query({ ... }).then(setData);\n *   }, [graphqlClient]);\n *\n *   return <div>{data && JSON.stringify(data)}</div>;\n * }\n * ```\n */\nexport function useDubheGraphQL(): DubheGraphqlClient {\n  return useDubheGraphQLFromProvider();\n}\n\n/**\n * Individual Instance Hook: useDubheECS\n *\n * Returns only the ECS World instance from Provider context.\n * More efficient than useDubhe() when only ECS access is needed.\n *\n * @returns ECS World instance (always available, depends on GraphQL client)\n *\n * @example\n * ```typescript\n * function ECSComponent() {\n *   const ecsWorld = useDubheECS();\n *\n *   useEffect(() => {\n *     ecsWorld.getComponent('MyComponent').then(setComponent);\n *   }, [ecsWorld]);\n *\n *   return <div>ECS Component Data</div>;\n * }\n * ```\n */\nexport function useDubheECS(): DubheECSWorld {\n  return useDubheECSFromProvider();\n}\n\n/**\n * Hook for dynamic configuration updates\n *\n * Provides methods to update provider configuration at runtime\n *\n * @returns Object with updateConfig, resetClients methods and current config\n *\n * @example\n * ```typescript\n * function NetworkSwitcher() {\n *   const { updateConfig, config } = useDubheConfigUpdate();\n *\n *   const switchToTestnet = () => {\n *     updateConfig({\n *       network: 'testnet',\n *       packageId: '0xTestnetPackageId...'\n *     });\n *   };\n *\n *   return (\n *     <div>\n *       <p>Network: {config.network}</p>\n *       <button onClick={switchToTestnet}>Switch to Testnet</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useDubheConfigUpdate() {\n  return useDubheConfigUpdateFromProvider();\n}\n\n/**\n * Compatibility alias for useDubhe\n */\nexport const useContract = useDubhe;\n"],"mappings":"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","names":["useDubheConfigUpdate","import_react","useDubheConfigUpdate"]}

package/dist/index.mjs

@@ -11,7 +11,7 @@ import {
   useDubheECS,
   useDubheGraphQL,
   validateConfig
-} from "./chunk-YQUGWGOF.mjs";
+} from "./chunk-Q5VWR7TU.mjs";
 export {
   DEFAULT_CONFIG,
   DubheProvider,

package/dist/sui/index.d.mts

@@ -11,27 +11,35 @@ import { ReactNode } from 'react';
 type NetworkType = 'mainnet' | 'testnet' | 'devnet' | 'localnet';
 /**
  * Modern Dubhe client configuration for auto-initialization
+ * Aligned with @0xobelisk/client configuration for consistency
  */
 interface DubheConfig {
     /** Network type */
     network: NetworkType;
     /** Contract package ID */
     packageId: string;
-    /** Dubhe Schema ID (optional, for enhanced features) */
-    dubheSchemaId: string;
     /** Contract metadata (required for contract instantiation) */
     metadata: any;
+    /** Dubhe Schema ID (optional, for enhanced features) */
+    dubheSchemaId?: string;
     /** Dubhe metadata (enables GraphQL/ECS features) */
-    dubheMetadata: any;
+    dubheMetadata?: any;
     /** Authentication credentials */
     credentials?: {
+        /** Private key (base64 or hex string) */
         secretKey?: string;
+        /** Mnemonic phrase (12 or 24 words) */
         mnemonics?: string;
     };
     /** Service endpoints configuration */
     endpoints?: {
+        /** Full node RPC URLs (can provide multiple for redundancy) */
+        fullnodeUrls?: string[];
+        /** GraphQL endpoint URL */
         graphql?: string;
+        /** WebSocket endpoint URL for subscriptions */
         websocket?: string;
+        /** gRPC endpoint URL */
         grpc?: string;
     };
     /** Performance and behavior options */
@@ -46,6 +54,10 @@ interface DubheConfig {
         reconnectOnError?: boolean;
     };
 }
+/**
+ * Type alias for consistency with @0xobelisk/client package
+ */
+type ClientConfig = DubheConfig;
 /**
  * Return type for the main useDubhe hook
  */
@@ -372,4 +384,4 @@ declare function useDubheConfigUpdate(): {
  */
 declare const useContract: typeof useDubhe;
 
-export { type ContractReturn, DEFAULT_CONFIG, type DubheConfig, DubheProvider, type DubheReturn, type NetworkType, getConfigSummary, mergeConfigurations, useContract, useDubhe, useDubheConfig, useDubheConfigUpdate, useDubheContract, useDubheECS, useDubheGraphQL, validateConfig };
+export { type ClientConfig, type ContractReturn, DEFAULT_CONFIG, type DubheConfig, DubheProvider, type DubheReturn, type NetworkType, getConfigSummary, mergeConfigurations, useContract, useDubhe, useDubheConfig, useDubheConfigUpdate, useDubheContract, useDubheECS, useDubheGraphQL, validateConfig };