@ninsei-labs/sdk 0.39.3 → 0.40.0

package/engine/mock/chain.js

@@ -1,14 +1,13 @@
 // GENERATED FILE - a byte-for-byte copy of the engine module www/js/mock/chain.js for the SDK package.
-// Edit the source under www/js, then run: node tools/build-sdk-engine.mjs
-// tools/check-sdk-engine.mjs reddens on any drift, so a stale copy cannot ship silently.
+// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
 // Everything below this header is identical to the source.
 
-// Мок-чейн: escrow-контракт на EVM и Monero-нога.
+// Mock chain: the escrow contract on EVM and the Monero leg.
 //
-// Здесь НЕТ реальных транзакций. Всё, что возвращается, помечено как mock, а хеши
-// детерминированы от id сделки - чтобы демо было воспроизводимо.
-// Точка подмены: когда появится контракт, эти функции заменяются на вызовы ethers.js,
-// а интерфейс (fund/lock/claim/refund/sweep) сохраняется.
+// There are NO real transactions here. Everything returned is marked mock, and the hashes
+// are deterministic from the swap id - so the demo is reproducible.
+// Swap-out point: once the contract exists, these functions are replaced by ethers.js calls,
+// while the interface (fund/lock/claim/refund/sweep) is preserved.
 
 import { randomHex } from "../core/format.js";
 import * as node from "../monero/node.js";
@@ -23,12 +22,12 @@ function hashOf(...parts) {
   return "0x" + hh.toString(16).padStart(8, "0") + randomHex(28);
 }
 
-// CREATE2-адрес per-order escrow (litepaper §8: свой контракт на сделку, без admin).
+// CREATE2 address of the per-order escrow (litepaper §8: its own contract per swap, no admin).
 export function escrowAddress(swapId) {
   return "0x" + hashOf("escrow", swapId).slice(2, 42);
 }
 
-// Адрес совместного Monero-выхода (S_a + S_b, V_a + V_b в реальном протоколе).
+// Address of the joint Monero output (S_a + S_b, V_a + V_b in the real protocol).
 export function moneroLockAddress(swapId) {
   return "8" + hashOf("xmrlock", swapId).slice(2, 96);
 }
@@ -41,10 +40,10 @@ export function fundEscrow({ swapId, ethAmountUsd, ethUsd }) {
     ethAmount: ethUsd > 0 ? ethAmountUsd / ethUsd : 0,
     valueUsd: ethAmountUsd,
     gasUsd: 0.21,
-    // ИМЯ МЕТОДА НЕ ВЫДУМЫВАЕМ. Здесь стояло lockAndSwap(bytes32 quoteHash, bytes makerSig) - такого
-    // метода в контракте нет вовсе, но именно эта строка уезжала в запись сделки и показывалась на экране
-    // как "Escrow method". Демо-путь денег не двигает, поэтому честная подпись для него - эта, без
-    // выдуманной сигнатуры. Настоящее имя вызова живой путь записывает сам, из фактического вызова.
+    // WE DO NOT INVENT THE METHOD NAME. This used to be lockAndSwap(bytes32 quoteHash, bytes makerSig) - no
+    // such method exists in the contract at all, yet that exact string went into the swap record and was shown
+    // on screen as "Escrow method". The demo path moves no money, so its honest label is this one, without the
+    // invented signature. The real call name is written by the live path itself, from the actual call.
     method: "simulated funding (no real transaction)",
     confirmations: 1,
   };
@@ -69,12 +68,12 @@ export function refundEscrow({ swapId, by }) {
   return { mock: true, txHash: hashOf("refund", swapId, by), by };
 }
 
-// Подтверждения Monero-ноды: 10 блоков по 2 минуты (litepaper §5.0).
+// Monero node confirmations: 10 blocks of 2 minutes (litepaper §5.0).
 //
-// chainMode=mock - подтверждения идут по sim-времени (быстро, для показа потока).
-// chainMode=live - подтверждения считаются по реальному росту высоты mainnet-нода:
-//   сделка тогда честно длится ~20 минут независимо от скорости демки. Если нод
-//   недоступен или высота на момент лока не зафиксирована, откатываемся на sim-счётчик.
+// chainMode=mock - confirmations follow sim-time (fast, for showing the flow).
+// chainMode=live - confirmations are counted from the real height growth of the mainnet node:
+//   the swap then honestly takes ~20 minutes regardless of the demo speed. If the node
+//   is unavailable or the height at lock time was not recorded, we fall back to the sim counter.
 export function confirmations(swap, simElapsedMs) {
   const target = swap.timeline.confTarget;
 

package/engine/monero/address.js

@@ -1,29 +1,18 @@
 // GENERATED FILE - a byte-for-byte copy of the engine module www/js/monero/address.js for the SDK package.
-// Edit the source under www/js, then run: node tools/build-sdk-engine.mjs
-// tools/check-sdk-engine.mjs reddens on any drift, so a stale copy cannot ship silently.
+// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
 // Everything below this header is identical to the source.
 
-// Проверка и сборка Monero-адресов: формат + настоящий checksum + префиксы всех сетей.
-//
-// Важная деталь, на которой легко ошибиться: у Monero СВОЙ base58 - блочный
-// (8 байт кодируются 11 символами, остаток идёт в конце). Он НЕ совместим с обычным
-// биткойн-base58: там ведущий символ '1' означает нулевой байт, а у Monero блок кодируется
-// как ЧИСЛО, и '1' может быть просто цифрой внутри числа. Поэтому ни bs58.decode, ни
-// bs58.encode здесь не годятся - base58 реализован ниже численно (см. base58ToBlock).
-//
-// Зачем это нужно в демке: без проверки checksum опечатка в адресе получения
-// выглядит валидной, а в atomic-свопе ошибка в адресе означает потерянные деньги.
-//
-// Префиксы сетей (из src/cryptonote_config.h, официальные значения):
-//   mainnet: 18 обычный, 19 с payment id, 42 суб-адрес
-//   stagenet: 24 / 25 / 36
-//   testnet: 53 / 54 / 63
-// Вендоренная monero-js умеет ТОЛЬКО mainnet (у неё в address.js жёстко 18/19/42),
-// поэтому здесь свой энкодер: библиотека даёт публичные ключи, а строку адреса собираем мы.
+// Monero address checks and assembly: format + real checksum + network prefixes.
+// A detail easy to get wrong: Monero has its OWN base58 - block-based (8 bytes -> 11 chars, the remainder last).
+// It is NOT compatible with bitcoin-base58, where a leading '1' means a zero byte; here a block is a NUMBER and
+// '1' can be just a digit. So bs58 does not fit and base58 is implemented numerically below.
+// Without the checksum a typo in the payout address looks valid, and in an atomic swap that means lost money.
+// Network prefixes (official): mainnet 18 plain, 19 with payment id, 42 subaddress.
+// The vendored monero-js knows ONLY mainnet, so we have our own encoder: the library gives public keys, we build the string.
 
 const BLOCK_CHARS = 11;
 
-// encoded bytes -> chars (из monero-js/src/base58.js, ENC_BLOCK_BYTE_LENS)
+// encoded bytes -> chars (from the vendored base58 table)
 const CHARS_BY_BYTES = { 1: 2, 2: 3, 3: 5, 4: 6, 5: 7, 6: 9, 7: 10, 8: 11 };
 const BYTES_BY_CHARS = { 2: 1, 3: 2, 5: 3, 6: 4, 7: 5, 9: 6, 10: 7, 11: 8 };
 
@@ -39,7 +28,7 @@ const PREFIXES = {
   63: { network: "testnet", kind: "subaddress" },
 };
 
-// обратная таблица: сеть + вид -> байт префикса (для сборки адреса)
+// reverse table: network + kind -> prefix byte (for address assembly)
 export const PREFIX_BY_NETWORK = {
   mainnet: { primary: 18, integrated: 19, subaddress: 42 },
   stagenet: { primary: 24, integrated: 25, subaddress: 36 },
@@ -54,16 +43,16 @@ export function prefixFor(network, kind = "primary") {
   return prefix;
 }
 
-// Синхронная проверка формата (для UI до загрузки библиотеки).
+// Synchronous format check (for the UI before the library loads).
 export function formatCheck(addr) {
   const a = String(addr || "").trim();
   if (![95, 106].includes(a.length)) return false;
   if (!/^[1-9A-HJ-NP-Za-km-z]+$/.test(a)) return false;
-  // первая буква адреса определяется префиксом сети: 4/8 mainnet, 5/7 stagenet, 9/A/B testnet
+  // the first letter is set by the network prefix: 4/8 mainnet, 5/7 stagenet, 9/A/B testnet
   return ["4", "5", "7", "8", "9", "A", "B"].includes(a[0]);
 }
 
-// Первая буква адреса прямо следует из префикса: 4/8 - mainnet, 5/7 - stagenet, 9/A/B - testnet
+// The first letter follows directly from the prefix: 4/8 mainnet, 5/7 stagenet, 9/A/B testnet
 export function networkFromShape(addr) {
   const a = String(addr || "").trim();
   if (!formatCheck(a)) return null;
@@ -93,7 +82,7 @@ async function loadLib() {
   }
 }
 
-// Алфавит Monero-base58 (тот же, что у Bitcoin, но правила кодирования другие).
+// The Monero-base58 alphabet (same as Bitcoin, different encoding rules).
 const B58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
 const B58_VALUES = (() => {
   const m = new Map();
@@ -101,7 +90,7 @@ const B58_VALUES = (() => {
   return m;
 })();
 
-// Блок байтов -> base58-строка (числом: никакого «ведущий '1' = нулевой байт»).
+// Block of bytes -> base58 string (as a number: no "leading '1' = zero byte").
 function blockToBase58(block) {
   let num = 0n;
   for (const b of block) num = (num << 8n) | BigInt(b);
@@ -113,12 +102,10 @@ function blockToBase58(block) {
   return s;
 }
 
-// base58-строка блока -> ровно `bytes` байтов, выравнивание по ПРАВОМУ краю.
+// base58 block string -> exactly `bytes` bytes, right-aligned.
 //
-// Почему не bs58 из npm: его декодер трактует каждый ведущий символ '1' как нулевой БАЙТ
-// (биткойн-семантика). В Monero блок кодируется как число, и '1' может быть просто цифрой
-// внутри числа - тогда bs58 выдаёт лишний нулевой байт, payload разъезжается, и checksum
-// ложно не сходится. На этом ловились: 18 адресов из 120 (15%) проверялись как «с опечаткой».
+// Why not bs58 from npm: its decoder treats every leading '1' as a zero BYTE (bitcoin semantics). In Monero a
+// block is a number and '1' can be just a digit, so bs58 adds a spurious zero byte and the checksum falsely fails.
 function base58ToBlock(str, bytes) {
   let num = 0n;
   for (const ch of str) {
@@ -135,11 +122,10 @@ function base58ToBlock(str, bytes) {
   return out;
 }
 
-// Блочный Monero-base58: строка -> байты.
+// Block-based Monero base58: string -> bytes.
 //
-// Порядок блоков важен: Monero сначала кодирует полные 8-байтовые блоки (по 11 символов),
-// а НЕПОЛНЫЙ остаток идёт В КОНЦЕ и занимает меньше символов (см. monero-js/src/base58.js:
-// сначала tot_block_cnt блоков, затем last_block_enc_len). Поэтому остаток берём с конца строки.
+// Block order matters: Monero encodes full 8-byte blocks first (11 chars each), and the PARTIAL remainder goes
+// LAST with fewer chars. So the remainder is taken from the end of the string.
 export function decodeMoneroBase58(str) {
   const s = String(str);
   const L = s.length;
@@ -159,8 +145,8 @@ export function decodeMoneroBase58(str) {
   return out;
 }
 
-// Блочный Monero-base58: байты -> строка (обратная к decode выше).
-// Полные 8-байтовые блоки кодируются по 11 символов (слева дополняются '1'), остаток - в конце.
+// Block-based Monero base58: bytes -> string (inverse of decode above). Full 8-byte blocks are 11 chars
+// (left-padded with '1'), the remainder goes last.
 export function encodeMoneroBase58(bytes) {
   const arr = Array.from(bytes);
   const L = arr.length;
@@ -178,7 +164,7 @@ export function encodeMoneroBase58(bytes) {
   return out;
 }
 
-// Полезная нагрузка адреса (без checksum): префикс + публичный spend + публичный view [+ payment id]
+// Address payload (without checksum): prefix + public spend + public view [+ payment id]
 export function addressPayload({ network, kind = "primary", spendPub, viewPub, paymentId }) {
   const prefix = prefixFor(network, kind);
   const spend = hexToBytes(spendPub, 32, "public spend key");
@@ -201,8 +187,8 @@ function hexToBytes(hex, expectedBytes, label) {
   return out;
 }
 
-// Сборка адреса из публичных ключей: deps = { keccak256 } (в браузере - из бандла monero-js).
-// bs58 здесь не нужен: base58 у Monero блочный и числовой, см. комментарий у base58ToBlock.
+// Assembly of the address from public keys: deps = { keccak256 } (in the browser, from the monero-js bundle).
+// bs58 is not needed: Monero base58 is block-based and numeric, see the comment at base58ToBlock.
 export function addressFromKeys({ network, kind = "primary", spendPub, viewPub, paymentId }, deps) {
   if (!deps?.keccak256) throw new Error("addressFromKeys needs { keccak256 }");
   const payload = addressPayload({ network, kind, spendPub, viewPub, paymentId });
@@ -213,9 +199,9 @@ export function addressFromKeys({ network, kind = "primary", spendPub, viewPub,
   return encodeMoneroBase58(full);
 }
 
-// Полная проверка: формат + блочный декод + keccak256-checksum + сеть.
-// expectNetwork (необязательно): если задан, адрес чужой сети считается ошибкой -
-// в свапе на stagenet mainnet-адрес это потерянные деньги, а не придирка.
+// Full check: format + block decode + keccak256 checksum + network.
+// expectNetwork (optional): if set, an address of another network is an error - on a stagenet swap a mainnet
+// address is lost money, not a nitpick.
 export async function checkAddress(addr, opts = {}) {
   const a = String(addr || "").trim();
   if (!formatCheck(a)) {
@@ -235,13 +221,12 @@ export async function checkAddress(addr, opts = {}) {
     if (payloadLen < 65) throw new Error("Address is too short");
     const payload = bytes.slice(0, payloadLen);
     const checksum = bytes.slice(payloadLen);
-    // keccak256 из бандла требует Buffer: Uint8Array он не принимает
+    // keccak256 from the bundle needs Buffer: it does not take Uint8Array
     const digest = Uint8Array.from(l.keccak256(l.Buffer.from(payload)));
     const match = checksum.length === 4 && checksum.every((b, i) => b === digest[i]);
     if (!match) {
-      // Мок-адреса демки (wallet.js, режим mock) намеренно без checksum: они помечены в UI как
-      // фиктивные. Если такой адрес попадёт сюда, «опечатка» - не единственная версия, и текст
-      // должен это говорить, иначе отладка уходит не туда.
+      // The demo mock addresses (wallet.js, mock mode) intentionally have no checksum: the UI marks them as fake,
+      // so a "typo" is not the only explanation for such an address and the text must say so.
       return { ok: false, reason: "Checksum mismatch: the address has a typo, is corrupted, or is a demo mock address (mock addresses have no checksum)" };
     }
 
@@ -257,7 +242,7 @@ export async function checkAddress(addr, opts = {}) {
   }
 }
 
-// Хелпер для кода, который уже загрузил бандл: собрать адрес нужной сети из ключей кошелька.
+// Helper for code that has already loaded the bundle: build an address of the right network from wallet keys.
 export async function addressForNetwork({ network, kind = "primary", spendPub, viewPub }) {
   const l = await loadLib();
   if (!l) throw new Error("monero-js bundle is not available");

package/engine/monero/halvesSweep.js

@@ -1,68 +1,50 @@
 // GENERATED FILE - a byte-for-byte copy of the engine module www/js/monero/halvesSweep.js for the SDK package.
-// Edit the source under www/js, then run: node tools/build-sdk-engine.mjs
-// tools/check-sdk-engine.mjs reddens on any drift, so a stale copy cannot ship silently.
+// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
 // Everything below this header is identical to the source.
 
-// КЛЮЧИ ДЛЯ ВЫВОДА ИЗ ФАЙЛА ПОЛОВИН. Вынесено отдельным модулем, потому что это ОДНА логика на два
-// потребителя: страница вывода (sweep.js) и проверка (tools/check-sweep-halves.mjs). Пока код жил прямо на
-// странице, проверить его можно было только в браузере, а вторая копия в проверке неизбежно разошлась бы с
-// первой - и заметил бы это не тот, кто ошибся.
-//
-// ПОЧЕМУ ЭТО ГЛАВНАЯ ФУНКЦИЯ ВСЕГО ВЫВОДА. Контракт убеждается лишь в том, что ХЕШ раскрытой половины совпал
-// с обязательством. Связь «раскрытая половина и точка в адресе» проверить он не может: ed25519 в EVM нет.
-// Значит её проверяем мы, и ДО всякой синхронизации: (s_a + s_b)*G обязана совпасть с публичным ключом траты
-// ордера. Не совпало - не метём и говорим прямо.
-//
-// Секреты здесь не создаются: обе половины уже есть у стороны (своя - в файле, чужая - раскрыта в цепи).
+// KEYS FOR SWEEPING FROM A HALVES FILE. One logic for two consumers: the sweep page (sweep.js) and the
+// check, so the two cannot drift.
+// This is the main check of the whole sweep: the contract only verifies that the HASH of the revealed half
+// matched the commitment, but ed25519 does not exist in the EVM, so WE must verify that (s_a + s_b)*G equals
+// the order's public spend key - before any synchronisation. No match: do not sweep and say so.
+// No secrets are created here: both halves already exist for the side (its own in the file, the other on chain).
 export function spendKeysFromRevealedHalf({
   halves, ownSpendHalf, ownViewHalf, otherSpendPoint, otherViewHalf, revealedHalf,
 }) {
-  if (!halves) throw new Error("нужна математика половин");
+  if (!halves) throw new Error("half maths is required");
   for (const [name, v] of Object.entries({ ownSpendHalf, ownViewHalf, otherSpendPoint, otherViewHalf, revealedHalf })) {
-    if (v === undefined || v === null || v === "") throw new Error("не задано: " + name);
+    if (v === undefined || v === null || v === "") throw new Error("not set: " + name);
   }
   const sum = halves.combineHalves(BigInt(ownSpendHalf), BigInt(revealedHalf));
   const sumPub = halves.publicHalves(sum).ed;
-  // Ожидаемый ключ траты собирается ИЗ СВОЕЙ ПОЛОВИНЫ И ЧУЖОЙ ТОЧКИ - то есть из того, что было в ордере.
-  // ПОЛОВИНА ИЗ ФАЙЛА ПРИХОДИТ СТРОКОЙ, И ЭТО НАДО УЧЕСТЬ КАЖДЫЙ РАЗ. Строкой она была и в сумме, и здесь -
-  // здесь забыли, и вывод XMR падал на живом стенде с «invalid field element: expected bigint, got string»
-  // уже ПОСЛЕ чтения раскрытой половины из цепи: до этой строки дело доходило, а дальше нет.
+  // The expected spend key is built FROM OWN HALF AND THE COUNTERPARTY POINT (what was in the order).
+  // The half from the file arrives as a string, so it must be converted - forgetting this crashed the XMR
+  // sweep with "expected bigint, got string".
   const expected = halves.combinePublic(halves.publicHalves(BigInt(ownSpendHalf)).ed, otherSpendPoint);
   const norm = (h) => String(h).replace(/^0x/i, "").toLowerCase();
   if (norm(sumPub) !== norm(expected)) {
     throw new Error(
-      "раскрытая половина не соответствует адресу: (s_a + s_b)*G != ключ траты ордера. " +
-        "Половина из другого ордера или подменена - метать нельзя"
+      "revealed half does not match the address: (s_a + s_b)*G != the order spend key. " +
+        "The half is from another order or substituted - sweeping is not allowed"
     );
   }
-  // Полный ключ ПРОСМОТРА - тоже сумма: своей половины из файла и половины контрагента. Тратить он не даёт,
-  // а без него кошелёк не найдёт наши XMR в цепи: ключи просмотра и траты в Monero независимы.
+  // The full VIEW key is also a sum (own half from the file + the counterparty half); it cannot spend, but
+  // without it the wallet cannot find our XMR on chain.
   const viewSum = halves.combineHalves(BigInt(ownViewHalf), BigInt(otherViewHalf));
-  // ПОРЯДОК БАЙТ - ЭТО ФОРМАТ, А НЕ КОСМЕТИКА, И ЗДЕСЬ ОН БЫЛ НЕВЕРЕН ДО 28.09.2026.
-  // Прежняя редакция писала скаляр обычной записью числа: старший байт первым. Библиотека ждёт ЗАПИСЬ
-  // MONERO - младшим байтом вперёд, как скаляр лежит в памяти.
+  // BYTE ORDER IS A FORMAT, NOT COSMETICS, and here it was wrong until 28.09.2026: the old code wrote the
+  // scalar most-significant-byte first, while the library expects Monero order (least-significant first).
+  // Both monero-ts 0.11.16 builds rejected the reversed key; the workarounds kept elsewhere must not fire.
   //
-  // ЗАМЕР 28.09.2026, ОБЕ СБОРКИ monero-ts 0.11.16 (нативная в узле и вендорная в браузере), ОДНИ И ТЕ ЖЕ
-  // ключи: своя же строка (createWalletKeys().getPrivateSpendKey()) принимается КАК ЕСТЬ и публичный ключ
-  // совпадает, а развёрнутая отвергается словами "failed to verify secret spend key". Обе сборки ведут себя
-  // ОДИНАКОВО - значит расхождение было нашим, а не библиотеки: прежняя запись числа давала развёрнутый
-  // порядок, и обе точки входа чинили это обходным путём (страница вывода - reversedKey, инструмент узла -
-  // flip). Обходные пути оставлены КАК СЕТЬ для чужого файла, но срабатывать не должны, и срабатывание
-  // видно в журнале.
-  //
-  // ПРЕФИКСА 0x ЗДЕСЬ НЕТ И БЫТЬ НЕ ДОЛЖНО: библиотека выдаёт ключ 64 hex без префикса и такой принимает,
-  // а вид "0x"+64 hex отвергает на разборе - "failed to parse secret spend key".
-  const be32 = (v) => BigInt(v).toString(16).padStart(64, "0");  // обычная запись числа, старший байт первым
-  const le32 = (v) => be32(v).match(/../g).reverse().join("");   // запись Monero: младший байт первым
+  // NO 0x PREFIX here: the library returns and accepts 64 hex without it, and rejects "0x"+64 hex at parse.
+  const be32 = (v) => BigInt(v).toString(16).padStart(64, "0");  // ordinary number notation, most significant byte first
+  const le32 = (v) => be32(v).match(/../g).reverse().join("");   // Monero notation: least significant byte first
   return { privateSpendKey: le32(sum), privateViewKey: le32(viewSum) };
 }
 
-// ОБРАТНЫЙ ПЕРЕХОД - ТОЖЕ ОДНА ФУНКЦИЯ НА ВСЕХ. Кто читает выданный ключ как ЧИСЛО, обязан развернуть порядок:
-// обычная запись числа (BigInt("0x" + ключ)) прочтёт запись Monero задом наперёд и даст другой скаляр - молча,
-// без всякой ошибки. Ровно на этом мы уже стояли: и проверка, и инструмент пары разбирали ключ напрямую, и
-// после исправления порядка байт оба обязаны были бы покраснеть - если бы их не поправили вместе с модулем.
+// THE REVERSE IS ALSO ONE FUNCTION FOR ALL: reading a returned key directly as a number
+// (BigInt("0x" + key)) silently reverses Monero order and gives another scalar.
 export function scalarFromMoneroHex(h) {
   const hex = String(h).replace(/^0x/i, "");
-  if (!/^[0-9a-f]{64}$/.test(hex)) throw new Error("ключ не в записи Monero: ожидались 64 hex");
+  if (!/^[0-9a-f]{64}$/.test(hex)) throw new Error("key is not in Monero notation: expected 64 hex");
   return BigInt("0x" + hex.match(/../g).reverse().join(""));
 }

package/engine/monero/node.js

@@ -1,20 +1,19 @@
 // GENERATED FILE - a byte-for-byte copy of the engine module www/js/monero/node.js for the SDK package.
-// Edit the source under www/js, then run: node tools/build-sdk-engine.mjs
-// tools/check-sdk-engine.mjs reddens on any drift, so a stale copy cannot ship silently.
+// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
 // Everything below this header is identical to the source.
 
-// Живой Monero-нод: единственная реальная внешняя зависимость демки.
+// The live Monero node: the only real external dependency of the demo.
 //
-// Адрес ноды - константа MONERO.node в www/js/core/config.js: наш прокси
-// https://xmr.arrakisswap.trade (конфиг .hermes/deploy/arrakis-xmr-rpc.conf).
-// Никаких параметров и переопределений у демки нет: адрес один и виден в коде.
-// Используем ноду для двух честных вещей:
-//   1) статус сети в шапке: реальная высота, nettype, доступность нода;
-//   2) режим "live chain": подтверждения Monero считаются по реальному росту высоты,
-//      а не по таймеру (медленно - блок ~2 минуты, зато по-настоящему).
+// The node address is the MONERO.node constant in www/js/core/config.js - the proxy
+// address is supplied at deploy time (see the deploy config for the Monero RPC proxy).
+// The demo has no parameters or overrides: the address is one and visible in the code.
+// We use the node for two honest things:
+//   1) network status in the header: real height, nettype, node availability;
+//   2) "live chain" mode: Monero confirmations are counted from real height growth,
+//      not from a timer (slow - a block is ~2 minutes, but real).
 //
-// Балансы, outputs и ключи через этот RPC не запрашиваются: для этого нужен кошелёк
-// (wallet2 в WASM + view-ключ), это следующий шаг, а не то, что делает демка.
+// Balances, outputs and keys are NOT queried through this RPC: that needs a wallet
+// (wallet2 in WASM + view key), which is the next step, not what the demo does.
 
 import { MONERO } from "../core/config.js";
 
@@ -32,7 +31,7 @@ async function rpc(method, params = {}, path = "/json_rpc") {
     const res = await fetch(RPC + path, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ jsonrpc: "2.0", id: "arrakis-demo", method, params }),
+      body: JSON.stringify({ jsonrpc: "2.0", id: "ninsei-demo", method, params }),
       signal: ctl.signal,
     });
     if (!res.ok) throw new Error("HTTP " + res.status);
@@ -52,7 +51,7 @@ export function lastError() {
   return cache.error;
 }
 
-// Высота сети на момент вызова (из кеша, если он свежий).
+// Network height at call time (from cache, if fresh).
 export async function height() {
   const info = await getInfo();
   return info ? info.height : null;
@@ -94,7 +93,7 @@ function normalize(info) {
   };
 }
 
-// Опрос раз в 30 секунд, пока страница открыта: шапка показывает живую высоту.
+// Poll every 30 seconds while the page is open: the header shows the live height.
 let poller = null;
 export function startPolling(onUpdate, intervalMs = 30_000) {
   if (poller) clearInterval(poller);