@gvnrdao/dh-sdk 0.0.132 → 0.0.143

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { ethers, DeferredTopicFilter, EventFragment, EventLog as EventLog$1, ContractTransactionResponse, FunctionFragment, ContractTransaction, LogDescription, Typed, TransactionRequest, BaseContract, ContractRunner, Listener, BigNumberish, BytesLike, AddressLike, ContractMethod, Interface, Result as Result$2, Wallet, providers } from 'ethers';
 import { LitNetwork, LitOps } from '@gvnrdao/dh-lit-ops';
+export { DiamondHandsLitActions, LitActionName } from '@gvnrdao/dh-lit-actions';
 
 /**
  * Result type for standardized error handling across the SDK
@@ -337,9 +338,9 @@ interface ContractAddresses {
     communityManager?: string;
     liquidationManager?: string;
     ucdToken: string;
-    btcProofValidator: string;
     priceFeedConsumer: string;
     operationAuthorizationRegistry?: string;
+    btcProofValidator?: string;
     mockUsdcToken?: string;
     mockUsdcOwner?: string;
     mockUsdtToken?: string;
@@ -417,13 +418,23 @@ interface BaseSDKConfig {
         maxContextKeys?: number;
         verboseInProduction?: boolean;
     };
-    validatorVersion?: number;
+    validators: {
+        /** Validator version for position creation (createPosition) - usually v1 for PKP security validation */
+        loanCreation: number;
+        /** Validator version for UCD minting (mintUCD) - usually v4 for business rules validation */
+        minting: number;
+        /** Validator version for partial payments (makePayment) - usually v1 for payment validation */
+        payment: number;
+        /** Validator version for loan extension/renewal (extendPosition) - usually v4 for extension validation */
+        extension: number;
+    };
     defaultSelectedTermMonths?: number;
     telegram?: {
         chatId: string;
         chatToken: string;
         threadId?: number;
     };
+    temperSignaturesTest?: boolean;
 }
 /**
  * Service Mode Configuration
@@ -611,29 +622,6 @@ declare namespace IPositionManagerCore {
     };
 }
 declare namespace IPositionManager {
-    type PKPPositionDataStruct = {
-        positionId: BytesLike;
-        borrower: AddressLike;
-        amount: BigNumberish;
-        requestedCollateralRatio: BigNumberish;
-        selectedTerm: BigNumberish;
-        createdAt: BigNumberish;
-    };
-    type PKPPositionDataStructOutput = [
-        positionId: string,
-        borrower: string,
-        amount: bigint,
-        requestedCollateralRatio: bigint,
-        selectedTerm: bigint,
-        createdAt: bigint
-    ] & {
-        positionId: string;
-        borrower: string;
-        amount: bigint;
-        requestedCollateralRatio: bigint;
-        selectedTerm: bigint;
-        createdAt: bigint;
-    };
     type PositionStruct = {
         positionId: BytesLike;
         pkpId: BytesLike;
@@ -673,6 +661,7 @@ declare namespace ICollateralManager {
         actionHash: BytesLike;
         authorizedSpendsHash: BytesLike;
         ucdDebtHash: BytesLike;
+        contractBundleHash: BytesLike;
         withdrawalAddress: string;
         totalDeduction: BigNumberish;
         newCollateral: BigNumberish;
@@ -686,6 +675,7 @@ declare namespace ICollateralManager {
         actionHash: string,
         authorizedSpendsHash: string,
         ucdDebtHash: string,
+        contractBundleHash: string,
         withdrawalAddress: string,
         totalDeduction: bigint,
         newCollateral: bigint,
@@ -698,6 +688,7 @@ declare namespace ICollateralManager {
         actionHash: string;
         authorizedSpendsHash: string;
         ucdDebtHash: string;
+        contractBundleHash: string;
         withdrawalAddress: string;
         totalDeduction: bigint;
         newCollateral: bigint;
@@ -708,8 +699,8 @@ declare namespace ICollateralManager {
     };
 }
 interface PositionManagerInterface extends Interface {
-    getFunction(nameOrSignature: "ADMIN_ROLE" | "COMMUNITY_FEE_DISTRIBUTOR_ROLE" | "COMMUNITY_MINTER_ROLE" | "DEFAULT_ADMIN_ROLE" | "EMERGENCY_PAUSE_ROLE" | "LIQUIDATOR_ROLE" | "ORACLE_UPDATER_ROLE" | "UPGRADE_INTERFACE_VERSION" | "VERSION" | "_performExtensionValidation" | "admin" | "authorizationRegistry" | "calculateCollateralRatio" | "circuitBreaker" | "clearExtensionPending" | "collateral" | "commitLiquidation" | "communityManager" | "core" | "createPosition" | "extendPosition" | "getExpiredLoanLiquidationThreshold" | "getPKPLoanParams" | "getPKPPositionData" | "getPositionDetails" | "getPositionStatus" | "getRoleAdmin" | "grantRole" | "hasRole" | "initialize" | "isExpiredLoanLiquidatable" | "liquidatePosition" | "liquidation" | "loanOps" | "makePartialPayment" | "paused" | "pkpValidationRegistry" | "proxiableUUID" | "renounceRole" | "repayPosition" | "revealAndLiquidate" | "revokeRole" | "setAuthorizationRegistry" | "setPKPValidationRegistry" | "supportsInterface" | "termManager" | "updateDebtFromLoanOps" | "updateModules" | "updatePosition" | "updatePositionStatusFromLoanOps" | "upgradeToAndCall" | "validatePKPLogic" | "validateUpgrade" | "views" | "withdrawBTC"): FunctionFragment;
-    getEvent(nameOrSignatureOrTopic: "CollateralRatioUpdated" | "ExtensionPendingCleared" | "Initialized" | "IntegrityCheckFailed" | "ModulesUpdatedBatch" | "PKPLogicValidated" | "PKPValidationRegistryUpdated" | "PartialPaymentMade" | "Paused" | "PositionClosed" | "PositionCreated" | "PositionLiquidated" | "PositionRenewed" | "PositionRepaid" | "PositionStatusUpdated" | "PositionUpdated" | "RoleAdminChanged" | "RoleGranted" | "RoleRevoked" | "UCDMinted" | "Unpaused" | "Upgraded"): EventFragment;
+    getFunction(nameOrSignature: "ADMIN_ROLE" | "COMMUNITY_FEE_DISTRIBUTOR_ROLE" | "COMMUNITY_MINTER_ROLE" | "DEFAULT_ADMIN_ROLE" | "EMERGENCY_PAUSE_ROLE" | "LIQUIDATOR_ROLE" | "ORACLE_UPDATER_ROLE" | "UPGRADE_INTERFACE_VERSION" | "VERSION" | "_performExtensionValidation" | "admin" | "authorizationRegistry" | "circuitBreaker" | "clearExtensionPending" | "collateral" | "commitLiquidation" | "communityManager" | "computeMintMessageHash" | "core" | "createPosition" | "extendPosition" | "getExpiredLoanLiquidationThreshold" | "getMintMessageHashParameters" | "getPositionById" | "getPositionByPkp" | "getRoleAdmin" | "grantRole" | "hasRole" | "initialize" | "isExpiredLoanLiquidatable" | "isExtensionPending" | "liquidatePosition" | "liquidation" | "loanOps" | "makePayment" | "mintUCD" | "paused" | "pkpValidationRegistry" | "proxiableUUID" | "renounceRole" | "revealAndLiquidate" | "revokeRole" | "setAuthorizationRegistry" | "setPKPValidationRegistry" | "supportsInterface" | "termManager" | "updateBalance" | "updateDebtFromLoanOps" | "updateModules" | "updatePositionStatusFromLoanOps" | "upgradeToAndCall" | "verifyAuthorization" | "views" | "withdrawBTC"): FunctionFragment;
+    getEvent(nameOrSignatureOrTopic: "BalanceConfirmed" | "ExtensionPendingCleared" | "Initialized" | "ModulesUpdatedBatch" | "PKPLogicValidated" | "PKPValidationRegistryUpdated" | "PartialPaymentMade" | "Paused" | "PositionClosed" | "PositionCreated" | "PositionLiquidated" | "PositionRenewed" | "PositionRepaid" | "PositionStatusUpdated" | "PositionUpdated" | "RoleAdminChanged" | "RoleGranted" | "RoleRevoked" | "UCDMinted" | "Unpaused" | "Upgraded"): EventFragment;
     encodeFunctionData(functionFragment: "ADMIN_ROLE", values?: undefined): string;
     encodeFunctionData(functionFragment: "COMMUNITY_FEE_DISTRIBUTOR_ROLE", values?: undefined): string;
     encodeFunctionData(functionFragment: "COMMUNITY_MINTER_ROLE", values?: undefined): string;
@@ -719,23 +710,46 @@ interface PositionManagerInterface extends Interface {
     encodeFunctionData(functionFragment: "ORACLE_UPDATER_ROLE", values?: undefined): string;
     encodeFunctionData(functionFragment: "UPGRADE_INTERFACE_VERSION", values?: undefined): string;
     encodeFunctionData(functionFragment: "VERSION", values?: undefined): string;
-    encodeFunctionData(functionFragment: "_performExtensionValidation", values: [IPositionManagerCore.PositionStruct, BigNumberish, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "_performExtensionValidation", values: [
+        IPositionManagerCore.PositionStruct,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish
+    ]): string;
     encodeFunctionData(functionFragment: "admin", values?: undefined): string;
     encodeFunctionData(functionFragment: "authorizationRegistry", values?: undefined): string;
-    encodeFunctionData(functionFragment: "calculateCollateralRatio", values: [BytesLike]): string;
     encodeFunctionData(functionFragment: "circuitBreaker", values?: undefined): string;
     encodeFunctionData(functionFragment: "clearExtensionPending", values: [BytesLike]): string;
     encodeFunctionData(functionFragment: "collateral", values?: undefined): string;
-    encodeFunctionData(functionFragment: "commitLiquidation", values: [BytesLike, BytesLike]): string;
+    encodeFunctionData(functionFragment: "commitLiquidation", values: [BytesLike, BigNumberish, BigNumberish, BytesLike]): string;
     encodeFunctionData(functionFragment: "communityManager", values?: undefined): string;
+    encodeFunctionData(functionFragment: "computeMintMessageHash", values: [
+        BytesLike,
+        BytesLike,
+        BytesLike,
+        BytesLike,
+        BytesLike,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish
+    ]): string;
     encodeFunctionData(functionFragment: "core", values?: undefined): string;
     encodeFunctionData(functionFragment: "createPosition", values: [BytesLike, BytesLike, string, string, BigNumberish, BigNumberish]): string;
-    encodeFunctionData(functionFragment: "extendPosition", values: [BytesLike, BigNumberish, BigNumberish, BigNumberish, BytesLike]): string;
+    encodeFunctionData(functionFragment: "extendPosition", values: [
+        BytesLike,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BytesLike
+    ]): string;
     encodeFunctionData(functionFragment: "getExpiredLoanLiquidationThreshold", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "getPKPLoanParams", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "getPKPPositionData", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "getPositionDetails", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "getPositionStatus", values: [BytesLike]): string;
+    encodeFunctionData(functionFragment: "getMintMessageHashParameters", values?: undefined): string;
+    encodeFunctionData(functionFragment: "getPositionById", values: [BytesLike]): string;
+    encodeFunctionData(functionFragment: "getPositionByPkp", values: [BytesLike]): string;
     encodeFunctionData(functionFragment: "getRoleAdmin", values: [BytesLike]): string;
     encodeFunctionData(functionFragment: "grantRole", values: [BytesLike, AddressLike]): string;
     encodeFunctionData(functionFragment: "hasRole", values: [BytesLike, AddressLike]): string;
@@ -752,21 +766,35 @@ interface PositionManagerInterface extends Interface {
         AddressLike
     ]): string;
     encodeFunctionData(functionFragment: "isExpiredLoanLiquidatable", values: [BytesLike, BigNumberish, BigNumberish]): string;
-    encodeFunctionData(functionFragment: "liquidatePosition", values: [BytesLike]): string;
+    encodeFunctionData(functionFragment: "isExtensionPending", values: [BytesLike]): string;
+    encodeFunctionData(functionFragment: "liquidatePosition", values: [BytesLike, BigNumberish, BigNumberish, BytesLike]): string;
     encodeFunctionData(functionFragment: "liquidation", values?: undefined): string;
     encodeFunctionData(functionFragment: "loanOps", values?: undefined): string;
-    encodeFunctionData(functionFragment: "makePartialPayment", values: [BytesLike, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "makePayment", values: [BytesLike, BigNumberish, BigNumberish, BigNumberish, BytesLike]): string;
+    encodeFunctionData(functionFragment: "mintUCD", values: [
+        BytesLike,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BigNumberish,
+        BytesLike,
+        BytesLike,
+        BytesLike,
+        BigNumberish,
+        BytesLike
+    ]): string;
     encodeFunctionData(functionFragment: "paused", values?: undefined): string;
     encodeFunctionData(functionFragment: "pkpValidationRegistry", values?: undefined): string;
     encodeFunctionData(functionFragment: "proxiableUUID", values?: undefined): string;
     encodeFunctionData(functionFragment: "renounceRole", values: [BytesLike, AddressLike]): string;
-    encodeFunctionData(functionFragment: "repayPosition", values: [BytesLike, BigNumberish]): string;
-    encodeFunctionData(functionFragment: "revealAndLiquidate", values: [BytesLike, BigNumberish, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "revealAndLiquidate", values: [BytesLike, BigNumberish, BigNumberish, BytesLike, BigNumberish]): string;
     encodeFunctionData(functionFragment: "revokeRole", values: [BytesLike, AddressLike]): string;
     encodeFunctionData(functionFragment: "setAuthorizationRegistry", values: [AddressLike]): string;
     encodeFunctionData(functionFragment: "setPKPValidationRegistry", values: [AddressLike]): string;
     encodeFunctionData(functionFragment: "supportsInterface", values: [BytesLike]): string;
     encodeFunctionData(functionFragment: "termManager", values?: undefined): string;
+    encodeFunctionData(functionFragment: "updateBalance", values: [BytesLike, BigNumberish, BigNumberish, BytesLike]): string;
     encodeFunctionData(functionFragment: "updateDebtFromLoanOps", values: [BytesLike, BigNumberish, BigNumberish]): string;
     encodeFunctionData(functionFragment: "updateModules", values: [
         AddressLike,
@@ -777,11 +805,9 @@ interface PositionManagerInterface extends Interface {
         AddressLike,
         AddressLike
     ]): string;
-    encodeFunctionData(functionFragment: "updatePosition", values: [BytesLike, BigNumberish]): string;
     encodeFunctionData(functionFragment: "updatePositionStatusFromLoanOps", values: [BytesLike, BigNumberish]): string;
     encodeFunctionData(functionFragment: "upgradeToAndCall", values: [AddressLike, BytesLike]): string;
-    encodeFunctionData(functionFragment: "validatePKPLogic", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "validateUpgrade", values: [AddressLike]): string;
+    encodeFunctionData(functionFragment: "verifyAuthorization", values: [BytesLike, BytesLike, BytesLike]): string;
     encodeFunctionData(functionFragment: "views", values?: undefined): string;
     encodeFunctionData(functionFragment: "withdrawBTC", values: [ICollateralManager.WithdrawalParamsStruct, BytesLike]): string;
     decodeFunctionResult(functionFragment: "ADMIN_ROLE", data: BytesLike): Result$2;
@@ -796,65 +822,67 @@ interface PositionManagerInterface extends Interface {
     decodeFunctionResult(functionFragment: "_performExtensionValidation", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "admin", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "authorizationRegistry", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "calculateCollateralRatio", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "circuitBreaker", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "clearExtensionPending", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "collateral", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "commitLiquidation", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "communityManager", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "computeMintMessageHash", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "core", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "createPosition", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "extendPosition", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "getExpiredLoanLiquidationThreshold", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "getPKPLoanParams", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "getPKPPositionData", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "getPositionDetails", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "getPositionStatus", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "getMintMessageHashParameters", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "getPositionById", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "getPositionByPkp", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "getRoleAdmin", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "grantRole", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "hasRole", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "initialize", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "isExpiredLoanLiquidatable", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "isExtensionPending", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "liquidatePosition", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "liquidation", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "loanOps", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "makePartialPayment", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "makePayment", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "mintUCD", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "paused", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "pkpValidationRegistry", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "proxiableUUID", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "renounceRole", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "repayPosition", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "revealAndLiquidate", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "revokeRole", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "setAuthorizationRegistry", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "setPKPValidationRegistry", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "supportsInterface", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "termManager", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "updateBalance", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "updateDebtFromLoanOps", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "updateModules", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "updatePosition", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "updatePositionStatusFromLoanOps", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "upgradeToAndCall", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "validatePKPLogic", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "validateUpgrade", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "verifyAuthorization", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "views", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "withdrawBTC", data: BytesLike): Result$2;
 }
-declare namespace CollateralRatioUpdatedEvent {
+declare namespace BalanceConfirmedEvent {
     type InputTuple = [
         positionId: BytesLike,
-        oldRatio: BigNumberish,
-        newRatio: BigNumberish
+        collateralValue: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        confirmedAt: BigNumberish
     ];
     type OutputTuple = [
         positionId: string,
-        oldRatio: bigint,
-        newRatio: bigint
+        collateralValue: bigint,
+        quantumTimestamp: bigint,
+        confirmedAt: bigint
     ];
     interface OutputObject {
         positionId: string;
-        oldRatio: bigint;
-        newRatio: bigint;
+        collateralValue: bigint;
+        quantumTimestamp: bigint;
+        confirmedAt: bigint;
     }
     type Event = TypedContractEvent<InputTuple, OutputTuple, OutputObject>;
     type Filter = TypedDeferredTopicFilter<Event>;
@@ -884,30 +912,6 @@ declare namespace InitializedEvent$1 {
     type Log = TypedEventLog<Event>;
     type LogDescription = TypedLogDescription<Event>;
 }
-declare namespace IntegrityCheckFailedEvent {
-    type InputTuple = [
-        positionId: BytesLike,
-        checkType: string,
-        reason: string,
-        timestamp: BigNumberish
-    ];
-    type OutputTuple = [
-        positionId: string,
-        checkType: string,
-        reason: string,
-        timestamp: bigint
-    ];
-    interface OutputObject {
-        positionId: string;
-        checkType: string;
-        reason: string;
-        timestamp: bigint;
-    }
-    type Event = TypedContractEvent<InputTuple, OutputTuple, OutputObject>;
-    type Filter = TypedDeferredTopicFilter<Event>;
-    type Log = TypedEventLog<Event>;
-    type LogDescription = TypedLogDescription<Event>;
-}
 declare namespace ModulesUpdatedBatchEvent {
     type InputTuple = [updatedBy: AddressLike, moduleCount: BigNumberish];
     type OutputTuple = [updatedBy: string, moduleCount: bigint];
@@ -958,22 +962,19 @@ declare namespace PartialPaymentMadeEvent {
         positionId: BytesLike,
         payer: AddressLike,
         paymentAmount: BigNumberish,
-        remainingDebt: BigNumberish,
-        newCollateralRatio: BigNumberish
+        remainingDebt: BigNumberish
     ];
     type OutputTuple = [
         positionId: string,
         payer: string,
         paymentAmount: bigint,
-        remainingDebt: bigint,
-        newCollateralRatio: bigint
+        remainingDebt: bigint
     ];
     interface OutputObject {
         positionId: string;
         payer: string;
         paymentAmount: bigint;
         remainingDebt: bigint;
-        newCollateralRatio: bigint;
     }
     type Event = TypedContractEvent<InputTuple, OutputTuple, OutputObject>;
     type Filter = TypedDeferredTopicFilter<Event>;
@@ -1284,7 +1285,8 @@ interface PositionManager extends BaseContract {
     _performExtensionValidation: TypedContractMethod<[
         position: IPositionManagerCore.PositionStruct,
         selectedTerm: BigNumberish,
-        btcPrice: BigNumberish
+        btcPrice: BigNumberish,
+        availableBTCBalance: BigNumberish
     ], [
         [
             bigint,
@@ -1300,11 +1302,6 @@ interface PositionManager extends BaseContract {
     ], "view">;
     admin: TypedContractMethod<[], [string], "view">;
     authorizationRegistry: TypedContractMethod<[], [string], "view">;
-    calculateCollateralRatio: TypedContractMethod<[
-        positionId: BytesLike
-    ], [
-        bigint
-    ], "view">;
     circuitBreaker: TypedContractMethod<[], [string], "view">;
     clearExtensionPending: TypedContractMethod<[
         positionId: BytesLike
@@ -1314,11 +1311,28 @@ interface PositionManager extends BaseContract {
     collateral: TypedContractMethod<[], [string], "view">;
     commitLiquidation: TypedContractMethod<[
         positionId: BytesLike,
-        commitHash: BytesLike
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        liquidationValidatorSignature: BytesLike
     ], [
         void
     ], "nonpayable">;
     communityManager: TypedContractMethod<[], [string], "view">;
+    computeMintMessageHash: TypedContractMethod<[
+        positionId: BytesLike,
+        actionHash: BytesLike,
+        authorizedSpendsHash: BytesLike,
+        ucdDebtHash: BytesLike,
+        contractHash: BytesLike,
+        btcPrice: BigNumberish,
+        mintAmount: BigNumberish,
+        mintFee: BigNumberish,
+        newCollateral: BigNumberish,
+        newDebt: BigNumberish,
+        quantumTimestamp: BigNumberish
+    ], [
+        string
+    ], "view">;
     core: TypedContractMethod<[], [string], "view">;
     createPosition: TypedContractMethod<[
         pkpId: BytesLike,
@@ -1335,6 +1349,7 @@ interface PositionManager extends BaseContract {
         selectedTerm: BigNumberish,
         quantumTimestamp: BigNumberish,
         btcPrice: BigNumberish,
+        availableBTCBalance: BigNumberish,
         extensionValidatorSignature: BytesLike
     ], [
         boolean
@@ -1344,26 +1359,13 @@ interface PositionManager extends BaseContract {
     ], [
         bigint
     ], "view">;
-    getPKPLoanParams: TypedContractMethod<[
-        arg0: BytesLike
-    ], [
-        [bigint, bigint, bigint]
-    ], "view">;
-    getPKPPositionData: TypedContractMethod<[
-        arg0: BytesLike
-    ], [
-        IPositionManager.PKPPositionDataStructOutput
-    ], "view">;
-    getPositionDetails: TypedContractMethod<[
+    getMintMessageHashParameters: TypedContractMethod<[], [string[]], "view">;
+    getPositionById: TypedContractMethod<[
         positionId: BytesLike
     ], [
         IPositionManager.PositionStructOutput
     ], "view">;
-    getPositionStatus: TypedContractMethod<[
-        positionId: BytesLike
-    ], [
-        bigint
-    ], "view">;
+    getPositionByPkp: TypedContractMethod<[pkpId: BytesLike], [string], "view">;
     getRoleAdmin: TypedContractMethod<[role: BytesLike], [string], "view">;
     grantRole: TypedContractMethod<[
         role: BytesLike,
@@ -1398,16 +1400,42 @@ interface PositionManager extends BaseContract {
     ], [
         boolean
     ], "view">;
-    liquidatePosition: TypedContractMethod<[
+    isExtensionPending: TypedContractMethod<[
         positionId: BytesLike
     ], [
         boolean
+    ], "view">;
+    liquidatePosition: TypedContractMethod<[
+        positionId: BytesLike,
+        btcPrice: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        liquidationValidatorSignature: BytesLike
+    ], [
+        boolean
     ], "nonpayable">;
     liquidation: TypedContractMethod<[], [string], "view">;
     loanOps: TypedContractMethod<[], [string], "view">;
-    makePartialPayment: TypedContractMethod<[
+    makePayment: TypedContractMethod<[
         positionId: BytesLike,
-        paymentAmount: BigNumberish
+        paymentAmount: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        paymentValidatorSignature: BytesLike
+    ], [
+        boolean
+    ], "nonpayable">;
+    mintUCD: TypedContractMethod<[
+        positionId: BytesLike,
+        mintAmount: BigNumberish,
+        mintFee: BigNumberish,
+        newDebt: BigNumberish,
+        newCollateral: BigNumberish,
+        btcPrice: BigNumberish,
+        authorizedSpendsHash: BytesLike,
+        ucdDebtHash: BytesLike,
+        contractHash: BytesLike,
+        quantumTimestamp: BigNumberish,
+        mintValidatorSignature: BytesLike
     ], [
         boolean
     ], "nonpayable">;
@@ -1420,15 +1448,11 @@ interface PositionManager extends BaseContract {
     ], [
         void
     ], "nonpayable">;
-    repayPosition: TypedContractMethod<[
-        positionId: BytesLike,
-        repaymentAmount: BigNumberish
-    ], [
-        boolean
-    ], "nonpayable">;
     revealAndLiquidate: TypedContractMethod<[
         positionId: BytesLike,
-        nonce: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        liquidationValidatorSignature: BytesLike,
         deadline: BigNumberish
     ], [
         boolean
@@ -1455,6 +1479,14 @@ interface PositionManager extends BaseContract {
         boolean
     ], "view">;
     termManager: TypedContractMethod<[], [string], "view">;
+    updateBalance: TypedContractMethod<[
+        positionId: BytesLike,
+        collateralValue: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        signature: BytesLike
+    ], [
+        void
+    ], "nonpayable">;
     updateDebtFromLoanOps: TypedContractMethod<[
         positionId: BytesLike,
         newDebt: BigNumberish,
@@ -1473,12 +1505,6 @@ interface PositionManager extends BaseContract {
     ], [
         void
     ], "nonpayable">;
-    updatePosition: TypedContractMethod<[
-        positionId: BytesLike,
-        newDebt: BigNumberish
-    ], [
-        boolean
-    ], "nonpayable">;
     updatePositionStatusFromLoanOps: TypedContractMethod<[
         positionId: BytesLike,
         newStatus: BigNumberish
@@ -1491,9 +1517,10 @@ interface PositionManager extends BaseContract {
     ], [
         void
     ], "payable">;
-    validatePKPLogic: TypedContractMethod<[pkpId: BytesLike], [boolean], "view">;
-    validateUpgrade: TypedContractMethod<[
-        newImplementation: AddressLike
+    verifyAuthorization: TypedContractMethod<[
+        selector: BytesLike,
+        messageHash: BytesLike,
+        signature: BytesLike
     ], [
         boolean
     ], "view">;
@@ -1517,7 +1544,8 @@ interface PositionManager extends BaseContract {
     getFunction(nameOrSignature: "_performExtensionValidation"): TypedContractMethod<[
         position: IPositionManagerCore.PositionStruct,
         selectedTerm: BigNumberish,
-        btcPrice: BigNumberish
+        btcPrice: BigNumberish,
+        availableBTCBalance: BigNumberish
     ], [
         [
             bigint,
@@ -1533,17 +1561,33 @@ interface PositionManager extends BaseContract {
     ], "view">;
     getFunction(nameOrSignature: "admin"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "authorizationRegistry"): TypedContractMethod<[], [string], "view">;
-    getFunction(nameOrSignature: "calculateCollateralRatio"): TypedContractMethod<[positionId: BytesLike], [bigint], "view">;
     getFunction(nameOrSignature: "circuitBreaker"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "clearExtensionPending"): TypedContractMethod<[positionId: BytesLike], [void], "nonpayable">;
     getFunction(nameOrSignature: "collateral"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "commitLiquidation"): TypedContractMethod<[
         positionId: BytesLike,
-        commitHash: BytesLike
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        liquidationValidatorSignature: BytesLike
     ], [
         void
     ], "nonpayable">;
     getFunction(nameOrSignature: "communityManager"): TypedContractMethod<[], [string], "view">;
+    getFunction(nameOrSignature: "computeMintMessageHash"): TypedContractMethod<[
+        positionId: BytesLike,
+        actionHash: BytesLike,
+        authorizedSpendsHash: BytesLike,
+        ucdDebtHash: BytesLike,
+        contractHash: BytesLike,
+        btcPrice: BigNumberish,
+        mintAmount: BigNumberish,
+        mintFee: BigNumberish,
+        newCollateral: BigNumberish,
+        newDebt: BigNumberish,
+        quantumTimestamp: BigNumberish
+    ], [
+        string
+    ], "view">;
     getFunction(nameOrSignature: "core"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "createPosition"): TypedContractMethod<[
         pkpId: BytesLike,
@@ -1560,23 +1604,19 @@ interface PositionManager extends BaseContract {
         selectedTerm: BigNumberish,
         quantumTimestamp: BigNumberish,
         btcPrice: BigNumberish,
+        availableBTCBalance: BigNumberish,
         extensionValidatorSignature: BytesLike
     ], [
         boolean
     ], "nonpayable">;
     getFunction(nameOrSignature: "getExpiredLoanLiquidationThreshold"): TypedContractMethod<[positionId: BytesLike], [bigint], "view">;
-    getFunction(nameOrSignature: "getPKPLoanParams"): TypedContractMethod<[arg0: BytesLike], [[bigint, bigint, bigint]], "view">;
-    getFunction(nameOrSignature: "getPKPPositionData"): TypedContractMethod<[
-        arg0: BytesLike
-    ], [
-        IPositionManager.PKPPositionDataStructOutput
-    ], "view">;
-    getFunction(nameOrSignature: "getPositionDetails"): TypedContractMethod<[
+    getFunction(nameOrSignature: "getMintMessageHashParameters"): TypedContractMethod<[], [string[]], "view">;
+    getFunction(nameOrSignature: "getPositionById"): TypedContractMethod<[
         positionId: BytesLike
     ], [
         IPositionManager.PositionStructOutput
     ], "view">;
-    getFunction(nameOrSignature: "getPositionStatus"): TypedContractMethod<[positionId: BytesLike], [bigint], "view">;
+    getFunction(nameOrSignature: "getPositionByPkp"): TypedContractMethod<[pkpId: BytesLike], [string], "view">;
     getFunction(nameOrSignature: "getRoleAdmin"): TypedContractMethod<[role: BytesLike], [string], "view">;
     getFunction(nameOrSignature: "grantRole"): TypedContractMethod<[
         role: BytesLike,
@@ -1611,12 +1651,38 @@ interface PositionManager extends BaseContract {
     ], [
         boolean
     ], "view">;
-    getFunction(nameOrSignature: "liquidatePosition"): TypedContractMethod<[positionId: BytesLike], [boolean], "nonpayable">;
+    getFunction(nameOrSignature: "isExtensionPending"): TypedContractMethod<[positionId: BytesLike], [boolean], "view">;
+    getFunction(nameOrSignature: "liquidatePosition"): TypedContractMethod<[
+        positionId: BytesLike,
+        btcPrice: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        liquidationValidatorSignature: BytesLike
+    ], [
+        boolean
+    ], "nonpayable">;
     getFunction(nameOrSignature: "liquidation"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "loanOps"): TypedContractMethod<[], [string], "view">;
-    getFunction(nameOrSignature: "makePartialPayment"): TypedContractMethod<[
+    getFunction(nameOrSignature: "makePayment"): TypedContractMethod<[
+        positionId: BytesLike,
+        paymentAmount: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        paymentValidatorSignature: BytesLike
+    ], [
+        boolean
+    ], "nonpayable">;
+    getFunction(nameOrSignature: "mintUCD"): TypedContractMethod<[
         positionId: BytesLike,
-        paymentAmount: BigNumberish
+        mintAmount: BigNumberish,
+        mintFee: BigNumberish,
+        newDebt: BigNumberish,
+        newCollateral: BigNumberish,
+        btcPrice: BigNumberish,
+        authorizedSpendsHash: BytesLike,
+        ucdDebtHash: BytesLike,
+        contractHash: BytesLike,
+        quantumTimestamp: BigNumberish,
+        mintValidatorSignature: BytesLike
     ], [
         boolean
     ], "nonpayable">;
@@ -1629,15 +1695,11 @@ interface PositionManager extends BaseContract {
     ], [
         void
     ], "nonpayable">;
-    getFunction(nameOrSignature: "repayPosition"): TypedContractMethod<[
-        positionId: BytesLike,
-        repaymentAmount: BigNumberish
-    ], [
-        boolean
-    ], "nonpayable">;
     getFunction(nameOrSignature: "revealAndLiquidate"): TypedContractMethod<[
         positionId: BytesLike,
-        nonce: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        liquidationValidatorSignature: BytesLike,
         deadline: BigNumberish
     ], [
         boolean
@@ -1652,6 +1714,14 @@ interface PositionManager extends BaseContract {
     getFunction(nameOrSignature: "setPKPValidationRegistry"): TypedContractMethod<[registry: AddressLike], [void], "nonpayable">;
     getFunction(nameOrSignature: "supportsInterface"): TypedContractMethod<[interfaceId: BytesLike], [boolean], "view">;
     getFunction(nameOrSignature: "termManager"): TypedContractMethod<[], [string], "view">;
+    getFunction(nameOrSignature: "updateBalance"): TypedContractMethod<[
+        positionId: BytesLike,
+        collateralValue: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        signature: BytesLike
+    ], [
+        void
+    ], "nonpayable">;
     getFunction(nameOrSignature: "updateDebtFromLoanOps"): TypedContractMethod<[
         positionId: BytesLike,
         newDebt: BigNumberish,
@@ -1670,12 +1740,6 @@ interface PositionManager extends BaseContract {
     ], [
         void
     ], "nonpayable">;
-    getFunction(nameOrSignature: "updatePosition"): TypedContractMethod<[
-        positionId: BytesLike,
-        newDebt: BigNumberish
-    ], [
-        boolean
-    ], "nonpayable">;
     getFunction(nameOrSignature: "updatePositionStatusFromLoanOps"): TypedContractMethod<[
         positionId: BytesLike,
         newStatus: BigNumberish
@@ -1688,8 +1752,13 @@ interface PositionManager extends BaseContract {
     ], [
         void
     ], "payable">;
-    getFunction(nameOrSignature: "validatePKPLogic"): TypedContractMethod<[pkpId: BytesLike], [boolean], "view">;
-    getFunction(nameOrSignature: "validateUpgrade"): TypedContractMethod<[newImplementation: AddressLike], [boolean], "view">;
+    getFunction(nameOrSignature: "verifyAuthorization"): TypedContractMethod<[
+        selector: BytesLike,
+        messageHash: BytesLike,
+        signature: BytesLike
+    ], [
+        boolean
+    ], "view">;
     getFunction(nameOrSignature: "views"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "withdrawBTC"): TypedContractMethod<[
         params: ICollateralManager.WithdrawalParamsStruct,
@@ -1697,10 +1766,9 @@ interface PositionManager extends BaseContract {
     ], [
         boolean
     ], "nonpayable">;
-    getEvent(key: "CollateralRatioUpdated"): TypedContractEvent<CollateralRatioUpdatedEvent.InputTuple, CollateralRatioUpdatedEvent.OutputTuple, CollateralRatioUpdatedEvent.OutputObject>;
+    getEvent(key: "BalanceConfirmed"): TypedContractEvent<BalanceConfirmedEvent.InputTuple, BalanceConfirmedEvent.OutputTuple, BalanceConfirmedEvent.OutputObject>;
     getEvent(key: "ExtensionPendingCleared"): TypedContractEvent<ExtensionPendingClearedEvent.InputTuple, ExtensionPendingClearedEvent.OutputTuple, ExtensionPendingClearedEvent.OutputObject>;
     getEvent(key: "Initialized"): TypedContractEvent<InitializedEvent$1.InputTuple, InitializedEvent$1.OutputTuple, InitializedEvent$1.OutputObject>;
-    getEvent(key: "IntegrityCheckFailed"): TypedContractEvent<IntegrityCheckFailedEvent.InputTuple, IntegrityCheckFailedEvent.OutputTuple, IntegrityCheckFailedEvent.OutputObject>;
     getEvent(key: "ModulesUpdatedBatch"): TypedContractEvent<ModulesUpdatedBatchEvent.InputTuple, ModulesUpdatedBatchEvent.OutputTuple, ModulesUpdatedBatchEvent.OutputObject>;
     getEvent(key: "PKPLogicValidated"): TypedContractEvent<PKPLogicValidatedEvent.InputTuple, PKPLogicValidatedEvent.OutputTuple, PKPLogicValidatedEvent.OutputObject>;
     getEvent(key: "PKPValidationRegistryUpdated"): TypedContractEvent<PKPValidationRegistryUpdatedEvent.InputTuple, PKPValidationRegistryUpdatedEvent.OutputTuple, PKPValidationRegistryUpdatedEvent.OutputObject>;
@@ -1720,21 +1788,19 @@ interface PositionManager extends BaseContract {
     getEvent(key: "Unpaused"): TypedContractEvent<UnpausedEvent$1.InputTuple, UnpausedEvent$1.OutputTuple, UnpausedEvent$1.OutputObject>;
     getEvent(key: "Upgraded"): TypedContractEvent<UpgradedEvent$1.InputTuple, UpgradedEvent$1.OutputTuple, UpgradedEvent$1.OutputObject>;
     filters: {
-        "CollateralRatioUpdated(bytes32,uint256,uint256)": TypedContractEvent<CollateralRatioUpdatedEvent.InputTuple, CollateralRatioUpdatedEvent.OutputTuple, CollateralRatioUpdatedEvent.OutputObject>;
-        CollateralRatioUpdated: TypedContractEvent<CollateralRatioUpdatedEvent.InputTuple, CollateralRatioUpdatedEvent.OutputTuple, CollateralRatioUpdatedEvent.OutputObject>;
+        "BalanceConfirmed(bytes32,uint256,uint256,uint256)": TypedContractEvent<BalanceConfirmedEvent.InputTuple, BalanceConfirmedEvent.OutputTuple, BalanceConfirmedEvent.OutputObject>;
+        BalanceConfirmed: TypedContractEvent<BalanceConfirmedEvent.InputTuple, BalanceConfirmedEvent.OutputTuple, BalanceConfirmedEvent.OutputObject>;
         "ExtensionPendingCleared(bytes32,address)": TypedContractEvent<ExtensionPendingClearedEvent.InputTuple, ExtensionPendingClearedEvent.OutputTuple, ExtensionPendingClearedEvent.OutputObject>;
         ExtensionPendingCleared: TypedContractEvent<ExtensionPendingClearedEvent.InputTuple, ExtensionPendingClearedEvent.OutputTuple, ExtensionPendingClearedEvent.OutputObject>;
         "Initialized(uint64)": TypedContractEvent<InitializedEvent$1.InputTuple, InitializedEvent$1.OutputTuple, InitializedEvent$1.OutputObject>;
         Initialized: TypedContractEvent<InitializedEvent$1.InputTuple, InitializedEvent$1.OutputTuple, InitializedEvent$1.OutputObject>;
-        "IntegrityCheckFailed(bytes32,string,string,uint256)": TypedContractEvent<IntegrityCheckFailedEvent.InputTuple, IntegrityCheckFailedEvent.OutputTuple, IntegrityCheckFailedEvent.OutputObject>;
-        IntegrityCheckFailed: TypedContractEvent<IntegrityCheckFailedEvent.InputTuple, IntegrityCheckFailedEvent.OutputTuple, IntegrityCheckFailedEvent.OutputObject>;
         "ModulesUpdatedBatch(address,uint256)": TypedContractEvent<ModulesUpdatedBatchEvent.InputTuple, ModulesUpdatedBatchEvent.OutputTuple, ModulesUpdatedBatchEvent.OutputObject>;
         ModulesUpdatedBatch: TypedContractEvent<ModulesUpdatedBatchEvent.InputTuple, ModulesUpdatedBatchEvent.OutputTuple, ModulesUpdatedBatchEvent.OutputObject>;
         "PKPLogicValidated(bytes32,bool)": TypedContractEvent<PKPLogicValidatedEvent.InputTuple, PKPLogicValidatedEvent.OutputTuple, PKPLogicValidatedEvent.OutputObject>;
         PKPLogicValidated: TypedContractEvent<PKPLogicValidatedEvent.InputTuple, PKPLogicValidatedEvent.OutputTuple, PKPLogicValidatedEvent.OutputObject>;
         "PKPValidationRegistryUpdated(address,address,address)": TypedContractEvent<PKPValidationRegistryUpdatedEvent.InputTuple, PKPValidationRegistryUpdatedEvent.OutputTuple, PKPValidationRegistryUpdatedEvent.OutputObject>;
         PKPValidationRegistryUpdated: TypedContractEvent<PKPValidationRegistryUpdatedEvent.InputTuple, PKPValidationRegistryUpdatedEvent.OutputTuple, PKPValidationRegistryUpdatedEvent.OutputObject>;
-        "PartialPaymentMade(bytes32,address,uint256,uint256,uint256)": TypedContractEvent<PartialPaymentMadeEvent.InputTuple, PartialPaymentMadeEvent.OutputTuple, PartialPaymentMadeEvent.OutputObject>;
+        "PartialPaymentMade(bytes32,address,uint256,uint256)": TypedContractEvent<PartialPaymentMadeEvent.InputTuple, PartialPaymentMadeEvent.OutputTuple, PartialPaymentMadeEvent.OutputObject>;
         PartialPaymentMade: TypedContractEvent<PartialPaymentMadeEvent.InputTuple, PartialPaymentMadeEvent.OutputTuple, PartialPaymentMadeEvent.OutputObject>;
         "Paused(address)": TypedContractEvent<PausedEvent$1.InputTuple, PausedEvent$1.OutputTuple, PausedEvent$1.OutputObject>;
         Paused: TypedContractEvent<PausedEvent$1.InputTuple, PausedEvent$1.OutputTuple, PausedEvent$1.OutputObject>;
@@ -2134,11 +2200,11 @@ interface ICommunityManager extends BaseContract {
 interface ILiquidationManagerInterface extends Interface {
     getFunction(nameOrSignature: "calculateLiquidationBonus" | "commitLiquidation" | "isLiquidatable" | "liquidatePosition" | "revealAndLiquidate" | "supportsInterface"): FunctionFragment;
     getEvent(nameOrSignatureOrTopic: "PositionLiquidated"): EventFragment;
-    encodeFunctionData(functionFragment: "calculateLiquidationBonus", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "commitLiquidation", values: [BytesLike, BytesLike]): string;
-    encodeFunctionData(functionFragment: "isLiquidatable", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "liquidatePosition", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "revealAndLiquidate", values: [BytesLike, BigNumberish, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "calculateLiquidationBonus", values: [BytesLike, BigNumberish, BigNumberish, BigNumberish, BytesLike]): string;
+    encodeFunctionData(functionFragment: "commitLiquidation", values: [BytesLike, BigNumberish, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "isLiquidatable", values: [BytesLike, BigNumberish, BigNumberish, BytesLike]): string;
+    encodeFunctionData(functionFragment: "liquidatePosition", values: [BytesLike, BigNumberish, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "revealAndLiquidate", values: [BytesLike, BigNumberish, BigNumberish, BytesLike, BigNumberish]): string;
     encodeFunctionData(functionFragment: "supportsInterface", values: [BytesLike]): string;
     decodeFunctionResult(functionFragment: "calculateLiquidationBonus", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "commitLiquidation", data: BytesLike): Result$2;
@@ -2188,29 +2254,41 @@ interface ILiquidationManager extends BaseContract {
     listeners(eventName?: string): Promise<Array<Listener>>;
     removeAllListeners<TCEvent extends TypedContractEvent>(event?: TCEvent): Promise<this>;
     calculateLiquidationBonus: TypedContractMethod<[
-        positionId: BytesLike
+        positionId: BytesLike,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        btcAmountSats: BigNumberish,
+        liquidationValidatorSignature: BytesLike
     ], [
         bigint
-    ], "view">;
+    ], "nonpayable">;
     commitLiquidation: TypedContractMethod<[
         positionId: BytesLike,
-        commitHash: BytesLike
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish
     ], [
         void
     ], "nonpayable">;
     isLiquidatable: TypedContractMethod<[
-        positionId: BytesLike
+        positionId: BytesLike,
+        btcPrice: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        liquidationValidatorSignature: BytesLike
     ], [
         boolean
-    ], "view">;
+    ], "nonpayable">;
     liquidatePosition: TypedContractMethod<[
-        positionId: BytesLike
+        positionId: BytesLike,
+        btcPrice: BigNumberish,
+        quantumTimestamp: BigNumberish
     ], [
         boolean
     ], "nonpayable">;
     revealAndLiquidate: TypedContractMethod<[
         positionId: BytesLike,
-        nonce: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        liquidationValidatorSignature: BytesLike,
         deadline: BigNumberish
     ], [
         boolean
@@ -2221,18 +2299,42 @@ interface ILiquidationManager extends BaseContract {
         boolean
     ], "view">;
     getFunction<T extends ContractMethod = ContractMethod>(key: string | FunctionFragment): T;
-    getFunction(nameOrSignature: "calculateLiquidationBonus"): TypedContractMethod<[positionId: BytesLike], [bigint], "view">;
+    getFunction(nameOrSignature: "calculateLiquidationBonus"): TypedContractMethod<[
+        positionId: BytesLike,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        btcAmountSats: BigNumberish,
+        liquidationValidatorSignature: BytesLike
+    ], [
+        bigint
+    ], "nonpayable">;
     getFunction(nameOrSignature: "commitLiquidation"): TypedContractMethod<[
         positionId: BytesLike,
-        commitHash: BytesLike
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish
     ], [
         void
     ], "nonpayable">;
-    getFunction(nameOrSignature: "isLiquidatable"): TypedContractMethod<[positionId: BytesLike], [boolean], "view">;
-    getFunction(nameOrSignature: "liquidatePosition"): TypedContractMethod<[positionId: BytesLike], [boolean], "nonpayable">;
+    getFunction(nameOrSignature: "isLiquidatable"): TypedContractMethod<[
+        positionId: BytesLike,
+        btcPrice: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        liquidationValidatorSignature: BytesLike
+    ], [
+        boolean
+    ], "nonpayable">;
+    getFunction(nameOrSignature: "liquidatePosition"): TypedContractMethod<[
+        positionId: BytesLike,
+        btcPrice: BigNumberish,
+        quantumTimestamp: BigNumberish
+    ], [
+        boolean
+    ], "nonpayable">;
     getFunction(nameOrSignature: "revealAndLiquidate"): TypedContractMethod<[
         positionId: BytesLike,
-        nonce: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        liquidationValidatorSignature: BytesLike,
         deadline: BigNumberish
     ], [
         boolean
@@ -2246,7 +2348,7 @@ interface ILiquidationManager extends BaseContract {
 }
 
 interface ILoanOperationsManagerInterface extends Interface {
-    getFunction(nameOrSignature: "authorizeBTCSpend" | "calculateCollateralRatio" | "getCurrentBTCPrice" | "getOriginationFeeBalance" | "getPKPActualCollateral" | "getUcdController" | "isPriceFeedStale" | "liquidationThreshold" | "maximumLtvRatio" | "minimumLoanValueWei" | "mintUCD" | "processPartialPayment" | "repayPosition" | "supportsInterface" | "transferOriginationFee" | "ucdToken" | "updatePosition"): FunctionFragment;
+    getFunction(nameOrSignature: "authorizeBTCSpend" | "calculateCollateralRatio" | "getOriginationFeeBalance" | "getPKPActualCollateral" | "getTotalAuthorizedSats" | "getUcdController" | "isPriceFeedStale" | "liquidationThreshold" | "maximumLtvRatio" | "minimumLoanValueWei" | "mintUCD" | "processPayment" | "supportsInterface" | "transferOriginationFee" | "ucdToken" | "updatePosition"): FunctionFragment;
     getEvent(nameOrSignatureOrTopic: "PositionRepaid" | "PositionUpdated" | "UCDMinted"): EventFragment;
     encodeFunctionData(functionFragment: "authorizeBTCSpend", values: [
         BytesLike,
@@ -2257,10 +2359,10 @@ interface ILoanOperationsManagerInterface extends Interface {
         BigNumberish,
         BytesLike
     ]): string;
-    encodeFunctionData(functionFragment: "calculateCollateralRatio", values: [BytesLike]): string;
-    encodeFunctionData(functionFragment: "getCurrentBTCPrice", values?: undefined): string;
+    encodeFunctionData(functionFragment: "calculateCollateralRatio", values: [BytesLike, BigNumberish]): string;
     encodeFunctionData(functionFragment: "getOriginationFeeBalance", values?: undefined): string;
     encodeFunctionData(functionFragment: "getPKPActualCollateral", values: [BytesLike]): string;
+    encodeFunctionData(functionFragment: "getTotalAuthorizedSats", values: [BytesLike]): string;
     encodeFunctionData(functionFragment: "getUcdController", values?: undefined): string;
     encodeFunctionData(functionFragment: "isPriceFeedStale", values?: undefined): string;
     encodeFunctionData(functionFragment: "liquidationThreshold", values?: undefined): string;
@@ -2274,28 +2376,26 @@ interface ILoanOperationsManagerInterface extends Interface {
         BigNumberish,
         BigNumberish,
         BytesLike,
-        BigNumberish,
-        BytesLike
+        BytesLike,
+        BigNumberish
     ]): string;
-    encodeFunctionData(functionFragment: "processPartialPayment", values: [BytesLike, BigNumberish]): string;
-    encodeFunctionData(functionFragment: "repayPosition", values: [BytesLike, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "processPayment", values: [BytesLike, BigNumberish, BigNumberish, BigNumberish]): string;
     encodeFunctionData(functionFragment: "supportsInterface", values: [BytesLike]): string;
     encodeFunctionData(functionFragment: "transferOriginationFee", values: [AddressLike, BigNumberish]): string;
     encodeFunctionData(functionFragment: "ucdToken", values?: undefined): string;
-    encodeFunctionData(functionFragment: "updatePosition", values: [BytesLike, BigNumberish]): string;
+    encodeFunctionData(functionFragment: "updatePosition", values: [BytesLike, BigNumberish, BigNumberish, BigNumberish, BytesLike]): string;
     decodeFunctionResult(functionFragment: "authorizeBTCSpend", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "calculateCollateralRatio", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "getCurrentBTCPrice", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "getOriginationFeeBalance", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "getPKPActualCollateral", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "getTotalAuthorizedSats", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "getUcdController", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "isPriceFeedStale", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "liquidationThreshold", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "maximumLtvRatio", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "minimumLoanValueWei", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "mintUCD", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "processPartialPayment", data: BytesLike): Result$2;
-    decodeFunctionResult(functionFragment: "repayPosition", data: BytesLike): Result$2;
+    decodeFunctionResult(functionFragment: "processPayment", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "supportsInterface", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "transferOriginationFee", data: BytesLike): Result$2;
     decodeFunctionResult(functionFragment: "ucdToken", data: BytesLike): Result$2;
@@ -2389,17 +2489,22 @@ interface ILoanOperationsManager extends BaseContract {
         bigint
     ], "nonpayable">;
     calculateCollateralRatio: TypedContractMethod<[
-        positionId: BytesLike
+        positionId: BytesLike,
+        btcPrice: BigNumberish
     ], [
         bigint
     ], "view">;
-    getCurrentBTCPrice: TypedContractMethod<[], [bigint], "view">;
     getOriginationFeeBalance: TypedContractMethod<[], [bigint], "view">;
     getPKPActualCollateral: TypedContractMethod<[
         pkpId: BytesLike
     ], [
         bigint
     ], "view">;
+    getTotalAuthorizedSats: TypedContractMethod<[
+        positionId: BytesLike
+    ], [
+        bigint
+    ], "view">;
     getUcdController: TypedContractMethod<[], [string], "view">;
     isPriceFeedStale: TypedContractMethod<[], [boolean], "view">;
     liquidationThreshold: TypedContractMethod<[], [bigint], "view">;
@@ -2413,20 +2518,16 @@ interface ILoanOperationsManager extends BaseContract {
         newCollateral: BigNumberish,
         btcPrice: BigNumberish,
         authorizedSpendsHash: BytesLike,
-        quantumTimestamp: BigNumberish,
-        mintValidatorSignature: BytesLike
+        ucdDebtHash: BytesLike,
+        quantumTimestamp: BigNumberish
     ], [
         boolean
     ], "nonpayable">;
-    processPartialPayment: TypedContractMethod<[
+    processPayment: TypedContractMethod<[
         positionId: BytesLike,
-        paymentAmount: BigNumberish
-    ], [
-        boolean
-    ], "nonpayable">;
-    repayPosition: TypedContractMethod<[
-        positionId: BytesLike,
-        repaymentAmount: BigNumberish
+        paymentAmount: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish
     ], [
         boolean
     ], "nonpayable">;
@@ -2444,7 +2545,10 @@ interface ILoanOperationsManager extends BaseContract {
     ucdToken: TypedContractMethod<[], [string], "view">;
     updatePosition: TypedContractMethod<[
         positionId: BytesLike,
-        newDebt: BigNumberish
+        newDebt: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        updateValidatorSignature: BytesLike
     ], [
         boolean
     ], "nonpayable">;
@@ -2460,10 +2564,15 @@ interface ILoanOperationsManager extends BaseContract {
     ], [
         bigint
     ], "nonpayable">;
-    getFunction(nameOrSignature: "calculateCollateralRatio"): TypedContractMethod<[positionId: BytesLike], [bigint], "view">;
-    getFunction(nameOrSignature: "getCurrentBTCPrice"): TypedContractMethod<[], [bigint], "view">;
+    getFunction(nameOrSignature: "calculateCollateralRatio"): TypedContractMethod<[
+        positionId: BytesLike,
+        btcPrice: BigNumberish
+    ], [
+        bigint
+    ], "view">;
     getFunction(nameOrSignature: "getOriginationFeeBalance"): TypedContractMethod<[], [bigint], "view">;
     getFunction(nameOrSignature: "getPKPActualCollateral"): TypedContractMethod<[pkpId: BytesLike], [bigint], "view">;
+    getFunction(nameOrSignature: "getTotalAuthorizedSats"): TypedContractMethod<[positionId: BytesLike], [bigint], "view">;
     getFunction(nameOrSignature: "getUcdController"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "isPriceFeedStale"): TypedContractMethod<[], [boolean], "view">;
     getFunction(nameOrSignature: "liquidationThreshold"): TypedContractMethod<[], [bigint], "view">;
@@ -2477,20 +2586,16 @@ interface ILoanOperationsManager extends BaseContract {
         newCollateral: BigNumberish,
         btcPrice: BigNumberish,
         authorizedSpendsHash: BytesLike,
-        quantumTimestamp: BigNumberish,
-        mintValidatorSignature: BytesLike
+        ucdDebtHash: BytesLike,
+        quantumTimestamp: BigNumberish
     ], [
         boolean
     ], "nonpayable">;
-    getFunction(nameOrSignature: "processPartialPayment"): TypedContractMethod<[
+    getFunction(nameOrSignature: "processPayment"): TypedContractMethod<[
         positionId: BytesLike,
-        paymentAmount: BigNumberish
-    ], [
-        boolean
-    ], "nonpayable">;
-    getFunction(nameOrSignature: "repayPosition"): TypedContractMethod<[
-        positionId: BytesLike,
-        repaymentAmount: BigNumberish
+        paymentAmount: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish
     ], [
         boolean
     ], "nonpayable">;
@@ -2504,7 +2609,10 @@ interface ILoanOperationsManager extends BaseContract {
     getFunction(nameOrSignature: "ucdToken"): TypedContractMethod<[], [string], "view">;
     getFunction(nameOrSignature: "updatePosition"): TypedContractMethod<[
         positionId: BytesLike,
-        newDebt: BigNumberish
+        newDebt: BigNumberish,
+        quantumTimestamp: BigNumberish,
+        btcPrice: BigNumberish,
+        updateValidatorSignature: BytesLike
     ], [
         boolean
     ], "nonpayable">;
@@ -4240,6 +4348,7 @@ interface UCDMintRequest {
     skipValidation?: boolean;
     customRpcUrl?: string;
     customBitcoinRpcUrl?: string;
+    testBtcPrice?: number;
 }
 /**
  * UCD Mint Result Interface
@@ -4288,6 +4397,8 @@ interface LiquidationRequest {
 interface PartialPaymentRequest {
     positionId: string;
     paymentAmount: number;
+    customRpcUrl?: string;
+    customBitcoinRpcUrl?: string;
 }
 /**
  * Partial Payment Result Interface
@@ -4413,9 +4524,9 @@ interface BitcoinOperationsConfig {
     providers: BitcoinProviderConfig[];
     /** Consensus mode: single or majority */
     consensusMode?: "single" | "majority";
-    /** Cache for balance results */
+    /** Cache for balance results (keyed by address) */
     balanceCache?: Cache<BitcoinBalanceResult>;
-    /** Cache for address derivations */
+    /** Cache for address derivations (keyed by PKP public key) */
     addressCache?: Cache<BitcoinAddresses>;
     /** LitOps instance for price oracle queries (optional) */
     litOps?: any;
@@ -4983,16 +5094,22 @@ declare class DiamondHandsSDK {
     /**
      * Extend position term
      *
-     * @param positionId - Position identifier
-     * @param selectedTerm - Extension term in months
+     * Follows main's security pattern: authorization → LIT validation → contract execution
+     *
+     * @param _positionId - Position identifier
+     * @param _selectedTerm - Extension term in months
      * @returns Transaction receipt
      */
+    extendPosition(_positionId: string, _selectedTerm: number): Promise<ethers.providers.TransactionReceipt>;
     /**
-     * Make a partial payment on a loan
+     * Make a payment on a loan position
+     *
+     * Follows main's security pattern: authorization → LIT validation → contract execution
      *
-     * @param request - Partial payment request with position ID and amount
-     * @returns Partial payment result with transaction details
+     * @param request - Payment request with position ID and amount
+     * @returns Payment result with transaction details
      */
+    makePayment(request: PartialPaymentRequest): Promise<PartialPaymentResult>;
     /**
      * Withdraw Bitcoin from a position
      *
@@ -5245,6 +5362,15 @@ declare class DiamondHandsSDK {
      * Get Bitcoin network based on chain
      */
     private getBitcoinNetwork;
+    /**
+     * Extract error message from LIT Action response
+     * Checks both `error` and `reason` fields and parses nested error structures
+     *
+     * @private
+     * @remarks Production-ready error parser for LIT Protocol responses
+     *          Will be integrated into core methods in Round 2
+     */
+    private extractLitActionError;
     /**
      * Get provider or throw error
      */
@@ -5707,8 +5833,6 @@ interface LoanCreatorConfig {
     litOpsSigner?: Wallet;
     /** SDK mode: 'service' or 'standalone' */
     mode?: "service" | "standalone";
-    /** Service endpoint for backend operations (service mode only) */
-    serviceEndpoint?: string;
     /** LIT Action CID for loan creation */
     litActionCid: string;
     /** User ID (typically wallet address) */
@@ -5717,8 +5841,10 @@ interface LoanCreatorConfig {
     debug?: boolean;
     /** Transaction timeout (ms) */
     transactionTimeoutMs?: number;
-    /** PKP validator version to use for signature verification */
-    validatorVersion?: number;
+    /** Validator version for loan creation (createPosition) - REQUIRED */
+    loanCreationValidatorVersion: number;
+    /** Security testing: Temper signatures to test contract validation */
+    temperSignaturesTest?: boolean;
 }
 /**
  * Loan creation audit trail
@@ -5758,6 +5884,7 @@ interface LoanCreationAudit {
 declare class LoanCreator {
     private readonly config;
     private readonly transactionTimeoutMs;
+    private pkpValidationRegistryAddressCache;
     constructor(config: LoanCreatorConfig);
     /**
      * Create a new loan
@@ -5969,47 +6096,279 @@ interface MonitoringOptions {
 }
 
 /**
- * LIT Action Types and Interfaces
+ * Branded identifier types for PKP and Position IDs.
+ *
+ * These provide lightweight nominal typing so that internal helpers can
+ * distinguish between generic strings and protocol identifiers, while
+ * still being freely assignable to `string` where needed.
+ */
+declare const __idBrand: unique symbol;
+/**
+ * Position identifier (on-chain bytes32, represented as hex string in SDK).
+ */
+type PositionId = string & {
+    readonly [__idBrand]: "PositionId";
+};
+declare const PositionId: (value: string) => PositionId;
+
+/**
+ * Typed responses for critical Diamond Hands LIT Actions.
+ *
+ * These mirror the JSON payloads passed to `Lit.Actions.setResponse(...)`
+ * in the lit-actions package and are intended to be used as the `TData`
+ * parameter on `LitActionResult<TData>`.
+ */
+
+/**
+ * Base shape for approval-style validator responses.
+ */
+interface BaseValidatorResponse {
+    approved: boolean;
+    positionId?: PositionId | string;
+    reason?: string;
+    failedStep?: string;
+    timestamp: number | string;
+    /**
+     * Optional low-level execution error from lit-ops / LIT runtime.
+     */
+    error?: string;
+    /**
+     * Some flows attach the raw signature JSON here (service wrappers).
+     */
+    signature?: string;
+}
+/**
+ * UCD Mint Validator response (ucdMintValidator).
+ * Source: lit-actions/src/ucd-mint-validator.ts
+ */
+interface UcdMintValidatorResponse extends BaseValidatorResponse {
+    approved: true;
+    mintAmount: string;
+    mintFee: string;
+    newDebt: string;
+    newCollateral: string;
+    newCollateralRatioBps: number;
+    btcPrice: string;
+    authorizedSpendsHash: string;
+    ucdDebtHash: string;
+    contractBundleHash: string;
+    signature: string;
+    validatorPkp: string;
+    /**
+     * Optional: Exact parameter values used for signing.
+     * If present, SDK should use these values instead of response values
+     * to ensure contract receives identical parameters that were signed.
+     */
+    signingParams?: {
+        positionId: string;
+        actionHash: string;
+        authorizedSpendsHash: string;
+        ucdDebtHash: string;
+        contractBundleHash: string;
+        btcPrice: string;
+        mintAmount: string;
+        mintFee: string;
+        newCollateral: string;
+        newDebt: string;
+        timestamp: string;
+    };
+}
+interface UcdMintValidatorErrorResponse extends BaseValidatorResponse {
+    approved: false;
+}
+type UcdMintValidatorResult = UcdMintValidatorResponse | UcdMintValidatorErrorResponse;
+/**
+ * BTC Withdrawal Validator response (btcWithdrawal).
+ * Source: lit-actions/src/btc-withdrawal.ts
+ */
+interface BtcWithdrawalValidatorResponse extends BaseValidatorResponse {
+    approved: true;
+    actionHash: string;
+    authorizedSpendsHash: string;
+    ucdDebtHash: string;
+    totalDeduction: string;
+    remainingCollateral: string;
+    newCollateralRatioBps?: number;
+    destinationAddress: string;
+    signature: string;
+    btcPrice: string;
+    /**
+     * Optional UTXO fields used by enhanced BTC withdrawal flow.
+     * These are populated by the LIT Action when BIP-143 validation is enabled.
+     */
+    utxoTxid?: string;
+    utxoVout?: number;
+}
+interface BtcWithdrawalValidatorErrorResponse extends BaseValidatorResponse {
+    approved: false;
+}
+type BtcWithdrawalValidatorResult = BtcWithdrawalValidatorResponse | BtcWithdrawalValidatorErrorResponse;
+/**
+ * Liquidation Validator response (liquidationValidator).
+ * Source: lit-actions/src/liquidation-validator.ts
+ */
+interface LiquidationValidatorResponse extends BaseValidatorResponse {
+    approved: true;
+    btcPrice: string;
+    btcAmountSats: string;
+    signature: string;
+    signatureBonus: string;
+    validatorPkp: string;
+}
+interface LiquidationValidatorErrorResponse extends BaseValidatorResponse {
+    approved: false;
+}
+type LiquidationValidatorResult = LiquidationValidatorResponse | LiquidationValidatorErrorResponse;
+/**
+ * Extend Position Validator response (extendPositionValidator).
+ * Source: lit-actions/src/extend-position-validator.ts
  */
-interface ILitAction {
+interface ExtendPositionValidatorResponse extends BaseValidatorResponse {
+    approved: true;
+    selectedTerm: number;
+    btcPrice: string;
+    availableBTCBalance: string;
+    extensionFee: string;
+    newTotalDebt: string;
+    newCollateralRatioBps: string;
+    signature: string;
+    timestamp: number;
+    quantumTimestamp: number;
+    validatorPkp: string;
+}
+interface ExtendPositionValidatorErrorResponse extends BaseValidatorResponse {
+    approved: false;
+}
+type ExtendPositionValidatorResult = ExtendPositionValidatorResponse | ExtendPositionValidatorErrorResponse;
+/**
+ * Process Payment Validator response (processPaymentValidator).
+ * Source: lit-actions/src/process-payment-validator.ts
+ */
+interface ProcessPaymentValidatorResponse extends BaseValidatorResponse {
+    approved: true;
+    paymentAmount: string;
+    btcPrice: string;
+    btcAmountSats: string;
+    signature: string;
+    timestamp: number;
+    validatorPkp: string;
+}
+interface ProcessPaymentValidatorErrorResponse extends BaseValidatorResponse {
+    approved: false;
+}
+type ProcessPaymentValidatorResult = ProcessPaymentValidatorResponse | ProcessPaymentValidatorErrorResponse;
+/**
+ * Loan vault BTC balance / deposit validator response (loanVaultBtcBalance).
+ * Source: lit-actions/src/loan-vault-btc-balance.ts
+ */
+interface LoanVaultBtcBalanceValidatorResponse {
+    vaultAddress: string;
+    vaultBalance: string;
+    positionId: PositionId | string;
+    btcPrice: string;
+    signature: string;
+    timestamp: number;
+    validatorPkp: string;
+}
+interface LoanVaultBtcBalanceValidatorErrorResponse {
+    error: string;
+    positionId: PositionId | string | null;
+    timestamp: number;
+}
+type LoanVaultBtcBalanceValidatorResult = LoanVaultBtcBalanceValidatorResponse | LoanVaultBtcBalanceValidatorErrorResponse;
+
+/**
+ * LIT Action Types and Interfaces (SDK boundary)
+ *
+ * This file provides the strongly-typed SDK view of LIT Actions and
+ * re-exports the action registry interfaces from the @gvnrdao/dh-lit-actions
+ * package so that action names and configs stay in sync across packages.
+ */
+
+/**
+ * Core LIT Action execution description.
+ *
+ * TParams describes the jsParams structure, TAuth describes the authSig shape.
+ * Both default to safe, unknown-based records instead of `any`.
+ */
+interface ILitAction<TParams extends Record<string, unknown> = Record<string, unknown>, TAuth = LitActionAuth> {
     code: string;
     ipfsId?: string;
-    jsParams: Record<string, any>;
-    authSig: any;
+    jsParams: TParams;
+    authSig: TAuth;
 }
-interface LitActionParams {
+/**
+ * Parameters passed to lit-node-client.executeJs.
+ *
+ * This mirrors ILitAction but is named for historic reasons.
+ */
+interface LitActionParams<TParams extends Record<string, unknown> = Record<string, unknown>, TAuth = LitActionAuth> {
     code: string;
-    jsParams: Record<string, any>;
-    authSig: any;
+    jsParams: TParams;
+    authSig: TAuth;
     debug?: boolean;
     pkpId?: string;
     userAddress?: string;
+    /**
+     * Collateral amount used by some actions (e.g. mint flows).
+     * Replaces legacy btcAmount naming.
+     */
     collateralAmount?: string;
 }
-interface LitActionResult {
+/**
+ * Raw result returned from LIT Action execution.
+ *
+ * Callers are encouraged to wrap this in action-specific result
+ * types instead of accessing the generic `data` bag directly.
+ */
+interface LitActionResult<TData = unknown> {
     success: boolean;
-    signedData?: any;
-    decryptedData?: any;
+    signedData?: unknown;
+    decryptedData?: unknown;
     claimedKeyId?: string;
-    signatures?: any;
+    signatures?: unknown;
+    /**
+     * Alias for signatures used by some helpers.
+     */
     signature?: string;
-    decryptions?: any;
-    claims?: any;
+    decryptions?: unknown;
+    claims?: unknown;
     response?: string;
     logs?: string;
-    data?: any;
+    /**
+     * Action-specific payload. Prefer narrowing this via generics.
+     */
+    data?: TData;
+    /**
+     * Human-readable error (if any).
+     */
     error?: string;
 }
+/**
+ * Discriminated union of typed results for the core Diamond Hands actions.
+ *
+ * This can be used by higher-level SDK helpers to express that a given
+ * execution is expected to return a particular validator payload.
+ */
+type DiamondHandsLitActionResult = LitActionResult<UcdMintValidatorResult> | LitActionResult<BtcWithdrawalValidatorResult> | LitActionResult<LiquidationValidatorResult> | LitActionResult<ExtendPositionValidatorResult> | LitActionResult<ProcessPaymentValidatorResult> | LitActionResult<LoanVaultBtcBalanceValidatorResult>;
+/**
+ * Standard EIP-191 style authorization signature used by LIT.
+ */
 interface LitActionAuth {
     sig: string;
     derivedVia: string;
     signedMessage: string;
     address: string;
 }
-interface LitActionValidationResult {
+/**
+ * Generic validation result used by some helper actions.
+ *
+ * Callers should prefer action-specific result types where available.
+ */
+interface LitActionValidationResult<TDetails = unknown> {
     valid: boolean;
     error?: string;
-    details?: any;
+    details?: TDetails;
 }
 
 /**
@@ -6460,7 +6819,7 @@ interface LoanQueryConfig {
     bitcoinOperations: BitcoinOperations;
     /** Ethereum provider for PKP public key retrieval */
     provider?: providers.Provider;
-    /** Cache for loan query results */
+    /** Cache for loan query results (keyed by PKP ID) */
     cache?: Cache<LoanData>;
     /** Enable debug logging */
     debug?: boolean;
@@ -6666,7 +7025,6 @@ interface NetworkConfig {
         liquidationManager?: string;
         ucdToken: string;
         ucdController?: string;
-        btcProofValidator: string;
         priceFeedConsumer: string;
         operationAuthorizationRegistry?: string;
         mockUsdcToken?: string;
@@ -6678,6 +7036,7 @@ interface NetworkConfig {
         tokenGvnrUrl?: string;
     };
     litNetwork: string;
+    validatorVersion?: number;
     debug: boolean;
 }
 /**
@@ -6749,7 +7108,7 @@ declare function validateSDKEnvironment(requirements: {
 /**
  * Smart Contract ABIs
  */
-declare const POSITION_MANAGER_ABI: readonly ["function createPosition(bytes32 pkpId, bytes calldata validatorSignature, address borrower, string calldata vaultAddress, uint256 selectedTermMonths) external returns (bool)", "function deletePosition(bytes32 positionId) external", "function getPositionDetails(bytes32 positionId) external view returns (tuple(bytes32 positionId, bytes32 pkpId, uint256 ucdDebt, string vaultAddress, address borrower, uint40 createdAt, uint40 lastUpdated, uint16 selectedTerm, uint40 expiryAt, uint8 status))", "function getUserPositions(address user) external view returns (bytes32[] memory)", "function calculateCollateralRatio(bytes32 positionId) external view returns (uint256)", "function hasRole(bytes32 role, address account) external view returns (bool)", "function ADMIN_ROLE() external view returns (bytes32)", "function paused() external view returns (bool)", "function mintUCD(bytes32 positionId, uint256 mintAmount, uint256 mintFee, uint256 newDebt, uint256 newCollateral, uint256 btcPrice, bytes32 authorizedSpendsHash, uint256 quantumTimestamp, bytes calldata mintValidatorSignature) external returns (bool)", "function repayPosition(bytes32 positionId, uint256 repaymentAmount) external returns (bool)", "function makePartialPayment(bytes32 positionId, uint256 paymentAmount) external returns (bool)", "function withdrawBTC(bytes32 positionId, string withdrawalAddress, uint256 networkFee) external returns (bool)", "function extendPosition(bytes32 positionId, uint256 selectedTerm) external returns (bool)", "function liquidatePosition(bytes32 positionId) external returns (bool)", "function commitLiquidation(bytes32 positionId, bytes32 commitHash) external", "function revealAndLiquidate(bytes32 positionId, uint256 nonce, uint256 deadline) external returns (bool)", "function getExpiredLoanLiquidationThreshold(bytes32 positionId) external view returns (uint256)", "function isExpiredLoanLiquidatable(bytes32 positionId, uint256 collateralValue, uint256 debtAmount) external view returns (bool)", "event PositionCreated(bytes32 indexed positionId, bytes32 indexed pkpId, address indexed borrower, uint256 requestedCollateralRatio, uint256 selectedTerm, uint256 expiryAt)", "event UCDMinted(bytes32 indexed positionId, uint256 amount, bytes proof)", "event PositionLiquidated(bytes32 indexed positionId, address indexed liquidator, uint256 collateralRatio, uint256 liquidationBonus)", "event CollateralRatioUpdated(bytes32 indexed positionId, uint256 oldRatio, uint256 newRatio)", "event PositionUpdated(bytes32 indexed positionId, uint256 oldDebt, uint256 newDebt)"];
+declare const POSITION_MANAGER_ABI: readonly ["function createPosition(bytes32 pkpId, bytes calldata validatorSignature, address borrower, string calldata vaultAddress, uint256 selectedTermMonths) external returns (bool)", "function deletePosition(bytes32 positionId) external", "function getPositionById(bytes32 positionId) external view returns (tuple(bytes32 positionId, bytes32 pkpId, uint256 ucdDebt, string vaultAddress, address borrower, uint40 createdAt, uint40 lastUpdated, uint16 selectedTerm, uint40 expiryAt, uint8 status))", "function getUserPositions(address user) external view returns (bytes32[] memory)", "function calculateCollateralRatio(bytes32 positionId) external view returns (uint256)", "function hasRole(bytes32 role, address account) external view returns (bool)", "function ADMIN_ROLE() external view returns (bytes32)", "function paused() external view returns (bool)", "function mintUCD(bytes32 positionId, uint256 mintAmount, uint256 mintFee, uint256 newDebt, uint256 newCollateral, uint256 btcPrice, bytes32 authorizedSpendsHash, bytes32 ucdDebtHash, bytes32 contractHash, uint256 quantumTimestamp, bytes calldata mintValidatorSignature) external returns (bool)", "function repayPosition(bytes32 positionId, uint256 repaymentAmount) external returns (bool)", "function makePayment(bytes32 positionId, uint256 paymentAmount, uint256 quantumTimestamp, uint256 btcPrice, bytes calldata paymentValidatorSignature) external returns (bool)", "function withdrawBTC(bytes32 positionId, string withdrawalAddress, uint256 networkFee) external returns (bool)", "function extendPosition(bytes32 positionId, uint256 selectedTerm) external returns (bool)", "function liquidatePosition(bytes32 positionId) external returns (bool)", "function commitLiquidation(bytes32 positionId, bytes32 commitHash) external", "function revealAndLiquidate(bytes32 positionId, uint256 nonce, uint256 deadline) external returns (bool)", "function getExpiredLoanLiquidationThreshold(bytes32 positionId) external view returns (uint256)", "function isExpiredLoanLiquidatable(bytes32 positionId, uint256 collateralValue, uint256 debtAmount) external view returns (bool)", "event PositionCreated(bytes32 indexed positionId, bytes32 indexed pkpId, address indexed borrower, uint256 requestedCollateralRatio, uint256 selectedTerm, uint256 expiryAt)", "event UCDMinted(bytes32 indexed positionId, uint256 amount, bytes proof)", "event PositionLiquidated(bytes32 indexed positionId, address indexed liquidator, uint256 collateralRatio, uint256 liquidationBonus)", "event CollateralRatioUpdated(bytes32 indexed positionId, uint256 oldRatio, uint256 newRatio)", "event PositionUpdated(bytes32 indexed positionId, uint256 oldDebt, uint256 newDebt)"];
 declare const UCD_TOKEN_ABI: readonly ["function balanceOf(address account) external view returns (uint256)", "function transfer(address to, uint256 amount) external returns (bool)", "function approve(address spender, uint256 amount) external returns (bool)", "function allowance(address owner, address spender) external view returns (uint256)", "function mint(address to, uint256 amount) external", "function burn(uint256 amount) external", "function burnFrom(address account, uint256 amount) external", "event Transfer(address indexed from, address indexed to, uint256 value)", "event Approval(address indexed owner, address indexed spender, uint256 value)"];
 declare const PRICE_FEED_CONSUMER_ABI: readonly ["function getCurrentPrice() external view returns (uint256)", "function isPriceStale() external view returns (bool)", "function updatePrice() external", "event PriceUpdated(uint256 indexed price, uint256 timestamp)"];
 declare const PSM_ABI: readonly ["function swap(address stablecoin, uint256 amountIn, uint256 minUcdOut) external returns (uint256 ucdAmount)", "function addSupportedStablecoin(address stablecoin, uint256 exchangeRate, uint256 entryFeeBps, uint256 exitFeeBps, uint8 decimals, uint256 minSwapAmount, uint256 minRedeemAmount) external", "function updateSupportedStablecoin(address stablecoin, uint256 exchangeRate, uint256 entryFeeBps, uint256 exitFeeBps, uint8 decimals, uint256 minSwapAmount, uint256 minRedeemAmount) external", "function removeSupportedStablecoin(address stablecoin) external", "function withdrawStablecoin(address stablecoin, uint256 amount) external", "function pause() external", "function unpause() external", "function redeem(address stablecoin, uint256 ucdAmount, uint256 minStablecoinOut) external returns (uint256 stablecoinAmount)", "function setExitFee(address stablecoin, uint256 fee) external", "function setEntryFee(address stablecoin, uint256 fee) external", "function setExchangeRate(address stablecoin, uint256 rate) external", "function setRedeemEnabled(bool enabled) external", "function addReserves(address stablecoin, uint256 amount) external", "function syncReserves(address stablecoin) external", "function forceSyncReserves(address stablecoin) external", "function getRedemptionQuote(address stablecoin, uint256 ucdAmount) external view returns (uint256 stablecoinOut, uint256 exitFee)", "function getAvailableReserves(address stablecoin) external view returns (uint256)", "function canRedeem(address stablecoin, uint256 ucdAmount) external view returns (bool)", "function version() external pure returns (string memory)", "function supportedStablecoins(address) external view returns (bool)", "function exchangeRates(address) external view returns (uint256)", "function fees(address) external view returns (uint256)", "function exitFees(address) external view returns (uint256)", "function reserves(address) external view returns (uint256)", "function redeemEnabled() external view returns (bool)", "function stablecoinDecimals(address) external view returns (uint8)", "function lastOperationBlock(address) external view returns (uint256)", "function operationCount(address) external view returns (uint256)", "function BASIS_POINTS() external view returns (uint256)", "function EXCHANGE_RATE_SCALE() external view returns (uint256)", "function MAX_EXIT_FEE() external view returns (uint256)", "function MAX_RESERVE_DRIFT() external view returns (uint256)", "event Swap(address indexed user, address indexed stablecoin, uint256 stablecoinAmount, uint256 ucdAmount, uint256 fee, uint256 timestamp)", "event Redeem(address indexed user, address indexed stablecoin, uint256 ucdAmount, uint256 stablecoinAmount, uint256 exitFee, uint256 timestamp)", "event StablecoinAdded(address indexed stablecoin, uint256 exchangeRate, uint256 fee)", "event StablecoinRemoved(address indexed stablecoin)", "event ReserveUpdated(address indexed stablecoin, uint256 oldReserve, uint256 newReserve)", "event ExitFeeUpdated(address indexed stablecoin, uint256 oldFee, uint256 newFee)", "event EntryFeeUpdated(address indexed stablecoin, uint256 oldFee, uint256 newFee)", "event ExchangeRateUpdated(address indexed stablecoin, uint256 oldRate, uint256 newRate)"];
@@ -6821,4 +7180,4 @@ declare const DEFAULT_BITCOIN_CONSENSUS_MODE: "majority";
  */
 declare const MIN_BITCOIN_PROVIDERS_FOR_CONSENSUS = 2;
 
-export { AuditTrail, AuthParamsValidation, AuthorizationParams, AuthorizationRequest, AuthorizationResult, BPS, BPSConversions, BTCDepositRequest, BTCDepositResult, BTCProof, BTCTransaction, BTCWithdrawalResult, BasicNetworkConfig, BitcoinAddresses, BitcoinBalanceResult, BitcoinNetwork, BitcoinOperations, BitcoinOperationsConfig, BitcoinProviderConfig, BitcoinUTXO, BlockNumber, CacheConfig, CacheManager, CacheStats, ClosePositionAuthParams, ConfirmationResult, ContractAddresses, ContractCallOptions, ContractManager, ContractManagerConfig, ContractQueryOptions, ContractTransactionResult, CreateLoanAuthParams, CreateLoanRequest, CreateLoanResult, DEFAULT_BALANCE_CACHE_SIZE, DEFAULT_BALANCE_CACHE_TTL_MS, DEFAULT_BITCOIN_CONSENSUS_MODE, DEFAULT_CACHE_CLEANUP_INTERVAL_MS, DEFAULT_CONCURRENCY_LIMIT, DEFAULT_LIT_NETWORKS, DEFAULT_MAX_RETRIES, DEFAULT_NETWORKS, DEFAULT_NETWORK_CONFIG, DEFAULT_OPERATION_TIMEOUT_MS, DEFAULT_PAGINATION_ROWS, DEFAULT_PKP_CACHE_SIZE, DEFAULT_PKP_CACHE_TTL_MS, DebugInfo, DiamondHandsSDK, DiamondHandsSDKConfig, EnrichedBitcoinBalance, EnvironmentName, ErrorCategory, ErrorSeverity, EventFilter, EventHelpers, EventLog, ExtendTermAuthParams, Failure, FeeDistributionEvent, IBTCProof, ILitAction, IPKPManager, IUCDMinting, Cache as LRUCache, LiquidationEvent, LiquidationRequest, LitActionAuth, LitActionParams, LitActionResult, LitActionValidationResult, LoanCreationAudit, LoanCreator, LoanCreatorConfig, LoanData, LoanDataDetail, LoanEvents, LoanEventsFilter, LoanManagerConfig, LoanQuery, LoanQueryConfig, LoanQueryFilters, LoanStatus, LoansQuery, MAX_PAGINATION_ROWS, MIN_BITCOIN_PROVIDERS_FOR_CONSENSUS, ManagedContracts, MintUCDAuthParams, MintingParams, MintingResult, MockTokenManager, MockTokenManagerConfig, MockTokenTransactionResult, MonitoringOptions, NETWORK_CONFIGS, NetworkConfig, PKPCreationRequest, PKPCreationResult, PKPData, PKPIssuanceRequest, PKPManager, PKPManagerConfig, PKPSigningRequest, PKPSigningResult, PKPValidationData, PKPValidationRequest, PKPValidationResult, POSITION_MANAGER_ABI, PRICE_FEED_CONSUMER_ABI, PSM_ABI, PSM_MAX_OPERATIONS_PER_WINDOW, PSM_RATE_LIMIT_RESET_BLOCKS, PaginatedLoansResponse, PaginatedResult, Pagination, PaginationParams, PartialPaymentRequest, PartialPaymentResult, PaymentEvent, PaymentType, Position, PositionDetails, PositionQueryOptions, PositionQueryResult, PositionStatus, PositionWithBTCStatus, PriceProviderConfig, RepayDebtAuthParams, Result$1 as Result, RetryConfig, RewardDistribution, SDKConfig, SDKError, SDKInitOptions, SDKMode, SDK_DEFAULTS, SDK_ERROR_MESSAGES, Satoshis, SatoshisConversions, ServiceModeConfig, StandaloneModeConfig, StatusUpdateEvent, Success, THE_GRAPH_MAX_BATCH_SIZE, UCD, UCDConversions, UCDMintEvent, UCDMintRequest, UCDMintResult, UCD_TOKEN_ABI, UnixTimestamp, ValidationRequest, Wei, WeiConversions, WithdrawBTCAuthParams, andThen, collectFailures, collectSuccesses, combine, createBitcoinOperations, createCacheManager, createContractManager, createLoanCreator, createLoanQuery, createMockTokenManager, createPKPManager, DiamondHandsSDK as default, envLog, failure, firstSuccess, fromPromise, getAllNetworkConfigs, getCurrentEnvironment, getLitNetworkConfig, getNetworkConfig, getNetworkConfigByName, isClosePositionAuth, isCreateLoanAuth, isExtendTermAuth, isFailure, isMintUCDAuth, isNetworkSupported, isRepayDebtAuth, isServiceModeConfig, isStandaloneModeConfig, isSuccess, isValidPaymentType, isValidPositionStatus, isWithdrawBTCAuth, loadSDKConfig, map, mapError, match, numericToPositionStatus, success, toPromise, tryCatch, tryCatchAsync, unwrap, unwrapOr, validateSDKConfig, validateSDKEnvironment, validateServiceModeConfig, validateStandaloneModeConfig };
+export { AuditTrail, AuthParamsValidation, AuthorizationParams, AuthorizationRequest, AuthorizationResult, BPS, BPSConversions, BTCDepositRequest, BTCDepositResult, BTCProof, BTCTransaction, BTCWithdrawalResult, BasicNetworkConfig, BitcoinAddresses, BitcoinBalanceResult, BitcoinNetwork, BitcoinOperations, BitcoinOperationsConfig, BitcoinProviderConfig, BitcoinUTXO, BlockNumber, CacheConfig, CacheManager, CacheStats, ClosePositionAuthParams, ConfirmationResult, ContractAddresses, ContractCallOptions, ContractManager, ContractManagerConfig, ContractQueryOptions, ContractTransactionResult, CreateLoanAuthParams, CreateLoanRequest, CreateLoanResult, DEFAULT_BALANCE_CACHE_SIZE, DEFAULT_BALANCE_CACHE_TTL_MS, DEFAULT_BITCOIN_CONSENSUS_MODE, DEFAULT_CACHE_CLEANUP_INTERVAL_MS, DEFAULT_CONCURRENCY_LIMIT, DEFAULT_LIT_NETWORKS, DEFAULT_MAX_RETRIES, DEFAULT_NETWORKS, DEFAULT_NETWORK_CONFIG, DEFAULT_OPERATION_TIMEOUT_MS, DEFAULT_PAGINATION_ROWS, DEFAULT_PKP_CACHE_SIZE, DEFAULT_PKP_CACHE_TTL_MS, DebugInfo, DiamondHandsLitActionResult, DiamondHandsSDK, DiamondHandsSDKConfig, EnrichedBitcoinBalance, EnvironmentName, ErrorCategory, ErrorSeverity, EventFilter, EventHelpers, EventLog, ExtendTermAuthParams, Failure, FeeDistributionEvent, IBTCProof, ILitAction, IPKPManager, IUCDMinting, Cache as LRUCache, LiquidationEvent, LiquidationRequest, LitActionAuth, LitActionParams, LitActionResult, LitActionValidationResult, LoanCreationAudit, LoanCreator, LoanCreatorConfig, LoanData, LoanDataDetail, LoanEvents, LoanEventsFilter, LoanManagerConfig, LoanQuery, LoanQueryConfig, LoanQueryFilters, LoanStatus, LoansQuery, MAX_PAGINATION_ROWS, MIN_BITCOIN_PROVIDERS_FOR_CONSENSUS, ManagedContracts, MintUCDAuthParams, MintingParams, MintingResult, MockTokenManager, MockTokenManagerConfig, MockTokenTransactionResult, MonitoringOptions, NETWORK_CONFIGS, NetworkConfig, PKPCreationRequest, PKPCreationResult, PKPData, PKPIssuanceRequest, PKPManager, PKPManagerConfig, PKPSigningRequest, PKPSigningResult, PKPValidationData, PKPValidationRequest, PKPValidationResult, POSITION_MANAGER_ABI, PRICE_FEED_CONSUMER_ABI, PSM_ABI, PSM_MAX_OPERATIONS_PER_WINDOW, PSM_RATE_LIMIT_RESET_BLOCKS, PaginatedLoansResponse, PaginatedResult, Pagination, PaginationParams, PartialPaymentRequest, PartialPaymentResult, PaymentEvent, PaymentType, Position, PositionDetails, PositionQueryOptions, PositionQueryResult, PositionStatus, PositionWithBTCStatus, PriceProviderConfig, RepayDebtAuthParams, Result$1 as Result, RetryConfig, RewardDistribution, SDKConfig, SDKError, SDKInitOptions, SDKMode, SDK_DEFAULTS, SDK_ERROR_MESSAGES, Satoshis, SatoshisConversions, ServiceModeConfig, StandaloneModeConfig, StatusUpdateEvent, Success, THE_GRAPH_MAX_BATCH_SIZE, UCD, UCDConversions, UCDMintEvent, UCDMintRequest, UCDMintResult, UCD_TOKEN_ABI, UnixTimestamp, ValidationRequest, Wei, WeiConversions, WithdrawBTCAuthParams, andThen, collectFailures, collectSuccesses, combine, createBitcoinOperations, createCacheManager, createContractManager, createLoanCreator, createLoanQuery, createMockTokenManager, createPKPManager, DiamondHandsSDK as default, envLog, failure, firstSuccess, fromPromise, getAllNetworkConfigs, getCurrentEnvironment, getLitNetworkConfig, getNetworkConfig, getNetworkConfigByName, isClosePositionAuth, isCreateLoanAuth, isExtendTermAuth, isFailure, isMintUCDAuth, isNetworkSupported, isRepayDebtAuth, isServiceModeConfig, isStandaloneModeConfig, isSuccess, isValidPaymentType, isValidPositionStatus, isWithdrawBTCAuth, loadSDKConfig, map, mapError, match, numericToPositionStatus, success, toPromise, tryCatch, tryCatchAsync, unwrap, unwrapOr, validateSDKConfig, validateSDKEnvironment, validateServiceModeConfig, validateStandaloneModeConfig };