@gvnrdao/dh-sdk 0.0.275 → 0.0.276

package/dist/deployments.js

@@ -73,11 +73,11 @@ var SEPOLIA_DEPLOYMENT = {
       reason: "Shared upgrade script: PositionManager implementation update"
     },
     LoanOperationsManagerModule: {
-      previousImplementation: "0x291B412c573a4F52410f09D7Ba82eead17D9a674",
-      newImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
-      upgradedAt: "2026-05-17T20:02:12.883Z",
+      previousImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+      newImplementation: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
+      upgradedAt: "2026-06-05T10:52:25.179Z",
       upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-      reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
+      reason: "audit #3 v1.6.0: LoanOperationsManagerModule \u2014 Chainlink feed-staleness gate (maxBtcFeedAgeBorrow / maxBtcFeedAgeLiquidation)"
     },
     UCDController: {
       previousImplementation: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
@@ -282,7 +282,7 @@ var SEPOLIA_DEPLOYMENT = {
     CIRCUIT_BREAKER_MODULE: "0x3D0B2cAE481821E57BA9CC3807bCC0d0D7F18bd8",
     ADMIN_MODULE: "0xAcd1f07915b17CA3727e7fE89BdF618A1545a1ed",
     UCD_CONTROLLER_IMPL: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
-    LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+    LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
     TERM_MANAGER_MODULE_IMPL: "0x358d6A7A864853beAA3E157fEB83dCEb1628E8eB",
     CIRCUIT_BREAKER_MODULE_IMPL: "0xF6277dEF72D51312CC99616B5380f34Eb7603D75",
     ADMIN_MODULE_IMPL: "0xBBA86246169f81a307Fafff02C1e3D8456aab973",

package/dist/deployments.mjs

@@ -40,11 +40,11 @@ var SEPOLIA_DEPLOYMENT = {
       reason: "Shared upgrade script: PositionManager implementation update"
     },
     LoanOperationsManagerModule: {
-      previousImplementation: "0x291B412c573a4F52410f09D7Ba82eead17D9a674",
-      newImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
-      upgradedAt: "2026-05-17T20:02:12.883Z",
+      previousImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+      newImplementation: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
+      upgradedAt: "2026-06-05T10:52:25.179Z",
       upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-      reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
+      reason: "audit #3 v1.6.0: LoanOperationsManagerModule \u2014 Chainlink feed-staleness gate (maxBtcFeedAgeBorrow / maxBtcFeedAgeLiquidation)"
     },
     UCDController: {
       previousImplementation: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
@@ -249,7 +249,7 @@ var SEPOLIA_DEPLOYMENT = {
     CIRCUIT_BREAKER_MODULE: "0x3D0B2cAE481821E57BA9CC3807bCC0d0D7F18bd8",
     ADMIN_MODULE: "0xAcd1f07915b17CA3727e7fE89BdF618A1545a1ed",
     UCD_CONTROLLER_IMPL: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
-    LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+    LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
     TERM_MANAGER_MODULE_IMPL: "0x358d6A7A864853beAA3E157fEB83dCEb1628E8eB",
     CIRCUIT_BREAKER_MODULE_IMPL: "0xF6277dEF72D51312CC99616B5380f34Eb7603D75",
     ADMIN_MODULE_IMPL: "0xBBA86246169f81a307Fafff02C1e3D8456aab973",

package/dist/index.js

@@ -3683,11 +3683,11 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: PositionManager implementation update"
         },
         LoanOperationsManagerModule: {
-          previousImplementation: "0x291B412c573a4F52410f09D7Ba82eead17D9a674",
-          newImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
-          upgradedAt: "2026-05-17T20:02:12.883Z",
+          previousImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+          newImplementation: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
+          upgradedAt: "2026-06-05T10:52:25.179Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
+          reason: "audit #3 v1.6.0: LoanOperationsManagerModule \u2014 Chainlink feed-staleness gate (maxBtcFeedAgeBorrow / maxBtcFeedAgeLiquidation)"
         },
         UCDController: {
           previousImplementation: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
@@ -3892,7 +3892,7 @@ var init_deployment_addresses = __esm({
         CIRCUIT_BREAKER_MODULE: "0x3D0B2cAE481821E57BA9CC3807bCC0d0D7F18bd8",
         ADMIN_MODULE: "0xAcd1f07915b17CA3727e7fE89BdF618A1545a1ed",
         UCD_CONTROLLER_IMPL: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
-        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
         TERM_MANAGER_MODULE_IMPL: "0x358d6A7A864853beAA3E157fEB83dCEb1628E8eB",
         CIRCUIT_BREAKER_MODULE_IMPL: "0xF6277dEF72D51312CC99616B5380f34Eb7603D75",
         ADMIN_MODULE_IMPL: "0xBBA86246169f81a307Fafff02C1e3D8456aab973",
@@ -37202,9 +37202,9 @@ var require_ToPrimitive = __commonJS({
   }
 });
 
-// node_modules/es-abstract/2024/ToString.js
+// node_modules/es-abstract/2025/ToString.js
 var require_ToString = __commonJS({
-  "node_modules/es-abstract/2024/ToString.js"(exports2, module2) {
+  "node_modules/es-abstract/2025/ToString.js"(exports2, module2) {
     "use strict";
     var GetIntrinsic = require_get_intrinsic();
     var $String = GetIntrinsic("%String%");
@@ -37225,13 +37225,20 @@ var require_implementation3 = __commonJS({
     var RequireObjectCoercible = require_RequireObjectCoercible();
     var ToString = require_ToString();
     var callBound = require_call_bound();
+    var safeRegexTester = require_safe_regex_test();
     var $replace = callBound("String.prototype.replace");
+    var $charAt = callBound("String.prototype.charAt");
+    var $slice = callBound("String.prototype.slice");
     var mvsIsWS = /^\s$/.test("\u180E");
     var leftWhitespace = mvsIsWS ? /^[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u180E\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+/ : /^[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+/;
-    var rightWhitespace = mvsIsWS ? /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u180E\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+$/ : /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+$/;
+    var isWhitespace = safeRegexTester(mvsIsWS ? /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u180E\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]$/ : /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]$/);
     module2.exports = function trim() {
-      var S = ToString(RequireObjectCoercible(this));
-      return $replace($replace(S, leftWhitespace, ""), rightWhitespace, "");
+      var S = $replace(ToString(RequireObjectCoercible(this)), leftWhitespace, "");
+      var end = S.length;
+      while (end > 0 && isWhitespace($charAt(S, end - 1))) {
+        end -= 1;
+      }
+      return $slice(S, 0, end);
     };
   }
 });
@@ -37484,6 +37491,22 @@ var require_ToObject = __commonJS({
   }
 });
 
+// node_modules/es-abstract/2024/ToString.js
+var require_ToString2 = __commonJS({
+  "node_modules/es-abstract/2024/ToString.js"(exports2, module2) {
+    "use strict";
+    var GetIntrinsic = require_get_intrinsic();
+    var $String = GetIntrinsic("%String%");
+    var $TypeError = require_type();
+    module2.exports = function ToString(argument) {
+      if (typeof argument === "symbol") {
+        throw new $TypeError("Cannot convert a Symbol value to a string");
+      }
+      return $String(argument);
+    };
+  }
+});
+
 // node_modules/array.prototype.findindex/implementation.js
 var require_implementation4 = __commonJS({
   "node_modules/array.prototype.findindex/implementation.js"(exports2, module2) {
@@ -37494,7 +37517,7 @@ var require_implementation4 = __commonJS({
     var LengthOfArrayLike = require_LengthOfArrayLike();
     var ToBoolean = require_ToBoolean();
     var ToObject = require_ToObject();
-    var ToString = require_ToString();
+    var ToString = require_ToString2();
     module2.exports = function findIndex(predicate) {
       var O = ToObject(this);
       var len = LengthOfArrayLike(O);
@@ -94338,6 +94361,13 @@ var ZeroAddress = "0x0000000000000000000000000000000000000000";
 // node_modules/ethers/lib.esm/constants/hashes.js
 var ZeroHash = "0x0000000000000000000000000000000000000000000000000000000000000000";
 
+// node_modules/ethers/lib.esm/constants/numbers.js
+var N = BigInt("0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141");
+var WeiPerEther = BigInt("1000000000000000000");
+var MaxUint256 = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+var MinInt256 = BigInt("0x8000000000000000000000000000000000000000000000000000000000000000") * BigInt(-1);
+var MaxInt256 = BigInt("0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+
 // node_modules/ethers/lib.esm/crypto/signature.js
 var BN_04 = BigInt(0);
 var BN_13 = BigInt(1);
@@ -123020,6 +123050,78 @@ Error data: ${errorData || "none"}`
     );
     return psm.getAvailableReserves(stablecoinAddress);
   }
+  /**
+   * Execute a PSM stablecoin → UCD swap.
+   * Handles stablecoin approval to the PSM contract if the current allowance is insufficient.
+   *
+   * @param params.stablecoinAddress - ERC-20 address of the stablecoin to swap in
+   * @param params.amountWei - Stablecoin amount in native decimals (bigint)
+   * @param params.minUcdOutWei - Minimum UCD to receive; reverts if below this (1% slippage guard)
+   * @param params.signer - Connected signer for the approval and swap transactions
+   */
+  async psmSwap(params) {
+    const psmAddress = this.config.contractAddresses?.simplePsmV2;
+    if (!psmAddress) {
+      throw new Error(
+        "SimplePSMV2 address not configured \u2014 provide contractAddresses.simplePsmV2"
+      );
+    }
+    const signerAddress = await params.signer.getAddress();
+    const erc20Abi = [
+      "function allowance(address owner, address spender) view returns (uint256)",
+      "function approve(address spender, uint256 amount) returns (bool)"
+    ];
+    const stablecoin = new Contract(params.stablecoinAddress, erc20Abi, params.signer);
+    const allowance = await stablecoin.allowance(signerAddress, psmAddress);
+    if (allowance < params.amountWei) {
+      const approveTx = await stablecoin.approve(psmAddress, MaxUint256);
+      await approveTx.wait();
+    }
+    const psm = SimplePSMV2__factory.connect(psmAddress, params.signer);
+    const tx = await psm.swap(params.stablecoinAddress, params.amountWei, params.minUcdOutWei);
+    const receipt = await tx.wait();
+    if (!receipt)
+      throw new Error("PSM swap transaction receipt unavailable");
+    return { hash: tx.hash, blockNumber: receipt.blockNumber };
+  }
+  /**
+   * Execute a PSM UCD → stablecoin redeem.
+   * Handles UCD approval to UCDController (not PSM) to satisfy the M-4 burn allowance guard:
+   * UCDToken.burn(from, amount) calls _spendAllowance(from, msg.sender=ucdController, amount).
+   *
+   * @param params.stablecoinAddress - ERC-20 address of the stablecoin to receive
+   * @param params.ucdAmountWei - UCD amount to redeem (18 decimals, bigint)
+   * @param params.minStablecoinOutWei - Minimum stablecoin to receive (slippage guard)
+   * @param params.signer - Connected signer
+   */
+  async psmRedeem(params) {
+    const psmAddress = this.config.contractAddresses?.simplePsmV2;
+    const ucdAddress = this.config.contractAddresses?.ucdToken;
+    const ucdControllerAddress = this.config.contractAddresses?.ucdController;
+    if (!psmAddress)
+      throw new Error("SimplePSMV2 address not configured \u2014 provide contractAddresses.simplePsmV2");
+    if (!ucdAddress)
+      throw new Error("UCDToken address not configured \u2014 provide contractAddresses.ucdToken");
+    if (!ucdControllerAddress)
+      throw new Error("UCDController address not configured \u2014 provide contractAddresses.ucdController");
+    const signerAddress = await params.signer.getAddress();
+    const erc20Abi = [
+      "function allowance(address owner, address spender) view returns (uint256)",
+      "function approve(address spender, uint256 amount) returns (bool)"
+    ];
+    const ucdToken = new Contract(ucdAddress, erc20Abi, params.signer);
+    const allowance = await ucdToken.allowance(signerAddress, ucdControllerAddress);
+    if (allowance < params.ucdAmountWei) {
+      const approveTx = await ucdToken.approve(ucdControllerAddress, MaxUint256);
+      await approveTx.wait();
+    }
+    const psm = SimplePSMV2__factory.connect(psmAddress, params.signer);
+    const tx = await psm.redeem(params.stablecoinAddress, params.ucdAmountWei, params.minStablecoinOutWei);
+    const receipt = await tx.wait();
+    if (!receipt)
+      throw new Error("PSM redeem transaction receipt unavailable");
+    return { hash: tx.hash, blockNumber: receipt.blockNumber };
+  }
   /**
    * Wait for the subgraph to index up to (and including) the given block number.
    * Call after on-chain actions (createLoan, mintUCD, etc.) before querying the subgraph.

package/dist/index.mjs

@@ -3689,11 +3689,11 @@ var init_deployment_addresses = __esm({
           reason: "Shared upgrade script: PositionManager implementation update"
         },
         LoanOperationsManagerModule: {
-          previousImplementation: "0x291B412c573a4F52410f09D7Ba82eead17D9a674",
-          newImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
-          upgradedAt: "2026-05-17T20:02:12.883Z",
+          previousImplementation: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+          newImplementation: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
+          upgradedAt: "2026-06-05T10:52:25.179Z",
           upgradedBy: "0xF20986F02420EF443AE9BE5092FB8A4975cF3aA6",
-          reason: "Shared upgrade script: LoanOperationsManagerModule implementation update"
+          reason: "audit #3 v1.6.0: LoanOperationsManagerModule \u2014 Chainlink feed-staleness gate (maxBtcFeedAgeBorrow / maxBtcFeedAgeLiquidation)"
         },
         UCDController: {
           previousImplementation: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
@@ -3898,7 +3898,7 @@ var init_deployment_addresses = __esm({
         CIRCUIT_BREAKER_MODULE: "0x3D0B2cAE481821E57BA9CC3807bCC0d0D7F18bd8",
         ADMIN_MODULE: "0xAcd1f07915b17CA3727e7fE89BdF618A1545a1ed",
         UCD_CONTROLLER_IMPL: "0x30d0458bE846f4C5D231242eB5a9e9Db68e7232F",
-        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x9DA8d69d7BcF9Fa3ba5734580e8C32618aB52D36",
+        LOAN_OPERATIONS_MANAGER_MODULE_IMPL: "0x8c20e9Edf44146718F2EF15eEF47A201CaC229B8",
         TERM_MANAGER_MODULE_IMPL: "0x358d6A7A864853beAA3E157fEB83dCEb1628E8eB",
         CIRCUIT_BREAKER_MODULE_IMPL: "0xF6277dEF72D51312CC99616B5380f34Eb7603D75",
         ADMIN_MODULE_IMPL: "0xBBA86246169f81a307Fafff02C1e3D8456aab973",
@@ -37208,9 +37208,9 @@ var require_ToPrimitive = __commonJS({
   }
 });
 
-// node_modules/es-abstract/2024/ToString.js
+// node_modules/es-abstract/2025/ToString.js
 var require_ToString = __commonJS({
-  "node_modules/es-abstract/2024/ToString.js"(exports2, module2) {
+  "node_modules/es-abstract/2025/ToString.js"(exports2, module2) {
     "use strict";
     var GetIntrinsic = require_get_intrinsic();
     var $String = GetIntrinsic("%String%");
@@ -37231,13 +37231,20 @@ var require_implementation3 = __commonJS({
     var RequireObjectCoercible = require_RequireObjectCoercible();
     var ToString = require_ToString();
     var callBound = require_call_bound();
+    var safeRegexTester = require_safe_regex_test();
     var $replace = callBound("String.prototype.replace");
+    var $charAt = callBound("String.prototype.charAt");
+    var $slice = callBound("String.prototype.slice");
     var mvsIsWS = /^\s$/.test("\u180E");
     var leftWhitespace = mvsIsWS ? /^[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u180E\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+/ : /^[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+/;
-    var rightWhitespace = mvsIsWS ? /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u180E\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+$/ : /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]+$/;
+    var isWhitespace = safeRegexTester(mvsIsWS ? /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u180E\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]$/ : /[\x09\x0A\x0B\x0C\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u202F\u205F\u3000\u2028\u2029\uFEFF]$/);
     module2.exports = function trim() {
-      var S = ToString(RequireObjectCoercible(this));
-      return $replace($replace(S, leftWhitespace, ""), rightWhitespace, "");
+      var S = $replace(ToString(RequireObjectCoercible(this)), leftWhitespace, "");
+      var end = S.length;
+      while (end > 0 && isWhitespace($charAt(S, end - 1))) {
+        end -= 1;
+      }
+      return $slice(S, 0, end);
     };
   }
 });
@@ -37490,6 +37497,22 @@ var require_ToObject = __commonJS({
   }
 });
 
+// node_modules/es-abstract/2024/ToString.js
+var require_ToString2 = __commonJS({
+  "node_modules/es-abstract/2024/ToString.js"(exports2, module2) {
+    "use strict";
+    var GetIntrinsic = require_get_intrinsic();
+    var $String = GetIntrinsic("%String%");
+    var $TypeError = require_type();
+    module2.exports = function ToString(argument) {
+      if (typeof argument === "symbol") {
+        throw new $TypeError("Cannot convert a Symbol value to a string");
+      }
+      return $String(argument);
+    };
+  }
+});
+
 // node_modules/array.prototype.findindex/implementation.js
 var require_implementation4 = __commonJS({
   "node_modules/array.prototype.findindex/implementation.js"(exports2, module2) {
@@ -37500,7 +37523,7 @@ var require_implementation4 = __commonJS({
     var LengthOfArrayLike = require_LengthOfArrayLike();
     var ToBoolean = require_ToBoolean();
     var ToObject = require_ToObject();
-    var ToString = require_ToString();
+    var ToString = require_ToString2();
     module2.exports = function findIndex(predicate) {
       var O = ToObject(this);
       var len = LengthOfArrayLike(O);
@@ -94260,6 +94283,13 @@ var ZeroAddress = "0x0000000000000000000000000000000000000000";
 // node_modules/ethers/lib.esm/constants/hashes.js
 var ZeroHash = "0x0000000000000000000000000000000000000000000000000000000000000000";
 
+// node_modules/ethers/lib.esm/constants/numbers.js
+var N = BigInt("0xfffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364141");
+var WeiPerEther = BigInt("1000000000000000000");
+var MaxUint256 = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+var MinInt256 = BigInt("0x8000000000000000000000000000000000000000000000000000000000000000") * BigInt(-1);
+var MaxInt256 = BigInt("0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+
 // node_modules/ethers/lib.esm/crypto/signature.js
 var BN_04 = BigInt(0);
 var BN_13 = BigInt(1);
@@ -122942,6 +122972,78 @@ Error data: ${errorData || "none"}`
     );
     return psm.getAvailableReserves(stablecoinAddress);
   }
+  /**
+   * Execute a PSM stablecoin → UCD swap.
+   * Handles stablecoin approval to the PSM contract if the current allowance is insufficient.
+   *
+   * @param params.stablecoinAddress - ERC-20 address of the stablecoin to swap in
+   * @param params.amountWei - Stablecoin amount in native decimals (bigint)
+   * @param params.minUcdOutWei - Minimum UCD to receive; reverts if below this (1% slippage guard)
+   * @param params.signer - Connected signer for the approval and swap transactions
+   */
+  async psmSwap(params) {
+    const psmAddress = this.config.contractAddresses?.simplePsmV2;
+    if (!psmAddress) {
+      throw new Error(
+        "SimplePSMV2 address not configured \u2014 provide contractAddresses.simplePsmV2"
+      );
+    }
+    const signerAddress = await params.signer.getAddress();
+    const erc20Abi = [
+      "function allowance(address owner, address spender) view returns (uint256)",
+      "function approve(address spender, uint256 amount) returns (bool)"
+    ];
+    const stablecoin = new Contract(params.stablecoinAddress, erc20Abi, params.signer);
+    const allowance = await stablecoin.allowance(signerAddress, psmAddress);
+    if (allowance < params.amountWei) {
+      const approveTx = await stablecoin.approve(psmAddress, MaxUint256);
+      await approveTx.wait();
+    }
+    const psm = SimplePSMV2__factory.connect(psmAddress, params.signer);
+    const tx = await psm.swap(params.stablecoinAddress, params.amountWei, params.minUcdOutWei);
+    const receipt = await tx.wait();
+    if (!receipt)
+      throw new Error("PSM swap transaction receipt unavailable");
+    return { hash: tx.hash, blockNumber: receipt.blockNumber };
+  }
+  /**
+   * Execute a PSM UCD → stablecoin redeem.
+   * Handles UCD approval to UCDController (not PSM) to satisfy the M-4 burn allowance guard:
+   * UCDToken.burn(from, amount) calls _spendAllowance(from, msg.sender=ucdController, amount).
+   *
+   * @param params.stablecoinAddress - ERC-20 address of the stablecoin to receive
+   * @param params.ucdAmountWei - UCD amount to redeem (18 decimals, bigint)
+   * @param params.minStablecoinOutWei - Minimum stablecoin to receive (slippage guard)
+   * @param params.signer - Connected signer
+   */
+  async psmRedeem(params) {
+    const psmAddress = this.config.contractAddresses?.simplePsmV2;
+    const ucdAddress = this.config.contractAddresses?.ucdToken;
+    const ucdControllerAddress = this.config.contractAddresses?.ucdController;
+    if (!psmAddress)
+      throw new Error("SimplePSMV2 address not configured \u2014 provide contractAddresses.simplePsmV2");
+    if (!ucdAddress)
+      throw new Error("UCDToken address not configured \u2014 provide contractAddresses.ucdToken");
+    if (!ucdControllerAddress)
+      throw new Error("UCDController address not configured \u2014 provide contractAddresses.ucdController");
+    const signerAddress = await params.signer.getAddress();
+    const erc20Abi = [
+      "function allowance(address owner, address spender) view returns (uint256)",
+      "function approve(address spender, uint256 amount) returns (bool)"
+    ];
+    const ucdToken = new Contract(ucdAddress, erc20Abi, params.signer);
+    const allowance = await ucdToken.allowance(signerAddress, ucdControllerAddress);
+    if (allowance < params.ucdAmountWei) {
+      const approveTx = await ucdToken.approve(ucdControllerAddress, MaxUint256);
+      await approveTx.wait();
+    }
+    const psm = SimplePSMV2__factory.connect(psmAddress, params.signer);
+    const tx = await psm.redeem(params.stablecoinAddress, params.ucdAmountWei, params.minStablecoinOutWei);
+    const receipt = await tx.wait();
+    if (!receipt)
+      throw new Error("PSM redeem transaction receipt unavailable");
+    return { hash: tx.hash, blockNumber: receipt.blockNumber };
+  }
   /**
    * Wait for the subgraph to index up to (and including) the given block number.
    * Call after on-chain actions (createLoan, mintUCD, etc.) before querying the subgraph.

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

@@ -11,7 +11,7 @@
  * - Dependency injection pattern
  * - Result-based error handling
  */
-import { type TransactionResponse } from "ethers";
+import { type Signer, type TransactionResponse } from "ethers";
 import { Result } from "../types/result";
 import { Satoshis } from "../types/branded/domain-values";
 import { SDKError } from "../utils/error-handler";
@@ -672,6 +672,43 @@ export declare class DiamondHandsSDK {
      * @param stablecoinAddress - EVM address of the stablecoin to query.
      */
     getPSMAvailableReserves(stablecoinAddress: string): Promise<bigint>;
+    /**
+     * Execute a PSM stablecoin → UCD swap.
+     * Handles stablecoin approval to the PSM contract if the current allowance is insufficient.
+     *
+     * @param params.stablecoinAddress - ERC-20 address of the stablecoin to swap in
+     * @param params.amountWei - Stablecoin amount in native decimals (bigint)
+     * @param params.minUcdOutWei - Minimum UCD to receive; reverts if below this (1% slippage guard)
+     * @param params.signer - Connected signer for the approval and swap transactions
+     */
+    psmSwap(params: {
+        stablecoinAddress: string;
+        amountWei: bigint;
+        minUcdOutWei: bigint;
+        signer: Signer;
+    }): Promise<{
+        hash: string;
+        blockNumber: number;
+    }>;
+    /**
+     * Execute a PSM UCD → stablecoin redeem.
+     * Handles UCD approval to UCDController (not PSM) to satisfy the M-4 burn allowance guard:
+     * UCDToken.burn(from, amount) calls _spendAllowance(from, msg.sender=ucdController, amount).
+     *
+     * @param params.stablecoinAddress - ERC-20 address of the stablecoin to receive
+     * @param params.ucdAmountWei - UCD amount to redeem (18 decimals, bigint)
+     * @param params.minStablecoinOutWei - Minimum stablecoin to receive (slippage guard)
+     * @param params.signer - Connected signer
+     */
+    psmRedeem(params: {
+        stablecoinAddress: string;
+        ucdAmountWei: bigint;
+        minStablecoinOutWei: bigint;
+        signer: Signer;
+    }): Promise<{
+        hash: string;
+        blockNumber: number;
+    }>;
     /**
      * Wait for the subgraph to index up to (and including) the given block number.
      * Call after on-chain actions (createLoan, mintUCD, etc.) before querying the subgraph.

package/package.json

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