dop-wallet-v6 1.2.14 → 1.2.15

package/WEB_WORKER_TROUBLESHOOTING.md

@@ -1,180 +0,0 @@
-# Web Worker Troubleshooting Guide for React Native
-
-## The Issue
-
-If you're seeing this error:
-```
-ERROR  node_modules/web-worker/cjs/node.js: node_modules/web-worker/cjs/node.js:Invalid call at line 201: import(mod)
-```
-
-This occurs because the `web-worker` package contains Node.js-specific code that uses dynamic imports (`import()`), which are not supported in React Native's Metro bundler.
-
-## Root Cause
-
-The `web-worker` package is a dependency of `circomlibjs` (used by dop-wallet-v6 for cryptographic operations). Even though we provide polyfills, Metro is still trying to parse the original package files, causing the error.
-
-## Solution Steps
-
-### 1. Update Your Metro Configuration
-
-Ensure your `metro.config.js` includes the updated configuration with proper blocking:
-
-```javascript
-const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');
-const path = require('path');
-
-const defaultConfig = getDefaultConfig(__dirname);
-
-const config = {
-  resolver: {
-    // Node.js core module aliases - CRITICAL for fixing ffjavascript dependencies
-    alias: {
-      // Primary Node.js modules required by ffjavascript
-      'os': require.resolve('./node-polyfills/os-polyfill.js'),
-      'crypto': require.resolve('crypto-browserify'),
-      'stream': require.resolve('stream-browserify'),
-      'buffer': require.resolve('buffer'),
-      'events': require.resolve('events'),
-      'util': require.resolve('util'),
-      'assert': require.resolve('assert'),
-      'process': require.resolve('process/browser'),
-      
-      // Additional modules that might be needed
-      'path': require.resolve('path-browserify'),
-      'url': require.resolve('url'),
-      'querystring': require.resolve('querystring-es3'),
-      'http': require.resolve('stream-http'),
-      'https': require.resolve('https-browserify'),
-      'zlib': require.resolve('browserify-zlib'),
-      
-      // Web Worker compatibility - CRITICAL: Block the problematic package
-      'web-worker': require.resolve('./node-polyfills/web-worker-polyfill.js'),
-      'web-worker/cjs/node.js': require.resolve('./node-polyfills/web-worker-polyfill.js'),
-      'web-worker/cjs/node': require.resolve('./node-polyfills/web-worker-polyfill.js'),
-      
-      // Disable problematic WASM-related modules for React Native
-      'wasmcurves': require.resolve('./node-polyfills/wasm-fallback.js'),
-      'wasmbuilder': require.resolve('./node-polyfills/wasm-fallback.js'),
-    },
-    
-    // Extra node modules for Metro resolver
-    extraNodeModules: {
-      'os': require.resolve('./node-polyfills/os-polyfill.js'),
-      'crypto': require.resolve('crypto-browserify'),
-      'stream': require.resolve('stream-browserify'),
-      'buffer': require.resolve('buffer'),
-      'events': require.resolve('events'),
-      'util': require.resolve('util'),
-      'assert': require.resolve('assert'),
-      'process': require.resolve('process/browser'),
-      'path': require.resolve('path-browserify'),
-      'url': require.resolve('url'),
-      'querystring': require.resolve('querystring-es3'),
-      'http': require.resolve('stream-http'),
-      'https': require.resolve('https-browserify'),
-      'zlib': require.resolve('browserify-zlib'),
-      'web-worker': require.resolve('./node-polyfills/web-worker-polyfill.js'),
-      'wasmcurves': require.resolve('./node-polyfills/wasm-fallback.js'),
-      'wasmbuilder': require.resolve('./node-polyfills/wasm-fallback.js'),
-    },
-    
-    // Platforms - ensure React Native takes precedence
-    platforms: ['native', 'react-native', 'android', 'ios', 'web'],
-    
-    // Asset extensions - include WASM if needed (though we're disabling it)
-    assetExts: [...defaultConfig.resolver.assetExts, 'wasm'],
-    
-    // Source extensions - ensure TypeScript and JavaScript are handled
-    sourceExts: [...defaultConfig.resolver.sourceExts, 'cjs'],
-    
-    // Block problematic modules from being processed by Metro
-    blockList: [
-      // Block the original web-worker package to prevent dynamic import errors
-      /node_modules\/web-worker\/cjs\/node\.js$/,
-      /node_modules\/web-worker\/lib\/node\.js$/,
-      // Block other potential problematic files
-      /.*\/node_modules\/web-worker\/.*\.node$/,
-    ],
-  },
-  
-  transformer: {
-    // Disable minification for debugging if needed
-    minifierConfig: {
-      keep_fnames: true,
-      mangle: {
-        keep_fnames: true,
-      },
-    },
-  },
-};
-
-module.exports = mergeConfig(defaultConfig, config);
-```
-
-### 2. Copy Updated Polyfills
-
-Ensure you have copied the latest polyfill files from `new-dop-wallet-v3/node-polyfills/` to your React Native project root:
-
-- `os-polyfill.js`
-- `web-worker-polyfill.js` (updated version)
-- `wasm-fallback.js`
-
-### 3. Clear Metro Cache
-
-After updating the configuration, clear Metro's cache:
-
-```bash
-npx react-native start --reset-cache
-```
-
-### 4. Alternative Solution: Package Resolution Override
-
-If the above doesn't work, you can also try adding package resolution overrides to your `package.json`:
-
-```json
-{
-  "name": "your-react-native-app",
-  "dependencies": {
-    // ... your dependencies
-  },
-  "resolutions": {
-    "web-worker": "file:./node-polyfills/web-worker-polyfill.js"
-  },
-  "overrides": {
-    "web-worker": "file:./node-polyfills/web-worker-polyfill.js"
-  }
-}
-```
-
-### 5. Verification
-
-To verify the fix is working:
-
-1. Start Metro with cache reset: `npx react-native start --reset-cache`
-2. Run your app: `npx react-native run-android` or `npx react-native run-ios`
-3. Check that you see the polyfill warning instead of the error:
-   ```
-   Web Worker polyfill: Web Workers are not supported in React Native. Operations will run synchronously.
-   ```
-
-## Why This Happens
-
-1. **Dynamic imports**: The `web-worker` package uses `import()` syntax which Metro cannot process
-2. **Node.js specific code**: The package contains code designed for Node.js environments
-3. **Dependency chain**: Even though you don't directly use web-worker, it's pulled in by circomlibjs
-
-## Prevention
-
-- Always use the provided Metro configuration when integrating dop-wallet-v6
-- Copy all polyfill files, not just the ones you think you need
-- Test with cache reset after any configuration changes
-
-## Still Having Issues?
-
-If you're still experiencing problems:
-
-1. Check that your Metro configuration exactly matches the example
-2. Verify all polyfill files are copied to the correct location
-3. Ensure the paths in your Metro config point to the actual polyfill files
-4. Try deleting `node_modules` and reinstalling
-5. Check that you're not importing dop-wallet-v6 before the required shims