PotLock · Ebube111 · Jun 20, 2025 · Jun 20, 2025 · Jun 25, 2025 · Jun 26, 2025
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -81,6 +81,8 @@
     "linktree",
     "localnet",
     "METAPOOL",
+    "Metaverse",
+    "Mochi",
     "mpdao",
     "mpdaovoting",
     "Multicall",

@@ -1,7 +1,7 @@
 {
-  "name": "@potlock/next",
+  "name": "@potlock/frontend",
   "description": "Decentralized funding stack for public goods",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "packageManager": "yarn@1.22.22",
   "private": true,
   "type": "module",
@@ -75,6 +75,10 @@
     "@rematch/persist": "^2.1.2",
     "@tanstack/react-table": "^8.20.5",
     "@tanstack/react-virtual": "^3.11.0",
+    "@tiptap/core": "^2.23.0",
+    "@tiptap/extension-link": "^2.23.0",
+    "@tiptap/react": "^2.23.0",
+    "@tiptap/starter-kit": "^2.23.0",
     "@uidotdev/usehooks": "^2.4.1",
     "@unocss/reset": "^0.60.4",
     "@web3modal/wagmi": "^5.1.10",
@@ -161,4 +165,4 @@
     "vite-tsconfig-paths": "^4.3.2",
     "vitest": "^1.6.0"
   }
-}
+}
diff --git a/src/common/_config/production.env-config.ts b/src/common/_config/production.env-config.ts
@@ -65,7 +65,7 @@ export const envConfig: EnvConfig = {
     [FeatureId.ProfileConfiguration]: {
       id: FeatureId.ProfileConfiguration,
       name: "Profile configuration",
-      isEnabled: false,
+      isEnabled: true,
     },
 
     [FeatureId.FtDonation]: {
@@ -85,5 +85,11 @@ export const envConfig: EnvConfig = {
       name: "Direct native token donation",
       isEnabled: true,
     },
+
+    [FeatureId.Cart]: {
+      id: FeatureId.Cart,
+      name: "Cart",
+      isEnabled: false,
+    },
   },
 };
diff --git a/src/common/_config/staging.env-config.ts b/src/common/_config/staging.env-config.ts
@@ -65,7 +65,7 @@ export const envConfig: EnvConfig = {
     [FeatureId.ProfileConfiguration]: {
       id: FeatureId.ProfileConfiguration,
       name: "Profile configuration",
-      isEnabled: false,
+      isEnabled: true,
     },
 
     [FeatureId.FtDonation]: {
@@ -85,6 +85,12 @@ export const envConfig: EnvConfig = {
       name: "Direct native token donation",
       isEnabled: true,
     },
+
+    [FeatureId.Cart]: {
+      id: FeatureId.Cart,
+      name: "Cart",
+      isEnabled: false,
+    },
   },
 };
 

diff --git a/src/common/_config/test.env-config.ts b/src/common/_config/test.env-config.ts
@@ -83,5 +83,11 @@ export const envConfig: EnvConfig = {
       name: "Direct native token donation",
       isEnabled: true,
     },
+
+    [FeatureId.Cart]: {
+      id: FeatureId.Cart,
+      name: "Cart",
+      isEnabled: false,
+    },
   },
 };
diff --git a/src/common/api/coingecko/hooks.ts b/src/common/api/coingecko/hooks.ts
@@ -1,15 +1,15 @@
 import useSWR from "swr";
 
-import { CONTRACT_SWR_CONFIG, NATIVE_TOKEN_ID } from "@/common/constants";
-import type { WithDisabled } from "@/common/types";
+import { NATIVE_TOKEN_ID } from "@/common/constants";
+import type { ConditionalActivation } from "@/common/types";
 
 import { client } from "./client";
 
 export const useNativeTokenUsdPrice = (
-  { disabled }: WithDisabled | undefined = { disabled: false },
+  { enabled = true }: ConditionalActivation | undefined = { enabled: true },
 ) =>
   useSWR(
-    () => (disabled ? null : ["oneNativeTokenUsdPrice", NATIVE_TOKEN_ID.toLowerCase()]),
+    () => (!enabled ? null : ["oneNativeTokenUsdPrice", NATIVE_TOKEN_ID.toLowerCase()]),
 
     ([_queryKeyHead, tokenId]) =>
       client
@@ -18,5 +18,9 @@ export const useNativeTokenUsdPrice = (
           response.data[tokenId].usd.toString(),
         ),
 
-    CONTRACT_SWR_CONFIG,
+    {
+      revalidateIfStale: false,
+      revalidateOnFocus: false,
+      revalidateOnReconnect: false,
+    },
   );
@@ -93,7 +93,11 @@ export const useAccountListRegistrations = ({
   ConditionalActivation) => {
   const queryResult = generatedClient.useV1AccountsListRegistrationsRetrieve(accountId, params, {
     ...INDEXER_CLIENT_CONFIG,
-    swr: { enabled },
+
+    swr: {
+      enabled,
+      shouldRetryOnError: (err) => err.status !== 404,
+    },
   });
 
   return { ...queryResult, data: queryResult.data?.data };

diff --git a/src/common/api/intear-token-indexer/hooks.ts b/src/common/api/intear-token-indexer/hooks.ts
@@ -1,23 +1,34 @@
-import { ByTokenId, type WithDisabled } from "@/common/types";
+import { ByTokenId, type ConditionalActivation, type LiveUpdateParams } from "@/common/types";
 
 import * as generatedClient from "./internal/client.generated";
 import { REQUEST_CONFIG } from "./internal/config";
 
 /**
  * https://prices.intear.tech/swagger-ui/#/Token%20Prices/get_get_token_price
  */
-export const useTokenUsdPrice = ({ tokenId, disabled = false }: ByTokenId & WithDisabled) => {
+export const useTokenUsdPrice = ({
+  enabled = true,
+  live = false,
+  tokenId,
+}: ByTokenId & ConditionalActivation & LiveUpdateParams) => {
   const queryResult = generatedClient.useGetSuperPrecisePrice(
     { token_id: tokenId },
 
     {
       ...REQUEST_CONFIG,
 
       swr: {
-        enabled: !disabled,
+        enabled,
         shouldRetryOnError: (err) => err.status !== 404,
-        revalidateOnFocus: false,
-        revalidateIfStale: false,
+
+        ...(live
+          ? {}
+          : {
+              revalidateIfStale: false,
+              revalidateOnFocus: false,
+              revalidateOnMount: false,
+              revalidateOnReconnect: false,
+            }),
       },
     },
   );

diff --git a/src/common/api/near-social-indexer/hooks.ts b/src/common/api/near-social-indexer/hooks.ts
@@ -3,30 +3,19 @@ import useSWR from "swr";
 
 import { AccountId, ByAccountId, type ConditionalActivation } from "@/common/types";
 
-import { CLIENT_CONFIG, nearSocialIndexerClient } from "./client";
+import { CLIENT_CONFIG, nearSocialClient, nearSocialIndexerClient } from "./client";
 
 export const useFollowerAccountIds = ({
   enabled = true,
   accountId,
 }: ByAccountId & ConditionalActivation) =>
   useSWR(
-    ["useFollowerAccountIds", "/keys"],
+    [`*/graph/follow/${accountId}`],
 
-    ([_queryKeyHead, urlKey]) =>
+    (keys) =>
       !enabled
         ? undefined
-        : nearSocialIndexerClient
-            .post(urlKey, {
-              keys: [`*/graph/follow/${accountId}`],
-              options: { values_only: true },
-            })
-            .then(
-              (
-                response: AxiosResponse<
-                  Record<AccountId, { graph: { follow: { [key: AccountId]: boolean } } }>
-                >,
-              ) => Object.keys(response.data),
-            ),
+        : nearSocialClient.keys({ keys, valuesOnly: true }).then((result) => Object.keys(result)),
 
     CLIENT_CONFIG.swr,
   );

diff --git a/src/common/blockchains/near-protocol/hooks.ts b/src/common/blockchains/near-protocol/hooks.ts
@@ -1,13 +1,14 @@
 import type { AccountView } from "near-api-js/lib/providers/provider";
-import useSWR from "swr";
+import useSWR, { type SWRResponse } from "swr";
 
 import {
   CONTRACT_SWR_CONFIG,
+  IS_CLIENT,
   NATIVE_TOKEN_DECIMALS,
   NATIVE_TOKEN_ICON_URL,
   NATIVE_TOKEN_ID,
 } from "@/common/constants";
-import type { ByAccountId, WithDisabled } from "@/common/types";
+import type { ByAccountId, ConditionalActivation, LiveUpdateParams } from "@/common/types";
 
 import { nearRpc } from "./client";
 
@@ -18,9 +19,9 @@ export type NativeTokenMetadata = {
   decimals: number;
 };
 
-export const useNativeTokenMetadata = ({ disabled = false }: WithDisabled) =>
+export const useNativeTokenMetadata = ({ enabled = true }: ConditionalActivation) =>
   useSWR(
-    () => (disabled ? null : ["NativeTokenMetadata", NATIVE_TOKEN_ID]),
+    () => (!enabled ? null : ["NativeTokenMetadata", NATIVE_TOKEN_ID]),
 
     (_queryKeyHead) =>
       new Promise<NativeTokenMetadata>((resolve) =>
@@ -35,18 +36,29 @@ export const useNativeTokenMetadata = ({ disabled = false }: WithDisabled) =>
     CONTRACT_SWR_CONFIG,
   );
 
-export const useViewAccount = ({ disabled = false, ...params }: ByAccountId & WithDisabled) =>
+export const useViewAccount = ({
+  enabled = true,
+  live = false,
+  ...params
+}: ByAccountId & ConditionalActivation & LiveUpdateParams): SWRResponse<AccountView, Error> =>
   useSWR(
-    () => (disabled ? null : ["view_account", params.accountId]),
+    () => (!enabled || !IS_CLIENT ? null : ["view_account", params.accountId]),
 
     ([_queryKeyHead, accountId]) =>
-      nearRpc
-        .query<AccountView>({
-          request_type: "view_account",
-          account_id: accountId,
-          finality: "final",
-        })
-        .catch(() => undefined),
+      nearRpc.query<AccountView>({
+        request_type: "view_account",
+        account_id: accountId,
+        finality: "final",
+      }),
 
-    CONTRACT_SWR_CONFIG,
+    {
+      ...(live
+        ? {}
+        : {
+            revalidateIfStale: false,
+            revalidateOnFocus: false,
+            revalidateOnMount: false,
+            revalidateOnReconnect: false,
+          }),
+    },
   );
@@ -6,8 +6,9 @@ import type { SWRConfiguration } from "swr";
 
 import { NETWORK, PLATFORM_NAME } from "./_config";
 import { ChronologicalSortOrderVariant, type TokenId } from "./types";
+import { version as FRAMEWORK_VERSION } from "../../package.json";
 
-export { PLATFORM_NAME };
+export { PLATFORM_NAME, FRAMEWORK_VERSION };
 
 export const IS_CLIENT = typeof window !== "undefined";
 
@@ -28,6 +29,7 @@ export const APP_BOS_COUNTERPART_URL = "https://bos.potlock.org";
 export const APP_METADATA: Metadata & {
   title: string;
   description: NonNullable<Metadata["description"]>;
+  other: { version: string };
   manifest: NonNullable<Metadata["manifest"]>;
 
   openGraph: {
@@ -43,6 +45,7 @@ export const APP_METADATA: Metadata & {
 } = {
   title: PLATFORM_NAME,
   description: "Bringing public goods funding to the table, built on NEAR",
+  other: { version: FRAMEWORK_VERSION },
   manifest: "/manifest.json",
 
   icons: {
@@ -169,7 +172,7 @@ export const CONTRACT_SWR_CONFIG: SWRConfiguration = {
 };
 
 /**
- * @deprecated Use `useTokenAllowlist` hooks instead
+ * @deprecated Use `useFungibleTokenAllowlist` hooks instead
  */
 export const SUPPORTED_FTS: Record<
   string,
@@ -197,3 +200,13 @@ export const SUPPORTED_FTS: Record<
         .toFixed(decimals || 2),
   },
 };
+
+console.info(`
+  ___  ___ _____ _    ___   ___ _  __
+ | _ \\/ _ \\_   _| |  / _ \\ / __| |/ /
+ |  _/ (_) || | | |_| (_) | (__| ' < 
+ |_|  \\___/ |_| |____\\___/ \\___|_|\\_\\
+
+  version: ${FRAMEWORK_VERSION}
+
+`);
diff --git a/src/common/contracts/social-db/hooks.ts b/src/common/contracts/social-db/hooks.ts
@@ -1,19 +1,34 @@
 import useSWR from "swr";
 
 import { IS_CLIENT } from "@/common/constants";
-import type { ByAccountId, ConditionalActivation } from "@/common/types";
+import type { ByAccountId, ConditionalActivation, LiveUpdateParams } from "@/common/types";
 
 import * as contractClient from "./client";
 
 export const useSocialProfile = ({
   enabled = true,
+  live = false,
   accountId,
-}: ByAccountId & ConditionalActivation) =>
-  useSWR(["useSocialProfile", accountId], ([_queryKeyHead, account_id]) =>
-    !enabled || !IS_CLIENT
-      ? undefined
-      : contractClient
-          .getSocialProfile({ accountId: account_id })
-          //* Handling `null` response
-          .then((response) => response ?? undefined),
+}: ByAccountId & ConditionalActivation & LiveUpdateParams) =>
+  useSWR(
+    ["useSocialProfile", accountId],
+
+    ([_queryKeyHead, account_id]) =>
+      !enabled || !IS_CLIENT
+        ? undefined
+        : contractClient
+            .getSocialProfile({ accountId: account_id })
+            //* Handling `null` response
+            .then((response) => response ?? undefined),
+
+    {
+      ...(live
+        ? {}
+        : {
+            revalidateIfStale: false,
+            revalidateOnFocus: false,
+            revalidateOnMount: false,
+            revalidateOnReconnect: false,
+          }),
+    },
   );
diff --git a/src/common/contracts/tokens/fungible/client.ts b/src/common/contracts/tokens/fungible/client.ts
@@ -1,16 +1,16 @@
-import { naxiosInstance } from "@/common/blockchains/near-protocol/client";
+import { nearProtocolClient } from "@/common/blockchains/near-protocol";
 import type { AccountId, ByAccountId, ByTokenId } from "@/common/types";
 
 import type { FungibleTokenMetadata } from "./interfaces";
 
 export const ft_metadata = ({ tokenId }: ByTokenId) =>
-  naxiosInstance
+  nearProtocolClient.naxiosInstance
     .contractApi({ contractId: tokenId })
     .view<{}, FungibleTokenMetadata>("ft_metadata")
     .catch(() => undefined);
 
 export const ft_balance_of = ({ accountId, tokenId }: ByAccountId & ByTokenId) =>
-  naxiosInstance
+  nearProtocolClient.naxiosInstance
     .contractApi({ contractId: tokenId })
     .view<{ account_id: AccountId }, string>("ft_balance_of", {
       args: { account_id: accountId },