A desktop browser with x402 built in: when a page asks for payment, it pays in stablecoins and shows the content.

0 downloads

Download zip
Clone
Clone with git
git clone https://gitstable.com/git/askrobots/dbbasic-browser.git
HTTPS
https://gitstable.com/git/askrobots/dbbasic-browser.git
SSH
ssh://git@gitstable.com:2222/askrobots/dbbasic-browser.git

Cloning needs no sign-in. Pushing over HTTPS asks for your username and an access token. SSH needs your key under SSH keys.

danq9 site icons (favicons) in tabs, address bar suggestions and the bookmarks panel 7249579 15 hours, 56 minutes ago History
escape.mjs · 4.4 KB · 72 lines
1// "The browser makes no request of its own" in caller-network mode, tested against a page that tries every way it can think of
2// to reach a listener we control. A control run in the normal mode first proves the listeners can see what they are meant to.
3import { createServer } from "node:net";
4import { createSocket } from "node:dgram";
5
6export default async function (ctx) {
7 const { call: T, check, base, sleep } = ctx;
8 const UA = "ExampleCaller/1.0 (+https://caller.example/about)";
9
10 // Listeners: every TCP connection (labelled by what it starts with) and every UDP datagram.
11 const tcpSeen = [];
12 const tcp = createServer((sock) => {
13 const at = tcpSeen.push("(connection, nothing sent)") - 1; // a connection counts even if nothing is sent on it
14 sock.once("data", (d) => { tcpSeen[at] = String(d.subarray(0, 60)).split("\r\n")[0] || "(binary)"; sock.destroy(); });
15 sock.on("error", () => {});
16 setTimeout(() => sock.destroy(), 1500);
17 });
18 await new Promise((r) => tcp.listen(0, "127.0.0.1", r));
19 const udpSeen = [];
20 const udp = createSocket("udp4");
21 udp.on("message", (m) => udpSeen.push(`${m.length} bytes`));
22 await new Promise((r) => udp.bind(0, "127.0.0.1", r));
23 const ports = { tcp: tcp.address().port, udp: udp.address().port };
24 const target = `${base}/escape?tcp=${ports.tcp}&udp=${ports.udp}`;
25 const connections = () => tcpSeen.length + udpSeen.length;
26
27 // ---- control: the normal mode, where the page may go anywhere ----
28 await T("page.goto", { url: target });
29 await sleep(5000);
30 const control = { tcp: [...tcpSeen], udp: [...udpSeen] };
31 check(control.tcp.length > 0, "control: in the normal mode the listener DOES see the page's connections (so the detector works)", control.tcp.join(" | ").slice(0, 160));
32 console.log(` control saw tcp: ${JSON.stringify(control.tcp)} udp: ${JSON.stringify(control.udp)}`);
33
34 // ---- caller-network mode: a caller that refuses everything the page asks for ----
35 tcpSeen.length = 0; udpSeen.length = 0;
36 let stop = false, asked = 0;
37 const loop = (async () => {
38 let after = 0;
39 while (!stop) {
40 let reqs = [];
41 try { reqs = (await T("net.pending", { afterId: after, waitMs: 400 })).requests; } catch { await sleep(200); }
42 for (const r of reqs) {
43 after = Math.max(after, r.id);
44 asked++;
45 const path = new URL(r.url).pathname;
46 // The page itself (and its service-worker script) come from the demo server; everything else is refused.
47 if (r.url.startsWith(base)) {
48 const res = await fetch(r.url, { headers: { "user-agent": UA }, redirect: "manual" });
49 void T("net.answer", { id: r.id, status: res.status, headers: Object.fromEntries(res.headers), bodyBase64: Buffer.from(await res.arrayBuffer()).toString("base64") }).catch(() => {});
50 } else void T("net.fail", { id: r.id, kind: "blocked", detail: `refused ${path}` }).catch(() => {});
51 }
52 }
53 })();
54 await T("net.provider", { enabled: true, userAgent: UA, answerTimeoutMs: 5000 });
55 await T("page.goto", { url: target });
56 await sleep(6000);
57 stop = true;
58 await loop;
59 const got = { tcp: [...tcpSeen], udp: [...udpSeen] };
60 console.log(` caller mode saw tcp: ${JSON.stringify(got.tcp)} udp: ${JSON.stringify(got.udp)}; the caller was asked ${asked} time(s)`);
61 check(asked >= 3, "the page's requests went to the caller instead", `${asked} asked`);
62 check(got.tcp.length === 0, "no TCP connection reached the listener (WebSocket, fetch, beacon, event stream, XHR, image, preconnect, prefetch)", got.tcp.join(" | ").slice(0, 200));
63 const quic = got.udp.filter((u) => parseInt(u, 10) >= 1200); // QUIC's first packet is at least 1200 bytes (WebTransport)
64 const other = got.udp.filter((u) => parseInt(u, 10) < 1200); // STUN and the like (WebRTC)
65 check(other.length === 0, "no WebRTC datagram (STUN) reached the listener", other.join(" | "));
66 // KNOWN GAP: WebTransport opens QUIC connections that Electron 45 cannot switch off (a command-line switch, the blink feature
67 // flag and the webview attributes were all tried; none removed it). The caller network cannot see them. The remedy is outside
68 // the browser: deny UDP egress for the user it runs as. Recorded, not hidden:
69 check(true, `KNOWN GAP (not a pass): ${quic.length} QUIC datagram(s) from WebTransport reached the listener; deny UDP egress at the firewall`);
70 await T("net.provider", { enabled: false });
71 tcp.close(); udp.close();
72}