@gvnrdao/dh-sdk 0.0.166 → 0.0.205

package/dist/utils/lit-signature.utils.d.ts

@@ -0,0 +1,6 @@
+export declare function extractLitSignature(raw: unknown, key: string): {
+    signature: string;
+    envelope?: Record<string, unknown>;
+};
+export declare function extractOptionalLitSignatureFromEnvelope(envelope: Record<string, unknown> | undefined, key: string): string;
+export declare function extractOptionalLitSignature(raw: unknown): string;

package/dist/utils/logger.utils.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Minimal Logger Utility
+ * Provides structured logging with levels and context to keep production output clean
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogContext {
+    operation?: string;
+    id?: string;
+    userId?: string;
+    positionId?: string;
+    pkpId?: string;
+    address?: string;
+    network?: string;
+    provider?: string;
+    attempt?: number;
+    maxAttempts?: number;
+    duration?: number;
+    [key: string]: any;
+}
+export interface LoggerConfig {
+    enabled: boolean;
+    level: LogLevel;
+    includeTimestamp: boolean;
+    includeContext: boolean;
+    maxContextKeys: number;
+    verboseInProduction: boolean;
+    isProduction: boolean;
+}
+export declare class Logger {
+    private config;
+    private static instance;
+    constructor(config?: Partial<LoggerConfig>);
+    /**
+     * Get or create singleton logger instance
+     */
+    static getInstance(config?: Partial<LoggerConfig>): Logger;
+    /**
+     * Update logger configuration
+     */
+    updateConfig(config: Partial<LoggerConfig>): void;
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Format context object for output
+     */
+    private formatContext;
+    /**
+     * Format timestamp for output
+     */
+    private formatTimestamp;
+    /**
+     * Core logging method
+     */
+    private log;
+    /**
+     * Get prefix for log level
+     */
+    private getLevelPrefix;
+    /**
+     * Debug level logging
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Info level logging
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Warning level logging
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Error level logging
+     */
+    error(message: string, context?: LogContext): void;
+    /**
+     * Log operation start
+     */
+    startOperation(operation: string, context?: LogContext): void;
+    /**
+     * Log operation completion
+     */
+    completeOperation(operation: string, context?: LogContext): void;
+    /**
+     * Log operation failure
+     */
+    failOperation(operation: string, error: Error | string, context?: LogContext): void;
+    /**
+     * Log retry attempt
+     */
+    retry(operation: string, attempt: number, maxAttempts: number, error?: Error, context?: LogContext): void;
+    /**
+     * Log cache operations
+     */
+    cacheHit(key: string, context?: LogContext): void;
+    cacheMiss(key: string, context?: LogContext): void;
+    /**
+     * Log network operations
+     */
+    networkRequest(url: string, method: string, context?: LogContext): void;
+    networkResponse(url: string, status: number, duration?: number, context?: LogContext): void;
+    /**
+     * Log Bitcoin operations
+     */
+    bitcoinOperation(operation: string, address?: string, context?: LogContext): void;
+    /**
+     * Log contract operations
+     */
+    contractOperation(operation: string, contract?: string, context?: LogContext): void;
+}
+/**
+ * Get the global logger instance
+ */
+export declare function getLogger(): Logger;
+/**
+ * Create a logger with specific configuration
+ */
+export declare function createLogger(config: Partial<LoggerConfig>): Logger;
+/**
+ * Quick logging functions for common use cases
+ */
+export declare const log: {
+    debug: (message: string, context?: LogContext) => void;
+    info: (message: string, context?: LogContext) => void;
+    warn: (message: string, context?: LogContext) => void;
+    error: (message: string, context?: LogContext) => void;
+    start: (operation: string, context?: LogContext) => void;
+    complete: (operation: string, context?: LogContext) => void;
+    fail: (operation: string, error: Error | string, context?: LogContext) => void;
+    retry: (operation: string, attempt: number, maxAttempts: number, error?: Error, context?: LogContext) => void;
+    cache: {
+        hit: (key: string, context?: LogContext) => void;
+        miss: (key: string, context?: LogContext) => void;
+    };
+    network: {
+        request: (url: string, method: string, context?: LogContext) => void;
+        response: (url: string, status: number, duration?: number, context?: LogContext) => void;
+    };
+    bitcoin: (operation: string, address?: string, context?: LogContext) => void;
+    contract: (operation: string, contract?: string, context?: LogContext) => void;
+};

package/dist/utils/mint-authorization.utils.d.ts

@@ -0,0 +1,224 @@
+/**
+ * UCD Mint Authorization Utilities
+ *
+ * Generates authorization signatures for UCD mint requests
+ * that can be verified by the ucd-mint-validator LIT Action.
+ * Also includes withdrawal authorization utilities.
+ */
+import { ethers as ethers5 } from "ethers";
+/**
+ * Owner Authorization Interface (matches lit-actions)
+ */
+export interface MintOwnerAuthorization {
+    positionId: string;
+    timestamp: number;
+    chainId: number;
+    amount: string;
+    action: string;
+    signature: string;
+}
+/**
+ * Build the mint authorization message hash without signing.
+ *
+ * Use this when signing with a smart contract wallet (e.g. Safe) that
+ * needs to wrap the hash in its own domain before signing.
+ *
+ * Returns the raw hash AND the timestamp so both can be passed to
+ * generateMintAuthorization via the pre-computed signature overload.
+ *
+ * @param positionId - Position identifier
+ * @param amount - Amount to mint in wei (bigint)
+ * @param chainId - Chain ID for cross-chain replay protection
+ * @returns { hash, timestamp } — pass these to Safe for signing
+ */
+export declare function buildMintAuthorizationHash(positionId: string, amount: bigint, chainId: number): {
+    hash: string;
+    timestamp: number;
+};
+/**
+ * Generate mint authorization signature
+ *
+ * Creates a signature that matches the format expected by
+ * AuthorizationModule.verifyMintAuthorization in lit-actions.
+ *
+ * Message structure:
+ * solidityKeccak256(
+ *   ["bytes32", "uint256", "uint256", "uint256", "bytes32"],
+ *   [positionId, timestamp, chainId, amount, actionHash]
+ * )
+ *
+ * Where:
+ * - actionHash = keccak256("mint-ucd")
+ * - Signer address is recovered from signature by LIT Action
+ * - LIT Action validates recovered address === position owner
+ *
+ * @param positionId - Position identifier
+ * @param amount - Amount to mint in wei (bigint)
+ * @param chainId - Chain ID for cross-chain replay protection
+ * @param signerOrPrecomputed - Either an ethers Signer (EOA) or { timestamp, signature } for smart contract wallets
+ * @returns Authorization object with signature
+ */
+export declare function generateMintAuthorization(positionId: string, amount: bigint, chainId: number, signerOrPrecomputed: ethers5.Signer | {
+    timestamp: number;
+    signature: string;
+}): Promise<MintOwnerAuthorization>;
+/**
+ * Payment Authorization Interface (matches lit-actions)
+ */
+export interface PaymentOwnerAuthorization {
+    positionId: string;
+    timestamp: number;
+    chainId: number;
+    amount: string;
+    action: string;
+    signature: string;
+}
+/**
+ * Extend Position Authorization Interface (matches lit-actions)
+ */
+export interface ExtendOwnerAuthorization {
+    positionId: string;
+    timestamp: number;
+    chainId: number;
+    selectedTerm: number;
+    action: string;
+    signature: string;
+}
+/**
+ * Balance Confirmation Authorization Interface
+ * For permissionless balance confirmation with quantum security
+ */
+export interface BalanceConfirmationAuthorization {
+    positionId: string;
+    timestamp: number;
+    chainId: number;
+    caller: string;
+    action: string;
+    signature: string;
+}
+/**
+ * Generate payment authorization signature
+ *
+ * Creates a signature that matches the format expected by
+ * process-payment-validator LIT Action.
+ *
+ * Message structure:
+ * solidityKeccak256(
+ *   ["bytes32", "uint256", "uint256", "uint256", "bytes32"],
+ *   [positionId, timestamp, chainId, amount, actionHash]
+ * )
+ *
+ * Where:
+ * - actionHash = keccak256("make-payment")
+ * - Signer address is recovered from signature by LIT Action
+ * - LIT Action validates recovered address === position owner
+ */
+export declare function generatePaymentAuthorization(positionId: string, amount: bigint, chainId: number, signer: ethers5.Signer): Promise<PaymentOwnerAuthorization>;
+/**
+ * Generate extend position authorization signature
+ *
+ * Creates a signature that matches the format expected by
+ * extend-position-validator LIT Action.
+ *
+ * Message structure:
+ * solidityKeccak256(
+ *   ["bytes32", "uint256", "uint256", "uint256", "bytes32"],
+ *   [positionId, timestamp, chainId, selectedTerm, actionHash]
+ * )
+ *
+ * Where:
+ * - actionHash = keccak256("extend-position")
+ * - Signer address is recovered from signature by LIT Action
+ * - LIT Action validates recovered address === position owner
+ */
+export declare function generateExtendAuthorization(positionId: string, selectedTerm: number, chainId: number, signer: ethers5.Signer): Promise<ExtendOwnerAuthorization>;
+/**
+ * Get PKP public key from PKP token ID
+ *
+ * Queries the PKP NFT contract on the Chipotle LIT chain (Chronicle Yellowstone, chainId 175188).
+ *
+ * @param pkpTokenId - PKP token ID (bytes32 hex string)
+ * @param provider - Ethereum provider (optional; reused if already on the correct LIT chain)
+ * @param pkpNftContractAddress - PKP NFT contract address (required)
+ * @returns PKP public key as hex string with '0x' prefix
+ */
+export declare function getPKPPublicKeyFromTokenId(pkpTokenId: string, provider?: ethers5.providers.Provider, pkpNftContractAddress?: string): Promise<string>;
+/**
+ * Withdraw Owner Authorization Interface (matches lit-actions)
+ */
+export interface WithdrawOwnerAuthorization {
+    positionId: string;
+    timestamp: number;
+    chainId: number;
+    amount: string;
+    action: string;
+    signature: string;
+}
+/**
+ * Build the withdraw authorization message hash without signing.
+ *
+ * Use this when signing with a smart contract wallet (e.g. Safe) that
+ * needs to wrap the hash in its own domain before signing.
+ *
+ * @param positionId - Position identifier
+ * @param amount - Amount to withdraw in satoshis (bigint)
+ * @param chainId - Chain ID for cross-chain replay protection
+ * @param destinationAddress - Bitcoin destination address
+ * @returns { hash, timestamp } — pass these to Safe for signing
+ */
+export declare function buildWithdrawAuthorizationHash(positionId: string, amount: bigint, chainId: number, destinationAddress: string): {
+    hash: string;
+    timestamp: number;
+};
+/**
+ * Generate withdrawal authorization signature
+ *
+ * Creates a signature that matches the format expected by
+ * AuthorizationModule.verifyWithdrawAuthorization in lit-actions.
+ *
+ * Message structure:
+ * solidityKeccak256(
+ *   ["bytes32", "uint256", "uint256", "uint256", "string", "bytes32"],
+ *   [positionId, timestamp, chainId, amount, destinationAddress, actionHash]
+ * )
+ *
+ * Where:
+ * - actionHash = keccak256("withdraw-btc")
+ * - Signer address is recovered from signature by LIT Action
+ * - LIT Action validates recovered address === position owner
+ *
+ * @param positionId - Position identifier
+ * @param amount - Amount to withdraw in satoshis (bigint)
+ * @param chainId - Chain ID for cross-chain replay protection
+ * @param signerOrPrecomputed - Either an ethers Signer (EOA) or { timestamp, signature } for smart contract wallets
+ * @param destinationAddress - Bitcoin address for withdrawal
+ * @returns Authorization object with signature
+ */
+export declare function generateWithdrawAuthorization(positionId: string, amount: bigint, // satoshis
+chainId: number, signerOrPrecomputed: ethers5.Signer | {
+    timestamp: number;
+    signature: string;
+}, destinationAddress: string): Promise<WithdrawOwnerAuthorization>;
+/**
+ * Generate balance confirmation authorization signature
+ *
+ * Creates a signature for permissionless balance confirmation with quantum security.
+ * Unlike mint/payment (owner-signed), this is signed by the caller (anyone).
+ *
+ * Message structure:
+ * solidityKeccak256(
+ *   ["bytes32", "uint256", "uint256", "address", "bytes32"],
+ *   [positionId, timestamp, chainId, caller, actionHash]
+ * )
+ *
+ * Where:
+ * - actionHash = keccak256("confirm-balance")
+ * - Signer is the caller (anyone can call permissionlessly)
+ * - Quantum timestamp validates timing security
+ *
+ * @param positionId - Position identifier
+ * @param chainId - Chain ID for cross-chain replay protection
+ * @param signer - Ethereum signer to sign with (the caller)
+ * @returns Authorization object with signature
+ */
+export declare function generateBalanceConfirmationAuthorization(positionId: string, chainId: number, signer: ethers5.Signer): Promise<BalanceConfirmationAuthorization>;

package/dist/utils/quantum-timing.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Quantum Timing Utility
+ *
+ * Shared utility for calculating valid quantum timestamps across SDK, tests, and lit-ops.
+ *
+ * NEW QUANTUM PROTOCOL (60-second 3-window system):
+ * - SDK signs for NEXT quantum immediately (no waiting)
+ * - 60-second quantum windows
+ * - 3-quantum validation (past, current, next) = 180s total validity
+ * - Dead zones: first 8s and last 8s of each quantum
+ * - Users can operate once per 60 seconds per position
+ *
+ * Architecture:
+ * - SDK uses this to calculate NEXT quantum immediately
+ * - Tests use this to generate valid timestamps
+ * - LIT Actions validate 3-quantum window with dead zone protection
+ */
+/**
+ * Calculate a valid quantum timestamp for NEXT quantum (NO WAITING)
+ *
+ * NEW 60-second quantum system:
+ * - Returns NEXT quantum boundary immediately
+ * - No waiting for optimal moment
+ * - Signature valid for 180 seconds (3 quantums: PAST, CURRENT, NEXT)
+ * - User can sign immediately, operation executes within 3-quantum window
+ *
+ * @returns Promise<number> - Next quantum boundary timestamp
+ */
+export declare function calculateValidQuantumTimestamp(): Promise<number>;
+/**
+ * Check if a timestamp is in the safe work zone (outside dead zones)
+ *
+ * @param timestamp - Unix timestamp to check
+ * @returns boolean - True if in safe zone (8-52s of any quantum)
+ */
+export declare function isInSafeWorkZone(timestamp: number): boolean;
+/**
+ * Get current quantum without waiting
+ *
+ * @returns number - Current quantum timestamp
+ */
+export declare function getCurrentQuantum(): number;
+/**
+ * Get seconds remaining in current quantum
+ *
+ * @returns number - Seconds until quantum expires
+ */
+export declare function getSecondsUntilQuantumExpiry(): number;
+/**
+ * Calculate next quantum timestamp WITHOUT waiting (60-second system)
+ *
+ * Returns NEXT quantum boundary immediately.
+ * No waiting, no optimal moment calculation.
+ * Signature valid for 180 seconds (3 quantums).
+ *
+ * @returns number - Next quantum boundary timestamp
+ */
+export declare function calculateNextQuantumTimestamp(): number;
+/**
+ * Wait until specific timestamp is reached
+ *
+ * @param targetTimestamp - Unix timestamp to wait for
+ */
+export declare function waitUntilTimestamp(targetTimestamp: number): Promise<void>;
+/**
+ * Validate quantum timing (60-second 3-quantum system)
+ *
+ * Validates that a signed timestamp falls within valid 3-quantum window.
+ * With 60-second quantums, signatures are valid for 180 seconds (PAST, CURRENT, NEXT).
+ *
+ * @param signedTimestamp - Timestamp that was signed by user
+ * @param bufferSeconds - Unused in new system (kept for API compatibility)
+ * @throws Error if timestamp is invalid
+ */
+export declare function validateQuantumTiming(signedTimestamp: number, _bufferSeconds?: number): void;

package/dist/utils/signature-tempering.utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Signature Tempering Utility
+ *
+ * Security testing tool to intentionally corrupt signatures
+ * to prove that smart contracts properly validate and reject invalid signatures.
+ *
+ * WARNING: This is for TESTING ONLY. Tempered signatures will cause transactions to FAIL.
+ */
+/**
+ * Tempers a signature by modifying the 3rd character with a random valid hex character
+ * that differs from the original.
+ *
+ * @param signature - Original signature (0x prefixed hex string)
+ * @returns Tempered signature with 3rd character modified
+ *
+ * @example
+ * const original = "0x1234567890abcdef...";
+ * const tempered = temperSignature(original);
+ * // tempered = "0x12X4567890abcdef..." where X != 3
+ */
+export declare function temperSignature(signature: string): string;
+/**
+ * Conditionally tempers a signature based on config flag.
+ * Returns original signature if tempering is disabled.
+ *
+ * @param signature - Original signature
+ * @param shouldTemper - Whether to apply tempering
+ * @param operationName - Name of operation for logging (optional)
+ * @returns Original or tempered signature
+ */
+export declare function maybeTemperSignature(signature: string, shouldTemper: boolean | undefined, operationName?: string): string;

package/dist/utils/telegram-messaging.utils.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Telegram Messaging Utilities
+ *
+ * Provides functionality to send messages to Telegram chats using the node-telegram-bot-api package
+ */
+/**
+ * Send a message to a Telegram chat
+ *
+ * @param chatId - Telegram chat ID
+ * @param chatToken - Telegram bot token
+ * @param message - Message to send
+ * @param threadId - Optional thread ID for message threads in groups
+ * @returns Promise that resolves when message is sent, or rejects on error
+ */
+export declare function sendTelegramMessage(chatId: string, chatToken: string, message: string, threadId?: number): Promise<void>;
+/**
+ * Format a mint notification message
+ *
+ * @param mintAmount - Amount minted in UCD
+ * @param loanId - Position/loan ID
+ * @param txHash - Transaction hash
+ * @returns Formatted message string
+ */
+export declare function formatMintMessage(mintAmount: number | string, loanId: string, txHash: string): string;
+/**
+ * Format a partial payment notification message
+ *
+ * @param paymentAmount - Amount repaid in UCD
+ * @param loanId - Position/loan ID
+ * @param txHash - Transaction hash
+ * @returns Formatted message string
+ */
+export declare function formatPartialPaymentMessage(paymentAmount: number | string, loanId: string, txHash: string): string;
+/**
+ * Format a BTC withdrawal notification message
+ *
+ * @param withdrawalAmount - Amount withdrawn in BTC
+ * @param vaultAddress - Bitcoin vault address
+ * @param loanId - Position/loan ID
+ * @param destinationAddress - Bitcoin destination address
+ * @returns Formatted message string
+ */
+export declare function formatWithdrawalMessage(withdrawalAmount: number | string, vaultAddress: string, loanId: string, destinationAddress: string): string;
+/**
+ * Format a mint failure notification message
+ *
+ * @param mintAmount - Amount that failed to be minted in UCD
+ * @param loanId - Position/loan ID
+ * @returns Formatted message string
+ */
+export declare function formatMintFailureMessage(mintAmount: number | string, loanId: string): string;
+/**
+ * Format a partial payment failure notification message
+ *
+ * @param paymentAmount - Amount that failed to be repaid in UCD
+ * @param loanId - Position/loan ID
+ * @param txHash - Optional transaction hash if available
+ * @returns Formatted message string
+ */
+export declare function formatPartialPaymentFailureMessage(paymentAmount: number | string, loanId: string, txHash?: string): string;
+/**
+ * Format a loan creation notification message
+ *
+ * @param positionId - Position/loan ID
+ * @param pkpId - PKP token ID
+ * @param vaultAddress - Regtest BTC vault address
+ * @returns Formatted message string
+ */
+export declare function formatLoanCreationMessage(positionId: string, pkpId: string, vaultAddress?: string): string;
+/**
+ * Format a loan creation failure notification message
+ *
+ * @param error - Error description
+ * @returns Formatted message string
+ */
+export declare function formatLoanCreationFailureMessage(error: string): string;
+/**
+ * Format a BTC withdrawal notification message
+ *
+ * @param withdrawalAmount - Amount withdrawn in BTC
+ * @param loanId - Position/loan ID
+ * @param btcTxHash - Bitcoin transaction hash
+ * @returns Formatted message string
+ */
+export declare function formatBTCWithdrawalMessage(withdrawalAmount: number | string, loanId: string, btcTxHash: string): string;
+/**
+ * Format a BTC withdrawal failure notification message
+ *
+ * @param withdrawalAmount - Amount that failed to be withdrawn in BTC
+ * @param btcVault - Bitcoin vault address
+ * @param btcDestinationAddress - Bitcoin destination address
+ * @param loanId - Position/loan ID
+ * @returns Formatted message string
+ */
+export declare function formatBTCWithdrawalFailureMessage(withdrawalAmount: number | string, btcVault: string, btcDestinationAddress: string, loanId: string): string;
+/**
+ * Format a loan renewal success notification message
+ *
+ * @param positionId - Position/loan ID
+ * @param txHash - Transaction hash
+ * @returns Formatted message string
+ */
+export declare function formatLoanRenewalMessage(positionId: string, txHash: string): string;
+/**
+ * Format a loan renewal failure notification message
+ *
+ * @param loanId - Position/loan ID
+ * @param error - Error description
+ * @returns Formatted message string
+ */
+export declare function formatLoanRenewalFailureMessage(loanId: string, error: string): string;
+/**
+ * Format a balance confirmation success notification message
+ *
+ * @param loanId - Position/loan ID
+ * @returns Formatted message string
+ */
+export declare function formatBalanceConfirmationMessage(loanId: string): string;
+/**
+ * Format a balance confirmation failure notification message
+ *
+ * @param loanId - Position/loan ID
+ * @returns Formatted message string
+ */
+export declare function formatBalanceConfirmationFailureMessage(loanId: string): string;
+/**
+ * Format a BTC withdrawal success notification message
+ *
+ * @param withdrawalAmount - Amount withdrawn in BTC
+ * @param btcVault - Bitcoin vault address
+ * @param btcDestinationAddress - Bitcoin destination address
+ * @param loanId - Position/loan ID
+ * @returns Formatted message string
+ */
+export declare function formatBTCWithdrawalSuccessMessage(withdrawalAmount: number | string, btcVault: string, btcDestinationAddress: string, loanId: string): string;
+/**
+ * Format a liquidation skipped notification message
+ *
+ * @param loanId - Position/loan ID
+ * @param ratio - Current collateral ratio (as percentage)
+ * @param threshold - Liquidation threshold (as percentage)
+ * @param btcVault - Bitcoin vault address
+ * @param btcVaultBalance - BTC vault balance
+ * @param ucdDebt - UCD debt amount
+ * @param btcPrice - Current BTC price
+ * @returns Formatted message string
+ */
+export declare function formatLiquidationSkippedMessage(loanId: string, ratio: number | string, threshold: number | string, btcVault: string, btcVaultBalance: string, ucdDebt: string, btcPrice: string): string;
+/**
+ * Format a liquidation success notification message
+ *
+ * @param loanId - Position/loan ID
+ * @param ratio - Current collateral ratio (as percentage)
+ * @param threshold - Liquidation threshold (as percentage)
+ * @param btcVault - Bitcoin vault address
+ * @param btcVaultBalance - BTC vault balance
+ * @param ucdDebt - UCD debt amount
+ * @param btcPrice - Current BTC price
+ * @returns Formatted message string
+ */
+export declare function formatLiquidationSuccessMessage(loanId: string, ratio: number | string, threshold: number | string, btcVault: string, btcVaultBalance: string, ucdDebt: string, btcPrice: string): string;
+/**
+ * Format BTC price from satoshi value to readable USD format
+ *
+ * @param btcPriceSats - BTC price in satoshis (8 decimals)
+ * @returns Formatted BTC price string
+ */
+export declare function formatBTCPrice(btcPriceSats: string | number): string;
+/**
+ * Format BTC amount to readable BTC format
+ * Accepts either satoshi values (converts to BTC) or already formatted BTC values
+ *
+ * @param btcAmount - BTC amount in satoshis or already in BTC format
+ * @returns Formatted BTC amount string
+ */
+export declare function formatBTCAmount(btcAmount: string | number): string;
+/**
+ * Format a liquidation failure notification message
+ *
+ * @param loanId - Position/loan ID
+ * @param errorMessage - Error message describing the failure
+ * @param btcVault - Bitcoin vault address
+ * @param btcVaultBalance - BTC vault balance
+ * @param ucdDebt - UCD debt amount
+ * @param btcPrice - Current BTC price
+ * @returns Formatted message string
+ */
+export declare function formatLiquidationFailureMessage(loanId: string, errorMessage: string, btcVault: string, btcVaultBalance: string, ucdDebt: string, btcPrice: string): string;