@gvnrdao/dh-sdk 0.0.224 → 0.0.225

package/dist/index.js

@@ -14325,16 +14325,16 @@ var init_deployment_addresses = __esm({
       },
       upgraded: {
         PositionManager: {
-          previousImplementation: "0x0e40B4D1708f49319f32d51AF01674c26acACeBF",
-          newImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
-          upgradedAt: "2026-04-30T16:23:00.805Z",
+          previousImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
+          newImplementation: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
+          upgradedAt: "2026-05-04T09:25:00.744Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: PositionManager implementation update"
         },
         LoanOperationsManagerModule: {
-          previousImplementation: "0xCf8998a639cC48139C4c61C8B1005EaC40419b88",
-          newImplementation: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
-          upgradedAt: "2026-04-30T16:40:12.746Z",
+          previousImplementation: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
+          newImplementation: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
+          upgradedAt: "2026-05-04T08:28:12.942Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
         },
@@ -14395,9 +14395,9 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: PositionManagerCoreModule implementation update"
         },
         CollateralManagerModule: {
-          previousImplementation: "0xd021ca6Dc2377F361E3c64f60C93E0e4075c2840",
-          newImplementation: "0x920e4f52c251B758e351c0d14c4418ad4E5B77ed",
-          upgradedAt: "2026-04-30T16:03:49.056Z",
+          previousImplementation: "0x920e4f52c251B758e351c0d14c4418ad4E5B77ed",
+          newImplementation: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
+          upgradedAt: "2026-05-04T08:26:01.565Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: CollateralManagerModule implementation update"
         },
@@ -14409,9 +14409,9 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: LiquidationManagerModule implementation update"
         },
         BTCSpendAuthorizer: {
-          previousImplementation: "0xe7337422e2A4AE7709EFc01fB6C681C8899e673C",
-          newImplementation: "0x605bf1C988bb307AFA07326954D593A71580e99d",
-          upgradedAt: "2026-04-30T20:22:12.956Z",
+          previousImplementation: "0x605bf1C988bb307AFA07326954D593A71580e99d",
+          newImplementation: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
+          upgradedAt: "2026-05-04T08:13:12.840Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: BTCSpendAuthorizer implementation update"
         },
@@ -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: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
+        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
         TERM_MANAGER_MODULE_IMPL: "0xcc3D2dD7aAfaE5DE923dfd53833a40077178dd75",
         CIRCUIT_BREAKER_MODULE_IMPL: "0x8e9e10B14E6a91ec271FBEb4FD3fB1FE06b545dD",
         ADMIN_MODULE_IMPL: "0x67AE2F872c37f33db9bC631e135432B2845d308b",
         POSITION_MANAGER_VIEWS_IMPL: "0xadF8e0F34082a8fC23e727276e0aEf3af183C8Fd",
-        POSITION_MANAGER_IMPL: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
+        POSITION_MANAGER_IMPL: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
         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: "0xd021ca6Dc2377F361E3c64f60C93E0e4075c2840",
+        COLLATERAL_MANAGER_MODULE_IMPL: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
         LIQUIDATION_MANAGER_MODULE: "0xC4AB00f39e7ceD812F5C67058C9fa44e15d40e76",
         LIQUIDATION_MANAGER_MODULE_IMPL: "0xf74d5437691df92087170861213e26064358A7fb",
         BTC_SPEND_AUTHORIZER: "0xd7E9Eb5eE53f1d9ee55Dc162bBC7486bE437B6bD",
-        BTC_SPEND_AUTHORIZER_IMPL: "0x4CD021181bD2583d10aB37D27FE2994b75c41b77",
+        BTC_SPEND_AUTHORIZER_IMPL: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
         UPGRADE_VALIDATOR: "0x592e650edD9bA26ecc407989fdd6F9cdcDeC27A6",
         UPGRADE_VALIDATOR_IMPL: "0xEFf189e5872bC7158191eD39d31E745aF2A6FDa7",
         BITCOIN_PROVIDER_REGISTRY: "0xbfA0c48B070D0a9A9CD27469AeacFD2d4261cEE2",
@@ -42387,6 +42387,107 @@ 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
    *
@@ -42447,7 +42548,7 @@ Error data: ${errorData || "none"}`
           positionId,
           utxoIdentifier,
           networkFee,
-          destination: spend.destination,
+          destination: spend.targetAddress,
           rpcUrl
         });
         results.push({

package/dist/index.mjs

@@ -14331,16 +14331,16 @@ var init_deployment_addresses = __esm({
       },
       upgraded: {
         PositionManager: {
-          previousImplementation: "0x0e40B4D1708f49319f32d51AF01674c26acACeBF",
-          newImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
-          upgradedAt: "2026-04-30T16:23:00.805Z",
+          previousImplementation: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
+          newImplementation: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
+          upgradedAt: "2026-05-04T09:25:00.744Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: PositionManager implementation update"
         },
         LoanOperationsManagerModule: {
-          previousImplementation: "0xCf8998a639cC48139C4c61C8B1005EaC40419b88",
-          newImplementation: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
-          upgradedAt: "2026-04-30T16:40:12.746Z",
+          previousImplementation: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
+          newImplementation: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
+          upgradedAt: "2026-05-04T08:28:12.942Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
         },
@@ -14401,9 +14401,9 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: PositionManagerCoreModule implementation update"
         },
         CollateralManagerModule: {
-          previousImplementation: "0xd021ca6Dc2377F361E3c64f60C93E0e4075c2840",
-          newImplementation: "0x920e4f52c251B758e351c0d14c4418ad4E5B77ed",
-          upgradedAt: "2026-04-30T16:03:49.056Z",
+          previousImplementation: "0x920e4f52c251B758e351c0d14c4418ad4E5B77ed",
+          newImplementation: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
+          upgradedAt: "2026-05-04T08:26:01.565Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: CollateralManagerModule implementation update"
         },
@@ -14415,9 +14415,9 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: LiquidationManagerModule implementation update"
         },
         BTCSpendAuthorizer: {
-          previousImplementation: "0xe7337422e2A4AE7709EFc01fB6C681C8899e673C",
-          newImplementation: "0x605bf1C988bb307AFA07326954D593A71580e99d",
-          upgradedAt: "2026-04-30T20:22:12.956Z",
+          previousImplementation: "0x605bf1C988bb307AFA07326954D593A71580e99d",
+          newImplementation: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
+          upgradedAt: "2026-05-04T08:13:12.840Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
           reason: "Shared upgrade script: BTCSpendAuthorizer implementation update"
         },
@@ -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: "0xF79384d5186B6081124a560e181dC5E0Cf0444dD",
+        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x2C6740cc4F31Aa90a941686c56FFD37467a3164B",
         TERM_MANAGER_MODULE_IMPL: "0xcc3D2dD7aAfaE5DE923dfd53833a40077178dd75",
         CIRCUIT_BREAKER_MODULE_IMPL: "0x8e9e10B14E6a91ec271FBEb4FD3fB1FE06b545dD",
         ADMIN_MODULE_IMPL: "0x67AE2F872c37f33db9bC631e135432B2845d308b",
         POSITION_MANAGER_VIEWS_IMPL: "0xadF8e0F34082a8fC23e727276e0aEf3af183C8Fd",
-        POSITION_MANAGER_IMPL: "0x94096F14f58Cb427B36f2a5aeE24348a26534C74",
+        POSITION_MANAGER_IMPL: "0x45f74eFd06A08040DD69C3059E2edb6966d57518",
         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: "0xd021ca6Dc2377F361E3c64f60C93E0e4075c2840",
+        COLLATERAL_MANAGER_MODULE_IMPL: "0x1Fa0440d3803FEccB612ac9977DE43Cb4008621D",
         LIQUIDATION_MANAGER_MODULE: "0xC4AB00f39e7ceD812F5C67058C9fa44e15d40e76",
         LIQUIDATION_MANAGER_MODULE_IMPL: "0xf74d5437691df92087170861213e26064358A7fb",
         BTC_SPEND_AUTHORIZER: "0xd7E9Eb5eE53f1d9ee55Dc162bBC7486bE437B6bD",
-        BTC_SPEND_AUTHORIZER_IMPL: "0x4CD021181bD2583d10aB37D27FE2994b75c41b77",
+        BTC_SPEND_AUTHORIZER_IMPL: "0x914b3d46F533798A4EFf0Be318E7731c94bf86B1",
         UPGRADE_VALIDATOR: "0x592e650edD9bA26ecc407989fdd6F9cdcDeC27A6",
         UPGRADE_VALIDATOR_IMPL: "0xEFf189e5872bC7158191eD39d31E745aF2A6FDa7",
         BITCOIN_PROVIDER_REGISTRY: "0xbfA0c48B070D0a9A9CD27469AeacFD2d4261cEE2",
@@ -42315,6 +42315,107 @@ 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
    *
@@ -42375,7 +42476,7 @@ Error data: ${errorData || "none"}`
           positionId,
           utxoIdentifier,
           networkFee,
-          destination: spend.destination,
+          destination: spend.targetAddress,
           rpcUrl
         });
         results.push({

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

@@ -353,6 +353,49 @@ 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
      *

package/package.json

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