/**
 * Address Conversion Utilities
 * Provides safe address conversion and validation with clear error messages
 */
/**
 * Safely convert a string to bytes32 with clear error handling
 * @param value String value to convert
 * @param fieldName Name of the field for error messages
 * @returns bytes32 string
 * @throws Clear error message if conversion fails
 */
export declare function safeHexZeroPad(value: string, fieldName?: string): string;
/**
 * Safely get Bitcoin addresses from PKP with retry and clear error handling
 * @param pkpId PKP ID to derive addresses from
 * @param maxRetries Maximum number of retries (default: 3)
 * @returns Bitcoin addresses for all networks
 * @throws Clear error message if derivation fails
 */
export declare function safeGetBitcoinAddressesFromPkp(pkpId: string, maxRetries?: number): Promise<{
    mainnet: string;
    testnet: string;
    regtest: string;
}>;
/**
 * Safely validate and format a Bitcoin address
 * @param address Bitcoin address to validate
 * @param network Network type for validation
 * @returns Validated address
 * @throws Clear error message if validation fails
 */
export declare function safeValidateBitcoinAddress(address: string, network?: 'mainnet' | 'testnet' | 'regtest'): string;
/**
 * Safely parse and validate a position ID
 * @param positionId Position ID to validate
 * @returns Validated position ID
 * @throws Clear error message if validation fails
 */
export declare function safeValidatePositionId(positionId: string): string;
