@eluvio/elv-client-js 4.0.23 → 4.0.25

package/dist/src/ElvClient.js

@@ -134,8 +134,8 @@ var ElvClient = /*#__PURE__*/function () {
    * @param {string} configUrl - Full URL to the config endpoint
    * @param {Array<string>} kmsUrls - List of KMS urls to use for OAuth authentication
    * @param {string=} region - Preferred region - the fabric will auto-detect the best region if not specified
-   * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
-   *
+   * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
+   * @param {string=} clientIP - IP address to use in determining the region to use
    * @return {Promise<Object>} - Object containing content space ID and fabric and ethereum URLs
    */
   _createClass(ElvClient, [{
@@ -256,6 +256,10 @@ var ElvClient = /*#__PURE__*/function () {
                 uris: this.authServiceURIs,
                 debug: this.debug
               });
+              this.SearchHttpClient = new HttpClient({
+                uris: this.searchURIs || [],
+                debug: this.debug
+              });
               this.ethClient = new EthClient({
                 client: this,
                 uris: this.ethereumURIs,
@@ -292,7 +296,7 @@ var ElvClient = /*#__PURE__*/function () {
               // Initialize crypto wasm
               this.Crypto = Crypto;
               this.Crypto.ElvCrypto();
-            case 18:
+            case 19:
             case "end":
               return _context2.stop();
           }
@@ -318,12 +322,12 @@ var ElvClient = /*#__PURE__*/function () {
     /**
      * Update fabric URLs to prefer the specified region.
      *
-     * Note: Client must have been initialized with FromConfiguration
+     * Note: Client must have been initialized with FromConfigurationUrl or FromNetworkName
      *
      * @methodGroup Nodes
      * @namedParams
      * @param {string} region - Preferred region - the fabric will auto-detect the best region if not specified
-     * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
+     * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
      *
      * @return {Promise<Object>} - An object containing the updated fabric, ethereum, auth service, and search URLs in order of preference
      */
@@ -380,7 +384,7 @@ var ElvClient = /*#__PURE__*/function () {
     /**
      * Reset fabric URLs to prefer the best region auto-detected by the fabric.
      *
-     * Note: Client must have been initialized with FromConfiguration
+     * Note: Client must have been initialized with FromConfigurationUrl or FromNetworkName
      *
      * @methodGroup Nodes
      *
@@ -419,7 +423,7 @@ var ElvClient = /*#__PURE__*/function () {
     /**
      * Retrieve the node ID reported by the fabric for the specified region
      *
-     * Note: Client must have been initialized with FromConfiguration
+     * Note: Client must have been initialized with FromConfigurationUrl or FromNetworkName
      *
      * @methodGroup Nodes
      *
@@ -1068,7 +1072,7 @@ var ElvClient = /*#__PURE__*/function () {
      * Set the signer for this client via OAuth token. The client will exchange the given token
      * for the user's private key using the KMS specified in the configuration.
      *
-     * NOTE: The KMS URL(s) must be set in the initial configuration of the client (FromConfigurationUrl)
+     * NOTE: The KMS URL(s) must be set in the initial configuration of the client (FromConfigurationUrl or FromNetworkName)
      *
      * @methodGroup Authorization
      * @namedParams
@@ -1489,20 +1493,23 @@ var ElvClient = /*#__PURE__*/function () {
     key: "Configuration",
     value: function () {
       var _Configuration = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee21(_ref22) {
-        var configUrl, _ref22$kmsUrls, kmsUrls, region, uri, fabricInfo, filterHTTPS, fabricURIs, ethereumURIs, authServiceURIs, searchURIs, fabricVersion;
+        var configUrl, _ref22$kmsUrls, kmsUrls, region, clientIP, uri, fabricInfo, filterHTTPS, fabricURIs, ethereumURIs, authServiceURIs, searchURIs, fabricVersion;
         return _regeneratorRuntime.wrap(function _callee21$(_context21) {
           while (1) switch (_context21.prev = _context21.next) {
             case 0:
-              configUrl = _ref22.configUrl, _ref22$kmsUrls = _ref22.kmsUrls, kmsUrls = _ref22$kmsUrls === void 0 ? [] : _ref22$kmsUrls, region = _ref22.region;
+              configUrl = _ref22.configUrl, _ref22$kmsUrls = _ref22.kmsUrls, kmsUrls = _ref22$kmsUrls === void 0 ? [] : _ref22$kmsUrls, region = _ref22.region, clientIP = _ref22.clientIP;
               _context21.prev = 1;
               uri = new URI(configUrl);
               uri.pathname("/config");
               if (region) {
                 uri.addSearch("elvgeo", region);
               }
-              _context21.next = 7;
+              if (clientIP) {
+                uri.addSearch("client_ip", clientIP);
+              }
+              _context21.next = 8;
               return Utils.ResponseToJson(HttpClient.Fetch(uri.toString()));
-            case 7:
+            case 8:
               fabricInfo = _context21.sent;
               // If any HTTPS urls present, throw away HTTP urls so only HTTPS will be used
               filterHTTPS = function filterHTTPS(uri) {
@@ -1534,19 +1541,19 @@ var ElvClient = /*#__PURE__*/function () {
                 searchURIs: searchURIs,
                 fabricVersion: fabricVersion
               });
-            case 20:
-              _context21.prev = 20;
+            case 21:
+              _context21.prev = 21;
               _context21.t0 = _context21["catch"](1);
               // eslint-disable-next-line no-console
               console.error("Error retrieving fabric configuration:");
               // eslint-disable-next-line no-console
               console.error(_context21.t0);
               throw _context21.t0;
-            case 25:
+            case 26:
             case "end":
               return _context21.stop();
           }
-        }, _callee21, null, [[1, 20]]);
+        }, _callee21, null, [[1, 21]]);
       }));
       function Configuration(_x18) {
         return _Configuration.apply(this, arguments);
@@ -1560,7 +1567,8 @@ var ElvClient = /*#__PURE__*/function () {
      * @namedParams
      * @param {string} networkName - Name of the network to connect to ("main", "demo", "test)
      * @param {string=} region - Preferred region - the fabric will auto-detect the best region if not specified
-     * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
+     * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
+     * @param {string=} clientIP - IP address to use in determining the region to use
      * @param {string=} trustAuthorityId - (OAuth) The ID of the trust authority to use for OAuth authentication   * @param {boolean=} noCache=false - If enabled, blockchain transactions will not be cached
      * @param {string=} staticToken - Static token that will be used for all authorization in place of normal auth
      * @param {number=} ethereumContractTimeout=10 - Number of seconds to wait for contract calls
@@ -1572,11 +1580,11 @@ var ElvClient = /*#__PURE__*/function () {
     key: "FromNetworkName",
     value: function () {
       var _FromNetworkName = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee22(_ref23) {
-        var networkName, region, trustAuthorityId, staticToken, _ref23$ethereumContra, ethereumContractTimeout, _ref23$noCache, noCache, _ref23$noAuth, noAuth, assumeV3, configUrl;
+        var networkName, region, clientIP, trustAuthorityId, staticToken, _ref23$ethereumContra, ethereumContractTimeout, _ref23$noCache, noCache, _ref23$noAuth, noAuth, assumeV3, configUrl;
         return _regeneratorRuntime.wrap(function _callee22$(_context22) {
           while (1) switch (_context22.prev = _context22.next) {
             case 0:
-              networkName = _ref23.networkName, region = _ref23.region, trustAuthorityId = _ref23.trustAuthorityId, staticToken = _ref23.staticToken, _ref23$ethereumContra = _ref23.ethereumContractTimeout, ethereumContractTimeout = _ref23$ethereumContra === void 0 ? 10 : _ref23$ethereumContra, _ref23$noCache = _ref23.noCache, noCache = _ref23$noCache === void 0 ? false : _ref23$noCache, _ref23$noAuth = _ref23.noAuth, noAuth = _ref23$noAuth === void 0 ? false : _ref23$noAuth, assumeV3 = _ref23.assumeV3;
+              networkName = _ref23.networkName, region = _ref23.region, clientIP = _ref23.clientIP, trustAuthorityId = _ref23.trustAuthorityId, staticToken = _ref23.staticToken, _ref23$ethereumContra = _ref23.ethereumContractTimeout, ethereumContractTimeout = _ref23$ethereumContra === void 0 ? 10 : _ref23$ethereumContra, _ref23$noCache = _ref23.noCache, noCache = _ref23$noCache === void 0 ? false : _ref23$noCache, _ref23$noAuth = _ref23.noAuth, noAuth = _ref23$noAuth === void 0 ? false : _ref23$noAuth, assumeV3 = _ref23.assumeV3;
               configUrl = networks[networkName];
               if (configUrl) {
                 _context22.next = 4;
@@ -1588,6 +1596,7 @@ var ElvClient = /*#__PURE__*/function () {
               return this.FromConfigurationUrl({
                 configUrl: configUrl,
                 region: region,
+                clientIP: clientIP,
                 trustAuthorityId: trustAuthorityId,
                 staticToken: staticToken,
                 ethereumContractTimeout: ethereumContractTimeout,
@@ -1615,7 +1624,8 @@ var ElvClient = /*#__PURE__*/function () {
      * @namedParams
      * @param {string} configUrl - Full URL to the config endpoint
      * @param {string=} region - Preferred region - the fabric will auto-detect the best region if not specified
-     * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
+     * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
+     * @param {string=} clientIP - IP address to use in determining the region to use
      * @param {string=} trustAuthorityId - (OAuth) The ID of the trust authority to use for OAuth authentication   * @param {boolean=} noCache=false - If enabled, blockchain transactions will not be cached
      * @param {string=} staticToken - Static token that will be used for all authorization in place of normal auth
      * @param {number=} ethereumContractTimeout=10 - Number of seconds to wait for contract calls
@@ -1627,14 +1637,15 @@ var ElvClient = /*#__PURE__*/function () {
     key: "FromConfigurationUrl",
     value: function () {
       var _FromConfigurationUrl = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee23(_ref24) {
-        var configUrl, region, trustAuthorityId, staticToken, _ref24$ethereumContra, ethereumContractTimeout, _ref24$noCache, noCache, _ref24$noAuth, noAuth, _ref24$assumeV, assumeV3, _yield$ElvClient$Conf3, contentSpaceId, networkId, networkName, fabricURIs, ethereumURIs, authServiceURIs, searchURIs, fabricVersion, client;
+        var configUrl, region, clientIP, trustAuthorityId, staticToken, _ref24$ethereumContra, ethereumContractTimeout, _ref24$noCache, noCache, _ref24$noAuth, noAuth, _ref24$assumeV, assumeV3, _yield$ElvClient$Conf3, contentSpaceId, networkId, networkName, fabricURIs, ethereumURIs, authServiceURIs, searchURIs, fabricVersion, client;
         return _regeneratorRuntime.wrap(function _callee23$(_context23) {
           while (1) switch (_context23.prev = _context23.next) {
             case 0:
-              configUrl = _ref24.configUrl, region = _ref24.region, trustAuthorityId = _ref24.trustAuthorityId, staticToken = _ref24.staticToken, _ref24$ethereumContra = _ref24.ethereumContractTimeout, ethereumContractTimeout = _ref24$ethereumContra === void 0 ? 10 : _ref24$ethereumContra, _ref24$noCache = _ref24.noCache, noCache = _ref24$noCache === void 0 ? false : _ref24$noCache, _ref24$noAuth = _ref24.noAuth, noAuth = _ref24$noAuth === void 0 ? false : _ref24$noAuth, _ref24$assumeV = _ref24.assumeV3, assumeV3 = _ref24$assumeV === void 0 ? false : _ref24$assumeV;
+              configUrl = _ref24.configUrl, region = _ref24.region, clientIP = _ref24.clientIP, trustAuthorityId = _ref24.trustAuthorityId, staticToken = _ref24.staticToken, _ref24$ethereumContra = _ref24.ethereumContractTimeout, ethereumContractTimeout = _ref24$ethereumContra === void 0 ? 10 : _ref24$ethereumContra, _ref24$noCache = _ref24.noCache, noCache = _ref24$noCache === void 0 ? false : _ref24$noCache, _ref24$noAuth = _ref24.noAuth, noAuth = _ref24$noAuth === void 0 ? false : _ref24$noAuth, _ref24$assumeV = _ref24.assumeV3, assumeV3 = _ref24$assumeV === void 0 ? false : _ref24$assumeV;
               _context23.next = 3;
               return ElvClient.Configuration({
                 configUrl: configUrl,
+                clientIP: clientIP,
                 region: region
               });
             case 3:

package/dist/src/client/ContentAccess.js

@@ -2835,11 +2835,13 @@ exports.CallBitcodeMethod = /*#__PURE__*/function () {
  * @param {string=} versionHash - Hash of the object version - if not specified, latest version will be used
  * @param {string} rep - Representation to use
  * @param {Object=} queryParams - Query params to add to the URL
+ * @param {string=} service=fabric - The service to use. By default, will use a fabric node. Options: "fabric", "search", "auth"
  * @param {boolean=} channelAuth=false - If specified, state channel authorization will be performed instead of access request authorization
  * @param {boolean=} noAuth=false - If specified, authorization will not be performed and the URL will not have an authorization
  * token. This is useful for accessing public assets.
  * @param {boolean=} noCache=false - If specified, a new access request will be made for the authorization regardless of
  * whether such a request exists in the client cache. This request will not be cached. This option has no effect if noAuth is true.
+ * @param {boolean=} makeAccessRequest=false - If using auth, will make a full access request
  *
  * @see <a href="#FabricUrl">FabricUrl</a> for creating arbitrary fabric URLs
  *
@@ -2847,11 +2849,11 @@ exports.CallBitcodeMethod = /*#__PURE__*/function () {
  */
 exports.Rep = /*#__PURE__*/function () {
   var _ref63 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee36(_ref62) {
-    var libraryId, objectId, versionHash, rep, _ref62$queryParams, queryParams, _ref62$channelAuth, channelAuth, _ref62$noAuth, noAuth, _ref62$noCache, noCache;
+    var libraryId, objectId, versionHash, rep, _ref62$queryParams, queryParams, _ref62$service, service, _ref62$makeAccessRequ, makeAccessRequest, _ref62$channelAuth, channelAuth, _ref62$noAuth, noAuth, _ref62$noCache, noCache;
     return _regeneratorRuntime.wrap(function _callee36$(_context36) {
       while (1) switch (_context36.prev = _context36.next) {
         case 0:
-          libraryId = _ref62.libraryId, objectId = _ref62.objectId, versionHash = _ref62.versionHash, rep = _ref62.rep, _ref62$queryParams = _ref62.queryParams, queryParams = _ref62$queryParams === void 0 ? {} : _ref62$queryParams, _ref62$channelAuth = _ref62.channelAuth, channelAuth = _ref62$channelAuth === void 0 ? false : _ref62$channelAuth, _ref62$noAuth = _ref62.noAuth, noAuth = _ref62$noAuth === void 0 ? false : _ref62$noAuth, _ref62$noCache = _ref62.noCache, noCache = _ref62$noCache === void 0 ? false : _ref62$noCache;
+          libraryId = _ref62.libraryId, objectId = _ref62.objectId, versionHash = _ref62.versionHash, rep = _ref62.rep, _ref62$queryParams = _ref62.queryParams, queryParams = _ref62$queryParams === void 0 ? {} : _ref62$queryParams, _ref62$service = _ref62.service, service = _ref62$service === void 0 ? "fabric" : _ref62$service, _ref62$makeAccessRequ = _ref62.makeAccessRequest, makeAccessRequest = _ref62$makeAccessRequ === void 0 ? false : _ref62$makeAccessRequ, _ref62$channelAuth = _ref62.channelAuth, channelAuth = _ref62$channelAuth === void 0 ? false : _ref62$channelAuth, _ref62$noAuth = _ref62.noAuth, noAuth = _ref62$noAuth === void 0 ? false : _ref62$noAuth, _ref62$noCache = _ref62.noCache, noCache = _ref62$noCache === void 0 ? false : _ref62$noCache;
           ValidateParameters({
             libraryId: libraryId,
             objectId: objectId,
@@ -2869,6 +2871,8 @@ exports.Rep = /*#__PURE__*/function () {
             versionHash: versionHash,
             rep: rep,
             queryParams: queryParams,
+            service: service,
+            makeAccessRequest: makeAccessRequest,
             channelAuth: channelAuth,
             noAuth: noAuth,
             noCache: noCache
@@ -2903,11 +2907,11 @@ exports.Rep = /*#__PURE__*/function () {
  */
 exports.PublicRep = /*#__PURE__*/function () {
   var _ref65 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee37(_ref64) {
-    var libraryId, objectId, versionHash, rep, _ref64$queryParams, queryParams;
+    var libraryId, objectId, versionHash, rep, _ref64$queryParams, queryParams, _ref64$service, service;
     return _regeneratorRuntime.wrap(function _callee37$(_context37) {
       while (1) switch (_context37.prev = _context37.next) {
         case 0:
-          libraryId = _ref64.libraryId, objectId = _ref64.objectId, versionHash = _ref64.versionHash, rep = _ref64.rep, _ref64$queryParams = _ref64.queryParams, queryParams = _ref64$queryParams === void 0 ? {} : _ref64$queryParams;
+          libraryId = _ref64.libraryId, objectId = _ref64.objectId, versionHash = _ref64.versionHash, rep = _ref64.rep, _ref64$queryParams = _ref64.queryParams, queryParams = _ref64$queryParams === void 0 ? {} : _ref64$queryParams, _ref64$service = _ref64.service, service = _ref64$service === void 0 ? "fabric" : _ref64$service;
           ValidateParameters({
             libraryId: libraryId,
             objectId: objectId,
@@ -2925,6 +2929,7 @@ exports.PublicRep = /*#__PURE__*/function () {
             versionHash: versionHash,
             publicRep: rep,
             queryParams: queryParams,
+            service: service,
             noAuth: true
           }));
         case 5:
@@ -2952,21 +2957,23 @@ exports.PublicRep = /*#__PURE__*/function () {
  * @param {string=} publicRep - Public rep parameter of the url
  * @param {string=} call - Bitcode method to call
  * @param {Object=} queryParams - Query params to add to the URL
+ * @param {string=} service=fabric - The service to use. By default, will use a fabric node. Options: "fabric", "search", "auth"
  * @param {boolean=} channelAuth=false - If specified, state channel authorization will be used instead of access request authorization
  * @param {boolean=} noAuth=false - If specified, authorization will not be performed and the URL will not have an authorization
  * token. This is useful for accessing public assets.
  * @param {boolean=} noCache=false - If specified, a new access request will be made for the authorization regardless of
  * whether such a request exists in the client cache. This request will not be cached. This option has no effect if noAuth is true.
+ * @param {boolean=} makeAccessRequest=false - If using auth, will make a full access request
  *
  * @returns {Promise<string>} - URL to the specified endpoint with authorization token
  */
 exports.FabricUrl = /*#__PURE__*/function () {
   var _ref67 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee38(_ref66) {
-    var libraryId, objectId, versionHash, writeToken, partHash, rep, publicRep, call, _ref66$queryParams, queryParams, _ref66$channelAuth, channelAuth, _ref66$noAuth, noAuth, _ref66$noCache, noCache, authorization, path;
+    var libraryId, objectId, versionHash, writeToken, partHash, rep, publicRep, call, _ref66$queryParams, queryParams, _ref66$service, service, _ref66$channelAuth, channelAuth, _ref66$makeAccessRequ, makeAccessRequest, _ref66$noAuth, noAuth, _ref66$noCache, noCache, authorization, path, httpClient;
     return _regeneratorRuntime.wrap(function _callee38$(_context38) {
       while (1) switch (_context38.prev = _context38.next) {
         case 0:
-          libraryId = _ref66.libraryId, objectId = _ref66.objectId, versionHash = _ref66.versionHash, writeToken = _ref66.writeToken, partHash = _ref66.partHash, rep = _ref66.rep, publicRep = _ref66.publicRep, call = _ref66.call, _ref66$queryParams = _ref66.queryParams, queryParams = _ref66$queryParams === void 0 ? {} : _ref66$queryParams, _ref66$channelAuth = _ref66.channelAuth, channelAuth = _ref66$channelAuth === void 0 ? false : _ref66$channelAuth, _ref66$noAuth = _ref66.noAuth, noAuth = _ref66$noAuth === void 0 ? false : _ref66$noAuth, _ref66$noCache = _ref66.noCache, noCache = _ref66$noCache === void 0 ? false : _ref66$noCache;
+          libraryId = _ref66.libraryId, objectId = _ref66.objectId, versionHash = _ref66.versionHash, writeToken = _ref66.writeToken, partHash = _ref66.partHash, rep = _ref66.rep, publicRep = _ref66.publicRep, call = _ref66.call, _ref66$queryParams = _ref66.queryParams, queryParams = _ref66$queryParams === void 0 ? {} : _ref66$queryParams, _ref66$service = _ref66.service, service = _ref66$service === void 0 ? "fabric" : _ref66$service, _ref66$channelAuth = _ref66.channelAuth, channelAuth = _ref66$channelAuth === void 0 ? false : _ref66$channelAuth, _ref66$makeAccessRequ = _ref66.makeAccessRequest, makeAccessRequest = _ref66$makeAccessRequ === void 0 ? false : _ref66$makeAccessRequ, _ref66$noAuth = _ref66.noAuth, noAuth = _ref66$noAuth === void 0 ? false : _ref66$noAuth, _ref66$noCache = _ref66.noCache, noCache = _ref66$noCache === void 0 ? false : _ref66$noCache;
           if (objectId || versionHash) {
             ValidateParameters({
               libraryId: libraryId,
@@ -2993,6 +3000,7 @@ exports.FabricUrl = /*#__PURE__*/function () {
             objectId: objectId,
             versionHash: versionHash,
             channelAuth: channelAuth,
+            makeAccessRequest: makeAccessRequest,
             noAuth: noAuth,
             noCache: noCache
           });
@@ -3033,11 +3041,17 @@ exports.FabricUrl = /*#__PURE__*/function () {
           } else if (call) {
             path = UrlJoin(path, "call", call);
           }
-          return _context38.abrupt("return", this.HttpClient.URL({
+          httpClient = this.HttpClient;
+          if (service === "search") {
+            httpClient = this.SearchHttpClient;
+          } else if (service === "auth") {
+            httpClient = this.AuthHttpClient;
+          }
+          return _context38.abrupt("return", httpClient.URL({
             path: path,
             queryParams: queryParams
           }));
-        case 21:
+        case 23:
         case "end":
           return _context38.stop();
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eluvio/elv-client-js",
-  "version": "4.0.23",
+  "version": "4.0.25",
   "description": "Javascript client for the Eluvio Content Fabric",
   "main": "src/index.js",
   "author": "Kevin Talmadge",

package/src/ElvClient.js

@@ -203,14 +203,15 @@ class ElvClient {
    * @param {string} configUrl - Full URL to the config endpoint
    * @param {Array<string>} kmsUrls - List of KMS urls to use for OAuth authentication
    * @param {string=} region - Preferred region - the fabric will auto-detect the best region if not specified
-   * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
-   *
+   * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
+   * @param {string=} clientIP - IP address to use in determining the region to use
    * @return {Promise<Object>} - Object containing content space ID and fabric and ethereum URLs
    */
   static async Configuration({
     configUrl,
     kmsUrls=[],
-    region
+    region,
+    clientIP
   }) {
     try {
       const uri = new URI(configUrl);
@@ -220,6 +221,10 @@ class ElvClient {
         uri.addSearch("elvgeo", region);
       }
 
+      if(clientIP) {
+        uri.addSearch("client_ip", clientIP);
+      }
+
       const fabricInfo = await Utils.ResponseToJson(
         HttpClient.Fetch(uri.toString())
       );
@@ -275,7 +280,8 @@ class ElvClient {
    * @namedParams
    * @param {string} networkName - Name of the network to connect to ("main", "demo", "test)
    * @param {string=} region - Preferred region - the fabric will auto-detect the best region if not specified
-   * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
+   * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
+   * @param {string=} clientIP - IP address to use in determining the region to use
    * @param {string=} trustAuthorityId - (OAuth) The ID of the trust authority to use for OAuth authentication   * @param {boolean=} noCache=false - If enabled, blockchain transactions will not be cached
    * @param {string=} staticToken - Static token that will be used for all authorization in place of normal auth
    * @param {number=} ethereumContractTimeout=10 - Number of seconds to wait for contract calls
@@ -286,6 +292,7 @@ class ElvClient {
   static async FromNetworkName({
     networkName,
     region,
+    clientIP,
     trustAuthorityId,
     staticToken,
     ethereumContractTimeout=10,
@@ -300,6 +307,7 @@ class ElvClient {
     return await this.FromConfigurationUrl({
       configUrl,
       region,
+      clientIP,
       trustAuthorityId,
       staticToken,
       ethereumContractTimeout,
@@ -316,7 +324,8 @@ class ElvClient {
    * @namedParams
    * @param {string} configUrl - Full URL to the config endpoint
    * @param {string=} region - Preferred region - the fabric will auto-detect the best region if not specified
-   * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
+   * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
+   * @param {string=} clientIP - IP address to use in determining the region to use
    * @param {string=} trustAuthorityId - (OAuth) The ID of the trust authority to use for OAuth authentication   * @param {boolean=} noCache=false - If enabled, blockchain transactions will not be cached
    * @param {string=} staticToken - Static token that will be used for all authorization in place of normal auth
    * @param {number=} ethereumContractTimeout=10 - Number of seconds to wait for contract calls
@@ -327,6 +336,7 @@ class ElvClient {
   static async FromConfigurationUrl({
     configUrl,
     region,
+    clientIP,
     trustAuthorityId,
     staticToken,
     ethereumContractTimeout=10,
@@ -345,6 +355,7 @@ class ElvClient {
       fabricVersion
     } = await ElvClient.Configuration({
       configUrl,
+      clientIP,
       region
     });
 
@@ -384,6 +395,7 @@ class ElvClient {
     const uris = this.service === "search" ? this.searchURIs : this.fabricURIs;
     this.HttpClient = new HttpClient({uris, debug: this.debug});
     this.AuthHttpClient = new HttpClient({uris: this.authServiceURIs, debug: this.debug});
+    this.SearchHttpClient = new HttpClient({uris: this.searchURIs || [], debug: this.debug});
     this.ethClient = new EthClient({client: this, uris: this.ethereumURIs, networkId: this.networkId, debug: this.debug, timeout: this.ethereumContractTimeout});
 
     if(!this.signer) {
@@ -425,12 +437,12 @@ class ElvClient {
   /**
    * Update fabric URLs to prefer the specified region.
    *
-   * Note: Client must have been initialized with FromConfiguration
+   * Note: Client must have been initialized with FromConfigurationUrl or FromNetworkName
    *
    * @methodGroup Nodes
    * @namedParams
    * @param {string} region - Preferred region - the fabric will auto-detect the best region if not specified
-   * - Available regions: as-east au-east eu-east-north eu-west-north na-east-north na-east-south na-west-north na-west-south eu-east-south eu-west-south
+   * - Available regions: as-east, au-east, eu-east-north, eu-west-north, na-east-north, na-east-south, na-west-north, na-west-south, eu-east-south, eu-west-south
    *
    * @return {Promise<Object>} - An object containing the updated fabric, ethereum, auth service, and search URLs in order of preference
    */
@@ -465,7 +477,7 @@ class ElvClient {
   /**
    * Reset fabric URLs to prefer the best region auto-detected by the fabric.
    *
-   * Note: Client must have been initialized with FromConfiguration
+   * Note: Client must have been initialized with FromConfigurationUrl or FromNetworkName
    *
    * @methodGroup Nodes
    *
@@ -482,7 +494,7 @@ class ElvClient {
   /**
    * Retrieve the node ID reported by the fabric for the specified region
    *
-   * Note: Client must have been initialized with FromConfiguration
+   * Note: Client must have been initialized with FromConfigurationUrl or FromNetworkName
    *
    * @methodGroup Nodes
    *
@@ -898,7 +910,7 @@ class ElvClient {
    * Set the signer for this client via OAuth token. The client will exchange the given token
    * for the user's private key using the KMS specified in the configuration.
    *
-   * NOTE: The KMS URL(s) must be set in the initial configuration of the client (FromConfigurationUrl)
+   * NOTE: The KMS URL(s) must be set in the initial configuration of the client (FromConfigurationUrl or FromNetworkName)
    *
    * @methodGroup Authorization
    * @namedParams

package/src/client/ContentAccess.js

@@ -1848,21 +1848,23 @@ exports.CallBitcodeMethod = async function({
  * @param {string=} versionHash - Hash of the object version - if not specified, latest version will be used
  * @param {string} rep - Representation to use
  * @param {Object=} queryParams - Query params to add to the URL
+ * @param {string=} service=fabric - The service to use. By default, will use a fabric node. Options: "fabric", "search", "auth"
  * @param {boolean=} channelAuth=false - If specified, state channel authorization will be performed instead of access request authorization
  * @param {boolean=} noAuth=false - If specified, authorization will not be performed and the URL will not have an authorization
  * token. This is useful for accessing public assets.
  * @param {boolean=} noCache=false - If specified, a new access request will be made for the authorization regardless of
  * whether such a request exists in the client cache. This request will not be cached. This option has no effect if noAuth is true.
+ * @param {boolean=} makeAccessRequest=false - If using auth, will make a full access request
  *
  * @see <a href="#FabricUrl">FabricUrl</a> for creating arbitrary fabric URLs
  *
  * @returns {Promise<string>} - URL to the specified rep endpoint with authorization token
  */
-exports.Rep = async function({libraryId, objectId, versionHash, rep, queryParams={}, channelAuth=false, noAuth=false, noCache=false}) {
+exports.Rep = async function({libraryId, objectId, versionHash, rep, queryParams={}, service="fabric", makeAccessRequest=false, channelAuth=false, noAuth=false, noCache=false}) {
   ValidateParameters({libraryId, objectId, versionHash});
   if(!rep) { throw "Rep not specified"; }
 
-  return this.FabricUrl({libraryId, objectId, versionHash, rep, queryParams, channelAuth, noAuth, noCache});
+  return this.FabricUrl({libraryId, objectId, versionHash, rep, queryParams, service, makeAccessRequest, channelAuth, noAuth, noCache});
 };
 
 /**
@@ -1882,11 +1884,11 @@ exports.Rep = async function({libraryId, objectId, versionHash, rep, queryParams
  *
  * @returns {Promise<string>} - URL to the specified rep endpoint with authorization token
  */
-exports.PublicRep = async function({libraryId, objectId, versionHash, rep, queryParams={}}) {
+exports.PublicRep = async function({libraryId, objectId, versionHash, rep, queryParams={}, service="fabric"}) {
   ValidateParameters({libraryId, objectId, versionHash});
   if(!rep) { throw "Rep not specified"; }
 
-  return this.FabricUrl({libraryId, objectId, versionHash, publicRep: rep, queryParams, noAuth: true});
+  return this.FabricUrl({libraryId, objectId, versionHash, publicRep: rep, queryParams, service, noAuth: true});
 };
 
 /**
@@ -1903,11 +1905,13 @@ exports.PublicRep = async function({libraryId, objectId, versionHash, rep, query
  * @param {string=} publicRep - Public rep parameter of the url
  * @param {string=} call - Bitcode method to call
  * @param {Object=} queryParams - Query params to add to the URL
+ * @param {string=} service=fabric - The service to use. By default, will use a fabric node. Options: "fabric", "search", "auth"
  * @param {boolean=} channelAuth=false - If specified, state channel authorization will be used instead of access request authorization
  * @param {boolean=} noAuth=false - If specified, authorization will not be performed and the URL will not have an authorization
  * token. This is useful for accessing public assets.
  * @param {boolean=} noCache=false - If specified, a new access request will be made for the authorization regardless of
  * whether such a request exists in the client cache. This request will not be cached. This option has no effect if noAuth is true.
+ * @param {boolean=} makeAccessRequest=false - If using auth, will make a full access request
  *
  * @returns {Promise<string>} - URL to the specified endpoint with authorization token
  */
@@ -1921,7 +1925,9 @@ exports.FabricUrl = async function({
   publicRep,
   call,
   queryParams={},
+  service="fabric",
   channelAuth=false,
+  makeAccessRequest=false,
   noAuth=false,
   noCache=false
 }) {
@@ -1960,6 +1966,7 @@ exports.FabricUrl = async function({
         objectId,
         versionHash,
         channelAuth,
+        makeAccessRequest,
         noAuth,
         noCache
       })
@@ -1997,7 +2004,14 @@ exports.FabricUrl = async function({
     path = UrlJoin(path, "call", call);
   }
 
-  return this.HttpClient.URL({
+  let httpClient = this.HttpClient;
+  if(service === "search") {
+    httpClient = this.SearchHttpClient;
+  } else if(service === "auth") {
+    httpClient = this.AuthHttpClient;
+  }
+
+  return httpClient.URL({
     path,
     queryParams
   });