@erfan_bahramali/tping 1.0.0 → 1.1.0

package/README.md

@@ -1,18 +1,20 @@
-# 🏓 tping
+# 🏓 TPing
 
-**Ping for Telegram Proxies** - Test connectivity to Telegram Proxies, just like `ping` for IP addresses.
+**Ping for Telegram Proxies.** It checks Telegram proxies the way `ping` checks IP addresses.
 
-A simple and clean CLI tool to continuously ping Telegram proxies (MTProto and SOCKS5) and measure latency in real-time using official Telegram API.
+TPing connects through the proxy exactly like the official Telegram apps (Android and Desktop) and only reports success when a Telegram datacenter actually answers. If TPing says a proxy works, Telegram can use it. If it fails, the error says where it broke.
 
 ---
 
 ## ✨ Features
 
-- 🏓 **Continuous ping mode** - Like standard `ping` command
-- 🔄 **Multiple proxies** - Ping simultaneously
-- ⚙️ **Configurable** - Custom count and interval
-- 📊 **Statistics** - min/avg/max latency, packet loss
-- 🚀 **Simple & clean** - Easy to use
+- 🔐 **Every official proxy type**: MTProto with simple, `dd`, and Fake TLS (`ee`) secrets, SOCKS5 with or without login, HTTP (Telegram Desktop), and the new WEB proxy (all four carrier modes)
+- 🤝 **Real handshake**: a `req_pq_multi` request goes through the proxy to the Telegram datacenter and must come back with our nonce
+- 🌐 **Datacenter selection**: test DC 2 (default), any set of DCs, or all five
+- 🏓 **Continuous mode** like `ping`, with count and interval
+- 🔄 **Many proxies at once**: from arguments, a file, or stdin
+- 📊 **Statistics**: loss, min/avg/max/mdev, last error
+- 🔍 **Clear errors**, for example: wrong secret, timeout during the Fake TLS handshake, SOCKS5 authentication failed
 
 ---
 
@@ -22,7 +24,7 @@ A simple and clean CLI tool to continuously ping Telegram proxies (MTProto and S
 npm install -g @erfan_bahramali/tping
 ```
 
-Or use directly with npx:
+Or use it directly with npx:
 
 ```bash
 npx @erfan_bahramali/tping <proxy>
@@ -32,27 +34,23 @@ npx @erfan_bahramali/tping <proxy>
 
 ## 🚀 Usage
 
-You can pass proxy as text or file path. For multiple proxies, separate by newlines (in text or file).
-
 ```bash
 # Single proxy
-tping "https://t.me/proxy?server=proxy.example.com&port=443&secret=0123456789abcdef"
+tping "https://t.me/proxy?server=proxy.example.com&port=443&secret=ee0123456789abcdef0123456789abcdef7777772e676f6f676c652e636f6d"
 
-# Multiple proxies
-tping "https://t.me/proxy?server=proxy1.com&port=443&secret=abc
-https://t.me/socks?server=proxy2.com&port=1080"
+# Several proxies (arguments, newlines, or spaces)
+tping "tg://proxy?server=a.example.com&port=443&secret=dd0123456789abcdef0123456789abcdef" \
+      "https://t.me/socks?server=b.example.com&port=1080&user=me&pass=secret"
 
-# From file (single or multiple proxies)
+# From a file, or from stdin
 tping proxies.txt
+cat proxies.txt | tping -
 
-# Ping 5 times
-tping -c 5 "https://t.me/socks?server=proxy.example.com&port=1080"
-
-# Ping unlimited times with custom interval (500ms)
-tping -i 500 "https://t.me/socks?server=proxy.example.com&port=1080"
+# 5 pings, 500ms apart, through all five Telegram datacenters
+tping -c 5 -i 500 --dc all proxies.txt
 
-# Ping 10 times with custom interval (500ms)
-tping -c 10 -i 500 proxies.txt
+# Show how long each phase took
+tping -V -c 3 proxies.txt
 ```
 
 ---
@@ -63,56 +61,79 @@ tping -c 10 -i 500 proxies.txt
 |--------|-------------|
 | `-c, --count <n>` | Number of pings to send (default: unlimited) |
 | `-i, --interval <ms>` | Interval between pings in milliseconds (default: 1000) |
-| `-t, --timeout <ms>` | Timeout for each ping in milliseconds (default: 10000) |
+| `-t, --timeout <ms>` | Timeout for one ping (connect + handshake + reply) in milliseconds (default: 10000) |
+| `-d, --dc <ids>` | Telegram DC(s) to test: `1`–`5`, comma-separated, or `all` (default: 2) |
+| `-6, --ipv6` | Use IPv6 datacenter addresses for SOCKS5/HTTP proxies |
+| `-V, --verbose` | Show the time of each phase: TCP connect, proxy handshake, Telegram round trip |
 | `-v, --version` | Show version number |
 | `-h, --help` | Show help |
 
+**Exit status:** `0` if every proxy answered at least once, `1` if any proxy never answered, `2` on invalid input.
+
+---
+
+## 🔗 Supported proxy formats
+
+| Type | Formats |
+|------|---------|
+| MTProto | `https://t.me/proxy?server=…&port=…&secret=…`, also `telegram.me`, `telegram.dog`, `www.`, `http://`, no scheme, `tg://proxy?…`, `tg:proxy?…` |
+| SOCKS5 | `https://t.me/socks?server=…&port=…&user=…&pass=…`, `tg://socks?…`, `socks5://user:pass@host:port` |
+| HTTP | `http://user:pass@host:port` (HTTP proxies are only supported by Telegram Desktop) |
+| WEB | `https://t.me/webproxy?server=host[/path]&secret=…`, `tg://webproxy?…` (always HTTPS on port 443) |
+
+MTProto secrets may be hex or base64/base64url, like in the official apps:
+
+| Secret | Mode | What TPing does |
+|--------|------|-----------------|
+| 16 bytes | simple | obfuscated intermediate transport |
+| `dd` + 16 bytes | secure | obfuscated padded intermediate transport |
+| `ee` + 16 bytes + domain | Fake TLS | TLS-looking handshake with the domain as SNI, then padded intermediate inside TLS records |
+
+WEB proxy secrets are 16 bytes or `dd` + 16 bytes (no Fake TLS). A link whose server has a base path (`host%2Fpath`) carries the secret in its marked form (`0x70` + secret, base64url), as the official installer generates it.
+
+Shell-escaped links (`t.me/proxy\?server\=…`) are accepted. Invalid lines are reported and skipped.
+
 ---
 
 ## 📊 Example Output
 
 ```
-🏓 PING proxy.example.com:443 (MTProto)
-Sending pings with 1000ms interval... (Press Ctrl+C to stop)
-
-✓ proxy.example.com:443 │ MTProto │ seq=1 │ 45ms
-✓ proxy.example.com:443 │ MTProto │ seq=2 │ 48ms
-✓ proxy.example.com:443 │ MTProto │ seq=3 │ 43ms
-^C
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📊 Statistics for proxy.example.com:443
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Packets: 3 sent │ 3 received │ 0% loss
-Latency: 43ms min │ 45ms avg │ 48ms max
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ #1 │ [1] proxy.example.com:443   │ MTProto · Fake TLS   │ 182ms
+❌ #1 │ [2] 203.0.113.7:8443        │ MTProto · dd         │ Proxy closed the connection before Telegram answered (wrong secret, or the proxy cannot reach Telegram)
+✅ #1 │ [3] socks.example.com:1080  │ SOCKS5               │ 95ms
 ```
 
+Press Ctrl+C to stop and print the statistics table. Press it twice to quit immediately.
+
 ---
 
-## 🔍 How it Works
+## 🔍 How it works
+
+TPing builds the same connection as the official apps:
+
+1. **Fake TLS (`ee`)**: sends a Chrome-like TLS ClientHello (shuffled extensions, GREASE, a valid x25519 key share, padded to 517 bytes). The client random is an HMAC-SHA256 of the hello with the secret, with the current time mixed in. The proxy's reply must be exactly ServerHello + ChangeCipherSpec + one Application Data record carrying a valid HMAC. A wrong secret, or the real website answering instead of the proxy, is detected here.
+2. **Transport obfuscation**: a random 64-byte header carries the protocol tag and the DC id, encrypted with AES-256-CTR keys derived from the secret ([MTProto transport obfuscation](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation)).
+3. **MTProto ping**: a `req_pq_multi` request is sent and a `resPQ` with the same nonce must come back from the Telegram datacenter.
+
+For **WEB proxies** ([tproxy-server](https://github.com/telegramdesktop/tproxy-server)), TPing does what the Telegram app and its bridge page do together. It derives the bridge capability (HMAC-SHA256 of the hostname, and base path if any, keyed with the secret) and loads `https://host/?bridge=…` with full certificate checks. It then creates a relay session (HELLO → WELCOME) and opens one stream per tested DC, carrying the normal obfuscated MTProxy bytes until the DC answers. All four carrier modes the relay can choose are supported: `https`, `https-lanes`, `websocket` and `websocket-lanes`. The session is deleted afterwards so it does not take up a slot on the relay. The official apps skip WEB proxies in their availability checks; TPing tests them for real.
+
+For SOCKS5 and HTTP proxies, TPing opens a tunnel to the Telegram datacenter's IP and runs the same obfuscated MTProto handshake through it. For HTTP proxies that refuse `CONNECT`, it falls back to the HTTP transport, as Telegram Desktop does.
 
-tping performs a **real MTProto handshake** through the proxy — the same first
-step every official Telegram client does:
+The reported latency covers the whole sequence, TCP connect + proxy handshake + Telegram round trip, which is the same thing the official apps show as a proxy's ping. With several DCs, the slowest DC is reported and each DC is listed.
 
-1. **Transport obfuscation** — a 64-byte header is generated with AES-256-CTR
-   keys derived from the proxy secret (per the official
-   [MTProto transport obfuscation](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation)).
-2. **Fake TLS** (secrets with `ee` prefix) — a TLS 1.3 ClientHello with a valid
-   HMAC digest is sent; the proxy's signed ServerHello is verified before any
-   data is trusted. Wrong secrets are detected immediately.
-3. **MTProto ping** — a `req_pq_multi` request is sent through the proxy to the
-   Telegram datacenter. The measured latency is the round trip of receiving a
-   valid `resPQ` reply with our echoed nonce. A proxy only passes if the
-   datacenter actually answers — dead or fake proxies are reported as failures,
-   never as successes.
+---
 
-SOCKS5 proxies are checked by negotiating a connection to a Telegram datacenter
-through them.
+## 🧪 Development
+
+```bash
+bun install
+bun test          # unit tests + end-to-end tests against local mock servers (MTProxy, Fake TLS, SOCKS5, HTTP, WEB relay)
+bun run build
+TPING_LIVE_PROXY="https://t.me/proxy?server=…&port=…&secret=…" bun test   # also test a real proxy
+```
 
 ---
 
 ## 📋 License
 
 MIT © 2026 [ErfanBahramali](https://github.com/ErfanBahramali)
-
----

package/dist/crypto/x25519.d.ts

@@ -0,0 +1,10 @@
+export declare const isQuadraticResidue: (value: bigint) => boolean;
+export declare const bufferToBigInt: (buffer: Buffer) => bigint;
+/**
+ * Generate a public key that is a valid x25519 point, as Telegram clients do
+ * for the fake TLS key_share extension (a random 32-byte string would be an
+ * easy DPI fingerprint, since half of them are not on the curve).
+ */
+export declare const generateX25519PublicKey: () => Buffer;
+export declare const isOnCurve: (key: Buffer) => boolean;
+//# sourceMappingURL=x25519.d.ts.map

package/dist/crypto/x25519.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x25519.d.ts","sourceRoot":"","sources":["../../src/crypto/x25519.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,OACE,CAAC;AAStD,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAsD,CAAC;AAEvG;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAO,MAa1C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,OAAgE,CAAC"}

package/dist/crypto/x25519.js

@@ -0,0 +1,51 @@
+import { randomBytes } from 'crypto';
+const P = (1n << 255n) - 19n;
+const A = 486662n;
+const mod = (value) => {
+    const result = value % P;
+    return result < 0n ? result + P : result;
+};
+const modPow = (base, exponent) => {
+    let result = 1n;
+    let b = mod(base);
+    let e = exponent;
+    while (e > 0n) {
+        if (e & 1n) {
+            result = (result * b) % P;
+        }
+        b = (b * b) % P;
+        e >>= 1n;
+    }
+    return result;
+};
+/** y^2 = x^3 + A*x^2 + x on Curve25519. */
+const curveY2 = (x) => mod(((x + A) * x + 1n) * x);
+export const isQuadraticResidue = (value) => value === 0n || modPow(value, (P - 1n) / 2n) === 1n;
+/** x-coordinate of 2*point (Montgomery doubling). */
+const doubleX = (x) => {
+    const numerator = mod(x * x - 1n);
+    const denominator = mod(4n * curveY2(x));
+    return mod(numerator * numerator * modPow(denominator, P - 2n));
+};
+export const bufferToBigInt = (buffer) => BigInt(`0x${buffer.toString('hex') || '0'}`);
+/**
+ * Generate a public key that is a valid x25519 point, as Telegram clients do
+ * for the fake TLS key_share extension (a random 32-byte string would be an
+ * easy DPI fingerprint, since half of them are not on the curve).
+ */
+export const generateX25519PublicKey = () => {
+    for (;;) {
+        const candidate = randomBytes(32);
+        candidate[31] &= 0x7f;
+        let x = mod(bufferToBigInt(candidate));
+        if (!isQuadraticResidue(curveY2(x))) {
+            continue;
+        }
+        for (let i = 0; i < 3; i++) {
+            x = doubleX(x);
+        }
+        return Buffer.from(x.toString(16).padStart(64, '0'), 'hex');
+    }
+};
+export const isOnCurve = (key) => isQuadraticResidue(curveY2(mod(bufferToBigInt(key))));
+//# sourceMappingURL=x25519.js.map

package/dist/crypto/x25519.js.map

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

package/dist/index.js

@@ -1,66 +1,109 @@
 #!/usr/bin/env node
+import { createRequire } from 'module';
 import chalk from 'chalk';
-import { program } from 'commander';
+import { InvalidArgumentError, Option, program } from 'commander';
 import { parseProxies } from './lib/parser.js';
-import { pingProxy } from './lib/ping.js';
+import { pingProxies } from './lib/ping.js';
+import { DC_IDS, DEFAULT_DC } from './lib/datacenters.js';
+import { waitForWebProxyCleanup } from './webproxy/check.js';
+const { version } = createRequire(import.meta.url)('../package.json');
+const integer = (name, min) => (value) => {
+    const number = Number(value);
+    if (!/^\d+$/.test(value.trim()) || !Number.isSafeInteger(number) || number < min) {
+        throw new InvalidArgumentError(`${name} must be an integer >= ${min}.`);
+    }
+    return number;
+};
+const parseDcs = (value) => {
+    if (value.trim().toLowerCase() === 'all') {
+        return [...DC_IDS];
+    }
+    const ids = value.split(',').map((part) => Number(part.trim()));
+    if (ids.length === 0 || ids.some((id) => !DC_IDS.includes(id))) {
+        throw new InvalidArgumentError(`DC must be "all" or a comma-separated list of ${DC_IDS.join(', ')}.`);
+    }
+    return [...new Set(ids)];
+};
 program
     .name('tping')
     .description('Ping for Telegram Proxies')
-    .version('1.0.0', '-v, --version')
-    .argument('[proxy]', 'Proxy URL or file path (supports MTProto, SOCKS5)')
-    .option('-c, --count <n>', 'Number of pings to send (default: unlimited)', parseInt)
-    .option('-i, --interval <ms>', 'Interval between pings in milliseconds (default: 1000)', parseInt)
-    .option('-t, --timeout <ms>', 'Timeout for each ping in milliseconds (default: 10000)', parseInt)
+    .version(version, '-v, --version')
+    .argument('[proxies...]', 'Proxy links, file paths, or "-" for stdin')
+    .option('-c, --count <n>', 'Number of pings to send (default: unlimited)', integer('count', 1))
+    .option('-i, --interval <ms>', 'Interval between pings in milliseconds', integer('interval', 0), 1000)
+    .option('-t, --timeout <ms>', 'Timeout for each ping (connect + handshake + reply) in milliseconds', integer('timeout', 100), 10000)
+    .addOption(new Option('-d, --dc <ids>', 'Telegram DC(s) to test through the proxy: 1-5, comma-separated, or "all"')
+    .argParser(parseDcs)
+    .default([DEFAULT_DC], String(DEFAULT_DC)))
+    .option('-6, --ipv6', 'Use IPv6 DC addresses for SOCKS5/HTTP proxies', false)
+    .option('-V, --verbose', 'Show the time spent in each phase (tcp, handshake, rtt)', false)
     .showHelpAfterError('(add --help for additional information)')
     .addHelpText('after', `
 Supported proxy formats:
-  MTProto:  "https://t.me/proxy?server=...&port=...&secret=..."
-  MTProto:  "tg://proxy?server=...&port=...&secret=..."
-  SOCKS5:   "https://t.me/socks?server=...&port=...&user=...&pass=..."
-  SOCKS5:   "tg://socks?server=...&port=...&user=...&pass=..."
+  MTProto:  https://t.me/proxy?server=...&port=...&secret=...   (also tg://proxy?...)
+            secret: 32 hex (simple), dd + 32 hex (secure), ee + 32 hex + domain hex (Fake TLS),
+            or the same bytes in base64 / base64url
+  SOCKS5:   https://t.me/socks?server=...&port=...&user=...&pass=...   (also tg://socks?...)
+            socks5://user:pass@host:port
+  HTTP:     http://user:pass@host:port   (Telegram Desktop only)
+  WEB:      https://t.me/webproxy?server=host[/path]&secret=...   (also tg://webproxy?...)
+            HTTPS on port 443 through a tproxy-server relay; secret: 32 hex or dd + 32 hex
+
+A ping succeeds only when a Telegram datacenter answers through the proxy.
+Exit status: 0 if every proxy answered at least once, 1 otherwise, 2 on bad input.
 
 Examples:
-  $ tping "https://t.me/proxy?server=proxy.example.com&port=443&secret=0123456789abcdef"
+  $ tping "https://t.me/proxy?server=proxy.example.com&port=443&secret=0123456789abcdef0123456789abcdef"
   $ tping -c 5 "https://t.me/socks?server=proxy.example.com&port=1080"
-  $ tping -c 10 -i 500 "tg://socks?server=proxy.example.com&port=1080&user=admin&pass=secret"
-  $ tping proxies.txt
+  $ tping -c 10 -i 500 --dc all proxies.txt
+  $ cat proxies.txt | tping -c 1 -
 `)
-    .action(async (proxyInput, options) => {
-    if (!proxyInput) {
+    .action(async (inputs, options) => {
+    if (inputs.length === 0) {
         program.help();
     }
-    // Parse proxies
-    const proxies = parseProxies(proxyInput);
+    const parsed = inputs.map(parseProxies);
+    const proxies = parsed.flatMap((p) => p.proxies);
+    const issues = parsed.flatMap((p) => p.issues);
+    for (const issue of issues) {
+        const shown = issue.input.length > 60 ? `${issue.input.slice(0, 57)}...` : issue.input;
+        console.error(chalk.yellow(`⚠️  Skipped "${shown}": ${issue.reason}`));
+    }
     if (proxies.length === 0) {
-        console.log(chalk.red('Error: Invalid proxy format'));
-        process.exit(1);
+        console.error(chalk.red('Error: no valid proxy found (pass a proxy link or a file path)'));
+        process.exit(2);
     }
-    options.interval = options.interval || 1000;
-    options.timeout = options.timeout || 10000;
-    // Print header
     console.log();
     console.log(chalk.bold.cyan('🏓 TPing'));
     console.log(chalk.gray('━'.repeat(50)));
-    console.log(chalk.cyan(`📡 Proxies: ${chalk.white(proxies.length)}`));
-    console.log(chalk.cyan(`🎯 Count: ${chalk.white(options.count || 'unlimited')}`));
-    console.log(chalk.cyan(`⏰ Interval: ${chalk.white(options.interval + 'ms')}`));
-    console.log(chalk.cyan(`⏳ Timeout: ${chalk.white(options.timeout + 'ms')}`));
+    console.log(chalk.cyan(`📡 Proxies:  ${chalk.white(proxies.length)}`));
+    console.log(chalk.cyan(`🎯 Count:    ${chalk.white(options.count ?? 'unlimited')}`));
+    console.log(chalk.cyan(`⏰ Interval: ${chalk.white(`${options.interval}ms`)}`));
+    console.log(chalk.cyan(`⏳ Timeout:  ${chalk.white(`${options.timeout}ms`)}`));
+    console.log(chalk.cyan(`🌐 DC:       ${chalk.white(options.dc.join(', '))}`));
     console.log(chalk.gray('━'.repeat(50)));
     console.log();
-    // Setup abort controller for Ctrl+C
     const abortController = new AbortController();
-    let isAborting = false;
-    const handleAbort = async () => {
-        if (isAborting) {
-            return;
+    const handleSignal = () => {
+        if (abortController.signal.aborted) {
+            process.exit(130);
         }
-        isAborting = true;
         abortController.abort();
-        console.log(chalk.yellow('\n⏸️  Stopping... (Press Ctrl+C again to force quit)'));
+        process.stderr.write(chalk.yellow('\n⏸️  Stopping... (press Ctrl+C again to force quit)\n'));
     };
-    process.on('SIGINT', handleAbort);
-    process.on('SIGTERM', handleAbort);
-    await pingProxy(proxies, options, abortController.signal);
-    process.exit(0);
-}).parse();
+    process.on('SIGINT', handleSignal);
+    process.on('SIGTERM', handleSignal);
+    const results = await pingProxies(proxies, {
+        count: options.count,
+        interval: options.interval,
+        timeout: options.timeout,
+        dcs: options.dc,
+        ipv6: options.ipv6,
+        verbose: options.verbose,
+    }, abortController.signal);
+    const allAnswered = results.every((list) => list.some((r) => r.success));
+    await waitForWebProxyCleanup();
+    process.exit(allAnswered ? 0 : 1);
+});
+await program.parseAsync();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/attempt.d.ts

@@ -0,0 +1,31 @@
+import type { Socket } from 'net';
+import { SocketStream } from '../net/stream.js';
+export declare class TimeoutError extends Error {
+    constructor();
+}
+export declare class AbortedError extends Error {
+    constructor();
+}
+export declare const STAGE_CONNECTING = "connecting to proxy";
+export declare const STAGE_WAITING = "waiting for Telegram";
+/**
+ * One check: a deadline and an abort signal shared by every connection it opens,
+ * plus the current phase for error messages.
+ */
+export declare class Attempt {
+    private readonly signal?;
+    stage: string;
+    private readonly streams;
+    private primary?;
+    private failure?;
+    private readonly timer;
+    private readonly onAbort;
+    constructor(deadline: number, signal?: AbortSignal | undefined);
+    /** The default TCP stream, created on first use. */
+    get stream(): SocketStream;
+    newStream(socket?: Socket, readyEvent?: string): SocketStream;
+    close(): void;
+    private failAll;
+}
+export declare const describeError: (err: unknown, stage: string) => string;
+//# sourceMappingURL=attempt.d.ts.map

package/dist/lib/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../src/lib/attempt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,YAAY,EAAqB,MAAM,kBAAkB,CAAC;AAEnE,qBAAa,YAAa,SAAQ,KAAK;;CAKtC;AAED,qBAAa,YAAa,SAAQ,KAAK;;CAKtC;AAED,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AACtD,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAEpD;;;GAGG;AACH,qBAAa,OAAO;IAQY,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAPtD,KAAK,SAAoB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;gBAE5D,QAAQ,EAAE,MAAM,EAAmB,MAAM,CAAC,EAAE,WAAW,YAAA;IAQnE,oDAAoD;IACpD,IAAI,MAAM,IAAI,YAAY,CAGzB;IAED,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY;IAS7D,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,OAAO;CAIhB;AAeD,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,EAAE,OAAO,MAAM,KAAG,MAuB3D,CAAC"}

package/dist/lib/attempt.js

@@ -0,0 +1,94 @@
+import { SocketStream, StreamClosedError } from '../net/stream.js';
+export class TimeoutError extends Error {
+    constructor() {
+        super('Timeout');
+        this.name = 'TimeoutError';
+    }
+}
+export class AbortedError extends Error {
+    constructor() {
+        super('Aborted');
+        this.name = 'AbortedError';
+    }
+}
+export const STAGE_CONNECTING = 'connecting to proxy';
+export const STAGE_WAITING = 'waiting for Telegram';
+/**
+ * One check: a deadline and an abort signal shared by every connection it opens,
+ * plus the current phase for error messages.
+ */
+export class Attempt {
+    signal;
+    stage = STAGE_CONNECTING;
+    streams = new Set();
+    primary;
+    failure;
+    timer;
+    onAbort = () => this.failAll(new AbortedError());
+    constructor(deadline, signal) {
+        this.signal = signal;
+        this.timer = setTimeout(() => this.failAll(new TimeoutError()), Math.max(0, deadline - Date.now()));
+        if (signal?.aborted) {
+            this.onAbort();
+        }
+        signal?.addEventListener('abort', this.onAbort, { once: true });
+    }
+    /** The default TCP stream, created on first use. */
+    get stream() {
+        this.primary ??= this.newStream();
+        return this.primary;
+    }
+    newStream(socket, readyEvent) {
+        const stream = new SocketStream(socket, readyEvent);
+        if (this.failure) {
+            stream.fail(this.failure);
+        }
+        this.streams.add(stream);
+        return stream;
+    }
+    close() {
+        clearTimeout(this.timer);
+        this.signal?.removeEventListener('abort', this.onAbort);
+        this.streams.forEach((stream) => stream.destroy());
+    }
+    failAll(err) {
+        this.failure ??= err;
+        this.streams.forEach((stream) => stream.fail(err));
+    }
+}
+const NETWORK_ERRORS = {
+    ECONNREFUSED: 'Connection refused',
+    ENOTFOUND: 'DNS lookup failed (unknown host)',
+    EAI_AGAIN: 'DNS lookup failed (temporary)',
+    EHOSTUNREACH: 'Host unreachable',
+    ENETUNREACH: 'Network unreachable',
+    ETIMEDOUT: 'Connection timed out',
+    EPIPE: 'Connection broken',
+};
+const CERTIFICATE_ERROR = /CERT|SELF_SIGNED|ALTNAME|UNABLE_TO_(GET|VERIFY)/;
+const TLS_HANDSHAKE_ERROR = /^ERR_(SSL|TLS)_/;
+export const describeError = (err, stage) => {
+    if (err instanceof TimeoutError) {
+        return `Timeout while ${stage}`;
+    }
+    if (err instanceof StreamClosedError) {
+        return stage === STAGE_WAITING
+            ? 'Proxy closed the connection before Telegram answered (wrong secret, or the proxy cannot reach Telegram)'
+            : `Connection closed while ${stage}`;
+    }
+    const code = err?.code;
+    if (code === 'ECONNRESET') {
+        return `Connection reset while ${stage}`;
+    }
+    if (code && NETWORK_ERRORS[code]) {
+        return NETWORK_ERRORS[code];
+    }
+    if (code && CERTIFICATE_ERROR.test(code)) {
+        return `TLS certificate error (${code})`;
+    }
+    if (code && TLS_HANDSHAKE_ERROR.test(code)) {
+        return `TLS handshake failed, not a normal HTTPS server (${code})`;
+    }
+    return err instanceof Error ? err.message : String(err);
+};
+//# sourceMappingURL=attempt.js.map

package/dist/lib/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../../src/lib/attempt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;QACE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;QACE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAEpD;;;GAGG;AACH,MAAM,OAAO,OAAO;IAQ6B;IAP/C,KAAK,GAAG,gBAAgB,CAAC;IACR,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAC;IAC3C,OAAO,CAAgB;IACvB,OAAO,CAAS;IACP,KAAK,CAAiB;IACtB,OAAO,GAAG,GAAS,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;IAExE,YAAY,QAAgB,EAAmB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;QACjE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpG,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,oDAAoD;IACpD,IAAI,MAAM;QACR,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,MAAe,EAAE,UAAmB;QAC5C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IAEO,OAAO,CAAC,GAAU;QACxB,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,cAAc,GAAqC;IACvD,YAAY,EAAE,oBAAoB;IAClC,SAAS,EAAE,kCAAkC;IAC7C,SAAS,EAAE,+BAA+B;IAC1C,YAAY,EAAE,kBAAkB;IAChC,WAAW,EAAE,qBAAqB;IAClC,SAAS,EAAE,sBAAsB;IACjC,KAAK,EAAE,mBAAmB;CAC3B,CAAC;AAEF,MAAM,iBAAiB,GAAG,iDAAiD,CAAC;AAC5E,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAY,EAAE,KAAa,EAAU,EAAE;IACnE,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;QAChC,OAAO,iBAAiB,KAAK,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;QACrC,OAAO,KAAK,KAAK,aAAa;YAC5B,CAAC,CAAC,yGAAyG;YAC3G,CAAC,CAAC,2BAA2B,KAAK,EAAE,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,GAAI,GAAyC,EAAE,IAAI,CAAC;IAC9D,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,OAAO,0BAA0B,KAAK,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,0BAA0B,IAAI,GAAG,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,oDAAoD,IAAI,GAAG,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/lib/checker.d.ts

@@ -1,6 +1,24 @@
-import type { TelegramProxy, CheckResult } from '../types/index.js';
+import type { CheckResult, TelegramProxy } from '../types/index.js';
+import { type DcAddress } from './datacenters.js';
+export interface CheckOptions {
+    /** Deadline for one whole check (connect + handshake + round trip), per DC. */
+    readonly timeout: number;
+    readonly dcs?: readonly number[];
+    /** Use IPv6 DC addresses for SOCKS5/HTTP proxies. */
+    readonly ipv6?: boolean;
+    readonly signal?: AbortSignal;
+    /** Override DC addresses (tests). */
+    readonly resolveDc?: (dc: number, transport: 'tcp' | 'http') => DcAddress;
+    /** Override where a WEB proxy hostname connects, and trusted CA (tests). */
+    readonly webProxyEndpoint?: {
+        readonly host: string;
+        readonly port: number;
+        readonly ca?: Buffer;
+    };
+}
 /**
- * Ping any proxy type.
+ * Check one proxy the way the official clients use it: open a real connection,
+ * do the proxy handshake, and get a resPQ back from each requested Telegram DC.
  */
-export declare const checkProxy: (proxy: TelegramProxy, timeout?: number) => Promise<CheckResult>;
+export declare const checkProxy: (proxy: TelegramProxy, options: CheckOptions) => Promise<CheckResult>;
 //# sourceMappingURL=checker.d.ts.map

package/dist/lib/checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../src/lib/checker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0EpE;;GAEG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,aAAa,EACpB,UAAS,MAAc,KACtB,OAAO,CAAC,WAAW,CAQrB,CAAC"}
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../src/lib/checker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAKX,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAY3B,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC;IAC1E,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpG;AAgID;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAU,OAAO,aAAa,EAAE,SAAS,YAAY,KAAG,OAAO,CAAC,WAAW,CA+BjG,CAAC"}