ferogram-connect

Raw TCP connection, MTProto framing, and transport layer for ferogram.

Sits between a raw TcpStream and decrypted MTProto messages. The ferogram crate uses this internally; most people never need to depend on it directly. If you're just building a bot or a client, start with ferogram instead.

ferogram re-exports everything here, so existing code needs no changes.

What it does

Takes a TCP connection to a Telegram DC and gives back decrypted, framed MTProto messages.

• Abridged, Intermediate, Padded Intermediate, and Full transport framing
• Obfuscated2 AES-256-CTR transport for bypassing DPI and MTProxy
• FakeTLS transport for 0xee MTProxy secrets
• SOCKS5 proxy with optional username/password (feature: socks5)
• MTProxy (tg://proxy?... and https://t.me/proxy?...) parsing and connection
• Keepalive pings with configurable interval
• gzip inflate and compress for MTProto containers
• MTProto envelope unwrapping and entity extraction

Transports

use ferogram_connect::TransportKind;

// Plain abridged (default)
TransportKind::Abridged

// Obfuscated2: bypasses ISP blocks, works with plain MTProxy secrets
TransportKind::Obfuscated { secret: None }

// Padded Intermediate: required for 0xdd MTProxy secrets
TransportKind::PaddedIntermediate { secret: Some(key) }

// FakeTLS: required for 0xee MTProxy secrets
TransportKind::FakeTls { secret: key, domain: "...".into() }

MTProxy

use ferogram_connect::MtProxyConfig;

// Parse a proxy link directly
let proxy = ferogram::proxy::parse_proxy_link("https://t.me/proxy?server=...&port=443&secret=...")?;

// Or build manually
let proxy = MtProxyConfig {
    host: "proxy.example.com".into(),
    port: 443,
    secret: vec![/* raw bytes */],
    transport: TransportKind::Obfuscated { secret: None },
};

SOCKS5 (feature: socks5)

Pulls in tokio-socks; off by default since it's not needed for direct connections to Telegram datacenters.

use ferogram_connect::Socks5Config;

let socks = Socks5Config::new("127.0.0.1:1080");
let socks_auth = Socks5Config::with_auth("127.0.0.1:1080", "user", "pass");

Feature flags

Stack position

ferogram
└ ferogram-mtsender
  └ ferogram-connect  <-- here
    ├ ferogram-mtproto
    └ ferogram-crypto

License

This project is licensed under either the MIT License or Apache License 2.0, at your option. See LICENSE-MIT and LICENSE-APACHE for details.

Author: Ankit Chaubey (@ankit-chaubey)