mtproto

package module
v0.0.0-...-7028a79 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 2, 2021 License: MIT Imports: 28 Imported by: 0

README

MTProto

godoc reference Go Report Card codecov license MIT chat telegram version v0.5.0 unstable

FINALLY! Full-native implementation of MTProto protocol on Golang!

We are hardly working on v1.0-rc relase candidate branch, you can leave a feedback!

english русский

Features

Full native implementation

All code, from sending requests to encryption serialization is written on pure golang. You don't need to fetch any additional dependencies.





Latest API version (117+)

Lib is supports all the API and MTProto features, including video calls and post comments. You can create additional pull request to push api updates!






Reactive API updates (generated from TL schema)

All changes in TDLib and Android client are monitoring to get the latest features and changes in TL schemas. New methods are creates by adding new lines into TL schema and updating generated code!




Implements ONLY network tools

No more SQLite databases and caching unnecessary files, that you don't need. Also you can control how sessions are stored, auth process and literally everything that you need!




Multiaccounting, Gateway mode

You can use more than 10 accounts at same time! xelaj/MTProto doesn't create huge overhead in memory or cpu consumption as TDLib. Thanks for that, you can create huge number of connection instances and don't worry about memory overload!




How to use

MTProto is really hard in implementation, but it's really easy to use. Basically, this lib sends serialized structures to Telegram servers (just like gRPC, but from Telegram LLC.). It looks like this:

func main() {
    client := &Telegram.NewClient()
    // for each method there is specific struct for serialization (<method_name>Params{})
    result, err := client.MakeRequest(&telegram.GetSomeInfoParams{FromChatId: 12345})
    if err != nil {
        panic(err)
    }

    resp, ok := result.(*SomeResponseObject)
    if !ok {
        panic("Oh no! Wrong type!")
    }
}

Not so hard, huh? But there is even easier way to send request, which is included in TL API specification:

func main() {
    client := &Telegram.NewClient()
    resp, err := client.GetSomeInfo(12345)
    if err != nil {
        panic(err)
    }

    // resp will be already asserted as described in TL specs of API
    // if _, ok := resp.(*SomeResponseObject); !ok {
    //     panic("No way, we found a bug! Create new issue!")
    // }

    println(resp.InfoAboutSomething)
}

You do not need to think about encryption, key exchange, saving and restoring session, and more routine things. It is already implemented just for you.

Code examples are here

Full docs are here

Getting started

Simple How-To

Installation is simple. Just do go get:

go get github.com/airani/mtproto

After that you can generate source structures of methods and functions if you wish to. To do it, use go generate

go generate github.com/airani/mtproto

That's it! You don't need to do anything more!

What is InvokeWithLayer?

It's Telegram specific feature. I you want to create client instance and get information about the current servers configuration, you need to do something like this:

    resp, err := client.InvokeWithLayer(apiVersion, &telegram.InitConnectionParams{
        ApiID:          124100,
        DeviceModel:    "Unknown",
        SystemVersion:  "linux/amd64",
        AppVersion:     "0.1.0",
	// just use "en", any other language codes will receive error. See telegram docs for more info.
        SystemLangCode: "en",
        LangCode:       "en",
        // HelpGetConfig() is ACTUAL request, but wrapped in IvokeWithLayer
        Query:          &telegram.HelpGetConfigParams{},
    })

Why? We don't know! This method is described in Telegram API docs, any other starting requests will receive error.

How to use phone authorization?

Example here

func AuthByPhone() {
    resp, err := client.AuthSendCode(
        yourPhone,
        appID,
        appHash,
        &telegram.CodeSettings{},
    )
	if err != nil {
        panic(err)
    }


    // You can make any way to enter verification code, like in
    // http requests, or what you like. You just need to call two
    // requests, that's main method.
	fmt.Print("Auth code:")
	code, _ := bufio.NewReader(os.Stdin).ReadString('\n')
    code = strings.Replace(code, "\n", "", -1)

    // this is ALL process of authorization! :)
    fmt.Println(client.AuthSignIn(yourPhone, resp.PhoneCodeHash, code))
}

That's it! You don't need any cycles, code is ready-to-go for async execution. You just need to follow the official Telegram API documentation.

Docs are empty. Why?

There is a pretty huge chunk of documentation. We are ready to describe every method and object, but its requires a lot of work. Although all methods are already described here.

Does this project support Windows?

Technically — yes. In practice — components don't require specific architecture, but we didn't test it yet. If you have any problems running it, just create an issue, we will try to help.

Who use it

Contributing

Please read contributing guide if you want to help. And the help is very necessary!

TODO

  • Basic MTProto implementation
  • Implement all Methods for latest layer
  • Make TL Encoder/Decoder
  • Get away from panics in parsing TL
  • Support MTProxy
  • Support socks5 as well
  • Multiple tests
  • Write amazing docs

Authors

License

WARNING! This project is only maintained by Xelaj inc., however copyright of this source code IS NOT owned by Xelaj inc. at all. If you want to connect with code owners, write mail to this email. For all other questions like any issues, PRs, questions, etc. Use GitHub issues, or find email on official website.

This project is licensed under the MIT License - see the LICENSE file for details

Documentation

Overview

also why gocritic detects false positive, but if i write explanation, golangci-lint throws error that description expected as lintrer??? //TODO nolint: lll

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func CatchResponseErrorCode 

func CatchResponseErrorCode(data []byte) error

func IsPacketEncrypted 

func IsPacketEncrypted(data []byte) bool

func MessageRequireToAck 

func MessageRequireToAck(msg serialize.TL) bool

func RpcErrorToNative 

func RpcErrorToNative(r *serialize.RpcError) error

func SaveSession 

func SaveSession(s *Session, path string) error

func TryExpandError 

func TryExpandError(errStr string) (nativeErrorName string, additionalData interface{})

Types

type BadMsgError 

type BadMsgError struct {
	*serialize.BadMsgNotification
	Description string
}

func BadMsgErrorFromNative 

func BadMsgErrorFromNative(in *serialize.BadMsgNotification) *BadMsgError

func (*BadMsgError) Error 

func (e *BadMsgError) Error() string

type BadSystemMessageCode 

type BadSystemMessageCode int32
const (
	ErrBadMsgUnknown             BadSystemMessageCode = 0
	ErrBadMsgIdTooLow            BadSystemMessageCode = 16
	ErrBadMsgIdTooHigh           BadSystemMessageCode = 17
	ErrBadMsgIncorrectMsgIdBits  BadSystemMessageCode = 18
	ErrBadMsgWrongContainerMsgId BadSystemMessageCode = 19 // this must never happen
	ErrBadMsgMessageTooOld       BadSystemMessageCode = 20
	ErrBadMsgSeqNoTooLow         BadSystemMessageCode = 32
	ErrBadMsgSeqNoTooHigh        BadSystemMessageCode = 33
	ErrBadMsgSeqNoExpectedEven   BadSystemMessageCode = 34
	ErrBadMsgSeqNoExpectedOdd    BadSystemMessageCode = 35
	ErrBadMsgServerSaltIncorrect BadSystemMessageCode = 48
	ErrBadMsgInvalidContainer    BadSystemMessageCode = 64
)

type Config 

type Config struct {
	AuthKeyFile string
	ServerHost  string
	PublicKey   *rsa.PublicKey
}

type ErrResponseCode 

type ErrResponseCode struct {
	Code           int
	Message        string
	Description    string
	AdditionalInfo interface{} // some errors has additional data like timeout seconds, dc id etc.
}

func (*ErrResponseCode) Error 

func (e *ErrResponseCode) Error() string

type MTProto 

type MTProto struct {

	//! DEPRECATED RecoverFunc используется только до того момента, когда из пакета будут убраны все паники
	RecoverFunc func(i interface{})
	// если задан, то в канал пишутся ошибки
	Warnings chan error
	// contains filtered or unexported fields
}

func NewMTProto 

func NewMTProto(c Config) (*MTProto, error)

func (*MTProto) AddCustomServerRequestHandler 

func (m *MTProto) AddCustomServerRequestHandler(handler customHandlerFunc)

func (*MTProto) CreateConnection 

func (m *MTProto) CreateConnection() error

func (*MTProto) Disconnect 

func (m *MTProto) Disconnect() error

func (*MTProto) GetAuthKey 

func (m *MTProto) GetAuthKey() []byte

получает ключ авторизации

func (*MTProto) GetLastSeqNo 

func (m *MTProto) GetLastSeqNo() int32

Получает lastSeqNo

func (*MTProto) GetServerSalt 

func (m *MTProto) GetServerSalt() int64

получает соль

func (*MTProto) GetSessionID 

func (m *MTProto) GetSessionID() int64

получает текущий идентификатор сессии

func (*MTProto) LoadSession 

func (m *MTProto) LoadSession() (err error)

func (*MTProto) MakeRequest 

func (m *MTProto) MakeRequest(msg serialize.TL) (serialize.TL, error)

func (*MTProto) MakeRequestAsSlice 

func (m *MTProto) MakeRequestAsSlice(msg serialize.TL, as reflect.Type) (serialize.TL, error)

func (*MTProto) Ping 

func (m *MTProto) Ping(pingID int64) (*serialize.Pong, error)

func (*MTProto) ReqDHParams 

func (m *MTProto) ReqDHParams(nonce, serverNonce *serialize.Int128, p, q []byte, publicKeyFingerprint int64, encryptedData []byte) (serialize.ServerDHParams, error)

func (*MTProto) ReqPQ 

func (m *MTProto) ReqPQ(nonce *serialize.Int128) (*serialize.ResPQ, error)

func (*MTProto) SaveSession 

func (m *MTProto) SaveSession() (err error)

func (*MTProto) SetAuthKey 

func (m *MTProto) SetAuthKey(key []byte)

func (*MTProto) SetClientDHParams 

func (m *MTProto) SetClientDHParams(nonce, serverNonce *serialize.Int128, encryptedData []byte) (serialize.SetClientDHParamsAnswer, error)

func (*MTProto) SetDCStorages 

func (m *MTProto) SetDCStorages(in map[int]string)

func (*MTProto) Stop 

func (m *MTProto) Stop() error

Stop останавливает текущее соединение

type PingParams 

type PingParams struct {
	PingID int64
}

func (*PingParams) CRC 

func (_ *PingParams) CRC() uint32

func (*PingParams) DecodeFrom 

func (t *PingParams) DecodeFrom(d *serialize.Decoder)

func (*PingParams) Encode 

func (t *PingParams) Encode() []byte

type ReqDHParamsParams 

type ReqDHParamsParams struct {
	Nonce                *serialize.Int128
	ServerNonce          *serialize.Int128
	P                    []byte
	Q                    []byte
	PublicKeyFingerprint int64
	EncryptedData        []byte
}

func (*ReqDHParamsParams) CRC 

func (_ *ReqDHParamsParams) CRC() uint32

func (*ReqDHParamsParams) DecodeFrom 

func (t *ReqDHParamsParams) DecodeFrom(d *serialize.Decoder)

func (*ReqDHParamsParams) Encode 

func (t *ReqDHParamsParams) Encode() []byte

type ReqPQParams 

type ReqPQParams struct {
	Nonce *serialize.Int128
}

func (*ReqPQParams) CRC 

func (_ *ReqPQParams) CRC() uint32

func (*ReqPQParams) DecodeFrom 

func (t *ReqPQParams) DecodeFrom(d *serialize.Decoder)

func (*ReqPQParams) Encode 

func (t *ReqPQParams) Encode() []byte

type Session 

type Session struct {
	Key      []byte
	Hash     []byte
	Salt     []byte
	Hostname string
}

func LoadSession 

func LoadSession(path string) (*Session, error)

type SetClientDHParamsParams 

type SetClientDHParamsParams struct {
	Nonce         *serialize.Int128
	ServerNonce   *serialize.Int128
	EncryptedData []byte
}

func (*SetClientDHParamsParams) CRC 

func (_ *SetClientDHParamsParams) CRC() uint32

func (*SetClientDHParamsParams) DecodeFrom 

func (t *SetClientDHParamsParams) DecodeFrom(d *serialize.Decoder)

func (*SetClientDHParamsParams) Encode 

func (t *SetClientDHParamsParams) Encode() []byte

Source Files

View all Source files

Directories

Path Synopsis
encoding
tl
examples
auth
get_channel_users
get_chats
get_configs_for_calls
get_saved_contacts
get_self
internal
aes_ige
mtproto/messages
mtproto/objects
init.go нужен для того что бы иметь один единственный инит в пакете, и при этом не заставляет его генерироваться через generate-tl-files
 init.go нужен для того что бы иметь один единственный инит в пакете, и при этом не заставляет его генерироваться через generate-tl-files
internal/srp

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.