fix(i18n): reject format-incompatible translations

Many strings are used directly as printf/ImGui format strings, and translations
are loaded from user/installer-modifiable JSON with no validation. A translated
value that drops or changes a conversion specifier would be passed to printf with
mismatched varargs (undefined behavior) on a wallet screen.

overlayTranslations() now compares each translated value's argument signature
against the English source and keeps English on mismatch. Also adds the
send_status_unconfirmed string used by the deferred-send-result path.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-07 14:18:25 -05:00
parent 8f22db5eea
commit e00772db6e
2 changed files with 64 additions and 12 deletions

View File

@@ -26,6 +26,38 @@ namespace util {
using json = nlohmann::json;
namespace {
// Map a printf conversion char to its varargs argument class: 'i' (int-promoted), 'f'
// (double), 'p' (pointer/string). This is what matters for safety — reading a double slot
// as an int (or vice-versa) is undefined behavior; interchanging d/x is merely cosmetic.
char conversionClass(char c)
{
switch (c) {
case 'd': case 'i': case 'o': case 'u': case 'x': case 'X': case 'c': return 'i';
case 'f': case 'F': case 'e': case 'E': case 'g': case 'G': case 'a': case 'A': return 'f';
case 's': case 'p': return 'p';
default: return '?';
}
}
// Ordered argument signature of a printf-style format string (e.g. "%d / %.0f%%" -> "if").
// "%%" is a literal and contributes nothing.
std::string formatSignature(const std::string& s)
{
std::string sig;
for (size_t i = 0; i < s.size(); ++i) {
if (s[i] != '%') continue;
if (++i >= s.size()) break;
if (s[i] == '%') continue; // literal "%%"
while (i < s.size() && std::strchr("-+ #0123456789.*lhLzjtq", s[i])) ++i;
if (i < s.size()) sig.push_back(conversionClass(s[i]));
}
return sig;
}
} // namespace
I18n::I18n()
{
// Register built-in languages
@@ -51,6 +83,27 @@ I18n& I18n::instance()
return instance;
}
void I18n::overlayTranslations(const nlohmann::json& translations)
{
for (auto& [key, value] : translations.items()) {
if (!value.is_string()) continue;
const std::string translated = value.get<std::string>();
// If the English base for this key carries printf specifiers, the translation must
// keep the same argument signature — otherwise it would be passed to printf/ImGui
// with mismatched varargs (UB). On mismatch, keep the safe English string.
const auto base = strings_.find(key);
if (base != strings_.end()) {
const std::string baseSig = formatSignature(base->second);
if (!baseSig.empty() && baseSig != formatSignature(translated)) {
DEBUG_LOGF("i18n: dropping '%s' — format mismatch (\"%s\" vs English)\n",
key.c_str(), translated.c_str());
continue;
}
}
strings_[key] = translated;
}
}
bool I18n::loadLanguage(const std::string& locale)
{
// Try to load from file: CWD-relative first, then exe-relative
@@ -72,11 +125,7 @@ bool I18n::loadLanguage(const std::string& locale)
} else {
strings_.clear();
}
for (auto& [key, value] : j.items()) {
if (value.is_string()) {
strings_[key] = value.get<std::string>();
}
}
overlayTranslations(j);
current_locale_ = locale;
DEBUG_LOGF("Loaded language file: %s (%zu strings)\n", lang_file.c_str(), strings_.size());
@@ -128,12 +177,8 @@ bool I18n::loadLanguage(const std::string& locale)
} else {
strings_.clear();
}
for (auto& [key, value] : j.items()) {
if (value.is_string()) {
strings_[key] = value.get<std::string>();
}
}
overlayTranslations(j);
current_locale_ = locale;
DEBUG_LOGF("Loaded embedded language: %s (%zu strings)\n", locale.c_str(), strings_.size());
return true;
@@ -1199,6 +1244,7 @@ void I18n::loadBuiltinEnglish()
strings_["send_tx_failed"] = "Transaction failed";
strings_["send_tx_sent"] = "Transaction sent!";
strings_["send_tx_success"] = "Transaction sent successfully!";
strings_["send_status_unconfirmed"] = "Transaction status could not be confirmed";
strings_["send_txid_copied"] = "TxID copied to clipboard";
strings_["send_txid_label"] = "TxID: %s";
strings_["send_valid_shielded"] = "Valid shielded address";

View File

@@ -7,6 +7,7 @@
#include <string>
#include <unordered_map>
#include <vector>
#include <nlohmann/json_fwd.hpp>
namespace dragonx {
namespace util {
@@ -58,7 +59,12 @@ public:
private:
I18n();
void loadBuiltinEnglish();
// Overlay translated strings onto the English base, but reject any value whose printf
// format-specifier signature differs from the English source (keep English instead).
// Many strings are used directly as printf/ImGui format strings, so a mismatched
// translation (dropped/changed specifier) is undefined behavior — this prevents it.
void overlayTranslations(const nlohmann::json& translations);
std::string current_locale_ = "en";
std::unordered_map<std::string, std::string> strings_;
std::vector<std::pair<std::string, std::string>> available_languages_;