@mezo-org/passport 0.4.0-dev.2 → 0.4.0-dev.20

package/src/components/Dropdown/DisconnectedTrigger.tsx

@@ -0,0 +1,36 @@
+import { Button, ButtonProps, LogIn01, useStyletron } from "@mezo-org/mezo-clay"
+import React, { forwardRef } from "react"
+
+type DisconnectedTriggerProps = Omit<ButtonProps, "children"> & {
+  children: string
+}
+
+const DisconnectedTrigger = forwardRef<
+  HTMLButtonElement,
+  DisconnectedTriggerProps
+>((props, ref) => {
+  const { onClick, children, ...restProps } = props
+
+  const [, theme] = useStyletron()
+
+  return (
+    <Button
+      startEnhancer={
+        <LogIn01 color="currentColor" size={theme.sizing.scale600} />
+      }
+      overrides={{
+        Root: {
+          props: { ref },
+        },
+      }}
+      size="small"
+      shape="pill"
+      onClick={onClick}
+      {...restProps}
+    >
+      {children}
+    </Button>
+  )
+})
+
+export default DisconnectedTrigger

package/src/components/Dropdown/Dropdown.tsx

@@ -0,0 +1,124 @@
+import {
+  ButtonProps,
+  StatefulPopover,
+  StatefulPopoverProps,
+  useStyletron,
+} from "@mezo-org/mezo-clay"
+import { useConnectModal } from "@rainbow-me/rainbowkit"
+import React, { useEffect } from "react"
+import { useDisconnect } from "wagmi"
+import DefaultAvatar from "../../assets/DefaultAvatar"
+import useDropdownData, {
+  DropdownCryptoAsset,
+} from "../../hooks/useDropdownData"
+import useWalletAccount from "../../hooks/useWalletAccount"
+import ConnectedTrigger from "./ConnectedTrigger"
+import Content from "./Content"
+import DisconnectedTrigger from "./DisconnectedTrigger"
+import { useSignInWithWallet } from "../../hooks"
+
+export type DropdownProps = {
+  /** The callback to be called when the user clicks the sign-out button */
+  onSignOut?: () => void
+  /** The callback to be called when the user clicks the button in sign-in state */
+  onSignIn?: () => void
+  /** The set of EVM native assets to be displayed in the dropdown */
+  evmNativeAssets?: DropdownCryptoAsset<"tbtc" | "wbtc">[]
+  /** The set of Matsnet assets to be displayed in the dropdown */
+  matsnetAssets?: DropdownCryptoAsset<"mbtc" | "musd">[]
+  /** The props to be passed to the trigger button */
+  triggerProps?: {
+    signedIn?: Omit<ButtonProps, "onClick" | "size"> & {
+      size: "medium" | "large"
+    }
+    signedOut?: Omit<ButtonProps, "onClick">
+  }
+} & Omit<StatefulPopoverProps, "children" | "content">
+
+/**
+ * Passport Dropdown component that displays user's wallet and assets information.
+ * @param {DropdownProps} props - Component props.
+ * @returns {JSX.Element}
+ */
+export function Dropdown(props: DropdownProps) {
+  const {
+    placement = "bottomRight",
+    animateOutTime = 120,
+    onSignIn,
+    onSignOut,
+    evmNativeAssets,
+    matsnetAssets,
+    overrides,
+    triggerProps,
+    ...restProps
+  } = props
+
+  const [, theme] = useStyletron()
+
+  const dropdownData = useDropdownData({ evmNativeAssets, matsnetAssets })
+
+  const { openConnectModal } = useConnectModal()
+
+  const { isConnected } = useWalletAccount()
+
+  const { signInWithWalletAsync, isPending } = useSignInWithWallet()
+
+  const { disconnectAsync } = useDisconnect()
+
+  useEffect(() => {
+    if (onSignIn) return
+
+    const handleSignIn = async () => {
+      if (!isConnected) return
+
+      try {
+        await signInWithWalletAsync()
+      } catch (error) {
+        await disconnectAsync()
+      }
+    }
+
+    handleSignIn()
+  }, [disconnectAsync, isConnected, onSignIn, signInWithWalletAsync])
+
+  if (!dropdownData || !isConnected) {
+    return (
+      <DisconnectedTrigger
+        // If connect wallet flow is not provided it fallbacks to RainbowKit's
+        // connect modal
+        onClick={onSignIn || openConnectModal}
+        isLoading={isPending}
+        {...triggerProps?.signedOut}
+      >
+        Sign in
+      </DisconnectedTrigger>
+    )
+  }
+
+  return (
+    <StatefulPopover
+      content={<Content data={dropdownData} onSignOut={onSignOut} />}
+      placement={placement}
+      animateOutTime={animateOutTime}
+      overrides={{
+        ...overrides,
+        Body: {
+          ...overrides?.Body,
+          style: {
+            width: "396px",
+            borderRadius: theme.borders.radius500,
+            boxShadow: theme.lighting.shadow500,
+            overflow: "hidden",
+            ...overrides?.Body?.style,
+          },
+        },
+      }}
+      {...restProps}
+    >
+      <ConnectedTrigger
+        avatar={<DefaultAvatar />}
+        {...triggerProps?.signedIn}
+      />
+    </StatefulPopover>
+  )
+}

package/src/components/Dropdown/NestedViewLayout.tsx

@@ -0,0 +1,75 @@
+import {
+  ArrowLeft,
+  Block,
+  ButtonIcon,
+  LabelMedium,
+  useStyletron,
+} from "@mezo-org/mezo-clay"
+import React, { ReactNode, useCallback } from "react"
+import useDropdownStore, { DropdownView } from "../../stores/dropdownStore"
+
+const getHeaderTitle = (view: DropdownView) => {
+  const titleMap: Partial<Record<DropdownView, string>> = {
+    [DropdownView.RECEIVE]: "Receive",
+  }
+  return titleMap[view]!
+}
+
+type NestedViewLayoutProps = {
+  children: ReactNode
+}
+
+function NestedViewLayout(props: NestedViewLayoutProps) {
+  const { children, ...restProps } = props
+
+  const currentView = useDropdownStore((state) => state.view)
+  const setView = useDropdownStore((state) => state.setView)
+  const isNested = useDropdownStore((state) => state.isNestedView())
+
+  const [, theme] = useStyletron()
+
+  const handleOnButtonClick = useCallback(() => {
+    setView(DropdownView.ROOT)
+  }, [setView])
+
+  return (
+    <Block
+      display="flex"
+      flexDirection="column"
+      minHeight="588px"
+      padding={theme.sizing.scale700}
+      paddingTop={0}
+      {...restProps}
+    >
+      <Block
+        display="flex"
+        alignItems="center"
+        paddingTop={theme.sizing.scale600}
+        paddingBottom={theme.sizing.scale600}
+        marginBottom={theme.sizing.scale300}
+      >
+        <ButtonIcon
+          onClick={handleOnButtonClick}
+          shape="circle"
+          size="small"
+          overrides={{
+            BaseButton: {
+              style: {
+                background: theme.colors.backgroundPrimary,
+                marginRight: isNested ? theme.sizing.scale300 : undefined,
+              },
+            },
+          }}
+        >
+          <ArrowLeft size={theme.sizing.scale700} />
+        </ButtonIcon>
+
+        <LabelMedium>{getHeaderTitle(currentView)}</LabelMedium>
+      </Block>
+
+      {children}
+    </Block>
+  )
+}
+
+export default NestedViewLayout

package/src/components/Dropdown/README.md

@@ -0,0 +1,55 @@
+# Passport Dropdown component
+
+This component is a layer of interaction with Passport API in form of Dropdown
+component. It allows to establish the session and interact with the API.
+
+## Props
+
+- `onSignIn` (`() => void`) - The callback to be executed on trigger click when
+  the state is disconnected. It's optional since by default it triggers the
+  [Rainbow Kit's wallet connection modal](https://www.rainbowkit.com/docs/modal-hooks).
+  If the callback is not provided it will automatically establish the Passport
+  Session. If not, you have to handle it manually using `useSignInWithWallet`
+  hook. - **optional**
+- `onSignOut` (`() => void`) - The callback to be executed on click of the
+  **Sign out** button. It's optional since by default it disconnects the current
+  wallet connector and closes the Passport session. - **optional**
+- `evmNativeAssets` (`Asset<"tbtc" | "wbtc">[]`) - Array of Matsnet assets. -
+  **optional**
+- `matsnetAssets` (`Asset<"mbtc" | "musd">[]`) - Array of Matsnet assets. -
+  **optional**
+  ```ts
+  type Asset = {
+    type: "btc" | "tbtc" | "wbtc" | "mbtc" | "musd"
+    decimals: number
+    amount: {
+      token: bigint
+      usd: number
+    }
+  }
+  ```
+- `triggerProps.signedIn` (`ButtonProps`) - Props to be passed to the trigger
+  button in signed-in state.
+- `triggerProps.signedOut` (`ButtonProps`) - Props to be passed to the trigger
+  button in signed-out state
+
+Besides that, component allows
+[Clay's `StatefulPopover` props](https://baseweb.design/components/popover/)
+excluding the `children` and `content`.
+
+## Overview
+
+The component has two distinguishable states - disconnected and connected. In
+disconnected state the component offers the trigger to initiate the connection
+flow. It can be fully customizable by providing your own one. As long as it's
+compliant with Wagmi/RainbowKit it will work. Component will automatically
+detect connected connector and change the state of component displaying the
+avatar thumbnail instead of button.
+
+Component has the following features:
+
+- displays wallet address that can be copied,
+- displays total balance in USD,
+- displays partial balances per asset with token amounts and USD conversions,
+- serves _Log out_ button which disconnects the wallet connector and closes
+  Passport API session.

package/src/components/Dropdown/Receive/Receive.tsx

@@ -0,0 +1,119 @@
+import {
+  Block,
+  Button,
+  LabelMedium,
+  MonoLabelXSmall,
+  ParagraphSmall,
+  useStyletron,
+} from "@mezo-org/mezo-clay"
+import React, { useCallback, useState } from "react"
+import { useCopyToClipboard } from "usehooks-ts"
+import { QRCodeSVG } from "qrcode.react"
+import NestedViewLayout from "../NestedViewLayout"
+import { getAddressExplorerUrl } from "../../../utils/address"
+import { usePassportContext } from "../../../hooks/usePassportContext"
+import useWalletAccount from "../../../hooks/useWalletAccount"
+
+type ReceiveProps = {
+  address: string
+}
+
+function Receive(props: ReceiveProps) {
+  const { address } = props
+
+  const { environment } = usePassportContext()
+
+  const blockExplorerUrl = getAddressExplorerUrl(
+    address,
+    "mezo",
+    environment === "testnet",
+  )
+
+  const [, theme] = useStyletron()
+
+  const [, copy] = useCopyToClipboard()
+  const [isCopiedMessageVisible, setIsCopiedMessageVisible] = useState(false)
+  const handleCopyAddress = useCallback(() => {
+    copy(address)
+    setIsCopiedMessageVisible(true)
+
+    setTimeout(() => {
+      setIsCopiedMessageVisible(false)
+    }, 2000)
+  }, [copy, address])
+
+  const { networkFamily } = useWalletAccount()
+
+  return (
+    <NestedViewLayout>
+      <LabelMedium>Receive assets on Mezo</LabelMedium>
+
+      <ParagraphSmall
+        marginTop={theme.sizing.scale300}
+        marginBottom={theme.sizing.scale600}
+        color={theme.colors.contentTertiary}
+      >
+        {networkFamily === "bitcoin" ? (
+          <>
+            Mezo automatically created a smart account that&apos;s fully
+            controlled by your connected Bitcoin wallet. Use this address to
+            receive assets on Mezo.
+          </>
+        ) : (
+          <>
+            Your connected wallet address is your Mezo address. Use this address
+            to receive assets on Mezo.
+          </>
+        )}
+      </ParagraphSmall>
+
+      <Block
+        as={QRCodeSVG}
+        value={address}
+        flex={1}
+        overrides={{
+          Block: {
+            style: {
+              aspectRatio: 1,
+              width: "fit-content",
+              margin: "0 auto",
+            },
+          },
+        }}
+      />
+
+      <MonoLabelXSmall
+        marginTop={theme.sizing.scale800}
+        marginBottom={theme.sizing.scale800}
+        overrides={{
+          Block: {
+            style: {
+              textAlign: "center",
+            },
+          },
+        }}
+      >
+        {address}
+      </MonoLabelXSmall>
+
+      <Button
+        onClick={handleCopyAddress}
+        overrides={{
+          BaseButton: {
+            style: {
+              marginBottom: theme.sizing.scale400,
+            },
+          },
+        }}
+      >
+        {isCopiedMessageVisible ? "Copied!" : "Copy Mezo Address"}
+      </Button>
+
+      <Button kind="secondary" $as="a" href={blockExplorerUrl} target="_blank">
+        View Explorer
+      </Button>
+    </NestedViewLayout>
+  )
+}
+
+export default Receive

package/src/components/Dropdown/Root/AccountAddressActions.tsx

@@ -0,0 +1,101 @@
+import {
+  ArrowNarrowLeft,
+  Block,
+  Button,
+  ButtonProps,
+  Cube01,
+  useStyletron,
+} from "@mezo-org/mezo-clay"
+import React, { useCallback } from "react"
+import { usePassportContext } from "../../../hooks/usePassportContext"
+import { getAddressExplorerUrl } from "../../../utils/address"
+import useDropdownStore, { DropdownView } from "../../../stores/dropdownStore"
+
+type AccountAddressActionsProps = {
+  address: string
+}
+
+const buttonStartEnhancerSize = 12
+
+const commonButtonProps: Partial<ButtonProps> = {
+  kind: "secondary",
+  size: "xsmall",
+  overrides: {
+    BaseButton: {
+      style: {
+        flex: 1,
+      },
+    },
+    StartEnhancer: {
+      style: {
+        stroke: "currentColor",
+      },
+    },
+  },
+}
+
+export default function AccountAddressActions(
+  props: AccountAddressActionsProps,
+) {
+  const { address } = props
+
+  const [, theme] = useStyletron()
+
+  const { environment } = usePassportContext()
+  const blockExplorerUrl = getAddressExplorerUrl(
+    address,
+    "mezo",
+    environment === "testnet",
+  )
+
+  const setDropdownView = useDropdownStore((state) => state.setView)
+
+  const handleReceiveClick = useCallback(() => {
+    setDropdownView(DropdownView.RECEIVE)
+  }, [setDropdownView])
+
+  return (
+    <Block
+      display="flex"
+      alignItems="center"
+      backgroundColor="transparent"
+      marginBottom={theme.sizing.scale600}
+      overrides={{
+        Block: {
+          style: {
+            gap: theme.sizing.scale600,
+          },
+        },
+      }}
+    >
+      <Button
+        startEnhancer={<Cube01 size={buttonStartEnhancerSize} />}
+        $as="a"
+        href={blockExplorerUrl}
+        target="_blank"
+        {...commonButtonProps}
+      >
+        View Mezo Explorer
+      </Button>
+
+      <Button
+        onClick={handleReceiveClick}
+        startEnhancer={
+          <ArrowNarrowLeft
+            size={buttonStartEnhancerSize}
+            overrides={{
+              Svg: {
+                style: {
+                  transform: "rotate(-45deg)",
+                },
+              },
+            }}
+          />
+        }
+        {...commonButtonProps}
+      >
+        Receive
+      </Button>
+    </Block>
+  )
+}

package/src/components/Dropdown/Root/AccountAssets.tsx

@@ -0,0 +1,108 @@
+import {
+  Block,
+  LabelSmall,
+  ParagraphSmall,
+  useStyletron,
+} from "@mezo-org/mezo-clay"
+import React, { useMemo } from "react"
+import { CryptoAssetKey, getCryptoAsset } from "../../../utils/cryptoAssets"
+
+type AccountAssetsProps = {
+  label: string | React.ReactNode
+  assets: {
+    type: CryptoAssetKey
+    balance: string
+    balanceInUsd: string
+  }[]
+}
+
+export default function AccountAssets(props: AccountAssetsProps) {
+  const { label, assets } = props
+
+  const [, theme] = useStyletron()
+
+  const assetsData = useMemo(
+    () =>
+      assets.map((token) => {
+        const { name, symbol, icon } = getCryptoAsset(token.type)
+
+        return {
+          ...token,
+          icon,
+          label: name,
+          symbol,
+        }
+      }),
+    [assets],
+  )
+
+  const labelContent =
+    typeof label === "string" ? (
+      <ParagraphSmall margin={0} color={theme.colors.gray800}>
+        {label}
+      </ParagraphSmall>
+    ) : (
+      label
+    )
+
+  if (assetsData.length === 0) {
+    return null
+  }
+
+  return (
+    <Block padding={`0 ${theme.sizing.scale500}`}>
+      <Block margin={`${theme.sizing.scale400} 0`}>{labelContent}</Block>
+
+      <Block
+        as="ul"
+        marginBottom={theme.sizing.scale600}
+        padding={0}
+        display="flex"
+        flexDirection="column"
+        overrides={{
+          Block: {
+            style: {
+              gap: theme.sizing.scale100,
+            },
+          },
+        }}
+      >
+        {assetsData.map((asset) => (
+          <Block
+            as="li"
+            key={`${asset.type}-${asset.balance}`}
+            display="flex"
+            justifyContent="space-between"
+            alignItems="center"
+            margin={`${theme.sizing.scale100} 0`}
+          >
+            <asset.icon
+              size={theme.sizing.scale800}
+              overrides={{
+                Svg: {
+                  style: {
+                    marginRight: theme.sizing.scale500,
+                  },
+                },
+              }}
+            />
+
+            <Block flex={1}>
+              <LabelSmall margin={0}>{asset.label}</LabelSmall>
+              <ParagraphSmall margin={0} color={theme.colors.gray500}>
+                {asset.symbol}
+              </ParagraphSmall>
+            </Block>
+
+            <Block display="flex" alignItems="end" flexDirection="column">
+              <LabelSmall margin={0}>{asset.balance}</LabelSmall>
+              <ParagraphSmall margin={0} color={theme.colors.gray500}>
+                {asset.balanceInUsd}
+              </ParagraphSmall>
+            </Block>
+          </Block>
+        ))}
+      </Block>
+    </Block>
+  )
+}

package/src/components/Dropdown/Root/AccountBalance.tsx

@@ -0,0 +1,35 @@
+import {
+  Block,
+  HeadingSmall,
+  ParagraphSmall,
+  useStyletron,
+} from "@mezo-org/mezo-clay"
+import React from "react"
+
+type AccountBalanceProps = {
+  amount: string
+}
+
+export default function AccountBalance(props: AccountBalanceProps) {
+  const { amount } = props
+
+  const [, theme] = useStyletron()
+
+  return (
+    <Block
+      padding={theme.sizing.scale500}
+      overrides={{
+        Block: {
+          style: {
+            borderBottom: `1px solid ${theme.colors.backgroundPrimary}`,
+          },
+        },
+      }}
+    >
+      <ParagraphSmall margin={0} color={theme.colors.gray800}>
+        Available balance
+      </ParagraphSmall>
+      <HeadingSmall margin={0}>{amount}</HeadingSmall>
+    </Block>
+  )
+}