Валюта

Читання основної валюти з налаштувань застосунку та конвертація сум за тими ж курсами, що використовує основний застосунок. Додаткові дозволи не потрібні.

Курси завантажуються та оновлюються головним процесом (Config.data.CURRENCY_RATES). Конвертація виконується через спільний хелпер ConvertCurrencyShared (проміжна валюта — USD).

currency.getCurrent()

Повертає код валюти, обраної в Налаштування → Основні → Валюта.

const res = await currency.getCurrent();
if (res.success) {
  console.log('Валюта користувача:', res.currency); // наприклад "USD", "EUR", "UAH"
}

Повертає { success: true, currency }, де currency — CurrencyCode (наприклад USD, EUR, RUB).

currency.getList()

Повертає всі відомі валюти масивом об'єктів { key, name } (англійські назви). Порядок збігається з вибором в основних налаштуваннях: спочатку основні валюти (USD, EUR, UAH, RUB, BYN, PLN), потім за алфавітом.

const res = await currency.getList();
if (res.success) {
  console.log(res.currencies[0]); // { key: 'USD', name: 'United States Dollar' }
  for (const { key, name } of res.currencies) {
    console.log(key, name);
  }
}

Повертає { success: true, currencies }, де в кожного запису:

currency.convert(amount, from, to)

Конвертує числову суму між двома валютами.

const res = await currency.convert(100, 'USD', 'EUR');
if (res.success) {
  console.log('Сконвертовано:', res.amount);
}

Повертає { success: true, amount } зі сконвертованим значенням або { success: false, message? }, коли:

• amount не є скінченним числом
• один із кодів валюти невідомий
• курс для однієї з валют дорівнює нулю або недоступний (наприклад CHEER)

Приклад: донат у валюті користувача

events.On('onDonation', async ({ body }) => {
  const { amount, currency: from } = body;
  const current = await currency.getCurrent();
  if (!current.success) {
    return;
  }

  if (from === current.currency) {
    console.log(`${amount} ${from}`);
    return;
  }

  const converted = await currency.convert(amount, from, current.currency);
  if (converted.success) {
    console.log(`${amount} ${from} (${converted.amount} ${current.currency})`);
  }
});