@ninsei-labs/sdk 0.39.3 → 0.40.0-develop.1

package/engine/evm/auth.js

@@ -1,33 +1,28 @@
 // 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.
+// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
 // Everything below this header is identical to the source.
 
-// ВХОД ПО ПОДПИСИ КОШЕЛЬКА И СПИСОК СДЕЛОК НА СЕРВЕРЕ.
+// WALLET-SIGNATURE LOGIN AND THE SERVER-SIDE SWAP LIST.
+// Why: while swap records live only in localStorage, "my list" is tied to the browser. A server-side list
+// fixes that; binding it to the wallet address keeps other people's swaps hidden.
 //
-// Зачем. Пока записи о сделках живут только в localStorage, "мой список" привязан к браузеру: очистили
-// данные сайта, открыли с другого устройства - список пуст, хотя деньги в эскроу на месте. Серверный
-// список снимает это ограничение, а привязка к адресу кошелька не даёт видеть чужое.
+// A SIGNATURE, NOT JUST A CONNECTION. Connecting is only a channel. Proving you own the address needs a
+// message signature, re-done every time: the pass lives in sessionStorage and dies with the tab.
 //
-// ПОДПИСЬ, А НЕ ПРОСТО ПОДКЛЮЧЕНИЕ. Подключение кошелька - только канал связи. Доказательство владения
-// адресом даёт лишь подпись сообщения, и подписывать приходится КАЖДЫЙ РАЗ заново: пропуск живёт в
-// sessionStorage, то есть умирает вместе с вкладкой. Так решено сознательно: безопасность важнее удобства.
+// WHAT GOES TO THE SERVER AND WHAT DOES NOT. Only public fields: escrow address, amounts, deadlines,
+// hashlock, network, swap id. THE SECRET NEVER GOES: it grants the money and stays in the recovery file.
 //
-// ЧТО УХОДИТ НА СЕРВЕР И ЧТО НЕТ. Уходят только публичные поля: адрес эскроу, суммы, сроки, hashlock,
-// сеть, id сделки. СЕКРЕТ НЕ УХОДИТ НИКОГДА: он даёт право на деньги и остаётся в файле восстановления.
-// Сервер не сможет распорядиться средствами, даже если захочет, - у него нет ни ключей, ни секрета.
-//
-// ОТКАЗ СЕРВЕРА НЕ ЛОМАЕТ СДЕЛКУ. Синхронизация - удобство, а не условие: если она не удалась, сделка
-// продолжается на локальной записи, и об этом честно сказано в консоли. Хуже было бы наоборот.
+// A SERVER REFUSAL DOES NOT BREAK THE SWAP: sync is a convenience, and on failure the swap continues on
+// the local record (said honestly in the console).
 import { signMessage, address, isConnected } from "./session.js";
 
-const TOKEN_KEY = "arrakis.auth.token";
-const ADDR_KEY = "arrakis.auth.address";
+const TOKEN_KEY = "ninsei.auth.token";
+const ADDR_KEY = "ninsei.auth.address";
 
-// Пропуск и адрес держим в sessionStorage: он переживает перезагрузку страницы, но исчезает вместе с
-// вкладкой - ровно то поведение, которое выбрано ("пока открыт браузер валидно").
-// СЕССИОННОЕ ХРАНИЛИЩЕ - СНАРУЖИ, как и хранилище состояния (www/js/core/store.js). В браузере это
-// sessionStorage, в проверках и в SDK - память: модуль обязан грузиться без DOM.
+// The pass and the address live in sessionStorage: it survives a reload but dies with the tab - exactly the
+// chosen behaviour ("valid while the browser is open"). SESSION STORAGE COMES FROM OUTSIDE, like the state
+// store (www/js/core/store.js): sessionStorage in the browser, memory in the checks and the SDK - the module
+// must load without a DOM.
 const sessionAdapters = () => {
   const store = typeof globalThis !== "undefined" ? globalThis.sessionStorage : undefined;
   if (!store || typeof store.getItem !== "function") return null;
@@ -43,17 +38,17 @@ const memoryStore = () => {
 };
 let sessionStore = sessionAdapters() || memoryStore();
 
-/** Подменить сессионное хранилище: годится и sessionStorage, и память, и адаптер SDK. */
+/** Swap the session storage: sessionStorage, memory or an SDK adapter all qualify. */
 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");
+  if (!ok) throw new Error("session storage must support 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 { /* тишина намеренно: недоступное хранилище не должно ломать вход */ } }
+function writeSession(key, value) { try { value == null ? sessionStore.remove(key) : sessionStore.set(key, value); } catch { /* silence on purpose: an unavailable store must not break login */ } }
 
 export function token() { return readSession(TOKEN_KEY); }
 export function authedAddress() { return readSession(ADDR_KEY); }
@@ -62,17 +57,17 @@ export function forgetSession() { writeSession(TOKEN_KEY, null); writeSession(AD
 async function api(path, init = {}) {
   const res = await fetch(path, init);
   let body = null;
-  try { body = await res.json(); } catch { /* не JSON - ниже вернём как есть */ }
+  try { body = await res.json(); } catch { /* not JSON - returned as is below */ }
   return { status: res.status, body };
 }
 
-// Вход: получаем одноразовое число, подписываем сообщение КОТОРОЕ ДАЛ СЕРВЕР (не своё: иначе расхождение
-// в одном символе давало бы "подпись не сходится" без объяснения) и обмениваем подпись на пропуск.
+// Login: get a one-time number, sign the message GIVEN BY THE SERVER (not our own: a one-char mismatch
+// would give "signature does not match" with no explanation) and exchange the signature for a pass.
 export async function signIn() {
-  if (!isConnected()) throw new Error("сначала подключите кошелёк");
+  if (!isConnected()) throw new Error("connect the wallet first");
   const nonce = await api("/api/auth/nonce");
   if (nonce.status !== 200 || !nonce.body || !nonce.body.message) {
-    throw new Error("сервер не выдал сообщение для подписи (ответ " + nonce.status + ")");
+    throw new Error("the server did not issue a message to sign (response " + nonce.status + ")");
   }
   const signature = await signMessage(nonce.body.message);
   const verified = await api("/api/auth/verify", {
@@ -81,17 +76,16 @@ export async function signIn() {
     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);
+    const why = verified.body && verified.body.error ? verified.body.error : "response " + verified.status;
+    throw new Error("login not accepted: " + why);
   }
   writeSession(TOKEN_KEY, verified.body.token);
   writeSession(ADDR_KEY, verified.body.address);
   return verified.body.address;
 }
 
-// Запрос с пропуском. При 401 пропуск мог истечь или сервер перезапуститься - пробуем один раз войти
-// заново, и только если и это не вышло, честно возвращаем отказ: молчаливое повторение подписи
-// раздражало бы кошелёк запросами без причины.
+// A request with the pass. On 401 the pass may have expired or the server restarted - try to log in once
+// more, and only if that also fails return the refusal honestly: silent re-signing would spam the wallet.
 async function authed(path, init = {}, retry = true) {
   const t = token();
   const headers = { ...(init.headers || {}) };
@@ -105,12 +99,12 @@ async function authed(path, init = {}, retry = true) {
   return r;
 }
 
-// Отправить запись о сделке. Возвращает { ok, reason }: отказ не исключение, а факт, о котором вызывающий
-// решает сам - сделка из-за него прерываться не должна.
+// Send a swap record. Returns { ok, reason }: a refusal is a fact, not an exception, and the caller
+// decides - the swap must not abort because of it.
 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: "кошелёк не подключён" };
+  if (!escrow) return { ok: false, reason: "the record has no escrow address" };
+  if (!isConnected()) return { ok: false, reason: "wallet not connected" };
   try {
     if (!token() || authedAddress() !== String(address()).toLowerCase()) { forgetSession(); await signIn(); }
     const r = await authed("/api/evm-swaps", {
@@ -118,9 +112,9 @@ export async function saveServerSwap(swap, network) {
       headers: { "content-type": "application/json" },
       body: JSON.stringify({
         id: swap.id, network: network || swap.network || swap.chain, escrow,
-        // ССЫЛКА НА КОТИРОВКУ. По ней сервер и нода провайдера понимают, ЧЕЙ это ордер: без неё адрес эскроу
-        // остаётся ноде неизвестным, и забрать ETH она не сможет. Отсутствие поля не ошибка: старые записи
-        // и сделки без провайдера отправляются как есть.
+      // QUOTE REFERENCE. Through it the server and the provider node know WHOSE order this is: without it
+      // the escrow address stays unknown to the node and it cannot claim the ETH. A missing field is not
+      // an error: old records and provider-less swaps are sent as is.
         quoteId: swap.orderQuoteId || null,
         providerId: swap.providerId || null,
         hashlock: (swap.escrow && swap.escrow.hashlock) || swap.hashlock || null,
@@ -130,25 +124,24 @@ export async function saveServerSwap(swap, network) {
       }),
     });
     if (r.status === 201 || r.status === 200) {
-      // СЕРВЕР ОТВЕЧАЕТ И ПРО ПРИВЯЗКУ КОТИРОВКИ. Без неё нода провайдера не заберёт ETH: её половина
-      // осталась бы невостребованной. Отказ привязки сделку не прерывает, но и молчать о нём нельзя -
-      // поэтому он уезжает вызывающему, а тот говорит в консоль.
+      // THE SERVER ALSO ANSWERS ABOUT THE QUOTE BINDING. Without it the provider node cannot claim the ETH.
+      // A binding refusal does not abort the swap, but must not be silent either - it goes to the caller, which logs it.
       return { ok: true, orderBinding: (r.body && r.body.orderBinding) || null };
     }
-    const why = r.body && r.body.error ? r.body.error : "ответ " + r.status;
+    const why = r.body && r.body.error ? r.body.error : "response " + r.status;
     return { ok: false, reason: why };
   } catch (e) {
     return { ok: false, reason: String((e && e.message) || e) };
   }
 }
 
-// Список сделок с сервера. Пустой результат и отказ - разные вещи, и вызывающий видит разницу.
+// The swap list from the server. An empty result and a refusal are different, and the caller sees the difference.
 export async function loadServerSwaps() {
-  if (!isConnected()) return { ok: false, reason: "кошелёк не подключён", swaps: [] };
+  if (!isConnected()) return { ok: false, reason: "wallet not connected", 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: [] };
+    if (r.status !== 200 || !r.body) return { ok: false, reason: "response " + 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

@@ -1,38 +1,23 @@
 // 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.
+// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
 // 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 GAS FOR THE XMR SELL (claim): ONE SOURCE OF TRUTH FOR THE CLIENT AND THE NODE.
+// In a reverse swap the person gives XMR and claims ETH via `claim` on the settlement chain. They have no ETH,
+// so the node sends the claim gas. The gas rules used to live in TWO places and the numbers differed ~100x, so
+// a person with one gift could not send the claim. Now this module computes both numbers.
+// WHY ONE MODULE UNDER www/js: the formula must be ONE. The EVM engine lives under www/js, and the node imports
+// from www/js too; the reverse import is impossible (the browser is never served the node directory).
+// WHAT IS ONE HERE: the claim gas limit, the fee rule (2 x baseFee + tip) and the GIFT SIZE - the same claim
+// cost plus an EXPLICIT margin for base-fee growth between ticket and claim.
 
-// ПРЕДЕЛ ГАЗА CLAIM - ОДНО ЧИСЛО НА ОБЕИХ СТОРОНАХ: его берут и страница/SDK (sdk/src/swap-flow.mjs), и
-// нода (rfq/payout.mjs). ИЗМЕРЕНО: честный claim, когда получателю комиссии ещё НЕ начислено (первая запись
-// в кассе = SSTORE нуля), стоит 120 721 газа на живой цепи (124 072 в gas-report канонических контрактов) -
-// больше прежних 120 000, чем законный забор и резался. Лимит задан с запасом: 200 000.
+// THE CLAIM GAS LIMIT IS ONE NUMBER ON BOTH SIDES. MEASURED: an honest claim costs 120 721 gas on a live chain,
+// more than the old 120 000, which cut off legitimate claims. The limit has a margin: 200 000.
 export const CLAIM_GAS_LIMIT = 200_000n;
 
-// ПОЛ ЧАЕВЫХ - ПОЛИТИКА СЕТИ, А НЕ КОНСТАНТА В КОДЕ ОТПРАВКИ. Раньше session.js ставил минимум 1 gwei
-// ВСЕГДА. На сети с дешёвым газом (Arbitrum One: baseFee ~0.02 gwei) это раздувало maxFeePerGas примерно
-// в 50 раз и поднимало ТРЕБУЕМЫЙ БАЛАНС пропорционально - то есть ломало ровно того, кому газ и
-// предназначен. Для Arbitrum чаевые не нужны: пол 0. Сеть со своей политикой передаёт minTipWei
-// аргументом (session.js берёт сеть из реестра, www/js/core/config.js).
+// THE TIP FLOOR IS NETWORK POLICY, NOT A CONSTANT IN THE SENDING CODE. A fixed 1 gwei minimum inflated
+// maxFeePerGas ~50x on cheap-gas networks and broke exactly those the gas is for. Arbitrum needs no tip
+// (floor 0); a network with its own policy passes minTipWei, taken from the network registry.
 export const CLAIM_TIP_FLOOR_WEI = 0n;
 
 const toBig = (v) => {
@@ -40,10 +25,9 @@ const toBig = (v) => {
   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, а не
-// ноль: неизвестное обязано называться, а не выдаваться за измеренное.
+// CLAIM FEE (EIP-1559): `maxFeePerGas = 2 x baseFee + tip`. Doubling the base fee covers its growth during the
+// transaction; the tip is gasPrice - baseFee, not below the network floor. baseFee = 0 (no EIP-1559): no fee
+// fields at all, and that is null, not zero.
 export function claimMaxFeePerGasWei({ baseFeeWei, priorityFeeWei = 0n, minTipWei = CLAIM_TIP_FLOOR_WEI } = {}) {
   const base = toBig(baseFeeWei);
   if (base === null || base <= 0n) return null;
@@ -54,8 +38,8 @@ export function claimMaxFeePerGasWei({ baseFeeWei, priorityFeeWei = 0n, minTipWe
   return base * 2n + tip;
 }
 
-// СКОЛЬКО НУЖНО НА БАЛАНСЕ ДЛЯ CLAIM - это же правило приёма транзакции узлом: `gasLimit x maxFeePerGas`.
-// Один из множителей не измерен - null (не «ноль газа»).
+// HOW MUCH THE BALANCE NEEDS FOR CLAIM - the node acceptance rule: `gasLimit x maxFeePerGas`. If a factor is
+// unmeasured - null (not "zero gas").
 export function claimRequiredWei({ gasLimit = CLAIM_GAS_LIMIT, maxFeePerGasWei } = {}) {
   const limit = toBig(gasLimit);
   const maxFee = toBig(maxFeePerGasWei);
@@ -63,21 +47,18 @@ export function claimRequiredWei({ gasLimit = CLAIM_GAS_LIMIT, maxFeePerGasWei }
   return limit * maxFee;
 }
 
-// ЗАПАС НА РОСТ БАЗОВОЙ ЦЕНЫ МЕЖДУ ВЫДАЧЕЙ БИЛЕТА И ЗАБОРОМ, в базисных пунктах (10 000 = +100%).
+// MARGIN FOR BASE-FEE GROWTH BETWEEN TICKET AND CLAIM, in basis points (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), а не догадка: её видно и можно переопределить без правки кода.
+// WHY IT IS NEEDED AND WHY THIS MUCH. The claim cost is computed at TICKET time, but the claim happens later:
+// the ticket lives RFQ_ORDER_QUOTE_TTL_MS, 40 minutes by default. The client rule (2 x baseFee) covers growth
+// only during its own transaction, not those 40 minutes. +100% covers a doubling of the base fee over the
+// ticket window, so the gift stays sufficient. The value is a node setting (RFQ_REVERSE_GAS_RESERVE_BPS), not
+// a guess: it is visible and can be overridden.
 export const DEFAULT_GIFT_RESERVE_BPS = 10_000n;
 
-// РАЗМЕР ПОДАРКА - ТА ЖЕ стоимость claim, что требует клиент, ПЛЮС запас. Это ЕДИНСТВЕННЫЙ расчёт размера
-// подарка: нода (rfq/reverseGas.mjs, requiredGasWei) и живой прогон зовут ИМЕННО ЕГО, а не свою копию.
-// base берётся у цепи на момент билета; priorityFeeWei - реальные чаевые сети (gasPrice - baseFee), если
-// известны. Нечитаемая база - null, а не ноль.
+// GIFT SIZE - the same claim cost the client requires, PLUS the margin. This is the ONLY computation of the
+// gift size: the node and the live run call IT, not their own copy. base comes from the chain at ticket time;
+// priorityFeeWei is the real network tip. An unreadable base is null, not zero.
 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 });

package/engine/evm/depositor.js

@@ -1,34 +1,31 @@
 // 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.
+// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
 // Everything below this header is identical to the source.
 
-// ВНОСЯЩИЙ ПО ПОДПИСИ, КЛИЕНТСКАЯ СТОРОНА (issue #97, часть C): EIP-712 typed data над ДАЙДЖЕСТОМ КОТИРОВКИ.
+// THE DEPOSITOR BY SIGNATURE, CLIENT SIDE: EIP-712 typed data over the QUOTE DIGEST.
 //
-// ЗАЧЕМ. Часть A дала фабрике путь `createOrderAndFundByDepositor`: транзакцию вправе отправить КТО УГОДНО
-// (релейщик, наш сервис), но вносившим записывается тот, кто подписал дайджест котировки. Чтобы релейщик
-// мог отправить транзакцию, вносящий обязан сперва подписать. Подпись кошелька - это typed data, а не
-// транзакция: она не стоит газа и не двигает деньги, поэтому человек БЕЗ своего ETH тоже может её дать.
+// WHY. The factory has a path createOrderAndFundByDepositor: ANYONE may send the transaction (a relayer, our
+// service), but the depositor is whoever signed the quote digest, so the depositor must sign first. A wallet
+// signature is typed data, not a transaction: it costs no gas and moves no money, so a person without ETH can give it.
 //
-// ПОЧЕМУ ФОРМА ЗДЕСЬ, А НЕ ВЫДУМАНА. Набор полей и домен - ЧАСТЬ ПРОТОКОЛА: тот же OrderQuote, что
-// проверяет эскроу (mvp/contracts/OrderQuote.sol) и подписывает нода (rfq/lib/quoteEip712Spec.mjs,
-// sdk/src/quoteEip712Spec.mjs). Перестановка двух полей даёт ДРУГОЙ дайджест, подпись восстанавливается в
-// чужой адрес, и фабрика отказывает `BadDepositorSignature`. Поэтому форма лежит ОДНИМ списком ниже, а
-// проверка (tools/check-usdc-without-eth.mjs) считает этой формой дайджест и сверяет его с дайджестом,
-// посчитанным СПЕКОЙ ноды/SDK на той же котировке - разойтись молча они не могут.
+// WHY THIS FORM, NOT AN INVENTED ONE. The field set and domain are PART OF THE PROTOCOL - the same OrderQuote
+// the escrow verifies and the node signs. Two swapped fields give a DIFFERENT digest and the factory refuses
+// BadDepositorSignature. So the form is ONE list below, and a check computes the digest with it and compares.
 //
-// ДОМЕН. verifyingContract - АДРЕС ФАБРИКИ ИЗ САМОЙ КОТИРОВКИ (поле `factory`), chainId - живой из котировки:
-// подпись, сделанная для другой фабрики или сети, здесь не восстановится. Второго источника домена нет.
+// DOMAIN. verifyingContract is the FACTORY ADDRESS FROM THE QUOTE (field `factory`), chainId is live: a signature
+// made for another factory or network will not recover here. There is no second source of the domain.
 //
-// ЧЕГО ЗДЕСЬ НЕТ. Криптографии: дайджест считает КОШЕЛЁК (eth_signTypedData_v4), а не этот модуль. Здесь -
-// только форма и её проверка, чтобы кошелёк подписал ровно то, что проверит цепь.
+// NO CRYPTOGRAPHY HERE: the wallet computes the digest (eth_signTypedData_v4). Here is only the form and its check.
 
-// Имя и версия домена - протокол котировок v8, дословно как в OrderQuote.sol.
-export const DEPOSITOR_DOMAIN_NAME = "NinseiEscrowFactory";
-export const DEPOSITOR_DOMAIN_VERSION = "1";
+import { SIGNING_DOMAIN } from "../core/config.js";
 
-// НАБОР ПОЛЕЙ В ПОРЯДКЕ КОНТРАКТА. Порядок - часть ABI: перестановка даёт другой дайджест. Список один -
-// из него строится и строка типа, и сообщение, разойтись им нечем.
+// The domain name and version are quote protocol v8. They are NOT brand literals here: they belong to the registry
+// contract (it returns DOMAIN_SEPARATOR()), so they are read from the config. The defaults equal today's values.
+export const DEPOSITOR_DOMAIN_NAME = SIGNING_DOMAIN.name;
+export const DEPOSITOR_DOMAIN_VERSION = SIGNING_DOMAIN.version;
+
+// FIELD SET IN CONTRACT ORDER. The order is part of the ABI: a swap gives another digest. One list feeds both
+// the type string and the message, so they cannot diverge.
 export const ORDER_QUOTE_TYPED_FIELDS = [
   ["provider", "address"],
   ["quoteKey", "address"],
@@ -48,47 +45,46 @@ export const ORDER_QUOTE_TYPED_FIELDS = [
   ["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
+  // THE XMR SIDE OF THE DEAL, 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"],
 ];
 
-// Тип сообщения. Собирается из списка: правка списка меняет и тип, и подпись - то есть не может остаться
-// незамеченной, в отличие от второго литерала рядом.
+// The message type. Built from the list: editing the list changes both the type and the signature, so it cannot
+// go unnoticed.
 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/не число: молчаливое выравнивание нулями ушло бы ДРУГИМ значением.
+// FORM IS NORMALISED, NOT DEMANDED. The quote carries ed25519 points WITHOUT the 0x prefix, while the wallet and
+// contract expect the same BYTES. So we normalise here and reject anything that is not address/bytes32/number.
 function normaliseField(name, type, value) {
   const raw = String(value === undefined || value === null ? "" : value).trim();
-  if (raw === "") throw new Error("котировка не несёт поля для подписи вносящего: " + name);
+  if (raw === "") throw new Error("the quote carries no depositor-signature field: " + name);
   if (type === "address") {
-    if (!isHex(raw, 20)) throw new Error("поле " + name + " - не адрес: " + raw);
+    if (!isHex(raw, 20)) throw new Error("field " + name + " is not an address: " + raw);
     return "0x" + raw.replace(/^0x/, "").toLowerCase();
   }
   if (type === "bytes32") {
-    if (!isHex(raw, 32)) throw new Error("поле " + name + " - не bytes32: " + raw);
+    if (!isHex(raw, 32)) throw new Error("field " + name + " is not bytes32: " + raw);
     return "0x" + raw.replace(/^0x/, "").toLowerCase();
   }
-  // uint64 / uint256: кошелёк принимает строку; десятичную и hex-форму даёт один и тот же разбор.
-  if (!isNum(raw)) throw new Error("поле " + name + " - не число: " + raw);
+  // uint64 / uint256: the wallet accepts a string; decimal and hex are parsed the same.
+  if (!isNum(raw)) throw new Error("field " + name + " is not a number: " + raw);
   return String(BigInt(raw));
 }
 
 /**
- * EIP-712 typed data, которое подписывает вносящий (eth_signTypedData_v4).
- * Домен строится ИЗ КОТИРОВКИ: verifyingContract = quote.factory, chainId = quote.chainId.
+ * EIP-712 typed data that the depositor signs (eth_signTypedData_v4).
+ * The domain is built FROM THE QUOTE: 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 - домен подписи не собрать");
+  if (!quote || typeof quote !== "object") throw new Error("no signed quote: nothing to sign");
+  if (!isHex(quote.factory, 20)) throw new Error("the quote has no factory address - cannot build the signing domain");
+  if (!isNum(quote.chainId)) throw new Error("the quote has no chainId - cannot build the signing domain");
   const message = {};
   for (const [name, type] of ORDER_QUOTE_TYPED_FIELDS) {
     message[name] = normaliseField(name, type, quote[name]);
@@ -101,7 +97,7 @@ export function orderQuoteTypedData(quote) {
       verifyingContract: "0x" + String(quote.factory).replace(/^0x/, "").toLowerCase(),
     },
     types: {
-      // EIP712Domain явно: кошельки показывают его человеку, и он обязан совпасть с тем, что считает цепь.
+      // EIP712Domain explicit: wallets show it to the person, and it must match what the chain computes.
       EIP712Domain: [
         { name: "name", type: "string" },
         { name: "version", type: "string" },
@@ -115,13 +111,13 @@ export function orderQuoteTypedData(quote) {
   };
 }
 
-// ПОДПИСЬ НА ПРОВОДЕ - 65 БАЙТ r || s || v. Проверяем форму ЗДЕСЬ: фабрика принимает подпись тремя словами,
-// и «похожая на подпись» строка не должна уехать в контракт как согласие.
+// SIGNATURE ON THE WIRE - 65 BYTES r || s || v. The form is checked HERE: the factory takes the signature as
+// three words, and a "signature-like" string must not reach the contract as consent.
 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 + " байт" };
+  if (!/^[0-9a-fA-F]{130}$/.test(hex)) return { ok: false, reason: "the depositor signature must be 65 bytes (r || s || v), got " + hex.length / 2 + " bytes" };
   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 };
+  if (v !== 27 && v !== 28) return { ok: false, reason: "depositor signature v outside {27,28}: " + v };
   return { ok: true, r: "0x" + hex.slice(0, 64).toLowerCase(), s: "0x" + hex.slice(64, 128).toLowerCase(), v: 27 + (v - 27) };
 }