td

td

Telegram client implementation in go.

• Security policy
• Support

Status

Work in progress. Only go1.15 is supported and no backward compatibility is provided.

Goal of this project is to implement Telegram client while providing building blocks for the other client or even server implementation without performance bottlenecks.

Features

• Full MTProto 2.0 implementation in go
• Code for Telegram types automatically generated by ./cmd/gotdgen (based on ernado/tl parser)
• Pluggable session storage
• Vendored Telegram public keys that are kept up-to-date
• Testing and fuzzing applied to improve durability

Example

You can see cmd/gotdecho for echo bot example.

Calling MTProto directly

You can use generated tg.Client that allows calling any MTProto methods directly.

client, err := telegram.Dial(dialCtx, telegram.Options{
    Addr:   "149.154.167.40:443",

    // Grab these from https://my.telegram.org/apps.
    // Never share it or hardcode!
    AppID:   appID,
    AppHash: appHash,
})
if err != nil {
    panic(err)
}

// updates.getState#edd4882a
state, err := tg.NewClient(client).UpdatesGetState(ctx, &tg.UpdatesGetStateRequest{})
if err != nil {
    panic(err)
}
// Got state: &{Pts:197 Qts:0 Date:1606855030 Seq:1 UnreadCount:106}

Reference

The MTProto protocol description is hosted by Telegram.

Most important parts for client impelemtations:

• Security guidelines for client software developers

Current implementation does not conform to security guidelines and should be used only as reference or for testing.

Prior art

• Lonami/grammers (Great Telegram client in Rust, many test vectors were used as reference)
• sdidyk/mtproto, cjongseok/mtproto, xelaj/mtproto (MTProto 1.0 in go)

License

MIT License, created by Aleksandr (ernado) Razumov in 2020