@gvnrdao/dh-sdk 0.0.224 → 0.0.226

package/dist/index.js

@@ -42407,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) {
@@ -42447,7 +42447,7 @@ Error data: ${errorData || "none"}`
           positionId,
           utxoIdentifier,
           networkFee,
-          destination: spend.destination,
+          destination: spend.targetAddress,
           rpcUrl
         });
         results.push({
@@ -42476,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

@@ -42335,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) {
@@ -42375,7 +42375,7 @@ Error data: ${errorData || "none"}`
           positionId,
           utxoIdentifier,
           networkFee,
-          destination: spend.destination,
+          destination: spend.targetAddress,
           rpcUrl
         });
         results.push({
@@ -42404,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

@@ -373,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.224",
+  "version": "0.0.226",
   "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",