Understanding-the-code

Coherence
Search…
Coherence
Home
Overview
In this page we are going to explain/describe the coherence's code, this code is built with the help of:
​argon2​
​cryptopp​
​libntru​
​liboqs​
​libuv​
​rapidjson​
params.h
It defines (with preprocessor) which algorithms are going to supported
It defines info_log structure to store the log data
It defines params structure to help to parse json data and share it with the functions 
coherence.c
In this file is main function. We create a tcp server with libuv, validate the input, create the logs output and send the client's input to be parsed.
main() displays the banner, create the tcp server, starts the event loop and call on_new_connection()
on_new_connection() accepts the clients, calls alloc_buffer() and on_read()
alloc_buffer() creates the buffer to store client's input
on_read() reads data from socket, starts t
if (nread < 0) an error on  reading socket data
if (nread >= 0) data is read, creates log info, validate the buffer with ok_buff(),if the buffer isn't ok close the connection, if the buffer is ok sends the input to PARSING() , writes the answer, parse_log cleans the log structure and prints the log.
Further reading
​libuv - uv_stream​
​libuv sample​
​libuv-dox-examples​
parsing.h
PARSING() parse the json input with Parsingjson() ,and address the algorithm to its functions
parse_log parse the log, basically delete sensitive information like private keys with Clear2json()
Further reading
​rapidjson intro​
parse-func.h
In this file we can find functions to validate inputs from json client input.
crypt-argon2.h
Functions to process argon2 requests
Further reading
​example 
crypt-block.h
Functions to process block cipher requests
Further reading
​example​
​aes example​
crypt-dh.h
Functions to process Diffie-Hellman requests
Further reading
​example​
crypt-dsa.h
Functions to process DSA requests
Further reading
​example​
crypt-ecc.h
Functions to process Elliptic Curves requests
Further reading
​example​
crypt-hash.h
Functions to process HASh requests
Further reading
​example​
crypt-mac.h
Functions to process MAC requests
Further reading
​hmac example​
[cmac example] (https://www.cryptopp.com/wiki/CMAC)
crypt-ntru.h
Functions to process NTRU requests
Further reading
​example​
crypt-oqs.h
Functions to process Post Quantum Algorithms requests
Further reading
​example​
crypt-rand.h
Functions to process Rand numbers generation requests
Further reading
​example​
crypt-rsa.h
Functions to process RSA requests
Further reading
​example​
crypt-stream.h
Functions to process Stream Ciphers requests
Further reading
​example​
Links