@pasosdejesus/m 0.24.0 → 0.25.0

package/dist/wallet/next/useInAppWallet.js

@@ -0,0 +1,261 @@
+'use client';
+import { useCallback, useEffect, useSyncExternalStore } from 'react';
+import { createWallet, deleteWallet, detectPlatformSupport, disableBiometricUnlock, emitAccountsChanged, enableBiometricUnlock, getInAppWalletProvider, getWalletInfo, hasBiometricUnlock, hasWallet, importWallet, lockWallet, unlockWallet, unlockWithBiometric as unlockWithBiometricCore, } from '../index.js';
+/**
+ * Auto-lock after this much inactivity, like OneKey and OKX Web3 (R-#246).
+ * Dropping the key means the next action asks for the gesture (or the password on
+ * devices without WebAuthn).
+ *
+ * One hour, not ten minutes: the operator's mobile test had to unlock again
+ * while donating on `/[lang]/gdcluster/ranking` less than ten minutes after
+ * unlocking, and OneKey waits about an hour after its own fingerprint prompt.
+ * The value only bounds how long the in-memory key survives a pause; moving
+ * funds is always gated by layer L1 (a fresh gesture), so a longer pause cannot
+ * make a transfer silent. An operator or the user changing the value is
+ * https://github.com/pasosdeJesus/learn.tg/issues/248.
+ */
+export const INACTIVITY_LOCK_MS = 60 * 60 * 1000;
+// Distinto de `USER_VERIFICATION_GRACE_MS` del core (15 min, R-#253): el auto-lock
+// es por inactividad (una hora) y, al llamar a `lockWallet()`, cierra la ventana de
+// gracia para que el próximo movimiento vuelva a pedir el gesto.
+/**
+ * Minimum time between two inactivity resets. Activity events arrive in bursts
+ * (a scroll fires dozens of them), and restarting the timer on each one is
+ * wasted work on the low-end phones this audience uses.
+ */
+const ACTIVITY_RESET_THROTTLE_MS = 5 * 1000;
+const initialState = {
+    status: 'loading',
+    walletInfo: null,
+    error: null,
+    biometricAvailable: false,
+    biometricEnabled: false,
+    lockReason: 'initial',
+};
+// Estado compartido por todas las instancias del hook. Sin esto, cada componente
+// que llama a `useInAppWallet()` tiene su propia copia: `InAppWalletSetup`
+// desbloquea la billetera y el consumidor (p. ej. `WalletSelector`) sigue viendo
+// `locked`, de modo que la interfaz parece no hacer nada.
+let state = initialState;
+let initialized = false;
+const listeners = new Set();
+function setState(partial) {
+    state = { ...state, ...partial };
+    for (const listener of listeners)
+        listener();
+}
+function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+function getSnapshot() {
+    return state;
+}
+function getServerSnapshot() {
+    return initialState;
+}
+/** Reads the stored wallet once per page load, whoever asks first. */
+async function initialize() {
+    if (initialized)
+        return;
+    initialized = true;
+    if (typeof window === 'undefined' || !window.indexedDB) {
+        setState({ status: 'no-wallet', walletInfo: null });
+        return;
+    }
+    try {
+        const exists = await hasWallet();
+        if (!exists) {
+            setState({ status: 'no-wallet', walletInfo: null });
+            return;
+        }
+        const info = await getWalletInfo();
+        // R-#246: the unlock lives in module memory. A reload locks the wallet again,
+        // which is why the biometric path exists: one gesture instead of the password.
+        let biometricEnabled = false;
+        try {
+            biometricEnabled = await hasBiometricUnlock();
+        }
+        catch {
+            biometricEnabled = false;
+        }
+        let biometricAvailable = false;
+        if (biometricEnabled) {
+            biometricAvailable = true;
+        }
+        else {
+            try {
+                const support = await detectPlatformSupport();
+                // `prf: null` means "the engine did not say": we only know for sure after
+                // creating a credential, so treat it as possibly available.
+                biometricAvailable = support.userVerifying && support.prf !== false;
+            }
+            catch {
+                biometricAvailable = false;
+            }
+        }
+        setState({
+            walletInfo: info,
+            status: state.status === 'unlocked' ? 'unlocked' : 'locked',
+            biometricEnabled,
+            biometricAvailable,
+        });
+    }
+    catch {
+        setState({ status: 'no-wallet', walletInfo: null });
+    }
+}
+/** Test-only: forgets the shared state and the "already initialized" flag. */
+export function resetInAppWalletStoreForTests() {
+    state = initialState;
+    initialized = false;
+    for (const listener of listeners)
+        listener();
+}
+export function useInAppWallet() {
+    const snapshot = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+    useEffect(() => {
+        void initialize();
+    }, []);
+    const create = useCallback(async (password) => {
+        setState({ error: null });
+        try {
+            const result = await createWallet({ password });
+            setState({ walletInfo: result.walletInfo, status: 'unlocked' });
+            return result;
+        }
+        catch (e) {
+            setState({ error: e instanceof Error ? e.message : String(e) });
+            throw e;
+        }
+    }, []);
+    const importExisting = useCallback(async (options) => {
+        setState({ error: null });
+        try {
+            const info = await importWallet(options);
+            setState({ walletInfo: info, status: 'unlocked' });
+            return info;
+        }
+        catch (e) {
+            setState({ error: e instanceof Error ? e.message : String(e) });
+            throw e;
+        }
+    }, []);
+    const unlock = useCallback(async (password) => {
+        setState({ error: null });
+        try {
+            const info = await unlockWallet(password);
+            setState({ walletInfo: info, status: 'unlocked' });
+            return info;
+        }
+        catch (e) {
+            setState({ error: e instanceof Error ? e.message : String(e) });
+            throw e;
+        }
+    }, []);
+    const unlockWithBiometric = useCallback(async () => {
+        setState({ error: null });
+        try {
+            const info = await unlockWithBiometricCore();
+            setState({ walletInfo: info, status: 'unlocked' });
+            return info;
+        }
+        catch (e) {
+            setState({ error: e instanceof Error ? e.message : String(e) });
+            throw e;
+        }
+    }, []);
+    const enableBiometric = useCallback(async (password) => {
+        setState({ error: null });
+        try {
+            await enableBiometricUnlock(password);
+            setState({ biometricEnabled: true, biometricAvailable: true });
+        }
+        catch (e) {
+            setState({ error: e instanceof Error ? e.message : String(e) });
+            throw e;
+        }
+    }, []);
+    const disableBiometric = useCallback(async () => {
+        setState({ error: null });
+        try {
+            await disableBiometricUnlock();
+            setState({ biometricEnabled: false });
+        }
+        catch (e) {
+            setState({ error: e instanceof Error ? e.message : String(e) });
+            throw e;
+        }
+    }, []);
+    const lock = useCallback(async () => {
+        await lockWallet();
+        // R-#236: quien esté suscrito al proveedor se entera de que la sesión terminó.
+        emitAccountsChanged([]);
+        setState({ status: 'locked', lockReason: 'user' });
+    }, []);
+    const remove = useCallback(async () => {
+        await deleteWallet();
+        emitAccountsChanged([]);
+        setState({ walletInfo: null, status: 'no-wallet', biometricEnabled: false, lockReason: 'deleted' });
+    }, []);
+    // R-#246: auto-lock tras inactividad (como OneKey y OKX). Suelta la clave en
+    // memoria; NO cierra la sesión (el motivo lo distingue `WalletEventListener`).
+    // `visibilitychange` se escucha en `document` (no burbujea hasta `window`, que
+    // era el defecto que dejaba el temporizador corriendo en el teléfono), y el
+    // reinicio se limita a uno cada pocos segundos para que `scroll` no lo agite.
+    useEffect(() => {
+        if (snapshot.status !== 'unlocked')
+            return;
+        const lockForIdle = () => {
+            void lockWallet();
+            emitAccountsChanged([]);
+            setState({ status: 'locked', lockReason: 'idle' });
+        };
+        let timer = window.setTimeout(lockForIdle, INACTIVITY_LOCK_MS);
+        let lastReset = Date.now();
+        const reset = () => {
+            const now = Date.now();
+            if (now - lastReset < ACTIVITY_RESET_THROTTLE_MS)
+                return;
+            lastReset = now;
+            window.clearTimeout(timer);
+            timer = window.setTimeout(lockForIdle, INACTIVITY_LOCK_MS);
+        };
+        const events = ['pointerdown', 'keydown', 'touchstart', 'click', 'scroll'];
+        for (const name of events) {
+            window.addEventListener(name, reset, { passive: true });
+        }
+        const onVisibilityChange = () => {
+            lastReset = 0;
+            reset();
+        };
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        return () => {
+            window.clearTimeout(timer);
+            for (const name of events)
+                window.removeEventListener(name, reset);
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+        };
+    }, [snapshot.status]);
+    const getProvider = useCallback((rpcUrl) => getInAppWalletProvider({ rpcUrl }), []);
+    return {
+        status: snapshot.status,
+        walletInfo: snapshot.walletInfo,
+        error: snapshot.error,
+        biometricAvailable: snapshot.biometricAvailable,
+        biometricEnabled: snapshot.biometricEnabled,
+        lockReason: snapshot.lockReason,
+        create,
+        importExisting,
+        unlock,
+        unlockWithBiometric,
+        enableBiometric,
+        disableBiometric,
+        lock,
+        remove,
+        getProvider,
+    };
+}
+//# sourceMappingURL=useInAppWallet.js.map

package/dist/wallet/next/useInAppWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInAppWallet.js","sourceRoot":"","sources":["../../../src/wallet/next/useInAppWallet.ts"],"names":[],"mappings":"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"}

package/dist/wallet/next/useInAppWallet.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useInAppWallet.test.d.ts.map

package/dist/wallet/next/useInAppWallet.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInAppWallet.test.d.ts","sourceRoot":"","sources":["../../../src/wallet/next/useInAppWallet.test.tsx"],"names":[],"mappings":""}

package/dist/wallet/next/useInAppWallet.test.js

@@ -0,0 +1,261 @@
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { act, cleanup, renderHook, waitFor } from '@testing-library/react';
+afterEach(cleanup);
+const walletMock = vi.hoisted(() => ({
+    hasWallet: vi.fn(),
+    getWalletInfo: vi.fn(),
+    createWallet: vi.fn(),
+    importWallet: vi.fn(),
+    unlockWallet: vi.fn(),
+    unlockWithBiometric: vi.fn(),
+    enableBiometricUnlock: vi.fn(),
+    disableBiometricUnlock: vi.fn(),
+    hasBiometricUnlock: vi.fn(),
+    detectPlatformSupport: vi.fn(),
+    lockWallet: vi.fn(),
+    deleteWallet: vi.fn(),
+    getInAppWalletProvider: vi.fn(),
+    // R-#236: avisa a quien esté suscrito al proveedor cuando la billetera se bloquea.
+    emitAccountsChanged: vi.fn(),
+    setWalletDbName: vi.fn(),
+    setDestinationsPrefix: vi.fn(),
+    setRpName: vi.fn(),
+}));
+vi.mock('../index.js', () => walletMock);
+import { useInAppWallet, resetInAppWalletStoreForTests, INACTIVITY_LOCK_MS } from './useInAppWallet.js';
+const ADDRESS = '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266';
+const INFO = { address: ADDRESS, chain: 'celoSepolia', createdAt: 1 };
+describe('useInAppWallet', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        resetInAppWalletStoreForTests();
+        walletMock.hasBiometricUnlock.mockResolvedValue(false);
+        walletMock.detectPlatformSupport.mockResolvedValue({ webauthn: false, userVerifying: false, prf: null });
+        globalThis.indexedDB = {};
+        window.indexedDB = {};
+    });
+    it('reports no-wallet when there is nothing stored', async () => {
+        walletMock.hasWallet.mockResolvedValue(false);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('no-wallet'));
+        expect(result.current.walletInfo).toBeNull();
+    });
+    it('reports locked when a wallet exists', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        expect(result.current.walletInfo?.address).toBe(ADDRESS);
+    });
+    it('reports the biometric capability of the device', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        walletMock.detectPlatformSupport.mockResolvedValue({ webauthn: true, userVerifying: true, prf: true });
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        expect(result.current.biometricAvailable).toBe(true);
+        expect(result.current.biometricEnabled).toBe(false);
+    });
+    it('stays locked and password-only on devices without WebAuthn', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        walletMock.detectPlatformSupport.mockResolvedValue({ webauthn: false, userVerifying: false, prf: null });
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        expect(result.current.biometricAvailable).toBe(false);
+    });
+    it('reports biometric as enabled when a sealed key exists', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        walletMock.hasBiometricUnlock.mockResolvedValue(true);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        expect(result.current.biometricEnabled).toBe(true);
+        expect(result.current.biometricAvailable).toBe(true);
+    });
+    it('unlocks with one gesture', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        walletMock.hasBiometricUnlock.mockResolvedValue(true);
+        walletMock.unlockWithBiometric.mockResolvedValue(INFO);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        await act(async () => {
+            await result.current.unlockWithBiometric();
+        });
+        expect(result.current.status).toBe('unlocked');
+        expect(result.current.walletInfo?.address).toBe(ADDRESS);
+    });
+    it('records the error and keeps the wallet locked when the gesture fails', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        walletMock.unlockWithBiometric.mockRejectedValue(new Error('auth-failed'));
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        await act(async () => {
+            await expect(result.current.unlockWithBiometric()).rejects.toThrow('auth-failed');
+        });
+        expect(result.current.status).toBe('locked');
+        expect(result.current.error).toBe('auth-failed');
+    });
+    it('enables and disables the biometric unlock', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        await act(async () => {
+            await result.current.enableBiometric('123456');
+        });
+        expect(walletMock.enableBiometricUnlock).toHaveBeenCalledWith('123456');
+        expect(result.current.biometricEnabled).toBe(true);
+        await act(async () => {
+            await result.current.disableBiometric();
+        });
+        expect(result.current.biometricEnabled).toBe(false);
+    });
+    it('goes to unlocked after creating a wallet', async () => {
+        walletMock.hasWallet.mockResolvedValue(false);
+        walletMock.createWallet.mockResolvedValue({ walletInfo: INFO, mnemonic: 'one two three' });
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('no-wallet'));
+        await act(async () => {
+            await result.current.create('123456');
+        });
+        expect(result.current.status).toBe('unlocked');
+        expect(result.current.walletInfo?.address).toBe(ADDRESS);
+    });
+    it('locks the wallet after inactivity and marks the reason as idle', async () => {
+        vi.useFakeTimers();
+        try {
+            walletMock.hasWallet.mockResolvedValue(true);
+            walletMock.getWalletInfo.mockResolvedValue(INFO);
+            walletMock.unlockWallet.mockResolvedValue(INFO);
+            const { result } = renderHook(() => useInAppWallet());
+            await act(async () => {
+                await vi.advanceTimersByTimeAsync(0);
+            });
+            await act(async () => {
+                await result.current.unlock('123456');
+            });
+            expect(result.current.status).toBe('unlocked');
+            await act(async () => {
+                await vi.advanceTimersByTimeAsync(INACTIVITY_LOCK_MS + 1);
+            });
+            expect(walletMock.lockWallet).toHaveBeenCalled();
+            expect(result.current.status).toBe('locked');
+            expect(result.current.lockReason).toBe('idle');
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it('restarts the inactivity timer when the tab becomes visible again', async () => {
+        vi.useFakeTimers();
+        try {
+            walletMock.hasWallet.mockResolvedValue(true);
+            walletMock.getWalletInfo.mockResolvedValue(INFO);
+            walletMock.unlockWallet.mockResolvedValue(INFO);
+            const { result } = renderHook(() => useInAppWallet());
+            await act(async () => {
+                await vi.advanceTimersByTimeAsync(0);
+            });
+            await act(async () => {
+                await result.current.unlock('123456');
+            });
+            await act(async () => {
+                await vi.advanceTimersByTimeAsync(INACTIVITY_LOCK_MS - 1000);
+            });
+            document.dispatchEvent(new Event('visibilitychange'));
+            await act(async () => {
+                await vi.advanceTimersByTimeAsync(2000);
+            });
+            expect(result.current.status).toBe('unlocked');
+            await act(async () => {
+                await vi.advanceTimersByTimeAsync(INACTIVITY_LOCK_MS);
+            });
+            expect(result.current.status).toBe('locked');
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it('marks the reason as user when the header ✕ locks it', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        walletMock.unlockWallet.mockResolvedValue(INFO);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        await act(async () => {
+            await result.current.unlock('123456');
+        });
+        await act(async () => {
+            await result.current.lock();
+        });
+        expect(result.current.lockReason).toBe('user');
+    });
+    it('goes to unlocked after importing and back to locked after locking', async () => {
+        walletMock.hasWallet.mockResolvedValue(false);
+        walletMock.importWallet.mockResolvedValue(INFO);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('no-wallet'));
+        await act(async () => {
+            await result.current.importExisting({ mnemonic: 'one two three', password: '123456' });
+        });
+        expect(result.current.status).toBe('unlocked');
+        expect(walletMock.importWallet).toHaveBeenCalledWith({ mnemonic: 'one two three', password: '123456' });
+        await act(async () => {
+            await result.current.lock();
+        });
+        expect(result.current.status).toBe('locked');
+        expect(result.current.walletInfo?.address).toBe(ADDRESS);
+    });
+    it('records the error and rethrows when unlocking fails', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        walletMock.unlockWallet.mockRejectedValue(new Error('Wrong password or corrupted wallet data'));
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        await act(async () => {
+            await expect(result.current.unlock('000000')).rejects.toThrow(/Wrong password/);
+        });
+        expect(result.current.error).toMatch(/Wrong password/);
+    });
+    it('takes the provider from the core package', async () => {
+        walletMock.hasWallet.mockResolvedValue(false);
+        const provider = { request: vi.fn() };
+        walletMock.getInAppWalletProvider.mockReturnValue(provider);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('no-wallet'));
+        expect(result.current.getProvider()).toBe(provider);
+    });
+    it('removes the wallet', async () => {
+        walletMock.hasWallet.mockResolvedValue(true);
+        walletMock.getWalletInfo.mockResolvedValue(INFO);
+        const { result } = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(result.current.status).toBe('locked'));
+        await act(async () => {
+            await result.current.remove();
+        });
+        expect(walletMock.deleteWallet).toHaveBeenCalled();
+        expect(result.current.status).toBe('no-wallet');
+    });
+    it('shares the state between instances (setup and consumer agree)', async () => {
+        walletMock.hasWallet.mockResolvedValue(false);
+        walletMock.createWallet.mockResolvedValue({ walletInfo: INFO, mnemonic: 'one two three' });
+        const setup = renderHook(() => useInAppWallet());
+        const consumer = renderHook(() => useInAppWallet());
+        await waitFor(() => expect(consumer.result.current.status).toBe('no-wallet'));
+        await act(async () => {
+            await setup.result.current.create('123456');
+        });
+        expect(setup.result.current.status).toBe('unlocked');
+        expect(consumer.result.current.status).toBe('unlocked');
+        expect(consumer.result.current.walletInfo?.address).toBe(ADDRESS);
+        await act(async () => {
+            await consumer.result.current.lock();
+        });
+        expect(setup.result.current.status).toBe('locked');
+    });
+});
+//# sourceMappingURL=useInAppWallet.test.js.map

package/dist/wallet/next/useInAppWallet.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInAppWallet.test.js","sourceRoot":"","sources":["../../../src/wallet/next/useInAppWallet.test.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pasosdejesus/m",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Motor para crear y gestionar proyectos al estilo Pasos de Jesus.",
   "author": "",
   "license": "ISC",
@@ -108,6 +108,10 @@
       "import": "./dist/wallet/index.js",
       "types": "./dist/wallet/index.d.ts"
     },
+    "./wallet/next": {
+      "import": "./dist/wallet/next/index.js",
+      "types": "./dist/wallet/next/index.d.ts"
+    },
     "./wallet/storage": {
       "import": "./dist/wallet/storage/index.js",
       "types": "./dist/wallet/storage/index.d.ts"

package/src/e2e/README.md

@@ -151,6 +151,22 @@ Lessons that cost time here (see also learn.tg's `doc/e2e-testing.md`):
 - **Receipt hashes**: the local node re-signs, so `setupFullWalletMock` re-keys the receipt
   under `keccak256(rawTransaction)` (the hash viem waits for).
 
+### Runner: retry and summary (`m/REQ/49` P3/P4)
+
+```sh
+./bin/m test:e2e --retry 2 --retry-delay 15000   # re-run failed specs (fresh WALLET_INDEX each)
+./bin/m test:e2e:summary /tmp/site.log /tmp/local.log   # compare two runs
+```
+
+- `--retry <N>` (default 0, or `E2E_RETRIES`): after the first pass, each failed spec is re-run
+  on its own up to N times; a spec is green **only by exit code**.
+- `--retry-delay <ms>` (default 15000): pause before each retry round.
+- `E2E_LOG_DIR` (default `/tmp`): the run writes `<dir>/e2e-<timestamp>.log` with one
+  `[e2e-result] <file> <ok|fail|skip>` line per spec per attempt (the machine-readable format).
+- `test:e2e:summary <log…>` reads those lines (or the human format for older logs) and prints a
+  row per spec, one column per log, marking `<-- difiere` when a spec's state changes between
+  runs (environmental vs product failure).
+
 ## Environment Variables
 
 See [doc/e2e.md](../../../../doc/e2e.md) for full reference.

package/src/wallet/README.md

@@ -68,6 +68,29 @@ setDestinationsPrefix('learn.tg.pdj-wallet.')      // localStorage
 setRpName('learn.tg')                              // nombre de la credencial WebAuthn
 ```
 
+## React (`./wallet/next`)
+
+Capa React de la billetera in-app (`m/REQ/37`, graduada de `learn.tg/packages/pdj-wallet-next`):
+
+```tsx
+import {
+  useInAppWallet, InAppWalletSetup, InAppWalletUnlock, configureInAppWallet,
+} from '@pasosdejesus/m/wallet/next'
+
+// Conserva tu namespace si ya tienes billeteras creadas:
+configureInAppWallet({
+  dbName: 'learn-tg-pdj-wallet',
+  destinationsPrefix: 'learn.tg.pdj-wallet.',
+  rpName: 'learn.tg',
+})
+
+// Textos: por defecto en/es; el host puede inyectar los suyos:
+<InAppWalletSetup lang="es" messages={{ createTitle: 'Abrir cartera' }} onDone={(a) => {}} />
+```
+
+`react` es un *optional peer*: el subpath está fuera del barrel, así que importar
+`@pasosdejesus/m/wallet` no arrastra React.
+
 ## Pruebas
 
 Mocks en `@pasosdejesus/m/test-utils` (`installLocalStorage`, `installIndexedDB`,
@@ -91,6 +114,6 @@ O a mano: `import { setupWalletTests } from '@pasosdejesus/m/test-utils'; setupW
 ## Notas
 
 - Fase 1/2 de `m/REQ/14`: primitivas, estado, storage, provider, WebAuthn (L1/L2),
-  destinos y resolutor EIP-6963. La billetera integrada (hook/UI React) vive en el
-  consumidor o en un futuro `@pasosdejesus/m/wallet-react`.
+  destinos y resolutor EIP-6963. La capa React (hook + `InAppWalletSetup`/`InAppWalletUnlock`)
+  vive en el subpath `./wallet/next` (`m/REQ/37`).
 - E2E con firma real: `@pasosdejesus/m/e2e` (`injectEIP6963`, `setupFullWalletMock`).