wired/complete_8h_source.html

#ifndef SRVFIN_COMPLETE_H

#define SRVFIN_COMPLETE_H


#include "crypto/kdf/keys/keyset.h"

#include "tls/keys/schedule_drive/keyschedule.h"


typedef struct {

  keysched* sched;

  keyset*   keys;

  int       confirmed;

} srvfin_state;


void srvfin_state_init(srvfin_state* s, keysched* sched, keyset* keys);


int srvfin_complete(

    srvfin_state* s, const u8* final_transcript, usz final_transcript_len);


int srvfin_early_send_keys(

    srvfin_state* s, const u8* transcript, usz transcript_len);


#endif

srvfin_complete
int srvfin_complete(srvfin_state *s, const u8 *final_transcript, usz final_transcript_len)
Advance the key schedule to Master over the final transcript (the handshake messages through the clie...

srvfin_early_send_keys
int srvfin_early_send_keys(srvfin_state *s, const u8 *transcript, usz transcript_len)
Derive and install the server's 1-RTT send keys early, before the client Finished arrives (0....

srvfin_state_init
void srvfin_state_init(srvfin_state *s, keysched *sched, keyset *keys)
Bind the key schedule and key set the completion step operates on.

keyschedule.h
RFC 8446 7.1: order-driven key schedule.

keyset.h
RFC 9001 4: per-protection-level key sets.

keysched
Key schedule state: the current stage, the Master Secret once reached, and the four traffic key sets ...
Definition keyschedule.h:30

keyset
Per-protection-level key store: one AES-128-GCM key set per level plus an installed flag.
Definition keyset.h:23

srvfin_state
Server handshake-completion state.
Definition complete.h:14

srvfin_state::sched
keysched * sched
the key schedule to advance to Master
Definition complete.h:15

srvfin_state::keys
keyset * keys
receives the server 1-RTT keys
Definition complete.h:16

srvfin_state::confirmed
int confirmed
1 once the handshake is confirmed
Definition complete.h:17

transcript
Cumulative Transcript-Hash state.
Definition transcript.h:11

usz
u64 usz
unsigned size (size_t equivalent)
Definition types.h:20

u8
unsigned char u8
unsigned 8-bit integer / byte
Definition types.h:18