AtlatestRepositorysigil-nat
1
// Outside-network probe helper: send a fixed 32-byte challenge and echo.2
import { createSocket } from 'node:dgram';3
import { isIP } from 'node:net';4
import { writeFileSync } from 'node:fs';5
import { resolve } from 'node:path';6
import { performance } from 'node:perf_hooks';7
import { pathToFileURL } from 'node:url';9
function 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
});34
}36
export 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() };50
}52
if (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
}65
}