@ninsei-labs/sdk 0.39.0

package/engine/core/finality.js

@@ -0,0 +1,93 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/core/finality.js for the SDK package.
+// Edit the source under www/js, then run: node tools/build-sdk-engine.mjs
+// tools/check-sdk-engine.mjs reddens on any drift, so a stale copy cannot ship silently.
+// Everything below this header is identical to the source.
+
+// ЗРЕЛОСТЬ СОСТОЯНИЯ ПО СЕТЯМ: на каком уровне цепь признаёт запись окончательной.
+//
+// ЗАЧЕМ ОТДЕЛЬНАЯ ТАБЛИЦА. Сети отличаются и временем блока, и смыслом тегов. Замер 28.09.2026 по живым
+// узлам (те самые адреса, что в настройках):
+//   arbitrum          0.267 с/блок  safe отстаёт ≈12.6 мин  finalized ≈19.6 мин
+//   arbitrum-sepolia  0.252 с/блок  safe ≈8.6 мин           finalized ≈14.9 мин
+//   mainnet          12.060 с/блок  safe ≈11.8 мин          finalized ≈18.2 мин
+//   base              2.000 с/блок  safe ≈0.4 мин           finalized ≈25.1 мин
+//   bsc               0.450 с/блок  safe и finalized отстают на 0-1 блок
+//   monad             0.302 с/блок  то же
+//   hyperevm          0.984 с/блок  то же
+// Отсюда два вывода, на которых стоит таблица:
+//   1) одно значение на все сети неверно: на base safe стоит 25 секунд, на arbitrum - 13 минут;
+//   2) на bsc, monad и hyperevm теги ФОРМАЛЬНЫ: они отвечают, но отставания нет, то есть "читать по
+//      finalized" там выглядит защитой, а защиты не даёт. Пустышку опаснее отсутствия тега: отсутствие
+//      видно, а пустышка молчит. Поэтому там - числовая глубина с НАЗВАННЫМ риском.
+//
+// ЭТА КОПИЯ - ДЛЯ СТРАНИЦЫ: она обслуживает все сети сразу, поэтому таблица нужна ей целиком.
+// Такая же таблица живёт у служб (rfq/finality.mjs); совпадение копий проверяет страж tools/check-finality.mjs,
+// потому что общего модуля у страницы и у служб быть не может.
+//
+// ОБЛАСТЬ ПРИМЕНЕНИЯ. Таблица отвечает на один вопрос: когда состояние EVM-стороны считается достаточно
+// зрелым, чтобы принять по нему НЕОБРАТИМОЕ решение - отправить XMR. Показ состояния на странице живёт по
+// latest и этой таблицей не ограничен.
+export const FINALITY = {
+  // ТЕГ ОСМЫСЛЕН: отставание измерено и названо.
+  "arbitrum-sepolia": { mode: "tag", tag: "safe", costSec: 520, reason: "тег осмыслен: отставание ≈8.6 мин (замер)" },
+  "arbitrum": { mode: "tag", tag: "safe", costSec: 760, reason: "тег осмыслен: отставание ≈12.6 мин (замер)" },
+  "mainnet": { mode: "tag", tag: "safe", costSec: 710, reason: "тег осмыслен: отставание ≈11.8 мин (замер)" },
+  "base": { mode: "tag", tag: "safe", costSec: 25, reason: "safe и осмыслен, и быстр: ≈25 с (замер)" },
+
+  // ТЕГ ПУСТЫШКА: формально отвечает, отставания нет. Числовая глубина - с названной ценой риска.
+  "bsc": { mode: "depth", depth: 15, costSec: 7, reason: "теги формальны (отставание 0-1 блок, замер): глубина ВЫБРАНА, а не измерена - риск назван" },
+  "monad": { mode: "depth", depth: 12, costSec: 4, reason: "теги формальны (отставание 0-1 блок, замер): глубина выбрана" },
+  "hyperevm": { mode: "depth", depth: 12, costSec: 12, reason: "теги формальны (отставание 0-1 блок, замер): глубина выбрана" },
+};
+
+// СЕТЬ НЕ ОПИСАНА - ГОВОРИМ ОБ ЭТОМ, А НЕ ПОДСТАВЛЯЕМ МОЛЧА. Глубина 12 - прежнее общее значение, и оно
+// честнее пустого места: решение принимается, но цена риска названа как неизмеренная.
+export const DEFAULT_FINALITY = {
+  mode: "depth", depth: 12, costSec: 0,
+  reason: "сеть не описана в таблице: берём общую глубину, риск не измерен",
+};
+
+export function finalityFor(network) {
+  return FINALITY[network] || DEFAULT_FINALITY;
+}
+
+// Сколько эта сеть заставляет ждать перед необратимым решением - в секундах. Складывать с окнами сделки
+// (readyBy, t1) обязан тот, кто эти окна назначает: окно, которое короче ожидания, убивает сделку.
+export function finalityWaitSec(network) {
+  return Number(finalityFor(network).costSec || 0);
+}
+
+// ЧТО СКАЗАТЬ ЧЕЛОВЕКУ. Строка для экрана: уровень и цена ожидания словами, без чисел-обманок.
+export function finalityNote(network) {
+  const f = finalityFor(network);
+  if (f.mode === "tag") {
+    const min = Math.max(1, Math.round(f.costSec / 60));
+    return "ждём уровень " + f.tag + ": это ≈" + min + " мин";
+  }
+  return "ждём " + f.depth + " подтверждений: это ≈" + Math.max(1, Math.round(f.costSec)) + " с";
+}
+
+// ЗНАЧОК ПРОВАЙДЕРА ДЛЯ СПИСКА. Короткий: человек решает, кого выбрать, и цена ожидания - часть выбора.
+// Свой замер важнее слов провайдера: если его уровень назван тегом, берём измеренную цену из таблицы.
+export function finalityBadge(policy) {
+  if (!policy) return "finality not stated";
+  if (policy.mode === "tag") {
+    const known = Object.values(FINALITY).find((f) => f.mode === "tag" && f.tag === policy.tag);
+    const cost = Number(policy.costSec || (known && known.costSec) || 0);
+    return cost >= 60 ? policy.tag + " · ≈" + Math.round(cost / 60) + " мин" : policy.tag + " · ≈" + Math.round(cost) + " с";
+  }
+  const d = Number(policy.depth || 0);
+  const cost = Number(policy.costSec || d * (FINALITY[Object.keys(FINALITY)[0]] ? 0.3 : 0.3) || 0);
+  return d + " блоков · ≈" + Math.max(1, Math.round(cost)) + " с";
+}
+
+// ОКНА ОРДЕРА ПО УРОВНЮ ПРОВАЙДЕРА. Окно короче ожидания убивает сделку: отметка готовности не успевает
+// попасть в контракт, и сделка распадается. Поэтому окна считаются от цены ожидания, а не берутся числом.
+// ЧИСЛА - РЕШЕНИЕ ВЛАДЕЛЬЦА (issue #88): при ПОКУПКЕ окно готовности 4 часа (человек должен успеть увидеть
+// XMR и отметиться), а окно забора ПОСЛЕ readyBy - 1 час; формула ниже держит именно эту разницу: claim на час
+// позже ready. При продаже сроки назначает нода (rfq/reverseOrder.mjs), там окно 1 час.
+export function orderWindows(policy, base = { readyWindowSeconds: 14400, claimWindowSeconds: 3600 }) {
+  const wait = Number((policy && policy.costSec) || 0);
+  const ready = Math.max(base.readyWindowSeconds, wait + 900);         // запас на внос и на дорогу транзакции
+  return { readyWindowSeconds: ready, claimWindowSeconds: Math.max(base.claimWindowSeconds, ready + 3600) };
+}

package/engine/core/format.js

@@ -0,0 +1,168 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/core/format.js for the SDK package.
+// Edit the source under www/js, then run: node tools/build-sdk-engine.mjs
+// tools/check-sdk-engine.mjs reddens on any drift, so a stale copy cannot ship silently.
+// Everything below this header is identical to the source.
+
+// Форматирование чисел, времени и адресов.
+
+const nf = (min, max) => new Intl.NumberFormat("en-US", { minimumFractionDigits: min, maximumFractionDigits: max });
+
+export function amount(v, dp = 2) {
+  const n = Number(v);
+  if (!isFinite(n)) return "-";
+  const max = Math.min(dp, 6);
+  // ПЫЛЬ НЕ ИСЧЕЗАЕТ. Раньше печать была жёстко «шесть знаков», и сумма меньше 0.000001 показывалась как
+  // 0.000000 - то есть ненулевое значение выглядело нулём. Для денег это худший вид отображения: человек
+  // видит ноль там, где у него что-то есть. Знаки добавляются ровно в том случае, когда печать обнулила
+  // ненулевое, и не больше 18 (предел точности wei).
+  if (n !== 0 && Math.abs(n) < Math.pow(10, -max)) {
+    const need = Math.min(18, Math.max(max + 1, -Math.floor(Math.log10(Math.abs(n)))));
+    return nf(need, need).format(n).replace(/(\.\d*?)0+$/, "$1").replace(/\.$/, "");
+  }
+  return nf(max, max).format(n);
+}
+
+
+export function usd(v) {
+  const n = Number(v);
+  if (!isFinite(n)) return "-";
+  return "$" + nf(0, Math.abs(n) < 100 ? 2 : 0).format(n);
+}
+
+export function pct(v, dp = 2) {
+  return (Number(v) * 100).toFixed(dp) + "%";
+}
+
+export function compact(v) {
+  const n = Number(v);
+  if (!isFinite(n)) return "-";
+  if (Math.abs(n) >= 1e9) return (n / 1e9).toFixed(2) + "B";
+  if (Math.abs(n) >= 1e6) return (n / 1e6).toFixed(2) + "M";
+  if (Math.abs(n) >= 1e3) return (n / 1e3).toFixed(1) + "K";
+  return String(Math.round(n));
+}
+
+export function shortHash(h, head = 6, tail = 4) {
+  if (!h) return "-";
+  const s = String(h);
+  if (s.length <= head + tail + 2) return s;
+  return s.slice(0, head) + "..." + s.slice(-tail);
+}
+
+// sim-время -> настенные часы демки (UTC, как в макетах литпепера)
+export function clockTime(ms) {
+  const d = new Date(ms);
+  const hh = String(d.getUTCHours()).padStart(2, "0");
+  const mm = String(d.getUTCMinutes()).padStart(2, "0");
+  const ss = String(d.getUTCSeconds()).padStart(2, "0");
+  return `${hh}:${mm}:${ss}`;
+}
+
+export function clockTimeShort(ms) {
+  return clockTime(ms).slice(0, 5);
+}
+
+// Длительность в секундах -> "12m 30s"
+export function duration(ms) {
+  const total = Math.max(0, Math.round(ms / 1000));
+  const m = Math.floor(total / 60);
+  const s = total % 60;
+  if (m === 0) return `${s}s`;
+  return `${m}m ${String(s).padStart(2, "0")}s`;
+}
+
+export function countdown(ms) {
+  const total = Math.max(0, Math.round(ms / 1000));
+  const h = Math.floor(total / 3600);
+  const m = Math.floor((total % 3600) / 60);
+  const s = total % 60;
+  const pad = (x) => String(x).padStart(2, "0");
+  return h > 0 ? `${h}:${pad(m)}:${pad(s)}` : `${pad(m)}:${pad(s)}`;
+}
+
+export function dateTime(iso) {
+  if (!iso) return "-";
+  const d = new Date(iso);
+  return d.toISOString().replace("T", " ").slice(0, 19) + " UTC";
+}
+
+export function randomHex(bytes = 16) {
+  const a = new Uint8Array(bytes);
+  crypto.getRandomValues(a);
+  return toHex(a);
+}
+
+// Байты (Uint8Array/Buffer) -> hex-строка без префикса 0x.
+export function toHex(bytes) {
+  const a = bytes instanceof Uint8Array ? bytes : Uint8Array.from(bytes || []);
+  return Array.from(a, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+// РАЗБОР СУММЫ, КОТОРУЮ ВВЁЛ ЧЕЛОВЕК.
+//
+// ПОЧЕМУ ЭТО ОТДЕЛЬНАЯ ФУНКЦИЯ, А НЕ replace ПРЯМО В ПОЛЕ. В полях суммы стояло
+// `e.target.value.replace(/[^0-9.]/g, "")`: всё, кроме цифр и точки, СТИРАЛОСЬ. Европейская запятая
+// ("0,05" - так пишут в половине стран) превращалась в "005", то есть в 5 - ошибка в СТО РАЗ, и заметить её
+// в интерфейсе почти невозможно: поле показывает "005", котировка считается по пяти, человек платит в сто
+// раз больше. Запятая без точки - десятичный разделитель, запятая при наличии точки - разделитель тысяч;
+// так же это делают кошельки Monero.
+//
+// Возвращает КАНОНИЧЕСКУЮ строку (только цифры и максимум одна точка). Именно её видно в поле и именно её
+// парсит остальной код - поэтому «что написано» и «что посчитано» не могут разойтись.
+export function normalizeAmountInput(raw) {
+  let s = String(raw == null ? "" : raw).trim().replace(/[^0-9.,]/g, "");
+  if (s.includes(".")) {
+    // Точка есть - запятые разделяют тысячи ("1,234.5" -> "1234.5").
+    s = s.replace(/,/g, "");
+  } else if (s.includes(",")) {
+    // Одна запятая без точки - десятичный разделитель ("0,05" -> "0.05"). Всё, что стоит ПОСЛЕ второй
+    // запятой, отбрасываем: угадывать, что "1,2,3" значило 123, значит на опечатке увеличить платёж в сто раз.
+    const i = s.indexOf(",");
+    const rest = s.slice(i + 1);
+    const cut = rest.indexOf(",");
+    s = s.slice(0, i) + "." + (cut < 0 ? rest : rest.slice(0, cut));
+  }
+  // Вторая точка - тоже опечатка, и хвост за ней отбрасывается, а не склеивается с числом ("1.2.3" -> "1.2").
+  const dot = s.indexOf(".");
+  if (dot >= 0) {
+    const rest = s.slice(dot + 1);
+    const cut = rest.indexOf(".");
+    s = s.slice(0, dot + 1) + (cut < 0 ? rest : rest.slice(0, cut));
+  }
+  s = s.replace(/^0+(?=\d)/, "");                     // "005" -> "5", но "0.5" не трогаем
+  if (!/[0-9]/.test(s)) return "";
+  return s;
+}
+
+/** Число из введённого человеком или null, если числа там нет. Никаких «догадок»: пусто - значит пусто. */
+export function parseAmount(raw) {
+  const s = normalizeAmountInput(raw);
+  if (!s) return null;
+  const n = Number(s);
+  return Number.isFinite(n) ? n : null;
+}
+
+export function shortId() {
+  // 16 hex-символов (8 байт = 2^64). Раньше было 4 символа (randomHex(2)): при 100 000 сделок совпадение
+  // практически неизбежно - 68.8% на 8 символах и 100% на 4, - а id служит ключом в состоянии и именем файла
+  // восстановления, поэтому совпадение означало бы потерю записи, за которой стоят средства.
+  // ВАЖНО: у уже созданных сделок id остаются короткими. Переименовывать их нельзя: id лежит в файле
+  // восстановления, в ссылках и в состоянии - они бы разъехались.
+  return randomHex(8);
+}
+
+// БЫСТРАЯ ПРИКИДКА ФОРМЫ Monero-адреса: base58, длина 95 (обычный) / 106 (integrated), префикс сети.
+//
+// ЧЕГО ЭТА ФУНКЦИЯ НЕ ДЕЛАЕТ: НЕ ПРОВЕРЯЕТ КОНТРОЛЬНУЮ СУММУ. Любая опечатка внутри адреса пройдёт здесь
+// незамеченной. Раньше она называлась isValidMoneroAddress - и это имя было ловушкой: функция, которую
+// зовут "проверкой адреса", но которая пропускает опечатку, рано или поздно попадает на путь денег.
+//
+// НАСТОЯЩАЯ ПРОВЕРКА - checkAddress() из ../monero/address.js: формат + разбор base58 + keccak256-контрольная
+// сумма + совпадение сети. Именно её зовёт форма. Здесь - только чтобы отсеять явный мусор до тяжёлого разбора.
+export function looksLikeMoneroAddress(addr) {
+  const a = String(addr || "").trim();
+  if (![95, 106].includes(a.length)) return false;
+  if (!/^[1-9A-HJ-NP-Za-km-z]+$/.test(a)) return false;
+  return ["4", "5", "7", "8", "9", "A", "B"].includes(a[0]);
+}
+