AtlatestRepositorysigil-nat

sigil-nat / tree / tools / natexternal-udp-probe.mjs

1// Outside-network probe helper: send a fixed 32-byte challenge and echo.
2import { createSocket } from 'node:dgram';
3import { isIP } from 'node:net';
4import { writeFileSync } from 'node:fs';
5import { resolve } from 'node:path';
6import { performance } from 'node:perf_hooks';
7import { pathToFileURL } from 'node:url';
8
9function probe(externalAddress, externalPort, challenge, timeoutMs, excludedPort) {
10 return new Promise((resolveProbe, reject) => {
11 const socket = createSocket('udp4');
12 const started = performance.now();
13 let finished = false;
14 const finish = (error, value) => {
15 if (finished) return;
16 finished = true;
17 clearTimeout(timer);
18 try { socket.close(); } catch {}
19 if (error) reject(error); else resolveProbe(value);
20 };
21 const timer = setTimeout(() => finish(null, { echoed: false }), timeoutMs);
22 socket.on('error', error => finish(error));
23 socket.on('message', (bytes, peer) => {
24 if (peer.address !== externalAddress || peer.port !== externalPort || !bytes.equals(challenge)) return;
25 finish(null, { echoed: true, sourcePort: socket.address().port,
26 rttMs: Number((performance.now() - started).toFixed(3)) });
27 });
28 socket.bind(0, () => {
29 // Never label a reused source port as a fresh post-delete path.
30 if (socket.address().port === excludedPort) return finish(new Error('Post-delete source port was reused; no packet sent'));
31 socket.send(challenge, externalPort, externalAddress, error => { if (error) finish(error); });
32 });
33 });
36export async function runExternalUdpProbe({ externalAddress, externalPort, challengeHex }) {
37 if (isIP(externalAddress) !== 4 || !Number.isInteger(externalPort) ||
38 externalPort < 1 || externalPort > 65535 || !/^[0-9a-f]{64}$/i.test(challengeHex || ''))
39 throw new Error('Invalid UDP probe target/32-byte challenge');
40 const challenge = Buffer.from(challengeHex, 'hex');
41 const beforeDelete = await probe(externalAddress, externalPort, challenge, 3000);
42 if (!beforeDelete.echoed) {
43 return { targetAddress: externalAddress, externalPort, beforeDelete,
44 afterDelete: { echoed: false, skipped: true }, checkedAt: new Date().toISOString() };
45 }
46 await new Promise(resolveWait => setTimeout(resolveWait, 8000));
47 const afterDelete = await probe(externalAddress, externalPort, challenge, 2500, beforeDelete.sourcePort);
48 return { targetAddress: externalAddress, externalPort,
49 beforeDelete, afterDelete, checkedAt: new Date().toISOString() };
52if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
53 const [externalAddress, portText, challengeHex, receiptPath = 'probe-receipt.json'] = process.argv.slice(2);
54 const result = await runExternalUdpProbe({ externalAddress, externalPort: Number(portText), challengeHex });
55 writeFileSync(receiptPath, JSON.stringify(result, null, 2) + '\n', { mode: 0o600 });
56 if (!result.beforeDelete.echoed) {
57 console.log('RESULT outsideEcho=false postDeleteProbe=not-sent');
58 process.exitCode = 1;
59 } else if (!result.afterDelete.echoed) {
60 console.log('RESULT outsideEcho=true rttMs=' + result.beforeDelete.rttMs + ' postDeleteProbe=timeout');
61 } else {
62 console.log('RESULT outsideEcho=true rttMs=' + result.beforeDelete.rttMs + ' postDeleteProbe=echoed');
63 process.exitCode = 1;
64 }