chore: add proxy wallet recovery script

One-shot script that calls ProxyWalletFactory.proxy() to:
1. Deploy a phantom CREATE2 proxy wallet that was never deployed
2. Transfer stuck ERC20 tokens (USDC.e + USDC) back to the EOA

Used to recover 55.49 USDC.e + 2.5 USDC that were sent to a
proxy address derived by the CLI but never deployed on-chain.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: croll83

scripts/recover-proxy-funds.js

@@ -0,0 +1,161 @@
+/**
+ * Recovery script: deploy phantom proxy wallet via factory and transfer stuck USDC back to EOA.
+ *
+ * The polymarket-cli derived a proxy address via CREATE2 but never deployed the contract.
+ * 55.49 USDC.e + 2.5 USDC are stuck at that address.
+ *
+ * This script calls the ProxyWalletFactory.proxy() which:
+ *   1. Auto-deploys the proxy wallet (CREATE2) if it doesn't exist
+ *   2. Executes ERC20 transfer calls through the proxy to send funds back to the EOA
+ *
+ * Usage:
+ *   DRY_RUN=1 node recover-proxy-funds.js   # simulate only
+ *   node recover-proxy-funds.js              # execute for real
+ */
+
+const { ethers } = require("ethers");
+
+// ─── Configuration ───────────────────────────────────────────────────────────
+
+const RPC_URL = "https://polygon.drpc.org";
+const PRIVATE_KEY = "0x67369faeaf47af03ea0519a3e40431d3bdf947454c2f121a7672593ebdc657a9";
+
+const FACTORY_ADDRESS = "0xaB45c5A4B0c941a2F231C04C3f49182e1A254052";
+const PHANTOM_PROXY   = "0x17a535cdd1cdb870b0e8d735c1dcc95e14727caf";
+
+// Tokens stuck at the phantom proxy
+const USDC_E = "0x2791bca1f2de4661ed88a30c99a7a9449aa84174"; // USDC.e (PoS bridged)
+const USDC   = "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"; // native USDC
+
+// ─── ABIs ────────────────────────────────────────────────────────────────────
+
+const FACTORY_ABI = [
+  "function proxy(tuple(uint8 operation, address to, uint256 value, bytes data)[] calls) payable returns (bytes[])",
+];
+
+const ERC20_ABI = [
+  "function transfer(address to, uint256 amount) returns (bool)",
+  "function balanceOf(address account) view returns (uint256)",
+];
+
+// ─── Main ────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const dryRun = process.env.DRY_RUN === "1";
+
+  const provider = new ethers.JsonRpcProvider(RPC_URL);
+  const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
+  const eoa = wallet.address;
+
+  console.log("EOA address:     ", eoa);
+  console.log("Phantom proxy:   ", PHANTOM_PROXY);
+  console.log("Factory:         ", FACTORY_ADDRESS);
+  console.log("Dry run:         ", dryRun);
+  console.log();
+
+  // Verify EOA matches expected
+  if (eoa.toLowerCase() !== "0x7b75418121134dce9d0a40a80762a8d8f379d49d") {
+    throw new Error(`EOA mismatch! Got ${eoa}, expected 0x7b754...`);
+  }
+
+  // Check phantom proxy has no code (not yet deployed)
+  const code = await provider.getCode(PHANTOM_PROXY);
+  if (code !== "0x") {
+    console.log("WARNING: Proxy already has code deployed. It may have been deployed already.");
+    console.log("Code:", code.slice(0, 40) + "...");
+  } else {
+    console.log("Confirmed: no contract at phantom proxy (will be deployed by factory)");
+  }
+
+  // Check token balances at phantom proxy
+  const usdcE = new ethers.Contract(USDC_E, ERC20_ABI, provider);
+  const usdc  = new ethers.Contract(USDC, ERC20_ABI, provider);
+
+  const balUsdcE = await usdcE.balanceOf(PHANTOM_PROXY);
+  const balUsdc  = await usdc.balanceOf(PHANTOM_PROXY);
+
+  console.log(`USDC.e balance:   ${ethers.formatUnits(balUsdcE, 6)} USDC.e`);
+  console.log(`USDC balance:     ${ethers.formatUnits(balUsdc, 6)} USDC`);
+  console.log();
+
+  if (balUsdcE === 0n && balUsdc === 0n) {
+    console.log("Nothing to recover — both balances are zero.");
+    return;
+  }
+
+  // Build ERC20 transfer calldata
+  const erc20Iface = new ethers.Interface(ERC20_ABI);
+  const calls = [];
+
+  if (balUsdcE > 0n) {
+    calls.push({
+      operation: 1, // CALL through proxy
+      to: USDC_E,
+      value: 0,
+      data: erc20Iface.encodeFunctionData("transfer", [eoa, balUsdcE]),
+    });
+  }
+
+  if (balUsdc > 0n) {
+    calls.push({
+      operation: 1, // CALL through proxy
+      to: USDC,
+      value: 0,
+      data: erc20Iface.encodeFunctionData("transfer", [eoa, balUsdc]),
+    });
+  }
+
+  console.log(`Prepared ${calls.length} transfer call(s) through factory.proxy()`);
+  for (const c of calls) {
+    console.log(`  → transfer to ${eoa} via token ${c.to}`);
+  }
+  console.log();
+
+  const factory = new ethers.Contract(FACTORY_ADDRESS, FACTORY_ABI, wallet);
+
+  if (dryRun) {
+    // Simulate with eth_call
+    console.log("=== DRY RUN: simulating transaction ===");
+    try {
+      const result = await factory.proxy.staticCall(calls);
+      console.log("Simulation SUCCESS!");
+      console.log("Return values:", result);
+    } catch (err) {
+      console.error("Simulation FAILED:", err.message);
+      if (err.data) console.error("Revert data:", err.data);
+    }
+    return;
+  }
+
+  // Execute for real
+  console.log("=== EXECUTING TRANSACTION ===");
+  const tx = await factory.proxy(calls, {
+    gasLimit: 500_000, // generous limit for proxy deploy + 2 transfers
+  });
+  console.log("Transaction sent:", tx.hash);
+  console.log("Waiting for confirmation...");
+
+  const receipt = await tx.wait();
+  console.log();
+  console.log("Transaction confirmed!");
+  console.log("Block:       ", receipt.blockNumber);
+  console.log("Gas used:    ", receipt.gasUsed.toString());
+  console.log("Status:      ", receipt.status === 1 ? "SUCCESS" : "FAILED");
+  console.log(`Polygonscan:  https://polygonscan.com/tx/${tx.hash}`);
+
+  // Verify funds arrived at EOA
+  console.log();
+  console.log("=== Post-recovery balances ===");
+  const newBalProxy_E = await usdcE.balanceOf(PHANTOM_PROXY);
+  const newBalProxy_U = await usdc.balanceOf(PHANTOM_PROXY);
+  const newBalEoa_E   = await usdcE.balanceOf(eoa);
+  const newBalEoa_U   = await usdc.balanceOf(eoa);
+
+  console.log(`Phantom proxy:  ${ethers.formatUnits(newBalProxy_E, 6)} USDC.e, ${ethers.formatUnits(newBalProxy_U, 6)} USDC`);
+  console.log(`EOA:            ${ethers.formatUnits(newBalEoa_E, 6)} USDC.e, ${ethers.formatUnits(newBalEoa_U, 6)} USDC`);
+}
+
+main().catch((err) => {
+  console.error("FATAL:", err);
+  process.exit(1);
+});