@eluvio/elv-client-js 3.1.92 → 3.1.95

package/dist/src/Utils.js

@@ -2,13 +2,17 @@ var _toConsumableArray = require("@babel/runtime/helpers/toConsumableArray");
 
 var _regeneratorRuntime = require("@babel/runtime/regenerator");
 
+var _asyncToGenerator = require("@babel/runtime/helpers/asyncToGenerator");
+
 var _defineProperty = require("@babel/runtime/helpers/defineProperty");
 
 var _slicedToArray = require("@babel/runtime/helpers/slicedToArray");
 
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
+var _this = this;
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 
 if (typeof Buffer === "undefined") {
   Buffer = require("buffer/").Buffer;
@@ -22,7 +26,9 @@ var VarInt = require("varint");
 
 var URI = require("urijs");
 
-var keccak256 = require("ethers").utils.keccak256;
+var _require$utils = require("ethers").utils,
+    keccak256 = _require$utils.keccak256,
+    getAddress = _require$utils.getAddress;
 /**
  * @namespace
  * @description This is a utility namespace mostly containing functions for managing
@@ -161,6 +167,145 @@ var Utils = {
     };
   },
 
+  /**
+   * Decode the specified write token into its component parts
+   *
+   * @param writeToken
+   *
+   * @returns {Object} - Components of the write token.
+   */
+  DecodeWriteToken: function DecodeWriteToken(writeToken) {
+    /*
+    Format:
+    - content write token, LRO:
+      - prefix: "tq__", "tqw__", "tlro"
+      - format:
+        prefix + base58(uvarint(len(QID) | QID |
+                        uvarint(len(NID) | NID |
+                        uvarint(len(RAND_BYTES) | RAND_BYTES)
+    - content part write token:
+      - prefix: "tqp_"
+      - format:
+        prefix + base58(scheme | flags | uvarint(len(RAND_BYTES) | RAND_BYTES)
+    - content write token v1, content part write token v1:
+      - prefix: "tqw_", "tqpw"
+      - format:
+        prefix + base58(RAND_BYTES)
+     */
+    if (writeToken.length < 4) {
+      throw new Error("Invalid write token: [\"".concat(writeToken, "\"] (unknown prefix)"));
+    }
+
+    var tokenType;
+
+    if (writeToken.startsWith("tqw__")) {
+      tokenType = "tq__";
+      writeToken = writeToken.slice(5);
+    } else {
+      tokenType = writeToken.slice(0, 4);
+      writeToken = writeToken.slice(4);
+    }
+
+    if (writeToken.length === 0) {
+      throw new Error("Invalid write token: [\"".concat(writeToken, "\"] (too short)"));
+    }
+
+    switch (tokenType) {
+      case "tqw_":
+      case "tq__":
+      case "tqpw":
+      case "tqp_":
+      case "tlro":
+        break;
+
+      default:
+        throw new Error("Invalid write token: [\"".concat(writeToken, "\"] (unknown prefix)"));
+    } // decode base58 payload
+
+
+    var bytes = Utils.FromB58(writeToken);
+
+    function decodeBytes(isID, prefix) {
+      var bsize = VarInt.decode(bytes, 0); // decode: count of bytes to read
+
+      var offset = VarInt.decode.bytes; // offset in buffer to start read after decode
+
+      var theBytes;
+      var ret;
+
+      if (isID) {
+        theBytes = bytes.slice(offset + 1, bsize + offset); // skip 1st byte (code id) at offset 0
+
+        if (theBytes.length === 0) {
+          ret = "";
+        } else {
+          ret = prefix + Utils.B58(theBytes);
+        }
+      } else {
+        theBytes = bytes.slice(offset, bsize + offset);
+        ret = "0x" + theBytes.toString("hex");
+      }
+
+      bytes = bytes.slice(bsize + offset);
+      return ret;
+    }
+
+    var tokenId;
+    var qid;
+    var nid;
+    var scheme;
+    var flags;
+
+    switch (tokenType) {
+      case "tqw_": // content write token v1
+
+      case "tqpw":
+        // content part write token v1
+        tokenId = "0x" + bytes.toString("hex");
+        break;
+
+      case "tlro": // LRO,
+
+      case "tq__":
+        // content write token
+        qid = decodeBytes(true, "iq__");
+        nid = decodeBytes(true, "inod");
+        tokenId = decodeBytes(false, "");
+        break;
+
+      case "tqp_":
+        // content part write token
+        if (bytes.length < 3) {
+          throw new Error("Invalid write token: [\"".concat(writeToken, "\"] (token truncated)"));
+        }
+
+        scheme = bytes[0];
+        flags = bytes[1];
+        bytes = bytes.slice(2);
+        tokenId = decodeBytes(false, "");
+        break;
+
+      default:
+        // already raised
+        throw new Error("Invalid write token: [\"".concat(writeToken, "\"] (unknown prefix)"));
+    }
+
+    return {
+      tokenType: tokenType,
+      // type of token
+      tokenId: tokenId,
+      // random bytes generated by the fabric node
+      objectId: qid,
+      // content id for content write token (tq__) or LRO (tlro)
+      nodeId: nid,
+      // node id where the content write token is valid (tq__)
+      scheme: scheme,
+      // encryption scheme for part write token - (tqp_)
+      flags: flags // flags for part write token (tqp_)
+
+    };
+  },
+
   /**
    * Convert contract address to multiformat hash
    *
@@ -259,6 +404,35 @@ var Utils = {
     return Utils.HashToAddress(firstHash) === Utils.HashToAddress(secondHash);
   },
 
+  /**
+   * Determine whether the address is valid
+   *
+   * @param {string} address - Address to validate
+   *
+   * @returns {boolean} - Whether or not the address is valid
+   */
+  ValidAddress: function ValidAddress(address) {
+    try {
+      getAddress(address);
+      return true;
+    } catch (error) {
+      _this.Log(error);
+
+      return false;
+    }
+  },
+
+  /**
+   * Determine whether the hash is valid
+   *
+   * @param {string} hash - Hash to validate
+   *
+   * @returns {boolean} - Whether or not the hash is valid
+   */
+  ValidHash: function ValidHash(hash) {
+    return Utils.ValidAddress(Utils.HashToAddress(hash));
+  },
+
   /**
    * Convert the specified string to a bytes32 string
    *
@@ -303,203 +477,233 @@ var Utils = {
         signature = _token$split2[1];
 
     info = JSON.parse(Utils.FromB64(info));
-    return _objectSpread({}, info, {
+    return _objectSpread(_objectSpread({}, info), {}, {
       signature: signature
     });
   },
-  LimitedMap: function LimitedMap(limit, array, f) {
-    var index, locked, nextIndex, results, active;
-    return _regeneratorRuntime.async(function LimitedMap$(_context3) {
-      while (1) {
-        switch (_context3.prev = _context3.next) {
-          case 0:
-            index = 0;
-            locked = false;
-
-            nextIndex = function nextIndex() {
-              var thisIndex;
-              return _regeneratorRuntime.async(function nextIndex$(_context) {
-                while (1) {
-                  switch (_context.prev = _context.next) {
-                    case 0:
-                      if (!locked) {
-                        _context.next = 5;
-                        break;
+  LimitedMap: function () {
+    var _LimitedMap = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(limit, array, f) {
+      var index, locked, nextIndex, results, active;
+      return _regeneratorRuntime.wrap(function _callee3$(_context3) {
+        while (1) {
+          switch (_context3.prev = _context3.next) {
+            case 0:
+              index = 0;
+              locked = false;
+
+              nextIndex = /*#__PURE__*/function () {
+                var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+                  var thisIndex;
+                  return _regeneratorRuntime.wrap(function _callee$(_context) {
+                    while (1) {
+                      switch (_context.prev = _context.next) {
+                        case 0:
+                          if (!locked) {
+                            _context.next = 5;
+                            break;
+                          }
+
+                          _context.next = 3;
+                          return new Promise(function (resolve) {
+                            return setTimeout(resolve, 10);
+                          });
+
+                        case 3:
+                          _context.next = 0;
+                          break;
+
+                        case 5:
+                          locked = true;
+                          thisIndex = index;
+                          index += 1;
+                          locked = false;
+                          return _context.abrupt("return", thisIndex);
+
+                        case 10:
+                        case "end":
+                          return _context.stop();
                       }
+                    }
+                  }, _callee);
+                }));
+
+                return function nextIndex() {
+                  return _ref.apply(this, arguments);
+                };
+              }();
+
+              results = [];
+              active = 0;
+              return _context3.abrupt("return", new Promise(function (resolve, reject) {
+                _toConsumableArray(Array(limit || 1)).forEach( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
+                  var index;
+                  return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+                    while (1) {
+                      switch (_context2.prev = _context2.next) {
+                        case 0:
+                          active += 1;
+                          _context2.next = 3;
+                          return nextIndex();
+
+                        case 3:
+                          index = _context2.sent;
+
+                        case 4:
+                          if (!(index < array.length)) {
+                            _context2.next = 19;
+                            break;
+                          }
+
+                          _context2.prev = 5;
+                          _context2.next = 8;
+                          return f(array[index], index);
+
+                        case 8:
+                          results[index] = _context2.sent;
+                          _context2.next = 14;
+                          break;
+
+                        case 11:
+                          _context2.prev = 11;
+                          _context2.t0 = _context2["catch"](5);
+                          reject(_context2.t0);
 
-                      _context.next = 3;
-                      return _regeneratorRuntime.awrap(new Promise(function (resolve) {
-                        return setTimeout(resolve, 10);
-                      }));
-
-                    case 3:
-                      _context.next = 0;
-                      break;
-
-                    case 5:
-                      locked = true;
-                      thisIndex = index;
-                      index += 1;
-                      locked = false;
-                      return _context.abrupt("return", thisIndex);
-
-                    case 10:
-                    case "end":
-                      return _context.stop();
-                  }
-                }
-              });
-            };
-
-            results = [];
-            active = 0;
-            return _context3.abrupt("return", new Promise(function (resolve, reject) {
-              _toConsumableArray(Array(limit || 1)).forEach(function _callee() {
-                var index;
-                return _regeneratorRuntime.async(function _callee$(_context2) {
-                  while (1) {
-                    switch (_context2.prev = _context2.next) {
-                      case 0:
-                        active += 1;
-                        _context2.next = 3;
-                        return _regeneratorRuntime.awrap(nextIndex());
-
-                      case 3:
-                        index = _context2.sent;
-
-                      case 4:
-                        if (!(index < array.length)) {
-                          _context2.next = 19;
+                        case 14:
+                          _context2.next = 16;
+                          return nextIndex();
+
+                        case 16:
+                          index = _context2.sent;
+                          _context2.next = 4;
                           break;
-                        }
-
-                        _context2.prev = 5;
-                        _context2.next = 8;
-                        return _regeneratorRuntime.awrap(f(array[index], index));
-
-                      case 8:
-                        results[index] = _context2.sent;
-                        _context2.next = 14;
-                        break;
-
-                      case 11:
-                        _context2.prev = 11;
-                        _context2.t0 = _context2["catch"](5);
-                        reject(_context2.t0);
-
-                      case 14:
-                        _context2.next = 16;
-                        return _regeneratorRuntime.awrap(nextIndex());
-
-                      case 16:
-                        index = _context2.sent;
-                        _context2.next = 4;
-                        break;
-
-                      case 19:
-                        // When finished and no more workers are active, resolve
-                        active -= 1;
-
-                        if (active === 0) {
-                          resolve(results);
-                        }
-
-                      case 21:
-                      case "end":
-                        return _context2.stop();
+
+                        case 19:
+                          // When finished and no more workers are active, resolve
+                          active -= 1;
+
+                          if (active === 0) {
+                            resolve(results);
+                          }
+
+                        case 21:
+                        case "end":
+                          return _context2.stop();
+                      }
                     }
-                  }
-                }, null, null, [[5, 11]]);
-              });
-            }));
-
-          case 6:
-          case "end":
-            return _context3.stop();
+                  }, _callee2, null, [[5, 11]]);
+                })));
+              }));
+
+            case 6:
+            case "end":
+              return _context3.stop();
+          }
         }
-      }
-    });
-  },
-  ResponseToJson: function ResponseToJson(response) {
-    return _regeneratorRuntime.async(function ResponseToJson$(_context4) {
-      while (1) {
-        switch (_context4.prev = _context4.next) {
-          case 0:
-            return _context4.abrupt("return", Utils.ResponseToFormat("json", response));
-
-          case 1:
-          case "end":
-            return _context4.stop();
+      }, _callee3);
+    }));
+
+    function LimitedMap(_x, _x2, _x3) {
+      return _LimitedMap.apply(this, arguments);
+    }
+
+    return LimitedMap;
+  }(),
+  ResponseToJson: function () {
+    var _ResponseToJson = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4(response) {
+      return _regeneratorRuntime.wrap(function _callee4$(_context4) {
+        while (1) {
+          switch (_context4.prev = _context4.next) {
+            case 0:
+              return _context4.abrupt("return", Utils.ResponseToFormat("json", response));
+
+            case 1:
+            case "end":
+              return _context4.stop();
+          }
         }
-      }
-    });
-  },
-  ResponseToFormat: function ResponseToFormat(format, response) {
-    return _regeneratorRuntime.async(function ResponseToFormat$(_context5) {
-      while (1) {
-        switch (_context5.prev = _context5.next) {
-          case 0:
-            _context5.next = 2;
-            return _regeneratorRuntime.awrap(response);
+      }, _callee4);
+    }));
+
+    function ResponseToJson(_x4) {
+      return _ResponseToJson.apply(this, arguments);
+    }
 
-          case 2:
-            response = _context5.sent;
-            _context5.t0 = format.toLowerCase();
-            _context5.next = _context5.t0 === "json" ? 6 : _context5.t0 === "text" ? 9 : _context5.t0 === "blob" ? 12 : _context5.t0 === "arraybuffer" ? 15 : _context5.t0 === "formdata" ? 18 : _context5.t0 === "buffer" ? 21 : 24;
-            break;
+    return ResponseToJson;
+  }(),
+  ResponseToFormat: function () {
+    var _ResponseToFormat = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(format, response) {
+      return _regeneratorRuntime.wrap(function _callee5$(_context5) {
+        while (1) {
+          switch (_context5.prev = _context5.next) {
+            case 0:
+              _context5.next = 2;
+              return response;
 
-          case 6:
-            _context5.next = 8;
-            return _regeneratorRuntime.awrap(response.json());
+            case 2:
+              response = _context5.sent;
+              _context5.t0 = format.toLowerCase();
+              _context5.next = _context5.t0 === "json" ? 6 : _context5.t0 === "text" ? 9 : _context5.t0 === "blob" ? 12 : _context5.t0 === "arraybuffer" ? 15 : _context5.t0 === "formdata" ? 18 : _context5.t0 === "buffer" ? 21 : 24;
+              break;
 
-          case 8:
-            return _context5.abrupt("return", _context5.sent);
+            case 6:
+              _context5.next = 8;
+              return response.json();
 
-          case 9:
-            _context5.next = 11;
-            return _regeneratorRuntime.awrap(response.text());
+            case 8:
+              return _context5.abrupt("return", _context5.sent);
 
-          case 11:
-            return _context5.abrupt("return", _context5.sent);
+            case 9:
+              _context5.next = 11;
+              return response.text();
 
-          case 12:
-            _context5.next = 14;
-            return _regeneratorRuntime.awrap(response.blob());
+            case 11:
+              return _context5.abrupt("return", _context5.sent);
 
-          case 14:
-            return _context5.abrupt("return", _context5.sent);
+            case 12:
+              _context5.next = 14;
+              return response.blob();
 
-          case 15:
-            _context5.next = 17;
-            return _regeneratorRuntime.awrap(response.arrayBuffer());
+            case 14:
+              return _context5.abrupt("return", _context5.sent);
 
-          case 17:
-            return _context5.abrupt("return", _context5.sent);
+            case 15:
+              _context5.next = 17;
+              return response.arrayBuffer();
 
-          case 18:
-            _context5.next = 20;
-            return _regeneratorRuntime.awrap(response.formData());
+            case 17:
+              return _context5.abrupt("return", _context5.sent);
 
-          case 20:
-            return _context5.abrupt("return", _context5.sent);
+            case 18:
+              _context5.next = 20;
+              return response.formData();
 
-          case 21:
-            _context5.next = 23;
-            return _regeneratorRuntime.awrap(response.buffer());
+            case 20:
+              return _context5.abrupt("return", _context5.sent);
 
-          case 23:
-            return _context5.abrupt("return", _context5.sent);
+            case 21:
+              _context5.next = 23;
+              return response.buffer();
 
-          case 24:
-            return _context5.abrupt("return", response);
+            case 23:
+              return _context5.abrupt("return", _context5.sent);
 
-          case 25:
-          case "end":
-            return _context5.stop();
+            case 24:
+              return _context5.abrupt("return", response);
+
+            case 25:
+            case "end":
+              return _context5.stop();
+          }
         }
-      }
-    });
-  },
+      }, _callee5);
+    }));
+
+    function ResponseToFormat(_x5, _x6) {
+      return _ResponseToFormat.apply(this, arguments);
+    }
+
+    return ResponseToFormat;
+  }(),
 
   /**
    * Resize the image file or link URL to the specified maximum height. Can also be used to remove
@@ -510,9 +714,9 @@ var Utils = {
    *
    * @returns {string} - The modified URL with the height parameter
    */
-  ResizeImage: function ResizeImage(_ref) {
-    var imageUrl = _ref.imageUrl,
-        height = _ref.height;
+  ResizeImage: function ResizeImage(_ref3) {
+    var imageUrl = _ref3.imageUrl,
+        height = _ref3.height;
 
     if (!imageUrl || imageUrl && !imageUrl.startsWith("http")) {
       return imageUrl;