dop-wallet-v6 1.2.15 → 1.2.16

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "dop-wallet-v6",
-  "version": "1.2.15",
+  "version": "1.2.16",
   "description": "DOP Wallet SDK, compatible with mobile, browser and nodejs environments.",
   "main": "dist/index.js",
   "license": "MIT",
   "files": [
     "dist/**/*",
     "*.js",
-    "*.md",
+    "README.md",
     "node-polyfills/**/*",
     "metro.config.react-native.example.js",
     "package-rn-integration.json"
@@ -30,7 +30,7 @@
     "eslint": "eslint src/**/* --ext .ts,.tsx --ignore-pattern **/*.graphql --fix",
     "lint": "npm run check-circular-deps && npm run eslint && npm run tsc && npm run tsc-test",
     "prepare": "npm run build",
-    "postinstall": "node postinstall.js",
+    "postinstall": "patch-package && node postinstall.js",
     "verify-rn-compatibility": "node verify-react-native-compatibility.cjs"
   },
   "dependencies": {
@@ -60,6 +60,7 @@
     "events": "3.3.0",
     "graphql": "^16.6.0",
     "memdown": "^6.1.1",
+    "patch-package": "^8.0.1",
     "poseidon-lite": "^0.3.0",
     "stream-browserify": "3.0.0"
   },

package/ASYNCSTORAGE_FIX_SUMMARY.md

@@ -1,79 +0,0 @@
-# AsyncStorage Fix Summary
-
-## Problem
-
-When integrating the `new-dop-wallet-v3` SDK into React Native applications, users encountered the following error:
-
-```
-Invariant Violation: AsyncStorage has been removed from react-native core. It can now be installed and imported from '@react-native-async-storage/async-storage' instead of 'react-native'
-```
-
-## Root Cause
-
-The issue was caused by the `@graphql-mesh/cache-localforage` dependency, which was trying to use the legacy React Native AsyncStorage API that was removed from React Native core starting from version 0.60+.
-
-The problematic imports were found in three GraphQL mesh configuration files:
-1. `/src/services/dop/dop-txids/graphql/index.ts`
-2. `/src/services/dop/quick-sync/V2/graphql/index.ts` 
-3. `/src/services/dop/quick-sync/V3/graphql/index.ts`
-
-## Solution
-
-**Replaced the cache implementation with `undefined` to disable caching for React Native compatibility:**
-
-### Files Modified:
-
-1. **`/src/services/dop/dop-txids/graphql/index.ts`**
-   - Commented out: `import MeshCache from "@graphql-mesh/cache-localforage";`
-   - Replaced cache instantiation with: `const cache = undefined;`
-
-2. **`/src/services/dop/quick-sync/V2/graphql/index.ts`**
-   - Commented out: `import MeshCache from "@graphql-mesh/cache-localforage";`
-   - Replaced cache instantiation with: `const cache = undefined;`
-
-3. **`/src/services/dop/quick-sync/V3/graphql/index.ts`**
-   - Commented out: `import MeshCache from '@graphql-mesh/cache-localforage';`
-   - Replaced cache instantiation with: `const cache = undefined;`
-
-### Changes Made:
-
-```typescript
-// BEFORE:
-import MeshCache from "@graphql-mesh/cache-localforage";
-
-const cache = new (MeshCache as any)({
-  ...({} as any),
-  importFn,
-  store: rootStore.child('cache'),
-  pubsub,
-  logger,
-} as any)
-
-// AFTER:
-// MODIFIED: Replaced cache-localforage with no cache for React Native compatibility
-// import MeshCache from "@graphql-mesh/cache-localforage";
-
-// MODIFIED: Replaced MeshCache with undefined to disable caching for React Native compatibility
-const cache = undefined;
-```
-
-## Impact
-
-- ✅ **Fixed**: React Native AsyncStorage compatibility issue
-- ✅ **No Breaking Changes**: The wallet functionality remains intact
-- ⚠️ **Performance**: GraphQL queries will not be cached, which may slightly impact performance
-- ✅ **Build**: All builds now pass successfully
-
-## Alternative Solutions Considered
-
-1. **Update `@graphql-mesh/cache-localforage`**: Not feasible as this package is maintained by GraphQL Mesh team
-2. **Replace with `@react-native-async-storage/async-storage`**: Would require custom cache implementation
-3. **Conditional caching**: More complex but could be implemented in future versions
-
-## Recommendation
-
-This fix resolves the immediate compatibility issue. For production applications that require optimal performance, consider implementing a custom cache strategy using `@react-native-async-storage/async-storage` for React Native environments and keeping LocalForage for web environments.
-
-## Version
-
-This fix was applied to version 1.2.10 of the `dop-wallet-v6` package.

package/BUILD_SUCCESS_SUMMARY.md

@@ -1,103 +0,0 @@
-# Build Success Summary - React Native Integration
-
-## ✅ Build Status: SUCCESSFUL
-
-The dop-wallet-v6 SDK now builds successfully with all React Native integration fixes applied.
-
-## Key Fixes Applied:
-
-### 1. **React Native Database Solution**
-- ✅ **Fixed**: Created `ReactNativeLevelDB` class in `/src/services/dop/core/react-native-init.ts`
-- ✅ **Fixed**: Uses memdown + AsyncStorage for persistent storage
-- ✅ **Fixed**: Provides AbstractLevelDOWN-compatible interface
-- ✅ **Fixed**: Handles AsyncStorage unavailability gracefully
-
-### 2. **React Native Initialization**
-- ✅ **Fixed**: Added `startDopEngineReactNative()` function for React Native apps
-- ✅ **Fixed**: Configurable database name (uses AsyncStorage prefix)
-- ✅ **Fixed**: Automatic polyfill detection and graceful fallbacks
-
-### 3. **Dependencies & Polyfills**
-- ✅ **Fixed**: Removed problematic Level-FS dependency
-- ✅ **Fixed**: Added memdown for in-memory LevelDB operations
-- ✅ **Fixed**: Documented all required polyfills in integration guide
-- ✅ **Fixed**: Updated react-native-shims.js with Buffer polyfill
-
-### 4. **Build Configuration**
-- ✅ **Fixed**: All ESLint errors resolved with proper disable comments
-- ✅ **Fixed**: TypeScript compilation passes without errors
-- ✅ **Fixed**: No circular dependencies detected
-
-### 5. **Documentation Updates**
-- ✅ **Fixed**: Updated React Native Integration Guide
-- ✅ **Fixed**: Added troubleshooting section
-- ✅ **Fixed**: Added verification scripts
-- ✅ **Fixed**: Updated integration test
-
-## Current Build Results:
-- ✅ Circular dependency check: PASSED
-- ✅ ESLint check: PASSED (135 warnings, 0 errors)
-- ✅ TypeScript compilation: PASSED
-- ✅ Test TypeScript compilation: PASSED
-
-## For React Native Developers:
-
-The SDK is now ready for React Native integration. Follow these steps:
-
-### 1. Install Required Polyfills:
-```bash
-npm install react-native-get-random-values react-native-url-polyfill buffer util stream-browserify crypto-browserify @react-native-async-storage/async-storage
-```
-
-### 2. Import Polyfills (BEFORE any DOP imports):
-```typescript
-import 'react-native-get-random-values';
-import 'react-native-url-polyfill/auto';
-import { Buffer } from 'buffer';
-global.Buffer = Buffer;
-```
-
-### 3. Configure Metro (metro.config.js):
-```javascript
-const { getDefaultConfig } = require('metro-config');
-
-module.exports = (async () => {
-  const {
-    resolver: { sourceExts, assetExts }
-  } = await getDefaultConfig();
-  
-  return {
-    resolver: {
-      assetExts: assetExts.filter(ext => ext !== 'svg'),
-      sourceExts: [...sourceExts, 'svg'],
-      alias: {
-        'crypto': 'crypto-browserify',
-        'stream': 'stream-browserify',
-        'util': 'util',
-        'buffer': 'buffer'
-      }
-    }
-  };
-})();
-```
-
-### 4. Initialize DOP Engine for React Native:
-```typescript
-import { startDopEngineReactNative } from 'dop-wallet-v6/dist/src/services/dop/core/react-native-init';
-import { ArtifactStore } from 'dop-wallet-v6';
-
-await startDopEngineReactNative(
-  'your-app-name',
-  true, // debug mode
-  new ArtifactStore('/path/to/artifacts'),
-  true, // use native artifacts
-  false, // don't skip merkletree scans
-  false, // no verbose scan logging
-  'dop-wallet-db' // database name
-);
-```
-
-## Next Steps:
-- The SDK is ready for publishing and React Native integration
-- All known React Native compatibility issues have been resolved
-- Comprehensive documentation and troubleshooting guides are in place