@gvnrdao/dh-sdk 0.0.299 → 0.0.300

package/dist/index.js

@@ -5915,6 +5915,35 @@ var ServerSession = class {
   }
 };
 
+// src/utils/quantum-revert.utils.ts
+var DEAD_ZONE_VIOLATION_SELECTOR = "0xbe4b82c1";
+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;
+  const name = selector ? QUANTUM_REVERT_NAMES[selector] ?? null : null;
+  return { data, selector, name };
+}
+
 // src/utils/btc-withdrawal-message.ts
 var import_ethers5 = require("ethers");
 var QUANTUM_SECONDS = 60;
@@ -16390,7 +16419,7 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
             {}
           );
         }
-        let errorData = preflightError?.data || preflightError?.error?.data?.data || preflightError?.error?.data || preflightError?.error?.error?.data;
+        let errorData = preflightError?.data || preflightError?.info?.error?.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) {
@@ -16406,7 +16435,31 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
           } catch (e) {
           }
         }
-        if (requireMessage) {
+        const isDeadZonePreflightArtifact = decodeQuantumRevert(preflightError).selector === DEAD_ZONE_VIOLATION_SELECTOR;
+        if (isDeadZonePreflightArtifact) {
+          const nowSec = Math.floor(Date.now() / 1e3);
+          const sigQuantum2 = Math.floor(Number(validationResponse.timestamp) / 60) * 60;
+          const realCurrentQuantum = Math.floor(nowSec / 60) * 60;
+          if (sigQuantum2 === realCurrentQuantum) {
+            if (this.config.debug) {
+              log.info(
+                "\u21AA\uFE0F  Preflight DeadZoneViolation is a stale-latest-block artifact (signature is the current quantum) \u2014 proceeding to broadcast",
+                {}
+              );
+            }
+          } else {
+            if (this.config.debug) {
+              log.info(
+                "\u{1F501} Preflight DeadZoneViolation near the boundary \u2014 deferring across it, then proceeding",
+                {}
+              );
+            }
+            await awaitSafeSubmissionWindow(
+              Number(validationResponse.timestamp)
+            );
+          }
+        }
+        if (requireMessage && !isDeadZonePreflightArtifact) {
           throw new Error(
             `Preflight check failed - mintUCD would revert:
 ${requireMessage}
@@ -16467,13 +16520,15 @@ Quantum Timing Analysis:
   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:
+          if (!isDeadZonePreflightArtifact) {
+            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;
@@ -16704,7 +16759,6 @@ Position: ${request.positionId}`
         validationResponse.timestamp,
         signatureHexMint
       ]);
-      await awaitSafeSubmissionWindow(Number(validationResponse.timestamp));
       const fromAddress = await signer.getAddress();
       const estimatedGas = await estimateContractCallGasWithMargin(
         signerProvider,
@@ -16722,6 +16776,7 @@ Position: ${request.positionId}`
             {}
           );
         }
+        await awaitSafeSubmissionWindow(Number(validationResponse.timestamp));
         tx = await sendEip1559Transaction({
           signer,
           to: positionManagerAddress,
@@ -16749,9 +16804,16 @@ Position: ${request.positionId}`
             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;
+          let errorData = callError?.data || callError?.info?.error?.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 isDeadZoneArtifact = decodeQuantumRevert(callError).selector === DEAD_ZONE_VIOLATION_SELECTOR;
+          if (isDeadZoneArtifact && this.config.debug) {
+            log.info(
+              "\u{1F536} mintUCD static-call DeadZoneViolation is a stale-latest-block artifact; broadcasting anyway (gated)",
+              {}
+            );
+          }
+          if (!isDeadZoneArtifact && errorData && typeof errorData === "string" && errorData.startsWith("0x") && errorData.length > 10) {
             const selector = errorData.slice(0, 10);
             const knownErrors = {
               "0x8baa579f": "InvalidSignature()",
@@ -16817,17 +16879,20 @@ Message: ${errorMessage}`
               }
             }
           }
-          throw new Error(
-            `mintUCD reverted: ${errorMessage}
+          if (!isDeadZoneArtifact) {
+            throw new Error(
+              `mintUCD reverted: ${errorMessage}
 Error data: ${errorData || "none"}`
-          );
+            );
+          }
         }
         if (this.config.debug) {
           log.info(
-            "\u2705 Static call OK \u2014 broadcasting mintUCD with fixed gas ceiling",
+            "\u2705 Static call clear \u2014 broadcasting mintUCD with fixed gas ceiling",
             {}
           );
         }
+        await awaitSafeSubmissionWindow(Number(validationResponse.timestamp));
         tx = await sendEip1559Transaction({
           signer,
           to: positionManagerAddress,
@@ -18896,23 +18961,10 @@ Error data: ${errorData || "none"}`
         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)
+        const { selector, name } = decodeQuantumRevert(e);
+        if (!selector)
           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}`;
+        return name ?? `Unknown error ${selector}`;
       };
       const MAX_DEADZONE_RESIMULATIONS = 3;
       for (let sim = 1; ; sim++) {
@@ -19678,7 +19730,8 @@ Error data: ${errorData || "none"}`
         tx = await positionManagerContract["withdrawBTC"](
           withdrawalParams,
           signatureBytes,
-          btcSpendAuthBytes
+          btcSpendAuthBytes,
+          { gasLimit: WITHDRAW_BTC_GAS_CEILING }
         );
       } catch (txError) {
         const txErrorMsg = txError instanceof Error ? txError.message : String(txError);
@@ -19709,6 +19762,9 @@ Error data: ${errorData || "none"}`
             WITHDRAW_BTC_GAS_CEILING
           );
           const gasLimit = estimatedGas ?? WITHDRAW_BTC_GAS_CEILING;
+          await awaitSafeSubmissionWindow(
+            Number(withdrawalParams.quantumTimestamp)
+          );
           tx = await signer.sendTransaction({
             to: contractAddress,
             data: calldata,

package/dist/index.mjs

@@ -5839,6 +5839,35 @@ var ServerSession = class {
   }
 };
 
+// src/utils/quantum-revert.utils.ts
+var DEAD_ZONE_VIOLATION_SELECTOR = "0xbe4b82c1";
+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;
+  const name = selector ? QUANTUM_REVERT_NAMES[selector] ?? null : null;
+  return { data, selector, name };
+}
+
 // 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;
@@ -16318,7 +16347,7 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
             {}
           );
         }
-        let errorData = preflightError?.data || preflightError?.error?.data?.data || preflightError?.error?.data || preflightError?.error?.error?.data;
+        let errorData = preflightError?.data || preflightError?.info?.error?.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) {
@@ -16334,7 +16363,31 @@ var DiamondHandsSDK = class _DiamondHandsSDK {
           } catch (e) {
           }
         }
-        if (requireMessage) {
+        const isDeadZonePreflightArtifact = decodeQuantumRevert(preflightError).selector === DEAD_ZONE_VIOLATION_SELECTOR;
+        if (isDeadZonePreflightArtifact) {
+          const nowSec = Math.floor(Date.now() / 1e3);
+          const sigQuantum2 = Math.floor(Number(validationResponse.timestamp) / 60) * 60;
+          const realCurrentQuantum = Math.floor(nowSec / 60) * 60;
+          if (sigQuantum2 === realCurrentQuantum) {
+            if (this.config.debug) {
+              log.info(
+                "\u21AA\uFE0F  Preflight DeadZoneViolation is a stale-latest-block artifact (signature is the current quantum) \u2014 proceeding to broadcast",
+                {}
+              );
+            }
+          } else {
+            if (this.config.debug) {
+              log.info(
+                "\u{1F501} Preflight DeadZoneViolation near the boundary \u2014 deferring across it, then proceeding",
+                {}
+              );
+            }
+            await awaitSafeSubmissionWindow(
+              Number(validationResponse.timestamp)
+            );
+          }
+        }
+        if (requireMessage && !isDeadZonePreflightArtifact) {
           throw new Error(
             `Preflight check failed - mintUCD would revert:
 ${requireMessage}
@@ -16395,13 +16448,15 @@ Quantum Timing Analysis:
   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:
+          if (!isDeadZonePreflightArtifact) {
+            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;
@@ -16632,7 +16687,6 @@ Position: ${request.positionId}`
         validationResponse.timestamp,
         signatureHexMint
       ]);
-      await awaitSafeSubmissionWindow(Number(validationResponse.timestamp));
       const fromAddress = await signer.getAddress();
       const estimatedGas = await estimateContractCallGasWithMargin(
         signerProvider,
@@ -16650,6 +16704,7 @@ Position: ${request.positionId}`
             {}
           );
         }
+        await awaitSafeSubmissionWindow(Number(validationResponse.timestamp));
         tx = await sendEip1559Transaction({
           signer,
           to: positionManagerAddress,
@@ -16677,9 +16732,16 @@ Position: ${request.positionId}`
             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;
+          let errorData = callError?.data || callError?.info?.error?.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 isDeadZoneArtifact = decodeQuantumRevert(callError).selector === DEAD_ZONE_VIOLATION_SELECTOR;
+          if (isDeadZoneArtifact && this.config.debug) {
+            log.info(
+              "\u{1F536} mintUCD static-call DeadZoneViolation is a stale-latest-block artifact; broadcasting anyway (gated)",
+              {}
+            );
+          }
+          if (!isDeadZoneArtifact && errorData && typeof errorData === "string" && errorData.startsWith("0x") && errorData.length > 10) {
             const selector = errorData.slice(0, 10);
             const knownErrors = {
               "0x8baa579f": "InvalidSignature()",
@@ -16745,17 +16807,20 @@ Message: ${errorMessage}`
               }
             }
           }
-          throw new Error(
-            `mintUCD reverted: ${errorMessage}
+          if (!isDeadZoneArtifact) {
+            throw new Error(
+              `mintUCD reverted: ${errorMessage}
 Error data: ${errorData || "none"}`
-          );
+            );
+          }
         }
         if (this.config.debug) {
           log.info(
-            "\u2705 Static call OK \u2014 broadcasting mintUCD with fixed gas ceiling",
+            "\u2705 Static call clear \u2014 broadcasting mintUCD with fixed gas ceiling",
             {}
           );
         }
+        await awaitSafeSubmissionWindow(Number(validationResponse.timestamp));
         tx = await sendEip1559Transaction({
           signer,
           to: positionManagerAddress,
@@ -18824,23 +18889,10 @@ Error data: ${errorData || "none"}`
         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)
+        const { selector, name } = decodeQuantumRevert(e);
+        if (!selector)
           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}`;
+        return name ?? `Unknown error ${selector}`;
       };
       const MAX_DEADZONE_RESIMULATIONS = 3;
       for (let sim = 1; ; sim++) {
@@ -19606,7 +19658,8 @@ Error data: ${errorData || "none"}`
         tx = await positionManagerContract["withdrawBTC"](
           withdrawalParams,
           signatureBytes,
-          btcSpendAuthBytes
+          btcSpendAuthBytes,
+          { gasLimit: WITHDRAW_BTC_GAS_CEILING }
         );
       } catch (txError) {
         const txErrorMsg = txError instanceof Error ? txError.message : String(txError);
@@ -19637,6 +19690,9 @@ Error data: ${errorData || "none"}`
             WITHDRAW_BTC_GAS_CEILING
           );
           const gasLimit = estimatedGas ?? WITHDRAW_BTC_GAS_CEILING;
+          await awaitSafeSubmissionWindow(
+            Number(withdrawalParams.quantumTimestamp)
+          );
           tx = await signer.sendTransaction({
             to: contractAddress,
             data: calldata,

package/dist/utils/quantum-revert.utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared decoder for custom-error reverts surfaced by quantum-signed operations
+ * (mintUCD / makePayment / withdrawBTC / extendPosition / liquidation).
+ *
+ * Consolidates what used to be three hand-rolled selector maps + ad-hoc error-data
+ * extraction scattered across diamond-hands-sdk.ts. The extraction probes EVERY
+ * nesting ethers v6 uses across provider types — notably `info.error.data`, which
+ * `BrowserProvider` (MetaMask) uses and the older per-site extractors missed, so a
+ * browser-provider DeadZoneViolation could slip through undetected and wrongly throw.
+ */
+/** `DeadZoneViolation()` selector — the stale-latest-block artifact we tolerate. */
+export declare const DEAD_ZONE_VIOLATION_SELECTOR = "0xbe4b82c1";
+/**
+ * Union of the custom-error selectors the mint/payment/quantum paths decode. Keep in
+ * sync with OperationAuthorizationRegistry / PositionManager / LoanOperationsManager.
+ */
+export declare const QUANTUM_REVERT_NAMES: Record<string, string>;
+export interface DecodedRevert {
+    /** Raw revert data (`0x…`) if any provider nesting carried it, else null. */
+    data: string | null;
+    /** 4-byte custom-error selector (`0x…`) if the data is a valid custom error. */
+    selector: string | null;
+    /** Human-readable error name if the selector is known, else null. */
+    name: string | null;
+}
+/**
+ * Extract the revert data / custom-error selector / known name from an ethers error,
+ * probing every provider nesting (JsonRpc, Browser/MetaMask, wrapped `error.error`).
+ */
+export declare function decodeQuantumRevert(e: any): DecodedRevert;
+/** True iff the error decodes to `DeadZoneViolation()` from any provider nesting. */
+export declare function isDeadZoneViolation(e: any): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gvnrdao/dh-sdk",
-  "version": "0.0.299",
+  "version": "0.0.300",
   "description": "TypeScript SDK for Diamond Hands Protocol - Bitcoin-backed lending with LIT Protocol PKPs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",