@eluvio/elv-client-js 3.2.16 → 3.2.18

package/src/walletClient/Configuration.js

@@ -1,6 +1,7 @@
 let WalletConfiguration = {
   demo: {
     configUrl: "https://demov3.net955210.contentfabric.io/config",
+    stateStoreUrls: ["https://appsvc.svc.eluv.io/dv3"],
     staging: {
       siteId: "iq__2gkNh8CCZqFFnoRpEUmz7P3PaBQG",
       purchaseMode: "develop",
@@ -9,6 +10,7 @@ let WalletConfiguration = {
   },
   main: {
     configUrl: "https://main.net955305.contentfabric.io/config",
+    stateStoreUrls: ["https://appsvc.svc.eluv.io/main"],
     staging: {
       siteId: "iq__inauxD1KLyKWPHargCWjdCh2ayr",
       purchaseMode: "production",

package/src/walletClient/Profile.js

@@ -0,0 +1,182 @@
+const Utils = require("../Utils");
+const UrlJoin = require("url-join");
+
+const StateStorePath = ({network, path}) => {
+  return UrlJoin(network === "main" ? "/main" : "/dv3", path);
+};
+
+const UserProfilePath = ({network, appId, userAddress, key, type, mode}) => {
+  return StateStorePath({network, path: UrlJoin(type === "app" ? "app" : "usr", type === "app" ? appId : "", userAddress, mode === "public" ? "pub" : "pri", key || "")});
+};
+
+/**
+ * Methods related to getting and setting user profile data.
+ *
+ * @module ProfileMethods
+ */
+
+/**
+ * Retrieve user profile metadata for the specified user
+ *
+ * @methodGroup ProfileMetadata
+ * @namedParams
+ * @param {string=} type="app" - Specify `app` or `user` metadata.
+ * @param {string=} mode="public" - Specify `public` or `private` metadata. If private is specified, you may only retrieve metadata for the current user.
+ * @param {string=} appId - Namespace to use for the metadata, if retrieving app metadata. Uses the app ID specified on client initialization by default.
+ * @param {string=} userAddress - User to retrieve metadata for. If not specified, will retrieve metadata for the current user
+ * @param {string=} key - The metadata key to retrieve
+ *
+ * @returns {Promise<Object|String>} - Returns the specified metadata
+ */
+exports.ProfileMetadata = async function({type="app", mode="public", appId, userAddress, key}) {
+  try {
+    const response = await this.stateStoreClient.Request({
+      path: UserProfilePath({
+        network: this.network,
+        appId: appId || this.appId,
+        userAddress: userAddress || this.UserAddress(),
+        type,
+        mode,
+        key
+      }),
+      headers: mode === "private" ?
+        {Authorization: `Bearer ${this.AuthToken()}`} : undefined
+    });
+
+    if(!response.ok) {
+      throw response;
+    }
+
+    return (await Utils.ResponseToJson(response))[key];
+  } catch(error) {
+    if(error.status === 404) {
+      return undefined;
+    }
+
+    throw error;
+  }
+};
+
+/**
+ * Set user profile metadata for the current user
+ *
+ * @methodGroup ProfileMetadata
+ * @namedParams
+ * @param {string=} type="app" - Specify `app` or `user` metadata.
+ * @param {string=} mode="public" - Specify `public` or `private` metadata.
+ * @param {string=} appId - Namespace to use for the metadata, if retrieving app metadata. Uses the app ID specified on client initialization by default.
+ * @param {string} key - The metadata key to set
+ * @param {string} value - The metadata value to set
+ */
+exports.SetProfileMetadata = async function({type="app", mode="public", appId, key, value}) {
+  await this.stateStoreClient.Request({
+    method: "POST",
+    path: UserProfilePath({
+      network: this.network,
+      appId: appId || this.appId,
+      userAddress: this.UserAddress(),
+      type,
+      mode,
+      key
+    }),
+    body: value,
+    bodyType: typeof value === "object" ? "JSON" : "string",
+    headers: {
+      Authorization: `Bearer ${this.AuthToken()}`
+    }
+  });
+};
+
+
+/**
+ * Remove user profile metadata for the current user
+ *
+ * @methodGroup ProfileMetadata
+ * @namedParams
+ * @param {string=} type="app" - Specify `app` or `user` metadata.
+ * @param {string=} mode="public" - Specify `public` or `private` metadata.
+ * @param {string=} appId - Namespace to use for the metadata, if retrieving app metadata.. Uses the app ID specified on client initialization by default.
+ * @param {string} key - The metadata key to set
+ * @param {string} value - The metadata value to set
+ */
+exports.RemoveProfileMetadata = async function({type="app", mode="public", appId, key, value}) {
+  await this.stateStoreClient.Request({
+    method: "DELETE",
+    path: UserProfilePath({
+      network: this.network,
+      appId: appId || this.appId,
+      userAddress: this.UserAddress(),
+      type,
+      mode,
+      key
+    }),
+    body: value,
+    headers: {
+      Authorization: `Bearer ${this.AuthToken()}`
+    }
+  });
+};
+
+/**
+ * Retrieve profile info for the specified user, including address, username and profile image (if set)
+ *
+ * @methodGroup Profile
+ * @param {string=} userAddress - Address of the user
+ * @param {string=} userName - Username of the user
+ *
+ * @returns {Promise<Object>} - Profile info of the specified user
+ */
+exports.Profile = async function({userAddress, userName}) {
+  if(userName) {
+    userAddress = await this.UserNameToAddress({userName});
+  }
+
+  if(!userAddress) {
+    throw Error("Eluvio Wallet Client: Unable to determine profile - user address not specified");
+  }
+
+  if(!userName) {
+    userName = await this.ProfileMetadata({type: "user", userAddress, key: "username"});
+  }
+
+  const imageUrl = await this.ProfileMetadata({type: "user", userAddress, key: "icon_url"});
+
+  return {
+    userAddress: Utils.FormatAddress(userAddress),
+    userName,
+    imageUrl
+  };
+};
+
+exports.UserNameToAddress = async function({userName}) {
+  try {
+    const response = await this.stateStoreClient.Request({
+      method: "GET",
+      path: StateStorePath({network: this.network, path: UrlJoin("usr", "profile_for_username", userName)}),
+    });
+
+    if(!response.ok) {
+      throw response;
+    }
+
+    return (await Utils.ResponseToJson(response)).address;
+  } catch(error) {
+    if(error.status !== 404) {
+      throw error;
+    }
+  }
+
+  return undefined;
+};
+
+
+
+
+
+
+
+
+
+
+
+

package/src/walletClient/Utils.js

@@ -23,6 +23,24 @@ const RarityToPercentage = (rarity) => {
   return percentage;
 };
 
+const LinkTargetHash = function(link) {
+  if(!link) { return; }
+
+  if(link["."] && link["."].source) {
+    return link["."].source;
+  }
+
+  if(link["/"] && link["/"].startsWith("/qfab/")) {
+    return link["/"].split("/").find(segment => segment.startsWith("hq__"));
+  }
+
+  if(link["."] && link["."].container) {
+    return link["."].container;
+  }
+};
+
+exports.LinkTargetHash = LinkTargetHash;
+
 // Format NFT or listing result into consistent format
 const FormatNFTDetails = function(entry) {
   const isListing = !!entry.id;
@@ -70,7 +88,7 @@ const FormatNFTDetails = function(entry) {
 exports.FormatNFTDetails = FormatNFTDetails;
 
 
-const FormatNFTMetadata = function(nft) {
+const FormatNFTMetadata = function(walletClient, nft) {
   nft.formatted = true;
 
   // Surface relevant details to top level
@@ -105,10 +123,13 @@ const FormatNFTMetadata = function(nft) {
 
         let embedUrl = new URL("https://embed.v3.contentfabric.io");
         embedUrl.searchParams.set("p", "");
-        embedUrl.searchParams.set("net", rootStore.network === "demo" ? "demo" : "main");
-        embedUrl.searchParams.set("ath", rootStore.authToken);
+        embedUrl.searchParams.set("net", walletClient.network === "demo" ? "demo" : "main");
 
-        if(mediaType === "video") {
+        if(media.requires_permissions) {
+          embedUrl.searchParams.set("ath", walletClient.AuthToken());
+        }
+
+        if(["video", "audio"].includes(mediaType)) {
           embedUrl.searchParams.set("vid", LinkTargetHash(media.media_link));
           embedUrl.searchParams.set("ct", "h");
           embedUrl.searchParams.set("ap", "");
@@ -123,6 +144,7 @@ const FormatNFTMetadata = function(nft) {
           embed_url: embedUrl.toString()
         };
       } catch(error) {
+        walletClient.Log(error, true);
         return media;
       }
     });
@@ -134,8 +156,7 @@ const FormatNFTMetadata = function(nft) {
       if(nft.metadata.pack_options && nft.metadata.pack_options[key]) {
         let embedUrl = new URL("https://embed.v3.contentfabric.io");
         embedUrl.searchParams.set("p", "");
-        embedUrl.searchParams.set("net", rootStore.network === "demo" ? "demo" : "main");
-        embedUrl.searchParams.set("ath", rootStore.authToken || rootStore.staticToken);
+        embedUrl.searchParams.set("net", walletClient.network === "demo" ? "demo" : "main");
         embedUrl.searchParams.set("vid", LinkTargetHash(nft.metadata.pack_options[key]));
         embedUrl.searchParams.set("ap", "");
 
@@ -155,27 +176,11 @@ const FormatNFTMetadata = function(nft) {
 
 exports.FormatNFTMetadata = FormatNFTMetadata;
 
-exports.FormatNFT = function (item) {
-  return FormatNFTMetadata(FormatNFTDetails(item));
+exports.FormatNFT = function (walletClient, item) {
+  return FormatNFTMetadata(walletClient, FormatNFTDetails(item));
 };
 
 
-exports.LinkTargetHash = function(link) {
-  if(!link) { return; }
-
-  if(link["."] && link["."].source) {
-    return link["."].source;
-  }
-
-  if(link["/"] && link["/"].startsWith("/qfab/")) {
-    return link["/"].split("/").find(segment => segment.startsWith("hq__"));
-  }
-
-  if(link["."] && link["."].container) {
-    return link["."].container;
-  }
-};
-
 // https://stackoverflow.com/questions/4068373/center-a-popup-window-on-screen
 const Popup = ({url, title, w, h}) => {
   // Fixes dual-screen position

package/src/walletClient/index.js

@@ -1,6 +1,7 @@
 const {ElvClient} = require("../ElvClient");
 const Configuration = require("./Configuration");
 const {LinkTargetHash, FormatNFT, ActionPopup} = require("./Utils");
+const HTTPClient = require("../HttpClient");
 const UrlJoin = require("url-join");
 const Utils = require("../Utils");
 const Ethers = require("ethers");
@@ -15,7 +16,9 @@ const embedded = inBrowser && window.top !== window.self;
  * See the Modules section on the sidebar for all client methods unrelated to login and authorization
  */
 class ElvWalletClient {
-  constructor({client, network, mode, marketplaceInfo, storeAuthToken}) {
+  constructor({appId, client, network, mode, marketplaceInfo, storeAuthToken}) {
+    this.appId = appId;
+
     this.client = client;
     this.loggedIn = false;
 
@@ -33,6 +36,9 @@ class ElvWalletClient {
     this.availableMarketplacesById = {};
     this.marketplaceHashes = {};
 
+    this.stateStoreUrls = Configuration[network].stateStoreUrls;
+    this.stateStoreClient = new HTTPClient({uris: this.stateStoreUrls});
+
     // Caches
     this.cachedMarketplaces = {};
     this.cachedCSS = {};
@@ -60,8 +66,10 @@ class ElvWalletClient {
    *
    * Specify tenantSlug and marketplaceSlug to automatically associate this tenant with a particular marketplace.
    *
+   *
    * @methodGroup Initialization
    * @namedParams
+   * @param {string} appId - A string identifying your app. This is used for namespacing user profile data.
    * @param {string} network=main - Name of the Fabric network to use (`main`, `demo`)
    * @param {string} mode=production - Environment to use (`production`, `staging`)
    * @param {Object=} marketplaceParams - Marketplace parameters
@@ -70,6 +78,7 @@ class ElvWalletClient {
    * @returns {Promise<ElvWalletClient>}
    */
   static async Initialize({
+    appId="general",
     network="main",
     mode="production",
     marketplaceParams,
@@ -86,6 +95,7 @@ class ElvWalletClient {
     const client = await ElvClient.FromNetworkName({networkName: network, assumeV3: true});
 
     const walletClient = new ElvWalletClient({
+      appId,
       client,
       network,
       mode,
@@ -217,6 +227,9 @@ class ElvWalletClient {
   /**
    * Direct the user to the Eluvio Media Wallet login page.
    *
+   * For redirect login, the authorization token will be included in the URL parameters of the callbackUrl. Simply re-initialize the wallet client and it will authorize with this token,
+   * or you can retrieve the parameter (`elvToken`) yourself and use it in the <a href="#Authenticate">Authenticate</a> method.
+   *
    * <b>NOTE:</b> The domain of the opening window (popup flow) or domain of the `callbackUrl` (redirect flow) MUST be allowed in the metadata of the specified marketplace.
    *
    * @methodGroup Login
@@ -744,20 +757,29 @@ class ElvWalletClient {
     priceRange,
     tokenIdRange,
     capLimit,
+    userAddress,
     sellerAddress,
     lastNDays=-1,
+    includeCheckoutLocked=false,
     start=0,
     limit=50
   }={}) {
     collectionIndexes = (collectionIndexes || []).map(i => parseInt(i));
 
     let params = {
-      sort_by: sortBy,
-      sort_descending: sortDesc,
       start,
-      limit
+      limit,
+      sort_descending: sortDesc
     };
 
+    if(mode !== "leaderboard") {
+      params.sort_by = sortBy;
+    }
+
+    if(mode.includes("listings") && includeCheckoutLocked) {
+      params.checkout = true;
+    }
+
     let marketplaceInfo, marketplace;
     if(marketplaceParams) {
       marketplaceInfo = await this.MarketplaceInfo({marketplaceParams});
@@ -772,6 +794,8 @@ class ElvWalletClient {
 
       if(sellerAddress) {
         filters.push(`seller:eq:${this.client.utils.FormatAddress(sellerAddress)}`);
+      } else if(userAddress && mode !== "owned") {
+        filters.push(`addr:eq:${this.client.utils.FormatAddress(userAddress)}`);
       }
 
       if(marketplace && collectionIndexes.length >= 0) {
@@ -798,7 +822,7 @@ class ElvWalletClient {
             }
           });
         });
-      } else if(mode !== "owned" && marketplaceInfo || tenantId) {
+      } else if(marketplaceInfo || tenantId) {
         filters.push(`tenant:eq:${marketplaceInfo ? marketplaceInfo.tenantId : tenantId}`);
       }
 
@@ -813,11 +837,10 @@ class ElvWalletClient {
           filters.push(`token:eq:${tokenId}`);
         }
       } else if(filter) {
-        if(mode.includes("listing")) {
+        if(mode === "listing") {
           filters.push(`nft/display_name:eq:${filter}`);
         } else if(mode === "owned") {
-          filters.push(`meta:@>:{"display_name":"${filter}"}`);
-          params.exact = false;
+          filters.push(`meta/display_name:eq:${filter}`);
         } else {
           filters.push(`name:eq:${filter}`);
         }
@@ -880,12 +903,7 @@ class ElvWalletClient {
       let path;
       switch(mode) {
         case "owned":
-          path = UrlJoin("as", "wlt", "nfts");
-
-          if(marketplaceInfo) {
-            path = UrlJoin("as", "wlt", "nfts", marketplaceInfo.tenantId);
-          }
-
+          path = UrlJoin("as", "wlt", userAddress || this.UserAddress());
           break;
 
         case "listings":
@@ -912,6 +930,10 @@ class ElvWalletClient {
           path = UrlJoin("as", "mkt", "stats", "sold");
           filters.push("seller:co:0x");
           break;
+
+        case "leaderboard":
+          path = UrlJoin("as", "wlt", "leaders");
+          break;
       }
 
       if(filters.length > 0) {
@@ -932,10 +954,7 @@ class ElvWalletClient {
         await this.client.authClient.MakeAuthServiceRequest({
           path,
           method: "GET",
-          queryParams: params,
-          headers: mode === "owned" ?
-            { Authorization: `Bearer ${this.AuthToken()}` } :
-            {}
+          queryParams: params
         })
       ) || [];
 
@@ -946,7 +965,7 @@ class ElvWalletClient {
           total: paging.total,
           more: paging.total > start + limit
         },
-        results: (contents || []).map(item => ["owned", "listings"].includes(mode) ? FormatNFT(item) : item)
+        results: (contents || []).map(item => ["owned", "listings"].includes(mode) ? FormatNFT(this, item) : item)
       };
     } catch(error) {
       if(error.status && error.status.toString() === "404") {
@@ -1029,5 +1048,6 @@ class ElvWalletClient {
 }
 
 Object.assign(ElvWalletClient.prototype, require("./ClientMethods"));
+Object.assign(ElvWalletClient.prototype, require("./Profile"));
 
 exports.ElvWalletClient = ElvWalletClient;