@ninsei-labs/sdk 0.39.0

package/engine/core/config.js

@@ -0,0 +1,885 @@
+// GENERATED FILE - a byte-for-byte copy of the engine module www/js/core/config.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.
+
+// Конфигурация демки. Все числа, которые видит пользователь, живут здесь.
+// Значения взяты из LITEPAPER.md (разделы 5.0, 6, 7) и помечены в UI как демо-данные.
+//
+// Сети и токены описаны одной структурой CHAINS: у каждой сети свой нативный токен,
+// свой список принимаемых токенов и свои decimals. Это не украшательство: у USDT и USDC
+// decimals РАЗНЫЕ в разных сетях (6 на Ethereum/Arbitrum/Base и 18 на BSC), а "ETH"
+// в BSC вообще не существует - там нативный BNB. Поэтому идентификатор токена в
+// состоянии свапа составной: "<chainId>:<SYMBOL>", например "42161:USDC".
+// Адреса и decimals проверяются в сети: node tools/check-tokens.mjs (см. .hermes/docs).
+//
+// ТРИ ПРИЗНАКА У ЗАПИСЕЙ, и ни один из них не означает "не поддерживается":
+//   hidden (у СЕТИ)   - сеть живая и выбирается по идентификатору, но её строки нет в списке сетей;
+//   hidden (у ТОКЕНА) - токен живой и есть в списке на обмене, но его нет в витрине сети (в шапке);
+//   peg: "native"     - цена токена берётся от натива (WETH = ETH), своей демо-цены у него нет.
+// Смысл токенного hidden: витрина сети решает, что показать рядом с названием сети, а торговать
+// можно всем, что принимается. Так WETH есть в обмене, но не раздувает подпись сети в шапке.
+//
+// DEX-НОГА (Uniswap v3). У сети может быть блок uniswap: адреса QuoterV2 и UniswapV3Factory, адрес
+// обёрнутого нативного токена (WETH/WBNB) и ступени комиссии. Адреса НЕ выдуманы: они взяты из
+// официального списка развёртываний Uniswap (github.com/Uniswap/contracts, deployments/json/<chainId>.json)
+// и подтверждены ВЫЗОВОМ в сети - наличие кода, symbol()/decimals() у токена, ответ getPool и живая
+// котировка. Проверка и замер ликвидности: node tools/check-uniswap-quote.mjs. Сети без этого блока
+// означают "адреса не подтверждены вызовом", а не "DEX там не бывает": интерфейс обязан сказать словами.
+
+export const APP = {
+  name: "ArrakisSwap",
+  version: "0.1.0",
+  demo: true,
+  storageKey: "arrakis.demo.v1",
+};
+
+// ---------------------------------------------------------------------------
+// Сети. rpcUrl здесь нужен ТОЛЬКО как параметр для wallet_addEthereumChain (им
+// пользуется кошелёк пользователя, не наша страница), поэтому CSP и наш сервер
+// к этим адресам отношения не имеют. Балансы демка читает через провайдера кошелька.
+// ---------------------------------------------------------------------------
+
+// Поле escrow отвечает на один вопрос: можно ли в этой сети СЕТТЛИТЬСЯ.
+//
+// Своп заканчивается там, где лежит контракт, поэтому сеть без контракта показываем в списке, но
+// выбрать не даём (в интерфейсе она серая с пометкой "coming soon"). Пока контракт не задеплоен
+// нигде, демка работает в режиме имитации: mode "simulated" - фондирование эскроу подделывается
+// (simulateEscrowFunding), реальных денег никто не двигает, и это честно написано в UI.
+//
+//   escrow: { address: null, mode: "simulated" }  - демо-режим, выбрать можно
+//   escrow: { address: "0x…", mode: "live" }       - контракт задеплоен (сеть закрепляется за ним)
+//   escrow: null                                   - контракта нет и не планировался: "coming soon"
+//
+// СЕТИ, ГДЕ DEX-НОГА ВКЛЮЧЕНА И ИЗМЕРЯЕТСЯ (список DEX_CHAINS ниже). Он именно в ДАННЫХ, и это не
+// украшение: обходить весь реестр нельзя, потому что большинство сетей в статусе coming soon - по ним
+// работа не ведётся, пулы не ищутся и адреса не подтверждаются. Когда придёт время следующей сети, она
+// добавляется ОДНОЙ СТРОКОЙ в DEX_CHAINS и блоком uniswap у себя - и попадает и в интерфейс, и в замер
+// (tools/check-uniswap-quote.mjs берёт список сетей отсюда, а не обходом CHAINS).
+//
+// ПОЧЕМУ ИМЕННО ЭТИ: arbitrum-sepolia (421614) - демо-сеть, где развёрнут наш эскроу и идут все прогоны;
+// arbitrum (42161) и mainnet (1) - боевые сети, где видно, что маршрут живой на настоящей ликвидности.
+export const DEX_CHAINS = ["arbitrum-sepolia", "arbitrum", "mainnet"];
+
+// СОСТАВ ОБМЕНА ЗАДАН ЖЁСТКО ЗДЕСЬ - ЭТО РЕШЕНИЕ, А НЕ РЕЗУЛЬТАТ ИЗМЕРЕНИЯ. Список читается как есть:
+// код ничего в него не добавляет и ничего из него не выкидывает, замер его не фильтрует. Если у токена в
+// сети нет пула, он ВСЁ РАВНО остаётся в списке, а факт отсутствия пула пишется в отчёт
+// (tools/check-uniswap-quote.mjs) - ликвидность оценивает человек, а не инструмент.
+// СЕТЬ МОЖЕТ НЕ ПРЕДЛАГАТЬ ЧАСТЬ СОСТАВА, и это ДРУГОЕ состояние, чем "маршрута нет": тогда актива нет
+// ни в tokens этой сети, ни в DEX_ROUTES у неё, и why-заглушки у него быть НЕ ДОЛЖНО (заглушка значила
+// бы "актив предлагается, но живого пула нет"). Пример - USDS и PyUSD на Arbitrum One (решение хозяина
+// 2026-09-23). Противоречия при этом краснеют: маршрут для актива, которого сеть не предлагает, и токен
+// в списке сети, которого нет в составе обмена.
+export const DEX_ASSETS = ["USDT", "USDC", "DAI", "USDS", "USDe", "PyUSD"];
+
+// СПРАВКА ДЛЯ ИНСТРУМЕНТА, А НЕ МЕХАНИЗМ ОБМЕНА: какие стейблы вообще годятся в посредники в этих сетях.
+// Когда обход нужен, он объявляется маршрутом в DEX_ROUTES ниже - человеком, а не перебором. DEX-нога
+// однонаправленная и доводит вход до НАТИВНОГО ТОКЕНА СЕТИ, потому что им фондируется эскроу; маршрутов,
+// заканчивающихся стейблом, не бывает по устройству ноги, и объявить такой нельзя (инструмент заметит).
+export const DEX_HUBS = ["USDC", "USDT", "DAI"];
+
+// ПОРОГИ ПРОВЕРКИ ЦЕНЫ - ЧИСЛА В ДАННЫХ, А НЕ В ЛОГИКЕ (www/js/evm/dex.js: priceGateVerdict). Проверка
+// отвечает на ОДИН вопрос: цена в пулах объявленного маршрута похожа на рыночную или сделка неверная.
+// Это не оценка ликвидности (её по-прежнему решает человек), а защита того же рода, что покрытие суммы:
+// неверная цена означает, что сделка не сойдётся, и такая сделка не должна начинаться (док 45).
+//   maxDeviationPct - насколько неявная цена натива, ВЫВЕДЕННАЯ ИЗ КОТИРОВКИ последнего шага, может
+//                     разойтись с эталоном цены натива (Chainlink, evm/prices.js), прежде чем это будет
+//                     "не рынок". 2% - граница между обычным разбегом и неверной ценой;
+//   stableBandPct   - полоса "стейбл к стейблу" (шаги USDe→USDC, USDS→USDC, PyUSD→USDC): цена обязана
+//                     быть около 1:1, и это проверяется САМОЙ КОТИРОВКОЙ, без оракула. 1% покрывает
+//                     комиссию ступени (0.3%) и обычный разбег курса;
+//   stables         - какие активы считаются стейблами для этой полосы. Это ТЕ ЖЕ активы, что в составе
+//                     обмена (DEX_ASSETS): там одни стейблы по определению, и второго списка не заводим.
+export const DEX_PRICE_GATE = {
+  maxDeviationPct: 2,
+  stableBandPct: 1,
+  stables: DEX_ASSETS,
+};
+
+// ПОРОГИ ЗАЩИТ ПЕРЕД ПОДПИСЬЮ - ТОЖЕ ЧИСЛА В ДАННЫХ, А НЕ В ЛОГИКЕ (www/js/core/preSignGuards.js).
+// Здесь лежит только то, что относится к СРОКАМ ордера; пороги цены и покрытия - выше, у DEX-ноги.
+//   minReadyLeadSec   - насколько срок отметки готовности обязан быть впереди "сейчас", прежде чем
+//                       ордер можно подписывать. Порог - МЯГКОЕ окно продажи (600 с, www/js/core/sellWindow.js):
+//                       столько провайдер обещает держать цену на экране. Раньше здесь стояло 1200 - ВЕСЬ срок
+//                       подтверждений, - и это была мина после issue #111: обратный билет нода выдаёт ровно с
+//                       контрактным окном 1200 с, а страница проверяет сроки на секунду-другую ПОЗЖЕ (см.
+//                       www/js/core/reverseOrder.js, deadlineVerdict), то есть заявка блокировала САМУ СЕБЯ.
+//                       Порог обязан быть строго меньше контрактного окна, иначе он ловит собственный билет.
+//   minClaimWindowSec - насколько срок расчёта (t1) обязан отстоять от срока готовности: окно, в
+//                       которое забирающий успевает забрать ETH, не может быть "несколько секунд".
+//                       10 минут против штатного часа.
+export const SIGNING_GUARDS = {
+  minReadyLeadSec: 600,
+  minClaimWindowSec: 600,
+  // maxDeadlineSec - ПОТОЛОК срока (issue #88): `t1` не дальше этого от "сейчас". Иначе срок можно
+  // поставить на год вперёд, и внесённые ETH нельзя вернуть ни до readyBy, ни до t1 - целый год.
+  // 72 часа (3 суток) - решение владельца; штатные окна (4 ч + 1 ч при покупке, 2 ч + 1 ч при продаже)
+  // укладываются в него с большим запасом.
+  maxDeadlineSec: 259200,
+  // readyLeadWarnSec - за сколько секунд до границы отметки готовности сторона обязана предупредить человека.
+  // У ПРЯМОГО режима это предупреждение на экране, у ОБРАТНОГО - тот же порог у сторожа ноды (у него своя
+  // настройка RFQ_READY_LEAD_WARN_SEC с тем же значением по умолчанию, потому что нода запускается отдельно
+  // и чужой конфиг не читает). Значение читается отсюда, а не повторяется числом в коде: два числа в двух
+  // местах разошлись бы молча, и тревога приходила бы не тогда, когда обещано.
+  readyLeadWarnSec: 600,
+};
+
+// ОБЪЯВЛЕННЫЕ МАРШРУТЫ DEX-НОГИ - РЕШЕНИЕ ХОЗЯИНА, А НЕ РЕЗУЛЬТАТ ПЕРЕБОРА В РАНТАЙМЕ (док 45).
+// Правило хозяина (2026-09-23): "обычно через USDT или USDC выбирать и всё, если нет прямого".
+// В обмене НЕТ ни поиска ступени, ни сравнения "напрямую / через хаб", ни выбора победителя по выходу:
+// страница котирует ТОЛЬКО тот путь, который объявлен здесь, и либо показывает его числа, либо честно
+// говорит, что по объявленному маршруту котировки нет (и почему). Маршрут выбирает человек.
+// Запись: steps - шаги по порядку, каждый { to, fee, pool, verified }. Первый токен пути - сам актив.
+//   to       - токен, в который ведёт шаг (символ из токенов этой сети либо обёрнутый натив этой сети);
+//   fee      - ступень комиссии ЭТОГО шага;
+//   pool     - адрес пула этого шага (прочитан у factory.getPool и подтверждён замером);
+//   verified - дата и блок, на которых шаг подтверждён живой котировкой (tools/check-uniswap-quote.mjs).
+// Пустой steps + why - маршрут НЕ объявлен: это честное "маршрута нет", и по нему подпись блокируется.
+// Числа в комментариях - из замера 2026-09-23: выход на 100 единиц, импант по профилю 100->1000, газ.
+export const DEX_ROUTES = {
+  "arbitrum-sepolia": {
+    // Демо-сеть: объявлен единственный пул с внятной ликвидностью. ЦЕНА В НЁМ ИЗМЕРЕННО НЕГОДНАЯ
+    // (+1738% к эталону Chainlink), и это оставлено наблюдением, а не приговором: решение - за хозяином.
+    USDC: {
+      steps: [{ to: "WETH", fee: 3000, pool: "0x66eeab70ac52459dd74c6ad50d578ef76a441bbf", verified: { at: "2026-09-23", block: 311900041 } }],
+    },
+  },
+  arbitrum: {
+    // Объявлен хозяином 2026-09-23 по замеру того же дня (блок 508125577).
+    USDT: {
+      steps: [{ to: "WETH", fee: 500, pool: "0x641c00a822e8b671738d32a431a4fb6074e5c79d", verified: { at: "2026-09-23", block: 508125577 } }], // 0.036707 WETH / 100 USDT, импант -0.004%, газ 93202
+    },
+    USDC: {
+      steps: [{ to: "WETH", fee: 100, pool: "0x6f38e884725a116c9c7fbf208e79fe8828a2595f", verified: { at: "2026-09-23", block: 508125577 } }], // 0.036719 WETH / 100 USDC, импант -0.023%, газ 93921
+    },
+    DAI: {
+      steps: [{ to: "WETH", fee: 3000, pool: "0xa961f0473da4864c5ed28e00fcc53a3aab056c1b", verified: { at: "2026-09-23", block: 508125577 } }], // 0.036601 WETH / 100 DAI, импант -0.373%, газ 95653
+    },
+    // USDe против WETH пула не имеет вовсе - объявлен обход через USDC (замер: 99.931621 USDC / 100 USDe).
+    USDe: {
+      steps: [
+        { to: "USDC", fee: 100, pool: "0x3223859e24d5413947761cb79d3094f21be69bfa", verified: { at: "2026-09-23", block: 508125577 } },
+        { to: "WETH", fee: 100, pool: "0x6f38e884725a116c9c7fbf208e79fe8828a2595f", verified: { at: "2026-09-23", block: 508125577 } },
+      ],
+    },
+    // USDS И PyUSD ЗДЕСЬ НЕ ОБЪЯВЛЕНЫ ВООБЩЕ (решение хозяина 2026-09-23): на Arbitrum One они больше
+    // НЕ ПРЕДЛАГАЮТСЯ - это не "маршрута нет", а "этого актива на этой сети нет". Поэтому записей у
+    // них нет ни одной, в том числе why-заглушки: заглушка значила бы "актив предлагается, пула нет".
+    // Их нет и в tokens этой сети (см. выше), а на Ethereum оба остаются и работают.
+    // WETH - не своп, а unwrap у WETH9: 1:1. Газ зависит от держателя и суммы: замер 2026-09-23 дал 52793
+    // (держатель 0x278d…f8d2, блоки 508121467..508121667) и 52598 на другом держателе - поэтому в
+    // интерфейсе газ unwrap не показывается числом (см. evm/dex.js: unwrapLeg).
+    WETH: { steps: [], unwrap: true },
+  },
+  mainnet: {
+    // Объявлен хозяином 2026-09-23 по замеру того же дня (блок 26040283).
+    USDT: {
+      steps: [{ to: "WETH", fee: 500, pool: "0x11b815efb8f581194ae79006d24e0d814b7697f6", verified: { at: "2026-09-23", block: 26040283 } }], // 0.036714 WETH / 100 USDT, импант -0.002%, газ 81801
+    },
+    USDC: {
+      steps: [{ to: "WETH", fee: 100, pool: "0xe0554a476a092703abdb3ef35c80e0d76d32939f", verified: { at: "2026-09-23", block: 26040283 } }], // 0.036717 WETH / 100 USDC, импант -0.002%, газ 87061
+    },
+    DAI: {
+      steps: [{ to: "WETH", fee: 500, pool: "0x60594a405d53811d3bc4766596efd80fd545a270", verified: { at: "2026-09-23", block: 26040283 } }], // 0.036707 WETH / 100 DAI, импант -0.006%, газ 79908
+    },
+    // USDe: прямого пула против WETH нет - объявлен обход через USDC (замер: 99.975800 USDC / 100 USDe).
+    USDe: {
+      steps: [
+        { to: "USDC", fee: 100, pool: "0xe6d7ebb9f1a9519dc06d557e03c522d53520e76a", verified: { at: "2026-09-23", block: 26040283 } },
+        { to: "WETH", fee: 100, pool: "0xe0554a476a092703abdb3ef35c80e0d76d32939f", verified: { at: "2026-09-23", block: 26040283 } },
+      ],
+    },
+    // USDS: прямой пул против WETH существует, но он заведомо непригоден (0.000867 WETH на 100 USDS),
+    // поэтому объявлен обход через USDC (замер: 99.640880 USDC / 100 USDS на ступени 0.3%).
+    USDS: {
+      steps: [
+        { to: "USDC", fee: 3000, pool: "0xa66a2770bc0e0c65b63b5a3bb4560e90f95d6146", verified: { at: "2026-09-23", block: 26040283 } },
+        { to: "WETH", fee: 100, pool: "0xe0554a476a092703abdb3ef35c80e0d76d32939f", verified: { at: "2026-09-23", block: 26040283 } },
+      ],
+    },
+    // PyUSD: прямой пул против WETH заведомо непригоден - объявлен обход через USDC (99.989571 USDC / 100 PyUSD).
+    PyUSD: {
+      steps: [
+        { to: "USDC", fee: 100, pool: "0x13394005c1012e708fce1eb974f1130fdc73a5ce", verified: { at: "2026-09-23", block: 26040283 } },
+        { to: "WETH", fee: 100, pool: "0xe0554a476a092703abdb3ef35c80e0d76d32939f", verified: { at: "2026-09-23", block: 26040283 } },
+      ],
+    },
+    // WETH - не своп, а unwrap у WETH9: 1:1. Газ зависит от держателя: замер 2026-09-23 дал 36335 и 36277
+    // у двух разных держателей, поэтому числом в интерфейсе он не показывается.
+    WETH: { steps: [], unwrap: true },
+  },
+};
+
+export const CHAINS = [
+  {
+    id: "arbitrum-sepolia",
+    name: "Arbitrum Sepolia",
+    vm: "evm",
+    chainId: 421614,
+    caip2: "eip155:421614",
+    testnet: true,
+    native: { symbol: "ETH", decimals: 18, usd: 3212.4 },
+    // Свой прокси, а не публичный узел напрямую: адрес эскроу (predict) приходит по этому пути, и
+    // подменённый или совравший посредник означал бы блокировку ETH не на тот адрес. Подробности,
+    // включая проверку сети и CORS, - в tools/check-evm-proxy.mjs и .hermes/deploy/arrakis-evm-*.conf
+    rpcUrl: "https://rpc.arrakisswap.trade",
+    // Фид Chainlink для цены нейтива. Адреса проверены ВЫЗОВОМ в сети (description() совпало
+    // с парой, значение свежее и в разумном коридоре) - см. tools/check-prices.mjs. Если фида
+    // нет, цены нет: интерфейс обязан сказать «демо», а не показывать вчерашнюю константу.
+    priceFeed: { address: "0xd30e2101a97dcbAeBCBC04F14C3f624E67A35165", pair: "ETH / USD", decimals: 8, min: 100, max: 20000 },
+    explorerTx: "https://sepolia.arbiscan.io/tx/",
+    explorerAddr: "https://sepolia.arbiscan.io/address/",
+    explorerName: "arbiscan (sepolia)",
+    gasUsd: 0.01,
+    routeType: "atomic",
+    // ОСНОВНАЯ сеть демки: сюда поехал контракт эскроу, и здесь РАЗВЁРНУТ РОУТЕР КОМИССИИ - он же
+    // фабрика (порождает эскроу, хранит ставку, держит кассу комиссии). Адрес ниже - факт, а не
+    // намерение: 0xaEB1c0455C76551dcEb2E6B1245B65F0458b0aE8 (высота 314323871,
+    // транзакция 0x7a88c0249867b76b11c6cb678e6092fdc19404b51540a64c5fd03f5a32f74826, код 8223 байта,
+    // keccak256 0x90f26f641b48a2a630463195d4429b0818d29187563e09711a40811fcf08a0ba, развёрнут 30.09.2026): добавлен РАННИЙ ВОЗВРАТ в мёртвой зоне - если отметки нет,
+    // refund открыт сразу после readyBy, и он же публикует половину внёсшего. Код совпадает с текущей
+    // сборкой репозитория байт в байт, то есть ранний возврат В СЕТИ (проверено
+    // `npm run check:deployed -- --address=0xaEB1c0455C76551dcEb2E6B1245B65F0458b0aE8`).
+    // ПРЕЖНЯЯ (потолок 3%, раннего возврата ещё нет): 0xEa619bDC78989627093B7830990367B2ECE52CE5
+    // (высота 314309038, транзакция 0x07ddb118c16639785d0055cfb5e28457f33f0c1e8323ea37d421c8abdfcec767, код 8143 байта).
+    // ПРЕЖНЯЯ боевая (роутер с потолком 10%): 0x9f856cd9c14fd9493961473b804039b09a4012ef (высота
+    // 313597131, код 8723 байта, keccak 0xe35b9efa1466fc9e57ffc61fd6243019c55990ea4a04de03bbfa3ec477e49427).
+    // ПРЕЖНЯЯ до неё (фабрика без комиссии): 0xcb54af9ec11344d448c7900ccb08530a23783259 (высота
+    // 312222006, код 6035 байт); ещё ПРЕЖНИЕ: 0x0ec0be02…4222e (высота 312180386, 5989 байт),
+    // 0x13556d78…aa8b8 и 0x4E7270…dbe1b0, см. .hermes/deploy.
+    // mode: "live" - форма вызывает НАСТОЯЩИЕ транзакции: создание ордера ВМЕСТЕ С ДЕНЬГАМИ одной
+    // транзакцией (createOrderAndFund; отдельной функции внесения у эскроу нет вовсе - ордер рождается
+    // зафондированным, см. FACTORY_METHODS в www/js/evm/factory.js и ESCROW_METHODS в escrow.js).
+    // Прежних lock(sealedHalf) и hashlock в контракте нет: половина не посылается, а раскрывается
+    // предъявлением.
+    // Возвращается в "simulated" одной правкой, если нужно показать демо без движения средств.
+    // cashier (#103): касса комиссии ИНТЕРФЕЙСА, которую он называет в котировках. Контракты в сети ещё
+    // ПРЕЖНИЕ (док 55), поэтому кассы там нет: поле заполняется тем же заходом, что и адрес фабрики.
+    escrow: { address: "0xaEB1c0455C76551dcEb2E6B1245B65F0458b0aE8", mode: "live", cashier: null },
+    tokens: [
+      // Тестовый USDC (Circle): decimals 6 и symbol "USDC" проверены в сети этой же нодой.
+      { symbol: "USDC", address: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d", decimals: 6, usd: 1, cls: "ar-token-usdc" },
+      // WETH - ЭТО ТОТ ЖЕ ETH, ТОЛЬКО ОБЁРНУТЫЙ, поэтому пула для него не ищем: WETH -> ETH это
+      // withdraw у самого WETH9, один к одному и без свопа (см. DEX-ногу ниже и tools/check-uniswap-quote.mjs).
+      // hidden: true - "в витрине сети (в шапке) не показываем", а НЕ "не поддерживается": в списке
+      // токенов на обмене он есть (список на обмене берёт tokensOf, а шапка фильтрует по hidden).
+      // Адрес определён ИЗМЕРЕНИЕМ, а не по памяти: token0/token1 пула USDC/WETH дали этот адрес, а
+      // symbol()/decimals()/name() ответили "WETH"/18/"Wrapped Ether" (проверка 2026-09-23).
+      // peg: "native" - своей демо-цены у WETH нет: его долларовая цена - это цена ETH.
+      { symbol: "WETH", address: "0x980B62Da83eFf3D4576C647993b0c1D7faf17c73", decimals: 18, cls: "ar-token-eth", peg: "native", hidden: true },
+    ],
+    // DEX-НОГА ЭТОЙ СЕТИ (Uniswap v3, только чтение: eth_call к QuoterV2).
+    // ФАБРИКИ В ОФИЦИАЛЬНОМ СПИСКЕ ДЛЯ ARBITRUM SEPOLIA НЕТ, поэтому адрес ПОЛУЧЕН ИЗМЕРЕНИЕМ:
+    // у пулов, названных в .hermes/docs/43-uniswap-same-chain-ramp.md, прочитан factory(), а затем
+    // сверено, что getPool(USDC, WETH, fee) у него возвращает те же адреса (2026-09-23).
+    // ВАЖНО ПРО ЭТУ СЕТЬ: пулы в ней ЕСТЬ, но ликвидность негодная. Ступень 0.01% НЕ ОБСЛУЖИВАЕТ НИ
+    // ОДНОГО размера ("pool cannot serve this size" - вокруг цены ликвидности нет), у 0.05% выход НОЛЬ
+    // на любом размере, а 0.3% отвечает, но ценой, которая с эталоном Chainlink расходится.
+    // ОДНО ЧИСЛО, А НЕ ТРИ РАЗНЫХ. До 24 сентября 2026 здесь стояли "в 30 раз" и "в 18 раз", а в
+    // докладе 43 - 94.54%: это замеры НА РАЗНЫХ РАЗМЕРАХ В РАЗНЫЕ ДНИ, и без названного размера и
+    // способа каждое из них - просто другое число. Замер 2026-09-24, блок 312238363, головной размер
+    // 100 USDC: котировка дала 0.116508 WETH, то есть неявная цена натива $858.31 против $2650.42 по
+    // фиду Chainlink - расхождение 67.6% при пороге 2%, пул дешевле эталона в 3.09 раза.
+    // СПОСОБ ЗАМЕРА - ТОТ ЖЕ КОД, ЧТО В ИНТЕРФЕЙСЕ (www/js/evm/dex.js: priceGateVerdict, эталон из
+    // www/js/evm/prices.js), и он перезапускаем одной командой:
+    // node tools/check-uniswap-quote.mjs --chain=arbitrum-sepolia
+    // ЧИСЛО ЗАВИСИТ ОТ РАЗМЕРА (тот же блок, та же шкала): 1 USDC = 77.5%, 10 USDC = 76.6%,
+    // 100 USDC = 67.6%, 1000 USDC = -16.0%. Поэтому здесь стоит ОДНО число С НАЗВАННЫМ РАЗМЕРОМ.
+    // Инструмент печатает ещё и наблюдение в шкале "во сколько раз дешевле" (+208.6% для 100 USDC,
+    // то есть те же 3.09 раза) - это ПЕРЕСЧЁТ той же величины, а не второй замер.
+    uniswap: {
+      factory: "0x248ab79bbb9bc29bb72f7cd42f17e054fc40188e",
+      quoter: "0x2779a0CC1c3e0E44D2542EC3e79e3864Ae93Ef0B",
+      // ИСПОЛНЕНИЕ (в отличие от котировки строкой выше): адреса ЗАМЕРЕНЫ, а не взяты из соглашения о
+      // развёртывании, и замер перепроверяется прогоном tools/check-dex-exec.mjs.
+      //   router - SwapRouter02. Три НЕЗАВИСИМЫХ признака происхождения, все из цепи: (1) код по адресу
+      //     есть, 24497 байт; (2) его factory() РАВЕН фабрике Uniswap строкой выше; (3) его WETH9()
+      //     РАВЕН wrapped ниже. Плюс исходник верифицирован у обозревателя: Arbiscan API V2 (chainid
+      //     421614) отдал ABI из 41 записи, имя контракта SwapRouter02, компилятор v0.7.6+commit.7338295f.
+      //     Угадать адрес, который вернёт ИМЕННО эти factory() и WETH9(), нельзя - это тот же контракт.
+      //     ВАЖНО: permit2() у ЭТОГО роутера ОТКАТЫВАЕТ (проверяется прогоном): он не потребляет
+      //     Permit2, и разрешение даётся ему самому обычным approve.
+      //   permit2 - канонический Permit2 Uniswap: код 9152 байта, и его DOMAIN_SEPARATOR() совпал с
+      //     посчитанным С НУЛЯ для chainId 421614 и этого адреса (имя домена "Permit2"), а исходник
+      //     верифицирован у обозревателя. Нужен пути ФИНАНСИРОВАНИЯ ордера, а НЕ этому роутеру.
+      // UniversalRouter (0x4A7b5Da61326A6379179b40d00F57E5bbDC962c2) СЮДА НЕ ВНЕСЁН - и это решение, а не
+      // забывчивость: его происхождение по этой сети НЕ подтверждается (getabi и getsourcecode у
+      // обозревателя отвечают NOTOK, то есть исходник не верифицирован), а "тот же адрес, что в докладе
+      // 43" доказательством не является. Появится нужда - сначала доказательство, потом запись.
+      router: "0x101F443B4d1b059569D643917553c771E1b9663E",
+      permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+      // Обёрнутый нативный токен: адрес совпадает с WETH в tokens выше - это проверяется (check-front).
+      wrapped: { symbol: "WETH", name: "Wrapped Ether", address: "0x980B62Da83eFf3D4576C647993b0c1D7faf17c73", decimals: 18 },
+      feeTiers: [100, 500, 3000, 10000],
+    },
+    // ЦЕНА ЭТОЙ СЕТИ НЕГОДНАЯ ПО ПРИРОДЕ, И ЭТО ПРИЗНАК СЕТИ (по образцу hidden/unsupported), а не
+    // ослабление проверки: тот же замер, что в блоке uniswap выше (блок 312238363, 100 USDC: неявная
+    // цена натива $858.31 против эталона $2650.42 - расхождение 67.6% при пороге 2%). На боевой сети такая цена
+    // ОСТАНАВЛИВАЕТ подпись, здесь - только помечается словами в интерфейсе: на тестнете проверяется
+    // ПОТОК, а не рынок, иначе демо-прогоны встали бы на цене, которую мы не выбирали.
+    // Признака нет у боевых сетей - там проверка цены блокирует, и это умолчание (DEX_PRICE_GATE).
+    // Песочница local-anvil в проверку не попадает вовсе: у неё нет ни блока uniswap, ни токенов, то
+    // есть DEX-ноги там не бывает - помечать нечего.
+    dexPriceGate: "tolerated",
+  },
+  {
+    // ЛОКАЛЬНАЯ СЕТЬ ДЛЯ ВНУТРЕННИХ ТЕСТОВ. Это anvil на этой же машине: настоящая цепочка, настоящие
+    // транзакции, но песочница. В демо она не для показа - она для прогонов, где нужен полный контроль.
+    // СВОЙ chainId (31337), а не как у публичной сети. С совпадающим идентификатором фронт не мог однозначно
+    // выбрать песочницу: при сверке с кошельком он находил ПЕРВУЮ сеть с таким id и возвращался к публичной.
+    // 31337 - обычный идентификатор локальных цепочек, ни с одной настоящей сетью не совпадает.
+    id: "local-anvil",
+    name: "Local (anvil)",
+    // СКРЫТА ИЗ СПИСКА СЕТЕЙ, НО НЕ ВЫКЛЮЧЕНА. hidden - это только про состав строк, которые рисует
+    // список (см. shownChains в www/js/ui/chainPicker.js): в демо песочницу показывать нечего, а для
+    // внутренних прогонов она нужна. Признак НЕ означает "не поддерживается" (это unsupported у
+    // Monad/Hyperliquid - те остаются в списке, просто серые и подписаны тем же "coming soon", что и остальные неживые сети):
+    // escrowState, isSelectable и settlementChain читают сам реестр и про hidden не знают, поэтому
+    // песочница остаётся живой сетью с живым эскроу и выбирается по идентификатору "local-anvil".
+    hidden: true,
+    vm: "evm",
+    chainId: 31337,
+    caip2: "eip155:31337",
+    testnet: true,
+    native: { symbol: "ETH", decimals: 18, usd: 3212.4 },
+    rpcUrl: "http://127.0.0.1:8545",
+    // Фида Chainlink в песочнице нет - и это ШТАТНЫЙ случай: интерфейс обязан сказать «демо»,
+    // а не показать вчерашнюю константу.
+    priceFeed: null,
+    explorerTx: "",
+    explorerAddr: "",
+    explorerName: "",
+    gasUsd: 0.0001,
+    routeType: "atomic",
+    // ФАБРИКА, развёрнутая в локальную цепочку. Адрес НЕ ВЫБИРАЕТСЯ, А СЛЕДУЕТ ИЗ ИСТОРИИ ОТПРАВИТЕЛЯ:
+    // CREATE строит его из счёта и номера его транзакции, поэтому на СВЕЖЕЙ цепочке он один и тот же, а на
+    // давно поднятой - другой: у счёта уже есть история. Здесь адрес ИЗМЕРЕН на цепи (чтение кода + keccak)
+    // после передеплоя под формат котировки с xmrAmount: счёт 0 anvil, nonce 60, блок 74, 13188 байт кода
+    // (keccak 0x9bffb62d50eef21bcfd4b59e1c3d6fb7cbb3e303257edb2f5ba9dc65b3e8719c - совпал со сборкой дерева).
+    // Команда - из mvp/contracts: forge script script/Deploy.s.sol:Deploy --rpc-url http://127.0.0.1:8545
+    // --broadcast --private-key <ключ счёта 0 anvil> - той же формой, что в tools/stack.mjs.
+    // cashier - второй CREATE того же захода (сначала фабрика, затем касса, затем реестр): 573 байта,
+    // keccak 0xcca1d8bc53d1d1c98901570800e093d0933f84637c6cdc727153b3ef8d8c3c36 - ровно тот хеш, которым
+    // эскроу сверяет кассу (#122). Реестр - третий CREATE (DEPLOY_REGISTRY=true), 4557 байт.
+    // ПРЕЖНЯЯ запись: фабрика 0x5fbdb2315678afecb367f032d93f642f64180aa3 (13077 байт, знала только прежний
+    // селектор predict 0x3d81fc01) и касса 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512 (573 байта, но ДРУГОЙ
+    // сборки - keccak 0x5c32bb9c…): её код не совпадал с канонической кассой, и эскроу отверг бы такой ордер
+    // по #122 - поэтому касса развёрнута заново тем же заходом.
+    escrow: { address: "0xcbEAF3BDe82155F56486Fb5a1072cb8baAf547cc", mode: "live", cashier: "0x1429859428C0aBc9C2C47C8Ee9FBaf82cFA0F20f" },
+    // Токенов в песочнице нет: расплата идёт нейтивом. Пустой список - это факт о песочнице, а не забывчивость.
+    tokens: [],
+    // Uniswap в песочнице не развёрнут и не нужен: тут своя цепочка для сквозных прогонов, а DEX-нога
+    // проверяется в публичных сетях (см. DEX_CHAINS у начала файла). Блока uniswap у сети нет.
+  },
+  {
+    id: "arbitrum",
+    name: "Arbitrum One",
+    vm: "evm",
+    chainId: 42161,
+    caip2: "eip155:42161",
+    native: { symbol: "ETH", decimals: 18, usd: 3212.4 },
+    rpcUrl: "https://arb1.arbitrum.io/rpc",
+    // Фид Chainlink для цены нейтива. Адреса проверены ВЫЗОВОМ в сети (description() совпало
+    // с парой, значение свежее и в разумном коридоре) - см. tools/check-prices.mjs. Если фида
+    // нет, цены нет: интерфейс обязан сказать «демо», а не показывать вчерашнюю константу.
+    priceFeed: { address: "0x639Fe6ab55C921f74e7fac1ee960C0B6293ba612", pair: "ETH / USD", decimals: 8, min: 100, max: 20000 },
+    explorerTx: "https://arbiscan.io/tx/",
+    explorerAddr: "https://arbiscan.io/address/",
+    explorerName: "arbiscan",
+    gasUsd: 0.21, // демо-оценка стоимости газа, как и остальные числа демки
+    routeType: "atomic",
+    // Контракта эскроу нет ни на одной боевой сети, поэтому демка имитирует фондирование.
+    escrow: { address: null, mode: "simulated" },
+    tokens: [
+      { symbol: "USDC", address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", decimals: 6, usd: 1, cls: "ar-token-usdc" },
+      // Адрес тот же, что был у USDT на Arbitrum, но контракт теперь отвечает symbol="USD₮0":
+      // Tether передал контракт USDT0 (миграция прошла без смены адреса, 1:1 к USDT на Ethereum).
+      // Идентификатор оставляем USDT - пользователь меняет «USDT», а не «USD₮0».
+      { symbol: "USDT", onChainSymbol: "USD₮0", address: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9", decimals: 6, usd: 1, cls: "ar-token-usdt" },
+      // DAI и USDe: адреса - РЕШЕНИЕ ХОЗЯИНА (стояли и раньше). Каждый подтверждён чтением в сети
+      // 2026-09-23, блок 508109137: код по адресу есть, symbol()/decimals()/name() прочитаны. Замер по
+      // фабрике (getPool(токен, WETH, fee), ступени 100/500/3000/10000) на тот же блок: у USDe пулы 500
+      // (0xaa9aea1896130089a8fc33acd7028dbaeba421d8) и 3000 (0x9511ee80843cdf8ecfa0337c73621458a8ca1c73)
+      // есть, запасы НУЛЕВЫЕ. Это СПРАВКА для человека, а не отбор: список обмена жёсткий (DEX_ASSETS),
+      // инструмент его не фильтрует.
+      // USDS И PyUSD В ЭТОЙ СЕТИ НЕ ПРЕДЛАГАЮТСЯ (решение хозяина 2026-09-23). Прежние адреса (USDS
+      // 0x6491c05A82219b8D1479057361ff1654749b876b, PyUSD 0x46850aD61C2B7d64d08c9C754F45254596696984) убраны
+      // отсюда вместе с маршрутами: актив, которого сеть не предлагает, не должен ни рисоваться в строке
+      // активов сети (ui/chainPicker.js), ни попадать в список на обмен (ui/views/swapForm.js). На
+      // Ethereum оба остаются.
+      { symbol: "DAI", address: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1", decimals: 18, usd: 1, cls: "ar-token-dai" },
+      { symbol: "USDe", address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, usd: 1, cls: "ar-token-usde" },
+      // WETH: как в arbitrum-sepolia (см. комментарий там) - пула не ищем, WETH->ETH это unwrap у WETH9.
+      // Адрес определён измерением: token0/token1 пулов USDC/WETH, symbol()="WETH", decimals=18, name()="Wrapped Ether".
+      { symbol: "WETH", address: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1", decimals: 18, cls: "ar-token-eth", peg: "native", hidden: true },
+    ],
+    // DEX-НОГА: адреса из официального списка развёртываний Uniswap (deployments/json/42161.json) и
+    // подтверждены вызовами в сети 2026-09-23: код QuoterV2 8273 байта, код фабрики 24535 байт,
+    // getPool(USDC|USDT|DAI|USDe, WETH, 100|500|3000|10000) отвечает, котировки живые.
+    // ЧЕГО В ЭТОЙ СЕТИ НЕТ: у USDe пул существует, но ликвидности в нём нет (liquidity()=0), а ступень
+    // 10000 у DAI мизерная - котировка на 100000 DAI даёт вчетверо меньше, чем на 1000. Это видно в
+    // замере, и это ровно тот случай, ради которого нога считается через пул, а не берётся из мока.
+    uniswap: {
+      factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+      quoter: "0x61fFE014bA17989E743c5F6cB21bF9697530B21e",
+      wrapped: { symbol: "WETH", name: "Wrapped Ether", address: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1", decimals: 18 },
+      feeTiers: [100, 500, 3000, 10000],
+    },
+  },
+  {
+    id: "mainnet",
+    name: "Ethereum",
+    vm: "evm",
+    chainId: 1,
+    caip2: "eip155:1",
+    native: { symbol: "ETH", decimals: 18, usd: 3212.4 },
+    rpcUrl: "https://ethereum-rpc.publicnode.com",
+    // Фид Chainlink для цены нейтива. Адреса проверены ВЫЗОВОМ в сети (description() совпало
+    // с парой, значение свежее и в разумном коридоре) - см. tools/check-prices.mjs. Если фида
+    // нет, цены нет: интерфейс обязан сказать «демо», а не показывать вчерашнюю константу.
+    priceFeed: { address: "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419", pair: "ETH / USD", decimals: 8, min: 100, max: 20000 },
+    explorerTx: "https://etherscan.io/tx/",
+    explorerAddr: "https://etherscan.io/address/",
+    explorerName: "etherscan",
+    gasUsd: 3.4, // на L1 газ заметно дороже - в демо это видно при выборе сети
+    routeType: "atomic",
+    escrow: { address: null, mode: "simulated" },
+    tokens: [
+      { symbol: "USDC", address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", decimals: 6, usd: 1, cls: "ar-token-usdc" },
+      { symbol: "USDT", address: "0xdAC17F958D2ee523a2206206994597C13D831ec7", decimals: 6, usd: 1, cls: "ar-token-usdt" },
+      // DAI, USDe, USDS, PyUSD: USDS и PyUSD - АДРЕСА ХОЗЯИНА, каждый подтверждён чтением в сети
+      // 2026-09-23, блок 26039940: код по адресу есть, symbol()/decimals()/name() прочитаны
+      // (USDS: "USDS"/18/"USDS Stablecoin"; PyUSD: "PYUSD"/6/"PayPal USD"). USDS и USDe отличаются одной
+      // буквой, поэтому подтверждались отдельно. Замер по фабрике (getPool(токен, WETH, fee)) на тот же
+      // блок: у USDS пулы только на 500 (0xe547c6d5039d1902db58102e7f52410dbc5b0708, ~2.1 USDS) и 3000
+      // (0x691c9c856eeec77531750c465450b5e05a74c047, пусто); у PyUSD - на 500 (0xa8b1a6acc942b8266f987c4b0cdf625e3479a26b, пусто),
+      // 3000 (0xf313d711d71eb9a607b4a61a827a9e32a7846621, ~33.8 PyUSD) и 10000 (0x643ea0885875a77bf8dc3e0f3ead866a125276b1, ~265.8 PyUSD);
+      // у USDe пула с WETH НЕТ ни на одной ступени. Это СПРАВКА, а не отбор: список жёсткий (DEX_ASSETS).
+      { symbol: "DAI", address: "0x6B175474E89094C44Da98b954EedeAC495271d0F", decimals: 18, usd: 1, cls: "ar-token-dai" },
+      { symbol: "USDe", address: "0x4c9EDD5852cd905f086C759E8383e09bff1E68B3", decimals: 18, usd: 1, cls: "ar-token-usde" },
+      { symbol: "USDS", address: "0xdC035D45d973E3EC169d2276DDab16f1e407384F", decimals: 18, usd: 1, cls: "ar-token-usds" },
+      { symbol: "PyUSD", address: "0x6c3ea9036406852006290770BEdFcAbA0e23A0e8", decimals: 6, usd: 1, cls: "ar-token-pyusd" },
+      // WETH: пула не ищем - WETH->ETH это unwrap у WETH9 (1:1). hidden: true = не показывать в витрине
+      // сети, но оставить в списке на обмене (см. arbitrum-sepolia). Адрес подтверждён измерением.
+      { symbol: "WETH", address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", decimals: 18, cls: "ar-token-eth", peg: "native", hidden: true },
+    ],
+    // DEX-НОГА: адреса из официального списка Uniswap (deployments/json/1.json), подтверждены вызовами:
+    // код QuoterV2 8273 байта, фабрики 24535 байт, пулы USDC|USDT|DAI к WETH есть по всем четырём
+    // ступеням, котировки живые. У USDe в этой сети пула НЕТ ни по одной ступени - так и должно быть
+    // сказано словами, а не показано нулём.
+    uniswap: {
+      factory: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+      quoter: "0x61fFE014bA17989E743c5F6cB21bF9697530B21e",
+      wrapped: { symbol: "WETH", name: "Wrapped Ether", address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", decimals: 18 },
+      feeTiers: [100, 500, 3000, 10000],
+    },
+  },
+  {
+    id: "base",
+    name: "Base",
+    vm: "evm",
+    chainId: 8453,
+    caip2: "eip155:8453",
+    native: { symbol: "ETH", decimals: 18, usd: 3212.4 },
+    rpcUrl: "https://mainnet.base.org",
+    // Фид Chainlink для цены нейтива. Адреса проверены ВЫЗОВОМ в сети (description() совпало
+    // с парой, значение свежее и в разумном коридоре) - см. tools/check-prices.mjs. Если фида
+    // нет, цены нет: интерфейс обязан сказать «демо», а не показывать вчерашнюю константу.
+    priceFeed: { address: "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70", pair: "ETH / USD", decimals: 8, min: 100, max: 20000 },
+    explorerTx: "https://basescan.org/tx/",
+    explorerAddr: "https://basescan.org/address/",
+    explorerName: "basescan",
+    gasUsd: 0.08,
+    routeType: "atomic",
+    escrow: { address: null, mode: "simulated" },
+    tokens: [
+      { symbol: "USDC", address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", decimals: 6, usd: 1, cls: "ar-token-usdc" },
+      { symbol: "USDT", address: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2", decimals: 6, usd: 1, cls: "ar-token-usdt" },
+      { symbol: "DAI", address: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb", decimals: 18, usd: 1, cls: "ar-token-dai" },
+      { symbol: "USDe", address: "0x5d3a1Ff2b6BAb83b63cd9AD0787074081a52ef34", decimals: 18, usd: 1, cls: "ar-token-usde" },
+    ],
+    // DEX-НОГИ В ЭТОЙ СЕТИ НЕТ, и это НЕ про "мы не проверяли", а про состояние продукта: сеть в
+    // статусе coming soon, блока uniswap у неё нет и пулы здесь не ищутся. Что это значит для экрана -
+    // он обязан сказать словами (см. mock/market.js: dexRoute), а не показать пул-пустышку.
+  },
+  {
+    id: "bsc",
+    name: "BNB Chain",
+    vm: "evm",
+    chainId: 56,
+    caip2: "eip155:56",
+    native: { symbol: "BNB", decimals: 18, usd: 612.5 },
+    rpcUrl: "https://bsc-dataseed.binance.org",
+    // Цена BNB: фид Chainlink не подтверждён вызовом - пока сеть показывает «демо»,
+    // а не выдуманное число. Добавляется сюда, когда адрес проверен так же, как остальные.
+    explorerTx: "https://bscscan.com/tx/",
+    explorerAddr: "https://bscscan.com/address/",
+    explorerName: "bscscan",
+    gasUsd: 0.05,
+    routeType: "atomic",
+    escrow: { address: null, mode: "simulated" },
+    tokens: [
+      // Внимание: на BSC у USDT и USDC 18 decimals (не 6, как на Ethereum L1 и L2).
+      // DAI и USDe на BNB Chain не добавляем: в демке их там нет.
+      { symbol: "USDT", address: "0x55d398326f99059fF775485246999027B3197955", decimals: 18, usd: 1, cls: "ar-token-usdt" },
+      { symbol: "USDC", address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d", decimals: 18, usd: 1, cls: "ar-token-usdc" },
+    ],
+    // DEX-НОГИ В ЭТОЙ СЕТИ НЕТ: сеть в статусе coming soon, блок uniswap у неё отсутствует, и пулы
+    // здесь не ищутся. Обёрнутый нативный токен этой сети - WBNB (нативный тут BNB, не ETH), но пока
+    // сеть не включена, в реестре нет ни одного её адреса: незачем подтверждать то, чем не пользуемся.
+  },
+  {
+    id: "bitcoin",
+    name: "Bitcoin",
+    vm: "bitcoin",
+    chainId: 0, // у Bitcoin нет EVM chainId; 0 - это SLIP-44 coin type, и он не сталкивается с EVM-сетями
+    caip2: "bip122:000000000019d6689c085ae165831e93", // bip122 + первые 32 символа хеша нулевого блока
+    native: { symbol: "BTC", decimals: 8, usd: 96000 },
+    // У Bitcoin нет JSON-RPC: это REST-API блокчейн-обозревателя. Демка в него не ходит.
+    rpcUrl: "https://blockstream.info/api",
+    explorerTx: "https://mempool.space/tx/",
+    explorerAddr: "https://mempool.space/address/",
+    explorerName: "mempool.space",
+    gasUsd: 1.2,
+    routeType: "atomic",
+    // В Bitcoin актив один - сам BTC: контрактных токенов в протоколе нет.
+    tokens: [],
+    // Эскроу-контракта здесь быть не может, и это не пробел: у Bitcoin вместо контракта работает
+    // native atomic swap (HTLC/адапторные подписи в скрипте). Поэтому говорим прямо, чем сеттлится,
+    // и не выдаём отсутствие контракта за "coming soon". Демка Bitcoin пока не умеет (подключается
+    // EVM-кошелёк), поэтому escrow: null - сеть в списке, выбрать её нельзя.
+    escrow: null,
+    settlement: "native-atomic-swap",
+  },
+  {
+    id: "tron",
+    name: "Tron",
+    vm: "tron",
+    chainId: 728126428, // network id: eth_chainId на TronGrid отвечает 0x2b6653dc
+    caip2: "tron:0x2b6653dc",
+    native: { symbol: "TRX", decimals: 6, usd: 0.28 },
+    rpcUrl: "https://api.trongrid.io",
+    explorerTx: "https://tronscan.org/#/transaction/",
+    explorerAddr: "https://tronscan.org/#/address/",
+    explorerName: "tronscan",
+    gasUsd: 0.35,
+    routeType: "atomic",
+    // НЕ EVM: демка сегодня подключает только EVM-кошелёк (EIP-1193) и не умеет здесь ни читать
+    // балансы, ни подписывать. Поэтому сеть видна в списке, но не выбирается - escrow: null.
+    escrow: null,
+    tokens: [
+      // TRC-20: symbol()/decimals() проверены через TronGrid triggerconstantcontract (USDT, 6).
+      { symbol: "USDT", address: "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", decimals: 6, usd: 1, cls: "ar-token-usdt" },
+    ],
+  },
+  {
+    id: "solana",
+    name: "Solana",
+    vm: "solana",
+    chainId: 101, // идентификатор Solana mainnet-beta; ниже CAIP-2 с genesis hash
+    caip2: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d",
+    native: { symbol: "SOL", decimals: 9, usd: 198.4 },
+    rpcUrl: "https://api.mainnet-beta.solana.com",
+    explorerTx: "https://solscan.io/tx/",
+    explorerAddr: "https://solscan.io/account/",
+    explorerName: "solscan",
+    gasUsd: 0.002,
+    routeType: "atomic",
+    // НЕ EVM: см. пояснение у Tron.
+    escrow: null,
+    tokens: [
+      // SPL-mint: проверено getAccountInfo (owner Tokenkeg...) и getTokenSupply (decimals 6).
+      { symbol: "USDC", address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", decimals: 6, usd: 1, cls: "ar-token-usdc" },
+      { symbol: "USDT", address: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB", decimals: 6, usd: 1, cls: "ar-token-usdt" },
+    ],
+  },
+  {
+    id: "monad",
+    name: "Monad",
+    vm: "evm",
+    // Демка эту сеть пока не умеет: в UI ведёт себя как Solana - серая и не выбирается,
+    // а в строке честно написано "not supported yet". План сети не отменён - снимем признак,
+    // когда появится контракт и токены.
+    unsupported: true,
+    chainId: 143,
+    caip2: "eip155:143",
+    native: { symbol: "MON", decimals: 18, usd: 0.03 },
+    rpcUrl: "https://rpc.monad.xyz",
+    explorerTx: "https://monadscan.com/tx/",
+    explorerAddr: "https://monadscan.com/address/",
+    explorerName: "monadscan",
+    gasUsd: 0.01,
+    routeType: "atomic",
+    escrow: { address: null, mode: "simulated" },
+    tokens: [
+      // USDC (Circle) и USDT0: symbol()/decimals() проверены вызовом в сети Monad (chainId 143).
+      { symbol: "USDC", address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603", decimals: 6, usd: 1, cls: "ar-token-usdc" },
+      { symbol: "USDT", onChainSymbol: "USDT0", address: "0xe7cd86e13AC4309349F30B3435a9d337750fC82D", decimals: 6, usd: 1, cls: "ar-token-usdt" },
+    ],
+    // DEX-НОГИ ЗДЕСЬ НЕТ: сеть в статусе coming soon, пулы не ищутся и адреса в реестр не пишутся.
+    // Незачем держать в интерфейсе адрес, которым нельзя пользоваться: то, что мы измерили раньше,
+    // после такого решения просто не проверяется, и оставлять это как "данные" было бы обманом.
+  },
+  {
+    id: "hyperevm",
+    name: "Hyperliquid EVM",
+    vm: "evm",
+    // Демка эту сеть пока не умеет: в UI ведёт себя как Solana - серая и не выбирается,
+    // а в строке честно написано "not supported yet". План сети не отменён - снимем признак,
+    // когда появится контракт и токены.
+    unsupported: true,
+    chainId: 999,
+    caip2: "eip155:999",
+    native: { symbol: "HYPE", decimals: 18, usd: 38.5 },
+    rpcUrl: "https://rpc.hyperliquid.xyz/evm",
+    explorerTx: "https://hyperevmscan.io/tx/",
+    explorerAddr: "https://hyperevmscan.io/address/",
+    explorerName: "hyperevmscan",
+    gasUsd: 0.01,
+    routeType: "atomic",
+    escrow: { address: null, mode: "simulated" },
+    tokens: [
+      // USDC и USDT0 (на контракте symbol = "USD₮0"): проверено вызовами в самой сети (chainId 999).
+      { symbol: "USDC", address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f", decimals: 6, usd: 1, cls: "ar-token-usdc" },
+      { symbol: "USDT", onChainSymbol: "USD₮0", address: "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb", decimals: 6, usd: 1, cls: "ar-token-usdt" },
+    ],
+    // DEX-НОГИ ЗДЕСЬ НЕТ: сеть в статусе coming soon, пулы не ищутся и адреса в реестр не пишутся.
+  },
+];
+
+export const DEFAULT_CHAIN = "arbitrum-sepolia";
+
+// СПИСОК ДОПУЩЕННЫХ ПРОВАЙДЕРОВ - ПОЛИТИКА ИНТЕРФЕЙСА, А НЕ ПРОВЕРКА ЦЕПИ (#76/#77).
+//
+// Цепь отвечает на ДРУГОЙ вопрос: чей ключ подписал котировку (реестр мейкеров, providerOf - его читает
+// ядро, sdk/src/quotes.mjs). ЭТОТ список - решение интерфейса о том, с кем он вообще торгует. Провайдер,
+// чей адрес подтверждён цепью, но не назван здесь, не проходит (код `quote-provider-not-allowed`), и это
+// видно ЧЕЛОВЕКУ до подписи: комиссию показывает котировка, а её выдача не состоится.
+//
+// ПОЧЕМУ ОТДЕЛЬНЫМ СПИСКОМ, А НЕ ЧТЕНИЕМ ИЗ БЕКЕНДА. Отбор - дело интерфейса: он меняется здесь, без
+// передеплоя контрактов и без правок у чужого узла. Такой же список есть и у бекенда
+// (`ARRAKIS_ALLOWED_PROVIDERS`, app/app.env) - это ДВЕ независимые ступени одного решения, а не копия:
+// страница защищает себя сама, даже если сервис настроен иначе.
+//
+// АДРЕСА - в нижнем регистре, как их отдаёт котировка (поле `provider`). Сеть без записи здесь означает
+// "список не задан" (политика не применяется), а НЕ "никого не пускать": иначе сеть без настройки встала бы
+// целиком. Заполнять список для сети нужно тогда, когда там зарегистрирован мейкер.
+export const ALLOWED_PROVIDERS = {
+  "local-anvil": ["0x60af2ad4963c738aa6ac16d6cb0af1982508ba21"],
+};
+
+// Список допущенных для сети - или null, если он не задан (политики нет). Ядро принимает и массив, и
+// предикат; здесь отдаётся массив в нижнем регистре: список - это то, что видно и меняется в одном месте.
+export function allowedProvidersFor(chainOrId) {
+  const id = typeof chainOrId === "string" ? chainOrId : chainOrId && chainOrId.id;
+  const list = ALLOWED_PROVIDERS[id];
+  if (!Array.isArray(list) || list.length === 0) return null;
+  return list.map((a) => String(a).toLowerCase());
+}
+
+// СПИСОК ИЗВЕСТНЫХ СБОРОК ФАБРИКИ - ПОЛИТИКА ИНТЕРФЕЙСА, РЯДОМ С allowedProviders (#103).
+// Значение - extcodehash (keccak256 кода) фабрики, которую интерфейс готов принять: фабрика приходит из
+// ЗАПИСИ РЕЕСТРА провайдера, а её код сверяется с этим списком. Пусто для сети = политики нет (фабрика всё
+// равно обязана быть названа записью и совпасть с подписанной котировкой). Заполняется при развёртывании:
+// у фабрики нет immutable-полей, поэтому одна и та же сборка даёт один и тот же хеш у любого, кто её
+// развернул, - своей фабрикой провайдер попадает в тот же список.
+export const KNOWN_FACTORY_CODES = {};
+
+export function knownFactoryCodesFor(chainOrId) {
+  const id = typeof chainOrId === "string" ? chainOrId : chainOrId && chainOrId.id;
+  const list = KNOWN_FACTORY_CODES[id];
+  if (!Array.isArray(list) || list.length === 0) return null;
+  return list.map((h) => String(h).toLowerCase());
+}
+
+export function chainById(id) {
+  return CHAINS.find((c) => c.id === id) || CHAINS.find((c) => c.id === DEFAULT_CHAIN) || CHAINS[0];
+}
+
+export function chainByChainId(chainId) {
+  return CHAINS.find((c) => c.chainId === Number(chainId)) || null;
+}
+
+// Принимаемые токены сети: нативный первым, затем контрактные.
+export function tokensOf(chainId) {
+  const c = chainById(chainId);
+  return [nativeOf(chainId), ...c.tokens];
+}
+
+export function nativeOf(chainId) {
+  const c = chainById(chainId);
+  return {
+    symbol: c.native.symbol,
+    label: c.native.symbol,
+    address: null,
+    decimals: c.native.decimals,
+    usd: c.native.usd,
+    cls: "ar-token-eth",
+    native: true,
+  };
+}
+
+// Токен по составному идентификатору "<chainId>:<SYMBOL>" либо по паре аргументов.
+export function tokenById(idOrChainId, symbolMaybe) {
+  let chainId = idOrChainId;
+  let symbol = symbolMaybe;
+  if (typeof idOrChainId === "string" && idOrChainId.includes(":")) {
+    [chainId, symbol] = idOrChainId.split(":");
+  }
+  const list = tokensOf(chainId);
+  return list.find((t) => t.symbol === String(symbol).toUpperCase()) || list[0];
+}
+
+
+// Monero-сеть демки.
+// networkType=mainnet - потому что monero-js (вендоренная библиотека мнемоник/ключей/адресов)
+// поддерживает только mainnet-префиксы адресов (см. www/assets/vendors/monero-js/README.md).
+// Режим monero-ts (WebAssembly wallet2) умеет и stagenet.
+// Получатель ордера (claimer) для ТЕСТОВ на тестовых сетях.
+//
+// ВАЖНО: контракт требует, чтобы locker и claimer различались, поэтому адрес оплаты здесь указывать
+// нельзя - транзакция будет отклонена. Платит подключённый кошелёк (кто угодно), а забирает средства тот,
+// кто записан здесь, предъявив секрет ордера.
+// Это ЗАГЛУШКА для испытаний: в бою адрес получателя приходит от RFQ-узла мейкера вместе с котировкой.
+export const TEST_CLAIMER = "0xc14C7841C7d6350859474dD6DF8dC9672047A6A0";
+
+export const MONERO = {
+  // Сеть, в которой демка генерирует свой демо-кошелёк и адрес получателя. Обязана совпадать с
+  // XMR_NETWORKS (ниже) и с той цепью, к которой подключена нода: адрес чужой сети в поле
+  // получателя означает отправленные в никуда XMR. Совпадение проверяет npm test.
+  networkType: "stagenet",
+  confirmTarget: 10, // подтверждений до claim (пример из litepaper §5.0)
+  blockTimeSim: 120_000, // 2 минуты на блок, в sim-времени
+  blockTimeReal: 120_000, // реальный target Monero mainnet
+  // Нода Monero. Адрес задан прямо здесь и больше нигде: параметров у демки нет
+  // (ни ?rpc=, ни localStorage) и переключений RPC не предполагается - меняется строкой в коде.
+  // сегодня в публичную, дальше в свою - для демки разницы нет.
+  // сегодня в публичную, дальше в свою - для демки разницы нет.
+  // Нода нужна только для статуса сети и режима live-подтверждений; ключи, балансы и выводы
+  // через неё не запрашиваются.
+  // АДРЕС НОДЫ. В бою он один и виден в коде (.hermes/deploy/arrakis-xmr-rpc.conf). НА ЛОКАЛЬНОМ СТЕНДЕ
+  // страница обязана ходить на НАШУ ноду: боевой прокси может быть недоступен (502), а высота сети - один из
+  // источников высоты скана для файла восстановления, то есть без ноды файл уходит владельцу без высоты.
+  // Подстановку делает только стенд через окно; в бою window.ARRAKIS_XMR_NODE никто не ставит.
+  node: (typeof window !== "undefined" && window.ARRAKIS_XMR_NODE) || "https://xmr.arrakisswap.trade",
+  nodePollMs: 30_000,
+};
+
+// ---------------------------------------------------------------------------
+// Бэкенд (app/): сессии свопов и наблюдение за Monero-ногой.
+//
+// API живёт на том же домене по пути /api/ (Angie проксирует на 127.0.0.1:8787) - поэтому CSP
+// править не нужно, его покрывает connect-src 'self'. Локально тот же путь отдаёт serve.mjs
+// с флагом --api=http://127.0.0.1:8787 (см. tools/serve.mjs) - тоже без правки политики.
+// ---------------------------------------------------------------------------
+export const API = {
+  base: "/api",
+  // Источник Monero-ноги: 'app' - настоящий бэкенд по HTTP, 'mock' - симулятор демки без сети.
+  xmrSource: "app",
+  pollMs: 5_000, // как часто фронт опрашивает сессию свопа
+  // СКОЛЬКО ПРОВАЙДЕРОВ ПОКАЗЫВАТЬ в блоке цены. Список из десятков строк не читается, а сравнить больше
+  // пяти цен человек всё равно не сможет - он выбирает лучшую. Остальные не скрываются молча: об их
+  // существовании говорит строка-итог ("и ещё N").
+  maxProviders: 5,
+  timeoutMs: 60_000, // Таймаут одного запроса: зависший бэкенд не должен подвешивать экран. 60 с, а не 10: создание
+    // кошелька сделки - единственный ДОЛГИЙ путь, он сканирует цепочку от высоты восстановления, и
+    // прежние 10 с обрывали РАБОТАЮЩИЙ запрос. Снаружи это выглядело как «Swap wallet unavailable».
+    // Срок поднимали дважды (8 -> 10 -> 60): здесь короткий таймаут не защита, а ложный отказ.
+};
+
+// Сеть Monero для каждого источника. Бэкенд на сервере работает со stagenet-кошельком
+// (monero-wallet-rpc поднят на stagenet-ноде), поэтому в режиме 'app' адрес свопа обязан быть
+// stagenet-адресом: иначе wallet-rpc не сможет создать по нему watch-only кошелёк.
+// Мок-режим демки исторически mainnet - адреса из демо-примеров.
+// Одна цепь на всю демку. Раньше мок-режим притворялся mainnet (демка была исторически mainnet),
+// но это только вредило: адреса в мок-режиме выглядели как mainnet (префикс 4), а живая нода -
+// stagenet (префикс 5), и в одном UI соседствовали две цепи. Смешение цепей в свопе означает
+// потерянные деньги (см. monero/address.js), поэтому теперь и мок, и живой режим - stagenet.
+export const XMR_NETWORKS = { app: "stagenet", mock: "stagenet" };
+
+// Страница sweep: отдельный домен со своей (более строгой) политикой и WASM-кошельком.
+// Вывод XMR делает сам пользователь там, по своему recovery-файлу - демка за него не подписывает
+// (см. .hermes/docs/09-sweep-origin.md).
+// Куда ведёт ссылка на страницу вывода. В бою - боевой домен, на локальном стенде - его собственный адрес
+// (там своя нода и свой бэкенд). Отдельная функция, чтобы правило было одним: ссылка и то, где страница
+// действительно поднята, не должны расходиться.
+export function sweepOrigin() {
+  const h = typeof location !== "undefined" ? location.hostname : "";
+  return /^(localhost|127\.0\.0\.1|\[::1\])$/.test(h) || /\.local$/.test(h) ? SWEEP.localOrigin : SWEEP.origin;
+}
+
+export const SWEEP = {
+  origin: "https://sweep.arrakisswap.trade",
+  localOrigin: "http://localhost:5195",
+};
+
+// ---------------------------------------------------------------------------
+// EVM-кошелёк: WalletConnect (Reown).
+// projectId - публичный идентификатор приложения, его видит любой сайт с WalletConnect
+// (это не секрет: он уходит в QR и в relay). Метаданные показываются пользователю в кошельке.
+// ---------------------------------------------------------------------------
+export const EVM = {
+  projectId: "18c13c05b6c0ab011ffff7cee0700e2d",
+  metadata: {
+    name: "ArrakisSwap",
+    description: "Non-custodial XMR <-> EVM atomic swap. Demo build: real wallet, real balances, no real funds move.",
+    url: "https://arrakisswap.trade",
+    icons: [],
+  },
+};
+
+// СТАВКИ КОМИССИИ ЗДЕСЬ НЕТ - И НЕ ДОЛЖНО БЫТЬ. Единственный источник правды: ПОДПИСАННАЯ КОТИРОВКА.
+// Ставка, величина и получатель комиссии - часть условий ордера (решение #76); функций feeBps()/feeFor() у
+// фабрики больше нет (роутер удалён), и узел не сверяет свою настройку с цепью - он её ПОДПИСЫВАЕТ, а
+// величина приходит в котировке и сверяется зеркалом формулы (www/js/evm/fees.js, rfq/fundEscrow.mjs).
+// Копия в конфиге разошлась бы с подписанным набором - и выяснилось бы это не здесь, а на подписи.
+// Запись со ставкой (0.003) удалена 28 сентября 2026; переход на котировку - этап #76 (комиссия в ордере).
+
+// Мок-мейкеры. Спред - то, что мейкер забирает себе; комиссия Arrakis считается отдельно.
+// СПИСОК ВЫДУМАННЫХ МЕЙКЕРОВ УДАЛЁН. Раньше здесь лежали Maker A/B/C с надбавкой, аптаймом, запасом и
+// задержкой - и всё это уходило в интерфейс как факты. Аптайм чужого сервиса мы не измеряем, запас не
+// знаем, а надбавку провайдер формирует сам и показывает её только в своей цене. Теперь котировки берутся
+// у провайдера через бекенд (/api/rate), и выдумывать рядом с ними нечего.
+
+// Тайминги. Все в sim-миллисекундах (см. js/core/clock.js): при speed=60 одна
+// реальная секунда равна одной sim-минуте.
+export const TIMING = {
+  quoteValid: 12_000, // срок жизни котировки (12 сек в sim)
+  quoteRefresh: 5_000,
+  fundingMined: 6_000, // tx фондирования попала в блок
+  makerLock: 30_000, // мейкер лочит XMR
+  xmrConfirm: MONERO.blockTimeSim,
+  readyWindow: 60 * 60_000, // сколько у пользователя есть на ready после лока
+  makerClaim: 45_000,
+  sweep: 30_000,
+  t0Refund: 20 * 60_000, // после этого можно вернуть ETH, если мейкер не залочил XMR
+  t1Refund: 40 * 60_000, // после этого можно вернуть ETH, если мейкер не сделал claim
+  watchtowerGrace: 5 * 60_000, // watchtower возвращает деньги, если пользователь ушёл
+  makerReclaim: 10 * 60_000, // мейкер забирает XMR, если пользователь не сделал ready
+};
+
+export const DEMO = {
+  speeds: [1, 20, 60, 300],
+  defaultSpeed: 60,
+  scenarios: ["happy", "maker_no_lock", "user_no_ready", "maker_stall"],
+  defaultScenario: "happy",
+  // Режима кошелька больше нет: ключи в демке считает monero-js, и это единственный путь
+  // (WASM-кошелёк monero-ts переехал на отдельный домен sweep - своя политика и COOP/COEP).
+  // mock - подтверждения по sim-таймеру; live - по реальной высоте Monero mainnet
+  chainModes: ["mock", "live"],
+  // ЖИВАЯ ВЫСОТА ПО УМОЛЧАНИЮ. "mock" означает подтверждения по таймеру песочницы - это демонстрационный
+  // режим, и он больше не подставляется сам: сделка обязана считаться по настоящей высоте цепи, иначе
+  // «подтверждено» на экране ничего не значит. Демонстрационный режим остался выбором, а не умолчанием.
+  defaultChainMode: "live",
+  // Источник Monero-ноги: 'app' - настоящий бэкенд (см. API.xmrSource), 'mock' - симулятор.
+  xmrSources: ["app", "mock"],
+  defaultXmrSource: "app",
+  defaultChain: DEFAULT_CHAIN,
+};
+
+export const SCENARIO_LABELS = {
+  happy: "happy path",
+  maker_no_lock: "maker never locks XMR",
+  user_no_ready: "user never confirms",
+  maker_stall: "maker stalls after ready",
+};