AtlatestRepositorysigil-http3
sigil-http3 / tree / scriptspunch-prime.mjs
1
// Bounded socket priming only. No router control or background sender.2
import { createSocket } from 'node:dgram';3
import { BlockList, isIP } from 'node:net';4
import { setTimeout as pause } from 'node:timers/promises';6
export const punchPorts = Object.freeze([40000, 40001, 40002]);7
function check(value, message) { if (!value) throw new Error(message); }8
export function validateRendezvous(value, localAddress, now = Date.now()) {9
check(value?.cellularOnly === true && isIP(value.phoneIPv6) === 6 &&10
/^[23][0-9a-f:]+$/i.test(value.phoneIPv6) && !/^2001:db8:/i.test(value.phoneIPv6) &&11
!value.phoneIPv6.includes('%'), 'Need the current numeric global cellular IPv6');12
const home = new BlockList();13
home.addSubnet(localAddress, 64, 'ipv6');14
check(!home.check(value.phoneIPv6, 'ipv6'), 'Cellular target must be outside local /64');15
const observed = Date.parse(value.observedAt);16
check(Number.isFinite(observed) && observed <= now && now - observed <= 600000,17
'Manual cellular address must have been confirmed within ten minutes');18
return value.phoneIPv6;19
}21
export async function primeSocket({ bindAddress, sourcePort, phoneIPv6, ports = punchPorts,22
scope = 'ipv6-direct', signal, beforeSend = () => {}, onRecord = () => {} }) {23
check(isIP(bindAddress) === 6 && isIP(phoneIPv6) === 6, 'Priming requires numeric IPv6');24
check(Number.isInteger(sourcePort) && sourcePort >= 1024 && sourcePort <= 65535, 'Invalid priming source port');25
check(ports.length === 3 && ports.every(port => Number.isInteger(port) && port >= 1024 && port <= 65535),26
'Choose exactly three unprivileged destination ports');27
check((scope === 'test-loopback' && bindAddress === '::1' && phoneIPv6 === '::1') ||28
(scope === 'ipv6-direct' && sourcePort === 43443 && /^[23]/i.test(bindAddress) && /^[23]/i.test(phoneIPv6) &&29
ports.every((port, index) => port === punchPorts[index])), 'Priming tuple exceeds the configured scope');30
const socket = createSocket('udp6');31
const receipt = { scope, bindAddress, sourcePort, phoneIPv6, destinationPorts: [...ports],32
mode: 'address-only-unknown-browser-port', startedAt: new Date().toISOString(), packets: [], ingress: [] };33
let bound = false;34
let socketError;35
socket.on('error', error => { socketError = error; });36
socket.on('message', (bytes, peer) => {37
if (receipt.ingress.length >= 32) return;38
const long = bytes.length > 0 && bytes[0] >= 128;39
const length = long && bytes.length >= 6 ? bytes[5] : null;40
receipt.ingress.push({ utc: new Date().toISOString(), address: peer.address, port: peer.port,41
bytes: bytes.length, header: long ? 'long' : 'short',42
dcid: length !== null && length <= 20 && bytes.length >= 6 + length ? bytes.subarray(6, 6 + length).toString('hex') : null,43
outcome: 'priming-socket-no-quic-processing' });44
});45
try {46
signal?.throwIfAborted();47
await new Promise((done, reject) => {48
socket.once('error', reject);49
socket.bind({ address: bindAddress, port: sourcePort, ipv6Only: true, exclusive: true }, done);50
});51
bound = true;52
const local = socket.address();53
check(local.address === bindAddress && local.port === sourcePort, 'Priming source tuple mismatch');54
for (let round = 0; round < 2; round++) {55
for (const port of ports) {56
signal?.throwIfAborted();57
if (socketError) throw socketError;58
beforeSend();59
const bytes = Buffer.alloc(8);60
bytes.write('SGP1');61
bytes.writeUInt32BE(receipt.packets.length, 4);62
await new Promise((done, reject) => socket.send(bytes, port, phoneIPv6, error => error ? reject(error) : done()));63
receipt.packets.push({ utc: new Date().toISOString(), destinationPort: port, bytes: bytes.length });64
onRecord(receipt);65
await pause(150, undefined, { signal });66
}67
}68
if (socketError) throw socketError;69
return receipt;70
} finally {71
await new Promise(done => { try { socket.close(done); } catch { done(); } });72
receipt.socketClosed = true;73
receipt.bound = bound;74
receipt.endedAt = new Date().toISOString();75
receipt.error = socketError?.message;76
onRecord(receipt);77
}78
}