@ninsei-labs/sdk 0.56.1 → 0.57.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/LICENSE-POLICY.md +9 -2
- package/README.md +17 -4
- package/THIRD_PARTY_NOTICES.md +174 -0
- package/assets/vendors/MANIFEST.json +1 -5
- package/assets/vendors/sdk/sdk-browser.js +5 -4
- package/engine/atomic/dleq2.js +116 -15
- package/engine/atomic/order.js +21 -3
- package/engine/core/config.js +17 -24
- package/engine/core/deployments.generated.js +103 -0
- package/engine/core/swap.js +7 -7
- package/engine/evm/asyncRoute.js +1 -1
- package/engine/evm/claimGas.js +2 -1
- package/engine/evm/escrow.js +13 -8
- package/engine/evm/factory.js +11 -6
- package/engine/evm/funding.js +8 -3
- package/engine/evm/index.js +2 -4
- package/engine/evm/session.js +3 -3
- package/engine/monero/scan.js +101 -22
- package/engine/recovery/restore.js +8 -8
- package/engine/sdk/bridge.js +2 -5
- package/index.d.ts +48 -11
- package/package.json +4 -2
- package/src/actions.mjs +8 -5
- package/src/codes.mjs +5 -0
- package/src/config.mjs +1 -0
- package/src/engine.mjs +6 -6
- package/src/feeEstimate.mjs +11 -4
- package/src/http.mjs +4 -1
- package/src/index.mjs +1 -1
- package/src/legs/kyber.mjs +23 -0
- package/src/lock.mjs +1 -0
- package/src/order.mjs +108 -20
- package/src/primitives.mjs +4 -5
- package/src/probes.mjs +9 -3
- package/src/public/networks.d.ts +45 -0
- package/src/public/networks.mjs +10 -1
- package/src/public/xmr.mjs +1 -1
- package/src/quotes.mjs +97 -23
- package/src/recovery-key.mjs +32 -14
- package/src/relayFeatures.mjs +25 -13
- package/src/relayFirmClient.mjs +33 -7
- package/src/relayQuote.mjs +87 -10
- package/src/relayView.mjs +3 -3
- package/src/swap-flow.mjs +100 -58
- package/src/swaps.mjs +234 -64
- package/src/sweep-restore.mjs +8 -4
- package/src/sweep.mjs +5 -1
- package/src/version.mjs +1 -1
- package/src/xmr-arrival.mjs +55 -24
- package/assets/vendors/atomic/atomic-browser.js +0 -24
- package/engine/atomic/order-client.js +0 -56
- package/engine/atomic/order-worker.js +0 -156
- package/engine/evm/asyncExec.js +0 -577
- package/engine/evm/asyncLegs.js +0 -308
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
// GENERATED FILE - a byte-for-byte copy of the engine module www/js/atomic/order-client.js for the SDK package.
|
|
2
|
-
// Edit the source under www/js and regenerate the mirror; a drift guard reddens on any difference.
|
|
3
|
-
// Everything below this header is identical to the source.
|
|
4
|
-
|
|
5
|
-
// Worker client: turns message passing into an ordinary call with a progress callback.
|
|
6
|
-
//
|
|
7
|
-
// A separate module is needed so the page knows nothing about postMessage and request ids:
|
|
8
|
-
// it calls buildSide(...) and gets a promise plus the stages.
|
|
9
|
-
export function createOrderWorker() {
|
|
10
|
-
if (typeof Worker === "undefined") throw new Error("workers are unavailable in this environment");
|
|
11
|
-
const worker = new Worker(new URL("./order-worker.js", import.meta.url), { type: "module" });
|
|
12
|
-
const pending = new Map();
|
|
13
|
-
let seq = 0;
|
|
14
|
-
|
|
15
|
-
worker.onmessage = (event) => {
|
|
16
|
-
const msg = event.data || {};
|
|
17
|
-
const entry = pending.get(msg.id);
|
|
18
|
-
if (!entry) return;
|
|
19
|
-
if (msg.kind === "progress") { entry.onProgress?.(msg.stage, msg.detail); return; }
|
|
20
|
-
pending.delete(msg.id);
|
|
21
|
-
if (msg.kind === "done") entry.resolve(msg.result);
|
|
22
|
-
else entry.reject(new Error(msg.message || "worker returned an error"));
|
|
23
|
-
};
|
|
24
|
-
worker.onerror = (event) => {
|
|
25
|
-
const err = new Error("worker crashed: " + (event.message || "no message"));
|
|
26
|
-
for (const [, entry] of pending) entry.reject(err);
|
|
27
|
-
pending.clear();
|
|
28
|
-
};
|
|
29
|
-
|
|
30
|
-
const call = (type, args = {}, onProgress) => {
|
|
31
|
-
const id = ++seq;
|
|
32
|
-
return new Promise((resolve, reject) => {
|
|
33
|
-
pending.set(id, { resolve, reject, onProgress });
|
|
34
|
-
worker.postMessage({ id, type, ...args });
|
|
35
|
-
});
|
|
36
|
-
};
|
|
37
|
-
|
|
38
|
-
return {
|
|
39
|
-
buildSide: (orderContext, onProgress) => call("newSide", { orderContext }, onProgress),
|
|
40
|
-
sealHalf: (orderContext, ownHalf, encPub, onProgress) => call("seal", { orderContext, ownHalf, counterparty: { encPub } }, onProgress),
|
|
41
|
-
verifyCounterparty: (orderContext, counterparty, sealedBytes, onProgress) => call("verify", { orderContext, counterparty, sealedBytes }, onProgress),
|
|
42
|
-
// Commitment to a half. Computed in the worker, because that is where the cryptography lives:
|
|
43
|
-
// only the hash goes out, the half stays inside and never reaches the main thread.
|
|
44
|
-
halfCommitment: (ownHalf) => call("commit", { ownHalf }),
|
|
45
|
-
// Point from a half: the counterparty's half comes from the quote, and the address needs a point.
|
|
46
|
-
pointOf: (ownHalf) => call("pointOf", { ownHalf }),
|
|
47
|
-
// Joint Monero address from the halves - in the worker, because that is where the cryptography lives.
|
|
48
|
-
jointAddress: (joint) => call("jointAddress", { joint }),
|
|
49
|
-
// MAKER MATERIAL OF THE REVERSE REQUEST: both halves, their points and the commitment. There is no proof
|
|
50
|
-
// here and there cannot be: in the reverse direction the node assigns the order binding, and there is
|
|
51
|
-
// nothing to prove before the ticket (order-worker.js, newMakerMaterial). The public part goes to the node
|
|
52
|
-
// in the request, the private part stays with the maker - it is used to claim the payout and see XMR arrival.
|
|
53
|
-
makerMaterial: () => call("newMakerMaterial"),
|
|
54
|
-
stop: () => worker.terminate(),
|
|
55
|
-
};
|
|
56
|
-
}
|
|
@@ -1,156 +0,0 @@
|
|
|
1
|
-
// Воркер: считает сторону ордера ВНЕ главного потока.
|
|
2
|
-
//
|
|
3
|
-
// Зачем он нужен, если он ничего не ускоряет. Доказательство DLEQ в JS занимает около 11 секунд
|
|
4
|
-
// (измерено; разбор половин ключа). Если считать его в главном потоке, страница
|
|
5
|
-
// замирает целиком - вместе с любым индикатором прогресса, который на ней нарисован. Воркер не делает
|
|
6
|
-
// счёт быстрее ни на миллисекунду: он делает его невидимым для интерфейса. Пока воркер считает, страница
|
|
7
|
-
// жива и может честно показывать, что происходит.
|
|
8
|
-
//
|
|
9
|
-
// Протокол: { id, type, ...аргументы } -> { id, kind: "progress"|"done"|"error", ... }
|
|
10
|
-
import {
|
|
11
|
-
createOrderBuilder, ed25519, secp256k1, keccak256, sha3_512, randomBytes,
|
|
12
|
-
} from "../../assets/vendors/atomic/atomic-browser.js";
|
|
13
|
-
|
|
14
|
-
const builder = createOrderBuilder({ ed25519, secp256k1, keccak256, sha3_512, randomBytes });
|
|
15
|
-
|
|
16
|
-
// THE COMMITMENT THE CONTRACT WILL COMPARE, DERIVED FROM THE PROVEN POINT. The worker's vendored builder can check
|
|
17
|
-
// the DLEQ equation, but its verifySide did not compare the proven secp256k1 point with the quote's commitment.
|
|
18
|
-
// engine/atomic/order.js carries that comparison; this worker runs the prebuilt bundle, so the same comparison is
|
|
19
|
-
// made here from the bundle's own secp256k1 and keccak256. A proof that is valid for another point must not build a
|
|
20
|
-
// side that funding then signs.
|
|
21
|
-
const commitmentOfPoint = (value) => {
|
|
22
|
-
try {
|
|
23
|
-
const point = secp256k1.Point.fromHex(String(value || "").replace(/^0x/i, ""));
|
|
24
|
-
const xy = point.toBytes(false).slice(1);
|
|
25
|
-
return "0x" + Array.from(keccak256(xy), (b) => b.toString(16).padStart(2, "0")).join("");
|
|
26
|
-
} catch { return null; }
|
|
27
|
-
};
|
|
28
|
-
const low160 = (value) => String(value || "").replace(/^0x/i, "").toLowerCase().slice(-40);
|
|
29
|
-
|
|
30
|
-
// Ключи шифрования построенных сторон: приватный ключ по своему публичному. Наружу приватные не уходят -
|
|
31
|
-
// вскрытие посылки происходит здесь.
|
|
32
|
-
//
|
|
33
|
-
// ПОЧЕМУ КАРТА, А НЕ ОДНА ПЕРЕМЕННАЯ. Сторон в ордере две, и посылка шифруется на ключ КОНКРЕТНОЙ стороны.
|
|
34
|
-
// Одна переменная хранила ключ последней построенной стороны, поэтому посылка вскрывалась не тем ключом, и
|
|
35
|
-
// проверка честно отвечала "в шифртексте не та половина". Теперь ключ находится по публичному.
|
|
36
|
-
const encPrivByPub = new Map();
|
|
37
|
-
|
|
38
|
-
// Кому зашифрована посылка в данном контексте ордера. Контекст - идентификатор стороны.
|
|
39
|
-
const sealedToPub = new Map();
|
|
40
|
-
|
|
41
|
-
const canon = (h) => "0x" + String(h || "").replace(/^0x/i, "").toLowerCase();
|
|
42
|
-
|
|
43
|
-
self.onmessage = async (event) => {
|
|
44
|
-
const { id, type, orderContext, ownHalf, counterparty, sealedBytes, joint } = event.data || {};
|
|
45
|
-
const say = (stage, detail) => self.postMessage({ id, kind: "progress", stage, detail });
|
|
46
|
-
try {
|
|
47
|
-
if (type === "newSide") {
|
|
48
|
-
// Половина генерируется мгновенно, а доказательство считается долго: сообщаем оба этапа
|
|
49
|
-
// раздельно, чтобы интерфейс успел показать первый до начала второго.
|
|
50
|
-
say("half", "генерирую половину ключа");
|
|
51
|
-
// Текст идёт НА КНОПКУ: она неактивна во время доказательства, и это единственное место, куда
|
|
52
|
-
// смотрит пользователь. Поэтому коротко и на языке интерфейса.
|
|
53
|
-
say("proof", "proving DLEQ proof: about 10 seconds");
|
|
54
|
-
const side = builder.newSide(orderContext, false, (bit, total) => {
|
|
55
|
-
say("proof", "proving DLEQ proof: " + bit + " of " + total + " bits (" +
|
|
56
|
-
Math.round((bit / total) * 100) + "%)");
|
|
57
|
-
});
|
|
58
|
-
// Hex-поля отдаём в каноническом виде (с префиксом 0x, нижний регистр), как это делает seal():
|
|
59
|
-
// иначе одни и те же байты гуляют по коду в двух записях, и однажды это даёт ошибку в другом месте.
|
|
60
|
-
const canon = (h) => "0x" + String(h).replace(/^0x/i, "").toLowerCase();
|
|
61
|
-
// Ключ кладём в карту по публичному: он понадобится, если посылка шифруется на эту сторону.
|
|
62
|
-
encPrivByPub.set(canon(side.enc.pub), side.enc.priv);
|
|
63
|
-
self.postMessage({
|
|
64
|
-
id, kind: "done",
|
|
65
|
-
result: {
|
|
66
|
-
pub: { ed: canon(side.pub.ed), secp: canon(side.pub.secp) },
|
|
67
|
-
encPub: canon(side.enc.pub),
|
|
68
|
-
proof: side.proof,
|
|
69
|
-
half: side.half, // BigInt: структурное клонирование переносит его без потерь
|
|
70
|
-
// ПОЛОВИНА ПРОСМОТРА ТОЖЕ УХОДИТ НАРУЖУ. Без неё сборка общего адреса падала на «не задано:
|
|
71
|
-
// ownViewHalf»: воркер возвращал только половину КЛЮЧА ТРАТЫ, а вызывающий код брал из ответа обе.
|
|
72
|
-
// Сторона их создаёт (order.js: newSide), терялся именно ответ воркера.
|
|
73
|
-
viewHalf: side.viewHalf,
|
|
74
|
-
viewPub: canon(side.viewPub),
|
|
75
|
-
},
|
|
76
|
-
});
|
|
77
|
-
} else if (type === "seal") {
|
|
78
|
-
say("seal", "шифрую половину для контрагента");
|
|
79
|
-
// Запоминаем, на чей ключ зашифровали: именно им и надо будет вскрывать.
|
|
80
|
-
sealedToPub.set(String(orderContext), canon(counterparty && counterparty.encPub));
|
|
81
|
-
const sealed = builder.sealFor({ enc: { pub: counterparty.encPub } }, ownHalf, orderContext);
|
|
82
|
-
self.postMessage({ id, kind: "done", result: { commitment: sealed.commitment, bytes: sealed.bytes } });
|
|
83
|
-
} else if (type === "commit") {
|
|
84
|
-
// Обязательство на половину: наружу уходит только хеш, сама половина остаётся здесь.
|
|
85
|
-
const hex = "0x" + builder.halfCommitment(ownHalf).replace(/^0x/, "");
|
|
86
|
-
self.postMessage({ id, kind: "done", result: { commitment: hex } });
|
|
87
|
-
} else if (type === "pointOf") {
|
|
88
|
-
self.postMessage({ id, kind: "done", result: { ed: builder.pointOf(ownHalf) } });
|
|
89
|
-
} else if (type === "jointAddress") {
|
|
90
|
-
// АДРЕС СЧИТАЕТСЯ ЗДЕСЬ, А НЕ В ГЛАВНОМ ПОТОКЕ: криптография живёт в одном месте, и главный поток
|
|
91
|
-
// не должен обрастать половинами и кривыми. Наружу уходит строка адреса и обе публичные точки.
|
|
92
|
-
self.postMessage({ id, kind: "done", result: builder.jointAddress(joint || {}) });
|
|
93
|
-
} else if (type === "newMakerMaterial") {
|
|
94
|
-
// МАТЕРИАЛ МЕЙКЕРА ОБРАТНОЙ СДЕЛКИ: ДВЕ ПОЛОВИНЫ И ИХ ПУБЛИЧНАЯ ЧАСТЬ, БЕЗ ДОКАЗАТЕЛЬСТВА.
|
|
95
|
-
//
|
|
96
|
-
// ПОЧЕМУ БЕЗ ДОКАЗАТЕЛЬСТВА, хотя в прямом направлении сторона его несёт. Доказательство DLEQ
|
|
97
|
-
// связывает половину с ПРИВЯЗКОЙ ордера (соль, сроки, адрес забора), а привязку в обратном режиме
|
|
98
|
-
// назначает НОДА и присылает её в билете. Пока билета нет, контекста нет, и доказывать нечего -
|
|
99
|
-
// ровно поэтому фаза 1 мейкера у ноды (tools/maker-reverse-order.mjs) считает те же величины и
|
|
100
|
-
// ничего не доказывает. Считать здесь одиннадцатисекундное доказательство значило бы заморозить
|
|
101
|
-
// кнопку заявки на то, что ноде пока не нужно.
|
|
102
|
-
//
|
|
103
|
-
// ЧТО УХОДИТ НАРУЖУ: те же четыре имени, которыми нода принимает заявку мейкера
|
|
104
|
-
// (rfq/reverseOrder.mjs, makerRequestRefusal), - и две половины, которыми мейкер потом забирает
|
|
105
|
-
// выплату и видит приход XMR. Имена половин взяты у вывода (order.js: newSide) и у файла
|
|
106
|
-
// восстановления (recovery/recoveryFile.js: spendHalf, viewHalf), чтобы у одного и того же
|
|
107
|
-
// значения не появилось второго имени.
|
|
108
|
-
const spendHalf = builder.halves.newHalf();
|
|
109
|
-
const viewHalf = builder.halves.newHalf();
|
|
110
|
-
self.postMessage({
|
|
111
|
-
id, kind: "done",
|
|
112
|
-
result: {
|
|
113
|
-
// ОБЯЗАТЕЛЬСТВО И ТОЧКА - ОБ ОДНОЙ И ТОЙ ЖЕ ПОЛОВИНЕ ТРАТЫ, и считает их один модуль половин:
|
|
114
|
-
// цепь сверяет половину с обязательством (NinseiEscrow.sol:235), поэтому разойтись им нельзя.
|
|
115
|
-
commitHalfClaimer: canon(builder.halfCommitment(spendHalf)),
|
|
116
|
-
edPointClaimer: canon(builder.halves.publicHalves(spendHalf).ed),
|
|
117
|
-
// ТОЧКА ПРОСМОТРА: по ней нода собирает общий адрес (адрес - сумма точек).
|
|
118
|
-
edViewPointClaimer: canon(builder.halves.publicHalves(viewHalf).ed),
|
|
119
|
-
// ПОЛОВИНА ПРОСМОТРА - ПРИВАТНАЯ и уходит ноде единственной из двух приватных: без неё она не
|
|
120
|
-
// увидит приход XMR. Форма записи та же, что у ноды: 32 байта hex (maker-reverse-order.mjs:83).
|
|
121
|
-
viewHalfClaimer: canon("0x" + viewHalf.toString(16).padStart(64, "0")),
|
|
122
|
-
spendHalf,
|
|
123
|
-
viewHalf,
|
|
124
|
-
},
|
|
125
|
-
});
|
|
126
|
-
} else if (type === "verify") {
|
|
127
|
-
say("verify", "проверяю доказательство контрагента");
|
|
128
|
-
const side = { proof: counterparty.proof, pub: { ed: counterparty.edPub }, commitHalfClaimer: counterparty.commitHalfClaimer || null };
|
|
129
|
-
// Вскрываем тем ключом, на который посылка была зашифрована в этом контексте.
|
|
130
|
-
const recipient = sealedToPub.get(String(orderContext));
|
|
131
|
-
const openWith = recipient ? encPrivByPub.get(recipient) : null;
|
|
132
|
-
if (sealedBytes && !openWith) {
|
|
133
|
-
throw new Error("нет ключа, которым вскрывать посылку: не было шифрования в этом контексте ордера");
|
|
134
|
-
}
|
|
135
|
-
let verdict = builder.verifySide(side, orderContext, sealedBytes || null, openWith);
|
|
136
|
-
// THE PROOF IS ABOUT THE COMMITMENT IN THE QUOTE, not only about two points that stand for one scalar. The
|
|
137
|
-
// contract pays against commitHalfClaimer; without this comparison a counterparty proves one point and funds
|
|
138
|
-
// another, and the half revealed at claim time does not open the joint address.
|
|
139
|
-
if (verdict && verdict.ok === true) {
|
|
140
|
-
if (!counterparty.commitHalfClaimer) {
|
|
141
|
-
verdict = { ok: false, reason: "the counterparty side carries no commitHalfClaimer" };
|
|
142
|
-
} else {
|
|
143
|
-
const proven = commitmentOfPoint(counterparty.proof && counterparty.proof.XA);
|
|
144
|
-
if (!proven || low160(proven) !== low160(counterparty.commitHalfClaimer)) {
|
|
145
|
-
verdict = { ok: false, reason: "the proven secp256k1 point does not match commitHalfClaimer: " + (proven || "unparsed") + " vs " + counterparty.commitHalfClaimer };
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
self.postMessage({ id, kind: "done", result: verdict });
|
|
150
|
-
} else {
|
|
151
|
-
self.postMessage({ id, kind: "error", message: "неизвестный запрос воркеру: " + String(type) });
|
|
152
|
-
}
|
|
153
|
-
} catch (err) {
|
|
154
|
-
self.postMessage({ id, kind: "error", message: (err && err.message) || String(err) });
|
|
155
|
-
}
|
|
156
|
-
};
|