@gvnrdao/dh-sdk 0.0.323 → 0.0.324

package/dist/index.js

@@ -1379,30 +1379,30 @@ var require_pkg_src = __commonJS({
         }
       },
       btcTransactionSigner: {
-        cid: "QmPncBUbxN9giWntJcvBMFW9GDAgA3DwgAkUAHxSsY67ic",
+        cid: "QmakWzTce8NH1Jkgv1xwg83Bg9WmF2UG1Mq76pDYDSwwUp",
         authorizedCidHex: cidToHex(
-          "QmPncBUbxN9giWntJcvBMFW9GDAgA3DwgAkUAHxSsY67ic"
+          "QmakWzTce8NH1Jkgv1xwg83Bg9WmF2UG1Mq76pDYDSwwUp"
         ),
         name: "Btc Transaction Signer",
         description: "Production Btc Transaction Signer",
         version: "1.1.1",
         deployed: true,
-        deployedAt: 1785226367707,
-        size: 66624,
-        hash: "9e0d9909519d5133bab03a9491566870b08d8b42c80e2d768bd24f02946cc781"
+        deployedAt: 1786113907707,
+        size: 67999,
+        hash: "83f3644c68819215e05ba8db3225571354a009458fc1437f606df6cb9142d3f9"
       },
       ucdMintValidator: {
-        cid: "QmPRLCfseSWCAS4PpvQWt9aEd6rXqWYG4JyGTn26KYk6xc",
+        cid: "Qmd8jgKRceLvf5aoTtwdXG2JqMoBK5cRJwrvEtQkgvbFbx",
         authorizedCidHex: cidToHex(
-          "QmPRLCfseSWCAS4PpvQWt9aEd6rXqWYG4JyGTn26KYk6xc"
+          "Qmd8jgKRceLvf5aoTtwdXG2JqMoBK5cRJwrvEtQkgvbFbx"
         ),
         name: "Ucd Mint Validator",
         description: "Production Ucd Mint Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785226381631,
-        size: 81658,
-        hash: "d8ea21622885c3d26fdb64e2ba9d2f9460753a5cd7934b2928858899537443eb",
+        deployedAt: 1786113908489,
+        size: 82739,
+        hash: "2bdd9aebdaad58a43a4731d5b7284f2531b7a9caaf8caf5719d891c4ed33cb2e",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x041ab17cd91fc5c0b761eea6092d032807561b621b82c488826776e04a9158d61ba64d809a4729f0501289d980732cb06d8dfd06999dd9c8efd2f495dad78b31bb",
@@ -1410,17 +1410,17 @@ var require_pkg_src = __commonJS({
         }
       },
       processPaymentValidator: {
-        cid: "QmNUzmHQHsaKThGkfZiD3xZrN64qZfn4P6J4MqWgvkeEsX",
+        cid: "QmNXVdysXDhCaQ1uNE2Vgjbuzy6yUEnnVgHzmDfNKXMU6z",
         authorizedCidHex: cidToHex(
-          "QmNUzmHQHsaKThGkfZiD3xZrN64qZfn4P6J4MqWgvkeEsX"
+          "QmNXVdysXDhCaQ1uNE2Vgjbuzy6yUEnnVgHzmDfNKXMU6z"
         ),
         name: "Process Payment Validator",
         description: "Production Process Payment Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785226385509,
-        size: 77655,
-        hash: "3c2af3c3e62e8e606d35f81fd7e6f4943f8516a9bef74f4150c8c1767cbd316f",
+        deployedAt: 1786113909138,
+        size: 78736,
+        hash: "17191ecc9c009e0fa5ab52c876330beb2a9a75d30cccb92e7c0c04f169df088b",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x04cfccb9b6c7addc79469c0e9fafebef4c70801302c62cdb26b610723a9b8527d23f98a40158c7340d83fd0e62d02b5ec74c12f7a86d98e8c6973b4811110f19ad",
@@ -1428,17 +1428,17 @@ var require_pkg_src = __commonJS({
         }
       },
       extendPositionValidator: {
-        cid: "QmY2t41w1maaoDmdRPx6wTfciHPQAydSpLSKwKVFSS2DPM",
+        cid: "QmYwBsyrhGfHWyRKx549G4tKHxsBLAuRUHcecigeUCkFav",
         authorizedCidHex: cidToHex(
-          "QmY2t41w1maaoDmdRPx6wTfciHPQAydSpLSKwKVFSS2DPM"
+          "QmYwBsyrhGfHWyRKx549G4tKHxsBLAuRUHcecigeUCkFav"
         ),
         name: "Extend Position Validator",
         description: "Production Extend Position Validator",
         version: "1.2.1",
         deployed: true,
-        deployedAt: 1785226398291,
-        size: 75434,
-        hash: "ba55532fbeaf6e65d180b869fd69ee06393d574daa0ace524a9e831d846539a5",
+        deployedAt: 1786113909872,
+        size: 76515,
+        hash: "1d4e085335af80f194a663a577876902c83015177e95906a0b461fa93bd5da08",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x04e52338f6a0c3362800f1a94c4c8f08be5030dde0fa217388c53d1c1a4790f4443c9f2886b2d2d8f4b75a9a156e9b028011b1a1cf7648da0e556aa980ec692836",
@@ -1446,9 +1446,9 @@ var require_pkg_src = __commonJS({
         }
       },
       btcWithdrawal: {
-        cid: "QmcBg8vPXsCmiKDk28bJVTqDpTrwCzSYAGu5V6ABVVPuK5",
+        cid: "QmZuR3qSBajutXfRd91ffpyFrRMgmaMh7fDEHRiQQF8Ljp",
         authorizedCidHex: cidToHex(
-          "QmcBg8vPXsCmiKDk28bJVTqDpTrwCzSYAGu5V6ABVVPuK5"
+          "QmZuR3qSBajutXfRd91ffpyFrRMgmaMh7fDEHRiQQF8Ljp"
         ),
         name: "Btc Withdrawal",
         description: "Production Btc Withdrawal",
@@ -1458,9 +1458,9 @@ var require_pkg_src = __commonJS({
         // than the one it replaced, which a rotation ceremony would treat as a rollback.
         version: "1.2.4",
         deployed: true,
-        deployedAt: 1785226412397,
-        size: 92754,
-        hash: "d3a8ec62e0b1e6d0566a154a884bf7ee4e25ef6dc2dd84fde98211d25c1dede5",
+        deployedAt: 1786113910531,
+        size: 95313,
+        hash: "ce12f11e3b5469953bc919586e4f3b8b5d594224b58b799dd9a3b60e3749559c",
         validatorWalletAddress: "0x82DB9F515957aA380B596C6eA2Bd30CEF181f236",
         pkp: {
           publicKey: "0x043616787c5432415c24378c4ef48de2bcd6bb7b575b837e3cff09171802662da7105d79586c7659677a0ecbaddac4cce06cb2a11f69a16fa0c4d7002ac7d51a4d",
@@ -1571,6 +1571,21 @@ var require_pkg_src = __commonJS({
         size: 1046,
         hash: "03ee5be239c91c735d2c95db89a0d1b77e602cfc18af8eb64b3281fddcd90a72"
       },
+      agentModuleExecutor: {
+        // Bound to the isolated Sepolia agent group 7 ("DH-Agent-Sepolia"), which
+        // holds this action and no PKPs until an agent is minted into it. NOT yet
+        // bound on mainnet — the Base `DH-Agent-Mainnet` group is created at rollout.
+        cid: "QmVgjGXUuxoGf8XyddW8a7btaazT9yEotpKoBgb65oPvcF",
+        authorizedCidHex: cidToHex(
+          "QmVgjGXUuxoGf8XyddW8a7btaazT9yEotpKoBgb65oPvcF"
+        ),
+        name: "Agent Module Executor",
+        description: "Capability gate for multi-sig Safe agent delegation: binds the agent PKP to the AgentDelegationRegistry record before signing (authorize | execute modes)",
+        version: "1.0.0",
+        deployed: true,
+        size: 11785,
+        hash: "fa294e164273c2158f9ef11a0ccfd735c343c0e3759fcb4b37e0f8a5d1ab0d29"
+      },
       staleSpendRecoveryValidator: {
         cid: "QmXQWT8V4wjuvH8BbC7xrkYxsVu5AKfvfWcS7jnYfrexYm",
         authorizedCidHex: cidToHex(
@@ -1590,17 +1605,17 @@ var require_pkg_src = __commonJS({
         }
       },
       btcUtxoInvalidator: {
-        cid: "QmZE422cZsEjYN8pE6AmpkgFoZCK4UAfdDuzoVRRsMJbwm",
+        cid: "Qmf4Ze8yhnQhHbnX5RPgJrC7Jw1aA3gbpfpd52kFg7fd1m",
         authorizedCidHex: cidToHex(
-          "QmZE422cZsEjYN8pE6AmpkgFoZCK4UAfdDuzoVRRsMJbwm"
+          "Qmf4Ze8yhnQhHbnX5RPgJrC7Jw1aA3gbpfpd52kFg7fd1m"
         ),
         name: "Btc Utxo Invalidator",
         description: "Production Btc Utxo Invalidator",
         version: "1.0.0",
         deployed: true,
-        deployedAt: 1785226423791,
-        size: 61472,
-        hash: "75eca528d8ac30ae8f21caaae206ccab162a83a048d622868e60f645f0c475e2"
+        deployedAt: 1786113911948,
+        size: 62553,
+        hash: "1dcea2b49e545c423195be22e072dc5e3039ed1c95a8490b23505956029f5b33"
       }
     };
     function getDeploymentsForNetwork(network) {
@@ -6253,7 +6268,10 @@ var import_ethers2 = require("ethers");
 // src/utils/quantum-timing.ts
 var QUANTUM_WINDOW_SECONDS = 60;
 var DEAD_ZONE_SECONDS = 8;
-var INCLUSION_LATENCY_BUDGET = 16;
+var SLOT_SECONDS = 12;
+var INCLUSION_SLOT_TOLERANCE = 3;
+var INCLUSION_LATENCY_BUDGET = SLOT_SECONDS * INCLUSION_SLOT_TOLERANCE;
+var MAX_GATE_POLLS = 12;
 var POST_BOUNDARY_SKEW_MARGIN = 3;
 function calculateNextQuantumTimestamp() {
   const now = Math.floor(Date.now() / 1e3);
@@ -6286,8 +6304,17 @@ function validateQuantumTiming(signedTimestamp, _bufferSeconds = 30) {
 async function awaitSafeSubmissionWindow(quantumTimestamp, opts = {}) {
   const now = opts.now ?? (() => Math.floor(Date.now() / 1e3));
   const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
-  const nowSec = now();
   const signatureQuantum = Math.floor(quantumTimestamp / QUANTUM_WINDOW_SECONDS) * QUANTUM_WINDOW_SECONDS;
+  if (opts.chainNow) {
+    const chainResult = await awaitSafeSubmissionWindowOnChain(
+      signatureQuantum,
+      opts.chainNow,
+      sleep
+    );
+    if (chainResult)
+      return chainResult;
+  }
+  const nowSec = now();
   const currentQuantum = Math.floor(nowSec / QUANTUM_WINDOW_SECONDS) * QUANTUM_WINDOW_SECONDS;
   const secsToBoundary = QUANTUM_WINDOW_SECONDS - nowSec % QUANTUM_WINDOW_SECONDS;
   const isNextQuantumSig = signatureQuantum === currentQuantum + QUANTUM_WINDOW_SECONDS;
@@ -6304,6 +6331,44 @@ async function awaitSafeSubmissionWindow(quantumTimestamp, opts = {}) {
   }
   return { waited: false, waitedSeconds: 0 };
 }
+async function awaitSafeSubmissionWindowOnChain(signatureQuantum, chainNow, sleep) {
+  let waitedSeconds = 0;
+  for (let poll = 0; poll < MAX_GATE_POLLS; poll++) {
+    let head;
+    try {
+      head = await chainNow();
+    } catch {
+      head = null;
+    }
+    if (head === null || !Number.isFinite(head)) {
+      return waitedSeconds > 0 ? { waited: true, waitedSeconds } : null;
+    }
+    const chainQuantum = Math.floor(head / QUANTUM_WINDOW_SECONDS) * QUANTUM_WINDOW_SECONDS;
+    if (signatureQuantum <= chainQuantum) {
+      return { waited: waitedSeconds > 0, waitedSeconds };
+    }
+    const earliestMine = head + SLOT_SECONDS;
+    const latestMine = head + SLOT_SECONDS * INCLUSION_SLOT_TOLERANCE;
+    const safeBeforeDeadZone = latestMine < signatureQuantum - DEAD_ZONE_SECONDS;
+    const safeAfterBoundary = earliestMine >= signatureQuantum;
+    if (safeBeforeDeadZone || safeAfterBoundary) {
+      return { waited: waitedSeconds > 0, waitedSeconds };
+    }
+    const sleepSeconds = Math.max(
+      1,
+      Math.min(SLOT_SECONDS, signatureQuantum - head)
+    );
+    log.debug(
+      `[Quantum Timing] \u23F3 Deferring send ${sleepSeconds}s to clear the quantum dead zone (sig quantum ${signatureQuantum}, chain head ${head}, insured mine window [${earliestMine}, ${latestMine}])`
+    );
+    await sleep(sleepSeconds * 1e3);
+    waitedSeconds += sleepSeconds;
+  }
+  log.debug(
+    `[Quantum Timing] \u26A0\uFE0F  Dead-zone gate exhausted ${MAX_GATE_POLLS} chain polls (sig quantum ${signatureQuantum}) \u2014 proceeding`
+  );
+  return { waited: waitedSeconds > 0, waitedSeconds };
+}
 
 // src/utils/mint-authorization.utils.ts
 var PKP_NFT_ABI = [
@@ -7260,6 +7325,20 @@ function decodeQuantumRevert(e) {
   }
   return { data, selector, name };
 }
+var RETRYABLE_QUANTUM_ERROR_NAMES = [
+  "DeadZoneViolation",
+  "QuantumOutsideWindow",
+  "QuantumAlreadyUsed",
+  "QuantumExpired"
+];
+function isRetryableQuantumFailure(message) {
+  if (!message)
+    return false;
+  if (message.includes("Transaction timeout") || message.includes("Transaction confirmation failed") || message.includes("Transaction receipt not found")) {
+    return false;
+  }
+  return RETRYABLE_QUANTUM_ERROR_NAMES.some((name) => message.includes(name)) || message.includes("Transaction reverted");
+}
 
 // src/utils/quantum-submission.utils.ts
 var MAX_DEADZONE_RESIMULATIONS = 3;
@@ -7281,9 +7360,14 @@ async function assertSafeQuantumSubmission(opts) {
   const now = opts.now ?? (() => Math.floor(Date.now() / 1e3));
   const onDebug = opts.onDebug ?? (() => {
   });
+  const chainNow = opts.chainNow ?? (typeof provider.getBlock === "function" ? async () => {
+    const block = await provider.getBlock("latest");
+    return typeof block?.timestamp === "number" ? block.timestamp : null;
+  } : void 0);
   const gateOpts = {
     now,
-    ...opts.sleep ? { sleep: opts.sleep } : {}
+    ...opts.sleep ? { sleep: opts.sleep } : {},
+    ...chainNow ? { chainNow } : {}
   };
   await awaitSafeSubmissionWindow(quantumTimestamp, gateOpts);
   const SAME_BLOCK_INTERACTION_SELECTOR = "0x3b53d1db";
@@ -22293,10 +22377,7 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
   isRetryablePaymentQuantumFailure(result) {
     if (result.success || !result.error)
       return false;
-    const e = result.error;
-    if (e.includes("Transaction timeout"))
-      return false;
-    return e.includes("DeadZoneViolation") || e.includes("QuantumOutsideWindow") || e.includes("QuantumAlreadyUsed") || e.includes("QuantumExpired") || e === "Transaction reverted";
+    return isRetryableQuantumFailure(result.error);
   }
   /**
    * One payment attempt: user auth → Lit Action authorization → dead-zone gate →
@@ -22935,6 +23016,37 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
     }
     return this.withdrawalAddressModule.getEntries(target);
   }
+  /**
+   * Recover the revert reason of an already-mined, already-reverted transaction.
+   *
+   * A status-0 receipt carries no revert data, and ethers does not re-fetch it, so
+   * the reason has to be recovered by replaying the exact calldata as an `eth_call`
+   * pinned to the block that mined it — the only block whose `block.timestamp`
+   * reproduces a timing-dependent revert such as `DeadZoneViolation()`.
+   *
+   * Caveat: the replay runs against end-of-block state rather than the state at the
+   * transaction's own index, so for a state-dependent revert the recovered name is
+   * diagnostic, not proof. Timing reverts (the case this exists for) are unaffected —
+   * they depend only on the block timestamp.
+   *
+   * @returns the decoded error name, its raw selector if unknown, or `null` when the
+   *          replay yields no revert data at all (never throws — a failed diagnosis
+   *          must not mask the underlying failure).
+   */
+  async decodeMinedRevert(params) {
+    try {
+      await this.getProviderOrThrow().call({
+        to: params.to,
+        from: params.from,
+        data: params.data,
+        blockTag: params.blockNumber
+      });
+      return null;
+    } catch (replayError) {
+      const decoded = decodeQuantumRevert(replayError);
+      return decoded.name ?? decoded.selector ?? null;
+    }
+  }
   /**
    * Withdraw Bitcoin from a position
    *
@@ -23508,9 +23620,23 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
           txHash: tx.hash
         });
       }
+      const withdrawProvider = this.getProviderOrThrow();
+      const withdrawTimeoutMs = this.config.transactionTimeoutMs || 3e5;
       let receipt;
       try {
-        receipt = await tx.wait();
+        receipt = await Promise.race([
+          withdrawProvider.waitForTransaction(tx.hash, 1),
+          new Promise(
+            (_, reject) => setTimeout(
+              () => reject(
+                new Error(
+                  `Transaction timeout after ${withdrawTimeoutMs}ms. Hash: ${tx.hash}`
+                )
+              ),
+              withdrawTimeoutMs
+            )
+          )
+        ]);
       } catch (waitError) {
         const waitErrorMsg = waitError instanceof Error ? waitError.message : String(waitError);
         if (this.config.debug) {
@@ -23527,7 +23653,26 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
       if (!receipt) {
         return {
           success: false,
-          error: `Transaction confirmation returned no receipt. Hash: ${tx.hash}`
+          error: `Transaction receipt not found for hash: ${tx.hash}`
+        };
+      }
+      if (receipt.status === 0) {
+        const revertName = await this.decodeMinedRevert({
+          to: positionManagerAddress,
+          from: await withdrawSigner.getAddress(),
+          data: withdrawCalldata,
+          blockNumber: receipt.blockNumber
+        });
+        if (this.config.debug) {
+          log.error("\u274C withdrawBTC reverted on-chain", {
+            txHash: receipt.hash,
+            blockNumber: receipt.blockNumber,
+            revert: revertName ?? "undecodable"
+          });
+        }
+        return {
+          success: false,
+          error: `Transaction reverted: ${revertName ?? "unknown reason"} (tx: ${receipt.hash})`
         };
       }
       if (this.config.debug) {
@@ -24655,13 +24800,11 @@ Message: ${causeMessage}${quantumContext}${mintDebtDiagnostics}`
         if (authResult.success) {
           break;
         }
-        const isQuantumError = authResult.error?.includes(
-          "QuantumOutsideWindow"
-        );
+        const isQuantumError = isRetryableQuantumFailure(authResult.error);
         if (isQuantumError && wAttempt < MAX_WITHDRAWAL_QUANTUM_RETRIES) {
           if (this.config.debug) {
             log.warn(
-              `\u26A0\uFE0F  Phase 1 QuantumOutsideWindow (attempt ${wAttempt}/${MAX_WITHDRAWAL_QUANTUM_RETRIES}). LIT action took too long. Retrying with fresh quantum...`
+              `\u26A0\uFE0F  Phase 1 quantum-timing failure (attempt ${wAttempt}/${MAX_WITHDRAWAL_QUANTUM_RETRIES}): ${authResult.error}. Retrying with a fresh quantum...`
             );
           }
           await new Promise((resolve) => setTimeout(resolve, 2e3));