@gvnrdao/dh-sdk 0.0.225 → 0.0.227

package/dist/index.js

@@ -14325,18 +14325,18 @@ var init_deployment_addresses = __esm({
       },
       upgraded: {
         PositionManager: {
-          previousImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
-          newImplementation: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
-          upgradedAt: "2026-05-04T09:25:00.744Z",
+          previousImplementation: "0x0e40B4D1708f49319f32d51AF01674c26acACeBF",
+          newImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
+          upgradedAt: "2026-04-30T16:23:00.805Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: PositionManager implementation update"
         },
         LoanOperationsManagerModule: {
-          previousImplementation: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
-          newImplementation: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
-          upgradedAt: "2026-05-04T08:28:12.942Z",
+          previousImplementation: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
+          newImplementation: "0x8a795b082c002aC07fb43Db0ae8eF8bE653cc4bb",
+          upgradedAt: "2026-05-04T13:22:08.881Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
+          reason: "Add cancelStaleSpend to cancel pending BTC withdrawals"
         },
         UCDController: {
           previousImplementation: "0xB5322F0D4a07d4342FA38137ebD95ac41D1c6036",
@@ -14395,11 +14395,11 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: PositionManagerCoreModule implementation update"
         },
         CollateralManagerModule: {
-          previousImplementation: "0x920e4f52c251B758e351c0d14c4418ad4E5B77ed",
-          newImplementation: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
-          upgradedAt: "2026-05-04T08:26:01.565Z",
+          previousImplementation: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
+          newImplementation: "0x72D17f489A7Ea57Fb665A340424aB7D04a4910aA",
+          upgradedAt: "2026-05-04T13:22:08.881Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: CollateralManagerModule implementation update"
+          reason: "Add cancelStaleSpend to cancel pending BTC withdrawals"
         },
         LiquidationManagerModule: {
           previousImplementation: "0xf74d5437691df92087170861213e26064358A7fb",
@@ -14409,11 +14409,11 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: LiquidationManagerModule implementation update"
         },
         BTCSpendAuthorizer: {
-          previousImplementation: "0x605bf1C988bb307AFA07326954D593A71580e99d",
-          newImplementation: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
-          upgradedAt: "2026-05-04T08:13:12.840Z",
+          previousImplementation: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
+          newImplementation: "0xBA4FAF0b804D72Bc4bdD2827f39DfE9256B5EF4F",
+          upgradedAt: "2026-05-04T13:22:08.881Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: BTCSpendAuthorizer implementation update"
+          reason: "Add cancelStaleSpend + BTCSpendCancelled event"
         },
         SimplePSMV2: {
           previousImplementation: "0xBdEFa375db7F9A498B81bcfdDd14FD16D02ca0BF",
@@ -14503,23 +14503,23 @@ var init_deployment_addresses = __esm({
         CIRCUIT_BREAKER_MODULE: "0x3D0B2cAE481821E57BA9CC3807bCC0d0D7F18bd8",
         ADMIN_MODULE: "0xAcd1f07915b17CA3727e7fE89BdF618A1545a1ed",
         UCD_CONTROLLER_IMPL: "0x2d4d689A70B56b6E0B9F70BffA6265A55173A4A1",
-        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
+        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x8a795b082c002aC07fb43Db0ae8eF8bE653cc4bb",
         TERM_MANAGER_MODULE_IMPL: "0xcc3D2dD7aAfaE5DE923dfd53833a40077178dd75",
         CIRCUIT_BREAKER_MODULE_IMPL: "0x8e9e10B14E6a91ec271FBEb4FD3fB1FE06b545dD",
         ADMIN_MODULE_IMPL: "0x67AE2F872c37f33db9bC631e135432B2845d308b",
         POSITION_MANAGER_VIEWS_IMPL: "0xadF8e0F34082a8fC23e727276e0aEf3af183C8Fd",
-        POSITION_MANAGER_IMPL: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
+        POSITION_MANAGER_IMPL: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
         SIMPLE_PSM_V2: "0x19EcF7BA26e054fd4Ff06009A03070103dbBB058",
         SIMPLE_PSM_V2_IMPL: "0x4107104fDF61AACC674f1F168c275f034c8112BF",
         UCD_TOKEN_IMPL: "0x155Da00Ee0beb1d9D5BA34Aeb62c9ad4E8227d5D",
         POSITION_MANAGER_CORE_MODULE: "0xfFAA39a08887FeFB697eBC8691A8630CbCC33391",
         POSITION_MANAGER_CORE_MODULE_IMPL: "0x41168d9BF8e696eBAB05ea539321ac212859d80b",
         COLLATERAL_MANAGER_MODULE: "0x967E92c976Fc0fa8268D37D4d6B7245d912aA7dB",
-        COLLATERAL_MANAGER_MODULE_IMPL: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
+        COLLATERAL_MANAGER_MODULE_IMPL: "0x72D17f489A7Ea57Fb665A340424aB7D04a4910aA",
         LIQUIDATION_MANAGER_MODULE: "0xC4AB00f39e7ceD812F5C67058C9fa44e15d40e76",
         LIQUIDATION_MANAGER_MODULE_IMPL: "0xf74d5437691df92087170861213e26064358A7fb",
         BTC_SPEND_AUTHORIZER: "0xd7E9Eb5eE53f1d9ee55Dc162bBC7486bE437B6bD",
-        BTC_SPEND_AUTHORIZER_IMPL: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
+        BTC_SPEND_AUTHORIZER_IMPL: "0xBA4FAF0b804D72Bc4bdD2827f39DfE9256B5EF4F",
         UPGRADE_VALIDATOR: "0x592e650edD9bA26ecc407989fdd6F9cdcDeC27A6",
         UPGRADE_VALIDATOR_IMPL: "0xEFf189e5872bC7158191eD39d31E745aF2A6FDa7",
         BITCOIN_PROVIDER_REGISTRY: "0xbfA0c48B070D0a9A9CD27469AeacFD2d4261cEE2",
@@ -42387,107 +42387,6 @@ Error data: ${errorData || "none"}`
       };
     }
   }
-  /**
-   * Cancel a stale authorized BTC spend whose signing/broadcast step never completed.
-   *
-   * Removes the entry from BTCSpendAuthorizer, restoring the UTXO to the available
-   * balance and allowing the borrower to retry via withdrawBTC() + executeBTCWithdrawal().
-   * Only the position's borrower may call this. Inputs come from getPendingWithdrawals().
-   *
-   * @param positionId - Position identifier
-   * @param txid - Bitcoin UTXO txid (from getPendingWithdrawals)
-   * @param vout - Output index (from getPendingWithdrawals)
-   */
-  async cancelStaleSpend(positionId, txid, vout) {
-    this.ensureInitialized();
-    try {
-      const utxoKey = ethers_exports.utils.solidityKeccak256(["string", "uint32"], [txid, vout]);
-      const contract = new ethers_exports.Contract(
-        this.getContractAddressesOrThrow().positionManager,
-        ["function cancelStaleSpend(bytes32,bytes32) external"],
-        this.getSignerOrThrow()
-      );
-      const tx = await contract["cancelStaleSpend"](
-        this.toBytes32(positionId),
-        utxoKey
-      );
-      const receipt = await tx.wait();
-      return { success: true, transactionHash: receipt.transactionHash };
-    } catch (error) {
-      return {
-        success: false,
-        error: error instanceof Error ? error.message : String(error)
-      };
-    }
-  }
-  /**
-   * Check which authorized BTC withdrawals have not yet been broadcast to Bitcoin.
-   *
-   * `withdrawBTC()` records an authorized spend on-chain but never clears it, even
-   * after execution. This method cross-references each authorized spend against the
-   * Bitcoin network (Esplora /outspend) to determine whether the signing+broadcast
-   * step (`executeBTCWithdrawal`) was actually completed.
-   *
-   * status 'pending'  → UTXO still unspent; executeBTCWithdrawal was never called
-   * status 'executed' → UTXO has been spent; withdrawal completed successfully
-   *
-   * @param positionId - Position identifier
-   */
-  async getPendingWithdrawals(positionId) {
-    this.ensureInitialized();
-    const bitcoinProviderUrl = this.config.bitcoinProviders && this.config.bitcoinProviders.length > 0 ? this.config.bitcoinProviders[0]?.url || "" : "";
-    if (!bitcoinProviderUrl) {
-      throw new Error(
-        "bitcoinProviders not configured in SDK config \u2014 required for UTXO spend check"
-      );
-    }
-    const contractAddresses = this.getContractAddressesOrThrow();
-    const positionManagerAbi = [
-      "function getAuthorizedSpends(bytes32) view returns (tuple(string txid, uint32 vout, uint256 satoshis, string targetAddress, uint256 targetAmount, uint256 authorizedAt)[])"
-    ];
-    const positionManager = new ethers_exports.Contract(
-      contractAddresses.positionManager,
-      positionManagerAbi,
-      this.getProviderOrThrow()
-    );
-    const positionIdBytes32 = this.toBytes32(positionId);
-    const authorizedSpends = await positionManager["getAuthorizedSpends"](
-      positionIdBytes32
-    );
-    const withdrawals = [];
-    for (const spend of authorizedSpends) {
-      let status = "pending";
-      try {
-        const resp = await fetch(
-          `${bitcoinProviderUrl}/tx/${spend.txid}/outspend/${spend.vout}`
-        );
-        if (resp.ok) {
-          const data = await resp.json();
-          status = data.spent === true ? "executed" : "pending";
-        }
-      } catch {
-        if (this.config.debug) {
-          log.warn(`\u26A0\uFE0F  Could not check outspend for ${spend.txid}:${spend.vout} \u2014 assuming pending`);
-        }
-      }
-      withdrawals.push({
-        txid: spend.txid,
-        vout: Number(spend.vout),
-        satoshis: BigInt(spend.satoshis.toString()),
-        targetAddress: spend.targetAddress,
-        targetAmount: BigInt(spend.targetAmount.toString()),
-        authorizedAt: Number(spend.authorizedAt),
-        status
-      });
-    }
-    const totalPendingSats = withdrawals.filter((w) => w.status === "pending").reduce((sum, w) => sum + w.satoshis, 0n);
-    return {
-      positionId,
-      withdrawals,
-      hasPending: withdrawals.some((w) => w.status === "pending"),
-      totalPendingSats
-    };
-  }
   /**
    * Execute pending Bitcoin transfers
    *
@@ -42508,25 +42407,25 @@ Error data: ${errorData || "none"}`
         });
       }
       const contractAddresses = this.getContractAddressesOrThrow();
-      const positionManagerAddress = contractAddresses.positionManager;
-      if (!positionManagerAddress) {
+      const btcSpendAuthorizerAddress = contractAddresses.btcSpendAuthorizer;
+      if (!btcSpendAuthorizerAddress) {
         return [
           {
             success: false,
-            error: "PositionManager address not configured"
+            error: "BTCSpendAuthorizer address not configured"
           }
         ];
       }
-      const positionManagerAbi = [
+      const btcSpendAuthorizerAbi = [
         "function getAuthorizedSpends(bytes32) view returns (tuple(string txid, uint32 vout, uint256 satoshis, string targetAddress, uint256 targetAmount, uint256 authorizedAt)[])"
       ];
-      const positionManager = new ethers_exports.Contract(
-        positionManagerAddress,
-        positionManagerAbi,
+      const btcSpendAuthorizer = new ethers_exports.Contract(
+        btcSpendAuthorizerAddress,
+        btcSpendAuthorizerAbi,
         this.getProviderOrThrow()
       );
       const positionIdBytes32 = this.toBytes32(positionId);
-      const authorizedSpends = await positionManager["getAuthorizedSpends"](
+      const authorizedSpends = await btcSpendAuthorizer["getAuthorizedSpends"](
         positionIdBytes32
       );
       if (this.config.debug) {
@@ -42577,6 +42476,92 @@ Error data: ${errorData || "none"}`
       ];
     }
   }
+  /**
+   * Get pending BTC withdrawals for a position
+   *
+   * Returns all authorized spends recorded in BTCSpendAuthorizer that have not yet
+   * been broadcast to the Bitcoin network. An empty array means no pending withdrawals.
+   *
+   * @param positionId - Position identifier
+   * @returns Array of pending withdrawals, each including a pre-computed utxoKey for use with cancelPendingWithdrawal
+   */
+  async getPendingWithdrawals(positionId) {
+    this.ensureInitialized();
+    const contractAddresses = this.getContractAddressesOrThrow();
+    const btcSpendAuthorizerAddress = contractAddresses.btcSpendAuthorizer;
+    if (!btcSpendAuthorizerAddress) {
+      throw new SDKError({
+        code: "SDK_CONTRACT_ADDRESSES_NOT_CONFIGURED",
+        message: "BTCSpendAuthorizer address not configured",
+        category: "CONFIGURATION" /* CONFIGURATION */,
+        severity: "HIGH" /* HIGH */,
+        originalError: new Error("BTCSpendAuthorizer address not configured")
+      });
+    }
+    const abi = [
+      "function getAuthorizedSpends(bytes32) view returns (tuple(string txid, uint32 vout, uint256 satoshis, string targetAddress, uint256 targetAmount, uint256 authorizedAt)[])"
+    ];
+    const contract = new ethers_exports.Contract(
+      btcSpendAuthorizerAddress,
+      abi,
+      this.getProviderOrThrow()
+    );
+    const positionIdBytes32 = this.toBytes32(positionId);
+    const raw = await contract["getAuthorizedSpends"](positionIdBytes32);
+    return raw.map((spend) => ({
+      txid: spend.txid,
+      vout: Number(spend.vout),
+      satoshis: Number(spend.satoshis),
+      targetAddress: spend.targetAddress,
+      targetAmount: Number(spend.targetAmount),
+      authorizedAt: Number(spend.authorizedAt),
+      utxoKey: ethers_exports.utils.solidityKeccak256(
+        ["string", "uint32"],
+        [spend.txid, Number(spend.vout)]
+      )
+    }));
+  }
+  /**
+   * Cancel a pending BTC withdrawal
+   *
+   * Removes a stale authorized spend from BTCSpendAuthorizer, unlocking the UTXO
+   * and allowing the borrower to retry the withdrawal from scratch.
+   * Only the position's borrower may call this — requires a connected signer.
+   *
+   * @param positionId - Position identifier
+   * @param txid - Bitcoin UTXO transaction ID (from getPendingWithdrawals)
+   * @param vout - Output index (from getPendingWithdrawals)
+   * @returns Transaction hash of the cancellation EVM transaction
+   */
+  async cancelPendingWithdrawal(positionId, txid, vout) {
+    this.ensureInitialized();
+    try {
+      const signer = this.getSignerOrThrow();
+      const contractAddresses = this.getContractAddressesOrThrow();
+      const positionManagerAddress = contractAddresses.positionManager;
+      if (!positionManagerAddress) {
+        return { success: false, error: "PositionManager address not configured" };
+      }
+      const utxoKey = ethers_exports.utils.solidityKeccak256(
+        ["string", "uint32"],
+        [txid, vout]
+      );
+      const positionManager = new ethers_exports.Contract(
+        positionManagerAddress,
+        ["function cancelStaleSpend(bytes32 positionId, bytes32 utxoKey) external"],
+        signer
+      );
+      const positionIdBytes32 = this.toBytes32(positionId);
+      const tx = await positionManager["cancelStaleSpend"](positionIdBytes32, utxoKey);
+      const receipt = await tx.wait();
+      return { success: true, transactionHash: receipt.transactionHash };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
   /**
    * Withdraw BTC and execute transfer (Complete Flow)
    *

package/dist/index.mjs

@@ -14331,18 +14331,18 @@ var init_deployment_addresses = __esm({
       },
       upgraded: {
         PositionManager: {
-          previousImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
-          newImplementation: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
-          upgradedAt: "2026-05-04T09:25:00.744Z",
+          previousImplementation: "0x0e40B4D1708f49319f32d51AF01674c26acACeBF",
+          newImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
+          upgradedAt: "2026-04-30T16:23:00.805Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: PositionManager implementation update"
         },
         LoanOperationsManagerModule: {
-          previousImplementation: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
-          newImplementation: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
-          upgradedAt: "2026-05-04T08:28:12.942Z",
+          previousImplementation: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
+          newImplementation: "0x8a795b082c002aC07fb43Db0ae8eF8bE653cc4bb",
+          upgradedAt: "2026-05-04T13:22:08.881Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
+          reason: "Add cancelStaleSpend to cancel pending BTC withdrawals"
         },
         UCDController: {
           previousImplementation: "0xB5322F0D4a07d4342FA38137ebD95ac41D1c6036",
@@ -14401,11 +14401,11 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: PositionManagerCoreModule implementation update"
         },
         CollateralManagerModule: {
-          previousImplementation: "0x920e4f52c251B758e351c0d14c4418ad4E5B77ed",
-          newImplementation: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
-          upgradedAt: "2026-05-04T08:26:01.565Z",
+          previousImplementation: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
+          newImplementation: "0x72D17f489A7Ea57Fb665A340424aB7D04a4910aA",
+          upgradedAt: "2026-05-04T13:22:08.881Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: CollateralManagerModule implementation update"
+          reason: "Add cancelStaleSpend to cancel pending BTC withdrawals"
         },
         LiquidationManagerModule: {
           previousImplementation: "0xf74d5437691df92087170861213e26064358A7fb",
@@ -14415,11 +14415,11 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: LiquidationManagerModule implementation update"
         },
         BTCSpendAuthorizer: {
-          previousImplementation: "0x605bf1C988bb307AFA07326954D593A71580e99d",
-          newImplementation: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
-          upgradedAt: "2026-05-04T08:13:12.840Z",
+          previousImplementation: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
+          newImplementation: "0xBA4FAF0b804D72Bc4bdD2827f39DfE9256B5EF4F",
+          upgradedAt: "2026-05-04T13:22:08.881Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: BTCSpendAuthorizer implementation update"
+          reason: "Add cancelStaleSpend + BTCSpendCancelled event"
         },
         SimplePSMV2: {
           previousImplementation: "0xBdEFa375db7F9A498B81bcfdDd14FD16D02ca0BF",
@@ -14509,23 +14509,23 @@ var init_deployment_addresses = __esm({
         CIRCUIT_BREAKER_MODULE: "0x3D0B2cAE481821E57BA9CC3807bCC0d0D7F18bd8",
         ADMIN_MODULE: "0xAcd1f07915b17CA3727e7fE89BdF618A1545a1ed",
         UCD_CONTROLLER_IMPL: "0x2d4d689A70B56b6E0B9F70BffA6265A55173A4A1",
-        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
+        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x8a795b082c002aC07fb43Db0ae8eF8bE653cc4bb",
         TERM_MANAGER_MODULE_IMPL: "0xcc3D2dD7aAfaE5DE923dfd53833a40077178dd75",
         CIRCUIT_BREAKER_MODULE_IMPL: "0x8e9e10B14E6a91ec271FBEb4FD3fB1FE06b545dD",
         ADMIN_MODULE_IMPL: "0x67AE2F872c37f33db9bC631e135432B2845d308b",
         POSITION_MANAGER_VIEWS_IMPL: "0xadF8e0F34082a8fC23e727276e0aEf3af183C8Fd",
-        POSITION_MANAGER_IMPL: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
+        POSITION_MANAGER_IMPL: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
         SIMPLE_PSM_V2: "0x19EcF7BA26e054fd4Ff06009A03070103dbBB058",
         SIMPLE_PSM_V2_IMPL: "0x4107104fDF61AACC674f1F168c275f034c8112BF",
         UCD_TOKEN_IMPL: "0x155Da00Ee0beb1d9D5BA34Aeb62c9ad4E8227d5D",
         POSITION_MANAGER_CORE_MODULE: "0xfFAA39a08887FeFB697eBC8691A8630CbCC33391",
         POSITION_MANAGER_CORE_MODULE_IMPL: "0x41168d9BF8e696eBAB05ea539321ac212859d80b",
         COLLATERAL_MANAGER_MODULE: "0x967E92c976Fc0fa8268D37D4d6B7245d912aA7dB",
-        COLLATERAL_MANAGER_MODULE_IMPL: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
+        COLLATERAL_MANAGER_MODULE_IMPL: "0x72D17f489A7Ea57Fb665A340424aB7D04a4910aA",
         LIQUIDATION_MANAGER_MODULE: "0xC4AB00f39e7ceD812F5C67058C9fa44e15d40e76",
         LIQUIDATION_MANAGER_MODULE_IMPL: "0xf74d5437691df92087170861213e26064358A7fb",
         BTC_SPEND_AUTHORIZER: "0xd7E9Eb5eE53f1d9ee55Dc162bBC7486bE437B6bD",
-        BTC_SPEND_AUTHORIZER_IMPL: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
+        BTC_SPEND_AUTHORIZER_IMPL: "0xBA4FAF0b804D72Bc4bdD2827f39DfE9256B5EF4F",
         UPGRADE_VALIDATOR: "0x592e650edD9bA26ecc407989fdd6F9cdcDeC27A6",
         UPGRADE_VALIDATOR_IMPL: "0xEFf189e5872bC7158191eD39d31E745aF2A6FDa7",
         BITCOIN_PROVIDER_REGISTRY: "0xbfA0c48B070D0a9A9CD27469AeacFD2d4261cEE2",
@@ -42315,107 +42315,6 @@ Error data: ${errorData || "none"}`
       };
     }
   }
-  /**
-   * Cancel a stale authorized BTC spend whose signing/broadcast step never completed.
-   *
-   * Removes the entry from BTCSpendAuthorizer, restoring the UTXO to the available
-   * balance and allowing the borrower to retry via withdrawBTC() + executeBTCWithdrawal().
-   * Only the position's borrower may call this. Inputs come from getPendingWithdrawals().
-   *
-   * @param positionId - Position identifier
-   * @param txid - Bitcoin UTXO txid (from getPendingWithdrawals)
-   * @param vout - Output index (from getPendingWithdrawals)
-   */
-  async cancelStaleSpend(positionId, txid, vout) {
-    this.ensureInitialized();
-    try {
-      const utxoKey = ethers_exports.utils.solidityKeccak256(["string", "uint32"], [txid, vout]);
-      const contract = new ethers_exports.Contract(
-        this.getContractAddressesOrThrow().positionManager,
-        ["function cancelStaleSpend(bytes32,bytes32) external"],
-        this.getSignerOrThrow()
-      );
-      const tx = await contract["cancelStaleSpend"](
-        this.toBytes32(positionId),
-        utxoKey
-      );
-      const receipt = await tx.wait();
-      return { success: true, transactionHash: receipt.transactionHash };
-    } catch (error) {
-      return {
-        success: false,
-        error: error instanceof Error ? error.message : String(error)
-      };
-    }
-  }
-  /**
-   * Check which authorized BTC withdrawals have not yet been broadcast to Bitcoin.
-   *
-   * `withdrawBTC()` records an authorized spend on-chain but never clears it, even
-   * after execution. This method cross-references each authorized spend against the
-   * Bitcoin network (Esplora /outspend) to determine whether the signing+broadcast
-   * step (`executeBTCWithdrawal`) was actually completed.
-   *
-   * status 'pending'  → UTXO still unspent; executeBTCWithdrawal was never called
-   * status 'executed' → UTXO has been spent; withdrawal completed successfully
-   *
-   * @param positionId - Position identifier
-   */
-  async getPendingWithdrawals(positionId) {
-    this.ensureInitialized();
-    const bitcoinProviderUrl = this.config.bitcoinProviders && this.config.bitcoinProviders.length > 0 ? this.config.bitcoinProviders[0]?.url || "" : "";
-    if (!bitcoinProviderUrl) {
-      throw new Error(
-        "bitcoinProviders not configured in SDK config \u2014 required for UTXO spend check"
-      );
-    }
-    const contractAddresses = this.getContractAddressesOrThrow();
-    const positionManagerAbi = [
-      "function getAuthorizedSpends(bytes32) view returns (tuple(string txid, uint32 vout, uint256 satoshis, string targetAddress, uint256 targetAmount, uint256 authorizedAt)[])"
-    ];
-    const positionManager = new ethers_exports.Contract(
-      contractAddresses.positionManager,
-      positionManagerAbi,
-      this.getProviderOrThrow()
-    );
-    const positionIdBytes32 = this.toBytes32(positionId);
-    const authorizedSpends = await positionManager["getAuthorizedSpends"](
-      positionIdBytes32
-    );
-    const withdrawals = [];
-    for (const spend of authorizedSpends) {
-      let status = "pending";
-      try {
-        const resp = await fetch(
-          `${bitcoinProviderUrl}/tx/${spend.txid}/outspend/${spend.vout}`
-        );
-        if (resp.ok) {
-          const data = await resp.json();
-          status = data.spent === true ? "executed" : "pending";
-        }
-      } catch {
-        if (this.config.debug) {
-          log.warn(`\u26A0\uFE0F  Could not check outspend for ${spend.txid}:${spend.vout} \u2014 assuming pending`);
-        }
-      }
-      withdrawals.push({
-        txid: spend.txid,
-        vout: Number(spend.vout),
-        satoshis: BigInt(spend.satoshis.toString()),
-        targetAddress: spend.targetAddress,
-        targetAmount: BigInt(spend.targetAmount.toString()),
-        authorizedAt: Number(spend.authorizedAt),
-        status
-      });
-    }
-    const totalPendingSats = withdrawals.filter((w) => w.status === "pending").reduce((sum, w) => sum + w.satoshis, 0n);
-    return {
-      positionId,
-      withdrawals,
-      hasPending: withdrawals.some((w) => w.status === "pending"),
-      totalPendingSats
-    };
-  }
   /**
    * Execute pending Bitcoin transfers
    *
@@ -42436,25 +42335,25 @@ Error data: ${errorData || "none"}`
         });
       }
       const contractAddresses = this.getContractAddressesOrThrow();
-      const positionManagerAddress = contractAddresses.positionManager;
-      if (!positionManagerAddress) {
+      const btcSpendAuthorizerAddress = contractAddresses.btcSpendAuthorizer;
+      if (!btcSpendAuthorizerAddress) {
         return [
           {
             success: false,
-            error: "PositionManager address not configured"
+            error: "BTCSpendAuthorizer address not configured"
           }
         ];
       }
-      const positionManagerAbi = [
+      const btcSpendAuthorizerAbi = [
         "function getAuthorizedSpends(bytes32) view returns (tuple(string txid, uint32 vout, uint256 satoshis, string targetAddress, uint256 targetAmount, uint256 authorizedAt)[])"
       ];
-      const positionManager = new ethers_exports.Contract(
-        positionManagerAddress,
-        positionManagerAbi,
+      const btcSpendAuthorizer = new ethers_exports.Contract(
+        btcSpendAuthorizerAddress,
+        btcSpendAuthorizerAbi,
         this.getProviderOrThrow()
       );
       const positionIdBytes32 = this.toBytes32(positionId);
-      const authorizedSpends = await positionManager["getAuthorizedSpends"](
+      const authorizedSpends = await btcSpendAuthorizer["getAuthorizedSpends"](
         positionIdBytes32
       );
       if (this.config.debug) {
@@ -42505,6 +42404,92 @@ Error data: ${errorData || "none"}`
       ];
     }
   }
+  /**
+   * Get pending BTC withdrawals for a position
+   *
+   * Returns all authorized spends recorded in BTCSpendAuthorizer that have not yet
+   * been broadcast to the Bitcoin network. An empty array means no pending withdrawals.
+   *
+   * @param positionId - Position identifier
+   * @returns Array of pending withdrawals, each including a pre-computed utxoKey for use with cancelPendingWithdrawal
+   */
+  async getPendingWithdrawals(positionId) {
+    this.ensureInitialized();
+    const contractAddresses = this.getContractAddressesOrThrow();
+    const btcSpendAuthorizerAddress = contractAddresses.btcSpendAuthorizer;
+    if (!btcSpendAuthorizerAddress) {
+      throw new SDKError({
+        code: "SDK_CONTRACT_ADDRESSES_NOT_CONFIGURED",
+        message: "BTCSpendAuthorizer address not configured",
+        category: "CONFIGURATION" /* CONFIGURATION */,
+        severity: "HIGH" /* HIGH */,
+        originalError: new Error("BTCSpendAuthorizer address not configured")
+      });
+    }
+    const abi = [
+      "function getAuthorizedSpends(bytes32) view returns (tuple(string txid, uint32 vout, uint256 satoshis, string targetAddress, uint256 targetAmount, uint256 authorizedAt)[])"
+    ];
+    const contract = new ethers_exports.Contract(
+      btcSpendAuthorizerAddress,
+      abi,
+      this.getProviderOrThrow()
+    );
+    const positionIdBytes32 = this.toBytes32(positionId);
+    const raw = await contract["getAuthorizedSpends"](positionIdBytes32);
+    return raw.map((spend) => ({
+      txid: spend.txid,
+      vout: Number(spend.vout),
+      satoshis: Number(spend.satoshis),
+      targetAddress: spend.targetAddress,
+      targetAmount: Number(spend.targetAmount),
+      authorizedAt: Number(spend.authorizedAt),
+      utxoKey: ethers_exports.utils.solidityKeccak256(
+        ["string", "uint32"],
+        [spend.txid, Number(spend.vout)]
+      )
+    }));
+  }
+  /**
+   * Cancel a pending BTC withdrawal
+   *
+   * Removes a stale authorized spend from BTCSpendAuthorizer, unlocking the UTXO
+   * and allowing the borrower to retry the withdrawal from scratch.
+   * Only the position's borrower may call this — requires a connected signer.
+   *
+   * @param positionId - Position identifier
+   * @param txid - Bitcoin UTXO transaction ID (from getPendingWithdrawals)
+   * @param vout - Output index (from getPendingWithdrawals)
+   * @returns Transaction hash of the cancellation EVM transaction
+   */
+  async cancelPendingWithdrawal(positionId, txid, vout) {
+    this.ensureInitialized();
+    try {
+      const signer = this.getSignerOrThrow();
+      const contractAddresses = this.getContractAddressesOrThrow();
+      const positionManagerAddress = contractAddresses.positionManager;
+      if (!positionManagerAddress) {
+        return { success: false, error: "PositionManager address not configured" };
+      }
+      const utxoKey = ethers_exports.utils.solidityKeccak256(
+        ["string", "uint32"],
+        [txid, vout]
+      );
+      const positionManager = new ethers_exports.Contract(
+        positionManagerAddress,
+        ["function cancelStaleSpend(bytes32 positionId, bytes32 utxoKey) external"],
+        signer
+      );
+      const positionIdBytes32 = this.toBytes32(positionId);
+      const tx = await positionManager["cancelStaleSpend"](positionIdBytes32, utxoKey);
+      const receipt = await tx.wait();
+      return { success: true, transactionHash: receipt.transactionHash };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
   /**
    * Withdraw BTC and execute transfer (Complete Flow)
    *

package/dist/modules/diamond-hands-sdk.d.ts

@@ -353,49 +353,6 @@ export declare class DiamondHandsSDK {
         destination?: string;
         error?: string;
     }>;
-    /**
-     * Cancel a stale authorized BTC spend whose signing/broadcast step never completed.
-     *
-     * Removes the entry from BTCSpendAuthorizer, restoring the UTXO to the available
-     * balance and allowing the borrower to retry via withdrawBTC() + executeBTCWithdrawal().
-     * Only the position's borrower may call this. Inputs come from getPendingWithdrawals().
-     *
-     * @param positionId - Position identifier
-     * @param txid - Bitcoin UTXO txid (from getPendingWithdrawals)
-     * @param vout - Output index (from getPendingWithdrawals)
-     */
-    cancelStaleSpend(positionId: string, txid: string, vout: number): Promise<{
-        success: boolean;
-        transactionHash?: string;
-        error?: string;
-    }>;
-    /**
-     * Check which authorized BTC withdrawals have not yet been broadcast to Bitcoin.
-     *
-     * `withdrawBTC()` records an authorized spend on-chain but never clears it, even
-     * after execution. This method cross-references each authorized spend against the
-     * Bitcoin network (Esplora /outspend) to determine whether the signing+broadcast
-     * step (`executeBTCWithdrawal`) was actually completed.
-     *
-     * status 'pending'  → UTXO still unspent; executeBTCWithdrawal was never called
-     * status 'executed' → UTXO has been spent; withdrawal completed successfully
-     *
-     * @param positionId - Position identifier
-     */
-    getPendingWithdrawals(positionId: string): Promise<{
-        positionId: string;
-        withdrawals: Array<{
-            txid: string;
-            vout: number;
-            satoshis: bigint;
-            targetAddress: string;
-            targetAmount: bigint;
-            authorizedAt: number;
-            status: "pending" | "executed";
-        }>;
-        hasPending: boolean;
-        totalPendingSats: bigint;
-    }>;
     /**
      * Execute pending Bitcoin transfers
      *
@@ -416,6 +373,41 @@ export declare class DiamondHandsSDK {
         destination?: string;
         error?: string;
     }>>;
+    /**
+     * Get pending BTC withdrawals for a position
+     *
+     * Returns all authorized spends recorded in BTCSpendAuthorizer that have not yet
+     * been broadcast to the Bitcoin network. An empty array means no pending withdrawals.
+     *
+     * @param positionId - Position identifier
+     * @returns Array of pending withdrawals, each including a pre-computed utxoKey for use with cancelPendingWithdrawal
+     */
+    getPendingWithdrawals(positionId: string): Promise<Array<{
+        txid: string;
+        vout: number;
+        satoshis: number;
+        targetAddress: string;
+        targetAmount: number;
+        authorizedAt: number;
+        utxoKey: string;
+    }>>;
+    /**
+     * Cancel a pending BTC withdrawal
+     *
+     * Removes a stale authorized spend from BTCSpendAuthorizer, unlocking the UTXO
+     * and allowing the borrower to retry the withdrawal from scratch.
+     * Only the position's borrower may call this — requires a connected signer.
+     *
+     * @param positionId - Position identifier
+     * @param txid - Bitcoin UTXO transaction ID (from getPendingWithdrawals)
+     * @param vout - Output index (from getPendingWithdrawals)
+     * @returns Transaction hash of the cancellation EVM transaction
+     */
+    cancelPendingWithdrawal(positionId: string, txid: string, vout: number): Promise<{
+        success: boolean;
+        transactionHash?: string;
+        error?: string;
+    }>;
     /**
      * Withdraw BTC and execute transfer (Complete Flow)
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gvnrdao/dh-sdk",
-  "version": "0.0.225",
+  "version": "0.0.227",
   "description": "TypeScript SDK for Diamond Hands Protocol - Bitcoin-backed lending with LIT Protocol PKPs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -71,7 +71,7 @@
   "sideEffects": false,
   "dependencies": {
     "@gvnrdao/dh-lit-actions": "^0.0.287",
-    "@gvnrdao/dh-lit-ops": "^0.0.260",
+    "@gvnrdao/dh-lit-ops": "^0.0.261",
     "@noble/hashes": "^1.5.0",
     "axios": "^1.15.2",
     "bech32": "^2.0.0",