@ninsei-labs/sdk 0.39.0 → 0.39.2

package/engine/evm/factory.js

@@ -147,3 +147,109 @@ export function decodeAddress(returnedHex) {
   if (hex.length < 64) throw new Error("короткий ответ: " + returnedHex);
   return "0x" + hex.slice(24, 64);
 }
+
+
+// ============================================================================================
+// РЕАЛИЗАЦИЯ ЭСКРОУ: ЕЁ АДРЕС И ХЕШ ЕЁ КОДА (issue #114, поправка 2).
+// С #114 эскроу каждого ордера - КЛОН EIP-1167 одной общей реализации, а адрес реализации и хеш её кода
+// лежат у фабрики (implementation() / implementationCodeHash()). ФАБРИКА при создании ордера проверяет эту
+// пару; КЛИЕНТ обязан проверить ТУ ЖЕ пару, иначе клон исполнит чужой код, а денежные пути "пройдут" впустую
+// (delegatecall на адрес без кода УСПЕШЕН). Здесь - только чтение полей и вердикт; вызовы к цепи делает
+// носитель (session.js: readContract/readCode), поэтому функция чистая и проверяется без сети.
+// ============================================================================================
+
+// Селекторы посчитаны инструментом, не вручную:
+//   cast sig "implementation()"         -> 0x5c60da1b
+//   cast sig "implementationCodeHash()" -> 0xbc0a3981
+export const FACTORY_READS = {
+  implementation: "0x5c60da1b",
+  implementationCodeHash: "0xbc0a3981",
+};
+
+// Чтение поля фабрики без аргументов: calldata равен селектору.
+export function encodeFactoryRead(name) {
+  const sel = FACTORY_READS[name];
+  if (typeof sel !== "string" || !/^0x[0-9a-f]{8}$/.test(sel)) throw new Error("нет такого чтения фабрики: " + name);
+  return sel;
+}
+
+// implementation() - один адрес в 32-байтовом слове.
+export function decodeImplementation(returnedHex) {
+  return decodeAddress(returnedHex);
+}
+
+// implementationCodeHash() - одно слово bytes32.
+export function decodeImplementationCodeHash(returnedHex) {
+  const hex = String(returnedHex || "").replace(/^0x/, "");
+  if (hex.length < 64) throw new Error("короткий ответ implementationCodeHash(): " + returnedHex);
+  return "0x" + hex.slice(0, 64).toLowerCase();
+}
+
+// ВЕРДИКТ ПО РЕАЛИЗАЦИИ - те же три условия, что проверяет фабрика (и что закрывает поправки #114):
+//   1) адрес реализации назван и её КОД на цепи непуст: delegatecall на адрес без кода успешен, поэтому
+//      клон без реализации принял бы ETH, а markReady/claim/refund "прошли" бы, ничего не сделав;
+//   2) хеш кода реализации равен recorded-хешу фабрики (сравнение делает сама фабрика через codehash);
+//   3) recorded-хеш входит в политику интерфейса (список известных сборок) - если она задана.
+// Если передан hashCode (keccak256 байтов кода), сверяется и живой код: тогда вердикт не доверяет одному
+// лишь ответу фабрики, а пересчитывает хеш из eth_getCode.
+export function verifyFactoryImplementation({ implementation, implementationCodeHash, code, hashCode, policy } = {}) {
+  if (!implementation || !/^0x[0-9a-fA-F]{40}$/.test(String(implementation))) {
+    return { ok: false, why: "implementation-missing" };
+  }
+  if (!implementationCodeHash || !/^0x[0-9a-fA-F]{64}$/.test(String(implementationCodeHash))) {
+    return { ok: false, why: "code-hash-missing" };
+  }
+  if (code === undefined || code === null || code === "0x" || code === "0x0") {
+    return { ok: false, why: "implementation-has-no-code" };
+  }
+  const pinned = String(implementationCodeHash).toLowerCase();
+  if (Array.isArray(policy) && policy.length) {
+    if (!policy.map((h) => String(h).toLowerCase()).includes(pinned)) {
+      return { ok: false, why: "implementation-code-unknown", codeHash: pinned };
+    }
+  }
+  if (typeof hashCode === "function") {
+    const live = String(hashCode(code)).toLowerCase();
+    if (live !== pinned) return { ok: false, why: "implementation-code-mismatch", got: live, want: pinned };
+  }
+  return { ok: true, codeHash: pinned };
+}
+
+// ЧТЕНИЕ ПАРЫ У ФАБРИКИ + ВЕРДИКТ - ОДНО МЕСТО НА ВСЕ НОСИТЕЛИ (SDK, узел, сторож). Читает пару полей
+// фабрики (implementation() / implementationCodeHash()) и КОД по адресу реализации, затем применяет тот же
+// вердикт, что и фабрика при создании ордера (verifyFactoryImplementation выше). Цепь инжектится: read -
+// это eth_call ({to,data}) -> hex, code - это eth_getCode (address) -> hex. Модуль остаётся чистым: ни
+// одного импорта, ни одного сетевого вызова, поэтому проверяется без сети. Носители подставляют СВОИ
+// чтения (SDK - evmCall/evmCode кошелька страницы, узел и сторож - свой RPC). hashCode, если передан,
+// пересчитывает живой код: тогда вердикт не доверяет одному лишь ответу фабрики.
+export async function verifyFactoryImplementationOnChain({ factory, read, code, policy = null, hashCode = null } = {}) {
+  if (!factory || !/^0x[0-9a-fA-F]{40}$/.test(String(factory))) {
+    return { ok: false, why: "factory-missing" };
+  }
+  if (typeof read !== "function") return { ok: false, why: "no-chain-read" };
+  if (typeof code !== "function") return { ok: false, why: "no-code-read" };
+  let implRaw, hashRaw;
+  try {
+    implRaw = await read({ to: factory, data: FACTORY_READS.implementation });
+    hashRaw = await read({ to: factory, data: FACTORY_READS.implementationCodeHash });
+  } catch {
+    // ЧТЕНИЕ ПАРЫ НЕ УДАЛОСЬ - ЭТО НАЗВАННЫЙ ОТКАЗ, А НЕ МОЛЧАНИЕ. Старая фабрика (без этих геттеров)
+    // отвечает revert'ом: пара не прочитана, вердикта нет, и носитель обязан отказать.
+    return { ok: false, why: "implementation-unreadable", factory: String(factory).toLowerCase() };
+  }
+  let implementation, implementationCodeHash;
+  try {
+    implementation = decodeImplementation(implRaw);
+    implementationCodeHash = decodeImplementationCodeHash(hashRaw);
+  } catch {
+    return { ok: false, why: "implementation-unreadable", factory: String(factory).toLowerCase() };
+  }
+  let liveCode;
+  try {
+    liveCode = await code(implementation);
+  } catch {
+    return { ok: false, why: "implementation-code-unreadable", implementation };
+  }
+  const verdict = verifyFactoryImplementation({ implementation, implementationCodeHash, code: liveCode, hashCode, policy });
+  return { ...verdict, implementation, implementationCodeHash };
+}

package/engine/evm/funding.js

@@ -104,17 +104,17 @@ export function toWei(human, decimals = 18) {
   return BigInt(intPart || "0") * 10n ** BigInt(decimals) + BigInt(frac || "0");
 }
 
-// ГАЗ ВЫСТАВЛЯЕМ САМИ И С ЗАПАСОМ - ЭТО НЕ ПЕРЕСТРАХОВКА, А ЛЕЧЕНИЕ КОНКРЕТНОЙ ОШИБКИ.
-// createOrder и lock уходят двумя транзакциями подряд. Кошелёк оценивает вторую в момент подписи, когда
-// эскроу ещё НЕ создан, поэтому считает по пустому адресу обычный перевод: 21000 + стоимость данных. На
-// живом контракте это дало лимит 24167 при реальной надобности 50294 - и lock упал по газу, хотя вызов
-// был полностью верный (та же сумма, тот же отправитель, тот же адрес). Оценку кошелька здесь доверять
-// нельзя, поэтому лимиты задаём явно, с запасом от измеренных значений.
-const GAS_CREATE_ORDER = 1_200_000n;   // измерено 612567 - запас ~2x: создаётся целый контракт
-// Создание И взнос в одной транзакции: создание контракта плюс запись взноса, запас намеренно большой -
-// недобор лимита стоит человеку подписи, а лишний газ в лимите на Arbitrum почти ничего не стоит.
-const GAS_CREATE_ORDER_AND_FUND = 1_500_000n;
-// GAS_LOCK УБРАН вместе с вызовом lock(bytes): взнос идёт в той же транзакции, что и создание ордера.
+// ГАЗ ВЫСТАВЛЯЕМ САМИ И С ЗАПАСОМ - ЭТО ЛЕЧЕНИЕ КОНКРЕТНОЙ ОШИБКИ, А НЕ ПЕРЕСТРАХОВКА.
+// createOrderAndFund уходит ОДНОЙ транзакцией, но кошелёк оценивает её по адресу, где эскроу ещё НЕ создан:
+// вместо создания клона и записи взноса он считает обычный перевод (21000 плюс данные). Оценку кошелька
+// здесь доверять нельзя, поэтому лимит задаём явно, с запасом от ИЗМЕРЕННОГО значения.
+// ИЗМЕРЕНО: полный createOrderAndFund после перехода на клоны EIP-1167 - 315 530 газа (у прежнего целого
+// контракта было 1 190 683); замер и методика - в описании PR в репозитории контрактов. Лимит примерно
+// вдвое выше измеренного: недобор стоит человеку подписи, а лишний газ в лимите почти ничего не стоит.
+const GAS_CREATE_ORDER_AND_FUND = 700_000n;
+// ОТДЕЛЬНОЙ КОНСТАНТЫ «СОЗДАНИЕ БЕЗ ВЗНОСА» НЕТ: целого контракта больше не создаётся - эскроу каждого
+// ордера есть клон EIP-1167 одной общей реализации, условия лежат в коде клона, а фабрика умеет только
+// createOrderAndFund. GAS_LOCK УБРАН вместе с вызовом lock(bytes): взнос идёт в той же транзакции.
 
 // СОБЫТИЕ OrderCreated: topic0 посчитан по фактической подписи (и сверяется проверкой watchtower),
 // topics = [topic0, escrow, locker, claimer]; в data - оба обязательства, обе точки, сумма, readyBy, t1, соль.

package/engine/evm/gasReserve.js

@@ -1,88 +1,88 @@
-// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/gasReserve.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, часть B): ОТМЕТКА ГОТОВНОСТИ И ВОЗМОЖНЫЙ ВОЗВРАТ.
-//
-// СУТЬ. В прямом обмене человек вносит средства в эскроу, а после прихода XMR сам зовёт markReady (когда XMR
-// подтверждены) либо refund (когда сделка не состоялась). Оба вызова стоят газа в НАТИВНОЙ монете сети, и у
-// человека, пришедшего из USDC, своего натива нет. Поэтому ДО котировки решается, СКОЛЬКО НАТИВА ОСТАВИТЬ под
-// эти два вызова; решение показывается и в ETH, и в долларах, а строкой входит в разбивку цены.
-//
-// ПОЧЕМУ ЧИСТЫЕ ФУНКЦИИ. Решение стоит денег и обязано проверяться без сети (tools/check-buy-gas-reserve.mjs)
-// и считаться ОДНИМ И ТЕМ ЖЕ кодом на экране и в прогоне. Сеть касается только чтения цены газа - его
-// подставляет вызывающий (www/js/evm/prices.js кладёт gasPriceWei в живые цены, экран передаёт его сюда).
-//
-// ЧИСЛА НЕ ВЫДУМАНЫ. Пределы газа - те же, с которыми НАШ ЖЕ код отправляет обе транзакции
-// (движок сделки теперь в пакете: sdk/src/swap-flow.mjs - markReadyOrder - gas 120000, refundOrder - gas 250000). Проверка
-// tools/check-buy-gas-reserve.mjs сверяет обе константы со строками того файла, поэтому правка одного места
-// без другого краснит прогон - ровно так же, как это сделано для газа забора в rfq/reverseGas.mjs.
-//
-// ПОЧЕМУ ЗАПАС ФИКСИРУЕТСЯ ДО КОТИРОВКИ. `amount` ордера входит в ПОДПИСАННУЮ котировку, и решение о запасе
-// меняет итоговую сумму взноса; значит оно принимается ДО запроса котировки и дальше не пересчитывается.
-// Экран кладёт готовый план в состояние формы (www/js/ui/views/swapForm.js), а экран подписи пользуется тем
-// же зафиксированным планом - второй пересчёт разошёлся бы с первым.
-
-// ПРЕДЕЛЫ ГАЗА - ИЗ НАШЕГО ЖЕ КОДА. Строки-источники: sdk/src/swap-flow.mjs (gas: 120_000n у отметки и
-// gas: 250_000n у возврата). Заниженный предел - это отказ уже после раскрытия половины; неиспользованный
-// газ в лимите не списывается, поэтому запас берётся с запасом.
-export const ORDER_READY_GAS_LIMIT = 120_000n;   // markReady - sdk/src/swap-flow.mjs markReadyOrder
-export const ORDER_REFUND_GAS_LIMIT = 250_000n;  // refund   - sdk/src/swap-flow.mjs refundOrder
-export const ORDER_GAS_LIMIT = ORDER_READY_GAS_LIMIT + ORDER_REFUND_GAS_LIMIT;
-
-const toBig = (v) => {
-  if (v === null || v === undefined || v === "") return null;
-  try { return BigInt(typeof v === "bigint" ? v : String(v)); } catch { return null; }
-};
-
-// СКОЛЬКО ВЕЙ НУЖНО НА ОБА ВЫЗОВА. Цену газа даёт цепь, пределы - наши. Ноль цены и нечитаемое число
-// означают «не измерено», и это НЕ ноль газа: неизвестное требование обязано называться, а не выдаваться за
-// ноль (то же правило, что у газа забора: rfq/reverseGas.mjs).
-export function orderGasReserveWei({ gasPriceWei, readyGasLimit = ORDER_READY_GAS_LIMIT, refundGasLimit = ORDER_REFUND_GAS_LIMIT } = {}) {
-  const gp = toBig(gasPriceWei);
-  if (gp === null || gp <= 0n) return null;
-  const ready = toBig(readyGasLimit);
-  const refund = toBig(refundGasLimit);
-  if (ready === null || refund === null || ready <= 0n || refund <= 0n) return null;
-  return gp * (ready + refund);
-}
-
-// ПОКАЗ В ОБЕИХ ВЕЛИЧИНАХ. У человека, пришедшего из USDC, нет чувства масштаба ETH, поэтому запас показан и
-// в ETH, и в долларах. Доллар - оценка по живому курсу натива; нет курса - нет и оценки (null), а не выдумка.
-export function gasReserveDisplay({ reserveWei, nativeUsd, decimals = 18 } = {}) {
-  const w = toBig(reserveWei);
-  if (w === null || w <= 0n) return null;
-  const native = Number(w) / 10 ** decimals;
-  const usd = Number.isFinite(Number(nativeUsd)) && Number(nativeUsd) > 0 ? native * Number(nativeUsd) : null;
-  return { native, usd };
-}
-
-// РЕШЕНИЕ ПО ГАЛОЧКЕ. Галочка НУЖНА, только когда своего натива НЕ ХВАТАЕТ на оба вызова; при достатке ETH
-// она не показывается вовсе - человек платит своим газом, и просить у него нечего. Нечитаемый баланс натива -
-// отдельное состояние: запас предлагаем (лучше предложить, чем промолчать о нехватке), и это названо полем.
-export function gasReserveChoice({ nativeBalanceWei, reserveWei } = {}) {
-  const need = toBig(reserveWei);
-  if (need === null || need <= 0n) return { measured: false, enough: null, show: false, balanceUnread: false };
-  const have = toBig(nativeBalanceWei);
-  if (have === null) return { measured: true, enough: false, show: true, balanceUnread: true };
-  return { measured: true, enough: have >= need, show: have < need, balanceUnread: false };
-}
-
-// ПОЛНОЕ РЕШЕНИЕ ОДНИМ ОБЪЕКТОМ - именно оно фиксируется в состоянии формы до котировки. Все числовые поля -
-// строки либо null: так план переживает запись и чтение, и BigInt не превращается в «[object BigInt]».
-export function orderGasReservePlan({ gasPriceWei = null, nativeBalanceWei = null, nativeUsd = null, decimals = 18 } = {}) {
-  const reserveWei = orderGasReserveWei({ gasPriceWei });
-  const display = reserveWei === null ? null : gasReserveDisplay({ reserveWei, nativeUsd, decimals });
-  const choice = gasReserveChoice({ nativeBalanceWei, reserveWei });
-  return {
-    measured: reserveWei !== null,
-    gasPriceWei: gasPriceWei === null || gasPriceWei === undefined ? null : String(gasPriceWei),
-    reserveWei: reserveWei === null ? null : reserveWei.toString(),
-    native: display ? display.native : null,
-    usd: display ? display.usd : null,
-    enough: choice.enough,
-    show: choice.show,
-    balanceUnread: Boolean(choice.balanceUnread),
-  };
-}
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/gasReserve.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, часть B): ОТМЕТКА ГОТОВНОСТИ И ВОЗМОЖНЫЙ ВОЗВРАТ.
+//
+// СУТЬ. В прямом обмене человек вносит средства в эскроу, а после прихода XMR сам зовёт markReady (когда XMR
+// подтверждены) либо refund (когда сделка не состоялась). Оба вызова стоят газа в НАТИВНОЙ монете сети, и у
+// человека, пришедшего из USDC, своего натива нет. Поэтому ДО котировки решается, СКОЛЬКО НАТИВА ОСТАВИТЬ под
+// эти два вызова; решение показывается и в ETH, и в долларах, а строкой входит в разбивку цены.
+//
+// ПОЧЕМУ ЧИСТЫЕ ФУНКЦИИ. Решение стоит денег и обязано проверяться без сети (tools/check-buy-gas-reserve.mjs)
+// и считаться ОДНИМ И ТЕМ ЖЕ кодом на экране и в прогоне. Сеть касается только чтения цены газа - его
+// подставляет вызывающий (www/js/evm/prices.js кладёт gasPriceWei в живые цены, экран передаёт его сюда).
+//
+// ЧИСЛА НЕ ВЫДУМАНЫ. Пределы газа - те же, с которыми НАШ ЖЕ код отправляет обе транзакции
+// (движок сделки теперь в пакете: sdk/src/swap-flow.mjs - markReadyOrder - gas 120000, refundOrder - gas 250000). Проверка
+// tools/check-buy-gas-reserve.mjs сверяет обе константы со строками того файла, поэтому правка одного места
+// без другого краснит прогон - ровно так же, как это сделано для газа забора в rfq/reverseGas.mjs.
+//
+// ПОЧЕМУ ЗАПАС ФИКСИРУЕТСЯ ДО КОТИРОВКИ. `amount` ордера входит в ПОДПИСАННУЮ котировку, и решение о запасе
+// меняет итоговую сумму взноса; значит оно принимается ДО запроса котировки и дальше не пересчитывается.
+// Экран кладёт готовый план в состояние формы (www/js/ui/views/swapForm.js), а экран подписи пользуется тем
+// же зафиксированным планом - второй пересчёт разошёлся бы с первым.
+
+// ПРЕДЕЛЫ ГАЗА - ИЗ НАШЕГО ЖЕ КОДА. Строки-источники: sdk/src/swap-flow.mjs (gas: 120_000n у отметки и
+// gas: 250_000n у возврата). Заниженный предел - это отказ уже после раскрытия половины; неиспользованный
+// газ в лимите не списывается, поэтому запас берётся с запасом.
+export const ORDER_READY_GAS_LIMIT = 120_000n;   // markReady - sdk/src/swap-flow.mjs markReadyOrder
+export const ORDER_REFUND_GAS_LIMIT = 250_000n;  // refund   - sdk/src/swap-flow.mjs refundOrder
+export const ORDER_GAS_LIMIT = ORDER_READY_GAS_LIMIT + ORDER_REFUND_GAS_LIMIT;
+
+const toBig = (v) => {
+  if (v === null || v === undefined || v === "") return null;
+  try { return BigInt(typeof v === "bigint" ? v : String(v)); } catch { return null; }
+};
+
+// СКОЛЬКО ВЕЙ НУЖНО НА ОБА ВЫЗОВА. Цену газа даёт цепь, пределы - наши. Ноль цены и нечитаемое число
+// означают «не измерено», и это НЕ ноль газа: неизвестное требование обязано называться, а не выдаваться за
+// ноль (то же правило, что у газа забора: rfq/reverseGas.mjs).
+export function orderGasReserveWei({ gasPriceWei, readyGasLimit = ORDER_READY_GAS_LIMIT, refundGasLimit = ORDER_REFUND_GAS_LIMIT } = {}) {
+  const gp = toBig(gasPriceWei);
+  if (gp === null || gp <= 0n) return null;
+  const ready = toBig(readyGasLimit);
+  const refund = toBig(refundGasLimit);
+  if (ready === null || refund === null || ready <= 0n || refund <= 0n) return null;
+  return gp * (ready + refund);
+}
+
+// ПОКАЗ В ОБЕИХ ВЕЛИЧИНАХ. У человека, пришедшего из USDC, нет чувства масштаба ETH, поэтому запас показан и
+// в ETH, и в долларах. Доллар - оценка по живому курсу натива; нет курса - нет и оценки (null), а не выдумка.
+export function gasReserveDisplay({ reserveWei, nativeUsd, decimals = 18 } = {}) {
+  const w = toBig(reserveWei);
+  if (w === null || w <= 0n) return null;
+  const native = Number(w) / 10 ** decimals;
+  const usd = Number.isFinite(Number(nativeUsd)) && Number(nativeUsd) > 0 ? native * Number(nativeUsd) : null;
+  return { native, usd };
+}
+
+// РЕШЕНИЕ ПО ГАЛОЧКЕ. Галочка НУЖНА, только когда своего натива НЕ ХВАТАЕТ на оба вызова; при достатке ETH
+// она не показывается вовсе - человек платит своим газом, и просить у него нечего. Нечитаемый баланс натива -
+// отдельное состояние: запас предлагаем (лучше предложить, чем промолчать о нехватке), и это названо полем.
+export function gasReserveChoice({ nativeBalanceWei, reserveWei } = {}) {
+  const need = toBig(reserveWei);
+  if (need === null || need <= 0n) return { measured: false, enough: null, show: false, balanceUnread: false };
+  const have = toBig(nativeBalanceWei);
+  if (have === null) return { measured: true, enough: false, show: true, balanceUnread: true };
+  return { measured: true, enough: have >= need, show: have < need, balanceUnread: false };
+}
+
+// ПОЛНОЕ РЕШЕНИЕ ОДНИМ ОБЪЕКТОМ - именно оно фиксируется в состоянии формы до котировки. Все числовые поля -
+// строки либо null: так план переживает запись и чтение, и BigInt не превращается в «[object BigInt]».
+export function orderGasReservePlan({ gasPriceWei = null, nativeBalanceWei = null, nativeUsd = null, decimals = 18 } = {}) {
+  const reserveWei = orderGasReserveWei({ gasPriceWei });
+  const display = reserveWei === null ? null : gasReserveDisplay({ reserveWei, nativeUsd, decimals });
+  const choice = gasReserveChoice({ nativeBalanceWei, reserveWei });
+  return {
+    measured: reserveWei !== null,
+    gasPriceWei: gasPriceWei === null || gasPriceWei === undefined ? null : String(gasPriceWei),
+    reserveWei: reserveWei === null ? null : reserveWei.toString(),
+    native: display ? display.native : null,
+    usd: display ? display.usd : null,
+    enough: choice.enough,
+    show: choice.show,
+    balanceUnread: Boolean(choice.balanceUnread),
+  };
+}