@gvnrdao/dh-sdk 0.0.299 → 0.0.301

package/dist/index.mjs

@@ -422,6 +422,20 @@ var init_deployment_addresses = __esm({
           upgradedAt: "2026-06-16T17:53:24.979Z",
           upgradedBy: "0xEba7BfAeB35ee18408b424Ee0BB45AdDf776589f",
           reason: "Initial PSM deploy / artifact sync"
+        },
+        CollateralManagerModule: {
+          previousImplementation: "0x1919860e528Cd2AbbD31a17858c986b8aCc8C185",
+          newImplementation: "0x55110B9dd6B2c9f812564e7a1ef42b3c76E1A3Bb",
+          upgradedAt: "2026-07-08T20:33:59Z",
+          upgradedBy: "AdminModule generic-op 0x740efe0cfe85044479cbd8ee3058aa244057d90703dd2b37044dd6787cbf3485 (3-of-5 ADMIN_ROLE Safes, 24h timelock; executed by 0xfb3B8cbeFB7D666A6Af34C53e189EdC31862a7be in tx 0x430c8e450f12d3d9359cde356ac5e2ef39661d7a89884b5674a596c1090f6cff)",
+          reason: "Validator gas fix (#420): BitcoinAddressValidator packed-table lookups; VERSION 1.3.0 -> 1.3.1"
+        },
+        BitcoinWithdrawalAddressRegistry: {
+          previousImplementation: "0x11731bFEC3068F2cc19D016381dfEA3B93013b1C",
+          newImplementation: "0x190c08300Ae650fb88ed8156445BBeb13bE9E8a3",
+          upgradedAt: "2026-07-08T20:33:59Z",
+          upgradedBy: "AdminModule generic-op 0x2603a486c0f34554b864cc1d909b325c7e105331da10ec0fd7e0b9373fa76207 (3-of-5 ADMIN_ROLE Safes, 24h timelock; executed by 0xfb3B8cbeFB7D666A6Af34C53e189EdC31862a7be in tx 0x430c8e450f12d3d9359cde356ac5e2ef39661d7a89884b5674a596c1090f6cff)",
+          reason: "Validator gas fix (#420): BitcoinAddressValidator packed-table lookups; VERSION 1.0.0 -> 1.0.1"
         }
       },
       latestEnv: {
@@ -1196,17 +1210,17 @@ var require_pkg_src = __commonJS({
         }
       },
       btcTransactionSigner: {
-        cid: "QmZs56sVTCJv7mgvyRYfpYHFvFLcSeXa4H44qUYT7z14QP",
+        cid: "QmcPG9C5Yx9JGrBKCfSVWbKuiRXn8XFwb91yNxQqY4VSJD",
         authorizedCidHex: cidToHex(
-          "QmZs56sVTCJv7mgvyRYfpYHFvFLcSeXa4H44qUYT7z14QP"
+          "QmcPG9C5Yx9JGrBKCfSVWbKuiRXn8XFwb91yNxQqY4VSJD"
         ),
         name: "Btc Transaction Signer",
         description: "Production Btc Transaction Signer",
-        version: "1.0.0",
+        version: "1.0.1",
         deployed: true,
-        deployedAt: 1781542204806,
-        size: 42376,
-        hash: "f4aed3d88f6fbff6623ed2047436cecd4f561a74883171ea6f4ebe0a1129973c"
+        deployedAt: 1783451891948,
+        size: 43688,
+        hash: "1ea0f0ac66cc68fc9b098dabb3c5e3ba96c25f13b133b95a06eac477028fdb1a"
       },
       ucdMintValidator: {
         cid: "QmPir8F8jmJ4ssQpEC3xFxkEnZxMHcgS6VxBQE1jkTLj5K",
@@ -2146,7 +2160,7 @@ ${errorReport}`);
     }
     init_debug_logger();
     init_session_signature_cache();
-    var import_ethers15 = __require("ethers");
+    var import_ethers16 = __require("ethers");
     var EXPIRED_LOAN_MIN_LIQUIDATION_THRESHOLD_BPS = 11e3;
     var GRACE_PERIOD_DAYS = 30;
     var SATOSHIS_PER_BITCOIN = 100000000n;
@@ -4381,12 +4395,12 @@ ${auth.clientId}`;
     }
     async function executeVaultSnapshot(params) {
       global.ethers = {
-        ...import_ethers15.ethers,
+        ...import_ethers16.ethers,
         providers: {
-          StaticJsonRpcProvider: import_ethers15.ethers.JsonRpcProvider
+          StaticJsonRpcProvider: import_ethers16.ethers.JsonRpcProvider
         },
-        Contract: import_ethers15.ethers.Contract,
-        utils: import_ethers15.ethers
+        Contract: import_ethers16.ethers.Contract,
+        utils: import_ethers16.ethers
         // v6 moved utils to top level
       };
       global.Lit = {
@@ -4837,7 +4851,7 @@ var init_network_configs = __esm({
 });
 
 // src/modules/diamond-hands-sdk.ts
-import { Contract as Contract6, Interface as Interface4, JsonRpcProvider, AbiCoder, keccak256 as keccak2565, solidityPackedKeccak256 as solidityPackedKeccak2564, toUtf8Bytes as toUtf8Bytes5, zeroPadValue as zeroPadValue4, toBeHex as toBeHex2, parseEther, formatEther, formatUnits, computeAddress, Signature, ZeroHash, ZeroAddress as ZeroAddress3, MaxUint256 } from "ethers";
+import { Contract as Contract6, Interface as Interface4, JsonRpcProvider, AbiCoder as AbiCoder2, keccak256 as keccak2565, solidityPackedKeccak256 as solidityPackedKeccak2564, toUtf8Bytes as toUtf8Bytes5, zeroPadValue as zeroPadValue4, toBeHex as toBeHex2, parseEther, formatEther, formatUnits, computeAddress, Signature, ZeroHash, ZeroAddress as ZeroAddress3, MaxUint256 } from "ethers";
 
 // src/types/result.ts
 function success(value) {
@@ -5221,22 +5235,12 @@ var SDKError = class _SDKError extends Error {
 
 // src/utils/chunks/eip1559-broadcast.utils.ts
 import { parseUnits } from "ethers";
-var MINT_UCD_GAS_CEILING = BigInt(2e6);
+var MINT_UCD_GAS_CEILING = BigInt(13e5);
 var WITHDRAW_BTC_GAS_CEILING = BigInt(3e6);
 var MAKE_PAYMENT_GAS_CEILING = BigInt(1e6);
 var EXTEND_POSITION_GAS_CEILING = BigInt(1e6);
 var LIQUIDATION_COMMIT_GAS_CEILING = BigInt(1e6);
 var LIQUIDATION_REVEAL_GAS_CEILING = BigInt(2e6);
-var MINT_UCD_ESTIMATE_MARGIN_BPS = 2500;
-async function estimateContractCallGasWithMargin(provider, from, to, data, marginBps, ceiling) {
-  try {
-    const estimated = await provider.estimateGas({ from, to, data });
-    const withMargin = estimated * BigInt(1e4 + marginBps) / 10000n;
-    return withMargin > ceiling ? ceiling : withMargin;
-  } catch {
-    return null;
-  }
-}
 async function resolveEip1559FeeFields(provider) {
   const feeData = await provider.getFeeData();
   let maxFeePerGas = feeData.maxFeePerGas ?? void 0;
@@ -5839,6 +5843,122 @@ var ServerSession = class {
   }
 };
 
+// src/utils/quantum-revert.utils.ts
+import { AbiCoder } from "ethers";
+var DEAD_ZONE_VIOLATION_SELECTOR = "0xbe4b82c1";
+var ERROR_STRING_SELECTOR = "0x08c379a0";
+var PANIC_SELECTOR = "0x4e487b71";
+var QUANTUM_REVERT_NAMES = {
+  "0xbe4b82c1": "DeadZoneViolation()",
+  "0x137f3b70": "InDeadZone()",
+  "0x131d9a21": "QuantumExpired()",
+  "0x52ce5d58": "QuantumAlreadyUsed()",
+  "0x3e76a3c9": "QuantumOutsideWindow()",
+  "0x8baa579f": "InvalidSignature()",
+  "0x62278171": "InvalidValidatorSignature()",
+  "0x3ee5aeb5": "OperationNotAuthorized()",
+  "0x48f5c3ed": "Unauthorized()",
+  "0x70f4b32a": "UnauthorizedSigner()",
+  "0xd92e233d": "ValidationFailed()",
+  "0x36bfdeea": "StateHashMismatch()",
+  "0xb9d419a7": "DebtUpdateVerificationFailed()",
+  "0xc7e20553": "DebtUpdateVerificationFailedDetailed(bytes32,uint256,uint256,uint256,uint256,uint256)",
+  "0x0cfd2a97": "MintVerificationMismatch(uint256,uint256)",
+  "0x07637bd8": "MintFailed()"
+};
+function decodeQuantumRevert(e) {
+  const raw = e?.data ?? e?.info?.error?.data ?? // ethers v6 BrowserProvider (MetaMask)
+  e?.error?.data?.data ?? e?.error?.data ?? e?.error?.error?.data;
+  const data = typeof raw === "string" && raw.startsWith("0x") ? raw : null;
+  const selector = data && data.length >= 10 ? data.slice(0, 10) : null;
+  let name = selector ? QUANTUM_REVERT_NAMES[selector] ?? null : null;
+  if (!name && selector && data) {
+    try {
+      if (selector === ERROR_STRING_SELECTOR) {
+        const [message] = AbiCoder.defaultAbiCoder().decode(
+          ["string"],
+          "0x" + data.slice(10)
+        );
+        name = `Error("${message}")`;
+      } else if (selector === PANIC_SELECTOR) {
+        const [code] = AbiCoder.defaultAbiCoder().decode(
+          ["uint256"],
+          "0x" + data.slice(10)
+        );
+        name = `Panic(0x${code.toString(16)})`;
+      }
+    } catch {
+    }
+  }
+  return { data, selector, name };
+}
+
+// src/utils/quantum-submission.utils.ts
+var MAX_DEADZONE_RESIMULATIONS = 3;
+var QuantumRevertError = class extends Error {
+  constructor(errorName, selector, data, cause) {
+    super(
+      `Pre-send simulation reverted: ${errorName ?? selector ?? "unknown"}`
+    );
+    this.errorName = errorName;
+    this.selector = selector;
+    this.data = data;
+    this.cause = cause;
+    this.name = "QuantumRevertError";
+  }
+};
+async function assertSafeQuantumSubmission(opts) {
+  const { provider, to, from, data, quantumTimestamp } = opts;
+  const maxResimulations = opts.maxResimulations ?? MAX_DEADZONE_RESIMULATIONS;
+  const now = opts.now ?? (() => Math.floor(Date.now() / 1e3));
+  const onDebug = opts.onDebug ?? (() => {
+  });
+  const gateOpts = {
+    now,
+    ...opts.sleep ? { sleep: opts.sleep } : {}
+  };
+  await awaitSafeSubmissionWindow(quantumTimestamp, gateOpts);
+  for (let sim = 1; ; sim++) {
+    try {
+      await provider.call({ to, from, data });
+      break;
+    } catch (simError) {
+      const decoded = decodeQuantumRevert(simError);
+      if (decoded.selector === DEAD_ZONE_VIOLATION_SELECTOR && sim <= maxResimulations) {
+        const sigQuantum = Math.floor(quantumTimestamp / QUANTUM_WINDOW_SECONDS) * QUANTUM_WINDOW_SECONDS;
+        const realCurrentQuantum = Math.floor(now() / QUANTUM_WINDOW_SECONDS) * QUANTUM_WINDOW_SECONDS;
+        if (sigQuantum === realCurrentQuantum) {
+          onDebug(
+            "\u21AA\uFE0F  Simulated DeadZoneViolation is a stale-latest-block artifact (signature is the current quantum) \u2014 proceeding to broadcast"
+          );
+          break;
+        }
+        const gate = await awaitSafeSubmissionWindow(quantumTimestamp, gateOpts);
+        if (gate.waited) {
+          onDebug(
+            `\u{1F501} Re-simulating after crossing the quantum boundary (attempt ${sim}/${maxResimulations})`
+          );
+          continue;
+        }
+      }
+      if (!decoded.data) {
+        const label = simError instanceof Error ? simError.message : String(simError);
+        onDebug(
+          `\u26A0\uFE0F  Pre-send simulation failed without revert data (${label}) \u2014 proceeding to broadcast`
+        );
+        break;
+      }
+      throw new QuantumRevertError(
+        decoded.name,
+        decoded.selector,
+        decoded.data,
+        simError
+      );
+    }
+  }
+  await awaitSafeSubmissionWindow(quantumTimestamp, gateOpts);
+}
+
 // src/utils/btc-withdrawal-message.ts
 import { keccak256 as keccak2563, toUtf8Bytes as toUtf8Bytes3, solidityPackedKeccak256 as solidityPackedKeccak2563, getBytes as getBytes3, zeroPadValue } from "ethers";
 var QUANTUM_SECONDS = 60;
@@ -16194,8 +16314,8 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
         throw new Error(`Position not found: ${request.positionId}`);
       }
       const currentDebt = position.ucdDebt.toString();
-      const ucdDebtHash = keccak2565(AbiCoder.defaultAbiCoder().encode(["uint256"], [currentDebt]));
-      const contractHash = keccak2565(AbiCoder.defaultAbiCoder().encode(
+      const ucdDebtHash = keccak2565(AbiCoder2.defaultAbiCoder().encode(["uint256"], [currentDebt]));
+      const contractHash = keccak2565(AbiCoder2.defaultAbiCoder().encode(
         ["address", "address", "address", "address"],
         [
           positionManagerAddress,
@@ -16256,188 +16376,6 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
           {}
         );
       }
-      if (this.config.debug) {
-        log.info("\u{1F50D} PREFLIGHT: Attempting diagnostic gas estimation...", {});
-      }
-      try {
-        const iface = new Interface4(positionManagerAbi);
-        const signatureHex = finalSignature.startsWith("0x") ? finalSignature : "0x" + finalSignature;
-        if (this.config.debug) {
-          log.info("\u{1F50D} DEBUG: Signature details:", {
-            finalSignature: finalSignature ? `${finalSignature.substring(0, 20)}... (length: ${finalSignature.length})` : "UNDEFINED/EMPTY",
-            signatureHex: signatureHex ? `${signatureHex.substring(0, 22)}... (length: ${signatureHex.length})` : "UNDEFINED/EMPTY"
-          });
-        }
-        const calldata = iface.encodeFunctionData("mintUCD", [
-          positionIdBytes32,
-          validationResponse.mintAmount,
-          validationResponse.mintFee,
-          validationResponse.newDebt,
-          validationResponse.newCollateral,
-          validationResponse.btcPrice,
-          validationResponse.authorizedSpendsHash,
-          ucdDebtHash,
-          contractHash,
-          validationResponse.timestamp,
-          signatureHex
-        ]);
-        if (this.config.debug) {
-          log.info("\u{1F50D} DEBUG: Encoded calldata:", {
-            length: calldata.length,
-            signaturePortion: calldata.substring(650, 670)
-          });
-        }
-        const provider = this.getSignerOrThrow().provider;
-        if (!provider) {
-          throw new Error("Provider not available");
-        }
-        const signerAddress = await this.getSignerOrThrow().getAddress();
-        if (this.config.debug) {
-          log.info("   Executing diagnostic eth_call...", {});
-        }
-        await provider.call({
-          to: positionManagerAddress,
-          from: signerAddress,
-          data: calldata
-        });
-        if (this.config.debug) {
-          log.info("   \u2705 Diagnostic eth_call succeeded!", {});
-        }
-      } catch (preflightError) {
-        if (this.config.debug) {
-          log.error(
-            "\u274C PREFLIGHT CHECK FAILED - Diagnostic eth_call reverted",
-            {}
-          );
-          log.error(`   Error message: ${preflightError?.message}`, {});
-          log.error(`   Error code: ${preflightError?.code}`, {});
-          log.error(`   Error data: ${preflightError?.data || "none"}`, {});
-          log.error(`   Error reason: ${preflightError?.reason || "none"}`, {});
-          log.error(
-            `   Error.error: ${JSON.stringify(preflightError?.error || {})}`,
-            {}
-          );
-        }
-        let errorData = preflightError?.data || preflightError?.error?.data?.data || preflightError?.error?.data || preflightError?.error?.error?.data;
-        const errorMessage = preflightError?.reason || preflightError?.error?.reason || preflightError?.error?.error?.reason || preflightError?.message || "Unknown error";
-        let requireMessage;
-        if (errorData && typeof errorData === "string" && errorData.startsWith("0x") && errorData.length > 138) {
-          try {
-            const errorSelector = errorData.slice(0, 10);
-            if (errorSelector === "0x08c379a0") {
-              const iface = new Interface4([
-                "function Error(string)"
-              ]);
-              const decoded = iface.decodeFunctionData("Error", errorData);
-              requireMessage = decoded[0];
-            }
-          } catch (e) {
-          }
-        }
-        if (requireMessage) {
-          throw new Error(
-            `Preflight check failed - mintUCD would revert:
-${requireMessage}
-Context: Quantum timestamp=${validationResponse.timestamp}, Position=${request.positionId}`
-          );
-        }
-        if (errorData && typeof errorData === "string" && errorData.startsWith("0x") && errorData.length > 10) {
-          const selector = errorData.slice(0, 10);
-          const knownErrors = {
-            "0x8baa579f": "InvalidSignature()",
-            "0xd92e233d": "ValidationFailed()",
-            "0x3ee5aeb5": "OperationNotAuthorized()",
-            "0x70f4b32a": "UnauthorizedSigner()",
-            "0x48f5c3ed": "Unauthorized()",
-            "0x36bfdeea": "StateHashMismatch()",
-            "0x131d9a21": "QuantumExpired()",
-            "0x52ce5d58": "QuantumAlreadyUsed()",
-            "0x137f3b70": "InDeadZone()",
-            "0xbe4b82c1": "DeadZoneViolation()",
-            "0x3e76a3c9": "QuantumOutsideWindow()",
-            "0x62278171": "InvalidValidatorSignature()",
-            "0xb9d419a7": "DebtUpdateVerificationFailed()",
-            "0xc7e20553": "DebtUpdateVerificationFailedDetailed(bytes32,uint256,uint256,uint256,uint256,uint256)",
-            "0x0cfd2a97": "MintVerificationMismatch(uint256,uint256)",
-            "0x07637bd8": "MintFailed()"
-          };
-          const errorName = knownErrors[selector] || `Unknown error ${selector}`;
-          const mintDebtDiagnostics = selector === "0xb9d419a7" || selector === "0xc7e20553" || selector === "0x0cfd2a97" || selector === "0x07637bd8" ? `
-
-Mint/debt diagnostics (LoanOperationsManager mint path \u2192 increaseDebtFromMint):
-  positionId: ${request.positionId}
-  on-chain ucdDebt before tx: ${currentDebt}
-  Lit newDebt: ${validationResponse.newDebt}
-  Lit mintAmount: ${validationResponse.mintAmount}
-  Lit mintFee: ${validationResponse.mintFee}
-  Call path: mintUCD -> mintUCDWithAuthorization -> increaseDebtFromMint -> finalizeMintDebtIncrease
-  Contract expects UCD supply increase to match mintAmount+mintFee and debt update to newDebt.
-` : "";
-          let quantumContext = "";
-          if (selector === "0x131d9a21" || selector === "0x52ce5d58" || selector === "0x137f3b70" || selector === "0xbe4b82c1" || selector === "0x3e76a3c9") {
-            const currentTime2 = Math.floor(Date.now() / 1e3);
-            const currentQuantum = Math.floor(currentTime2 / 60) * 60;
-            const sigQuantum2 = Math.floor(validationResponse.timestamp / 60) * 60;
-            const timeDiff = currentTime2 - validationResponse.timestamp;
-            quantumContext = `
-
-Quantum Timing Analysis:
-  Signature created: ${validationResponse.timestamp} (${new Date(
-              validationResponse.timestamp * 1e3
-            ).toISOString()})
-  Current time: ${currentTime2} (${new Date(
-              currentTime2 * 1e3
-            ).toISOString()})
-  Time elapsed: ${timeDiff} seconds
-  Signature quantum: ${sigQuantum2}
-  Current quantum: ${currentQuantum}
-  Quantum window: 60 seconds
-  Status: ${sigQuantum2 < currentQuantum ? "\u274C EXPIRED - Signature created in older quantum window" : "\u2705 VALID"}
-  Note: QuantumOutsideWindow can also occur if the tx is mined outside the accepted past/current/next quantum set.`;
-          }
-          throw new Error(
-            `Preflight check failed - mintUCD would revert:
-Error: ${errorName}
-Selector: ${selector}
-Message: ${errorMessage}
-Data: ${errorData}${quantumContext}${mintDebtDiagnostics}`
-          );
-        } else {
-          const currentTime2 = Math.floor(Date.now() / 1e3);
-          const timeSinceSig = currentTime2 - validationResponse.timestamp;
-          const currentQuantum = Math.floor(currentTime2 / 60) * 60;
-          const sigQuantum2 = Math.floor(validationResponse.timestamp / 60) * 60;
-          throw new Error(
-            `Preflight check failed - mintUCD would revert:
-${errorMessage}
-
-Error Details:
-  Error data: ${errorData || "0x (empty - no custom error)"}
-  Error code: ${preflightError?.code || "none"}
-
-Quantum Timing Analysis:
-  Signature created: ${validationResponse.timestamp} (${new Date(
-              validationResponse.timestamp * 1e3
-            ).toISOString()})
-  Current time: ${currentTime2} (${new Date(
-              currentTime2 * 1e3
-            ).toISOString()})
-  Time elapsed: ${timeSinceSig} seconds
-  Signature quantum: ${sigQuantum2}
-  Current quantum: ${currentQuantum}
-  Status: ${sigQuantum2 < currentQuantum ? "\u274C EXPIRED - Signature too old" : "\u2705 VALID"}
-
-Possible Causes (when error data is empty):
-  \u2022 Quantum signature expired (current=${currentQuantum}, signature=${sigQuantum2})
-  \u2022 Contract paused or circuit breaker active
-  \u2022 Position state changed since LIT Action signed
-  \u2022 Authorization registry validation failed
-  \u2022 RPC provider not returning detailed revert data
-
-Position: ${request.positionId}`
-          );
-        }
-      }
       try {
         const coreAddress = this.getContractAddressesOrThrow().positionManagerCore;
         if (!coreAddress) {
@@ -16455,7 +16393,7 @@ Position: ${request.positionId}`
           positionIdBytes32
         );
         const currentDebtHash = keccak2565(
-          AbiCoder.defaultAbiCoder().encode(
+          AbiCoder2.defaultAbiCoder().encode(
             ["uint256"],
             [currentPosition.ucdDebt]
           )
@@ -16632,137 +16570,122 @@ Position: ${request.positionId}`
         validationResponse.timestamp,
         signatureHexMint
       ]);
-      await awaitSafeSubmissionWindow(Number(validationResponse.timestamp));
       const fromAddress = await signer.getAddress();
-      const estimatedGas = await estimateContractCallGasWithMargin(
-        signerProvider,
-        fromAddress,
-        positionManagerAddress,
-        mintCalldata,
-        MINT_UCD_ESTIMATE_MARGIN_BPS,
-        MINT_UCD_GAS_CEILING
-      );
-      let tx;
-      if (estimatedGas !== null) {
-        if (this.config.debug) {
-          log.info(
-            `\u{1F4DD} Broadcasting mintUCD (gasLimit=${estimatedGas.toString()})`,
-            {}
-          );
-        }
-        tx = await sendEip1559Transaction({
-          signer,
+      try {
+        await assertSafeQuantumSubmission({
+          provider: signerProvider,
           to: positionManagerAddress,
+          from: fromAddress,
           data: mintCalldata,
-          gasLimit: estimatedGas
+          quantumTimestamp: Number(validationResponse.timestamp),
+          onDebug: this.config.debug ? (msg) => log.info(msg, {}) : void 0
         });
-      } else {
-        if (this.config.debug) {
-          log.info(
-            "\u{1F50D} eth_estimateGas failed for mintUCD; running static call",
-            {}
-          );
-        }
-        try {
-          await signerProvider.call({
-            to: positionManagerAddress,
-            from: fromAddress,
-            data: mintCalldata
-          });
-        } catch (callError) {
-          if (this.config.debug) {
-            log.info("\u{1F50D} DEBUG: mintUCD static call failed", {});
-            log.info(`   Error message: ${callError?.message}`, {});
-            log.info(`   Error code: ${callError?.code}`, {});
-            log.info(`   Error data type: ${typeof callError?.data}`, {});
-            log.info(`   Error data value: ${callError?.data}`, {});
-          }
-          let errorData = callError?.data || callError?.error?.data?.data || callError?.error?.data;
-          const errorMessage = callError?.reason || callError?.message || "Unknown error";
-          if (errorData && typeof errorData === "string" && errorData.startsWith("0x") && errorData.length > 10) {
-            const selector = errorData.slice(0, 10);
-            const knownErrors = {
-              "0x8baa579f": "InvalidSignature()",
-              "0xd92e233d": "ValidationFailed()",
-              "0x3ee5aeb5": "OperationNotAuthorized()",
-              "0x70f4b32a": "UnauthorizedSigner()",
-              "0x48f5c3ed": "Unauthorized()",
-              "0x36bfdeea": "StateHashMismatch()",
-              "0x131d9a21": "QuantumExpired()",
-              "0x52ce5d58": "QuantumAlreadyUsed()",
-              "0x137f3b70": "InDeadZone()",
-              "0xbe4b82c1": "DeadZoneViolation()",
-              "0x3e76a3c9": "QuantumOutsideWindow()",
-              "0x62278171": "InvalidValidatorSignature()",
-              "0xb9d419a7": "DebtUpdateVerificationFailed()",
-              "0xc7e20553": "DebtUpdateVerificationFailedDetailed(bytes32,uint256,uint256,uint256,uint256,uint256)",
-              "0x0cfd2a97": "MintVerificationMismatch(uint256,uint256)",
-              "0x07637bd8": "MintFailed()"
-            };
-            const errorName = knownErrors[selector] || `Unknown error ${selector}`;
-            throw new Error(
-              `mintUCD reverted: ${errorName}
-Error selector: ${selector}
-Error data: ${errorData}
-Call path: mintUCD -> mintUCDWithAuthorization -> increaseDebtFromMint -> finalizeMintDebtIncrease
-Message: ${errorMessage}`
-            );
-          }
-          if (errorData === "0x" || !errorData) {
-            const viewsAddress = this.config.contractAddresses?.positionManagerViews;
-            if (viewsAddress) {
-              try {
-                const views = new Contract6(
-                  viewsAddress,
-                  [
-                    "function diagnoseMintUCD(bytes32,uint256,uint256,uint256,uint256,uint256,bytes32,bytes32,bytes32,uint256,bytes) view returns (string)"
-                  ],
-                  signerProvider
-                );
-                const diagnosis = await views["diagnoseMintUCD"](
-                  request.positionId,
-                  validationResponse.mintAmount,
-                  validationResponse.mintFee,
-                  validationResponse.newDebt,
-                  validationResponse.newCollateral,
-                  validationResponse.btcPrice,
-                  validationResponse.authorizedSpendsHash,
-                  ucdDebtHash,
-                  contractHash,
-                  validationResponse.timestamp,
-                  signatureHexMint
-                );
-                throw new Error(
-                  `mintUCD reverted with empty data; diagnosis: ${diagnosis}`
+      } catch (simError) {
+        if (!(simError instanceof QuantumRevertError)) {
+          throw simError;
+        }
+        const simCause = simError.cause;
+        const causeMessage = simCause?.reason ?? simCause?.shortMessage ?? (simCause instanceof Error ? simCause.message : String(simCause));
+        if (!simError.data) {
+          const viewsAddress = this.config.contractAddresses?.positionManagerViews;
+          if (viewsAddress) {
+            let diagnosis = null;
+            try {
+              const views = new Contract6(
+                viewsAddress,
+                [
+                  "function diagnoseMintUCD(bytes32,uint256,uint256,uint256,uint256,uint256,bytes32,bytes32,bytes32,uint256,bytes) view returns (string)"
+                ],
+                signerProvider
+              );
+              diagnosis = await views["diagnoseMintUCD"](
+                request.positionId,
+                validationResponse.mintAmount,
+                validationResponse.mintFee,
+                validationResponse.newDebt,
+                validationResponse.newCollateral,
+                validationResponse.btcPrice,
+                validationResponse.authorizedSpendsHash,
+                ucdDebtHash,
+                contractHash,
+                validationResponse.timestamp,
+                signatureHexMint
+              );
+            } catch (diagErr) {
+              if (this.config.debug) {
+                log.info(
+                  `   diagnoseMintUCD unavailable or failed: ${diagErr?.message || diagErr}`,
+                  {}
                 );
-              } catch (diagErr) {
-                if (this.config.debug) {
-                  log.info(
-                    `   diagnoseMintUCD unavailable or failed: ${diagErr?.message || diagErr}`,
-                    {}
-                  );
-                }
               }
             }
+            if (diagnosis !== null) {
+              throw new Error(
+                `mintUCD reverted with empty data; diagnosis: ${diagnosis}`
+              );
+            }
           }
           throw new Error(
-            `mintUCD reverted: ${errorMessage}
-Error data: ${errorData || "none"}`
+            `mintUCD would revert (pre-send simulation): ${causeMessage}
+Error data: none`
           );
         }
-        if (this.config.debug) {
-          log.info(
-            "\u2705 Static call OK \u2014 broadcasting mintUCD with fixed gas ceiling",
-            {}
-          );
+        const selector = simError.selector;
+        const errorName = simError.errorName ?? (selector ? `Unknown error ${selector}` : "unknown");
+        const mintDebtDiagnostics = selector === "0xb9d419a7" || // DebtUpdateVerificationFailed()
+        selector === "0xc7e20553" || // DebtUpdateVerificationFailedDetailed(...)
+        selector === "0x0cfd2a97" || // MintVerificationMismatch(uint256,uint256)
+        selector === "0x07637bd8" ? `
+
+Mint/debt diagnostics (LoanOperationsManager mint path \u2192 increaseDebtFromMint):
+  positionId: ${request.positionId}
+  on-chain ucdDebt before tx: ${currentDebt}
+  Lit newDebt: ${validationResponse.newDebt}
+  Lit mintAmount: ${validationResponse.mintAmount}
+  Lit mintFee: ${validationResponse.mintFee}
+  Call path: mintUCD -> mintUCDWithAuthorization -> increaseDebtFromMint -> finalizeMintDebtIncrease
+  Contract expects UCD supply increase to match mintAmount+mintFee and debt update to newDebt.
+` : "";
+        let quantumContext = "";
+        if (selector === "0x131d9a21" || // QuantumExpired()
+        selector === "0x52ce5d58" || // QuantumAlreadyUsed()
+        selector === "0x137f3b70" || // InDeadZone()
+        selector === "0xbe4b82c1" || // DeadZoneViolation()
+        selector === "0x3e76a3c9") {
+          const nowSecs = Math.floor(Date.now() / 1e3);
+          const nowQuantum = Math.floor(nowSecs / 60) * 60;
+          const signedQuantum = Math.floor(Number(validationResponse.timestamp) / 60) * 60;
+          const timeDiff = nowSecs - Number(validationResponse.timestamp);
+          quantumContext = `
+
+Quantum Timing Analysis:
+  Signature created: ${validationResponse.timestamp} (${new Date(
+            Number(validationResponse.timestamp) * 1e3
+          ).toISOString()})
+  Current time: ${nowSecs} (${new Date(
+            nowSecs * 1e3
+          ).toISOString()})
+  Time elapsed: ${timeDiff} seconds
+  Signature quantum: ${signedQuantum}
+  Current quantum: ${nowQuantum}
+  Quantum window: 60 seconds
+  Status: ${signedQuantum < nowQuantum ? "\u274C EXPIRED - Signature created in older quantum window" : "\u2705 VALID"}
+  Note: QuantumOutsideWindow can also occur if the tx is mined outside the accepted past/current/next quantum set.`;
         }
-        tx = await sendEip1559Transaction({
-          signer,
-          to: positionManagerAddress,
-          data: mintCalldata,
-          gasLimit: MINT_UCD_GAS_CEILING
-        });
+        throw new Error(
+          `mintUCD would revert (pre-send simulation): ${errorName}
+Error selector: ${selector}
+Error data: ${simError.data}
+Call path: mintUCD -> mintUCDWithAuthorization -> increaseDebtFromMint -> finalizeMintDebtIncrease
+Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
+        );
       }
+      const tx = await sendEip1559Transaction({
+        signer,
+        to: positionManagerAddress,
+        data: mintCalldata,
+        gasLimit: MINT_UCD_GAS_CEILING
+      });
       const receipt = await signerProvider.waitForTransaction(
         tx.hash,
         1,
@@ -17926,26 +17849,43 @@ Error data: ${errorData || "none"}`
     if (!signatureBytes.startsWith("0x")) {
       signatureBytes = "0x" + signatureBytes;
     }
-    const contractManager = this.getContractManager();
-    const positionManagerResult = contractManager.getPositionManager();
-    if (!positionManagerResult.success) {
-      throw new Error(
-        `Failed to get PositionManager: ${positionManagerResult.error.message}`
-      );
-    }
-    const positionManager = positionManagerResult.value;
-    await awaitSafeSubmissionWindow(Number(quantumTimestamp));
-    const extendPositionFn = positionManager["extendPosition"];
-    const tx = await extendPositionFn(
+    const extendIface = new Interface4([
+      "function extendPosition(bytes32 positionId, uint256 selectedTerm, uint256 quantumTimestamp, uint256 btcPrice, uint256 availableBTCBalance, uint256 proRataRenewalFee, bytes calldata extensionValidatorSignature) external returns (bool)"
+    ]);
+    const extendCalldata = extendIface.encodeFunctionData("extendPosition", [
       positionIdBytes32,
       BigInt(_selectedTerm),
       quantumTimestamp,
       btcPrice,
       availableBTCBalance,
       proRataRenewalFee,
-      signatureBytes,
-      { gasLimit: EXTEND_POSITION_GAS_CEILING }
-    );
+      signatureBytes
+    ]);
+    const extendTo = this.getContractAddressesOrThrow().positionManager;
+    const extendSigner = this.getSignerOrThrow();
+    try {
+      await assertSafeQuantumSubmission({
+        provider: this.getProviderOrThrow(),
+        to: extendTo,
+        from: await extendSigner.getAddress(),
+        data: extendCalldata,
+        quantumTimestamp: Number(quantumTimestamp),
+        onDebug: this.config.debug ? (msg) => log.info(msg, {}) : void 0
+      });
+    } catch (simError) {
+      if (!(simError instanceof QuantumRevertError)) {
+        throw simError;
+      }
+      throw new Error(
+        `extendPosition would revert (pre-send simulation): ${simError.errorName ?? simError.selector ?? "unknown"}`
+      );
+    }
+    const tx = await sendEip1559Transaction({
+      signer: extendSigner,
+      to: extendTo,
+      data: extendCalldata,
+      gasLimit: EXTEND_POSITION_GAS_CEILING
+    });
     const txWithProvider = tx;
     if (!txWithProvider.provider) {
       const signer2 = this.getSignerOrThrow();
@@ -18805,7 +18745,6 @@ Error data: ${errorData || "none"}`
           quantumTimestamp: quantumTimestamp.toString()
         });
       }
-      await awaitSafeSubmissionWindow(Number(quantumTimestamp));
       const paymentAmountStr = paymentAmountWei.toString();
       const quantumTimestampStr = quantumTimestamp.toString();
       const btcPriceStr = btcPrice.toString();
@@ -18823,71 +18762,30 @@ Error data: ${errorData || "none"}`
         btcPriceStr,
         signature
       ]);
-      const decodePaymentRevert = (e) => {
-        const raw = e?.data ?? e?.info?.error?.data ?? e?.error?.data?.data ?? e?.error?.data;
-        const data = typeof raw === "string" ? raw : void 0;
-        if (!data || !data.startsWith("0x") || data.length < 10)
-          return null;
-        const selector = data.slice(0, 10);
-        const map2 = {
-          "0xbe4b82c1": "DeadZoneViolation()",
-          "0x137f3b70": "InDeadZone()",
-          "0x52ce5d58": "QuantumAlreadyUsed()",
-          "0x3e76a3c9": "QuantumOutsideWindow()",
-          "0x131d9a21": "QuantumExpired()",
-          "0x8baa579f": "InvalidSignature()",
-          "0x62278171": "InvalidValidatorSignature()",
-          "0x3ee5aeb5": "OperationNotAuthorized()",
-          "0x48f5c3ed": "Unauthorized()"
-        };
-        return map2[selector] ?? `Unknown error ${selector}`;
-      };
-      const MAX_DEADZONE_RESIMULATIONS = 3;
-      for (let sim = 1; ; sim++) {
-        try {
-          await paymentProvider.call({
-            to: paymentContractAddress,
-            from: paymentFrom,
-            data: paymentCalldata
-          });
-          break;
-        } catch (simError) {
-          const decoded = decodePaymentRevert(simError);
-          if (decoded === "DeadZoneViolation()" && sim <= MAX_DEADZONE_RESIMULATIONS) {
-            const nowSec = Math.floor(Date.now() / 1e3);
-            const sigQuantum = Math.floor(Number(quantumTimestamp) / 60) * 60;
-            const realCurrentQuantum = Math.floor(nowSec / 60) * 60;
-            if (sigQuantum === realCurrentQuantum) {
-              if (this.config.debug) {
-                log.info(
-                  "\u21AA\uFE0F  Simulated DeadZoneViolation is a stale-latest-block artifact (signature is the current quantum) \u2014 proceeding to broadcast",
-                  {}
-                );
-              }
-              break;
-            }
-            const gate = await awaitSafeSubmissionWindow(Number(quantumTimestamp));
-            if (gate.waited) {
-              if (this.config.debug) {
-                log.info(
-                  `\u{1F501} Re-simulating makePayment after crossing the quantum boundary (attempt ${sim}/${MAX_DEADZONE_RESIMULATIONS})`,
-                  {}
-                );
-              }
-              continue;
-            }
-          }
-          const label = decoded ?? simError?.reason ?? simError?.shortMessage ?? (simError instanceof Error ? simError.message : String(simError));
-          if (this.config.debug) {
-            log.error("\u274C makePayment pre-send simulation reverted", { error: label });
-          }
-          return {
-            success: false,
-            error: `Payment would revert (pre-send simulation): ${label}`,
-            positionId: request.positionId,
-            paymentAmountUCD: request.paymentAmount
-          };
+      try {
+        await assertSafeQuantumSubmission({
+          provider: paymentProvider,
+          to: paymentContractAddress,
+          from: paymentFrom,
+          data: paymentCalldata,
+          quantumTimestamp: Number(quantumTimestamp),
+          onDebug: this.config.debug ? (msg) => log.info(msg, {}) : void 0
+        });
+      } catch (simError) {
+        if (!(simError instanceof QuantumRevertError)) {
+          throw simError;
+        }
+        const simCause = simError.cause;
+        const label = simError.errorName ?? (simError.selector ? `Unknown error ${simError.selector}` : null) ?? simCause?.reason ?? simCause?.shortMessage ?? (simCause instanceof Error ? simCause.message : String(simCause));
+        if (this.config.debug) {
+          log.error("\u274C makePayment pre-send simulation reverted", { error: label });
         }
+        return {
+          success: false,
+          error: `Payment would revert (pre-send simulation): ${label}`,
+          positionId: request.positionId,
+          paymentAmountUCD: request.paymentAmount
+        };
       }
       const tx = await sendEip1559Transaction({
         signer: paymentSigner,
@@ -19561,13 +19459,6 @@ Error data: ${errorData || "none"}`
           error: "PositionManager address not configured"
         };
       }
-      const positionManagerContract = new Contract6(
-        positionManagerAddress,
-        [
-          "function withdrawBTC((bytes32 positionId, bytes32 actionHash, bytes32 authorizedSpendsHash, bytes32 ucdDebtHash, bytes32 contractBundleHash, string withdrawalAddress, uint256 totalDeduction, uint256 newCollateral, uint256 quantumTimestamp, uint256 btcPrice, string utxoTxid, uint32 utxoVout) params, bytes withdrawalValidatorSignature, bytes btcSpendAuthSignature) external returns (bool)"
-        ],
-        this.getSignerOrThrow()
-      );
       const withdrawalParams = {
         positionId: positionIdBytes32,
         actionHash: validationResponse.actionHash,
@@ -19600,82 +19491,56 @@ Error data: ${errorData || "none"}`
           utxoVout: withdrawalParams.utxoVout
         });
       }
-      await awaitSafeSubmissionWindow(Number(withdrawalParams.quantumTimestamp));
+      const withdrawIface = new Interface4([
+        "function withdrawBTC((bytes32 positionId, bytes32 actionHash, bytes32 authorizedSpendsHash, bytes32 ucdDebtHash, bytes32 contractBundleHash, string withdrawalAddress, uint256 totalDeduction, uint256 newCollateral, uint256 quantumTimestamp, uint256 btcPrice, string utxoTxid, uint32 utxoVout) params, bytes withdrawalValidatorSignature, bytes btcSpendAuthSignature) external returns (bool)"
+      ]);
+      const withdrawCalldata = withdrawIface.encodeFunctionData("withdrawBTC", [
+        withdrawalParams,
+        signatureBytes,
+        btcSpendAuthBytes
+      ]);
+      const withdrawSigner = this.getSignerOrThrow();
       let tx;
       try {
-        tx = await positionManagerContract["withdrawBTC"](
-          withdrawalParams,
-          signatureBytes,
-          btcSpendAuthBytes
-        );
+        await assertSafeQuantumSubmission({
+          provider: this.getProviderOrThrow(),
+          to: positionManagerAddress,
+          from: await withdrawSigner.getAddress(),
+          data: withdrawCalldata,
+          quantumTimestamp: Number(withdrawalParams.quantumTimestamp),
+          onDebug: this.config.debug ? (msg) => log.info(msg, {}) : void 0
+        });
+        tx = await sendEip1559Transaction({
+          signer: withdrawSigner,
+          to: positionManagerAddress,
+          data: withdrawCalldata,
+          gasLimit: WITHDRAW_BTC_GAS_CEILING
+        });
       } catch (txError) {
-        const txErrorMsg = txError instanceof Error ? txError.message : String(txError);
+        const txErrorMsg = txError instanceof QuantumRevertError ? `Withdrawal would revert (pre-send simulation): ${txError.errorName ?? txError.selector ?? "unknown"}` : txError instanceof Error ? txError.message : String(txError);
         if (this.config.debug) {
-          log.warn(
-            "\u26A0\uFE0F  withdrawBTC contract interface failed, falling back to raw transaction",
-            { error: txErrorMsg }
-          );
+          log.error("\u274C withdrawBTC transaction submission failed", {
+            error: txErrorMsg,
+            withdrawalParams,
+            signatureBytesLength: signatureBytes.length
+          });
         }
         try {
-          const contractAddress = this.getContractAddressesOrThrow().positionManager;
-          const iface = new Interface4([
-            "function withdrawBTC((bytes32 positionId, bytes32 actionHash, bytes32 authorizedSpendsHash, bytes32 ucdDebtHash, bytes32 contractBundleHash, string withdrawalAddress, uint256 totalDeduction, uint256 newCollateral, uint256 quantumTimestamp, uint256 btcPrice, string utxoTxid, uint32 utxoVout) params, bytes withdrawalValidatorSignature, bytes btcSpendAuthSignature) external returns (bool)"
-          ]);
-          const calldata = iface.encodeFunctionData("withdrawBTC", [
-            withdrawalParams,
-            signatureBytes,
-            btcSpendAuthBytes
-          ]);
-          const signer = this.getSignerOrThrow();
-          const fromAddress = await signer.getAddress();
-          const estimatedGas = await estimateContractCallGasWithMargin(
-            this.getProviderOrThrow(),
-            fromAddress,
-            contractAddress,
-            calldata,
-            MINT_UCD_ESTIMATE_MARGIN_BPS,
-            WITHDRAW_BTC_GAS_CEILING
+          const position = await this.getPosition(positionId);
+          const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
+          const message = formatBTCWithdrawalFailureMessage(
+            btcAmount,
+            position?.vaultAddress || "unknown",
+            withdrawalAddress,
+            positionId
           );
-          const gasLimit = estimatedGas ?? WITHDRAW_BTC_GAS_CEILING;
-          tx = await signer.sendTransaction({
-            to: contractAddress,
-            data: calldata,
-            value: "0x0",
-            gasLimit
-          });
-          if (this.config.debug) {
-            log.info("\u2705 withdrawBTC raw transaction fallback succeeded", {
-              txHash: tx.hash,
-              gasLimit: gasLimit.toString(),
-              estimated: estimatedGas !== null
-            });
-          }
-        } catch (rawError) {
-          const rawErrorMsg = rawError instanceof Error ? rawError.message : String(rawError);
-          if (this.config.debug) {
-            log.error("\u274C withdrawBTC transaction failed (raw fallback also failed)", {
-              error: rawErrorMsg,
-              withdrawalParams,
-              signatureBytesLength: signatureBytes.length
-            });
-          }
-          try {
-            const position = await this.getPosition(positionId);
-            const btcAmount = (Number(withdrawalAmount) / 1e8).toFixed(8);
-            const message = formatBTCWithdrawalFailureMessage(
-              btcAmount,
-              position?.vaultAddress || "unknown",
-              withdrawalAddress,
-              positionId
-            );
-            await this._relayNotification(message);
-          } catch {
-          }
-          return {
-            success: false,
-            error: `Transaction submission failed: ${rawErrorMsg}`
-          };
+          await this._relayNotification(message);
+        } catch {
         }
+        return {
+          success: false,
+          error: `Transaction submission failed: ${txErrorMsg}`
+        };
       }
       if (this.config.debug) {
         log.info("\u2705 Transaction submitted, waiting for confirmation:", {
@@ -19698,6 +19563,12 @@ Error data: ${errorData || "none"}`
           error: `Transaction confirmation failed: ${waitErrorMsg}`
         };
       }
+      if (!receipt) {
+        return {
+          success: false,
+          error: `Transaction confirmation returned no receipt. Hash: ${tx.hash}`
+        };
+      }
       if (this.config.debug) {
         log.info("\u2705 BTC withdrawal confirmed", {
           blockNumber: receipt.blockNumber,