qdremrand.h

Go to the documentation of this file.

/* qdremrand.h - Quantum Dice remote randomness */
 
#include <openssl/ssl.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
/* ******************************************************************
 *  Section 1: This is the C interface. See next section for the C++ interface
 */ 
 
typedef struct {
    SSL_CTX *ctx;       
    SSL *ssl;           
    unsigned rqrand;    
    unsigned pendrand;  
    int sentversion;    
    int verbose;        
} QDREMRAND;
 
// The version of the library
extern const char qdremrand_version[];
 
void qdremrand(QDREMRAND *qdr);
 
int qdremrand_verbose(QDREMRAND *qdr, int verbose);
 
int qdremrand_connect(QDREMRAND *qdr, const char *rem_host, const char *rem_port, const char *peer_cert_file, const char *my_chain_file, const char *my_key_file);
 
 
ssize_t qdremrand_getrand(QDREMRAND *qdr, unsigned char *randbuf, size_t randlen);
 
struct qdrandom {
        unsigned rawbits;       // number of bits acquired from physical process to generate this block
        float entropy;          // estimated quantum entropy in acquired bits
        unsigned char data[8];          // conditioned random data
};
 
ssize_t qdremrand_getrand_ce(QDREMRAND *qdr, struct qdrandom *randbuf, size_t randlen);
 
void qdremrand_dtor(QDREMRAND *qdr);
 
#ifdef __cplusplus
}   // end of extern "C
 
/* ******************************************************************
 *  Section 2: The C++ interface. 
 *  The methods are equivalent to the C functions in section 1
 */ 
 
class Qdremrand {
public:
    Qdremrand() {
        qdremrand(&qdr_);
    }
    int connect(const char *rem_host, const char *rem_port, const char *peer_cert_file, const char *my_chain_file, const char *my_key_file) {
        if (qdr_.ctx) return 1; // already connected
        int ret = qdremrand_connect(&qdr_, rem_host, rem_port, peer_cert_file, my_chain_file, my_key_file);
        if (ret) {
            qdremrand_dtor(&qdr_);
        }
        return ret;
    }
    ssize_t getrand(unsigned char *randbuf, size_t randlen) {
        if (!qdr_.ctx) return -1;   // not connected
        return qdremrand_getrand(&qdr_, randbuf, randlen);
    }
    ~Qdremrand() {
        if (qdr_.ctx) qdremrand_dtor(&qdr_);
    }
private:
    QDREMRAND qdr_;
};
 
#endif