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 run
scripts/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; }