@matrix-privacy/wallet 0.0.1

package/dist/tests/local-e2e.js

@@ -0,0 +1,487 @@
+"use strict";
+/// <reference types="../types/global" />
+/* eslint-disable no-plusplus, no-await-in-loop, @typescript-eslint/no-floating-promises, @typescript-eslint/restrict-template-expressions, @typescript-eslint/strict-boolean-expressions, import/no-extraneous-dependencies */
+/**
+ * Local E2E test for Matrix wallet against a local Ganache/Hardhat node.
+ *
+ * Prerequisites:
+ *   1. Start local node:  ./ganache.sh  (or: npx hardhat node)
+ *   2. Deploy contracts:  cd matrix-contracts && yarn hardhat deploy:full --network localhost
+ *   3. Fill in deployed addresses in wallet/local-deploy.json.example
+ *      (also set "mnemonic" and "userPrivateKey" matching your local node)
+ *
+ * Run:
+ *   cd wallet && npx ts-node -P tsconfig.test.json src/tests/local-e2e.ts
+ */
+/* eslint-disable no-console */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const leveldown_1 = __importDefault(require("leveldown"));
+const ethers_1 = require("ethers");
+const snarkjs_1 = require("snarkjs");
+const shared_models_1 = require("@matrix-privacy/shared-models");
+const engine_1 = require("@matrix-privacy/engine");
+const core_1 = require("../services/matrix/core");
+const wallets_1 = require("../services/matrix/wallets/wallets");
+const balance_update_1 = require("../services/matrix/wallets/balance-update");
+const tx_shield_1 = require("../services/transactions/tx-shield");
+const tx_proof_transfer_1 = require("../services/transactions/tx-proof-transfer");
+const tx_transfer_1 = require("../services/transactions/tx-transfer");
+const tx_proof_unshield_1 = require("../services/transactions/tx-proof-unshield");
+const tx_unshield_1 = require("../services/transactions/tx-unshield");
+const artifact_store_1 = require("../services/artifacts/artifact-store");
+const utils_1 = require("../utils");
+// ============================================================
+// Configuration
+// ============================================================
+const WALLET_ROOT = path_1.default.resolve(__dirname, '../..');
+const CONFIG_PATH = path_1.default.resolve(WALLET_ROOT, 'local-deploy.json');
+const CONFIG_PATH_EXAMPLE = path_1.default.resolve(WALLET_ROOT, 'local-deploy.json.example');
+const DB_PATH = path_1.default.resolve(WALLET_ROOT, 'local-e2e.db');
+const ARTIFACTS_DIR = path_1.default.resolve(WALLET_ROOT, 'local-e2e-artifacts');
+// Defaults (Ganache) — overridden by config file fields "userPrivateKey" / "mnemonic"
+// Using account[2] — account[0] is deployer, account[1] is treasury
+const DEFAULT_USER_PRIVATE_KEY = '0xb9bf8d5cedb05765c054f80b69ba7770721b858deb51fc78a8c6962daab4b316'; // Ganache account[2]
+const DEFAULT_MNEMONIC = 'tube level toe forget impulse absorb travel during coach option round coyote';
+const DB_ENCRYPTION_KEY = '0101010101010101010101010101010101010101010101010101010101010101';
+const SHIELD_AMOUNT = ethers_1.ethers.parseEther('1.0'); // 1 WETH
+const TRANSFER_AMOUNT = ethers_1.ethers.parseEther('0.4'); // private transfer amount
+const UNSHIELD_AMOUNT = ethers_1.ethers.parseEther('0.1'); // unshield amount
+// ============================================================
+// Helpers
+// ============================================================
+const fileExists = (filePath) => fs_1.default.promises.access(filePath).then(() => true).catch(() => false);
+const rmDirSafe = async (dir) => {
+    if (await fileExists(dir)) {
+        await fs_1.default.promises.rm(dir, { recursive: true });
+    }
+};
+const step = (n, msg) => console.log(`\n${'='.repeat(60)}\n  Step ${n}: ${msg}\n${'='.repeat(60)}`);
+const info = (msg) => console.log(`  [INFO] ${msg}`);
+const ok = (msg) => console.log(`  [OK]   ${msg}`);
+const fail = (msg) => console.error(`  [FAIL] ${msg}`);
+// Minimal WETH9 ABI
+const WETH9_ABI = [
+    'function deposit() payable',
+    'function approve(address spender, uint256 amount) returns (bool)',
+    'function balanceOf(address owner) view returns (uint256)',
+];
+/** Wait for a merkletree scan cycle to complete. */
+const waitForScan = async (timeoutMs = 30000) => {
+    return new Promise((resolve) => {
+        let done = false;
+        const cb = (scanData) => {
+            if (scanData.scanStatus === shared_models_1.MerkletreeScanStatus.Complete && !done) {
+                done = true;
+                resolve(true);
+            }
+        };
+        (0, core_1.setOnUTXOMerkletreeScanCallback)(cb);
+        setTimeout(() => { if (!done) {
+            done = true;
+            resolve(false);
+        } }, timeoutMs);
+    });
+};
+/** Get gas details for Ganache (EIP-1559). */
+const getGasDetails = async (provider, gasEstimate = 4000000n) => {
+    const feeData = await provider.getFeeData();
+    return {
+        evmGasType: shared_models_1.EVMGasType.Type2,
+        gasEstimate,
+        maxFeePerGas: feeData.maxFeePerGas ?? 2000000000n,
+        maxPriorityFeePerGas: feeData.maxPriorityFeePerGas ?? 1000000000n,
+    };
+};
+// ============================================================
+// Main
+// ============================================================
+async function main() {
+    console.log('\nMatrix Wallet — Local E2E Test\n');
+    // ── Step 0: Read deployment config ──────────────────────────
+    step(0, 'Read deployment config');
+    // Try local-deploy.json first, then local-deploy.json.example
+    let configFile;
+    if (await fileExists(CONFIG_PATH)) {
+        configFile = CONFIG_PATH;
+    }
+    else if (await fileExists(CONFIG_PATH_EXAMPLE)) {
+        configFile = CONFIG_PATH_EXAMPLE;
+    }
+    if (!configFile) {
+        fail(`Config file not found.`);
+        console.log(`\nLooked for:\n  ${CONFIG_PATH}\n  ${CONFIG_PATH_EXAMPLE}`);
+        console.log('\nCreate one with your deployed contract addresses.');
+        console.log('Required fields: rpc, chainId, weth, accumulatorProxy,');
+        console.log('  matrixProxy, verifierProxy, tokenVaultProxy, relayAdapt');
+        console.log('Optional: userPrivateKey, mnemonic\n');
+        process.exit(1);
+    }
+    info(`Reading config from: ${path_1.default.basename(configFile)}`);
+    const config = JSON.parse(await fs_1.default.promises.readFile(configFile, 'utf-8'));
+    // Validate all addresses are present
+    const requiredFields = [
+        'rpc', 'chainId', 'weth',
+        'accumulatorProxy', 'matrixProxy', 'verifierProxy',
+        'tokenVaultProxy', 'relayAdapt',
+    ];
+    for (const field of requiredFields) {
+        if (!config[field]) {
+            fail(`Missing field "${field}" in local-deploy.json`);
+            process.exit(1);
+        }
+    }
+    info(`RPC: ${config.rpc}`);
+    info(`Chain ID: ${config.chainId}`);
+    info(`WETH: ${config.weth}`);
+    info(`Accumulator: ${config.accumulatorProxy}`);
+    info(`Matrix: ${config.matrixProxy}`);
+    info(`Verifier: ${config.verifierProxy}`);
+    info(`TokenVault: ${config.tokenVaultProxy}`);
+    info(`RelayAdapt: ${config.relayAdapt}`);
+    ok('Config loaded');
+    // ── Step 1: Patch NETWORK_CONFIG ────────────────────────────
+    step(1, 'Patch NETWORK_CONFIG with deployed addresses');
+    const networkConfig = shared_models_1.NETWORK_CONFIG[shared_models_1.NetworkName.Hardhat];
+    networkConfig.chain.id = config.chainId;
+    networkConfig.matrixContract = config.matrixProxy;
+    networkConfig.accumulatorContract = config.accumulatorProxy;
+    // Engine's "verifier" is the Matrix contract (legacy naming from Railgun's
+    // PoseidonMerkleVerifier). It holds the execute() entry point.
+    networkConfig.verifierContract = config.matrixProxy;
+    networkConfig.tokenVaultContract = config.tokenVaultProxy;
+    networkConfig.relayAdaptContract = config.relayAdapt;
+    networkConfig.baseToken.wrappedAddress = config.weth;
+    networkConfig.deploymentBlock = 0;
+    ok('NETWORK_CONFIG patched');
+    // ── Step 2: Connect to local node ───────────────────────────
+    step(2, 'Connect to local node');
+    const userPrivateKey = config.userPrivateKey || DEFAULT_USER_PRIVATE_KEY;
+    const mnemonic = config.mnemonic || DEFAULT_MNEMONIC;
+    const jsonRpcProvider = new ethers_1.JsonRpcProvider(config.rpc, config.chainId);
+    const blockNumber = await jsonRpcProvider.getBlockNumber();
+    info(`Current block: ${blockNumber}`);
+    const userWallet = new ethers_1.Wallet(userPrivateKey, jsonRpcProvider);
+    const userAddress = await userWallet.getAddress();
+    const ethBalance = await jsonRpcProvider.getBalance(userAddress);
+    info(`User address: ${userAddress}`);
+    info(`ETH balance: ${ethers_1.ethers.formatEther(ethBalance)} ETH`);
+    if (ethBalance === 0n) {
+        fail('User account has 0 ETH — wrong private key or unfunded account?');
+        process.exit(1);
+    }
+    ok('Connected to local node');
+    // ── Step 3: Initialize Matrix Engine ────────────────────────
+    step(3, 'Initialize Matrix Engine');
+    await rmDirSafe(DB_PATH);
+    // Keep ARTIFACTS_DIR across runs so IPFS-downloaded circuit artifacts are cached.
+    const db = new leveldown_1.default(DB_PATH);
+    const artifactStore = new artifact_store_1.ArtifactStore((filePath) => fs_1.default.promises.readFile(path_1.default.resolve(ARTIFACTS_DIR, filePath)), async (dir, filePath, data) => {
+        const fullDir = path_1.default.resolve(ARTIFACTS_DIR, dir);
+        const fullPath = path_1.default.resolve(ARTIFACTS_DIR, filePath);
+        await fs_1.default.promises.mkdir(fullDir, { recursive: true });
+        await fs_1.default.promises.writeFile(fullPath, data);
+    }, async (filePath) => fileExists(path_1.default.resolve(ARTIFACTS_DIR, filePath)));
+    (0, utils_1.setLoggers)(console.log, console.error);
+    await (0, core_1.startMatrixEngine)('locale2etest', // walletSource (max 16 chars, lowercase, no hyphens)
+    db, // database
+    true, // shouldDebug
+    artifactStore, // artifactStore
+    false, // useNativeArtifacts (nodejs = false)
+    false, // skipMerkletreeScans
+    false);
+    (0, core_1.getEngine)().prover.setSnarkJSGroth16(snarkjs_1.groth16);
+    ok('Engine initialized');
+    // ── Step 4: Load network provider ──────────────────────────
+    step(4, 'Load network provider');
+    const fallbackProviderConfig = {
+        chainId: config.chainId,
+        providers: [
+            {
+                provider: config.rpc,
+                priority: 1,
+                weight: 2,
+                maxLogsPerBatch: 100,
+                stallTimeout: 5000,
+            },
+        ],
+    };
+    const { feesSerialized } = await (0, core_1.loadProvider)(fallbackProviderConfig, shared_models_1.NetworkName.Hardhat, 5000);
+    info(`Shield fee: ${feesSerialized.shieldFee} bps`);
+    info(`Unshield fee: ${feesSerialized.unshieldFee} bps`);
+    ok('Provider loaded, network connected');
+    // ── Step 5: Create Matrix wallet ───────────────────────────
+    step(5, 'Create Matrix wallet');
+    const walletInfo = await (0, wallets_1.createMatrixWallet)(DB_ENCRYPTION_KEY, mnemonic, { [shared_models_1.NetworkName.Hardhat]: 0 }, 0);
+    info(`Wallet ID: ${walletInfo.id}`);
+    info(`Matrix address: ${walletInfo.matrixAddress}`);
+    ok('Wallet created');
+    // ── Step 6: Set up event listeners and scan ────────────────
+    step(6, 'Scan contract history');
+    let scanComplete = false;
+    const scanPromise = new Promise((resolve) => {
+        (0, core_1.setOnUTXOMerkletreeScanCallback)((scanData) => {
+            info(`Scan: status=${scanData.scanStatus}, progress=${(scanData.progress * 100).toFixed(1)}%`);
+            if (scanData.scanStatus === shared_models_1.MerkletreeScanStatus.Complete) {
+                scanComplete = true;
+                resolve();
+            }
+        });
+    });
+    let balanceUpdated = false;
+    (0, balance_update_1.setOnBalanceUpdateCallback)(() => {
+        balanceUpdated = true;
+    });
+    const { chain } = shared_models_1.NETWORK_CONFIG[shared_models_1.NetworkName.Hardhat];
+    (0, core_1.getEngine)().scanContractHistory(chain, undefined);
+    // Wait for initial scan (should be fast on empty chain)
+    const scanTimeout = setTimeout(() => {
+        if (!scanComplete) {
+            info('Scan taking long, continuing...');
+        }
+    }, 10000);
+    await Promise.race([
+        scanPromise,
+        new Promise(resolve => setTimeout(resolve, 15000)),
+    ]);
+    clearTimeout(scanTimeout);
+    ok('Initial scan complete');
+    // ── Step 7: Wrap ETH → WETH ────────────────────────────────
+    step(7, 'Wrap ETH → WETH');
+    const weth = new ethers_1.Contract(config.weth, WETH9_ABI, userWallet);
+    // Ganache instamine + ethers v6 nonce caching = stale nonces.
+    // Fetch once, increment locally for each send.
+    let nonce = await jsonRpcProvider.getTransactionCount(userAddress, 'pending');
+    info(`Starting nonce: ${nonce}`);
+    info(`Depositing ${ethers_1.ethers.formatEther(SHIELD_AMOUNT)} ETH → WETH...`);
+    const depositTx = await weth.deposit({ value: SHIELD_AMOUNT, nonce: nonce++ });
+    await depositTx.wait();
+    const wethBalance = await weth.balanceOf(userAddress);
+    info(`WETH balance: ${ethers_1.ethers.formatEther(wethBalance)}`);
+    ok('ETH wrapped to WETH');
+    // ── Step 8: Approve TokenVault to spend WETH ───────────────
+    step(8, 'Approve TokenVault for WETH');
+    info(`Approving ${config.tokenVaultProxy} to spend WETH...`);
+    const approveTx = await weth.approve(config.tokenVaultProxy, SHIELD_AMOUNT, { nonce: nonce++ });
+    await approveTx.wait();
+    ok('TokenVault approved');
+    // ── Step 9: Shield WETH into Matrix wallet ─────────────────
+    step(9, 'Shield WETH');
+    // Generate a shield private key (random for testing)
+    const shieldPrivateKey = engine_1.ByteUtils.randomHex(32);
+    info(`Shield private key: ${shieldPrivateKey.slice(0, 18)}...`);
+    info(`Shield message: "${(0, tx_shield_1.getShieldPrivateKeySignatureMessage)()}"`);
+    const erc20AmountRecipients = [
+        {
+            tokenAddress: config.weth,
+            amount: SHIELD_AMOUNT,
+            recipientAddress: walletInfo.matrixAddress,
+        },
+    ];
+    info('Populating shield transaction...');
+    const { transaction: shieldTx } = await (0, tx_shield_1.populateShield)(shared_models_1.NetworkName.Hardhat, shieldPrivateKey, erc20AmountRecipients, [], // nftAmountRecipients
+    undefined);
+    info(`Shield tx to: ${shieldTx.to}`);
+    info('Sending shield transaction...');
+    const sentTx = await userWallet.sendTransaction({ ...shieldTx, nonce: nonce++ });
+    info(`TX hash: ${sentTx.hash}`);
+    const receipt = await sentTx.wait();
+    info(`TX confirmed in block ${receipt?.blockNumber}, gas used: ${receipt?.gasUsed.toString()}`);
+    ok('Shield transaction confirmed');
+    // ── Step 10: Wait for balance update ───────────────────────
+    step(10, 'Wait for balance scan after shield');
+    info('Triggering rescan...');
+    balanceUpdated = false;
+    (0, core_1.getEngine)().scanContractHistory(chain, undefined);
+    // Wait for balance update
+    const balanceTimeout = 30000;
+    const startTime = Date.now();
+    while (!balanceUpdated && Date.now() - startTime < balanceTimeout) {
+        await new Promise(resolve => setTimeout(resolve, 500));
+    }
+    if (balanceUpdated) {
+        ok('Balance updated after shield');
+    }
+    else {
+        info('Balance update not received within timeout — check engine logs above');
+    }
+    // ── Step 11: Query private balance ───────────────────────
+    step(11, 'Query private balance after shield');
+    const wallet1 = (0, wallets_1.walletForID)(walletInfo.id);
+    const balances1 = await wallet1.getTokenBalances(chain, false);
+    const erc20Balances1 = (0, balance_update_1.getSerializedERC20Balances)(balances1);
+    const shieldedWeth = erc20Balances1.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());
+    if (shieldedWeth) {
+        info(`Private WETH balance: ${ethers_1.ethers.formatEther(shieldedWeth.amount)}`);
+    }
+    else {
+        fail('No WETH found in private balance!');
+        process.exit(1);
+    }
+    ok('Private balance confirmed');
+    // ── Step 12: Create second wallet (recipient) ────────────
+    step(12, 'Create second Matrix wallet (recipient)');
+    const wallet2Info = await (0, wallets_1.createMatrixWallet)(DB_ENCRYPTION_KEY, mnemonic, { [shared_models_1.NetworkName.Hardhat]: 0 }, 1);
+    info(`Wallet 2 ID: ${wallet2Info.id}`);
+    info(`Wallet 2 address: ${wallet2Info.matrixAddress}`);
+    ok('Second wallet created');
+    // ── Step 13: Private transfer ────────────────────────────
+    step(13, 'Private transfer (ZK proof)');
+    info(`Transferring ${ethers_1.ethers.formatEther(TRANSFER_AMOUNT)} WETH to wallet 2...`);
+    info('Generating transfer proof (this may take ~30-60s)...');
+    const transferRecipients = [
+        {
+            tokenAddress: config.weth,
+            amount: TRANSFER_AMOUNT,
+            recipientAddress: wallet2Info.matrixAddress,
+        },
+    ];
+    await (0, tx_proof_transfer_1.generateTransferProof)(shared_models_1.NetworkName.Hardhat, walletInfo.id, DB_ENCRYPTION_KEY, false, // showSenderAddressToRecipient
+    undefined, // memoText
+    transferRecipients, [], // nftAmountRecipients
+    undefined, // broadcasterFeeERC20AmountRecipient
+    true, // sendWithPublicWallet
+    undefined, // overallBatchMinGasPrice
+    (progress, status) => {
+        info(`Proof: ${status} (${(progress * 100).toFixed(1)}%)`);
+    });
+    ok('Transfer proof generated');
+    const transferGasDetails = await getGasDetails(jsonRpcProvider);
+    const { transaction: transferTx } = await (0, tx_transfer_1.populateProvedTransfer)(shared_models_1.NetworkName.Hardhat, walletInfo.id, false, // showSenderAddressToRecipient
+    undefined, // memoText
+    transferRecipients, [], // nftAmountRecipients
+    undefined, // broadcasterFeeERC20AmountRecipient
+    true, // sendWithPublicWallet
+    undefined, // overallBatchMinGasPrice
+    transferGasDetails);
+    info(`Transfer tx to: ${transferTx.to}`);
+    const sentTransferTx = await userWallet.sendTransaction({ ...transferTx, nonce: nonce++ });
+    info(`TX hash: ${sentTransferTx.hash}`);
+    const transferReceipt = await sentTransferTx.wait();
+    info(`TX confirmed in block ${transferReceipt?.blockNumber}, gas used: ${transferReceipt?.gasUsed.toString()}`);
+    ok('Private transfer confirmed on-chain');
+    // ── Step 14: Rescan + verify transfer balances ───────────
+    step(14, 'Rescan after transfer');
+    (0, core_1.getEngine)().scanContractHistory(chain, undefined);
+    const scanOk1 = await waitForScan();
+    if (scanOk1) {
+        ok('Scan complete');
+    }
+    else {
+        info('Scan timeout — continuing');
+    }
+    // Query both wallets (balance deserialization may fail for wallet 2 — investigate separately)
+    let w1Weth;
+    let w2Weth;
+    try {
+        const w1PostTransfer = await (0, wallets_1.walletForID)(walletInfo.id).getTokenBalances(chain, false);
+        const w1Erc20 = (0, balance_update_1.getSerializedERC20Balances)(w1PostTransfer);
+        w1Weth = w1Erc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());
+        info(`Wallet 1 private WETH: ${w1Weth ? ethers_1.ethers.formatEther(w1Weth.amount) : '0'}`);
+    }
+    catch (err) {
+        info(`Wallet 1 balance query failed: ${err.message}`);
+    }
+    try {
+        const wallet2 = (0, wallets_1.walletForID)(wallet2Info.id);
+        const w2PostTransfer = await wallet2.getTokenBalances(chain, false);
+        const w2Erc20 = (0, balance_update_1.getSerializedERC20Balances)(w2PostTransfer);
+        w2Weth = w2Erc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());
+        info(`Wallet 2 private WETH: ${w2Weth ? ethers_1.ethers.formatEther(w2Weth.amount) : '0'}`);
+    }
+    catch (err) {
+        info(`Wallet 2 balance query failed: ${err.message}`);
+    }
+    ok('Transfer balances checked');
+    // ── Step 15: Unshield from wallet 1 ──────────────────────
+    step(15, 'Unshield WETH (ZK proof)');
+    info(`Unshielding ${ethers_1.ethers.formatEther(UNSHIELD_AMOUNT)} WETH to ${userAddress}...`);
+    info('Generating unshield proof (this may take ~30-60s)...');
+    const unshieldRecipients = [
+        {
+            tokenAddress: config.weth,
+            amount: UNSHIELD_AMOUNT,
+            recipientAddress: userAddress, // public ETH address
+        },
+    ];
+    await (0, tx_proof_unshield_1.generateUnshieldProof)(shared_models_1.NetworkName.Hardhat, walletInfo.id, DB_ENCRYPTION_KEY, unshieldRecipients, [], // nftAmountRecipients
+    undefined, // broadcasterFeeERC20AmountRecipient
+    true, // sendWithPublicWallet
+    undefined, // overallBatchMinGasPrice
+    (progress, status) => {
+        info(`Proof: ${status} (${(progress * 100).toFixed(1)}%)`);
+    });
+    ok('Unshield proof generated');
+    const unshieldGasDetails = await getGasDetails(jsonRpcProvider);
+    const { transaction: unshieldTx } = await (0, tx_unshield_1.populateProvedUnshield)(shared_models_1.NetworkName.Hardhat, walletInfo.id, unshieldRecipients, [], // nftAmountRecipients
+    undefined, // broadcasterFeeERC20AmountRecipient
+    true, // sendWithPublicWallet
+    undefined, // overallBatchMinGasPrice
+    unshieldGasDetails);
+    info(`Unshield tx to: ${unshieldTx.to}`);
+    const sentUnshieldTx = await userWallet.sendTransaction({ ...unshieldTx, nonce: nonce++ });
+    info(`TX hash: ${sentUnshieldTx.hash}`);
+    const unshieldReceipt = await sentUnshieldTx.wait();
+    info(`TX confirmed in block ${unshieldReceipt?.blockNumber}, gas used: ${unshieldReceipt?.gasUsed.toString()}`);
+    ok('Unshield confirmed on-chain');
+    // ── Step 16: Rescan + verify unshield ────────────────────
+    step(16, 'Verify unshield');
+    (0, core_1.getEngine)().scanContractHistory(chain, undefined);
+    const scanOk2 = await waitForScan();
+    if (scanOk2) {
+        ok('Scan complete');
+    }
+    else {
+        info('Scan timeout — continuing');
+    }
+    const postUnshieldWeth = await weth.balanceOf(userAddress);
+    info(`Public WETH balance after unshield: ${ethers_1.ethers.formatEther(postUnshieldWeth)}`);
+    let w1FinalWeth;
+    try {
+        const w1Final = await (0, wallets_1.walletForID)(walletInfo.id).getTokenBalances(chain, false);
+        const w1FinalErc20 = (0, balance_update_1.getSerializedERC20Balances)(w1Final);
+        w1FinalWeth = w1FinalErc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());
+        info(`Wallet 1 final private WETH: ${w1FinalWeth ? ethers_1.ethers.formatEther(w1FinalWeth.amount) : '0'}`);
+    }
+    catch (err) {
+        info(`Wallet 1 final balance query failed: ${err.message}`);
+    }
+    ok('Unshield verified');
+    // ── Step 17: Final summary ───────────────────────────────
+    step(17, 'Final Summary');
+    const finalEthBalance = await jsonRpcProvider.getBalance(userAddress);
+    const finalWethBalance = await weth.balanceOf(userAddress);
+    let w2FinalWeth;
+    try {
+        const w2Final = await (0, wallets_1.walletForID)(wallet2Info.id).getTokenBalances(chain, false);
+        const w2FinalErc20 = (0, balance_update_1.getSerializedERC20Balances)(w2Final);
+        w2FinalWeth = w2FinalErc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());
+    }
+    catch (err) {
+        info(`Wallet 2 final balance query failed: ${err.message}`);
+    }
+    console.log('\n  Public wallet:');
+    info(`ETH:  ${ethers_1.ethers.formatEther(finalEthBalance)}`);
+    info(`WETH: ${ethers_1.ethers.formatEther(finalWethBalance)}`);
+    console.log('\n  Private wallets:');
+    info(`Wallet 1: ${w1FinalWeth ? ethers_1.ethers.formatEther(w1FinalWeth.amount) : '0'} WETH`);
+    info(`Wallet 2: ${w2FinalWeth ? ethers_1.ethers.formatEther(w2FinalWeth.amount) : '0'} WETH`);
+    console.log('\n  Operations completed:');
+    info(`Shield:   ${ethers_1.ethers.formatEther(SHIELD_AMOUNT)} WETH (fee ${feesSerialized.shieldFee} bps)`);
+    info(`Transfer: ${ethers_1.ethers.formatEther(TRANSFER_AMOUNT)} WETH (wallet 1 -> wallet 2)`);
+    info(`Unshield: ${ethers_1.ethers.formatEther(UNSHIELD_AMOUNT)} WETH (fee ${feesSerialized.unshieldFee} bps)`);
+    console.log('');
+    // ── Cleanup ────────────────────────────────────────────────
+    await (0, core_1.stopMatrixEngine)();
+    ok('Engine stopped. Full E2E test complete.\n');
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error('\n  [FATAL]', err);
+    process.exit(1);
+});
+//# sourceMappingURL=local-e2e.js.map

package/dist/tests/local-e2e.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-e2e.js","sourceRoot":"","sources":["../../src/tests/local-e2e.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference types=\"../types/global\" />\n/* eslint-disable no-plusplus, no-await-in-loop, @typescript-eslint/no-floating-promises, @typescript-eslint/restrict-template-expressions, @typescript-eslint/strict-boolean-expressions, import/no-extraneous-dependencies */\n/**\n * Local E2E test for Matrix wallet against a local Ganache/Hardhat node.\n *\n * Prerequisites:\n *   1. Start local node:  ./ganache.sh  (or: npx hardhat node)\n *   2. Deploy contracts:  cd matrix-contracts && yarn hardhat deploy:full --network localhost\n *   3. Fill in deployed addresses in wallet/local-deploy.json.example\n *      (also set \"mnemonic\" and \"userPrivateKey\" matching your local node)\n *\n * Run:\n *   cd wallet && npx ts-node -P tsconfig.test.json src/tests/local-e2e.ts\n */\n/* eslint-disable no-console */\n\nimport fs from 'fs';\nimport path from 'path';\nimport LevelDOWN from 'leveldown';\nimport { ethers, Wallet, JsonRpcProvider, Contract, ContractTransactionResponse } from 'ethers';\nimport { groth16 } from 'snarkjs';\nimport {\n  NETWORK_CONFIG,\n  NetworkName,\n  FallbackProviderJsonConfig,\n  MerkletreeScanStatus,\n  MerkletreeScanUpdateEvent,\n  EVMGasType,\n  type TransactionGasDetailsType2,\n} from '@matrix-privacy/shared-models';\nimport {\n  SnarkJSGroth16,\n  MatrixContracts,\n  ByteUtils,\n} from '@matrix-privacy/engine';\nimport {\n  startMatrixEngine,\n  stopMatrixEngine,\n  getEngine,\n  loadProvider,\n  setOnUTXOMerkletreeScanCallback,\n} from '../services/matrix/core';\nimport {\n  createMatrixWallet,\n  walletForID,\n} from '../services/matrix/wallets/wallets';\nimport {\n  setOnBalanceUpdateCallback,\n  getSerializedERC20Balances,\n} from '../services/matrix/wallets/balance-update';\nimport {\n  populateShield,\n  getShieldPrivateKeySignatureMessage,\n} from '../services/transactions/tx-shield';\nimport { generateTransferProof } from '../services/transactions/tx-proof-transfer';\nimport { populateProvedTransfer } from '../services/transactions/tx-transfer';\nimport { generateUnshieldProof } from '../services/transactions/tx-proof-unshield';\nimport { populateProvedUnshield } from '../services/transactions/tx-unshield';\nimport { ArtifactStore } from '../services/artifacts/artifact-store';\nimport { setLoggers } from '../utils';\n\n// ============================================================\n// Configuration\n// ============================================================\n\nconst WALLET_ROOT = path.resolve(__dirname, '../..');\nconst CONFIG_PATH = path.resolve(WALLET_ROOT, 'local-deploy.json');\nconst CONFIG_PATH_EXAMPLE = path.resolve(WALLET_ROOT, 'local-deploy.json.example');\nconst DB_PATH = path.resolve(WALLET_ROOT, 'local-e2e.db');\nconst ARTIFACTS_DIR = path.resolve(WALLET_ROOT, 'local-e2e-artifacts');\n\n// Defaults (Ganache) — overridden by config file fields \"userPrivateKey\" / \"mnemonic\"\n// Using account[2] — account[0] is deployer, account[1] is treasury\nconst DEFAULT_USER_PRIVATE_KEY =\n  '0xb9bf8d5cedb05765c054f80b69ba7770721b858deb51fc78a8c6962daab4b316'; // Ganache account[2]\nconst DEFAULT_MNEMONIC =\n  'tube level toe forget impulse absorb travel during coach option round coyote';\nconst DB_ENCRYPTION_KEY =\n  '0101010101010101010101010101010101010101010101010101010101010101';\n\nconst SHIELD_AMOUNT = ethers.parseEther('1.0'); // 1 WETH\nconst TRANSFER_AMOUNT = ethers.parseEther('0.4'); // private transfer amount\nconst UNSHIELD_AMOUNT = ethers.parseEther('0.1'); // unshield amount\n\n// ============================================================\n// Types\n// ============================================================\n\ninterface DeployConfig {\n  rpc: string;\n  chainId: number;\n  weth: string;\n  accumulatorProxy: string;\n  matrixProxy: string;\n  verifierProxy: string;\n  tokenVaultProxy: string;\n  relayAdapt: string;\n  // Optional: override default user key / mnemonic\n  userPrivateKey?: string;\n  mnemonic?: string;\n}\n\n// ============================================================\n// Helpers\n// ============================================================\n\nconst fileExists = (filePath: string): Promise<boolean> =>\n  fs.promises.access(filePath).then(() => true).catch(() => false);\n\nconst rmDirSafe = async (dir: string) => {\n  if (await fileExists(dir)) {\n    await fs.promises.rm(dir, { recursive: true });\n  }\n};\n\nconst step = (n: number, msg: string) =>\n  console.log(`\\n${'='.repeat(60)}\\n  Step ${n}: ${msg}\\n${'='.repeat(60)}`);\n\nconst info = (msg: string) => console.log(`  [INFO] ${msg}`);\nconst ok = (msg: string) => console.log(`  [OK]   ${msg}`);\nconst fail = (msg: string) => console.error(`  [FAIL] ${msg}`);\n\n// Minimal WETH9 ABI\nconst WETH9_ABI = [\n  'function deposit() payable',\n  'function approve(address spender, uint256 amount) returns (bool)',\n  'function balanceOf(address owner) view returns (uint256)',\n];\n\n/** Wait for a merkletree scan cycle to complete. */\nconst waitForScan = async (timeoutMs = 30000): Promise<boolean> => {\n  return new Promise<boolean>((resolve) => {\n    let done = false;\n    const cb = (scanData: MerkletreeScanUpdateEvent) => {\n      if (scanData.scanStatus === MerkletreeScanStatus.Complete && !done) {\n        done = true;\n        resolve(true);\n      }\n    };\n    setOnUTXOMerkletreeScanCallback(cb);\n    setTimeout(() => { if (!done) { done = true; resolve(false); } }, timeoutMs);\n  });\n};\n\n/** Get gas details for Ganache (EIP-1559). */\nconst getGasDetails = async (\n  provider: JsonRpcProvider,\n  gasEstimate = 4_000_000n,\n): Promise<TransactionGasDetailsType2> => {\n  const feeData = await provider.getFeeData();\n  return {\n    evmGasType: EVMGasType.Type2,\n    gasEstimate,\n    maxFeePerGas: feeData.maxFeePerGas ?? 2_000_000_000n,\n    maxPriorityFeePerGas: feeData.maxPriorityFeePerGas ?? 1_000_000_000n,\n  };\n};\n\n// ============================================================\n// Main\n// ============================================================\n\nasync function main() {\n  console.log('\\nMatrix Wallet — Local E2E Test\\n');\n\n  // ── Step 0: Read deployment config ──────────────────────────\n  step(0, 'Read deployment config');\n\n  // Try local-deploy.json first, then local-deploy.json.example\n  let configFile: string | undefined;\n  if (await fileExists(CONFIG_PATH)) {\n    configFile = CONFIG_PATH;\n  } else if (await fileExists(CONFIG_PATH_EXAMPLE)) {\n    configFile = CONFIG_PATH_EXAMPLE;\n  }\n\n  if (!configFile) {\n    fail(`Config file not found.`);\n    console.log(`\\nLooked for:\\n  ${CONFIG_PATH}\\n  ${CONFIG_PATH_EXAMPLE}`);\n    console.log('\\nCreate one with your deployed contract addresses.');\n    console.log('Required fields: rpc, chainId, weth, accumulatorProxy,');\n    console.log('  matrixProxy, verifierProxy, tokenVaultProxy, relayAdapt');\n    console.log('Optional: userPrivateKey, mnemonic\\n');\n    process.exit(1);\n  }\n\n  info(`Reading config from: ${path.basename(configFile)}`);\n  const config: DeployConfig = JSON.parse(\n    await fs.promises.readFile(configFile, 'utf-8'),\n  );\n\n  // Validate all addresses are present\n  const requiredFields: (keyof DeployConfig)[] = [\n    'rpc', 'chainId', 'weth',\n    'accumulatorProxy', 'matrixProxy', 'verifierProxy',\n    'tokenVaultProxy', 'relayAdapt',\n  ];\n  for (const field of requiredFields) {\n    if (!config[field]) {\n      fail(`Missing field \"${field}\" in local-deploy.json`);\n      process.exit(1);\n    }\n  }\n\n  info(`RPC: ${config.rpc}`);\n  info(`Chain ID: ${config.chainId}`);\n  info(`WETH: ${config.weth}`);\n  info(`Accumulator: ${config.accumulatorProxy}`);\n  info(`Matrix: ${config.matrixProxy}`);\n  info(`Verifier: ${config.verifierProxy}`);\n  info(`TokenVault: ${config.tokenVaultProxy}`);\n  info(`RelayAdapt: ${config.relayAdapt}`);\n  ok('Config loaded');\n\n  // ── Step 1: Patch NETWORK_CONFIG ────────────────────────────\n  step(1, 'Patch NETWORK_CONFIG with deployed addresses');\n\n  const networkConfig = NETWORK_CONFIG[NetworkName.Hardhat];\n  networkConfig.chain.id = config.chainId;\n  networkConfig.matrixContract = config.matrixProxy;\n  networkConfig.accumulatorContract = config.accumulatorProxy;\n  // Engine's \"verifier\" is the Matrix contract (legacy naming from Railgun's\n  // PoseidonMerkleVerifier). It holds the execute() entry point.\n  networkConfig.verifierContract = config.matrixProxy;\n  networkConfig.tokenVaultContract = config.tokenVaultProxy;\n  networkConfig.relayAdaptContract = config.relayAdapt;\n  networkConfig.baseToken.wrappedAddress = config.weth;\n  networkConfig.deploymentBlock = 0;\n\n  ok('NETWORK_CONFIG patched');\n\n  // ── Step 2: Connect to local node ───────────────────────────\n  step(2, 'Connect to local node');\n\n  const userPrivateKey = config.userPrivateKey || DEFAULT_USER_PRIVATE_KEY;\n  const mnemonic = config.mnemonic || DEFAULT_MNEMONIC;\n\n  const jsonRpcProvider = new JsonRpcProvider(config.rpc, config.chainId);\n  const blockNumber = await jsonRpcProvider.getBlockNumber();\n  info(`Current block: ${blockNumber}`);\n\n  const userWallet = new Wallet(userPrivateKey, jsonRpcProvider);\n  const userAddress = await userWallet.getAddress();\n  const ethBalance = await jsonRpcProvider.getBalance(userAddress);\n  info(`User address: ${userAddress}`);\n  info(`ETH balance: ${ethers.formatEther(ethBalance)} ETH`);\n  if (ethBalance === 0n) {\n    fail('User account has 0 ETH — wrong private key or unfunded account?');\n    process.exit(1);\n  }\n  ok('Connected to local node');\n\n  // ── Step 3: Initialize Matrix Engine ────────────────────────\n  step(3, 'Initialize Matrix Engine');\n\n  await rmDirSafe(DB_PATH);\n  // Keep ARTIFACTS_DIR across runs so IPFS-downloaded circuit artifacts are cached.\n\n  const db = new LevelDOWN(DB_PATH);\n\n  const artifactStore = new ArtifactStore(\n    (filePath) => fs.promises.readFile(path.resolve(ARTIFACTS_DIR, filePath)),\n    async (dir, filePath, data) => {\n      const fullDir = path.resolve(ARTIFACTS_DIR, dir);\n      const fullPath = path.resolve(ARTIFACTS_DIR, filePath);\n      await fs.promises.mkdir(fullDir, { recursive: true });\n      await fs.promises.writeFile(fullPath, data);\n    },\n    async (filePath) => fileExists(path.resolve(ARTIFACTS_DIR, filePath)),\n  );\n\n  setLoggers(console.log, console.error);\n\n  await startMatrixEngine(\n    'locale2etest',  // walletSource (max 16 chars, lowercase, no hyphens)\n    db,              // database\n    true,            // shouldDebug\n    artifactStore,   // artifactStore\n    false,           // useNativeArtifacts (nodejs = false)\n    false,           // skipMerkletreeScans\n    false,           // verboseScanLogging\n  );\n\n  getEngine().prover.setSnarkJSGroth16(groth16 as SnarkJSGroth16);\n\n  ok('Engine initialized');\n\n  // ── Step 4: Load network provider ──────────────────────────\n  step(4, 'Load network provider');\n\n  const fallbackProviderConfig: FallbackProviderJsonConfig = {\n    chainId: config.chainId,\n    providers: [\n      {\n        provider: config.rpc,\n        priority: 1,\n        weight: 2,\n        maxLogsPerBatch: 100,\n        stallTimeout: 5000,\n      },\n    ],\n  };\n\n  const { feesSerialized } = await loadProvider(\n    fallbackProviderConfig,\n    NetworkName.Hardhat,\n    5000, // pollingInterval (5s for local)\n  );\n\n  info(`Shield fee: ${feesSerialized.shieldFee} bps`);\n  info(`Unshield fee: ${feesSerialized.unshieldFee} bps`);\n  ok('Provider loaded, network connected');\n\n  // ── Step 5: Create Matrix wallet ───────────────────────────\n  step(5, 'Create Matrix wallet');\n\n  const walletInfo = await createMatrixWallet(\n    DB_ENCRYPTION_KEY,\n    mnemonic,\n    { [NetworkName.Hardhat]: 0 },\n    0, // derivationIndex\n  );\n\n  info(`Wallet ID: ${walletInfo.id}`);\n  info(`Matrix address: ${walletInfo.matrixAddress}`);\n  ok('Wallet created');\n\n  // ── Step 6: Set up event listeners and scan ────────────────\n  step(6, 'Scan contract history');\n\n  let scanComplete = false;\n  const scanPromise = new Promise<void>((resolve) => {\n    setOnUTXOMerkletreeScanCallback((scanData: MerkletreeScanUpdateEvent) => {\n      info(`Scan: status=${scanData.scanStatus}, progress=${(scanData.progress * 100).toFixed(1)}%`);\n      if (scanData.scanStatus === MerkletreeScanStatus.Complete) {\n        scanComplete = true;\n        resolve();\n      }\n    });\n  });\n\n  let balanceUpdated = false;\n  setOnBalanceUpdateCallback(() => {\n    balanceUpdated = true;\n  });\n\n  const { chain } = NETWORK_CONFIG[NetworkName.Hardhat];\n  getEngine().scanContractHistory(chain, undefined);\n\n  // Wait for initial scan (should be fast on empty chain)\n  const scanTimeout = setTimeout(() => {\n    if (!scanComplete) {\n      info('Scan taking long, continuing...');\n    }\n  }, 10000);\n\n  await Promise.race([\n    scanPromise,\n    new Promise(resolve => setTimeout(resolve, 15000)),\n  ]);\n  clearTimeout(scanTimeout);\n\n  ok('Initial scan complete');\n\n  // ── Step 7: Wrap ETH → WETH ────────────────────────────────\n  step(7, 'Wrap ETH → WETH');\n\n  const weth = new Contract(config.weth, WETH9_ABI, userWallet);\n\n  // Ganache instamine + ethers v6 nonce caching = stale nonces.\n  // Fetch once, increment locally for each send.\n  let nonce = await jsonRpcProvider.getTransactionCount(userAddress, 'pending');\n  info(`Starting nonce: ${nonce}`);\n\n  info(`Depositing ${ethers.formatEther(SHIELD_AMOUNT)} ETH → WETH...`);\n  const depositTx = await weth.deposit({ value: SHIELD_AMOUNT, nonce: nonce++ }) as ContractTransactionResponse;\n  await depositTx.wait();\n\n  const wethBalance = await weth.balanceOf(userAddress);\n  info(`WETH balance: ${ethers.formatEther(wethBalance)}`);\n  ok('ETH wrapped to WETH');\n\n  // ── Step 8: Approve TokenVault to spend WETH ───────────────\n  step(8, 'Approve TokenVault for WETH');\n\n  info(`Approving ${config.tokenVaultProxy} to spend WETH...`);\n  const approveTx = await weth.approve(\n    config.tokenVaultProxy,\n    SHIELD_AMOUNT,\n    { nonce: nonce++ },\n  ) as ContractTransactionResponse;\n  await approveTx.wait();\n\n  ok('TokenVault approved');\n\n  // ── Step 9: Shield WETH into Matrix wallet ─────────────────\n  step(9, 'Shield WETH');\n\n  // Generate a shield private key (random for testing)\n  const shieldPrivateKey = ByteUtils.randomHex(32);\n  info(`Shield private key: ${shieldPrivateKey.slice(0, 18)}...`);\n  info(`Shield message: \"${getShieldPrivateKeySignatureMessage()}\"`);\n\n  const erc20AmountRecipients = [\n    {\n      tokenAddress: config.weth,\n      amount: SHIELD_AMOUNT,\n      recipientAddress: walletInfo.matrixAddress,\n    },\n  ];\n\n  info('Populating shield transaction...');\n  const { transaction: shieldTx } = await populateShield(\n    NetworkName.Hardhat,\n    shieldPrivateKey,\n    erc20AmountRecipients,\n    [], // nftAmountRecipients\n    undefined, // gasDetails (let the node estimate)\n  );\n\n  info(`Shield tx to: ${shieldTx.to}`);\n  info('Sending shield transaction...');\n\n  const sentTx = await userWallet.sendTransaction({ ...shieldTx, nonce: nonce++ });\n  info(`TX hash: ${sentTx.hash}`);\n\n  const receipt = await sentTx.wait();\n  info(`TX confirmed in block ${receipt?.blockNumber}, gas used: ${receipt?.gasUsed.toString()}`);\n  ok('Shield transaction confirmed');\n\n  // ── Step 10: Wait for balance update ───────────────────────\n  step(10, 'Wait for balance scan after shield');\n\n  info('Triggering rescan...');\n  balanceUpdated = false;\n\n  getEngine().scanContractHistory(chain, undefined);\n\n  // Wait for balance update\n  const balanceTimeout = 30000;\n  const startTime = Date.now();\n  while (!balanceUpdated && Date.now() - startTime < balanceTimeout) {\n    await new Promise(resolve => setTimeout(resolve, 500));\n  }\n\n  if (balanceUpdated) {\n    ok('Balance updated after shield');\n  } else {\n    info('Balance update not received within timeout — check engine logs above');\n  }\n\n  // ── Step 11: Query private balance ───────────────────────\n  step(11, 'Query private balance after shield');\n\n  const wallet1 = walletForID(walletInfo.id);\n  const balances1 = await wallet1.getTokenBalances(chain, false);\n  const erc20Balances1 = getSerializedERC20Balances(balances1);\n  const shieldedWeth = erc20Balances1.find(\n    b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase(),\n  );\n\n  if (shieldedWeth) {\n    info(`Private WETH balance: ${ethers.formatEther(shieldedWeth.amount)}`);\n  } else {\n    fail('No WETH found in private balance!');\n    process.exit(1);\n  }\n  ok('Private balance confirmed');\n\n  // ── Step 12: Create second wallet (recipient) ────────────\n  step(12, 'Create second Matrix wallet (recipient)');\n\n  const wallet2Info = await createMatrixWallet(\n    DB_ENCRYPTION_KEY,\n    mnemonic,\n    { [NetworkName.Hardhat]: 0 },\n    1, // derivation index 1\n  );\n\n  info(`Wallet 2 ID: ${wallet2Info.id}`);\n  info(`Wallet 2 address: ${wallet2Info.matrixAddress}`);\n  ok('Second wallet created');\n\n  // ── Step 13: Private transfer ────────────────────────────\n  step(13, 'Private transfer (ZK proof)');\n\n  info(`Transferring ${ethers.formatEther(TRANSFER_AMOUNT)} WETH to wallet 2...`);\n  info('Generating transfer proof (this may take ~30-60s)...');\n\n  const transferRecipients = [\n    {\n      tokenAddress: config.weth,\n      amount: TRANSFER_AMOUNT,\n      recipientAddress: wallet2Info.matrixAddress,\n    },\n  ];\n\n  await generateTransferProof(\n    NetworkName.Hardhat,\n    walletInfo.id,\n    DB_ENCRYPTION_KEY,\n    false,     // showSenderAddressToRecipient\n    undefined, // memoText\n    transferRecipients,\n    [],        // nftAmountRecipients\n    undefined, // broadcasterFeeERC20AmountRecipient\n    true,      // sendWithPublicWallet\n    undefined, // overallBatchMinGasPrice\n    (progress, status) => {\n      info(`Proof: ${status} (${(progress * 100).toFixed(1)}%)`);\n    },\n  );\n  ok('Transfer proof generated');\n\n  const transferGasDetails = await getGasDetails(jsonRpcProvider);\n\n  const { transaction: transferTx } = await populateProvedTransfer(\n    NetworkName.Hardhat,\n    walletInfo.id,\n    false,     // showSenderAddressToRecipient\n    undefined, // memoText\n    transferRecipients,\n    [],        // nftAmountRecipients\n    undefined, // broadcasterFeeERC20AmountRecipient\n    true,      // sendWithPublicWallet\n    undefined, // overallBatchMinGasPrice\n    transferGasDetails,\n  );\n\n  info(`Transfer tx to: ${transferTx.to}`);\n  const sentTransferTx = await userWallet.sendTransaction({ ...transferTx, nonce: nonce++ });\n  info(`TX hash: ${sentTransferTx.hash}`);\n\n  const transferReceipt = await sentTransferTx.wait();\n  info(`TX confirmed in block ${transferReceipt?.blockNumber}, gas used: ${transferReceipt?.gasUsed.toString()}`);\n  ok('Private transfer confirmed on-chain');\n\n  // ── Step 14: Rescan + verify transfer balances ───────────\n  step(14, 'Rescan after transfer');\n\n  getEngine().scanContractHistory(chain, undefined);\n  const scanOk1 = await waitForScan();\n  if (scanOk1) {\n    ok('Scan complete');\n  } else {\n    info('Scan timeout — continuing');\n  }\n\n  // Query both wallets (balance deserialization may fail for wallet 2 — investigate separately)\n  let w1Weth: { tokenAddress: string; amount: bigint } | undefined;\n  let w2Weth: { tokenAddress: string; amount: bigint } | undefined;\n  try {\n    const w1PostTransfer = await walletForID(walletInfo.id).getTokenBalances(chain, false);\n    const w1Erc20 = getSerializedERC20Balances(w1PostTransfer);\n    w1Weth = w1Erc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());\n    info(`Wallet 1 private WETH: ${w1Weth ? ethers.formatEther(w1Weth.amount) : '0'}`);\n  } catch (err) {\n    info(`Wallet 1 balance query failed: ${(err as Error).message}`);\n  }\n  try {\n    const wallet2 = walletForID(wallet2Info.id);\n    const w2PostTransfer = await wallet2.getTokenBalances(chain, false);\n    const w2Erc20 = getSerializedERC20Balances(w2PostTransfer);\n    w2Weth = w2Erc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());\n    info(`Wallet 2 private WETH: ${w2Weth ? ethers.formatEther(w2Weth.amount) : '0'}`);\n  } catch (err) {\n    info(`Wallet 2 balance query failed: ${(err as Error).message}`);\n  }\n  ok('Transfer balances checked');\n\n  // ── Step 15: Unshield from wallet 1 ──────────────────────\n  step(15, 'Unshield WETH (ZK proof)');\n\n  info(`Unshielding ${ethers.formatEther(UNSHIELD_AMOUNT)} WETH to ${userAddress}...`);\n  info('Generating unshield proof (this may take ~30-60s)...');\n\n  const unshieldRecipients = [\n    {\n      tokenAddress: config.weth,\n      amount: UNSHIELD_AMOUNT,\n      recipientAddress: userAddress, // public ETH address\n    },\n  ];\n\n  await generateUnshieldProof(\n    NetworkName.Hardhat,\n    walletInfo.id,\n    DB_ENCRYPTION_KEY,\n    unshieldRecipients,\n    [],        // nftAmountRecipients\n    undefined, // broadcasterFeeERC20AmountRecipient\n    true,      // sendWithPublicWallet\n    undefined, // overallBatchMinGasPrice\n    (progress, status) => {\n      info(`Proof: ${status} (${(progress * 100).toFixed(1)}%)`);\n    },\n  );\n  ok('Unshield proof generated');\n\n  const unshieldGasDetails = await getGasDetails(jsonRpcProvider);\n\n  const { transaction: unshieldTx } = await populateProvedUnshield(\n    NetworkName.Hardhat,\n    walletInfo.id,\n    unshieldRecipients,\n    [],        // nftAmountRecipients\n    undefined, // broadcasterFeeERC20AmountRecipient\n    true,      // sendWithPublicWallet\n    undefined, // overallBatchMinGasPrice\n    unshieldGasDetails,\n  );\n\n  info(`Unshield tx to: ${unshieldTx.to}`);\n  const sentUnshieldTx = await userWallet.sendTransaction({ ...unshieldTx, nonce: nonce++ });\n  info(`TX hash: ${sentUnshieldTx.hash}`);\n\n  const unshieldReceipt = await sentUnshieldTx.wait();\n  info(`TX confirmed in block ${unshieldReceipt?.blockNumber}, gas used: ${unshieldReceipt?.gasUsed.toString()}`);\n  ok('Unshield confirmed on-chain');\n\n  // ── Step 16: Rescan + verify unshield ────────────────────\n  step(16, 'Verify unshield');\n\n  getEngine().scanContractHistory(chain, undefined);\n  const scanOk2 = await waitForScan();\n  if (scanOk2) {\n    ok('Scan complete');\n  } else {\n    info('Scan timeout — continuing');\n  }\n\n  const postUnshieldWeth = await weth.balanceOf(userAddress);\n  info(`Public WETH balance after unshield: ${ethers.formatEther(postUnshieldWeth)}`);\n\n  let w1FinalWeth: { tokenAddress: string; amount: bigint } | undefined;\n  try {\n    const w1Final = await walletForID(walletInfo.id).getTokenBalances(chain, false);\n    const w1FinalErc20 = getSerializedERC20Balances(w1Final);\n    w1FinalWeth = w1FinalErc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());\n    info(`Wallet 1 final private WETH: ${w1FinalWeth ? ethers.formatEther(w1FinalWeth.amount) : '0'}`);\n  } catch (err) {\n    info(`Wallet 1 final balance query failed: ${(err as Error).message}`);\n  }\n\n  ok('Unshield verified');\n\n  // ── Step 17: Final summary ───────────────────────────────\n  step(17, 'Final Summary');\n\n  const finalEthBalance = await jsonRpcProvider.getBalance(userAddress);\n  const finalWethBalance = await weth.balanceOf(userAddress);\n\n  let w2FinalWeth: { tokenAddress: string; amount: bigint } | undefined;\n  try {\n    const w2Final = await walletForID(wallet2Info.id).getTokenBalances(chain, false);\n    const w2FinalErc20 = getSerializedERC20Balances(w2Final);\n    w2FinalWeth = w2FinalErc20.find(b => b.tokenAddress.toLowerCase() === config.weth.toLowerCase());\n  } catch (err) {\n    info(`Wallet 2 final balance query failed: ${(err as Error).message}`);\n  }\n\n  console.log('\\n  Public wallet:');\n  info(`ETH:  ${ethers.formatEther(finalEthBalance)}`);\n  info(`WETH: ${ethers.formatEther(finalWethBalance)}`);\n  console.log('\\n  Private wallets:');\n  info(`Wallet 1: ${w1FinalWeth ? ethers.formatEther(w1FinalWeth.amount) : '0'} WETH`);\n  info(`Wallet 2: ${w2FinalWeth ? ethers.formatEther(w2FinalWeth.amount) : '0'} WETH`);\n  console.log('\\n  Operations completed:');\n  info(`Shield:   ${ethers.formatEther(SHIELD_AMOUNT)} WETH (fee ${feesSerialized.shieldFee} bps)`);\n  info(`Transfer: ${ethers.formatEther(TRANSFER_AMOUNT)} WETH (wallet 1 -> wallet 2)`);\n  info(`Unshield: ${ethers.formatEther(UNSHIELD_AMOUNT)} WETH (fee ${feesSerialized.unshieldFee} bps)`);\n  console.log('');\n\n  // ── Cleanup ────────────────────────────────────────────────\n  await stopMatrixEngine();\n  ok('Engine stopped. Full E2E test complete.\\n');\n  process.exit(0);\n}\n\nmain().catch((err) => {\n  console.error('\\n  [FATAL]', err);\n  process.exit(1);\n});\n"]}

package/dist/tests/mocks.test.d.ts

@@ -0,0 +1,40 @@
+import { FallbackProviderJsonConfig, FeeTokenDetails, MatrixERC20Amount, MatrixNFTAmountRecipient, MatrixNFTAmount, TransactionGasDetails, MatrixERC20Recipient } from '@matrix-privacy/shared-models';
+import { BalancesUpdatedCallback } from '../services/matrix/wallets/balance-update';
+import { CommitmentCiphertextV3 } from '@matrix-privacy/engine';
+export declare const MOCK_MNEMONIC = "test test test test test test test test test test test junk";
+export declare const MOCK_MNEMONIC_2 = "pause crystal tornado alcohol genre cement fade large song like bag where";
+export declare const MOCK_DB_ENCRYPTION_KEY = "0101010101010101010101010101010101010101010101010101010101010101";
+export declare const MOCK_MEMO = "A nice little mock memo, and how bout a little more for ya? \uD83E\uDD29";
+export declare const MOCK_MATRIX_WALLET_ADDRESS = "0zk1q8hxknrs97q8pjxaagwthzc0df99rzmhl2xnlxmgv9akv32sua0kfrv7j6fe3z53llhxknrs97q8pjxaagwthzc0df99rzmhl2xnlxmgv9akv32sua0kg0zpzts";
+export declare const MOCK_ETH_WALLET_ADDRESS = "0x9E9F988356f46744Ee0374A17a5Fa1a3A3cC3777";
+export declare const MOCK_TOKEN_ADDRESS = "0x5FbDB2315678afecb367f032d93F642f64180aa3";
+export declare const MOCK_TOKEN_ADDRESS_2 = "0xe76C6c83af64e4C60245D8C7dE953DF673a7A33D";
+export declare const MOCK_NFT_ADDRESS = "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d";
+export declare const TEST_POLYGON_RPC = "https://polygon-rpc.com";
+export declare const TEST_WALLET_SOURCE = "test engine";
+export declare const MOCK_TOKEN_AMOUNTS_TOKEN_1_ONLY: MatrixERC20Amount[];
+export declare const MOCK_TOKEN_AMOUNTS: MatrixERC20Amount[];
+export declare const MOCK_ERC20_RECIPIENTS: MatrixERC20Recipient[];
+export declare const MOCK_NFT_AMOUNTS: MatrixNFTAmount[];
+export declare const MOCK_COMMITMENTS: string[];
+export declare const MOCK_NULLIFIERS: string[];
+export declare const MOCK_BOUND_PARAMS_V3: {
+    local: {
+        commitmentCiphertext: {
+            ciphertext: string;
+            blindedSenderViewingKey: string;
+            blindedReceiverViewingKey: string;
+        }[];
+    };
+};
+export declare const MOCK_COMMITMENT_HASH = "0x2b13bccd4974c797df42a89221ed6e19e50c32055058cdcc5a8ea836233e4cab";
+export declare const MOCK_FORMATTED_BROADCASTER_FEE_COMMITMENT_CIPHERTEXT_V3: CommitmentCiphertextV3;
+export declare const MOCK_NFT_AMOUNT_RECIPIENTS: MatrixNFTAmountRecipient[];
+export declare const MOCK_NFT_AMOUNT_RECIPIENTS_UNSHIELD: MatrixNFTAmountRecipient[];
+export declare const MOCK_TOKEN_FEE: MatrixERC20Amount;
+export declare const MOCK_FEE_TOKEN_DETAILS: FeeTokenDetails;
+export declare const MOCK_TRANSACTION_GAS_DETAILS_SERIALIZED_TYPE_2: TransactionGasDetails;
+export declare const MOCK_BALANCES_UPDATE_CALLBACK: BalancesUpdatedCallback;
+export declare const MOCK_FALLBACK_PROVIDER_JSON_CONFIG_POLYGON: FallbackProviderJsonConfig;
+export declare const MOCK_FALLBACK_PROVIDER_JSON_CONFIG_SEPOLIA: FallbackProviderJsonConfig;
+export declare const MOCK_FALLBACK_PROVIDER_JSON_CONFIG_ETHEREUM: FallbackProviderJsonConfig;