Merge branch '9.0RC'9.0

1 files changed, 45 insertions, 0 deletions

diff --git a/library/sodium-plus/docs/SodiumPlus/utilities.md b/library/sodium-plus/docs/SodiumPlus/utilities.md
new file mode 100644
index 000000000..43d493b88
--- /dev/null
+++ b/library/sodium-plus/docs/SodiumPlus/utilities.md
@@ -0,0 +1,45 @@
+## Utilities
+
+### sodium_bin2hex
+
+Encode data into a hexadecimal string.
+
+**Parameters and their respective types**:
+
+1. `{string|Buffer}` non-hex-encoded input
+
+Returns a `Promise` that resolves to a `string`.
+
+```javascript
+const { SodiumPlus } = require('sodium-plus');
+let sodium;
+
+(async function () {
+    if (!sodium) sodium = await SodiumPlus.auto();
+    let buf = await sodium.randombytes_buf(32);
+
+    console.log(await sodium.sodium_bin2hex(buf));
+})();
+```
+
+### sodium_hex2bin
+
+Decode data from a hexadecimal string to a `Buffer`.
+
+**Parameters and their respective types**:
+
+1. `{string|Buffer}` hex-encoded input
+
+Returns a `Promise` that resolves to a `Buffer`.
+
+```javascript
+const { SodiumPlus } = require('sodium-plus');
+let sodium;
+
+(async function () {
+    if (!sodium) sodium = await SodiumPlus.auto();
+    let hex = '491d40c4924ba547d6f0bda9da77a539391decdc';
+
+    console.log(await sodium.sodium_hex2bin(hex));
+})();
+```