AtlatestRepositorysigil-http3

sigil-http3 / tree / scriptspunch-prime.mjs

1// Bounded socket priming only. No router control or background sender.
2import { createSocket } from 'node:dgram';
3import { BlockList, isIP } from 'node:net';
4import { setTimeout as pause } from 'node:timers/promises';
5
6export const punchPorts = Object.freeze([40000, 40001, 40002]);
7function check(value, message) { if (!value) throw new Error(message); }
8export 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;
21export 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 }