@mezo-org/passport 0.4.0-dev.0 → 0.4.0-dev.10

package/src/hooks/usePassportContext.ts

@@ -0,0 +1,11 @@
+import { useContext } from "react"
+import { PassportContext, PassportContextValue } from "../provider"
+
+export function usePassportContext(): PassportContextValue {
+  const passportContext = useContext(PassportContext)
+  if (!passportContext) {
+    throw new Error("usePassportContext must be used within PassportProvider!")
+  }
+
+  return passportContext
+}

package/src/hooks/usePortalApiClient.ts

@@ -0,0 +1,6 @@
+import { usePassportContext } from "./usePassportContext"
+
+export function usePortalApiClient() {
+  const { portalApiClient } = usePassportContext()
+  return portalApiClient
+}

package/src/hooks/useSignInWithDiscord.ts

@@ -0,0 +1,35 @@
+import { MutationOptions, useMutation } from "@tanstack/react-query"
+import { useCreateSession } from "./useCreateSession"
+import { useEnsureNoSessionAndFetchNonce } from "./useEnsureNoSessionAndFetchNonce"
+import type { AuthenticationProviderRedirectResponse } from "../api"
+
+function useSignInWithDiscord(
+  mutationOptions: Omit<
+    MutationOptions<AuthenticationProviderRedirectResponse>,
+    "mutationFn" | "mutationKey"
+  > = {},
+) {
+  const { ensureNoSessionAndFetchNonce } = useEnsureNoSessionAndFetchNonce()
+  const { createSessionAsync } = useCreateSession()
+
+  const { mutate, mutateAsync, ...signInMutationRestParameters } = useMutation({
+    mutationFn: async (): Promise<AuthenticationProviderRedirectResponse> => {
+      await ensureNoSessionAndFetchNonce()
+
+      return (await createSessionAsync({
+        type: "discord",
+      })) as AuthenticationProviderRedirectResponse
+      // ^ By passing type: "discord" we know for sure the return type is
+      // AuthenticationProviderRedirectResponse
+    },
+    ...mutationOptions,
+  })
+
+  return {
+    signInWithDiscord: mutate,
+    signInWithDiscordAsync: mutateAsync,
+    ...signInMutationRestParameters,
+  }
+}
+
+export { useSignInWithDiscord }

package/src/hooks/useSignInWithWallet.ts

@@ -0,0 +1,21 @@
+import { MutationOptions } from "@tanstack/react-query"
+import { useAuthenticateWithWallet } from "./useAuthenticateWithWallet"
+import type { Session } from "../api"
+
+function useSignInWithWallet(
+  mutationOptions: Omit<
+    MutationOptions<Session>,
+    "mutationFn" | "mutationKey"
+  > = {},
+) {
+  const { authenticateWithWallet, authenticateWithWalletAsync, ...rest } =
+    useAuthenticateWithWallet(false, mutationOptions)
+
+  return {
+    signInWithWallet: authenticateWithWallet,
+    signInWithWalletAsync: authenticateWithWalletAsync,
+    ...rest,
+  }
+}
+
+export { useSignInWithWallet }

package/src/hooks/useSignOut.ts

@@ -0,0 +1,35 @@
+import {
+  MutationOptions,
+  useMutation,
+  useQueryClient,
+} from "@tanstack/react-query"
+import { useAuthApiClient } from "./useAuthApiClient"
+import { QUERY_KEYS } from "./constants"
+import type { DeleteSessionResponse } from "../api"
+
+export function useSignOut(
+  mutationOptions: Omit<
+    MutationOptions<DeleteSessionResponse>,
+    "mutationFn" | "mutationKey"
+  > = {},
+) {
+  const queryClient = useQueryClient()
+  const authApiClient = useAuthApiClient()
+
+  const { onSuccess: customOnSuccess, ...restMutationOptions } = mutationOptions
+
+  const { mutate, mutateAsync, ...rest } = useMutation({
+    mutationFn: () => authApiClient.deleteSession(),
+    onSuccess: (data, variables, context) => {
+      queryClient.resetQueries({ queryKey: [QUERY_KEYS.SESSION] })
+      queryClient.resetQueries({
+        queryKey: [QUERY_KEYS.ACCOUNT, QUERY_KEYS.CURRENT],
+      })
+
+      if (customOnSuccess) customOnSuccess(data, variables, context)
+    },
+    ...restMutationOptions,
+  })
+
+  return { signOut: mutate, signOutAsync: mutateAsync, ...rest }
+}

package/src/hooks/useSignUpWithWallet.ts

@@ -0,0 +1,21 @@
+import { MutationOptions } from "@tanstack/react-query"
+import { useAuthenticateWithWallet } from "./useAuthenticateWithWallet"
+import type { Session } from "../api"
+
+function useSignUpWithWallet(
+  mutationOptions: Omit<
+    MutationOptions<Session>,
+    "mutationFn" | "mutationKey"
+  > = {},
+) {
+  const { authenticateWithWallet, authenticateWithWalletAsync, ...rest } =
+    useAuthenticateWithWallet(true, mutationOptions)
+
+  return {
+    signUpWithWallet: authenticateWithWallet,
+    signUpWithWalletAsync: authenticateWithWalletAsync,
+    ...rest,
+  }
+}
+
+export { useSignUpWithWallet }

package/src/hooks/useUpdateMezoId.ts

@@ -0,0 +1,33 @@
+import {
+  useQueryClient,
+  useMutation,
+  MutationOptions,
+  DefaultError,
+} from "@tanstack/react-query"
+import { useAuthApiClient } from "./useAuthApiClient"
+import { QUERY_KEYS } from "./constants"
+import type { UpdateMezoIdResponse } from "../api"
+
+export function useUpdateMezoId(
+  mutationOptions: Omit<
+    MutationOptions<UpdateMezoIdResponse, DefaultError, string>,
+    "mutationFn" | "mutationKey"
+  > = {},
+) {
+  const queryClient = useQueryClient()
+  const authApiClient = useAuthApiClient()
+
+  const { onSuccess: customOnSuccess, ...restMutationOptions } = mutationOptions
+
+  const { mutate, mutateAsync, ...rest } = useMutation({
+    mutationFn: (newMezoId: string) => authApiClient.updateMezoId(newMezoId),
+    onSuccess: (data, variables, context) => {
+      queryClient.resetQueries({ queryKey: [QUERY_KEYS.ACCOUNT] })
+
+      if (customOnSuccess) customOnSuccess(data, variables, context)
+    },
+    ...restMutationOptions,
+  })
+
+  return { updateMezoId: mutate, updateMezoIdAsync: mutateAsync, ...rest }
+}

package/src/hooks/useWalletAccount.ts

@@ -0,0 +1,53 @@
+import { OrangeKitBitcoinProvider } from "@mezo-org/orangekit"
+import { useQuery } from "@tanstack/react-query"
+import { useMemo } from "react"
+import { Address } from "viem"
+import { Connector, useAccount } from "wagmi"
+
+type UseWalletAccountReturn = {
+  address?: string | Address
+  isConnected: boolean
+  networkFamily: "bitcoin" | "evm"
+  connector?: Connector
+  chainId?: number
+}
+
+type OrangeKitConnector = {
+  getBitcoinProvider: () => OrangeKitBitcoinProvider
+}
+
+export default function useWalletAccount(): UseWalletAccountReturn {
+  const { address: evmAddress, connector, chainId } = useAccount()
+
+  const networkFamily = useMemo(
+    () => (connector?.type !== "orangekit" ? "evm" : "bitcoin"),
+    [connector],
+  )
+
+  const { data: btcData } = useQuery({
+    queryKey: [connector?.id],
+    queryFn: async () => {
+      const bitcoinProvider = (
+        connector as unknown as OrangeKitConnector
+      ).getBitcoinProvider()
+
+      const address = await bitcoinProvider.getAddress()
+      const balance = await bitcoinProvider.getBalance()
+
+      return {
+        address,
+        balance,
+      }
+    },
+  })
+
+  const { address: btcAddress } = btcData || {}
+
+  return {
+    address: networkFamily === "bitcoin" ? btcAddress : evmAddress,
+    isConnected: networkFamily === "bitcoin" ? !!btcAddress : !!evmAddress,
+    networkFamily,
+    connector,
+    chainId,
+  } as const
+}

package/src/index.ts

@@ -1,4 +1,6 @@
+export * from "./components"
 export * from "./config"
 export * from "./constants"
 export * from "./hooks"
+export * from "./provider"
 export * from "./wallet"

package/src/provider.ts

@@ -0,0 +1,50 @@
+import { createContext, createElement } from "react"
+import { AuthApiClient, PortalApiClient } from "./api"
+
+export interface PassportContextValue {
+  authApiClient: AuthApiClient
+  portalApiClient: PortalApiClient
+  environment?: Environment
+}
+
+export const PassportContext = createContext<PassportContextValue | undefined>(
+  undefined,
+)
+
+type Environment = "mainnet" | "testnet"
+
+type PassportProviderProps = {
+  children: React.ReactNode
+  // eslint-disable-next-line react/require-default-props
+  environment?: Environment
+  // eslint-disable-next-line react/require-default-props
+  authApiUrl?: string
+  // eslint-disable-next-line react/require-default-props
+  portalApiUrl?: string
+}
+
+export function PassportProvider({
+  environment,
+  authApiUrl,
+  portalApiUrl,
+  children,
+}: PassportProviderProps) {
+  if (environment && !["mainnet", "testnet"].includes(environment)) {
+    throw new Error("Wrong environment passed to PassportProvider.")
+  }
+
+  return createElement(
+    PassportContext.Provider,
+    {
+      value: {
+        authApiClient: new AuthApiClient(environment ?? "mainnet", authApiUrl),
+        portalApiClient: new PortalApiClient(
+          environment ?? "mainnet",
+          portalApiUrl,
+        ),
+        environment,
+      },
+    },
+    children,
+  )
+}

package/src/utils/address.test.ts

@@ -0,0 +1,38 @@
+import { getAddressExplorerUrl, trimAddress } from "./address"
+
+describe("trimAddress", () => {
+  it("returns full address if length is less than 11", () => {
+    expect(trimAddress("0x12345")).toBe("0x12345")
+  })
+
+  it("returns trimmed address if length is 11 or more", () => {
+    const input = "0x123456789abcdef"
+    const expected = "0x123...bcdef"
+    expect(trimAddress(input)).toBe(expected)
+  })
+})
+
+describe("getAddressExplorerUrl", () => {
+  const btcAddress = "bc1qxyz123"
+  const evmAddress = "0x1234567890abcdef"
+
+  it("returns correct mainnet Bitcoin explorer URL", () => {
+    const url = getAddressExplorerUrl(btcAddress, "bitcoin", false)
+    expect(url).toBe(`https://mempool.space/address/${btcAddress}`)
+  })
+
+  it("returns correct testnet Bitcoin explorer URL", () => {
+    const url = getAddressExplorerUrl(btcAddress, "bitcoin", true)
+    expect(url).toBe(`https://mempool.space/testnet/address/${btcAddress}`)
+  })
+
+  it("returns correct mainnet EVM explorer URL", () => {
+    const url = getAddressExplorerUrl(evmAddress, "evm", false)
+    expect(url).toBe(`https://etherscan.io/address/${evmAddress}`)
+  })
+
+  it("returns correct testnet EVM explorer URL", () => {
+    const url = getAddressExplorerUrl(evmAddress, "evm", true)
+    expect(url).toBe(`https://sepolia.etherscan.io/address/${evmAddress}`)
+  })
+})

package/src/utils/address.ts

@@ -0,0 +1,43 @@
+/**
+ * Trims the address to the first 5 and last 5 characters.
+ * @param address The address to trim.
+ * @returns The trimmed address.
+ */
+export function trimAddress(address: string): string {
+  if (address.length < 11) return address
+
+  const trimmedAddress = `${address.slice(0, 5)}...${address.slice(-5)}`
+
+  return trimmedAddress
+}
+
+const MAINNET_EXPLORER_URLS: Record<"bitcoin" | "evm", string> = {
+  bitcoin: "https://mempool.space",
+  evm: "https://etherscan.io",
+}
+
+const TESTNET_EXPLORER_URLS: Record<"bitcoin" | "evm", string> = {
+  bitcoin: "https://mempool.space/testnet",
+  evm: "https://sepolia.etherscan.io",
+}
+
+/**
+ * Get the URL of the block explorer page for an address.
+ * @param address - The address to link to.
+ * @param chainType - The chain type of the address.
+ * @param isTestnet - Whether the address is on testnet.
+ * @returns The URL of the block explorer page for the address.
+ */
+export function getAddressExplorerUrl(
+  address: string,
+  chainType: "bitcoin" | "evm",
+  isTestnet: boolean,
+) {
+  const EXPLORER_URLS = isTestnet
+    ? TESTNET_EXPLORER_URLS
+    : MAINNET_EXPLORER_URLS
+  const baseUrl = EXPLORER_URLS[chainType]
+  const endpoint = `address/${address}`
+
+  return `${baseUrl}/${endpoint}`
+}

package/src/utils/cryptoAssets.test.ts

@@ -0,0 +1,61 @@
+import {
+  BitcoinCircle,
+  EthCircle,
+  MUsdCircle,
+  TBtcCircle,
+} from "@mezo-org/mezo-clay"
+import { getCryptoAsset } from "./cryptoAssets"
+
+// FIXME: Test fails if run in full suite (pnpm test) but works when run in isolation (pnpm test cryptoAssets)
+
+describe("getCryptoAsset", () => {
+  it("returns the correct asset for 'btc'", () => {
+    const asset = getCryptoAsset("btc")
+    expect(asset.name).toBe("Bitcoin")
+    expect(asset.symbol).toBe("BTC")
+    expect(asset.decimals).toBe(8)
+    expect(asset.icon).toBe(BitcoinCircle)
+  })
+
+  it("returns the correct asset for 'eth'", () => {
+    const asset = getCryptoAsset("eth")
+    expect(asset.name).toBe("Ethereum")
+    expect(asset.symbol).toBe("ETH")
+    expect(asset.decimals).toBe(18)
+    expect(asset.icon).toBe(EthCircle)
+  })
+
+  it("returns the correct asset for 'tbtc'", () => {
+    const asset = getCryptoAsset("tbtc")
+    expect(asset.name).toBe("Threshold Bitcoin")
+    expect(asset.symbol).toBe("tBTC")
+    expect(asset.decimals).toBe(18)
+    expect(asset.icon).toBe(TBtcCircle)
+  })
+
+  it("returns the correct asset for 'wbtc'", () => {
+    const asset = getCryptoAsset("wbtc")
+    expect(asset.name).toBe("Wrapped Bitcoin")
+    expect(asset.symbol).toBe("wBTC")
+    expect(asset.decimals).toBe(8)
+    // FIXME: Test should expect the exact icon component
+    expect(asset.icon).toEqual(expect.any(Function))
+  })
+
+  it("returns the correct asset for 'mbtc'", () => {
+    const asset = getCryptoAsset("mbtc")
+    expect(asset.name).toBe("Matsnet Bitcoin")
+    expect(asset.symbol).toBe("BTC")
+    expect(asset.decimals).toBe(18)
+    // FIXME: Test should expect the exact icon component
+    expect(asset.icon).toEqual(expect.any(Function))
+  })
+
+  it("returns the correct asset for 'musd'", () => {
+    const asset = getCryptoAsset("musd")
+    expect(asset.name).toBe("Mezo USD")
+    expect(asset.symbol).toBe("MUSD")
+    expect(asset.decimals).toBe(18)
+    expect(asset.icon).toBe(MUsdCircle)
+  })
+})

package/src/utils/cryptoAssets.ts

@@ -0,0 +1,93 @@
+import {
+  BitcoinCircle,
+  EthCircle,
+  IconProps,
+  MUsdCircle,
+  TBtcCircle,
+} from "@mezo-org/mezo-clay"
+import { createElement, FC } from "react"
+
+export type CryptoAssetKey = "btc" | "eth" | "tbtc" | "wbtc" | "mbtc" | "musd"
+
+export type CryptoAsset = {
+  name: string
+  symbol: string
+  icon: FC<IconProps>
+  decimals: number
+}
+
+const CRYPTO_ASSETS: Record<CryptoAssetKey, CryptoAsset> = {
+  btc: {
+    name: "Bitcoin",
+    symbol: "BTC",
+    icon: BitcoinCircle,
+    decimals: 8,
+  },
+  eth: {
+    name: "Ethereum",
+    symbol: "ETH",
+    icon: EthCircle,
+    decimals: 18,
+  },
+  tbtc: {
+    name: "Threshold Bitcoin",
+    symbol: "tBTC",
+    icon: TBtcCircle,
+    decimals: 18,
+  },
+  wbtc: {
+    name: "Wrapped Bitcoin",
+    symbol: "wBTC",
+    icon: (props) =>
+      createElement(BitcoinCircle, {
+        ...props,
+        symbolColor: "#FF8A00",
+        color: "#000000",
+      }),
+    decimals: 8,
+  },
+  mbtc: {
+    name: "Matsnet Bitcoin",
+    symbol: "BTC",
+    icon: (props) =>
+      createElement(BitcoinCircle, {
+        ...props,
+        symbolColor: "#000000",
+        color: "#FFC907",
+      }),
+    decimals: 18,
+  },
+  musd: {
+    name: "Mezo USD",
+    symbol: "MUSD",
+    icon: MUsdCircle,
+    decimals: 18,
+  },
+}
+
+/**
+ * Gets details of given crypto asset
+ * @param key The key of crypto asset
+ * @returns The crypto asset details
+ */
+export function getCryptoAsset(key: CryptoAssetKey) {
+  return CRYPTO_ASSETS[key]
+}
+
+/**
+ * Checks if given crypto asset is Bitcoin-like
+ * @param key The key of crypto asset
+ * @returns True if crypto asset is Bitcoin-like
+ */
+export function isBitcoinLikeCryptoAsset(key: CryptoAssetKey) {
+  return ["btc", "tbtc", "wbtc", "mbtc"].includes(key)
+}
+
+/**
+ * Checks if given crypto asset is USD-like
+ * @param key The key of crypto asset
+ * @returns True if crypto asset is USD-like
+ */
+export function isUsdLikeCryptoAsset(key: CryptoAssetKey) {
+  return ["musd"].includes(key)
+}

package/src/utils/currency.test.ts

@@ -0,0 +1,38 @@
+import { formatCurrency, formatUsd } from "./currency"
+
+describe("formatCurrency", () => {
+  it("formats a number as currency with default options", () => {
+    const result = formatCurrency(1234.5, { currency: "EUR" })
+    expect(result).toBe("€1,234.50")
+  })
+
+  it("respects minimumFractionDigits (min = 3, max = 3)", () => {
+    const result = formatCurrency(1.2, {
+      currency: "USD",
+      minimumFractionDigits: 3,
+      maximumFractionDigits: 3,
+    })
+    expect(result).toBe("$1.200")
+  })
+
+  it("respects maximumFractionDigits (min = 0, max = 1)", () => {
+    const result = formatCurrency(1.234567, {
+      currency: "USD",
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 1,
+    })
+    expect(result).toBe("$1.2")
+  })
+})
+
+describe("formatUsd", () => {
+  it("formats a number as USD", () => {
+    const result = formatUsd(99.99)
+    expect(result).toBe("$99.99")
+  })
+
+  it("formats zero", () => {
+    const result = formatUsd(0)
+    expect(result).toBe("$0.00")
+  })
+})

package/src/utils/currency.ts

@@ -0,0 +1,32 @@
+const DEFAULT_FORMAT_OPTIONS: Intl.NumberFormatOptions = {
+  style: "currency",
+  minimumFractionDigits: 2,
+  maximumFractionDigits: 2,
+}
+
+/**
+ * Formats a number as a currency
+ * @param value The value to format
+ * @param options The options to pass to the formatter
+ * @returns The formatted currency
+ */
+export function formatCurrency(
+  value: number,
+  options: Omit<Intl.NumberFormatOptions, "style"> = {},
+): string {
+  const formatter = new Intl.NumberFormat("en-US", {
+    ...DEFAULT_FORMAT_OPTIONS,
+    ...options,
+  })
+
+  return formatter.format(value)
+}
+
+/**
+ * Formats a number as a USD currency
+ * @param value The value to format
+ * @returns The formatted currency
+ */
+export function formatUsd(value: number): string {
+  return formatCurrency(value, { currency: "USD" })
+}

package/src/utils/numbers.test.ts

@@ -0,0 +1,73 @@
+import {
+  formatHumanReadableNumber,
+  fromFixedPoint,
+  roundUpNumber,
+} from "./numbers"
+
+describe("formatHumanReadableNumber", () => {
+  it("formats number less than 1000 with decimals", () => {
+    expect(formatHumanReadableNumber(123.456789, 2)).toBe("123.46")
+  })
+
+  it("formats thousands with K", () => {
+    expect(formatHumanReadableNumber(12_345, 2)).toBe("12.35K")
+  })
+
+  it("formats millions with M", () => {
+    expect(formatHumanReadableNumber(12_345_678, 2)).toBe("12.35M")
+  })
+
+  it("formats billions with B", () => {
+    expect(formatHumanReadableNumber(12_345_678_901, 2)).toBe("12.35B")
+  })
+
+  it("formats trillions with T", () => {
+    expect(formatHumanReadableNumber(12_345_678_901_234, 2)).toBe("12.35T")
+  })
+
+  it("formats bigint as readable number", () => {
+    expect(formatHumanReadableNumber(1234567890123456789n, 2)).toBe(
+      "1,234,567.89T",
+    )
+  })
+
+  it("caps at > 1000T for huge numbers", () => {
+    const hugeNumber = 10 ** 18 // 1e18
+    expect(formatHumanReadableNumber(hugeNumber, 2)).toBe("1,000,000T")
+  })
+
+  it("formats numbers with trailing zeros correctly", () => {
+    expect(formatHumanReadableNumber(1_000, 2)).toBe("1K")
+  })
+})
+
+describe("roundUpNumber", () => {
+  it("rounds up to 2 decimals", () => {
+    expect(roundUpNumber(1.234)).toBe(1.24)
+  })
+
+  it("rounds up to 3 decimals", () => {
+    expect(roundUpNumber(9.87654, 3)).toBe(9.877)
+  })
+
+  it("rounds up exact decimal", () => {
+    expect(roundUpNumber(2.5, 1)).toBe(2.5)
+  })
+})
+
+describe("fromFixedPoint", () => {
+  it("converts fixed point with 18 decimals to float", () => {
+    const raw = 1234567890000000000n // 1.23456789 ETH in 18 decimals
+    expect(fromFixedPoint(raw, 18, 4)).toBe(1.2345)
+  })
+
+  it("converts with truncation to 2 decimals", () => {
+    const raw = 987654321000000000n // ~0.987654321 ETH
+    expect(fromFixedPoint(raw, 18, 2)).toBe(0.98)
+  })
+
+  it("handles large fixedPoint decimals", () => {
+    const raw = 1_000_000_000_000_000_000_000_000n // 1M with 6 decimals
+    expect(fromFixedPoint(raw, 6, 2)).toBe(1000000000000000000)
+  })
+})