LBUSD Translator

Purpose & User Intent: The LBUSD Translator is a currency conversion and pricing tool that converts LBUSD amounts to USD using reference rate data, aimed at traders, developers, and analysts who need fiat valuations for LBUSD-denominated assets or transactions. Core logic centers on accurate rate application and auditable outputs for pricing, invoicing, and financial modeling. When a user needs to price LBUSD-denominated assets, settle invoices in USD, or build pricing modules, this tool delivers a deterministic, verifiable conversion pipeline.
Core Logic & Features: It supports real-time rate retrieval with a cache fallback, computes LBUSD × USD rate, supports up to 6 decimals, allows optional fee adjustments and different rounding modes, and exposes the rate used, timestamp, and validity in the output. Required inputs include amount_lb (LBUSD), rate_source (e.g., live or cache), and target_currency (USD). Advanced features include historical rate view, multiple rate sources, and unit normalization for large values to ensure consistent accounting.
Inputs & Outputs: Inputs: amount_lb (number, LBUSD, required), rate_source (string, optional, default 'live'), decimals (int, optional, 0-6), include_fees (boolean, optional). Outputs: amount_usd (number, USD), rate (number, USD per LBUSD), timestamp (ISO 8601), validity (boolean). Validation: amount_lb ≥ 0; decimals in 0-6; rate_source must be recognised; if live feed fails, fall back to cached value.
Algorithms & Calculations: amount_usd = amount_lb × rate; apply rounding to specified decimals; if include_fees, apply fee factor; ensure precise handling of floating-point to decimal conversions. Reference: standard crypto price feeds and typical FX pricers.
Error & Edge Cases: Missing inputs or negative values result in invalid; rate fetch failure triggers fallback; currency pair mismatch triggers error; out-of-range amounts trigger clamping.
Industry/Region & Localization: Prices expressed in USD; uses ISO currency codes; supports international decimals; applies currency formatting rules when exporting.
Assumptions & Exclusions: Assumes LBUSD is a traded token with a published USD rate; not responsible for cross-currency arbitrage; excludes UI-specific messaging; inputs must be numeric.