@resciencelab/agent-world-network 1.0.0

package/dist/peer-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-db.js","sourceRoot":"","sources":["../src/peer-db.ts"],"names":[],"mappings":"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"}

package/dist/peer-server.d.ts

@@ -0,0 +1,36 @@
+import { P2PMessage, Identity, Endpoint } from "./types";
+export type MessageHandler = (msg: P2PMessage & {
+    verified: boolean;
+}) => void;
+export declare function addWorldMembers(worldId: string, memberIds: string[]): void;
+/** Replace the member set for a world — revokes access for any IDs not in the new list. */
+export declare function setWorldMembers(worldId: string, memberIds: string[]): void;
+export declare function removeWorld(worldId: string): void;
+export declare function isCoMember(agentId: string): boolean;
+export declare function clearWorldMembers(): void;
+interface SelfMeta {
+    agentId?: string;
+    publicKey?: string;
+    alias?: string;
+    version?: string;
+    endpoints?: Endpoint[];
+}
+export interface PeerServerOptions {
+    /** If true, disables startup delays for tests */
+    testMode?: boolean;
+    /** Identity for response signing (optional) */
+    identity?: Identity;
+    /** When set, incoming messages are dispatched to this handler and world co-member check is skipped (used by World Servers) */
+    onMessage?: MessageHandler;
+}
+export declare function setSelfMeta(meta: SelfMeta): void;
+export declare function onMessage(handler: MessageHandler): void;
+export declare function startPeerServer(port?: number, opts?: PeerServerOptions): Promise<void>;
+export declare function stopPeerServer(): Promise<void>;
+/**
+ * Process a raw UDP datagram as a P2PMessage.
+ * Returns true if the message was valid and handled, false otherwise.
+ */
+export declare function handleUdpMessage(data: Buffer, from: string): boolean;
+export {};
+//# sourceMappingURL=peer-server.d.ts.map

package/dist/peer-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-server.d.ts","sourceRoot":"","sources":["../src/peer-server.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AASxD,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,CAAA;AAU9E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAO1E;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,UAAU,QAAQ;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACvB;AAGD,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,8HAA8H;IAC9H,SAAS,CAAC,EAAE,cAAc,CAAA;CAC3B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAGhD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAEvD;AAYD,wBAAsB,eAAe,CAAC,IAAI,GAAE,MAAa,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8KlG;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAqDpE"}

package/dist/peer-server.js

@@ -0,0 +1,319 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addWorldMembers = addWorldMembers;
+exports.setWorldMembers = setWorldMembers;
+exports.removeWorld = removeWorld;
+exports.isCoMember = isCoMember;
+exports.clearWorldMembers = clearWorldMembers;
+exports.setSelfMeta = setSelfMeta;
+exports.onMessage = onMessage;
+exports.startPeerServer = startPeerServer;
+exports.stopPeerServer = stopPeerServer;
+exports.handleUdpMessage = handleUdpMessage;
+/**
+ * P2P peer HTTP server listening on [::]:8099.
+ *
+ * Trust model:
+ *   Layer 1 — Ed25519 signature (universal trust anchor)
+ *   Layer 2 — TOFU: agentId -> publicKey binding
+ *   Layer 3 — World membership: only co-members can exchange messages
+ *
+ * All source IP filtering has been removed. Trust is established at the
+ * application layer via Ed25519 signatures, not at the network layer.
+ */
+const fastify_1 = __importDefault(require("fastify"));
+const identity_1 = require("./identity");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const pkgVersion = require("../package.json").version;
+const PROTOCOL_VERSION = pkgVersion.split(".").slice(0, 2).join(".");
+const peer_db_1 = require("./peer-db");
+const MAX_MESSAGE_AGE_MS = 5 * 60 * 1000; // 5 minutes
+let server = null;
+const _handlers = [];
+let _identity = null;
+// ── World membership allowlist ───────────────────────────────────────────────
+const _worldMembers = new Map();
+function addWorldMembers(worldId, memberIds) {
+    let set = _worldMembers.get(worldId);
+    if (!set) {
+        set = new Set();
+        _worldMembers.set(worldId, set);
+    }
+    for (const id of memberIds)
+        set.add(id);
+}
+/** Replace the member set for a world — revokes access for any IDs not in the new list. */
+function setWorldMembers(worldId, memberIds) {
+    _worldMembers.set(worldId, new Set(memberIds));
+}
+function removeWorld(worldId) {
+    _worldMembers.delete(worldId);
+}
+function isCoMember(agentId) {
+    for (const members of _worldMembers.values()) {
+        if (members.has(agentId))
+            return true;
+    }
+    return false;
+}
+function clearWorldMembers() {
+    _worldMembers.clear();
+}
+let _selfMeta = {};
+function setSelfMeta(meta) {
+    _selfMeta = meta;
+    // If we have agentId but no signing key, we can't sign responses without privateKey
+}
+function onMessage(handler) {
+    _handlers.push(handler);
+}
+function canonical(msg) {
+    return {
+        from: msg.from,
+        publicKey: msg.publicKey,
+        event: msg.event,
+        content: msg.content,
+        timestamp: msg.timestamp,
+    };
+}
+async function startPeerServer(port = 8099, opts) {
+    if (opts?.identity) {
+        _identity = opts.identity;
+    }
+    server = (0, fastify_1.default)({ logger: false });
+    // Preserve raw body string for Content-Digest verification
+    server.decorateRequest("rawBody", "");
+    server.addContentTypeParser("application/json", { parseAs: "string" }, (req, body, done) => {
+        try {
+            ;
+            req.rawBody = body;
+            done(null, JSON.parse(body));
+        }
+        catch (err) {
+            done(err, undefined);
+        }
+    });
+    // Sign all /peer/* JSON responses
+    server.addHook("onSend", async (_req, reply, payload) => {
+        if (!_identity || typeof payload !== "string")
+            return payload;
+        const url = (_req.url ?? "").split("?")[0];
+        if (!url.startsWith("/peer/"))
+            return payload;
+        const ct = reply.getHeader("content-type");
+        if (!ct || !ct.includes("application/json"))
+            return payload;
+        const hdrs = (0, identity_1.signHttpResponse)(_identity, reply.statusCode, payload);
+        for (const [k, v] of Object.entries(hdrs))
+            reply.header(k, v);
+        return payload;
+    });
+    server.get("/peer/ping", async () => ({
+        ok: true,
+        ts: Date.now(),
+        agentId: _selfMeta.agentId ?? _identity?.agentId,
+        publicKey: _selfMeta.publicKey ?? _identity?.publicKey,
+    }));
+    server.post("/peer/message", async (req, reply) => {
+        const raw = req.body;
+        if (!raw?.publicKey || !raw?.from) {
+            return reply.code(400).send({ error: "Missing 'from' or 'publicKey'" });
+        }
+        // Verify X-AgentWorld-* header signature
+        const rawBody = req.rawBody;
+        const authority = req.headers["host"] ?? "localhost";
+        const reqPath = req.url.split("?")[0];
+        const result = (0, identity_1.verifyHttpRequestHeaders)(req.headers, req.method, reqPath, authority, rawBody, raw.publicKey);
+        if (!result.ok)
+            return reply.code(403).send({ error: result.error });
+        const headerFrom = req.headers["x-agentworld-from"];
+        if (headerFrom !== raw.from) {
+            return reply.code(400).send({ error: "X-AgentWorld-From does not match body 'from'" });
+        }
+        const agentId = raw.from;
+        const knownPeer = (0, peer_db_1.getPeer)(agentId);
+        if (!knownPeer?.publicKey && (0, identity_1.agentIdFromPublicKey)(raw.publicKey) !== agentId) {
+            return reply.code(400).send({ error: "agentId does not match publicKey" });
+        }
+        if (raw.timestamp && Math.abs(Date.now() - raw.timestamp) > MAX_MESSAGE_AGE_MS) {
+            return reply.code(400).send({ error: "Message timestamp too old or too far in the future" });
+        }
+        if (!(0, peer_db_1.tofuVerifyAndCache)(agentId, raw.publicKey)) {
+            return reply.code(403).send({
+                error: `Public key mismatch for ${agentId} — possible key rotation, re-add peer`,
+            });
+        }
+        // World co-member check (skip when onMessage handler is set — world servers handle their own auth)
+        if (!opts?.onMessage && !isCoMember(agentId)) {
+            return reply.code(403).send({ error: "Not a world co-member" });
+        }
+        const msg = {
+            from: agentId,
+            publicKey: raw.publicKey,
+            event: raw.event,
+            content: raw.content,
+            timestamp: raw.timestamp,
+            signature: raw.signature,
+        };
+        if (msg.event === "leave") {
+            (0, peer_db_1.removePeer)(agentId);
+            console.log(`[p2p] <- leave  from=${agentId} — removed from peer table`);
+            return { ok: true };
+        }
+        console.log(`[p2p] <- verified  from=${agentId}  event=${msg.event}`);
+        _handlers.forEach((h) => h({ ...msg, verified: true }));
+        return { ok: true };
+    });
+    // TODO: transport-level header signing for /peer/key-rotation is deferred —
+    // rotation uses its own dual-signature proof structure (signedByOld + signedByNew)
+    server.post("/peer/key-rotation", async (req, reply) => {
+        const rot = req.body;
+        if (!rot.oldAgentId || !rot.newAgentId ||
+            !rot.oldIdentity?.publicKeyMultibase ||
+            !rot.newIdentity?.publicKeyMultibase ||
+            !rot.proofs?.signedByOld?.signature || !rot.proofs?.signedByNew?.signature) {
+            return reply.code(400).send({ error: "Missing required key rotation fields" });
+        }
+        if (rot.type !== "agentworld-identity-rotation" || rot.version !== PROTOCOL_VERSION) {
+            return reply.code(400).send({ error: `Expected type=agentworld-identity-rotation and version=${PROTOCOL_VERSION}` });
+        }
+        const agentId = rot.oldAgentId;
+        // Only accept key rotation from known peers or co-members
+        if (!(0, peer_db_1.getPeer)(agentId) && !isCoMember(agentId)) {
+            return reply.code(403).send({ error: "Unknown agent — key rotation requires existing relationship" });
+        }
+        let oldPublicKeyB64, newPublicKeyB64;
+        try {
+            oldPublicKeyB64 = multibaseToBase64(rot.oldIdentity.publicKeyMultibase);
+            newPublicKeyB64 = multibaseToBase64(rot.newIdentity.publicKeyMultibase);
+        }
+        catch {
+            return reply.code(400).send({ error: "Invalid publicKeyMultibase encoding" });
+        }
+        const timestamp = rot.timestamp;
+        if ((0, identity_1.agentIdFromPublicKey)(oldPublicKeyB64) !== agentId) {
+            return reply.code(400).send({ error: "agentId does not match oldPublicKey" });
+        }
+        if (timestamp && Math.abs(Date.now() - timestamp) > MAX_MESSAGE_AGE_MS) {
+            return reply.code(400).send({ error: "Key rotation timestamp too old or too far in the future" });
+        }
+        const signable = {
+            agentId,
+            oldPublicKey: oldPublicKeyB64,
+            newPublicKey: newPublicKeyB64,
+            timestamp,
+        };
+        if (!(0, identity_1.verifyWithDomainSeparator)(identity_1.DOMAIN_SEPARATORS.KEY_ROTATION, oldPublicKeyB64, signable, rot.proofs.signedByOld.signature)) {
+            return reply.code(403).send({ error: "Invalid signatureByOldKey" });
+        }
+        if (!(0, identity_1.verifyWithDomainSeparator)(identity_1.DOMAIN_SEPARATORS.KEY_ROTATION, newPublicKeyB64, signable, rot.proofs.signedByNew.signature)) {
+            return reply.code(403).send({ error: "Invalid signatureByNewKey" });
+        }
+        // TOFU: clean rotation only — key-loss recovery requires manual re-pairing
+        const knownPeer = (0, peer_db_1.getPeer)(agentId);
+        if (knownPeer?.publicKey && knownPeer.publicKey !== oldPublicKeyB64) {
+            return reply.code(403).send({ error: "TOFU binding mismatch — key-loss recovery requires manual re-pairing" });
+        }
+        (0, peer_db_1.tofuReplaceKey)(agentId, newPublicKeyB64);
+        console.log(`[p2p] key-rotation  agentId=${agentId}  newKey=${newPublicKeyB64.slice(0, 16)}...`);
+        return { ok: true };
+    });
+    await server.listen({ port, host: "::" });
+    console.log(`[p2p] Peer server listening on [::]:${port}`);
+}
+async function stopPeerServer() {
+    if (server) {
+        await server.close();
+        server = null;
+    }
+    _identity = null;
+}
+/**
+ * Process a raw UDP datagram as a P2PMessage.
+ * Returns true if the message was valid and handled, false otherwise.
+ */
+function handleUdpMessage(data, from) {
+    let raw;
+    try {
+        raw = JSON.parse(data.toString("utf-8"));
+    }
+    catch {
+        return false;
+    }
+    if (!raw || !raw.from || !raw.publicKey || !raw.event || !raw.signature) {
+        return false;
+    }
+    const knownPeer = (0, peer_db_1.getPeer)(raw.from);
+    if (!knownPeer?.publicKey && (0, identity_1.agentIdFromPublicKey)(raw.publicKey) !== raw.from) {
+        return false;
+    }
+    if (raw.timestamp && Math.abs(Date.now() - raw.timestamp) > MAX_MESSAGE_AGE_MS) {
+        return false;
+    }
+    const { signature, ...signable } = raw;
+    if (!(0, identity_1.verifyWithDomainSeparator)(identity_1.DOMAIN_SEPARATORS.MESSAGE, raw.publicKey, signable, signature)) {
+        return false;
+    }
+    if (!(0, peer_db_1.tofuVerifyAndCache)(raw.from, raw.publicKey)) {
+        return false;
+    }
+    // World co-member check
+    if (!isCoMember(raw.from)) {
+        return false;
+    }
+    const msg = {
+        from: raw.from,
+        publicKey: raw.publicKey,
+        event: raw.event,
+        content: raw.content,
+        timestamp: raw.timestamp,
+        signature: raw.signature,
+    };
+    if (msg.event === "leave") {
+        (0, peer_db_1.removePeer)(raw.from);
+        console.log(`[p2p] <- leave (UDP) from=${raw.from}`);
+        return true;
+    }
+    console.log(`[p2p] <- verified (UDP) from=${raw.from}  event=${msg.event}`);
+    _handlers.forEach((h) => h({ ...msg, verified: true }));
+    return true;
+}
+// ── Key rotation helpers ─────────────────────────────────────────────────────
+const BASE58_ALPHABET_KR = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58Decode(str) {
+    const bytes = [0];
+    for (const char of str) {
+        let carry = BASE58_ALPHABET_KR.indexOf(char);
+        if (carry < 0)
+            throw new Error(`Invalid base58 char: ${char}`);
+        for (let j = 0; j < bytes.length; j++) {
+            carry += bytes[j] * 58;
+            bytes[j] = carry & 0xff;
+            carry >>= 8;
+        }
+        while (carry > 0) {
+            bytes.push(carry & 0xff);
+            carry >>= 8;
+        }
+    }
+    for (const char of str) {
+        if (char === "1")
+            bytes.push(0);
+        else
+            break;
+    }
+    return new Uint8Array(bytes.reverse());
+}
+/** Convert a multibase (z<base58btc>) Ed25519 public key to base64. */
+function multibaseToBase64(multibase) {
+    if (!multibase.startsWith("z"))
+        throw new Error("Unsupported multibase prefix");
+    const bytes = base58Decode(multibase.slice(1));
+    // Strip 2-byte multicodec prefix (0xed 0x01 for Ed25519 public keys)
+    const keyBytes = bytes.length === 34 ? bytes.slice(2) : bytes;
+    return Buffer.from(keyBytes).toString("base64");
+}
+//# sourceMappingURL=peer-server.js.map

package/dist/peer-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-server.js","sourceRoot":"","sources":["../src/peer-server.ts"],"names":[],"mappings":"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"}

package/dist/transport-quic.d.ts

@@ -0,0 +1,32 @@
+import { Transport, TransportId, TransportEndpoint } from "./transport";
+import { Identity } from "./types";
+/** Check if Node.js native QUIC is available (node:quic, Node 24+). */
+declare function isNativeQuicAvailable(): boolean;
+export declare class UDPTransport implements Transport {
+    readonly id: TransportId;
+    private _address;
+    private _port;
+    private _active;
+    private _socket;
+    private _handlers;
+    private _publicEndpoint;
+    private _useNativeQuic;
+    get address(): string;
+    get publicEndpoint(): {
+        address: string;
+        port: number;
+    } | null;
+    start(identity: Identity, opts?: Record<string, unknown>): Promise<boolean>;
+    stop(): Promise<void>;
+    isActive(): boolean;
+    send(target: string, data: Buffer): Promise<void>;
+    onMessage(handler: (from: string, data: Buffer) => void): void;
+    getEndpoint(): TransportEndpoint;
+}
+/** Parse a host:port or [host]:port string. */
+declare function parseHostPort(addr: string): {
+    host: string;
+    port: number;
+};
+export { parseHostPort, isNativeQuicAvailable };
+//# sourceMappingURL=transport-quic.d.ts.map

package/dist/transport-quic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-quic.d.ts","sourceRoot":"","sources":["../src/transport-quic.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAElC,uEAAuE;AACvE,iBAAS,qBAAqB,IAAI,OAAO,CAOxC;AAED,qBAAa,YAAa,YAAW,SAAS;IAC5C,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,cAAc,CAAiB;IAEvC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,cAAc;iBAPkB,MAAM;cAAQ,MAAM;aASvD;IAEK,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAmE3E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,QAAQ,IAAI,OAAO;IAIb,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevD,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9D,WAAW,IAAI,iBAAiB;CASjC;AAED,+CAA+C;AAC/C,iBAAS,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAenE;AAED,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/transport-quic.js

@@ -0,0 +1,195 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UDPTransport = void 0;
+exports.parseHostPort = parseHostPort;
+exports.isNativeQuicAvailable = isNativeQuicAvailable;
+/**
+ * UDP transport backend — optional fast transport alongside the primary HTTP/TCP layer.
+ *
+ * IMPORTANT: This is a plain UDP datagram transport, NOT a real QUIC
+ * implementation. It provides:
+ *   - Unencrypted, unreliable UDP delivery (no retransmission, no ordering)
+ *   - Messages >MTU (~1400 bytes) may be silently dropped
+ *
+ * The advertised public endpoint is determined by explicit configuration
+ * (ADVERTISE_ADDRESS / ADVERTISE_PORT env vars or plugin config), not by
+ * automatic NIC scanning or STUN. This is intentional: in the world-scoped
+ * architecture, reachable addresses are a deployment concern.
+ *
+ * Security relies entirely on the application-layer Ed25519 signatures.
+ * When Node.js native QUIC (node:quic, Node 24+) becomes stable, this
+ * transport should be upgraded to use it for transport-layer encryption.
+ */
+const dgram = __importStar(require("node:dgram"));
+/** Check if Node.js native QUIC is available (node:quic, Node 24+). */
+function isNativeQuicAvailable() {
+    try {
+        require("node:quic");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+class UDPTransport {
+    id = "quic";
+    _address = "";
+    _port = 0;
+    _active = false;
+    _socket = null;
+    _handlers = [];
+    _publicEndpoint = null;
+    _useNativeQuic = false;
+    get address() {
+        return this._address;
+    }
+    get publicEndpoint() {
+        return this._publicEndpoint;
+    }
+    async start(identity, opts) {
+        const port = opts?.quicPort ?? 8098;
+        const testMode = opts?.testMode ?? false;
+        const advertiseAddress = opts?.advertiseAddress ?? process.env.ADVERTISE_ADDRESS;
+        const advertisePort = opts?.advertisePort
+            ?? (process.env.ADVERTISE_PORT ? parseInt(process.env.ADVERTISE_PORT, 10) : undefined);
+        if (!testMode && !advertiseAddress) {
+            console.warn("[transport:quic] Disabled: no advertised public endpoint configured (set ADVERTISE_ADDRESS / advertise_address)");
+            return false;
+        }
+        // Check for native QUIC support first
+        this._useNativeQuic = isNativeQuicAvailable();
+        if (this._useNativeQuic) {
+            console.log("[transport:quic] Native QUIC available (node:quic)");
+        }
+        try {
+            // Create UDP socket for QUIC transport
+            this._socket = dgram.createSocket("udp6");
+            await new Promise((resolve, reject) => {
+                this._socket.on("error", reject);
+                this._socket.bind(port, "::", () => {
+                    this._socket.removeListener("error", reject);
+                    resolve();
+                });
+            });
+            const actualPort = this._socket.address().port;
+            this._port = actualPort;
+            // Set up message handler
+            this._socket.on("message", (msg, rinfo) => {
+                const from = rinfo.address.includes(":") ? `[${rinfo.address}]:${rinfo.port}` : `${rinfo.address}:${rinfo.port}`;
+                for (const h of this._handlers) {
+                    h(from, msg);
+                }
+            });
+            // Use explicit advertise address if configured
+            if (!testMode && advertiseAddress) {
+                const effPort = advertisePort ?? actualPort;
+                const isIpv6 = advertiseAddress.includes(":") && !advertiseAddress.includes(".");
+                this._address = isIpv6 ? `[${advertiseAddress}]:${effPort}` : `${advertiseAddress}:${effPort}`;
+                this._publicEndpoint = { address: advertiseAddress, port: effPort };
+                console.log(`[transport:quic] Advertised endpoint: ${this._address}`);
+            }
+            // Tests can run without a public endpoint; production cannot.
+            if (!this._address) {
+                this._address = `[::1]:${actualPort}`;
+                if (!testMode) {
+                    console.log(`[transport:quic] Local endpoint: ${this._address} (set ADVERTISE_ADDRESS for public reachability)`);
+                }
+            }
+            this._active = true;
+            console.log(`[transport:quic] Listening on UDP port ${actualPort}`);
+            return true;
+        }
+        catch (err) {
+            console.warn(`[transport:quic] Failed to start: ${err?.message}`);
+            return false;
+        }
+    }
+    async stop() {
+        this._active = false;
+        if (this._socket) {
+            this._socket.close();
+            this._socket = null;
+        }
+    }
+    isActive() {
+        return this._active;
+    }
+    async send(target, data) {
+        if (!this._socket || !this._active) {
+            throw new Error("QUIC transport not active");
+        }
+        const { host, port } = parseHostPort(target);
+        return new Promise((resolve, reject) => {
+            this._socket.send(data, 0, data.length, port, host, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    onMessage(handler) {
+        this._handlers.push(handler);
+    }
+    getEndpoint() {
+        return {
+            transport: "quic",
+            address: this._publicEndpoint?.address ?? this._address,
+            port: this._publicEndpoint?.port ?? this._port,
+            priority: 0,
+            ttl: 3600,
+        };
+    }
+}
+exports.UDPTransport = UDPTransport;
+/** Parse a host:port or [host]:port string. */
+function parseHostPort(addr) {
+    // [ipv6]:port format
+    const bracketMatch = addr.match(/^\[([^\]]+)\]:(\d+)$/);
+    if (bracketMatch) {
+        return { host: bracketMatch[1], port: parseInt(bracketMatch[2], 10) };
+    }
+    // host:port (IPv4 or hostname)
+    const lastColon = addr.lastIndexOf(":");
+    if (lastColon > 0) {
+        return {
+            host: addr.slice(0, lastColon),
+            port: parseInt(addr.slice(lastColon + 1), 10),
+        };
+    }
+    throw new Error(`Invalid address format: ${addr}`);
+}
+//# sourceMappingURL=transport-quic.js.map

package/dist/transport-quic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-quic.js","sourceRoot":"","sources":["../src/transport-quic.ts"],"names":[],"mappings":"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"}