Commit755ddd00Recorded19 Oct 2026Repositorysigil-http3
Start bounded direct IPv6 phone window with fresh certificate gate
Changed
scripts/phantom-ipv6-phone-run.sh | 15 +++++++++++++++
scripts/vpn-phone-run.mjs | 38 ++++++++++++++++++++++----------------
2 files changed, 37 insertions(+), 16 deletions(-)Diff
scripts/phantom-ipv6-phone-run.shadded
@@ -0,0 +1,15 @@
+1
#!/usr/bin/env bash+2
set -euo pipefail+3
cd "$(dirname "$0")/.."+4
test "${HTTP3_VERIFIED_NATIVE_JOB:-}" = http3-example+5
verified="${HTTP3_WORKSPACE_ROOT:?Set HTTP3_WORKSPACE_ROOT}/$HTTP3_VERIFIED_NATIVE_JOB"+6
test "$(cat "$verified/rc")" = 0+7
mkdir -p tools/interop/build/native/bin+8
cp "$verified/src/tools/interop/build/native/bin/http3-preflight" tools/interop/build/native/bin/+9
node --check scripts/vpn-phone-run.mjs+10
export HTTP3_PREFLIGHT_SAN="IP:127.0.0.1,IP:::1,IP:${HTTP3_IPV4_ADDRESS:-127.0.0.1},IP:$HTTP3_IPV6_ADDRESS,DNS:localhost"+11
export HTTP3_PREFLIGHT_PREBUILT=1 HTTP3_PREFLIGHT_HTTPS_PAGE=1 HTTP3_PREFLIGHT_QUERY=1+12
export HTTP3_SPIKE_SDK_JOB=http3-example+13
HTTP3_PREFLIGHT_HOST=::1 bash scripts/phantom-browser-preflight.sh+14
export HTTP3_PHONE_SCOPE=ipv6-direct+15
exec node scripts/vpn-phone-run.mjs runscripts/vpn-phone-run.mjsmodified
@@ -3,7 +3,7 @@ import { createHash } from 'node:crypto';
3
import { createSocket } from 'node:dgram'; 4
import { copyFileSync, chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'; 5
import { createServer } from 'node:net';−6
import { hostname } from 'node:os';+6
import { hostname, networkInterfaces } from 'node:os'; 7
import { resolve, join } from 'node:path'; 8
import { identity, inspectPlan, runTest, stopRun } from './echo-lifecycle.mjs'; 9
import { startPhonePage } from './phone-page-host.mjs';@@ -34,13 +34,19 @@ async function unusedPort(kind, address) {
34
35
async function runVpnPhone() { 36
+37
const direct = process.env.HTTP3_PHONE_SCOPE === 'ipv6-direct';+38
const bindAddress = direct ? process.env.HTTP3_IPV6_ADDRESS : (process.env.HTTP3_IPV4_ADDRESS ?? '127.0.0.1');+39
if (direct) check(Object.values(networkInterfaces()).flat().some(address =>+40
address?.family === 'IPv6' && address.address === bindAddress && !address.internal),+41
'configured IPv6 address is not assigned'); 42
const verifiedJob = process.env.HTTP3_VERIFIED_NATIVE_JOB; 43
check(/^http3-spike-echo-[0-9]{3}$/.test(verifiedJob ?? ''), 'Expected the admitted native gate'); 44
const verified = `${process.env.HTTP3_WORKSPACE_ROOT ?? (process.cwd() + "/build/workspaces")}/${verifiedJob}`; 45
check(readFileSync(verified + '/rc', 'utf8').trim() === '0', 'Native gate must have completed successfully'); 46
check(readFileSync(verified + '/src/build/spike-echo/result.txt', 'utf8') 47
.includes('RESULT spike-echo-native-v4-v6-and-lifecycle=PASS'), 'Full family/lifecycle gate missing');−43
const receipt = json(verified + '/src/build/browser/capabilities.json');+48
const nativeReceipt = json(verified + '/src/build/browser/capabilities.json');+49
const receipt = direct ? json(resolve('build/browser/capabilities.json')) : nativeReceipt; 50
check(receipt.quicRevision === readFileSync('quic.rev', 'utf8').trim() && 51
receipt.spikeSdkRevision === readFileSync('spike-sdk.rev', 'utf8').trim(), 'Verified QUIC/SDK pair mismatch'); 52
check(['ready', 'bidirectionalEcho', 'unidirectionalEcho', 'datagramEcho', 'chromeReaped', 'serverReaped']@@ -49,12 +55,12 @@ async function runVpnPhone() {
55
'pathChangeLogging', 'cidChangeLogging', 'echoOnly'].every(key => receipt.server?.[key] === true), 56
'Reviewed server capability gate missing'); 57
const originalBinary = verified + '/src/tools/interop/build/native/bin/http3-preflight';−52
const originalCertificate = verified + '/src/build/browser';−53
check(digest(originalBinary) === receipt.binarySha256 &&+58
const originalCertificate = direct ? resolve('build/browser') : verified + '/src/build/browser';+59
check(receipt.binarySha256 === nativeReceipt.binarySha256 && digest(originalBinary) === receipt.binarySha256 && 60
digest(originalCertificate + '/cert.der') === receipt.certificateSha256, 'Verified input hash mismatch'); 61
62
mkdirSync('build', { recursive: true, mode: 0o700 });−57
const directory = resolve('build/phone-vpn');+63
const directory = resolve(direct ? 'build/phone-ipv6' : 'build/phone-vpn'); 64
mkdirSync(directory, { mode: 0o700 }); // Exclusive; never reuse another window. 65
const certificateDirectory = join(directory, 'certificate'); 66
mkdirSync(certificateDirectory, { mode: 0o700 });@@ -66,8 +72,8 @@ async function runVpnPhone() {
72
copyFileSync(originalBinary, binary); 73
chmodSync(binary, 0o700); 74
privateJson(join(directory, 'interop.json'), receipt);−69
const bindAddress = (process.env.HTTP3_IPV4_ADDRESS ?? '127.0.0.1');−70
const lifetimeSeconds = 5400; // 90 minutes, including setup; below the two-hour cap.+75
const pageBindAddress = (process.env.HTTP3_IPV4_ADDRESS ?? '127.0.0.1');+76
const lifetimeSeconds = direct ? 2700 : 5400; // Direct window fits within the already-open firewall guard. 77
const cancellation = new AbortController(); 78
const deadline = Date.now() + lifetimeSeconds * 1000; 79
const timer = setTimeout(() => cancellation.abort(), lifetimeSeconds * 1000);@@ -75,7 +81,7 @@ async function runVpnPhone() {
81
process.on('SIGTERM', terminate); 82
process.on('SIGINT', terminate); 83
const statePath = join(directory, 'state.json');−78
const state = { schema: 1, kind: 'phone-vpn-controller', phase: 'starting',+84
const state = { schema: 1, kind: direct ? 'phone-ipv6-controller' : 'phone-vpn-controller', phase: 'starting', 85
supervisor: identity(process.pid), startedAt: new Date().toISOString(), 86
expiresAt: new Date(deadline).toISOString(), verifiedJob, 87
sourceRevision: receipt.sourceRevision, quicRevision: receipt.quicRevision,@@ -89,18 +95,18 @@ async function runVpnPhone() {
95
const serverDirectory = join(directory, 'server'); 96
try { 97
privateJson(statePath, state);−92
const port = await unusedPort('udp', bindAddress);−93
const pagePort = await unusedPort('tcp', bindAddress);+98
const port = direct ? 43443 : await unusedPort('udp', bindAddress);+99
const pagePort = await unusedPort('tcp', pageBindAddress); 100
cancellation.signal.throwIfAborted();−95
const origin = `https://${bindAddress}:${pagePort}`;−96
const config = { schema: 1, testId: 'phone-vpn-001', expectedHost: hostname(), scope: 'vpn',+101
const origin = `https://${pageBindAddress}:${pagePort}`;+102
const config = { schema: 1, testId: direct ? 'phone-ipv6-001' : 'phone-vpn-001', expectedHost: hostname(), scope: direct ? 'ipv6-direct' : 'vpn', 103
binary, binarySha256: receipt.binarySha256, certificateDirectory, 104
runDirectory: serverDirectory, interopReceipt: join(directory, 'interop.json'),−99
bindAddress, port, lifetimeSeconds, authority: `${bindAddress}:${port}`, origins: [origin] };+105
bindAddress, port, lifetimeSeconds, authority: direct ? `[${bindAddress}]:${port}` : `${bindAddress}:${port}`, origins: [origin] }; 106
const configPath = join(directory, 'server-config.json'); 107
privateJson(configPath, config); 108
check(inspectPlan(configPath).ready, 'Phone lifecycle prerequisites are incomplete');−103
page = await startPhonePage({ schema: 1, scope: 'vpn', expectedHost: hostname(), bindAddress,+109
page = await startPhonePage({ schema: 1, scope: 'vpn', expectedHost: hostname(), bindAddress: pageBindAddress, 110
port: pagePort, lifetimeSeconds, page: resolve('web/phone.html'), certificateDirectory }); 111
page.closed.then(() => cancellation.abort()); 112
server = runTest(configPath, { signal: cancellation.signal }).then(@@ -119,7 +125,7 @@ async function runVpnPhone() {
125
check(serverState?.phase === 'ready' && !serverEnded && !cancellation.signal.aborted, 126
serverError?.message ?? 'Phone server ended before readiness'); 127
const query = new URLSearchParams({ host: bindAddress, port: String(port), hash: receipt.certificateSha256 });−122
const parameters = { scope: 'vpn', host: bindAddress, port, hash: receipt.certificateSha256,+128
const parameters = { scope: direct ? 'ipv6-direct' : 'vpn', host: bindAddress, port, hash: receipt.certificateSha256, 129
pagePort, pageURL: page.url, phoneURL: `${page.url}?${query}`, expiresAt: state.expiresAt, 130
sourceRevision: receipt.sourceRevision, binarySha256: receipt.binarySha256, 131
quicRevision: receipt.quicRevision, sdkRevision: receipt.spikeSdkRevision,@@ -127,7 +133,7 @@ async function runVpnPhone() {
133
privateJson(join(directory, 'parameters.json'), parameters); 134
Object.assign(state, { phase: 'ready', readyAt: new Date().toISOString(), child: serverState.child }); 135
privateJson(statePath, state);−130
console.log(`RESULT phone-vpn-ready parameters=build/phone-vpn/parameters.json expires=${state.expiresAt}`);+136
console.log(`RESULT phone-window-ready parameters=${directory}/parameters.json expires=${state.expiresAt}`); 137
await server; 138
if (serverError) throw serverError; 139
} catch (error) { failure = error; }