Module authentication 

MTProto authentication key generation (DH handshake steps).

Structs

DhParamsForRetry

Pre-processed server DH parameters retained so that step 3 can be repeated on dh_gen_retry without having to re-decrypt the server response.

Finished

The final output of a successful auth key handshake.

Step1

State after step 1.

Step2

State after step 2.

Step3

State after step 3.

Enums

Error

Errors that can occur during auth key generation.

FinishResult

Result of finish either the handshake is done, or the server wants us to retry step 3 with the auth_key_aux_hash as retry_id.

Functions

finish

Finalise the handshake.

key_for_fingerprint

RSA key by server fingerprint. Includes both production and test DC keys.

retry_step3

Re-run the client DH params generation after a dh_gen_retry response. Feed the dh_params, nonce, server_nonce, new_nonce from FinishResult::Retry and the retry_id (= auth_key_aux_hash).

step1

Generate a req_pq_multi request. Returns the request + opaque state.

step2

Process ResPQ and generate req_DH_params.

step3

Process ServerDhParams into a reusable DhParamsForRetry + send the first set_client_DH_params request.

step2_temp

Like step2 but requests a temporary auth key (PFS). Uses p_q_inner_data_temp_dc instead of p_q_inner_data_dc. Caller must bind the resulting key via auth.bindTempAuthKey before any RPCs.