@gvnrdao/dh-sdk 0.0.236 → 0.0.244

package/dist/interfaces/chunks/config.i.d.ts

@@ -1,7 +1,7 @@
 /**
  * SDK Configuration Interfaces
  */
-import { ethers as ethers5 } from "ethers";
+import type { Wallet, Signer, Provider } from "ethers";
 import { LitNetwork } from "@gvnrdao/dh-lit-ops";
 export type SDKMode = "standalone" | "service";
 /**
@@ -28,6 +28,10 @@ export interface ContractAddresses {
     btcSpendAuthorizer?: string;
     /** BitcoinProviderRegistry proxy; required on non-hardhat chains when chain policy disallows arbitrary providers. */
     bitcoinProviderRegistry?: string;
+    /** ContractVersionRegistry proxy; used for cross-contract version pinning. */
+    contractVersionRegistry?: string;
+    /** PositionDelegateRegistry proxy; consumed by LIT Action authorization verifier as the third recovery arm for Safe-as-borrower flows. */
+    positionDelegateRegistry?: string;
     mockUsdcToken?: string;
     mockUsdcOwner?: string;
     mockUsdtToken?: string;
@@ -38,21 +42,26 @@ export interface ContractAddresses {
  */
 interface BaseSDKConfig {
     litNetwork?: LitNetwork;
-    contractSigner?: ethers5.Wallet | ethers5.Signer;
+    contractSigner?: Wallet | Signer;
+    /**
+     * Optional signer used exclusively for EIP-712 server-session login.
+     * When provided, `ServerSession` uses this instead of `contractSigner` so
+     * the two concerns (auth identity vs on-chain msg.sender) can differ. In
+     * Safe mode the CLI passes the raw agent EOA here while `contractSigner`
+     * is a SafeModuleSignerAdapter that routes transactions through the module.
+     */
+    authSigner?: Wallet | Signer;
     ethRpcUrl?: string;
     chainId?: number;
     networkOverride?: {
         chainId: number;
         name: string;
     };
-    provider?: ethers5.providers.Provider;
+    provider?: Provider;
     chain?: string;
     litActionCid?: string;
     litNodeConnectTimeoutMs?: number;
     subgraphUrl?: string;
-    bitcoinRpcUrl?: string;
-    bitcoinProviders?: BitcoinProviderConfig[];
-    bitcoinConsensusMode?: "single" | "majority";
     priceProviders?: PriceProviderConfig[];
     /** PKP Ethereum address for signed price oracle (Lit jsParams pkpId); optional */
     priceOraclePkpId?: string;
@@ -79,6 +88,8 @@ interface BaseSDKConfig {
     transactionTimeoutMs?: number;
     retryAttempts?: number;
     debug?: boolean;
+    /** Notification label for server Telegram notifications. Default: "DH SDK". Set "DH APP" in the web app. */
+    callerLabel?: string;
     /**
      * Optional: Override quantum timing buffer (in seconds)
      * Default: Auto-detected based on network (10s for local, 50s for Sepolia, 35s for mainnet)
@@ -159,7 +170,6 @@ interface BaseSDKConfig {
 export interface ServiceModeConfig extends BaseSDKConfig {
     mode: "service";
     serviceEndpoint: string;
-    serviceAuthToken?: string;
     litOpsSigner?: never;
 }
 /**
@@ -168,9 +178,8 @@ export interface ServiceModeConfig extends BaseSDKConfig {
  */
 export interface StandaloneModeConfig extends BaseSDKConfig {
     mode: "standalone";
-    litOpsSigner: ethers5.Wallet;
+    litOpsSigner: Wallet;
     serviceEndpoint?: never;
-    serviceAuthToken?: never;
 }
 /**
  * Main SDK Configuration - Discriminated Union
@@ -222,7 +231,7 @@ export declare function validateSDKConfig(config: DiamondHandsSDKConfig): string
  */
 export interface SDKInitOptions {
     overrideDefaults?: boolean;
-    customProvider?: ethers5.providers.Provider;
+    customProvider?: Provider;
     skipNetworkCheck?: boolean;
 }
 /**
@@ -252,6 +261,7 @@ export interface BitcoinProviderConfig {
  */
 export interface PriceProviderConfig {
     name: string;
+    pkpId?: string;
     apiKey?: string;
     apiSecret?: string;
 }

package/dist/interfaces/chunks/contract-interactions.i.d.ts

@@ -1,7 +1,7 @@
 /**
  * Smart Contract Interaction Interfaces
  */
-import { ethers as ethers5 } from "ethers";
+import type { TransactionReceipt } from "ethers";
 /**
  * Contract Call Options Interface
  */
@@ -18,7 +18,7 @@ export interface ContractTransactionResult {
     success: boolean;
     error?: string;
     transactionHash?: string;
-    receipt?: ethers5.providers.TransactionReceipt;
+    receipt?: TransactionReceipt;
     gasUsed?: string;
     events?: any[];
 }

package/dist/interfaces/chunks/contract-types.i.d.ts

@@ -5,20 +5,19 @@
  * They are independent definitions - NOT imported from the contracts package.
  * Based on Solidity interfaces from contracts/src/interfaces/
  */
-import { ethers as ethers5 } from "ethers";
-import type { BigNumber } from "ethers";
+import type { BaseContract, ContractTransactionResponse } from "ethers";
 /**
  * Position Manager Contract Interface
  * Based on contracts/src/interfaces/IPositionManager.sol
  */
-export interface PositionManager extends ethers5.Contract {
-    createPosition(pkpId: string, validatorSignature: string, mainnetVaultAddress: string, regtestVaultAddress: string, selectedTermMonths: number | BigNumber, validatorVersion: number | BigNumber, pkpPublicKey: string): Promise<ethers5.ContractTransaction>;
-    mintUCD(positionId: string, mintAmount: BigNumber, mintFee: BigNumber, newDebt: BigNumber, newCollateral: BigNumber, btcPrice: BigNumber, authorizedSpendsHash: string, ucdDebtHash: string, contractHash: string, quantumTimestamp: BigNumber, mintValidatorSignature: string): Promise<ethers5.ContractTransaction>;
-    liquidatePosition(positionId: string, btcPrice: BigNumber, quantumTimestamp: BigNumber, liquidationValidatorSignature: string): Promise<ethers5.ContractTransaction>;
+export interface PositionManager extends BaseContract {
+    createPosition(pkpId: string, validatorSignature: string, mainnetVaultAddress: string, regtestVaultAddress: string, selectedTermMonths: number | bigint, validatorVersion: number | bigint, pkpPublicKey: string): Promise<ContractTransactionResponse>;
+    mintUCD(positionId: string, mintAmount: bigint, mintFee: bigint, newDebt: bigint, newCollateral: bigint, btcPrice: bigint, authorizedSpendsHash: string, ucdDebtHash: string, contractHash: string, quantumTimestamp: bigint, mintValidatorSignature: string): Promise<ContractTransactionResponse>;
+    liquidatePosition(positionId: string, btcPrice: bigint, quantumTimestamp: bigint, liquidationValidatorSignature: string): Promise<ContractTransactionResponse>;
     getPosition(positionId: string): Promise<{
         positionId: string;
         pkpId: string;
-        ucdDebt: BigNumber;
+        ucdDebt: bigint;
         borrower: string;
         createdAt: number;
         lastUpdated: number;
@@ -26,67 +25,71 @@ export interface PositionManager extends ethers5.Contract {
         expiryAt: number;
         status: number;
     }>;
+    extendPosition(positionId: string, selectedTerm: bigint, quantumTimestamp: bigint, btcPrice: bigint, availableBTCBalance: bigint, proRataRenewalFee: bigint, extensionValidatorSignature: string): Promise<ContractTransactionResponse>;
+    commitLiquidation(positionId: string, quantumTimestamp: bigint, btcPrice: bigint, btcVaultBalance: bigint, liquidationValidatorSignature: string, overrides?: object): Promise<ContractTransactionResponse>;
+    revealAndLiquidate(positionId: string, quantumTimestamp: bigint, btcPrice: bigint, btcVaultBalance: bigint, liquidationValidatorSignature: string, deadline: bigint, overrides?: object): Promise<ContractTransactionResponse>;
+    makePayment(positionId: string, paymentAmount: bigint | string, quantumTimestamp: bigint | string, btcPrice: bigint | string, paymentValidatorSignature: string): Promise<ContractTransactionResponse>;
     pkpValidationRegistry(): Promise<string>;
-    updateBalance(positionId: string, newBtcBalance: string | number | BigNumber, btcPrice: string | number | BigNumber, quantumTimestamp: string | number | BigNumber, signature: string): Promise<ethers5.ContractTransaction>;
+    updateBalance(positionId: string, newBtcBalance: string | number | bigint, btcPrice: string | number | bigint, quantumTimestamp: string | number | bigint, signature: string): Promise<ContractTransactionResponse>;
 }
 /**
  * Loan Operations Manager Contract Interface
  * Based on contracts/src/interfaces/ILoanOperationsManager.sol
  */
-export interface ILoanOperationsManager extends ethers5.Contract {
-    mintUCD(positionId: string, mintAmount: BigNumber, mintFee: BigNumber, newDebt: BigNumber, newCollateral: BigNumber, btcPrice: BigNumber, authorizedSpendsHash: string, ucdDebtHash: string, quantumTimestamp: BigNumber): Promise<ethers5.ContractTransaction>;
-    processPayment(positionId: string, paymentAmount: BigNumber, quantumTimestamp: BigNumber, btcPrice: BigNumber): Promise<ethers5.ContractTransaction>;
-    updatePosition(positionId: string, newDebt: BigNumber, quantumTimestamp: BigNumber, btcPrice: BigNumber, updateValidatorSignature: string): Promise<ethers5.ContractTransaction>;
-    transferOriginationFee(recipient: string, amount: BigNumber): Promise<ethers5.ContractTransaction>;
-    mintExtensionFee(amount: BigNumber): Promise<ethers5.ContractTransaction>;
-    getOriginationFeeBalance(): Promise<BigNumber>;
-    authorizeBTCSpend(positionId: string, txid: string, vout: number, satoshis: BigNumber, targetAddress: string, targetAmount: BigNumber, litSignature: string): Promise<ethers5.ContractTransaction>;
-    liquidationThreshold(): Promise<BigNumber>;
-    minimumLoanValueWei(): Promise<BigNumber>;
+export interface ILoanOperationsManager extends BaseContract {
+    mintUCD(positionId: string, mintAmount: bigint, mintFee: bigint, newDebt: bigint, newCollateral: bigint, btcPrice: bigint, authorizedSpendsHash: string, ucdDebtHash: string, quantumTimestamp: bigint): Promise<ContractTransactionResponse>;
+    processPayment(positionId: string, paymentAmount: bigint, quantumTimestamp: bigint, btcPrice: bigint): Promise<ContractTransactionResponse>;
+    updatePosition(positionId: string, newDebt: bigint, quantumTimestamp: bigint, btcPrice: bigint, updateValidatorSignature: string): Promise<ContractTransactionResponse>;
+    transferOriginationFee(recipient: string, amount: bigint): Promise<ContractTransactionResponse>;
+    mintExtensionFee(amount: bigint): Promise<ContractTransactionResponse>;
+    getOriginationFeeBalance(): Promise<bigint>;
+    authorizeBTCSpend(positionId: string, txid: string, vout: number, satoshis: bigint, targetAddress: string, targetAmount: bigint, litSignature: string): Promise<ContractTransactionResponse>;
+    liquidationThreshold(): Promise<bigint>;
+    minimumLoanValueWei(): Promise<bigint>;
     ucdToken(): Promise<string>;
     getUcdController(): Promise<string>;
-    getPKPActualCollateral(pkpId: string): Promise<BigNumber>;
+    getPKPActualCollateral(pkpId: string): Promise<bigint>;
     isPriceFeedStale(): Promise<boolean>;
-    calculateCollateralRatio(positionId: string, btcPrice: BigNumber): Promise<BigNumber>;
-    getTotalAuthorizedSats(positionId: string): Promise<BigNumber>;
-    extendPosition(positionId: string, newTermMonths: BigNumber, extensionFee: BigNumber, quantumTimestamp: BigNumber, btcPrice: BigNumber, extendValidatorSignature: string): Promise<ethers5.ContractTransaction>;
-    withdrawBTC(positionId: string, btcTxid: string, btcVout: number, satoshis: BigNumber, destinationAddress: string, quantumTimestamp: BigNumber, btcPrice: BigNumber, btcWithdrawalSignature: string): Promise<ethers5.ContractTransaction>;
+    calculateCollateralRatio(positionId: string, btcPrice: bigint): Promise<bigint>;
+    getTotalAuthorizedSats(positionId: string): Promise<bigint>;
+    extendPosition(positionId: string, newTermMonths: bigint, extensionFee: bigint, quantumTimestamp: bigint, btcPrice: bigint, extendValidatorSignature: string): Promise<ContractTransactionResponse>;
+    withdrawBTC(positionId: string, btcTxid: string, btcVout: number, satoshis: bigint, destinationAddress: string, quantumTimestamp: bigint, btcPrice: bigint, btcWithdrawalSignature: string): Promise<ContractTransactionResponse>;
 }
 /**
  * UCD Controller Contract Interface
  * Based on contracts/src/interfaces/IUCDController.sol
  */
-export interface IUCDController extends ethers5.Contract {
-    mintFromLoanOps(to: string, amount: BigNumber, positionId: string, debtAfterMint: BigNumber): Promise<ethers5.ContractTransaction>;
-    mintFromPsm(to: string, amount: BigNumber, stablecoin: string, amountIn: BigNumber): Promise<ethers5.ContractTransaction>;
-    burnTokens(from: string, amount: BigNumber): Promise<ethers5.ContractTransaction>;
-    setAdminModule(_adminModule: string): Promise<ethers5.ContractTransaction>;
-    setAuthorizedMinter(minter: string, authorized: boolean): Promise<ethers5.ContractTransaction>;
-    setAuthorizedBurner(burner: string, authorized: boolean): Promise<ethers5.ContractTransaction>;
-    setMaxSupply(newMaxSupply: BigNumber): Promise<ethers5.ContractTransaction>;
-    setDailyMintLimit(newLimit: BigNumber): Promise<ethers5.ContractTransaction>;
-    setDailyBurnLimit(newLimit: BigNumber): Promise<ethers5.ContractTransaction>;
-    setUCDToken(newToken: string): Promise<ethers5.ContractTransaction>;
-    getCurrentSupply(): Promise<BigNumber>;
-    getRemainingMintCapacity(): Promise<BigNumber>;
-    getRemainingBurnCapacity(): Promise<BigNumber>;
-    getRemainingPsmMintCapacity(): Promise<BigNumber>;
+export interface IUCDController extends BaseContract {
+    mintFromLoanOps(to: string, amount: bigint, positionId: string, debtAfterMint: bigint): Promise<ContractTransactionResponse>;
+    mintFromPsm(to: string, amount: bigint, stablecoin: string, amountIn: bigint): Promise<ContractTransactionResponse>;
+    burnTokens(from: string, amount: bigint): Promise<ContractTransactionResponse>;
+    setAdminModule(_adminModule: string): Promise<ContractTransactionResponse>;
+    setAuthorizedMinter(minter: string, authorized: boolean): Promise<ContractTransactionResponse>;
+    setAuthorizedBurner(burner: string, authorized: boolean): Promise<ContractTransactionResponse>;
+    setMaxSupply(newMaxSupply: bigint): Promise<ContractTransactionResponse>;
+    setDailyMintLimit(newLimit: bigint): Promise<ContractTransactionResponse>;
+    setDailyBurnLimit(newLimit: bigint): Promise<ContractTransactionResponse>;
+    setUCDToken(newToken: string): Promise<ContractTransactionResponse>;
+    getCurrentSupply(): Promise<bigint>;
+    getRemainingMintCapacity(): Promise<bigint>;
+    getRemainingBurnCapacity(): Promise<bigint>;
+    getRemainingPsmMintCapacity(): Promise<bigint>;
     isAuthorizedMinter(account: string): Promise<boolean>;
     isAuthorizedBurner(account: string): Promise<boolean>;
     authorizedMinters(account: string): Promise<boolean>;
     authorizedBurners(account: string): Promise<boolean>;
-    burnedPerAddress(account: string): Promise<BigNumber>;
-    totalMinted(): Promise<BigNumber>;
-    totalBurned(): Promise<BigNumber>;
-    maxSupply(): Promise<BigNumber>;
-    dailyMintLimit(): Promise<BigNumber>;
-    dailyBurnLimit(): Promise<BigNumber>;
-    lastMintReset(): Promise<BigNumber>;
-    lastBurnReset(): Promise<BigNumber>;
-    dailyMinted(): Promise<BigNumber>;
-    dailyBurned(): Promise<BigNumber>;
-    dailyPsmMinted(): Promise<BigNumber>;
-    psmDailyMintLimit(): Promise<BigNumber>;
+    burnedPerAddress(account: string): Promise<bigint>;
+    totalMinted(): Promise<bigint>;
+    totalBurned(): Promise<bigint>;
+    maxSupply(): Promise<bigint>;
+    dailyMintLimit(): Promise<bigint>;
+    dailyBurnLimit(): Promise<bigint>;
+    lastMintReset(): Promise<bigint>;
+    lastBurnReset(): Promise<bigint>;
+    dailyMinted(): Promise<bigint>;
+    dailyBurned(): Promise<bigint>;
+    dailyPsmMinted(): Promise<bigint>;
+    psmDailyMintLimit(): Promise<bigint>;
     circuitBreaker(): Promise<string>;
     ucdToken(): Promise<string>;
     adminModule(): Promise<string>;
@@ -94,72 +97,73 @@ export interface IUCDController extends ethers5.Contract {
 /**
  * Price Feed Consumer Contract Interface
  */
-export interface IPriceFeedConsumer extends ethers5.Contract {
-    updatePrice(): Promise<ethers5.ContractTransaction>;
-    getCurrentPrice(): Promise<BigNumber>;
-    getPriceAge(): Promise<BigNumber>;
+export interface IPriceFeedConsumer extends BaseContract {
+    updatePrice(): Promise<ContractTransactionResponse>;
+    getCurrentPrice(): Promise<bigint>;
+    getPriceAge(): Promise<bigint>;
     isPriceStale(): Promise<boolean>;
     validatePriceFeed(): Promise<boolean>;
-    getLatestBTCPrice(): Promise<BigNumber>;
+    getLatestBTCPrice(): Promise<bigint>;
     decimals(): Promise<number>;
 }
 /**
  * Term Manager Contract Interface
  * Based on contracts/src/interfaces/ITermManager.sol
  */
-export interface ITermManager extends ethers5.Contract {
-    addTerm(termMonths: BigNumber, originationFee: BigNumber, extensionFee: BigNumber): Promise<ethers5.ContractTransaction>;
-    removeTerm(termMonths: BigNumber): Promise<ethers5.ContractTransaction>;
-    updateTermFees(termMonths: BigNumber, originationFee: BigNumber, extensionFee: BigNumber): Promise<ethers5.ContractTransaction>;
-    getTermFees(termMonths: BigNumber): Promise<{
-        originationFee: BigNumber;
-        extensionFee: BigNumber;
+export interface ITermManager extends BaseContract {
+    addTerm(termMonths: bigint, originationFee: bigint, extensionFee: bigint): Promise<ContractTransactionResponse>;
+    removeTerm(termMonths: bigint): Promise<ContractTransactionResponse>;
+    updateTermFees(termMonths: bigint, originationFee: bigint, extensionFee: bigint): Promise<ContractTransactionResponse>;
+    getTermFees(termMonths: bigint): Promise<{
+        originationFee: bigint;
+        extensionFee: bigint;
     }>;
-    isValidTerm(termMonths: BigNumber): Promise<boolean>;
+    isValidTerm(termMonths: bigint): Promise<boolean>;
     getValidTermsWithFees(): Promise<{
-        terms: BigNumber[];
-        originationFees: BigNumber[];
-        extensionFees: BigNumber[];
+        terms: bigint[];
+        originationFees: bigint[];
+        extensionFees: bigint[];
     }>;
-    getTermDataById(termId: BigNumber): Promise<{
-        termMonths: BigNumber;
-        originationFee: BigNumber;
-        extensionFee: BigNumber;
+    getTermDataById(termId: bigint): Promise<{
+        termMonths: bigint;
+        originationFee: bigint;
+        extensionFee: bigint;
         isActive: boolean;
     }>;
-    getAllTerms(): Promise<BigNumber[]>;
-    updateDependencies(newCore: string, newUcdController: string): Promise<ethers5.ContractTransaction>;
+    getAllTerms(): Promise<bigint[]>;
+    updateDependencies(newCore: string, newUcdController: string): Promise<ContractTransactionResponse>;
     supportsInterface(interfaceId: string): Promise<boolean>;
 }
 /**
  * Circuit Breaker Module Contract Interface
  * Based on contracts/src/interfaces/ICircuitBreakerModule.sol
  */
-export interface CircuitBreakerModule extends ethers5.Contract {
-    circuitBreakerCheck(ucdAmount: BigNumber, btcAmount: BigNumber): Promise<ethers5.ContractTransaction>;
-    proposeLimitUpdate(newMaxLoanValue: BigNumber, newMaxBtcPerPosition: BigNumber, newDailyLimit: BigNumber): Promise<ethers5.ContractTransaction>;
-    signLimitUpdate(proposalHash: string): Promise<ethers5.ContractTransaction>;
-    executeLimitUpdate(proposalHash: string, newMaxLoanValue: BigNumber, newMaxBtcPerPosition: BigNumber, newDailyLimit: BigNumber): Promise<ethers5.ContractTransaction>;
-    activateCircuitBreaker(): Promise<ethers5.ContractTransaction>;
-    deactivateCircuitBreaker(): Promise<ethers5.ContractTransaction>;
-    signCircuitBreakerDeactivation(): Promise<ethers5.ContractTransaction>;
-    maxSingleLoanValue(): Promise<BigNumber>;
-    maxBtcPerPosition(): Promise<BigNumber>;
-    dailyVolumeLimit(): Promise<BigNumber>;
+export interface CircuitBreakerModule extends BaseContract {
+    circuitBreakerCheck(ucdAmount: bigint, btcAmount: bigint): Promise<ContractTransactionResponse>;
+    proposeLimitUpdate(newMaxLoanValue: bigint, newMaxBtcPerPosition: bigint, newDailyLimit: bigint): Promise<ContractTransactionResponse>;
+    signLimitUpdate(proposalHash: string): Promise<ContractTransactionResponse>;
+    executeLimitUpdate(proposalHash: string, newMaxLoanValue: bigint, newMaxBtcPerPosition: bigint, newDailyLimit: bigint): Promise<ContractTransactionResponse>;
+    activateCircuitBreaker(): Promise<ContractTransactionResponse>;
+    deactivateCircuitBreaker(): Promise<ContractTransactionResponse>;
+    signCircuitBreakerDeactivation(): Promise<ContractTransactionResponse>;
+    maxSingleLoanValue(): Promise<bigint>;
+    maxBtcPerPosition(): Promise<bigint>;
+    dailyVolumeLimit(): Promise<bigint>;
     circuitBreakerActive(): Promise<boolean>;
-    circuitBreakerActivatedAt(): Promise<BigNumber>;
-    dailyUcdVolume(day: BigNumber): Promise<BigNumber>;
-    dailyBtcVolume(day: BigNumber): Promise<BigNumber>;
+    circuitBreakerActivatedAt(): Promise<bigint>;
+    dailyUcdVolume(day: bigint): Promise<bigint>;
+    dailyBtcVolume(day: bigint): Promise<bigint>;
     supportsInterface(interfaceId: string): Promise<boolean>;
 }
 /**
  * Liquidation Manager Contract Interface
  * Based on contracts/src/interfaces/ILiquidationManager.sol
  */
-export interface ILiquidationManager extends ethers5.Contract {
-    liquidatePosition(positionId: string, btcPrice: BigNumber, quantumTimestamp: BigNumber): Promise<ethers5.ContractTransaction>;
-    commitLiquidation(positionId: string, quantumTimestamp: BigNumber, btcPrice: BigNumber): Promise<ethers5.ContractTransaction>;
-    revealAndLiquidate(positionId: string, quantumTimestamp: BigNumber, btcPrice: BigNumber, liquidationValidatorSignature: string, deadline: BigNumber): Promise<ethers5.ContractTransaction>;
-    isLiquidatable(positionId: string, btcPrice: BigNumber, quantumTimestamp: BigNumber, liquidationValidatorSignature: string): Promise<boolean>;
+export interface ILiquidationManager extends BaseContract {
+    liquidatePosition(positionId: string, btcPrice: bigint, quantumTimestamp: bigint): Promise<ContractTransactionResponse>;
+    commitLiquidation(positionId: string, quantumTimestamp: bigint, btcPrice: bigint): Promise<ContractTransactionResponse>;
+    revealAndLiquidate(positionId: string, quantumTimestamp: bigint, btcPrice: bigint, liquidationValidatorSignature: string, deadline: bigint): Promise<ContractTransactionResponse>;
+    isLiquidatable(positionId: string, btcPrice: bigint, quantumTimestamp: bigint, liquidationValidatorSignature: string): Promise<boolean>;
+    vrfSeeds(positionId: string): Promise<bigint>;
     supportsInterface(interfaceId: string): Promise<boolean>;
 }

package/dist/interfaces/chunks/loan-operations.i.d.ts

@@ -169,7 +169,6 @@ export interface UCDMintRequest {
     selectedTerm?: number;
     skipValidation?: boolean;
     rpcUrl?: string;
-    customBitcoinRpcUrl?: string;
     testBtcPrice?: number;
     debugOverrides?: {
         useStubbedBtcData?: boolean;
@@ -232,6 +231,8 @@ export interface BTCWithdrawalResult {
     bitcoinTransactionHash?: string;
     utxoTxid?: string;
     utxoVout?: number;
+    /** Full satoshi value of the authorized UTXO; needed by Phase 2 broadcast. */
+    utxoSatoshis?: string;
     error?: string;
 }
 /**
@@ -247,7 +248,6 @@ export interface LiquidationRequest {
      */
     skipUcdApproval?: boolean;
     rpcUrl?: string;
-    customBitcoinRpcUrl?: string;
 }
 /**
  * Liquidation Result Interface
@@ -272,7 +272,6 @@ export interface PartialPaymentRequest {
     positionId: string;
     paymentAmount: number;
     rpcUrl?: string;
-    customBitcoinRpcUrl?: string;
 }
 /**
  * Confirm Balance Result Interface

package/dist/modules/bitcoin/bitcoin-operations.module.d.ts

@@ -197,6 +197,43 @@ export declare class BitcoinOperations {
      * Check if consensus mode is enabled
      */
     isConsensusEnabled(): boolean;
+    /**
+     * Audit CRIT-2: verify a Phase-2 BTC withdrawal that the lit-ops-server
+     * claimed broadcast actually exists on chain and matches the user's
+     * authorization.
+     *
+     * Behavior:
+     *  - If we successfully fetch the tx AND it disagrees with what the user
+     *    authorized → throws (hard fail; server lied).
+     *  - If we fetch the tx and it matches → returns `{ verified: true }`.
+     *  - If no provider has the tx after `maxAttempts` retries → returns
+     *    `{ verified: false, reason: "not yet visible" }`. The caller decides
+     *    whether to log a warning and proceed (e.g., regtest without an
+     *    Esplora indexer, or extreme propagation delay) or to escalate.
+     *  - If no Bitcoin providers are configured → returns `{ verified: false,
+     *    reason: "no providers" }` immediately.
+     *
+     * The expected `value` is `targetAmount - networkFee` (what reaches the
+     * recipient after the fee), matching the Lit Action's
+     * `userReceivesAmount` computation.
+     */
+    verifyBroadcastTx(args: {
+        txid: string;
+        expectedInput: {
+            txid: string;
+            vout: number;
+        };
+        expectedOutput: {
+            address: string;
+            value: number;
+        };
+        maxAttempts?: number;
+        delayMs?: number;
+    }): Promise<{
+        verified: boolean;
+        reason?: string;
+        confirmed?: boolean;
+    }>;
     /**
      * Get current BTC price using LIT Protocol price oracle
      *

package/dist/modules/cache/cache-manager.module.d.ts

@@ -86,6 +86,14 @@ export interface CacheConfig {
  */
 export declare class LRUCache<K, V> {
     private cache;
+    /**
+     * Audit M-J: singleflight registry for `getOrCompute` / `getOrComputeResult`.
+     * Concurrent cache-miss callers for the same key share one inflight promise
+     * instead of each running `compute()` independently — important when the
+     * compute spends a paid LIT capacity credit or hits a rate-limited upstream.
+     */
+    private inflight;
+    private inflightResult;
     private readonly maxSize;
     private readonly ttlMs;
     private readonly debug;

package/dist/modules/contract/contract-manager.module.d.ts

@@ -10,19 +10,19 @@
  * This module centralizes all contract interaction setup and provides
  * a clean interface for other modules to access contracts.
  */
-import { ethers as ethers5 } from "ethers";
+import { type Provider, type Signer } from "ethers";
 import type { ContractAddresses } from "../../interfaces/chunks/config.i";
 import { Result } from "../../types/result";
 import { SDKError } from "../../utils/error-handler";
 import type { PositionManager, ILoanOperationsManager, IUCDController, IPriceFeedConsumer, ITermManager, CircuitBreakerModule, ILiquidationManager } from "../../interfaces/chunks/contract-types.i";
 /**
- * Type alias for ethers v5 provider (used throughout SDK)
+ * Type alias for ethers v6 provider (used throughout SDK)
  */
-export type Provider = ethers5.providers.Provider;
+export type { Provider };
 /**
- * Type alias for ethers v5 signer
+ * Type alias for ethers v6 signer
  */
-export type Signer = ethers5.Signer;
+export type { Signer };
 /**
  * Type alias for contract runner (provider or signer)
  */