183 lines
12 KiB
JavaScript
183 lines
12 KiB
JavaScript
#!/usr/bin/env node
|
|
// Mission item 12, the weight-backed peer directory (docs/analysis/mission/invent.md 7.1), the fast-time gate: "a fresh
|
|
// node with genesis peers only reaches 8 outbound from the directory". Ten listing nodes mine on one fast-time network,
|
|
// each miner announcing its own node's loopback p2p address in its blocks (`igneum-miner --announce`); every node advertises
|
|
// an UNROUTABLE address as its external ip, so ordinary address gossip hands a fresh node dead addresses only and the
|
|
// directory is the one live source. After --joint seconds (the weight table has every listing key above dust) a fresh node
|
|
// starts with --outpeers=8 and one --addpeer to node 0 (its "genesis peer"), syncs, reads the announcements out of the
|
|
// blocks, and is watched for --watch seconds.
|
|
//
|
|
// --switch on peer_directory_activation_daa 0: the fresh node reaches 8 outbound peers; its log carries "drawn from
|
|
// the peer directory"
|
|
// --switch off the switch at never, the known-failed case: the fresh node holds 1 outbound (node 0) for the whole watch
|
|
// --expect eight|one which outcome is a PASS; `--switch off --expect eight` is the harness's own failed shape (must FAIL)
|
|
//
|
|
// node infra/fast-time/peer-directory.mjs --switch on --expect eight [--listing 10] [--joint 200] [--watch 180] [--slot 0]
|
|
// IGNEUMD and IGNEUM_MINER name the binaries (a build of the peer-directory-node branch).
|
|
//
|
|
// Leftovers of an earlier run of the same slot are stopped by PID FILE, never by name (CLAUDE.md, 6 October 2026).
|
|
|
|
import { spawn } from 'node:child_process';
|
|
import { mkdirSync, rmSync, writeFileSync, readFileSync, openSync, existsSync, appendFileSync } from 'node:fs';
|
|
import { Rpc } from '../../tools/finality-attacks/lib/rpc.mjs';
|
|
|
|
const ROOT = new URL('../../', import.meta.url).pathname;
|
|
const FILE = `${ROOT}infra/fast-time/override-60x.json`;
|
|
const IGNEUMD = process.env.IGNEUMD || `${ROOT}vendor/igneum-node/target-integration/release/igneumd`;
|
|
const CPU_MINER = process.env.IGNEUM_MINER || `${ROOT}vendor/igneum-node/target-integration/release/igneum-miner`;
|
|
const args = process.argv.slice(2);
|
|
const flag = (name, dflt) => { const i = args.indexOf(`--${name}`); return i >= 0 ? Number(args[i + 1]) : dflt; };
|
|
const sflag = (name, dflt = null) => { const i = args.indexOf(`--${name}`); return i >= 0 ? args[i + 1] : dflt; };
|
|
const SWITCH = sflag('switch', 'on');
|
|
const EXPECT = sflag('expect', SWITCH === 'on' ? 'eight' : 'one');
|
|
const LISTING = flag('listing', 10), JOINT = flag('joint', 200), WATCH = flag('watch', 180), SLOT = flag('slot', 0);
|
|
const GENESIS_BITS = flag('genesis-bits', 0x1f010000);
|
|
const CASE = sflag('case') || `switch-${SWITCH}-expect-${EXPECT}`;
|
|
const OUT = sflag('out') || `${ROOT}docs/plans/mission-item-12-gate/peer-directory-${CASE}.json`;
|
|
// nodes at BASE + i x 10 (gRPC, p2p, JSON-RPC, EVM RPC), the fresh node last; a slot is 200 ports wide, clear of every other
|
|
// fast-time harness (the fork gate's slots end at 30930)
|
|
const BASE = 31090 + SLOT * 200, SUFFIX = 975 + SLOT;
|
|
const TMP = `/tmp/igneum-fast-time-pd${SLOT}`;
|
|
const NEVER = '18446744073709551615';
|
|
if (!['on', 'off'].includes(SWITCH) || !['eight', 'one'].includes(EXPECT)) { console.error('usage: --switch on|off --expect eight|one'); process.exit(2); }
|
|
const started = [];
|
|
const log = (...a) => console.log(new Date().toISOString().slice(11, 23), `pd${SLOT}`, ...a);
|
|
const sleep = (ms) => new Promise(r => setTimeout(r, ms));
|
|
for (const b of [IGNEUMD, CPU_MINER]) if (!existsSync(b)) { console.error(`missing ${b}`); process.exit(2); }
|
|
|
|
const PIDS = `${TMP}/pids`;
|
|
function stopLeftovers() {
|
|
if (!existsSync(PIDS)) return;
|
|
const ports = Array.from({ length: 200 }, (_, k) => `127.0.0.1:${BASE + k}`);
|
|
for (const line of readFileSync(PIDS, 'utf8').split('\n').filter(Boolean)) {
|
|
const pid = Number(line);
|
|
let cmd = '';
|
|
try { cmd = readFileSync(`/proc/${pid}/cmdline`, 'utf8'); } catch { continue; }
|
|
if (!cmd.includes(TMP) && !ports.some(p => cmd.includes(p))) continue;
|
|
try { process.kill(pid, 'SIGKILL'); log(`stopped leftover pid ${pid} of an earlier run`); } catch { }
|
|
}
|
|
}
|
|
stopLeftovers();
|
|
await sleep(1000);
|
|
rmSync(TMP, { recursive: true, force: true }); mkdirSync(TMP, { recursive: true });
|
|
const track = (proc) => { started.push(proc); try { appendFileSync(PIDS, `${proc.pid}\n`); } catch { } };
|
|
|
|
const baseText = readFileSync(FILE, 'utf8');
|
|
const field = (name) => { const m = new RegExp(`"${name}":\\s*([0-9]+)`).exec(baseText); return m ? +m[1] : undefined; };
|
|
function mergeOverrideText(text, fields) {
|
|
let out = text;
|
|
for (const k of Object.keys(fields)) out = out.replace(new RegExp(`\\s*"${k}":\\s*[^,}\\n]+,?`), '');
|
|
const extra = Object.entries(fields).map(([k, v]) => `"${k}": ${typeof v === 'string' && !/^\d+$/.test(v) ? JSON.stringify(v) : v}`).join(', ');
|
|
return out.replace(/,?\s*}\s*$/, `,\n ${extra}\n}\n`);
|
|
}
|
|
const DAY_MS = field('pow_day_ms');
|
|
const override = `${TMP}/override.json`;
|
|
writeFileSync(override, mergeOverrideText(baseText, {
|
|
genesis_bits: GENESIS_BITS, skip_proof_of_work: false,
|
|
peer_directory_activation_daa: SWITCH === 'on' ? '0' : NEVER,
|
|
program_class_v3_activation_daa: NEVER, program_class_v4_activation_daa: NEVER,
|
|
}));
|
|
log(`case ${CASE}: switch ${SWITCH}, ${LISTING} listing nodes, joint ${JOINT} s, watch ${WATCH} s, expect ${EXPECT}`);
|
|
|
|
class Node {
|
|
constructor(name, i, peers = [], outpeers = null) {
|
|
this.name = name; this.i = i; this.grpcPort = BASE + i * 10; this.p2pPort = BASE + i * 10 + 1; this.jsonPort = BASE + i * 10 + 2; this.evmPort = BASE + i * 10 + 3;
|
|
this.peers = peers; this.outpeers = outpeers; this.dir = `${TMP}/${name}`; this.logFile = `${this.dir}/node.log`;
|
|
}
|
|
get grpc() { return `grpc://127.0.0.1:${this.grpcPort}`; }
|
|
async start() {
|
|
mkdirSync(this.dir, { recursive: true });
|
|
// the advertised address is unroutable on purpose (10.255.0.0/16 is not on any route from the box), so gossip is dead
|
|
const a = ['--devnet', `--devnet-suffix=${SUFFIX}`, '--nodnsseed', '--disable-upnp', '--nologfiles', '--enable-unsynced-mining', '--utxoindex',
|
|
`--appdir=${this.dir}`, `--rpclisten=127.0.0.1:${this.grpcPort}`, `--rpclisten-json=127.0.0.1:${this.jsonPort}`, `--evm-rpclisten=127.0.0.1:${this.evmPort}`,
|
|
`--listen=127.0.0.1:${this.p2pPort}`, `--externalip=10.255.${Math.floor(this.i / 250)}.${1 + (this.i % 250)}:${this.p2pPort}`,
|
|
`--override-params-file=${override}`, '--loglevel=info', '--yes'];
|
|
for (const p of this.peers) a.push(`--addpeer=127.0.0.1:${p}`);
|
|
if (this.outpeers != null) a.push(`--outpeers=${this.outpeers}`); else if (!this.peers.length) a.push('--outpeers=0');
|
|
const out = openSync(this.logFile, 'a');
|
|
this.proc = spawn(IGNEUMD, a, { stdio: ['ignore', out, out] });
|
|
track(this.proc);
|
|
await sleep(1500);
|
|
if (this.proc.exitCode != null) throw new Error(`${this.name} exited ${this.proc.exitCode}: ${this.grepLog(/ERROR|Error|error|refused|invalid/).slice(-3).join(' | ')}`);
|
|
for (let i = 0; i < 20; i++) {
|
|
const rpc = new Rpc(`ws://127.0.0.1:${this.jsonPort}`);
|
|
try { if (await rpc.connect()) { await rpc.call('getBlockDagInfo'); this.rpc = rpc; break; } } catch { try { rpc.close(); } catch { } }
|
|
this.rpc = null; await sleep(500);
|
|
}
|
|
if (!this.rpc) throw new Error(`${this.name}: the RPC did not answer within 10 s`);
|
|
log(`${this.name} up pid ${this.proc.pid} json ${this.jsonPort} p2p ${this.p2pPort}${this.peers.length ? ` addpeer ${this.peers.join(',')}` : ''}`);
|
|
return this;
|
|
}
|
|
grepLog(re) { try { return readFileSync(this.logFile, 'utf8').split('\n').filter(l => re.test(l)); } catch { return []; } }
|
|
async peers_() {
|
|
const r = await this.rpc.call('getConnectedPeerInfo');
|
|
// RpcPeerInfo is not camelCased in the fork (the response is): is_outbound, not isOutbound (read 14:3x UK, 7 October 2026)
|
|
const list = r.infos || r.peerInfo || r.peer_info || [];
|
|
const out = (p) => p.isOutbound ?? p.is_outbound ?? false;
|
|
return { outbound: list.filter(out).length, inbound: list.filter(p => !out(p)).length, total: list.length };
|
|
}
|
|
async dag() { const d = await this.rpc.call('getBlockDagInfo'); return { blocks: +d.blockCount, daa: +d.virtualDaaScore }; }
|
|
}
|
|
function miner(name, node, threads, secs) {
|
|
const out = openSync(`${TMP}/${name}.log`, 'a');
|
|
const p = spawn(CPU_MINER, ['mine', node.grpc, String(threads), String(secs), name, '--engine', 'igneum-pow', '--payout-label', name, '--status-secs', '60', '--no-vote', '--announce', `127.0.0.1:${node.p2pPort}`],
|
|
{ stdio: ['ignore', out, out], env: { ...process.env, IGNEUM_POW_DAY_MS: String(DAY_MS) } });
|
|
track(p);
|
|
return p;
|
|
}
|
|
async function stopAll() {
|
|
for (const p of started.slice().reverse()) { try { p.kill('SIGINT'); } catch { } }
|
|
await sleep(1500);
|
|
for (const p of started) { try { p.kill('SIGKILL'); } catch { } }
|
|
}
|
|
process.on('SIGINT', async () => { await stopAll(); process.exit(130); });
|
|
process.on('unhandledRejection', async (e) => { log(`FAILED: ${e?.stack || e}`); await stopAll(); process.exit(3); });
|
|
|
|
// the listing nodes: node 0 listens, every other dials node 0 and its predecessor (a mesh with two links each)
|
|
const nodes = [await new Node('n0', 0).start()];
|
|
for (let i = 1; i < LISTING; i++) nodes.push(await new Node(`n${i}`, i, [nodes[0].p2pPort, nodes[i - 1].p2pPort]).start());
|
|
await sleep(2000);
|
|
const t0 = Date.now();
|
|
const since = () => ((Date.now() - t0) / 1000).toFixed(1);
|
|
for (const n of nodes) miner(`pd-${n.name}`, n, 1, JOINT + WATCH + 120);
|
|
await sleep(JOINT * 1000);
|
|
const dag0 = await nodes[0].dag();
|
|
const listed = nodes[0].grepLog(/Peer directory: key .* lists/).length;
|
|
log(`phase 1 done at ${since()} s: node 0 at ${dag0.blocks} blocks DAA ${dag0.daa}; ${listed} directory listing line(s) on node 0`);
|
|
|
|
// the fresh node: one genesis peer, 8 wanted
|
|
const fresh = await new Node('fresh', LISTING, [nodes[0].p2pPort], 8).start();
|
|
const samples = [];
|
|
let eightAt = null;
|
|
const watchAt = Date.now();
|
|
while (Date.now() - watchAt < WATCH * 1000) {
|
|
await sleep(5000);
|
|
const p = await fresh.peers_();
|
|
const d = await fresh.dag();
|
|
const drawn = fresh.grepLog(/drawn from the peer directory/).length;
|
|
const connectedFromDirectory = fresh.grepLog(/connected to .* from the peer directory/).length;
|
|
samples.push({ t: +since(), outbound: p.outbound, inbound: p.inbound, blocks: d.blocks, daa: d.daa, drawn, connected_from_directory: connectedFromDirectory });
|
|
if (p.outbound >= 8 && eightAt == null) { eightAt = +since(); log(`the fresh node holds ${p.outbound} outbound peers at ${since()} s (${connectedFromDirectory} from the directory)`); }
|
|
if (samples.length % 6 === 0) log(`t=${since()} s fresh: ${p.outbound} outbound, ${p.inbound} inbound, ${d.blocks} blocks, ${drawn} draw line(s), ${connectedFromDirectory} directory connection(s)`);
|
|
}
|
|
const last = samples.at(-1);
|
|
const checks = {
|
|
listing_lines_on_node_0: listed >= LISTING - 1,
|
|
fresh_synced: last.blocks > dag0.blocks / 2,
|
|
fresh_reached_eight_outbound: eightAt != null,
|
|
fresh_connected_from_directory: last.connected_from_directory >= 7,
|
|
fresh_held_one_outbound: samples.every(s => s.outbound <= 1),
|
|
no_directory_line_on_fresh: last.drawn === 0 && last.connected_from_directory === 0,
|
|
};
|
|
const good = EXPECT === 'eight'
|
|
? checks.listing_lines_on_node_0 && checks.fresh_synced && checks.fresh_reached_eight_outbound && checks.fresh_connected_from_directory
|
|
: checks.fresh_synced && checks.fresh_held_one_outbound && checks.no_directory_line_on_fresh;
|
|
const needed = EXPECT === 'eight' ? ['listing_lines_on_node_0', 'fresh_synced', 'fresh_reached_eight_outbound', 'fresh_connected_from_directory'] : ['fresh_synced', 'fresh_held_one_outbound', 'no_directory_line_on_fresh'];
|
|
const fails = needed.filter(k => !checks[k]);
|
|
const summary = { pass: good, expect: EXPECT, case: CASE, switch: SWITCH, listing: LISTING, joint: JOINT, watch: WATCH, node0: dag0, listing_lines_on_node_0: listed, eight_outbound_at_s: eightAt, last, checks, failed_checks: fails, samples, node: IGNEUMD, miner: CPU_MINER, slot: SLOT, ports: { base: BASE, suffix: SUFFIX } };
|
|
mkdirSync(OUT.replace(/\/[^/]+$/, ''), { recursive: true });
|
|
writeFileSync(OUT, JSON.stringify(summary, null, 2));
|
|
log(`SUMMARY ${good ? 'PASS' : 'FAIL'} (${CASE}): node 0 logged ${listed} listings; the fresh node ${eightAt == null ? `never reached 8 outbound (last ${last.outbound})` : `reached 8 outbound at ${eightAt} s`}, ${last.connected_from_directory} connection(s) from the directory, ${last.drawn} draw line(s), ${last.blocks} blocks${fails.length ? `; FAILED CHECK ${fails.join(', ')}` : ''}`);
|
|
log(`summary: ${OUT}`);
|
|
await stopAll();
|
|
process.exit(good ? 0 : 1);
|