@ninsei-labs/sdk 0.39.0

package/engine/evm/amounts.js

@@ -0,0 +1,131 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/amounts.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.
+
+// Пересчёт балансов из «сырых» единиц контракта в человекочитаемые.
+//
+// Отдельным модулем, потому что это денежная математика и её надо проверять без браузера:
+// правильность decimals - самая частая ошибка EVM-кошельков (у USDT/USDC на BSC их 18, а не 6),
+// а цена ошибки - баланс, отличающийся на 10^12. Проверка живёт в tools/validate.mjs (npm test),
+// поэтому она гоняется и в CI, и локально.
+
+// BigInt (сырые единицы) -> число с точкой.
+//
+// Делим как Number, а не целочисленно: вариант "raw * 1e6 / 10^dec" съедал мелкие значения -
+// 55000 wei при 18 decimals превращались ровно в 0, и демка показывала пустой баланс там, где
+// деньги есть (поймано проверкой на конкретных числах). Точности double достаточно: 15-16
+// значащих цифр против 6 знаков после точки, которые показывает интерфейс.
+export function toHuman(raw, decimals) {
+  return Number(raw) / 10 ** decimals;
+}
+
+// Убирает хвостовые нули у строки с точкой: "12.180000" -> "12.18".
+// Точка обязательна: у "1000" хвостовые нули трогать нельзя.
+export function trimTrailingZeros(text) {
+  const s = String(text);
+  return s.includes(".") ? s.replace(/0+$/, "").replace(/\.$/, "") : s;
+}
+
+// Сумма для показа и для кнопки MAX: усечение (не округление) и не больше 6 знаков после точки.
+//
+// Почему усечение: MAX не имеет права подставить сумму больше реального баланса - иначе форма
+// справедливо ответит "Not enough ...", и кнопка MAX приведёт в тупик. Округление вверх как раз
+// это и делало: 0.0399187 -> 0.039919 > баланса.
+// Почему 6 знаков: человеческая точность, и ровно столько же показывает подсказка с балансом.
+// Возвращает ЧИСЛО (для сравнений); строку для поля ввода даёт amountInputValue ниже.
+export function floorAmount(value, decimals = 6) {
+  const n = Number(value);
+  if (!Number.isFinite(n) || n <= 0) return 0;
+  const scaled = Math.floor(n * 10 ** decimals);
+  if (scaled > 0) return scaled / 10 ** decimals;
+  // Меньше 10^-decimals: это пыль. Отдаём значение целиком (точность до 18 знаков), чтобы
+  // MAX не подставил 0.0000001 вместо 0.000000123 - то есть не отбросил баланс почти целиком.
+  return Math.floor(n * 1e18) / 1e18;
+}
+
+// Строка для поля ввода и для подсказки с балансом: одна и та же функция, поэтому MAX
+// подставляет ровно то число, которое видит пользователь.
+//
+// toFixed, а не String(): String(1.23e-7) даёт "1e-7", а поле ввода принимает только цифры
+// и точку - "1e-7" превратилось бы в "17" (это поймано проверкой, а не пользователем).
+export function amountInputValue(value, decimals = 6) {
+  // Сначала усекаем, потом форматируем: toFixed САМ округляет, и без усечения получалось
+  // 0.039919 - то есть больше баланса, и MAX упирался в "Not enough ...".
+  const cut = floorAmount(value, decimals);
+  if (!Number.isFinite(cut) || cut <= 0) return "0";
+  // Для пыли печатаем все знаки: иначе toFixed округлил бы до первого ненулевого разряда.
+  const d = cut >= 10 ** -decimals ? decimals : 18;
+  return trimTrailingZeros(cut.toFixed(d));
+}
+
+// Набор случаев для проверки: [сырое значение, decimals, ожидаемое].
+// 6 decimals - USDT/USDC на Ethereum, Arbitrum, Base; 18 - на BNB Chain и у нативных токенов.
+// Ожидания сверены арифметикой вручную: 1 единица при 18 decimals это 1e-18, поэтому
+// 55000 wei - это 5.5e-14, а не 0.000055 (последнее - это 5.5e13 wei).
+export const AMOUNT_CASES = [
+  [12345678900n, 6, 12345.6789], // USDC, 6 decimals
+  [108275582n, 6, 108.275582], // реальный баланс, снятый с Arbitrum
+  [10n ** 18n, 18, 1], // 1 ETH
+  [1500000000000000000n, 18, 1.5], // 1.5 ETH
+  [55000000000000n, 18, 0.000055], // 0.000055 ETH - на экране видно, но старое округление врало
+  [55000n, 18, 5.5e-14], // пыль: старая формула давала ровно 0 (тихая потеря)
+  [3120000000000000000000n, 18, 3120], // 3120 BNB
+  [0n, 18, 0], // пустой кошелёк
+];
+
+// Случаи для показа баланса и MAX: [баланс, ожидаемая строка].
+// Первый - ровно то, на что жаловался пользователь: 0.03991877164758065 попадало в поле целиком.
+export const MAX_CASES = [
+  [0.03991877164758065, "0.039918"], // тот самый ETH: 6 знаков, как в подсказке
+  [0.0399187, "0.039918"], // усечение вниз, а не округление вверх до 0.039919
+  [12431.18, "12431.18"], // стейбл: хвостовых нулей нет
+  [3.4125, "3.4125"],
+  [1, "1"],
+  [0.000000123, "0.000000123"], // пыль: ни нуля, ни экспоненты "1e-7"
+  [0, "0"],
+];
+
+export const TRIM_CASES = [
+  ["12,431.180000", "12,431.18"],
+  ["0.039918", "0.039918"],
+  ["1.000000", "1"],
+  ["1000", "1000"],
+  ["0.000000", "0"],
+];
+
+// Поле ввода принимает только цифры и точку (см. oninput в swapForm.js). Если строка этому
+// не удовлетворяет, поле молча превратит её в другое число - поэтому проверяем и это.
+const INPUT_PATTERN = /^[0-9]+(\.[0-9]+)?$/;
+
+export function checkAmounts({ tolerance = 1e-9 } = {}) {
+  const failures = [];
+
+  for (const [raw, decimals, expected] of AMOUNT_CASES) {
+    const got = toHuman(raw, decimals);
+    if (!Number.isFinite(got) || Math.abs(got - expected) > tolerance) {
+      failures.push(`${raw} при ${decimals} decimals -> ${got}, ожидалось ${expected}`);
+    }
+  }
+
+  for (const [balance, expected] of MAX_CASES) {
+    const got = amountInputValue(balance);
+    if (got !== expected) {
+      failures.push(`MAX при балансе ${balance} -> "${got}", ожидалось "${expected}"`);
+    }
+    if (!INPUT_PATTERN.test(got)) {
+      failures.push(`MAX при балансе ${balance} дал "${got}" - поле ввода такое значение исказит`);
+    }
+    // Главное свойство MAX: подставленная сумма НЕ больше баланса.
+    if (floorAmount(balance) > balance) {
+      failures.push(`MAX при балансе ${balance} подставил больше баланса: ${floorAmount(balance)}`);
+    }
+  }
+
+  for (const [input, expected] of TRIM_CASES) {
+    const got = trimTrailingZeros(input);
+    if (got !== expected) failures.push(`показ баланса "${input}" -> "${got}", ожидалось "${expected}"`);
+  }
+
+  return failures;
+}

package/engine/evm/auth.js

@@ -0,0 +1,156 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/auth.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.
+
+// ВХОД ПО ПОДПИСИ КОШЕЛЬКА И СПИСОК СДЕЛОК НА СЕРВЕРЕ.
+//
+// Зачем. Пока записи о сделках живут только в localStorage, "мой список" привязан к браузеру: очистили
+// данные сайта, открыли с другого устройства - список пуст, хотя деньги в эскроу на месте. Серверный
+// список снимает это ограничение, а привязка к адресу кошелька не даёт видеть чужое.
+//
+// ПОДПИСЬ, А НЕ ПРОСТО ПОДКЛЮЧЕНИЕ. Подключение кошелька - только канал связи. Доказательство владения
+// адресом даёт лишь подпись сообщения, и подписывать приходится КАЖДЫЙ РАЗ заново: пропуск живёт в
+// sessionStorage, то есть умирает вместе с вкладкой. Так решено сознательно: безопасность важнее удобства.
+//
+// ЧТО УХОДИТ НА СЕРВЕР И ЧТО НЕТ. Уходят только публичные поля: адрес эскроу, суммы, сроки, hashlock,
+// сеть, id сделки. СЕКРЕТ НЕ УХОДИТ НИКОГДА: он даёт право на деньги и остаётся в файле восстановления.
+// Сервер не сможет распорядиться средствами, даже если захочет, - у него нет ни ключей, ни секрета.
+//
+// ОТКАЗ СЕРВЕРА НЕ ЛОМАЕТ СДЕЛКУ. Синхронизация - удобство, а не условие: если она не удалась, сделка
+// продолжается на локальной записи, и об этом честно сказано в консоли. Хуже было бы наоборот.
+import { signMessage, address, isConnected } from "./session.js";
+
+const TOKEN_KEY = "arrakis.auth.token";
+const ADDR_KEY = "arrakis.auth.address";
+
+// Пропуск и адрес держим в sessionStorage: он переживает перезагрузку страницы, но исчезает вместе с
+// вкладкой - ровно то поведение, которое выбрано ("пока открыт браузер валидно").
+// СЕССИОННОЕ ХРАНИЛИЩЕ - СНАРУЖИ, как и хранилище состояния (www/js/core/store.js). В браузере это
+// sessionStorage, в проверках и в SDK - память: модуль обязан грузиться без DOM.
+const sessionAdapters = () => {
+  const store = typeof globalThis !== "undefined" ? globalThis.sessionStorage : undefined;
+  if (!store || typeof store.getItem !== "function") return null;
+  return {
+    get: (key) => store.getItem(key),
+    set: (key, value) => store.setItem(key, String(value)),
+    remove: (key) => store.removeItem(key),
+  };
+};
+const memoryStore = () => {
+  const map = new Map();
+  return { get: (key) => (map.has(key) ? map.get(key) : null), set: (key, value) => map.set(key, String(value)), remove: (key) => map.delete(key) };
+};
+let sessionStore = sessionAdapters() || memoryStore();
+
+/** Подменить сессионное хранилище: годится и sessionStorage, и память, и адаптер SDK. */
+export function setSessionStore(next) {
+  const ok = next && typeof next.get === "function" && typeof next.set === "function" && typeof next.remove === "function";
+  if (!ok) throw new Error("сессионное хранилище должно уметь get/set/remove");
+  sessionStore = next;
+  return sessionStore;
+}
+export const sessionStoreInUse = () => sessionStore;
+
+function readSession(key) { try { return sessionStore.get(key); } catch { return null; } }
+function writeSession(key, value) { try { value == null ? sessionStore.remove(key) : sessionStore.set(key, value); } catch { /* тишина намеренно: недоступное хранилище не должно ломать вход */ } }
+
+export function token() { return readSession(TOKEN_KEY); }
+export function authedAddress() { return readSession(ADDR_KEY); }
+export function forgetSession() { writeSession(TOKEN_KEY, null); writeSession(ADDR_KEY, null); }
+
+async function api(path, init = {}) {
+  const res = await fetch(path, init);
+  let body = null;
+  try { body = await res.json(); } catch { /* не JSON - ниже вернём как есть */ }
+  return { status: res.status, body };
+}
+
+// Вход: получаем одноразовое число, подписываем сообщение КОТОРОЕ ДАЛ СЕРВЕР (не своё: иначе расхождение
+// в одном символе давало бы "подпись не сходится" без объяснения) и обмениваем подпись на пропуск.
+export async function signIn() {
+  if (!isConnected()) throw new Error("сначала подключите кошелёк");
+  const nonce = await api("/api/auth/nonce");
+  if (nonce.status !== 200 || !nonce.body || !nonce.body.message) {
+    throw new Error("сервер не выдал сообщение для подписи (ответ " + nonce.status + ")");
+  }
+  const signature = await signMessage(nonce.body.message);
+  const verified = await api("/api/auth/verify", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ nonce: nonce.body.nonce, address: address(), signature }),
+  });
+  if (verified.status !== 200 || !verified.body || !verified.body.token) {
+    const why = verified.body && verified.body.error ? verified.body.error : "ответ " + verified.status;
+    throw new Error("вход не принят: " + why);
+  }
+  writeSession(TOKEN_KEY, verified.body.token);
+  writeSession(ADDR_KEY, verified.body.address);
+  return verified.body.address;
+}
+
+// Запрос с пропуском. При 401 пропуск мог истечь или сервер перезапуститься - пробуем один раз войти
+// заново, и только если и это не вышло, честно возвращаем отказ: молчаливое повторение подписи
+// раздражало бы кошелёк запросами без причины.
+async function authed(path, init = {}, retry = true) {
+  const t = token();
+  const headers = { ...(init.headers || {}) };
+  if (t) headers.authorization = "Bearer " + t;
+  const r = await api(path, { ...init, headers });
+  if (r.status === 401 && retry && isConnected()) {
+    forgetSession();
+    try { await signIn(); } catch (e) { return r; }
+    return authed(path, init, false);
+  }
+  return r;
+}
+
+// Отправить запись о сделке. Возвращает { ok, reason }: отказ не исключение, а факт, о котором вызывающий
+// решает сам - сделка из-за него прерываться не должна.
+export async function saveServerSwap(swap, network) {
+  const escrow = swap && swap.escrow && swap.escrow.address;
+  if (!escrow) return { ok: false, reason: "в записи нет адреса эскроу" };
+  if (!isConnected()) return { ok: false, reason: "кошелёк не подключён" };
+  try {
+    if (!token() || authedAddress() !== String(address()).toLowerCase()) { forgetSession(); await signIn(); }
+    const r = await authed("/api/evm-swaps", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        id: swap.id, network: network || swap.network || swap.chain, escrow,
+        // ССЫЛКА НА КОТИРОВКУ. По ней сервер и нода провайдера понимают, ЧЕЙ это ордер: без неё адрес эскроу
+        // остаётся ноде неизвестным, и забрать ETH она не сможет. Отсутствие поля не ошибка: старые записи
+        // и сделки без провайдера отправляются как есть.
+        quoteId: swap.orderQuoteId || null,
+        providerId: swap.providerId || null,
+        hashlock: (swap.escrow && swap.escrow.hashlock) || swap.hashlock || null,
+        amount: (swap.escrow && swap.escrow.amountWei) || swap.amountWei || null,
+        t0: swap.escrow && swap.escrow.t0 != null ? swap.escrow.t0 : null,
+        t1: swap.escrow && swap.escrow.t1 != null ? swap.escrow.t1 : null,
+      }),
+    });
+    if (r.status === 201 || r.status === 200) {
+      // СЕРВЕР ОТВЕЧАЕТ И ПРО ПРИВЯЗКУ КОТИРОВКИ. Без неё нода провайдера не заберёт ETH: её половина
+      // осталась бы невостребованной. Отказ привязки сделку не прерывает, но и молчать о нём нельзя -
+      // поэтому он уезжает вызывающему, а тот говорит в консоль.
+      return { ok: true, orderBinding: (r.body && r.body.orderBinding) || null };
+    }
+    const why = r.body && r.body.error ? r.body.error : "ответ " + r.status;
+    return { ok: false, reason: why };
+  } catch (e) {
+    return { ok: false, reason: String((e && e.message) || e) };
+  }
+}
+
+// Список сделок с сервера. Пустой результат и отказ - разные вещи, и вызывающий видит разницу.
+export async function loadServerSwaps() {
+  if (!isConnected()) return { ok: false, reason: "кошелёк не подключён", swaps: [] };
+  try {
+    if (!token()) await signIn();
+    const r = await authed("/api/evm-swaps");
+    if (r.status !== 200 || !r.body) return { ok: false, reason: "ответ " + r.status, swaps: [] };
+    return { ok: true, swaps: r.body.swaps || [] };
+  } catch (e) {
+    return { ok: false, reason: String((e && e.message) || e), swaps: [] };
+  }
+}

package/engine/evm/claimGas.js

@@ -0,0 +1,87 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/claimGas.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.
+
+// ГАЗ ЗАБОРА ПРИ ПРОДАЖЕ XMR (claim): ОДИН ИСТОЧНИК ПРАВДЫ ДЛЯ КЛИЕНТА И ДЛЯ НОДЫ (issue #127).
+//
+// СУТЬ. В обратном обмене человек отдаёт XMR и забирает ETH вызовом `claim` в сети расчёта. Своего ETH у
+// него нет, поэтому газ на claim ПРИСЫЛАЕТ НОДА (issue #78, rfq/reverseGas.mjs). Но правила газа жили в
+// ДВУХ местах: страница/SDK отправляли claim с пределом 250 000 и комиссией `2 x baseFee + 1 gwei`
+// (движок сделки теперь в пакете: sdk/src/swap-flow.mjs; www/js/evm/session.js), а нода считала подарок как `eth_gasPrice x 120 000`
+// (rfq/reverseGas.mjs). Числа расходились примерно в 100 раз, и человек с одним подарком claim отправить
+// не мог: узел принимает транзакцию, только если на балансе есть `gasLimit x maxFeePerGas`, а подарка на
+// это не хватало. Теперь оба числа считает ЭТОТ модуль.
+//
+// ПОЧЕМУ ОТДЕЛЬНЫЙ МОДУЛЬ И ПОЧЕМУ ПОД www/js. Формула обязана быть ОДНА. Её читает и страница/SDK
+// (движок живёт под www/js), и нода - rfq/reverseGas.mjs, а rfq уже импортирует из www/js (см.
+// rfq/payoutFee.mjs, `../www/js/core/format.js`). Обратный импорт невозможен: боевой веб-корень - www/,
+// каталог rfq/ браузеру не отдаётся. Поэтому единственный общий дом - www/js/evm/.
+//
+// ЧТО ЗДЕСЬ ОДНО. Предел газа claim, правило комиссии (2 x baseFee + чаевые) и РАЗМЕР ПОДАРКА - та же
+// стоимость claim плюс ЯВНЫЙ ЗАПАС на рост базовой цены между выдачей билета и забором. Второго расчёта
+// размера подарка нет ни у ноды, ни у прогонов: они зовут claimGasGiftWei отсюда.
+
+// ПРЕДЕЛ ГАЗА CLAIM - ОДНО ЧИСЛО НА ОБЕИХ СТОРОНАХ. Это тот же предел, с которым нода подписывает свой
+// claim в rfq/payout.mjs, и тот же, что отправляет страница/SDK (sdk/src/swap-flow.mjs). Число не
+// выдумано: живой прогон меряет фактический gasUsed забора сверху (tools/live-gas-run.mjs).
+export const CLAIM_GAS_LIMIT = 120_000n;
+
+// ПОЛ ЧАЕВЫХ - ПОЛИТИКА СЕТИ, А НЕ КОНСТАНТА В КОДЕ ОТПРАВКИ. Раньше session.js ставил минимум 1 gwei
+// ВСЕГДА. На сети с дешёвым газом (Arbitrum One: baseFee ~0.02 gwei) это раздувало maxFeePerGas примерно
+// в 50 раз и поднимало ТРЕБУЕМЫЙ БАЛАНС пропорционально - то есть ломало ровно того, кому газ и
+// предназначен. Для Arbitrum чаевые не нужны: пол 0. Сеть со своей политикой передаёт minTipWei
+// аргументом (session.js берёт сеть из реестра, www/js/core/config.js).
+export const CLAIM_TIP_FLOOR_WEI = 0n;
+
+const toBig = (v) => {
+  if (v === null || v === undefined || v === "") return null;
+  try { return BigInt(typeof v === "bigint" ? v : String(v)); } catch { return null; }
+};
+
+// КОМИССИЯ ЗАБОРА (EIP-1559): `maxFeePerGas = 2 x baseFee + чаевые`. Удвоение базовой цены перекрывает её
+// рост за время подтверждения СВОЕЙ транзакции; чаевые - это разница gasPrice - baseFee (её отдаёт любая
+// цепь), не ниже пола сети. baseFee = 0 (сеть без EIP-1559) - полей комиссии нет вовсе, и это null, а не
+// ноль: неизвестное обязано называться, а не выдаваться за измеренное.
+export function claimMaxFeePerGasWei({ baseFeeWei, priorityFeeWei = 0n, minTipWei = CLAIM_TIP_FLOOR_WEI } = {}) {
+  const base = toBig(baseFeeWei);
+  if (base === null || base <= 0n) return null;
+  const prio = toBig(priorityFeeWei);
+  const floor = toBig(minTipWei);
+  const floored = floor === null || floor < 0n ? 0n : floor;
+  const tip = prio !== null && prio > floored ? prio : floored;
+  return base * 2n + tip;
+}
+
+// СКОЛЬКО НУЖНО НА БАЛАНСЕ ДЛЯ CLAIM - это же правило приёма транзакции узлом: `gasLimit x maxFeePerGas`.
+// Один из множителей не измерен - null (не «ноль газа»).
+export function claimRequiredWei({ gasLimit = CLAIM_GAS_LIMIT, maxFeePerGasWei } = {}) {
+  const limit = toBig(gasLimit);
+  const maxFee = toBig(maxFeePerGasWei);
+  if (limit === null || limit <= 0n || maxFee === null || maxFee <= 0n) return null;
+  return limit * maxFee;
+}
+
+// ЗАПАС НА РОСТ БАЗОВОЙ ЦЕНЫ МЕЖДУ ВЫДАЧЕЙ БИЛЕТА И ЗАБОРОМ, в базисных пунктах (10 000 = +100%).
+//
+// ПОЧЕМУ ОН НУЖЕН И ПОЧЕМУ СТОЛЬКО. Стоимость claim считается на момент БИЛЕТА, а сам claim случается
+// позже: билет живёт RFQ_ORDER_QUOTE_TTL_MS, по умолчанию 40 минут (rfq/config.mjs). Правило клиента
+// (2 x baseFee) перекрывает рост цены ТОЛЬКО на время подтверждения своей транзакции, а не эти 40 минут.
+// Подарок без запаса не проходит, если базовая цена хоть немного поднялась с момента билета - это и
+// показал issue #127. +100% перекрывает УДВОЕНИЕ базовой цены за окно билета, то есть подарок остаётся
+// достаточным, даже если цена газа к забору вырастет вдвое. Значение - настройка ноды
+// (RFQ_REVERSE_GAS_RESERVE_BPS), а не догадка: её видно и можно переопределить без правки кода.
+export const DEFAULT_GIFT_RESERVE_BPS = 10_000n;
+
+// РАЗМЕР ПОДАРКА - ТА ЖЕ стоимость claim, что требует клиент, ПЛЮС запас. Это ЕДИНСТВЕННЫЙ расчёт размера
+// подарка: нода (rfq/reverseGas.mjs, requiredGasWei) и живой прогон зовут ИМЕННО ЕГО, а не свою копию.
+// base берётся у цепи на момент билета; priorityFeeWei - реальные чаевые сети (gasPrice - baseFee), если
+// известны. Нечитаемая база - null, а не ноль.
+export function claimGasGiftWei({ baseFeeWei, priorityFeeWei, minTipWei, gasLimit = CLAIM_GAS_LIMIT, reserveBps = DEFAULT_GIFT_RESERVE_BPS } = {}) {
+  const maxFee = claimMaxFeePerGasWei({ baseFeeWei, priorityFeeWei, minTipWei });
+  const need = claimRequiredWei({ gasLimit, maxFeePerGasWei: maxFee });
+  if (need === null) return null;
+  const bps = toBig(reserveBps);
+  const step = bps === null || bps < 0n ? 0n : bps;
+  return need + (need * step) / 10_000n;
+}

package/engine/evm/depositor.js

@@ -0,0 +1,127 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/depositor.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.
+
+// ВНОСЯЩИЙ ПО ПОДПИСИ, КЛИЕНТСКАЯ СТОРОНА (issue #97, часть C): EIP-712 typed data над ДАЙДЖЕСТОМ КОТИРОВКИ.
+//
+// ЗАЧЕМ. Часть A дала фабрике путь `createOrderAndFundByDepositor`: транзакцию вправе отправить КТО УГОДНО
+// (релейщик, наш сервис), но вносившим записывается тот, кто подписал дайджест котировки. Чтобы релейщик
+// мог отправить транзакцию, вносящий обязан сперва подписать. Подпись кошелька - это typed data, а не
+// транзакция: она не стоит газа и не двигает деньги, поэтому человек БЕЗ своего ETH тоже может её дать.
+//
+// ПОЧЕМУ ФОРМА ЗДЕСЬ, А НЕ ВЫДУМАНА. Набор полей и домен - ЧАСТЬ ПРОТОКОЛА: тот же OrderQuote, что
+// проверяет эскроу (mvp/contracts/OrderQuote.sol) и подписывает нода (rfq/lib/quoteEip712Spec.mjs,
+// sdk/src/quoteEip712Spec.mjs). Перестановка двух полей даёт ДРУГОЙ дайджест, подпись восстанавливается в
+// чужой адрес, и фабрика отказывает `BadDepositorSignature`. Поэтому форма лежит ОДНИМ списком ниже, а
+// проверка (tools/check-usdc-without-eth.mjs) считает этой формой дайджест и сверяет его с дайджестом,
+// посчитанным СПЕКОЙ ноды/SDK на той же котировке - разойтись молча они не могут.
+//
+// ДОМЕН. verifyingContract - АДРЕС ФАБРИКИ ИЗ САМОЙ КОТИРОВКИ (поле `factory`), chainId - живой из котировки:
+// подпись, сделанная для другой фабрики или сети, здесь не восстановится. Второго источника домена нет.
+//
+// ЧЕГО ЗДЕСЬ НЕТ. Криптографии: дайджест считает КОШЕЛЁК (eth_signTypedData_v4), а не этот модуль. Здесь -
+// только форма и её проверка, чтобы кошелёк подписал ровно то, что проверит цепь.
+
+// Имя и версия домена - протокол котировок v8, дословно как в OrderQuote.sol.
+export const DEPOSITOR_DOMAIN_NAME = "NinseiEscrowFactory";
+export const DEPOSITOR_DOMAIN_VERSION = "1";
+
+// НАБОР ПОЛЕЙ В ПОРЯДКЕ КОНТРАКТА. Порядок - часть ABI: перестановка даёт другой дайджест. Список один -
+// из него строится и строка типа, и сообщение, разойтись им нечем.
+export const ORDER_QUOTE_TYPED_FIELDS = [
+  ["provider", "address"],
+  ["quoteKey", "address"],
+  ["registry", "address"],
+  ["cashier", "address"],
+  ["locker", "address"],
+  ["claimer", "address"],
+  ["amount", "uint256"],
+  ["readyBy", "uint64"],
+  ["t1", "uint64"],
+  ["salt", "bytes32"],
+  ["commitHalfClaimer", "bytes32"],
+  ["edPointClaimer", "bytes32"],
+  ["chainId", "uint256"],
+  ["feeBps", "uint256"],
+  ["fee", "uint256"],
+  ["feeRecipient", "address"],
+  ["validUntil", "uint64"],
+  ["nonce", "uint256"],
+  // THE XMR SIDE OF THE DEAL (#110 step 3), in atomic units: it joined the signed set together with the contract
+  // (OrderQuote.sol), the node/SDK spec and the vector, so the depositor's signature covers the same XMR the chain
+  // verifies. A field the chain could not see used to stay OUT of this list on purpose - that is no longer the case.
+  ["xmrAmount", "uint256"],
+];
+
+// Тип сообщения. Собирается из списка: правка списка меняет и тип, и подпись - то есть не может остаться
+// незамеченной, в отличие от второго литерала рядом.
+export const ORDER_QUOTE_TYPED_TYPE = "OrderQuote(" + ORDER_QUOTE_TYPED_FIELDS.map(([n, t]) => t + " " + n).join(",") + ")";
+
+const isHex = (v, bytes) => new RegExp("^(0x)?[0-9a-fA-F]{" + bytes * 2 + "}$").test(String(v === undefined || v === null ? "" : v).trim());
+const isNum = (v) => /^(0x[0-9a-fA-F]+|[0-9]+)$/.test(String(v === undefined || v === null ? "" : v).trim());
+
+// ФОРМА ПРИВОДИТСЯ, А НЕ ТРЕБУЕТСЯ. Точки ed25519 котировка несёт БЕЗ префикса 0x (так их пишет нода),
+// а кошелёк и контракт ждут одинаковые БАЙТЫ. Поэтому приводим к одному виду здесь, на границе, и
+// отвергаем всё, что не адрес/не bytes32/не число: молчаливое выравнивание нулями ушло бы ДРУГИМ значением.
+function normaliseField(name, type, value) {
+  const raw = String(value === undefined || value === null ? "" : value).trim();
+  if (raw === "") throw new Error("котировка не несёт поля для подписи вносящего: " + name);
+  if (type === "address") {
+    if (!isHex(raw, 20)) throw new Error("поле " + name + " - не адрес: " + raw);
+    return "0x" + raw.replace(/^0x/, "").toLowerCase();
+  }
+  if (type === "bytes32") {
+    if (!isHex(raw, 32)) throw new Error("поле " + name + " - не bytes32: " + raw);
+    return "0x" + raw.replace(/^0x/, "").toLowerCase();
+  }
+  // uint64 / uint256: кошелёк принимает строку; десятичную и hex-форму даёт один и тот же разбор.
+  if (!isNum(raw)) throw new Error("поле " + name + " - не число: " + raw);
+  return String(BigInt(raw));
+}
+
+/**
+ * EIP-712 typed data, которое подписывает вносящий (eth_signTypedData_v4).
+ * Домен строится ИЗ КОТИРОВКИ: verifyingContract = quote.factory, chainId = quote.chainId.
+ * @returns {{ domain: object, types: object, primaryType: string, message: object }}
+ */
+export function orderQuoteTypedData(quote) {
+  if (!quote || typeof quote !== "object") throw new Error("нет подписанной котировки: подписывать нечего");
+  if (!isHex(quote.factory, 20)) throw new Error("в котировке нет адреса фабрики (factory) - домен подписи не собрать");
+  if (!isNum(quote.chainId)) throw new Error("в котировке нет chainId - домен подписи не собрать");
+  const message = {};
+  for (const [name, type] of ORDER_QUOTE_TYPED_FIELDS) {
+    message[name] = normaliseField(name, type, quote[name]);
+  }
+  return {
+    domain: {
+      name: DEPOSITOR_DOMAIN_NAME,
+      version: DEPOSITOR_DOMAIN_VERSION,
+      chainId: Number(BigInt(quote.chainId)),
+      verifyingContract: "0x" + String(quote.factory).replace(/^0x/, "").toLowerCase(),
+    },
+    types: {
+      // EIP712Domain явно: кошельки показывают его человеку, и он обязан совпасть с тем, что считает цепь.
+      EIP712Domain: [
+        { name: "name", type: "string" },
+        { name: "version", type: "string" },
+        { name: "chainId", type: "uint256" },
+        { name: "verifyingContract", type: "address" },
+      ],
+      OrderQuote: ORDER_QUOTE_TYPED_FIELDS.map(([name, type]) => ({ name, type })),
+    },
+    primaryType: "OrderQuote",
+    message,
+  };
+}
+
+// ПОДПИСЬ НА ПРОВОДЕ - 65 БАЙТ r || s || v. Проверяем форму ЗДЕСЬ: фабрика принимает подпись тремя словами,
+// и «похожая на подпись» строка не должна уехать в контракт как согласие.
+export function depositorSignatureShape(signature) {
+  const hex = String(signature === undefined || signature === null ? "" : signature).replace(/^0x/, "");
+  if (!/^[0-9a-fA-F]{130}$/.test(hex)) return { ok: false, reason: "подпись вносящего обязана быть 65 байт (r || s || v), а пришло " + hex.length / 2 + " байт" };
+  let v = parseInt(hex.slice(128, 130), 16);
+  if (v < 27) v += 27;
+  if (v !== 27 && v !== 28) return { ok: false, reason: "v подписи вносящего вне {27,28}: " + v };
+  return { ok: true, r: "0x" + hex.slice(0, 64).toLowerCase(), s: "0x" + hex.slice(64, 128).toLowerCase(), v: 27 + (v - 27) };
+}