@ninsei-labs/sdk 0.39.0

package/engine/evm/escrow.js

@@ -0,0 +1,208 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/escrow.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.
+
+// Вызовы контракта-эскроу ArrakisSwap (один экземпляр = один ордер).
+//
+// Библиотек для EVM в проекте нет: у эскроу ТРИ функции, которые двигают состояние (markReady, claim,
+// refund), и несколько читаемых, поэтому calldata собирается селектором и словами по 32 байта.
+// ФУНКЦИИ ВНЕСЕНИЯ У ЭСКРОУ НЕТ: ордер рождается зафондированным в транзакции создания, и двухшаговый
+// путь («создать пустым, внести вторым вызовом») убран вместе с ней - он и был источником запирания
+// денег в закрытом ордере. Отсюда и отсутствие селектора fund() в таблице ниже.
+// Селекторы вычислены инструментом, не вручную - и это те подписи, которые у контракта ЕСТЬ:
+//   cast sig "markReady()"     -> 0x1ca087e7
+//   cast sig "claim(bytes32)"  -> 0xbd66528a
+//   cast sig "refund(bytes32)" -> 0x7249fbb6   (refund() БЕЗ аргумента у контракта нет: половина обязательна, :294)
+//   cast sig "status()"        -> 0x200d2ed2
+// Проверяются в tools/check-evm-abi.mjs сверкой с эталоном Foundry (cast sig / cast calldata).
+//
+// ПРО СОБЫТИЯ - ПРЕЖНЯЯ РЕДАКЦИЯ ЭТОГО КОММЕНТАРИЯ ВРАЛА, и врала дважды. У эскроу события ЕСТЬ, три:
+//   HalfRevealed(bytes32 half, bool byClaimer) - mvp/contracts/NinseiEscrow.sol:131
+//   OrderTerms(...)                            - :133-139
+//   Ready(address indexed by)                  - :141
+//   StrayRescued(address indexed token, ...)    - :145
+// Состояние всё же читается вызовом status(), и причина не в отсутствии событий, а в двух других вещах:
+//   1) ВНЕСЕНИЕ ДЕНЕГ СОБЫТИЯ НЕ ИМЕЕТ ВООБЩЕ: флаг funded ставится в конструкторе (:232-237) вместе с
+//      эмиссией OrderTerms, но отдельного «внесено» в логах нет, а это первое из состояний ордера;
+//   2) status() (:406-408) заведён в контракте именно «фронту и watchtower'у» и отдаёт все четыре
+//      величины ОДНИМ вызовом - внесено, забрано, возвращено, остаток - по адресу эскроу, который уже
+//      известен из записи сделки. Следить для этого за логами с блока создания не нужно.
+// Событие HalfRevealed при этом несёт признак byClaimer, то есть из него видно и «забрано», и
+// «возвращено»: тому, кто ведёт журнал ордеров, подписка на него полезна. Для чтения состояния
+// конкретного ордера на месте нужен status().
+
+export const ESCROW_METHODS = {
+  // ВНЕСЕНИЯ ЗДЕСЬ НЕТ НАМЕРЕННО. Прежний fund() кодировался как 0xb60d4288; функции у контракта больше
+  // нет, а её правила переехали в рождение ордера: ровно `amount + fee` проверяет конструктор, и платит
+  // тот, кто назван внёсшим, - других транзакций у ордера не бывает. Вернувшаяся строка с этим селектором
+  // краснит tools/check-evm-abi.mjs.
+  // отметить готовность: "XMR вижу". Без неё забор невозможен (:233) - это защита от забора ETH без XMR.
+  // Ставит её только внёсший, только на зафондированном ордере и только до readyBy (:218-222).
+  markReady: "0x1ca087e7",
+  // забрать, предъявив СВОЮ половину; её хеш (обязательство) зашит в ордер при создании.
+  // Вызвать вправе кто угодно - адрес отправителя контракт не проверяет (:232-235), - но деньги уходят
+  // не ему, а записанному claimer (:242), поэтому переадресовать их вызывающий не может.
+  claim: "0xbd66528a",
+  // вернуть средства после срока t1, ПРЕДЪЯВИВ ПОЛОВИНУ ВНЁСШЕГО: контракт сверяет её хеш с
+  // обязательством commitHalfLocker (:253, поле :79) и отвергает чужую половину (BadHalf).
+  // Отсюда уточнение к прежней формулировке "может позвать кто угодно": отправить транзакцию вправе
+  // любой (:246-249, роль watchtower), но провести её может лишь тот, у кого есть половина внёсшего.
+  // Деньги при этом идут ВСЕГДА внёсшему (:260), а половина публикуется - по ней он заберёт своё XMR.
+  refund: "0x7249fbb6",
+  // состояние: (заблокировано, забрано, возвращено, остаток)
+  status: "0x200d2ed2",
+  // СРОК ОДИН. До t1 ETH забирает только claimer по своей половине и только при отметке ready (:233),
+  // с t1 забор запрещён (:234), а вернуть вправе кто угодно, предъявив половину внёсшего (:250-253).
+  // Селектора t0() здесь больше нет: поля t0 в контракте не существует (решение
+  // 2026-09-16, док 26). У ордеров, созданных раньше, срок лежит в записи сделки, и правило для них
+  // прежнее - см. derive() в core/swap.js.
+  t1: "0xfb5343f3",
+  // до этого срока внёсший может отметить готовность; строго раньше t1
+  readyBy: "0x53fc2f40",
+  // отмечена ли готовность: без неё забор закрыт
+  ready: "0x6defbf80",
+  // раскрытая расчётом половина: из неё вторая сторона собирает ключ траты
+  revealedHalf: "0x3f267bb6",
+  // ТОЧКИ И ОБЯЗАТЕЛЬСТВА ОРДЕРА, прочитанные У САМОГО ЭСКРОУ. Нужны перед подписью: доказательство DLEQ
+  // связывает половину с точкой, но не мешает положить в ордер ДРУГИЕ точки - тогда общий адрес Monero
+  // соберётся не из тех половин, а узнать об этом можно, только сверив СЛОТЫ ЖИВОЙ ЦЕПИ с тем, что собрала
+  // страница. Селекторы посчитаны `cast sig` по фактическим подписям; сверка таблицы - в
+  // tools/check-evm-abi.mjs (отдельный зуб на каждое имя).
+  edPointLocker: "0x8c03382b",     // точка траты внёсшего: половина общего адреса
+  edPointClaimer: "0xdd98c465",    // и точка траты забирающего: сверяется с котировкой, а не берётся на слово
+  edViewPointLocker: "0x9a06a5fe", // и его точка просмотра: без неё адрес Monero не собрать
+  commitHalfLocker: "0x498b422e",  // обязательство на половину внёсшего: по нему контракт проверит refund
+  commitHalfClaimer: "0x7d4c81f7", // обязательство на половину забирающего: по нему контракт проверит claim
+  // условия ордера одним хешем. Нужен, чтобы файл восстановления был ПРИВЯЗАН к ордеру на цепи: по нему
+  // владелец файла проверяет, что файл относится именно к этому эскроу, а не к похожему.
+  // ГРАНИЦА, КОТОРУЮ НАЗВАЛ АУДИТ, ЗАКРЫТА РЕШЕНИЕМ. Раньше точки просмотра внёсшего (edViewPointLocker) в хеше
+  // НЕ было, и сверку именно этой точки приходилось делать отдельно. Теперь поле входит в слепок (:346) на
+  // своё место - сразу после точки забирающего, как в событии OrderTerms, - поэтому ордер сверяется
+  // ЦЕЛИКОМ, и отдельная сверка точки просмотра больше не нужна. ЦЕНА НАЗВАНА ПРЯМО: слепок у ВСЕХ ордеров
+  // другой, значит фабрика и эскроу передеплоиваются, а адреса, записанные где-либо до этого (config.js,
+  // networks.json, записи сделок), к новым ордерам не относятся.
+  termsHash: "0xb311d9fd",
+  // КОМИССИЯ, РЕЕСТР И ПРОИСХОЖДЕНИЕ - ВСЁ ЧИТАЕТСЯ У САМОГО ЭСКРОУ. У фабрики этих полей больше нет
+  // (роутер удалён, решение #76): ставка, величина и получатель комиссии, адрес реестра, провайдер и ключ
+  // подписи приходят в подписанной котировке и лежат в ордере неизменяемыми полями. Селекторы - `cast sig`
+  // по фактическим подписям, как и всё остальное в этой таблице; сверка - в tools/check-evm-abi.mjs.
+  fee: "0xddca3f43",                // величина комиссии в wei (посчитана при создании ордера)
+  feeBps: "0x24a9d853",             // ставка в базисных пунктах (30 = 0.30%)
+  feeRecipient: "0x46904840",       // кому комиссия зачисляется в кассу
+  feeOnTop: "0x2296cc23",           // true - покупка (комиссия сверху), false - продажа (вычет из выплаты)
+  registry: "0x7b103999",           // адрес реестра мейкеров ИЗ УСЛОВИЙ ОРДЕРА
+  cashier: "0xed740e97",            // касса комиссии ИЗ УСЛОВИЙ ОРДЕРА (#103): фабрика её НЕ заводит
+  provider: "0x085d4883",           // провайдер, заявленный в котировке (проверен по реестру)
+  quoteKey: "0x391d53ca",           // ключ, которым подписана котировка
+  validUntil: "0xddac6654",         // срок годности котировки (СЕКУНДЫ)
+  nonce: "0xaffed0e0",              // нонс котировки
+};
+
+// Динамических аргументов у эскроу НЕТ, поэтому все вызовы ниже - голые селекторы. Кодировщика внесения
+// здесь больше нет: у эскроу нет самой функции (см. заметку в ESCROW_METHODS).
+// call markReady(): аргументов нет.
+export function encodeMarkReady() {
+  return ESCROW_METHODS.markReady;
+}
+
+// call ready()/readyBy()/revealedHalf(): аргументов нет - calldata у них равен самому селектору,
+// поэтому отдельных кодировщиков здесь нет, а селекторы лежат в ESCROW_METHODS выше.
+
+// call claim(secret): секрет - bytes32. По контракту это половина ЗАБИРАЮЩЕГО (имя параметра -
+// halfClaimer, :231), а "секретом" её называют потому, что она служит прообразом обязательства
+// commitHalfClaimer: контракт сверяет keccak256 предъявленной половины со своим обязательством
+// (:235) и ничего больше - связь половины с адресом Monero проверяет не он (док 27 §10).
+export function encodeClaim(secret) {
+  return ESCROW_METHODS.claim + halfAsThirtyTwoBytes(secret, "секрет");
+}
+
+// ПОЛОВИНА - ЧИСЛО, А НЕ СТРОКА ФИКСИРОВАННОЙ ДЛИНЫ. В записи сделки и в файле восстановления половина
+// хранится как есть, и ведущий ноль теряется: 63 знака вместо 64. Контракту нужны ровно 32 байта, поэтому
+// добиваем слева (как это делает нода в своём заборе). Без этого возврат был невозможен в принципе:
+// снаружи это выглядело как "половина должна быть 32 байтами" на живом нажатии кнопки возврата.
+function halfAsThirtyTwoBytes(value, what) {
+  const hex = String(value || "").replace(/^0x/i, "").toLowerCase();
+  if (!/^[0-9a-f]{1,64}$/.test(hex)) throw new Error(what + " должен быть числом до 32 байт: " + value);
+  return hex.padStart(64, "0");
+}
+
+// call refund(bytes32 halfLocker): предъявляется половина ВНЁСШЕГО, а не половина вызывающего -
+// контракт сверяет её хеш с обязательством commitHalfLocker (:253) и чужую отвергает (BadHalf).
+// Отправителя контракт не проверяет: право на вызов даёт сама половина (:246-249).
+export function encodeRefund(halfLocker) {
+  return ESCROW_METHODS.refund + halfAsThirtyTwoBytes(halfLocker, "половина");
+}
+
+// call status(): аргументов нет.
+export function encodeStatus() {
+  return ESCROW_METHODS.status;
+}
+
+// call t1(): аргументов нет.
+export function encodeT1() {
+  return ESCROW_METHODS.t1;
+}
+
+// call termsHash(): аргументов нет.
+export function encodeTermsHash() {
+  return ESCROW_METHODS.termsHash;
+}
+
+// call к методу эскроу БЕЗ аргументов по имени. Нужен там, где чтений много (слоты ордера): отдельная
+// функция на каждый селектор завела бы вторую таблицу тех же имён, и она разошлась бы с первой молча.
+export function encodeRead(name) {
+  const sel = ESCROW_METHODS[name];
+  if (typeof sel !== "string" || !/^0x[0-9a-f]{8}$/.test(sel)) throw new Error("нет такого метода эскроу: " + name);
+  return sel;
+}
+
+// Разбор ответа bytes32: одно слово.
+export function decodeBytes32(returnedHex, what = "значение") {
+  const hex = String(returnedHex || "").replace(/^0x/, "");
+  if (hex.length < 64) throw new Error("короткий ответ " + what + ": " + returnedHex);
+  return "0x" + hex.slice(0, 64).toLowerCase();
+}
+
+// Разбор ответа t1(): одно слово, uint64 внутри uint256.
+export function decodeUint64(returnedHex, what = "значение") {
+  const hex = String(returnedHex || "").replace(/^0x/, "");
+  if (hex.length < 64) throw new Error("короткий ответ " + what + ": " + returnedHex);
+  const v = BigInt("0x" + hex.slice(0, 64));
+  if (v > 18446744073709551615n) throw new Error("ответ " + what + " не влезает в uint64: " + v);
+  return Number(v);
+}
+
+// Разбор ответа status(): четыре слова по 32 байта, три флага и остаток.
+export function decodeStatus(returnedHex) {
+  const hex = String(returnedHex || "").replace(/^0x/, "");
+  if (hex.length < 256) throw new Error("короткий ответ status(): " + returnedHex);
+  const word = (i) => hex.slice(i * 64, (i + 1) * 64);
+  return {
+    isFunded: BigInt("0x" + word(0)) !== 0n,
+    isClaimed: BigInt("0x" + word(1)) !== 0n,
+    isRefunded: BigInt("0x" + word(2)) !== 0n,
+    balance: BigInt("0x" + word(3)),
+  };
+}
+
+// Какие условия ордера нужны эскроу при создании - одним местом, чтобы форма и проверка не разошлись.
+// СРОК ОДИН. Поля t0 в условиях ордера больше нет: до t1 ETH забирает claimer по своей половине и
+// только при отметке ready, с t1 забор запрещён, а вернуть вправе кто угодно, ПРЕДЪЯВИВ ПОЛОВИНУ
+// ВНЁСШЕГО (NinseiEscrow.sol:250-253) - у сторожа её нет, поэтому "вернёт кто угодно" надо читать как
+// "любой, у кого есть половина" (решение 2026-09-16, док 26; то же уточнение - док 24 §1).
+// Проверка "t1 позже t0" потеряла смысл, но её место заняла не пустота: срок обязан быть В БУДУЩЕМ,
+// иначе ордер создаётся уже закрытым - claim по нему невозможен, и деньги зависли бы до возврата.
+// Верхних границ и требования "сроки в будущем" у КОНТРАКТА нет вовсе: конструктор проверяет только
+// amount != 0 и t1 > readyBy (:170-171), а сроки в прошлом для него допустимы. Их держит эта функция -
+// контракт защищает деньги, но не защищает от ордера с прошлыми сроками.
+export function orderTerms({ locker, claimer, commitHalfLocker, commitHalfClaimer, edPointLocker, edPointClaimer, amount, readyBy, t1 }) {
+  for (const [k, v] of Object.entries({ locker, claimer, commitHalfLocker, commitHalfClaimer, edPointLocker, edPointClaimer, amount })) {
+    if (v === undefined || v === null || v === "") throw new Error("не задано условие ордера: " + k);
+  }
+  // Сроков два, и они НЕ должны совпадать: совпадение вернуло бы окно, где забор и возврат валидны
+  // одновременно, и спор решал бы газ. Первый срок - окно отметки готовности, второй - граница расчёта.
+  if (Number(readyBy) <= Math.floor(Date.now() / 1000)) throw new Error("readyBy должен быть в будущем: " + readyBy);
+  if (Number(t1) <= Number(readyBy)) throw new Error("t1 должен быть позже readyBy");
+  return { locker, claimer, commitHalfLocker, commitHalfClaimer, edPointLocker, edPointClaimer, amount, readyBy, t1 };
+}

package/engine/evm/factory.js

@@ -0,0 +1,149 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/factory.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.
+
+// Вызовы контракта-фабрики эскроу ArrakisSwap.
+//
+// Библиотек для EVM в проекте нет и не добавляем. ОБЕ ФУНКЦИИ ФАБРИКИ ТЕПЕРЬ ПРИНИМАЮТ ПОДПИСАННУЮ КОТИРОВКУ
+// (OrderQuote.Quote), подпись тремя словами (r, s, v) и три поля вносившего. Комиссия и адрес реестра - ЧАСТЬ
+// КОТИРОВКИ, а не настройка контракта: функций feeBps()/feeFor() у фабрики больше нет (роутер удалён,
+// решение #76), и спрашивать их не у чего. Все аргументы статические, поэтому calldata - селектор плюс слова
+// по 32 байта; собирается здесь, в одном месте, и проверяется tools/check-evm-abi.mjs.
+//
+//   cast sig "predict((address,address,address,address,address,address,uint256,uint64,uint64,bytes32,bytes32,bytes32,uint256,uint256,uint256,address,uint64,uint256,uint256),bytes32,bytes32,uint8,bytes32,bytes32,bytes32)" -> 0x0824d205
+//   cast sig "createOrderAndFund(<тот же tuple>,...)"                                                                                                                -> 0x4703a9d3
+
+export const FACTORY_METHODS = {
+  // СОСТАВ КОТИРОВКИ ВЫРОС ПОЛЕМ xmrAmount (#110 шаг 3): XMR-сторона сделки входит в подписанный набор, поэтому
+  // селекторы обеих прежних функций сменились вторично (прежде - от поля cashier, #103).
+  predict: "0x0824d205",
+  // создать эскроу И внести деньги ОДНОЙ транзакцией (перевод value вместе с вызовом).
+  createOrderAndFund: "0x4703a9d3",
+  // создать эскроу и внести деньги, когда ВНОСЯЩИЙ восстановлен ИЗ ПОДПИСИ над дайджестом котировки
+  // (issue #97, часть A): транзакцию шлёт кто угодно, а `locker` записан подписавшим.
+  createOrderAndFundByDepositor: "0x2acd187b",
+};
+
+// ТЕМА СОБЫТИЯ OrderCreated. Она выросла адресом реестра, провайдером и ключом подписи:
+//   cast keccak "OrderCreated(address,address,address,bytes32,bytes32,bytes32,bytes32,bytes32,uint256,uint64,uint64,bytes32,address,address,address)"
+// Тема живёт в ДВУХ местах - здесь и в watchtower/scan.mjs, - и обе обязаны совпадать: разойтись молча они
+// не могут, сверку держит проверка ABI.
+export const ORDER_CREATED_TOPIC =
+  "0xa22cdabaed3cce4f51dde71626a108ffe9c7bc4216fd14d5e719f892e2fd8ab0";
+
+// ПОЛЯ КОТИРОВКИ В ПОРЯДКЕ КОНТРАКТА. Порядок - часть ABI: перестановка даёт другой вызов (чужую функцию
+// или ордер с чужими условиями). Список ОДИН на обе функции: разойтись им нечем.
+export const QUOTE_FIELDS = [
+  "provider", "quoteKey", "registry", "cashier", "locker", "claimer", "amount", "readyBy", "t1", "salt",
+  "commitHalfClaimer", "edPointClaimer", "chainId", "feeBps", "fee", "feeRecipient", "validUntil", "nonce", "xmrAmount",
+];
+// Поля вносившего котировка НЕ несёт: они уходят отдельными аргументами (входят в init-код эскроу).
+const LOCKER_HALF_FIELDS = ["commitHalfLocker", "edPointLocker", "edViewPointLocker"];
+const ADDR_FIELDS = ["provider", "quoteKey", "registry", "cashier", "locker", "claimer", "feeRecipient"];
+const B32_FIELDS = ["salt", "commitHalfClaimer", "edPointClaimer", "commitHalfLocker", "edPointLocker", "edViewPointLocker"];
+
+// Слово calldata: значение, выровненное вправо до 32 байт. Числа приходят десятичными (wei, сроки), а в
+// calldata обязаны быть шестнадцатеричными: дополнение нулями десятичных цифр кодировало бы их как hex и
+// уводило сумму в другое число. Поймано сверкой с эталоном Foundry.
+export function word(value, bytes = 32) {
+  const raw = String(value).trim();
+  let hex;
+  if (/^0x[0-9a-fA-F]*$/.test(raw)) {
+    hex = raw.slice(2).toLowerCase();
+    if (hex.length === 0) hex = "0";
+  } else if (/^[0-9]+$/.test(raw)) {
+    hex = BigInt(raw).toString(16);
+  } else {
+    throw new Error("не число и не hex: " + value);
+  }
+  if (!/^[0-9a-f]*$/.test(hex)) throw new Error("не hex: " + value);
+  if (hex.length > bytes * 2) throw new Error(`значение не влезает в ${bytes} байт: ${value}`);
+  return hex.padStart(bytes * 2, "0");
+}
+
+// ФОРМА ПРИВОДИТСЯ, А НЕ ТРЕБУЕТСЯ: точки и обязательства в записи движка лежат БЕЗ префикса 0x, а word()
+// требует префикс. Байты одни и те же, поэтому оба вида кодируются одинаково.
+const asHex32 = (v) => {
+  const x = String(v === undefined || v === null ? "" : v).trim();
+  return /^[0-9a-fA-F]{64}$/.test(x) ? "0x" + x.toLowerCase() : x;
+};
+
+// СЛОВА ПОДПИСАННОГО НАБОРА. Подпись - 65 байт r || s || v; v приводится к 27/28 (контракт принимает оба
+// соглашения). r и s - ПОЛНЫЕ 32 байта, v - тоже ПОЛНОЕ слово из 32 байт (ABI uint8 не бывает короче слова:
+// неполное слово сдвинуло бы хвост calldata и вызов ушёл бы на несуществующий селектор).
+function quoteWords(quote) {
+  for (const name of QUOTE_FIELDS) {
+    if (quote[name] === undefined || quote[name] === null || quote[name] === "") throw new Error("в котировке нет поля: " + name);
+  }
+  // ФОРМА ПРОВЕРЯЕТСЯ, А НЕ ДОСТРАИВАЕТСЯ: короткий адрес или усечённый bytes32 молча выровнялся бы
+  // нулями и ушёл в контракт ДРУГИМ значением.
+  for (const name of ADDR_FIELDS) {
+    if (!/^(0x)?[0-9a-fA-F]{40}$/.test(String(quote[name]).trim())) throw new Error("поле котировки " + name + " - не адрес");
+  }
+  for (const name of B32_FIELDS) {
+    if (!/^(0x)?[0-9a-fA-F]{64}$/.test(String(quote[name]).trim())) throw new Error("поле котировки " + name + " - не bytes32");
+  }
+  const map = {
+    provider: word(quote.provider, 32), quoteKey: word(quote.quoteKey, 32), registry: word(quote.registry, 32),
+    cashier: word(quote.cashier, 32),
+    locker: word(quote.locker, 32), claimer: word(quote.claimer, 32),
+    amount: word(quote.amount, 32), readyBy: word(quote.readyBy, 32), t1: word(quote.t1, 32),
+    salt: word(asHex32(quote.salt), 32),
+    commitHalfClaimer: word(asHex32(quote.commitHalfClaimer), 32),
+    edPointClaimer: word(asHex32(quote.edPointClaimer), 32),
+    chainId: word(quote.chainId, 32), feeBps: word(quote.feeBps, 32), fee: word(quote.fee, 32),
+    feeRecipient: word(quote.feeRecipient, 32), validUntil: word(quote.validUntil, 32), nonce: word(quote.nonce, 32),
+    xmrAmount: word(quote.xmrAmount, 32),
+  };
+  return QUOTE_FIELDS.map((n) => map[n]).join("");
+}
+
+function signatureWords(signature) {
+  const hex = String(signature || "").replace(/^0x/, "");
+  if (!/^[0-9a-fA-F]{130}$/.test(hex)) throw new Error("подпись котировки должна быть 65 байт: " + String(signature).slice(0, 20));
+  const r = hex.slice(0, 64), s = hex.slice(64, 128);
+  let v = parseInt(hex.slice(128, 130), 16);
+  if (v < 27) v += 27;
+  return word("0x" + r, 32) + word("0x" + s, 32) + word(v, 32);
+}
+
+// ОБЩАЯ ЧАСТЬ predict и createOrderAndFund.
+function lockerHalfWords(quote) {
+  return LOCKER_HALF_FIELDS.map((name) => {
+    if (quote[name] === undefined || quote[name] === null || quote[name] === "") throw new Error("в котировке нет поля вносившего: " + name);
+    return word(asHex32(quote[name]), 32);
+  }).join("");
+}
+
+function quoteCallArgs(quote) {
+  return quoteWords(quote) + signatureWords(quote.signature) + lockerHalfWords(quote);
+}
+
+// ПРЕДСКАЗАТЬ АДРЕС. Состав аргументов совпадает с createOrderAndFund БАЙТ В БАЙТ (адрес - хеш кода
+// создания, и подпись в него входит).
+export function encodePredict(quote) {
+  return FACTORY_METHODS.predict + quoteCallArgs(quote);
+}
+
+// СОЗДАТЬ И ВНЕСТИ. Вносившим становится msg.sender; его адрес уже внутри котировки, а фабрика сверяет его
+// с отправителем.
+export function encodeCreateOrderAndFund(quote) {
+  return FACTORY_METHODS.createOrderAndFund + quoteCallArgs(quote);
+}
+
+// СОЗДАТЬ И ВНЕСТИ, когда вносящий восстановлен ИЗ ЕГО ПОДПИСИ над ДАЙДЖЕСТОМ КОТИРОВКИ (#97, часть A).
+// Транзакцию шлёт кто угодно, поэтому подписантов ДВОЕ: `quote.signature` - подпись провайдера (её
+// проверяет эскроу), `depositorSignature` - подпись ВНОСЯЩЕГО (её проверяет фабрика и требует, чтобы
+// восстановленный адрес совпал с `quote.locker`). Обе - над ОДНИМ дайджестом котировки.
+export function encodeCreateOrderAndFundByDepositor(quote, depositorSignature) {
+  return FACTORY_METHODS.createOrderAndFundByDepositor + quoteWords(quote) +
+    signatureWords(quote.signature) + signatureWords(depositorSignature) + lockerHalfWords(quote);
+}
+
+// Ответ predict() - один адрес в 32-байтовом слове.
+export function decodeAddress(returnedHex) {
+  const hex = String(returnedHex || "").replace(/^0x/, "");
+  if (hex.length < 64) throw new Error("короткий ответ: " + returnedHex);
+  return "0x" + hex.slice(24, 64);
+}

package/engine/evm/fees.js

@@ -0,0 +1,90 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/fees.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.
+
+// Комиссия ArrakisSwap: ЧАСТЬ ПОДПИСАННОЙ КОТИРОВКИ (OrderQuote v7), а не настройка контракта.
+//
+// ГДЕ ЖИВЁТ СТАВКА. Раньше её и получателя назначала ФАБРИКА (или роутер) в неизменяемых полях, и клиент
+// спрашивал их у цепи (feeBps()/feeRecipient()/feeFor()). Теперь этих функций у контракта НЕТ: роутер удалён
+// (решение #76), а ставка, величина и получатель комиссии входят в ПОДПИСАННЫЙ набор условий ордера. Значит
+// источник правды ОДИН - котировка, и второго места быть не должно:
+//   * в настройках страницы ставки НЕТ; копия разошлась бы с подписанным набором;
+//   * у фабрики спрашивать нечего - она ничего о комиссии не знает;
+//   * величина в wei посчитана по формуле `amount * feeBps / 10000` (округление ВНИЗ) и здесь сверяется с
+//     этой же формулой ЗЕРКАЛОМ: расхождение обязано остановить подпись, а не превратиться в отказ эскроу
+//     (WrongAmount/BadFee) уже после неё.
+//
+// КТО ПЛАТИТ. Комиссию платит ПОЛЬЗОВАТЕЛЬ ИНТЕРФЕЙСА. Направление видно из ролей котировки: провайдер
+// забирает ETH - покупка (комиссия СВЕРХУ взноса), провайдер вносит ETH - продажа (комиссия ВЫЧЕТОМ из
+// выплаты, `amount - fee`). Провайдер не назван ни там, ни там - понять нечего, отказ.
+//
+// ОДНА ЕДИНИЦА ВРЕМЕНИ. Время в проекте - СЕКУНДЫ (сроки ордера, срок годности котировки, block.timestamp):
+// пересчёт между шкалами и был единственным местом, где ошибка на тысячу проходит молча.
+
+// Потолок ставки, зашитый в контракте (NinseiEscrow.MAX_FEE_BPS = 200 = 2%). Нужен здесь, чтобы отличить
+// осмысленную ставку от испорченной: читать мусор как ставку и считать по нему комиссию нельзя.
+export const MAX_FEE_BPS = 200;
+
+// ЗЕРКАЛО ФОРМУЛЫ КОНТРАКТА. Одно место на всю страницу: вторая копия разошлась бы с первой ровно там,
+// где это дороже всего - на величине, которую требует эскроу.
+export function feeWeiFor(amountWei, feeBps) {
+  const amount = BigInt(amountWei === null || amountWei === undefined || amountWei === "" ? 0 : amountWei);
+  const bps = BigInt(Number(feeBps) || 0);
+  if (amount < 0n || bps < 0n) throw new Error("комиссия: отрицательная сумма или ставка");
+  return (amount * bps) / 10000n;   // ВНИЗ, как в Solidity: amount * feeBps / 10000
+}
+
+const sameAddr = (a, b) => String(a || "").toLowerCase() === String(b || "").toLowerCase();
+const zeroAddr = (a) => !a || /^0x0{40}$/i.test(String(a));
+
+// ПАМЯТЬ О ПОСЛЕДНЕЙ ПОДПИСАННОЙ КОТИРОВКЕ. Ставка становится известна ТОЛЬКО с котировкой; до неё её нет,
+// и показывать вместо неё ноль или число из конфига значило бы врать. Проверки подставляют свои значения
+// через resetFeeCache + feeTermsFromQuote.
+let lastTerms = null;
+
+// СБРОС ПАМЯТИ. Нужен проверкам и любому повтору после смены котировки.
+export function resetFeeCache() {
+  lastTerms = null;
+}
+
+// КОМИССИЯ ИЗ КОТИРОВКИ. Возвращает ставку, величину (сверенную зеркалом), получателя и направление; при
+// ненулевой ставке без получателя - отказ (комиссия сгорела бы). Результат кладётся в память для экрана.
+export function feeTermsFromQuote(quote) {
+  if (!quote || typeof quote !== "object") throw new Error("нет подписанной котировки: комиссию и адрес реестра взять неоткуда");
+  const amount = BigInt(String(quote.amount));
+  const bps = Number(quote.feeBps === undefined || quote.feeBps === null ? 0 : quote.feeBps);
+  if (!Number.isFinite(bps) || bps < 0 || bps > MAX_FEE_BPS) throw new Error("ставка комиссии вне потолка: " + quote.feeBps);
+  const fee = feeWeiFor(amount, bps);
+  if (BigInt(String(quote.fee === undefined || quote.fee === null ? 0 : quote.fee)) !== fee) {
+    throw new Error("подписанная комиссия " + quote.fee + " расходится с формулой amount * rate (" + fee + ") - подпись не начата");
+  }
+  if (bps !== 0 && zeroAddr(quote.feeRecipient)) throw new Error("при ненулевой ставке получатель комиссии обязан быть назван");
+  const providerIsLocker = sameAddr(quote.locker, quote.provider);
+  const providerIsClaimer = sameAddr(quote.claimer, quote.provider);
+  if (providerIsLocker === providerIsClaimer) throw new Error("не понять, кто платит комиссию: провайдер не назван ни вносившим, ни забирающим");
+  const feeOnTop = providerIsClaimer;   // провайдер забирает ETH -> покупка -> комиссия сверху взноса
+  const terms = { bps, feeWei: fee, totalWei: feeOnTop ? amount + fee : amount, recipient: quote.feeRecipient || null, feeOnTop, legacy: false };
+  lastTerms = terms;
+  return terms;
+}
+
+// СИНХРОННЫЙ ДОСТУП К ПРОЧИТАННОМУ. Пусто - значит "ещё не читали либо не смогли": это НЕ ноль, и
+// вызывающий обязан закрыть подпись, а не посчитать комиссию нулевой.
+export function cachedFeeTerms() {
+  return lastTerms;
+}
+
+// СТАВКА ДЛЯ ПОКАЗА. Единственное место, откуда страница берёт число для строки разбивки цены. Ответа нет -
+// null, и экран говорит, что ставка ещё неизвестна.
+export function cachedFeeRate() {
+  if (!lastTerms || !Number.isFinite(Number(lastTerms.bps))) return null;
+  return Number(lastTerms.bps) / 10000;
+}
+
+// РАНЬШЕ ЭТА ФУНКЦИЯ ЧИТАЛА СТАВКУ У ЦЕПИ. Теперь читать не у чего: ставка - в подписанной котировке, и
+// приходит она вместе с нею (feeTermsFromQuote). Функция оставлена ради вызывающих экранов: до котировки она
+// честно возвращает то, что уже известно (обычно null - "ставка неизвестна"), и ничего не выдумывает.
+export async function ensureFeeTerms() {
+  return lastTerms;
+}