Package: github.com/gotd/td/session/tdesktop

package tdesktop Import Path github.com/gotd/td/session/tdesktop (on go.dev) Dependency Relation imports 21 packages, and imported by one package

Involved Source Files constant.go dbi.go errors.go file.go key_data.go local_key.go md5.go mtp_authorization.go mtp_config.go mtp_dcoptions.go d tdesktop.go Package tdesktop contains Telegram Desktop session decoder.

Package-Level Type Names (total 10, in which 7 are exported)

/* sort exporteds by: alphabet | popularity */

type Account (struct) Account is a Telegram user account representation in Telegram Desktop storage. Fields (total 3, all are exported) Authorization MTPAuthorization Authorization contains Telegram user and MTProto sessions. Config MTPConfig Config contains Telegram config. IDx uint32 IDx is an internal Telegram Desktop account ID. As Outputs Of (at least 2, both are exported) func Read(root string, passcode []byte) ([]Account, error) func ReadFS(root fs.FS, passcode []byte) ([]Account, error) As Inputs Of (at least one exported) func github.com/gotd/td/session.TDesktopSession(account Account) (*session.Data, error)

type MTPAuthorization (struct) MTPAuthorization is a Telegram Desktop storage structure which stores MTProto session info. See https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/main/main_account.cpp#L359. Fields (total 3, all are exported) Keys map[int]crypto.Key Key is a map of keys per DC ID. // DC ID -> Key MainDC int MainDC is a main DC ID of this user. UserID uint64 UserID is a Telegram user ID. Methods (only one, which is unexported) /* one unexported ... *//* one unexported: */ (*MTPAuthorization) deserialize(r *qtReader) error As Outputs Of (at least one unexported) /* at least one unexported ... *//* at least one unexported: */ func readMTPData(tgf *tdesktopFile, localKey crypto.Key) (MTPAuthorization, error)

type MTPConfig (struct) MTPConfig is a Telegram Desktop storage structure which stores MTProto config info. See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/mtproto/mtproto_config.h. Fields (total 32, all are exported) BlockedMode bool // default: false CallConnectTimeoutMs int32 // default: 30000 CallPacketTimeoutMs int32 // default: 10000 CallReceiveTimeoutMs int32 // default: 20000 CallRingTimeoutMs int32 // default: 90000 CaptionLengthMax int32 // default: 1024 ChannelsReadMediaPeriod int32 // default: 86400 * 7 ChatSizeMax int32 // default: 200 DCOptions MTPDCOptions EditTimeLimit int32 // default: 172800 Environment MTPConfigEnvironment ForwardedCountMax int32 // default: 100 InternalLinksDomain string // default: "https://t.me/" MegagroupSizeMax int32 // default: 10000 NotifyCloudDelay int32 // default: 30000 NotifyDefaultDelay int32 // default: 1500 OfflineBlurTimeout int32 // default: 5000 OfflineIdleTimeout int32 // default: 30000 OnlineCloudTimeout int32 // default: 300000 OnlineFocusTimeout int32 // default: 1000 OnlineUpdatePeriod int32 // default: 120000 PhoneCallsEnabled bool // default: true PinnedDialogsCountMax int32 // default: 5 PinnedDialogsInFolderMax int32 // default: 100 RevokePrivateInbox bool // default: false RevokePrivateTimeLimit int32 // default: 172800 RevokeTimeLimit int32 // default: 172800 SavedGifsLimit int32 // default: 200 StickersFavedLimit int32 // default: 5 StickersRecentLimit int32 // default: 30 TxtDomainString string // default: "" WebFileDCID int32 // default: 4 Methods (only one, which is unexported) /* one unexported ... *//* one unexported: */ (*MTPConfig) deserialize(r *qtReader) error As Outputs Of (at least one unexported) /* at least one unexported ... *//* at least one unexported: */ func readMTPConfig(tgf *tdesktopFile, localKey crypto.Key) (MTPConfig, error) As Inputs Of (at least one unexported) /* at least one unexported ... *//* at least one unexported: */ func github.com/gotd/td/session.mapConfig(mainDC int, cfg MTPConfig) session.Config

type MTPConfigEnvironment int32 (basic type) MTPConfigEnvironment is enum of config environment. Methods (total 3, in which 2 are exported) ( MTPConfigEnvironment) String() string String implements fmt.Stringer. ( MTPConfigEnvironment) Test() bool Test denotes that environment is test. /* one unexported ... *//* one unexported: */ ( MTPConfigEnvironment) valid() bool Implements (at least 3, in which 1 is exported) MTPConfigEnvironment : fmt.Stringer /* 2+ unexporteds ... *//* 2+ unexporteds: */ MTPConfigEnvironment : context.stringer MTPConfigEnvironment : runtime.stringer

type MTPDCOption (struct) MTPDCOption is a Telegram Desktop storage structure which stores DC info. See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/mtproto/mtproto_dc_options.h. Fields (total 5, all are exported) Flags bin.Fields ID int32 IP string Port int32 Secret []byte Methods (total 6, in which 5 are exported) ( MTPDCOption) CDN() bool CDN denotes that this is a CDN DC. ( MTPDCOption) IPv6() bool IPv6 denotes that the specified IP is an IPv6 address. ( MTPDCOption) MediaOnly() bool MediaOnly denotes that this DC should only be used to download or upload files. ( MTPDCOption) Static() bool Static denotes that this IP should be used when connecting through a proxy. ( MTPDCOption) TCPOOnly() bool TCPOOnly denotes that this DC only supports connection with transport obfuscation. /* one unexported ... *//* one unexported: */ (*MTPDCOption) deserialize(r *qtReader, version int32) error

type MTPDCOptions (struct) MTPDCOptions is a Telegram Desktop storage structure which stores DCs info. See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/mtproto/mtproto_dc_options.cpp#L479. Fields (only one, which is exported) Options []MTPDCOption Methods (only one, which is unexported) /* one unexported ... *//* one unexported: */ (*MTPDCOptions) deserialize(r *qtReader) error

type WrongMagicError (struct) WrongMagicError is returned when tdesktop data file has wrong magic header. Fields (only one, which is exported) Magic [4]byte Methods (only one, which is exported) (*WrongMagicError) Error() string Error implements error. Implements (at least one exported) *WrongMagicError : error

/* 3 unexporteds ... *//* 3 unexporteds: */

type keyData (struct) Fields (total 2, neither is exported) /* 2 unexporteds ... *//* 2 unexporteds: */ accountsIDx []uint32 localKey crypto.Key As Outputs Of (at least one unexported) /* at least one unexported ... *//* at least one unexported: */ func readKeyData(tgf *tdesktopFile, passcode []byte) (_ keyData, rErr error)

type qtReader (struct) Fields (only one, which is unexported) /* one unexported ... *//* one unexported: */ buf bin.Buffer Methods (total 8, none are exported) /* 8 unexporteds ... *//* 8 unexporteds: */ (*qtReader) consumeN(target []byte, n int) error (*qtReader) readBytes() ([]byte, error) (*qtReader) readInt32() (int32, error) (*qtReader) readString() (string, error) (*qtReader) readUint32() (uint32, error) (*qtReader) readUint64() (uint64, error) (*qtReader) skip(n int) error (*qtReader) subArray() (qtReader, error) As Inputs Of (at least 5, none are exported) /* 5+ unexporteds ... *//* 5+ unexporteds: */ func readKey(r *qtReader, k *crypto.Key) (uint32, error) func (*MTPAuthorization).deserialize(r *qtReader) error func (*MTPConfig).deserialize(r *qtReader) error func (*MTPDCOption).deserialize(r *qtReader, version int32) error func (*MTPDCOptions).deserialize(r *qtReader) error

type tdesktopFile (struct) Fields (total 3, none are exported) /* 3 unexporteds ... *//* 3 unexporteds: */ data []byte n int version uint32 Methods (only one, which is unexported) /* one unexported ... *//* one unexported: */ (*tdesktopFile) readArray() ([]byte, error) As Outputs Of (at least 2, neither is exported) /* 2+ unexporteds ... *//* 2+ unexporteds: */ func fromFile(r io.Reader) (*tdesktopFile, error) func open(filesystem fs.FS, fileName string) (*tdesktopFile, error) As Inputs Of (at least 3, none are exported) /* 3+ unexporteds ... *//* 3+ unexporteds: */ func readKeyData(tgf *tdesktopFile, passcode []byte) (_ keyData, rErr error) func readMTPConfig(tgf *tdesktopFile, localKey crypto.Key) (MTPConfig, error) func readMTPData(tgf *tdesktopFile, localKey crypto.Key) (MTPAuthorization, error)

Package-Level Functions (total 18, in which 2 are exported)

func Read(root string, passcode []byte) ([]Account, error) Read reads accounts info from given Telegram Desktop tdata root. Shorthand for: ReadFS(os.DirFS(root), passcode)

func ReadFS(root fs.FS, passcode []byte) ([]Account, error) ReadFS reads Telegram Desktop accounts info from given FS root.

/* 16 unexporteds ... *//* 16 unexporteds: */

func createLegacyLocalKey(passcode, salt []byte) (r crypto.Key) See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/storage/details/storage_file_utilities.cpp#L322.

func createLocalKey(passcode, salt []byte) (r crypto.Key) See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/storage/details/storage_file_utilities.cpp#L300.

func decryptLocal(encrypted []byte, localKey crypto.Key) ([]byte, error) See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/storage/details/storage_file_utilities.cpp#L584.

func encryptLocal(decrypted []byte, localKey crypto.Key) ([]byte, error) encryptLocal code may panic

func fileKey(s string) string

func fromFile(r io.Reader) (*tdesktopFile, error) fromFile creates new Telegram Desktop storage file. Based on https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/storage/details/storage_file_utilities.cpp#L473.

func open(filesystem fs.FS, fileName string) (*tdesktopFile, error)

func readArray(data []byte, order binary.ByteOrder) (array []byte, n int, _ error)

func readKey(r *qtReader, k *crypto.Key) (uint32, error)

func readKeyData(tgf *tdesktopFile, passcode []byte) (_ keyData, rErr error) See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/storage/storage_domain.cpp#L119-L159.

func readMTPConfig(tgf *tdesktopFile, localKey crypto.Key) (MTPConfig, error) See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/storage/storage_account.cpp#L938.

func readMTPData(tgf *tdesktopFile, localKey crypto.Key) (MTPAuthorization, error) See https://github.com/telegramdesktop/tdesktop/blob/v2.9.8/Telegram/SourceFiles/storage/storage_account.cpp#L898.

func tdesktopMD5(s string) string

func telegramFileHash(data []byte, version [4]byte) (r [16]byte)

func writeArray(writer io.Writer, data []byte, order binary.ByteOrder) error

func writeFile(w io.Writer, data []byte, version [4]byte) error

Package-Level Variables (total 3, in which 2 are exported)

var ErrKeyInfoDecrypt error ErrKeyInfoDecrypt is returned when key data decrypt fails. It can happen if passed passcode is wrong.

var ErrNoAccounts error ErrNoAccounts reports that decoded tdata does not contain any accounts info.

/* one unexported ... *//* one unexported: */

var tdesktopFileMagic [4]byte

Package-Level Constants (total 78, none are exported) /* 78 unexporteds ... *//* 78 unexporteds: */

const dbiAdaptiveForWide = 56

const dbiAskDownloadPath = 20

const dbiAuthSessionSettings = 77

const dbiAutoDownload = 52

const dbiAutoLock = 34

const dbiAutoPlay = 55

const dbiAutoStart = 6

const dbiAutoUpdate = 12

const dbiCatsAndDogs = 18

const dbiChatSizeMax = 3

const dbiCompressPastedImage = 30

const dbiConnectionType = 79

const dbiConnectionTypeOld = 15

const dbiDcOptionOld = 39

const dbiDcOptionOldOld = 2

const dbiDcOptions = 74

const dbiDefaultAttach = 17 0x10 reserved

const dbiDesktopNotify = 11

const dbiDialogLastPath = 35

const dbiDialogsMode = 64

const dbiDialogsWidthRatioOld = 72

const dbiDownloadPath = 51

const dbiDownloadPathOld = 21

const dbiEmojiTabOld = 23

const dbiEmojiVariants = 59

const dbiEmojiVariantsOld = 37

const dbiEncrypted = 444

const dbiEncryptedWithSalt = 333

const dbiHiddenPinnedMessages = 57

const dbiIncludeMuted = 49

const dbiKey = 0

const dbiLangFileOld = 32

const dbiLangOld = 31

const dbiLangPackKey = 78

const dbiLastSeenWarningSeenOld = 76

const dbiLastUpdateCheck = 13

const dbiLoggedPhoneNumber = 25

const dbiMegagroupSizeMax = 50

const dbiModerateMode = 65

const dbiMtpAuthorization = 75

const dbiMutedPeers = 26

const dbiMutePeer = 4

const dbiNativeNotifications = 68

const dbiNotificationsCorner = 70

const dbiNotificationsCount = 69

const dbiNotifyView = 28 0x1b reserved

const dbiRecentEmoji = 58

const dbiRecentEmojiOld = 36

const dbiRecentEmojiOldOld = 24

const dbiRecentStickers = 38

const dbiReplaceEmojis = 19

const dbiSavedGifsLimit = 53

const dbiScale = 22

const dbiSeenTrayTooltip = 10

const dbiSendKey = 5

const dbiSendToMenu = 29

const dbiShowingSavedGifsOld = 54

const dbiSongVolume = 41

const dbiSoundNotify = 8

const dbiStartMinimized = 7

const dbiStickersFavedLimit = 80

const dbiStickersRecentLimit = 67

const dbiSuggestStickersByEmoji = 81

const dbiThemeKey = 71

const dbiTileBackground = 33

const dbiTryIPv6 = 40

const dbiUseExternalVideoPlayer = 73

const dbiUser = 1

const dbiVideoVolume = 66

const dbiWindowPosition = 14

const dbiWindowsNotificationsOld = 48

const dbiWorkMode = 9

const kStrongIterationsCount = 100000

const kVersion = 1

const kWideIdsTag uint64 = 18446744073709551615

const localEncryptIterCount = 4000 // key derivation iteration count

const localEncryptNoPwdIterCount = 4 // key derivation iteration count without pwd (not secure anyway)

const localEncryptSaltSize = 32 // 256 bit