@ninsei-labs/sdk 0.39.0

package/engine/evm/injected.js

@@ -0,0 +1,175 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/injected.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.
+
+// Браузерные кошельки: обнаружение по EIP-6963 и подключение по EIP-1193.
+//
+// ПОЧЕМУ EIP-6963, А НЕ window.ethereum.isMetaMask. При двух установленных расширениях
+// window.ethereum - это «кто успел последним», и угадывание по флагам даёт чужие имена и иконки:
+// пользователь видит «MetaMask», а подключается Rabby. EIP-6963 решает это стандартно: кошелёк
+// объявляет себя событием `eip6963:announceProvider` с именем, иконкой и своим провайдером, а
+// страница просит объявиться событием `eip6963:requestProvider`. Так список кошельков настоящий,
+// и он же обновляется, если пользователь поставил расширение при открытой вкладке.
+//
+// window.ethereum остаётся фолбэком для старых кошельков, которые 6963 ещё не умеют. В этом
+// случае честное имя - «Browser wallet»: назвать его MetaMask мы не имеем права, не проверив.
+//
+// Здесь НЕТ состояния: этот модуль только находит провайдеров и делает рукопожатие. Состояние,
+// балансы и смена сети живут в evm/session.js - общие для обоих коннекторов.
+
+const ANNOUNCE = "eip6963:announceProvider";
+const REQUEST = "eip6963:requestProvider";
+
+// Коды EIP-1193, которые важны на экране: отказ пользователя - это не ошибка приложения.
+export const USER_REJECTED = 4001;
+
+export function isUserRejection(error) {
+  const code = error && (error.code || (error.data && error.data.originalError && error.data.originalError.code));
+  if (code === USER_REJECTED) return true;
+  return /rejected|denied|cancell?ed|closed by user/i.test(String((error && error.message) || error || ""));
+}
+
+// Человеческое имя для фолбэка: флаги - единственное, что есть у старых кошельков.
+function fallbackName(eth) {
+  if (!eth) return null;
+  if (eth.isMetaMask) return "MetaMask";
+  if (eth.isRabby) return "Rabby";
+  if (eth.isCoinbaseWallet) return "Coinbase Wallet";
+  if (eth.isBraveWallet) return "Brave Wallet";
+  if (eth.isFrame) return "Frame";
+  return "Browser wallet";
+}
+
+// Собрать список кошельков: сначала объявившиеся по EIP-6963, затем фолбэк window.ethereum.
+// timeoutMs нужен потому, что announceProvider - событие: без паузы список будет пустым даже при
+// установленном кошельке (у расширения свой темп инициализации).
+export function discoverWallets({ win = globalThis, timeoutMs = 250 } = {}) {
+  const found = [];
+  const seen = new Set();
+  const add = (entry) => {
+    const key = entry.rdns || entry.uuid || entry.name;
+    if (seen.has(key)) return;
+    seen.add(key);
+    found.push(entry);
+  };
+
+  const onAnnounce = (event) => {
+    const detail = event && event.detail;
+    if (!detail || !detail.provider || !detail.info) return;
+    add({
+      uuid: detail.info.uuid || null,
+      name: detail.info.name || "Browser wallet",
+      icon: detail.info.icon || null,
+      rdns: detail.info.rdns || null,
+      provider: detail.provider,
+      source: "eip6963",
+    });
+  };
+
+  if (win && typeof win.addEventListener === "function") {
+    win.addEventListener(ANNOUNCE, onAnnounce);
+    if (typeof win.dispatchEvent === "function") {
+      // Просим объявиться; ответы придут асинхронно, поэтому ждём короткую паузу.
+      win.dispatchEvent(new Event(REQUEST));
+    }
+  }
+
+  return new Promise((resolve) => {
+    const finish = () => {
+      if (win && typeof win.removeEventListener === "function") win.removeEventListener(ANNOUNCE, onAnnounce);
+      // Фолбэк: старый кошелёк, который 6963 не умеет, но window.ethereum выставил.
+      // providers (массив) бывает, когда установлено несколько кошельков без поддержки 6963.
+      const legacy = win && win.ethereum;
+      if (!found.length && legacy) {
+        const list = Array.isArray(legacy.providers) && legacy.providers.length ? legacy.providers : [legacy];
+        for (const p of list) {
+          add({ name: fallbackName(p), icon: null, rdns: null, provider: p, source: "legacy" });
+        }
+      }
+      resolve(found);
+    };
+    if (timeoutMs > 0 && typeof setTimeout === "function") setTimeout(finish, timeoutMs);
+    else finish();
+  });
+}
+
+// Подписка на «кошелёк появился». Нужна, чтобы список в модалке не был снимком на момент открытия:
+// пользователь может поставить расширение, не перезагружая страницу.
+//
+// Работаем именно с самим объявлением, а не с повторным обнаружением: событие EIP-6963 несёт и имя,
+// и провайдер кошелька, а события не переигрываются - кошелёк, объявившийся до нашей подписки, при
+// повторном запросе ответит снова, но снимок всё равно был бы потерян. Так список только дополняется.
+export function watchWallets(fn, { win = globalThis } = {}) {
+  if (!win || typeof win.addEventListener !== "function") return () => {};
+  const known = new Map();
+  const publish = () => fn([...known.values()]);
+  const onAnnounce = (event) => {
+    const detail = event && event.detail;
+    if (!detail || !detail.provider || !detail.info) return;
+    const key = detail.info.rdns || detail.info.uuid || detail.info.name;
+    if (!key || known.has(key)) return;
+    known.set(key, {
+      uuid: detail.info.uuid || null,
+      name: detail.info.name || "Browser wallet",
+      icon: detail.info.icon || null,
+      rdns: detail.info.rdns || null,
+      provider: detail.provider,
+      source: "eip6963",
+    });
+    publish();
+  };
+  win.addEventListener(ANNOUNCE, onAnnounce);
+  // Просим объявиться: кошельки, которые уже установлены, ответят прямо сейчас и попадут в список.
+  // Пустой список наружу не отдаём - иначе UI очищался бы просто потому, что кошельков нет.
+  if (typeof win.dispatchEvent === "function") win.dispatchEvent(new Event(REQUEST));
+  return () => win.removeEventListener(ANNOUNCE, onAnnounce);
+}
+
+// Рукопожатие EIP-1193: просим аккаунты (здесь кошелёк спросит разрешение) и узнаём сеть.
+export async function handshake(provider) {
+  if (!provider || typeof provider.request !== "function") {
+    throw new Error("Этот кошелёк не умеет EIP-1193 (нет request)");
+  }
+  const accounts = await provider.request({ method: "eth_requestAccounts" });
+  const address = Array.isArray(accounts) ? accounts[0] : null;
+  const chainIdHex = await provider.request({ method: "eth_chainId" });
+  return { address: address || null, chainId: Number(chainIdHex) || null };
+}
+
+// Тихая проверка «сайт уже разрешён этому кошельку» - для восстановления после перезагрузки.
+// eth_accounts НЕ показывает окно кошелька: пустой ответ значит «разрешения нет», и это нормальное
+// состояние, а не ошибка. Именно поэтому нельзя звать здесь eth_requestAccounts: страница при
+// загрузке не должна выкидывать окно подключения.
+export async function silentAccounts(provider) {
+  if (!provider || typeof provider.request !== "function") return [];
+  try {
+    const accounts = await provider.request({ method: "eth_accounts" });
+    return Array.isArray(accounts) ? accounts : [];
+  } catch {
+    return [];
+  }
+}
+
+// Почему кошелёк мог не открыться - переводим код ошибки в понятную причину.
+//
+// -32002 - самая частая причина «нажал, а окно не появилось»: у кошелька уже есть открытый
+// запрос (окно висит на другом экране/вкладке, или предыдущая попытка не завершена).
+export function explainInjectedError(e, label = "Кошелёк") {
+  const code = e && (e.code || (e.data && e.data.originalError && e.data.originalError.code));
+  const message = String((e && e.message) || e);
+  if (code === -32002 || /already pending|already processing/i.test(message)) {
+    return (
+      label +
+      ": в кошельке уже есть незавершённый запрос, поэтому новое окно не открылось. " +
+      "Открой расширение, заверши или отмени тот запрос и нажми снова."
+    );
+  }
+  if (/no provider|not connected|provider is disconnected|undefined is not a function/i.test(message)) {
+    return label + ": расширение не отвечает (браузер мог выгрузить его или страница открыта не там, где оно работает).";
+  }
+  if (/user rejected|user denied|rejected by user/i.test(message) || code === 4001) {
+    return label + ": запрос отклонён в кошельке.";
+  }
+  return label + ": " + message;
+}

package/engine/evm/permit.js

@@ -0,0 +1,125 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/permit.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.
+
+// РАЗРЕШЕНИЕ НА ТОКЕН ДЛЯ ПОКУПКИ БЕЗ СВОЕГО ETH (issue #97, часть C): что именно умеет токен и чего не хватает.
+//
+// ЧТО ЗДЕСЬ И ЧЕГО НЕТ. Здесь ТОЛЬКО селекторы, сборка calldata и ЧЕСТНЫЙ вердикт о том, хватает ли протоколу
+// разрешения по подписи. Ни одного вывода «у USDC permit есть» из памяти тут не записано: такой вывод -
+// догадка, а догадка об учётной функции токена стоит денег. Возможность ПРОВЕРЯЕТСЯ чтением цепи (есть ли у
+// адреса код, отвечает ли DOMAIN_SEPARATOR словом, отвечает ли nonces(owner)), и вердикт умеет говорить
+// «неизвестно» - третьим значением, а не одним из двух.
+//
+// ЧТО УЖЕ ПРОВЕРЕНО ПРО НАШУ НОГУ ОБМЕНА (docs/48, www/js/evm/dexExec.js): разрешение нужно РОУТЕРУ обычным
+// approve. Роутер этой сборки Permit2 НЕ ЗНАЕТ (`permit2()` у него откатывает, перенос оплачивает
+// TransferHelper.safeTransferFrom от msg.sender). Значит Permit2 в реестре лежит для БУДУЩЕГО пути
+// финансирования, а не потому, что этот своп его вызывает.
+//
+// ПОЧЕМУ ОДНОЙ ТРАНЗАКЦИИ ЗДЕСЬ НЕТ, И ЭТО НЕ ЗАБЫВЧИВОСТЬ. Своп платит ТОТ, КОГО роутер видит `msg.sender`.
+// Пользователь без ETH не может отправить ни approve, ни своп, ни внесение. Внести за него и списать USDC по
+// его подписи может только КОНТРАКТ-исполнитель (EOA чужую подпись на списание предъявить не может). Такого
+// контракта в репозитории нет и план 61 его не называет, поэтому `usdcWithoutEthVerdict` ОТКАЗЫВАЕТСЯ назвать
+// путь исполняемым и говорит, чего не хватает. Собирать calldata «на всякий случай» - значит выдать догадку
+// за согласие (ровно то, что док 48 называет ловушкой подставленного получателя).
+//
+// ПОДПИСЬ ВНОСЯЩЕГО (www/js/evm/depositor.js) - ДРУГОЕ РАЗРЕШЕНИЕ. Оно даёт релейщику право ОТПРАВИТЬ
+// транзакцию создания ордера, но не право списать токен. Одно другое не заменяет: списание USDC требует
+// отдельного разрешения ПО ТОКЕНУ (approve или permit), и оно адресуется тому, кто тянет токен.
+
+// Селекторы ERC-20 и EIP-2612. Рядом с каждым - строка подписи, из которой он посчитан: проверка
+// (tools/check-usdc-without-eth.mjs) пересчитывает keccak256 от этих строк, поэтому селектор не может
+// разойтись с подписью молча.
+export const ERC20_METHOD = {
+  approve: { hex: "0x095ea7b3", signature: "approve(address,uint256)" },
+  allowance: { hex: "0xdd62ed3e", signature: "allowance(address,address)" },
+  balanceOf: { hex: "0x70a08231", signature: "balanceOf(address)" },
+};
+export const EIP2612_METHOD = {
+  permit: { hex: "0xd505accf", signature: "permit(address,address,uint256,uint256,uint8,bytes32,bytes32)" },
+  nonces: { hex: "0x7ecebe00", signature: "nonces(address)" },
+  DOMAIN_SEPARATOR: { hex: "0x3644e515", signature: "DOMAIN_SEPARATOR()" },
+};
+
+const hexBody = (s) => String(s === undefined || s === null ? "" : s).replace(/^0x/, "");
+const isAddr = (a) => /^0x[0-9a-fA-F]{40}$/.test(String(a || ""));
+const addrWord = (a) => hexBody(a).toLowerCase().padStart(64, "0");
+const uintWord = (v) => BigInt(v).toString(16).padStart(64, "0");
+const wordBytes = (hex) => {
+  const b = hexBody(hex);
+  // ПУСТОЙ ОТВЕТ - ЭТО «НЕ ПРОЧИТАЛИ», А НЕ «НОЛЬ БАЙТ». Так eth_call отвечает по адресу без кода:
+  // показать это как «нет домена» значило бы принять незнание за отказ токена.
+  if (b.length === 0) return null;
+  return b.length % 2 ? null : b.length / 2;
+};
+
+// calldata для разрешения по подписи (EIP-2612). Подпись - r || s || v (65 байт); v - в {27,28}.
+export function encodePermit({ owner, spender, value, deadline, signature }) {
+  if (!isAddr(owner) || !isAddr(spender)) throw new Error("permit: owner и spender обязаны быть адресами");
+  const hex = hexBody(signature);
+  if (hex.length !== 130) throw new Error("permit: подпись обязана быть 65 байт, а пришло " + hex.length / 2);
+  let v = parseInt(hex.slice(128, 130), 16);
+  if (v < 27) v += 27;
+  if (v !== 27 && v !== 28) throw new Error("permit: v вне {27,28}: " + v);
+  return EIP2612_METHOD.permit.hex +
+    addrWord(owner) + addrWord(spender) + uintWord(value) + uintWord(deadline) +
+    uintWord(v) + hex.slice(0, 64) + hex.slice(64, 128);
+}
+
+export const encodeNonces = (owner) => EIP2612_METHOD.nonces.hex + addrWord(owner);
+export const encodeDomainSeparator = () => EIP2612_METHOD.DOMAIN_SEPARATOR.hex;
+export const encodeApprove = ({ spender, amountWei }) => ERC20_METHOD.approve.hex + addrWord(spender) + uintWord(amountWei);
+
+/**
+ * Умеет ли ЭТОТ адрес разрешение по подписи (EIP-2612). Ответ - ТРИ состояния, и это не педантизм:
+ * «не проверено» обязано отличаться от «нет».
+ *   supported === true  - код есть, DOMAIN_SEPARATOR отвечает словом, nonces(owner) отвечает словом,
+ *                         и в байткоде присутствует селектор permit;
+ *   supported === false - код есть, но одного из признаков НЕТ (тогда разрешение по подписи недоступно);
+ *   supported === null  - прочитать не удалось (нет кода/пустой ответ): это НЕ «нет permit», это «не знаем».
+ */
+export function permitSupportVerdict({ code = null, domainSeparator = null, nonces = null, owner = null } = {}) {
+  const codeHex = hexBody(code);
+  if (codeHex.length === 0) return { supported: null, kind: "no-code", reason: "по адресу токена нет кода - это не токен, и разрешение читать не у чего" };
+  if (!isAddr(owner)) return { supported: null, kind: "no-owner", reason: "владелец не назван - nonces(owner) прочитать нечем" };
+  const dsBytes = wordBytes(domainSeparator);
+  if (dsBytes === null) return { supported: null, kind: "domain-unread", reason: "DOMAIN_SEPARATOR не отвечает 32 байтами: читать не удалось" };
+  if (dsBytes !== 32) return { supported: false, kind: "domain-empty", reason: "DOMAIN_SEPARATOR вернул " + dsBytes + " байт вместо 32: EIP-712-домен не заявлен" };
+  const nonceBytes = wordBytes(nonces);
+  if (nonceBytes === null) return { supported: null, kind: "nonces-unread", reason: "nonces(owner) не отвечает: читать не удалось" };
+  if (nonceBytes !== 32) return { supported: false, kind: "nonces-empty", reason: "nonces(owner) вернул " + nonceBytes + " байт вместо 32: EIP-2612-счётчика нет" };
+  if (!codeHex.toLowerCase().includes(EIP2612_METHOD.permit.hex.slice(2))) {
+    return { supported: false, kind: "permit-selector-absent", reason: "в байткоде токена нет селектора permit: разрешения по подписи токен не предоставляет" };
+  }
+  return { supported: true, kind: "eip2612", reason: "токен заявляет EIP-712-домен, счётчик nonces и селектор permit" };
+}
+
+/**
+ * Можно ли провести покупку за токен БЕЗ своего ETH ОДНОЙ транзакцией. Вердикт говорит ИМЕННО то, чего не
+ * хватает, и НЕ выдаёт calldata, пока путь не исполним полностью.
+ * @param {{ orchestrator?: string|null, permitSupported?: boolean|null, token?: string|null }} args
+ */
+export function usdcWithoutEthVerdict({ orchestrator = null, permitSupported = null, token = null } = {}) {
+  // ПЕРВЫЙ И ГЛАВНЫЙ ОТКАЗ, и он не про токен. Своп платит msg.sender (роутер), а чужую подпись на списание
+  // может предъявить только КОНТРАКТ. Без исполнителя однотранзакционный путь не существует ВООБЩЕ - и это
+  // не зависит от того, есть ли у токена permit.
+  if (!isAddr(orchestrator)) {
+    return {
+      ok: false, blocked: true, kind: "no-orchestrator",
+      reason: "нет контракта-исполнителя: списать токен по подписи пользователя и внести натив в эскроу одной транзакцией может только контракт, а в этой сборке его нет. Подпись вносящего без него даёт релейщику право ОТПРАВИТЬ создание ордера, но не право списать токен",
+    };
+  }
+  if (permitSupported === false) {
+    return {
+      ok: false, blocked: true, kind: "token-no-permit",
+      reason: "у токена нет разрешения по подписи (EIP-2612): разрешение придётся выдавать отдельным approve, то есть отдельной транзакцией - одной транзакцией путь не собирается",
+    };
+  }
+  if (permitSupported !== true) {
+    return {
+      ok: false, blocked: true, kind: "permit-unproven",
+      reason: "неизвестно, умеет ли токен разрешение по подписи: «не проверено» - это не «можно». Возможность обязана быть прочитана у цепи до сборки пути",
+    };
+  }
+  return { ok: true, blocked: false, kind: "one-tx-possible", reason: "исполнитель назван, токен заявляет EIP-2612: путь одной транзакцией собирается" };
+}

package/engine/evm/prices.js

@@ -0,0 +1,179 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/evm/prices.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.
+
+// Живые рыночные числа для EVM-ноги: цена нейтива (Chainlink on-chain) и стоимость газа (RPC).
+//
+// ПОЧЕМУ ON-CHAIN, А НЕ API. Цена берётся вызовом контракта через тот же RPC, что уже разрешён
+// в CSP (`connect-src`), поэтому:
+//   - не появляется ни одного нового внешнего домена (и ни одного нового доверенного сервиса);
+//   - нет ключей, лимитов и «мы упали, потому что у CoinGecko 429»;
+//   - значение нельзя перепутать с ценой другой сети: адрес фида свой у каждой цепи.
+// Адреса фидов НЕ выдуманы: каждый подтверждён вызовом в сети - описание `description()` должно
+// совпасть с ожидаемой парой, а ответ - попасть в разумный коридор и быть свежим. Проверка живёт
+// в tools/check-prices.mjs (работает на заглушке RPC, без сети).
+//
+// ЧЕГО ЗДЕСЬ НЕТ: если фида для сети нет или он молчит - возвращаем null, и вызывающий код обязан
+// показать, что число демонстрационное, а не подставить вчерашнюю константу молча.
+
+const SELECTOR = {
+  description: "0x7284e416", // description()
+  latestRoundData: "0xfeaf968c", // latestRoundData() -> (roundId, answer, startedAt, updatedAt, answeredInRound)
+};
+
+const CACHE_MS = 60_000; // цена: минута - компромисс между свежестью и числом запросов
+const GAS_CACHE_MS = 30_000; // газ меняется чаще, но и он не обязан бегать на каждый ввод символа
+const MAX_AGE_MS = 24 * 60 * 60 * 1000; // старше суток фид считаем несвежим и не показываем как живой
+
+const cache = new Map(); // ключ: chainId + вид запроса
+
+function cached(key, ttlMs) {
+  const hit = cache.get(key);
+  if (hit && Date.now() - hit.at < ttlMs) return hit.value;
+  return undefined;
+}
+
+function put(key, value) {
+  cache.set(key, { at: Date.now(), value });
+  return value;
+}
+
+async function rpc(chain, method, params = []) {
+  const res = await fetch(chain.rpcUrl, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
+  });
+  if (!res.ok) throw new Error(method + ": HTTP " + res.status);
+  const j = await res.json();
+  if (j.error) throw new Error(method + ": " + (j.error.message || "ошибка RPC"));
+  return j.result;
+}
+
+const word = (data, i) => BigInt("0x" + String(data).slice(2).slice(i * 64, (i + 1) * 64));
+
+// Декодирование строки ABI: [offset][length][bytes]. Нужно, чтобы отличить фид ETH/USD от любого
+// другого, который кто-то подставил в конфиг. TextDecoder, а не Buffer: этот код живёт в браузере.
+function decodeString(data) {
+  const s = String(data || "");
+  if (s.length < 2 + 128) return "";
+  const len = Number(BigInt("0x" + s.slice(2 + 64, 2 + 128)));
+  const body = s.slice(2 + 128, 2 + 128 + len * 2);
+  const bytes = new Uint8Array(body.length / 2);
+  for (let i = 0; i < bytes.length; i++) bytes[i] = parseInt(body.slice(i * 2, i * 2 + 2), 16);
+  return new TextDecoder().decode(bytes);
+}
+
+// Цена нейтива в USD. null - если фида нет, он молчит или значения не проходят проверку.
+export async function nativeUsd(chain, { force = false } = {}) {
+  const feed = chain && chain.priceFeed;
+  if (!feed || !feed.address) return null;
+  const key = chain.id + ":usd";
+  if (!force) {
+    const hit = cached(key, CACHE_MS);
+    if (hit !== undefined) return hit;
+  }
+  try {
+    const [descHex, roundHex] = await Promise.all([
+      rpc(chain, "eth_call", [{ to: feed.address, data: SELECTOR.description }, "latest"]),
+      rpc(chain, "eth_call", [{ to: feed.address, data: SELECTOR.latestRoundData }, "latest"]),
+    ]);
+    const desc = decodeString(descHex);
+    const answer = word(roundHex, 1);
+    const updatedAt = Number(word(roundHex, 3)) * 1000;
+    const decimals = Number(feed.decimals || 8);
+    const value = Number(answer) / 10 ** decimals;
+    const fresh = updatedAt > 0 && Date.now() - updatedAt < MAX_AGE_MS;
+    const sane = value >= (feed.min || 0.01) && value <= (feed.max || 1e7);
+    if (desc !== feed.pair || !fresh || !sane) {
+      return put(key, null); // null, а не «примерно столько»: молчание честнее выдумки
+    }
+    return put(key, { usd: value, updatedAt, source: "chainlink", pair: desc });
+  } catch {
+    return put(key, null);
+  }
+}
+
+// Стоимость газа в USD: оценка лимита × цена газа × цена нейтива.
+// На Arbitrum в цену газа уже входит L1-составляющая (так устроен их gas price), поэтому
+// отдельный вызов NodeInterface не нужен - обычная оценка даёт сопоставимую с кошельками цифру.
+export async function gasUsd(chain, { from = null, payToken = null, amountWei = null } = {}) {
+  const key = chain.id + ":gas";
+  const hit = cached(key, GAS_CACHE_MS);
+  if (hit !== undefined) return hit;
+  const price = await nativeUsd(chain);
+  if (!price) return put(key, null);
+  try {
+    const gasPrice = BigInt(await rpc(chain, "eth_gasPrice"));
+    let gasLimit = null;
+    let measured = false;
+    // Оцениваем ту транзакцию, которую человек и подпишет: перевод оплачиваемого токена.
+    // Эскроу ещё не задеплоен, поэтому это честная нижняя оценка, а не «газ свопа».
+    try {
+      // Без аккаунта eth_estimateGas подставляет НУЛЕВОЙ адрес, и перевод токена справедливо
+      // падает с "ERC20: transfer from the zero address". Поэтому без from не оцениваем вовсе:
+      // берём типовой лимит и честно помечаем, что он не измерен (в интерфейсе это видно).
+      // ВАЖНО: признак "перевод токена" и признак "есть аккаунт" - РАЗНЫЕ условия. Раньше они
+      // были слиты в одну ветку, и без аккаунта перевод токена получал лимит нативного перевода
+      // (21000 вместо 65000) - поймал tools/check-prices.mjs.
+      const tokenTransfer = Boolean(payToken && !payToken.native);
+      if (tokenTransfer && from) {
+        // transfer(address,uint256) = 0xa9059cbb
+        const to = String(from || "").replace(/^0x/, "").padStart(64, "0");
+        const value = BigInt(amountWei || 1).toString(16).padStart(64, "0");
+        gasLimit = BigInt(await rpc(chain, "eth_estimateGas", [{ from, to: payToken.address, data: "0xa9059cbb" + to + value }]));
+        measured = true;
+      } else if (from) {
+        gasLimit = BigInt(await rpc(chain, "eth_estimateGas", [{ from, to: from, value: "0x1" }]));
+        measured = true;
+      } else {
+        // Ни аккаунта, ни измерения: типовой лимит и честный признак «не измерено».
+        gasLimit = BigInt(chain.gasLimitFallback || (tokenTransfer ? 65000 : 21000));
+      }
+    } catch {
+      gasLimit = BigInt(chain.gasLimitFallback || (tokenTransfer ? 65000 : 21000));
+    }
+    const wei = gasPrice * gasLimit;
+    const usd = (Number(wei) / 1e18) * price.usd;
+    return put(key, { usd, gasLimit: gasLimit.toString(), gasPrice: gasPrice.toString(), native: price, source: "rpc", measured });
+  } catch {
+    return put(key, null);
+  }
+}
+
+// Одна точка обновления: подтянуть цену и газ для сети и вернуть то, чем можно подписать интерфейс.
+export async function refreshChainPrices(chain, opts = {}) {
+  if (!chain || !chain.rpcUrl) return { nativeUsd: null, gasUsd: null, source: "none" };
+  const [price, gas] = await Promise.all([nativeUsd(chain), gasUsd(chain, opts)]);
+  // Цена нейтива - общая для всех расчётов сети (балансы, «≈ $», оценка газа), поэтому пишем её
+  // в конфиг сети: иначе одна и та же цифра жила бы в двух местах и разъезжалась.
+  if (price && Number.isFinite(price.usd)) chain.native.usd = price.usd;
+  return {
+    nativeUsd: price ? price.usd : null,
+    nativeUpdatedAt: price ? price.updatedAt : null,
+    gasUsd: gas ? gas.usd : null,
+    // ЦЕНА ГАЗА В ВЕЙ - НАРУЖУ, А НЕ ТОЛЬКО СТОИМОСТЬ ОЦЕНКИ. Из неё считается запас газа на действия ордера
+    // (www/js/evm/gasReserve.js): отметка готовности и возврат - другие транзакции, у них свои пределы, и
+    // «стоимость одной оценки» их не заменяет. Нет газа у цепи - null, и вызывающий обязан сказать, что запас
+    // не измерен, а не подставить ноль.
+    gasPriceWei: gas ? gas.gasPrice : null,
+    gasSource: gas ? gas.source : null,
+    gasMeasured: gas ? Boolean(gas.measured) : false,
+    source: price ? "chainlink" : "demo",
+  };
+}
+
+// Коротко и в одну строку, но про ОБЕ половины: строка называется «Gas & price», значит и газ,
+// и цена должны быть в значении. Живая цена видна по самому тексту (Chainlink), демо - по «demo values».
+export function priceLabel(info) {
+  if (!info || !info.source || info.source === "none") return "demo values";
+  if (info.source !== "chainlink") return "demo values";
+  const when = info.nativeUpdatedAt ? new Date(info.nativeUpdatedAt).toISOString().slice(11, 16) : "?";
+  const gas = info.gasMeasured ? "gas by RPC" : "gas estimate";
+  return gas + ", price by Chainlink at " + when + " UTC";
+}
+
+export function resetPriceCache() {
+  cache.clear();
+}