Improved documentation

[paixaop]

Improved documentation

[m1sta]

The utility functions in particular, could use some help. These might already exist elsewhere in the module but I found adding these useful...

sodium.api.crypto_box_random_nonce = function (){
    var nonce = new Buffer(sodium.crypto_box_NONCEBYTES);
    sodium.randombytes_buf(nonce);
    return nonce

}

sodium.api.to_hex = function (args) {
    var ret = "";
    for ( var i = 0; i < args.length; i++ )
        ret += (args[i] < 16 ? "0" : "") + args[i].toString(16);
    return ret; //.toUpperCase();
}

sodium.api.from_hex = function (str) {
    if (typeof str == 'string') {
        var ret = new Uint8Array(Math.floor(str.length / 2));
                var i = 0;
        str.replace(/(..)/g, function(str) { ret[i++] = parseInt(str, 16);});
        return ret;
    }
  }

[paixaop]

I will add the to_hex and from_hex. Random nonce is already generated by the nonce classes.

[paixaop]

Added to the Utils as 'api' is reserved to the core lib sodium functions