@daimo/pay 1.6.1 → 1.6.2

package/build/pay/packages/connectkit/src/types.d.ts

@@ -0,0 +1,46 @@
+import { ReactNode } from "react";
+import { CustomAvatarProps } from "./components/Common/Avatar";
+import { Languages as Lang } from "./localizations";
+export type Languages = Lang;
+export type Theme = "auto" | "web95" | "retro" | "soft" | "midnight" | "minimal" | "rounded" | "nouns";
+export type Mode = "light" | "dark" | "auto";
+export type CustomTheme = any;
+export type All = {
+    theme?: Theme;
+    mode?: Mode;
+    customTheme?: CustomTheme;
+    lang?: Languages;
+};
+export type { CustomAvatarProps };
+/** Global options, across all pay buttons and payments. */
+export type DaimoPayContextOptions = {
+    language?: Languages;
+    hideBalance?: boolean;
+    hideTooltips?: boolean;
+    hideQuestionMarkCTA?: boolean;
+    hideNoWalletCTA?: boolean;
+    hideRecentBadge?: boolean;
+    walletConnectCTA?: "link" | "modal" | "both";
+    /** Avoids layout shift when the DaimoPay modal is open by adding padding to the body */
+    avoidLayoutShift?: boolean;
+    /** Automatically embeds Google Font of the current theme. Does not work with custom themes */
+    embedGoogleFonts?: boolean;
+    truncateLongENSAddress?: boolean;
+    walletConnectName?: string;
+    reducedMotion?: boolean;
+    disclaimer?: ReactNode | string;
+    bufferPolyfill?: boolean;
+    customAvatar?: React.FC<CustomAvatarProps>;
+    initialChainId?: number;
+    enforceSupportedChains?: boolean;
+    ethereumOnboardingUrl?: string;
+    walletOnboardingUrl?: string;
+    /** Blur the background when the modal is open */
+    overlayBlur?: number;
+};
+/** Modal UI options, set on the pay button triggering that modal. */
+export type DaimoPayModalOptions = {
+    closeOnSuccess?: boolean;
+};
+/** Additional payment options. Onchain payments are always enabled. */
+export type PaymentOption = "Daimo" | "Coinbase" | "Binance" | "RampNetwork" | "Solana" | "ExternalChains" | "Lemon";

package/build/pay/packages/connectkit/src/utils/exports.d.ts

@@ -0,0 +1 @@
+export declare const daimoPayVersion: string;

package/build/pay/packages/connectkit/src/utils/format.d.ts

@@ -0,0 +1,49 @@
+import { BigIntStr, DaimoPayToken } from "@daimo/pay-common";
+export declare const USD_DECIMALS = 2;
+/**
+ * Round a number to a given number of decimal places
+ *
+ * @param round - The rounding strategy to use:
+ * - "up": Always rounds up to the next decimal place (ceiling)
+ * - "down": Always rounds down to the previous decimal place (floor)
+ * - "nearest": Rounds to the nearest decimal place (standard rounding)
+ */
+export declare function roundDecimals(value: number, decimals: number, round: "up" | "down" | "nearest"): string;
+/**
+ * Format a number as a USD amount
+ *
+ * @param usd - The USD amount to format
+ * @param round - The rounding strategy to use ("up", "down", or "nearest")
+ * @returns The formatted USD amount
+ */
+export declare function formatUsd(usd: number, round?: "up" | "down" | "nearest"): string;
+/**
+ * Round a USD amount to `USD_DECIMALS` precision
+ */
+export declare function roundUsd(usd: number, round?: "up" | "down" | "nearest"): string;
+/**
+ * Round a token amount to `displayDecimals` precision
+ */
+export declare function roundTokenAmount(amount: bigint | BigIntStr, token: DaimoPayToken, round?: "up" | "down" | "nearest"): string;
+/**
+ * Round a token amount in units to `displayDecimals` precision
+ */
+export declare function roundTokenAmountUnits(amountUnits: number, token: DaimoPayToken, round?: "up" | "down" | "nearest"): string;
+/**
+ * Convert a USD amount to a token amount with `displayDecimals` precision
+ *
+ * @param usd - The USD amount to convert
+ * @param token - The token to convert to
+ * @param round - The rounding strategy to use ("up", "down", or "nearest")
+ * @returns The token amount
+ */
+export declare function usdToRoundedTokenAmount(usd: number, token: DaimoPayToken, round?: "up" | "down" | "nearest"): string;
+/**
+ * Convert a token amount to a USD amount with `USD_DECIMALS` precision
+ *
+ * @param amount - The token amount to convert
+ * @param token - The token to convert from
+ * @param round - The rounding strategy to use ("up", "down", or "nearest")
+ * @returns The formatted USD amount
+ */
+export declare function tokenAmountToRoundedUsd(amount: bigint | BigIntStr, token: DaimoPayToken, round?: "up" | "down" | "nearest"): string;

package/build/pay/packages/connectkit/src/utils/index.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+declare const truncateEthAddress: (address?: string, separator?: string) => string;
+declare const truncateENSAddress: (ensName: string, maxLength: number) => string;
+declare const nFormatter: (num: number, digits?: number) => string;
+declare const detectBrowser: () => "" | import("detect-browser").Browser | "bot" | "node" | "react-native";
+declare const detectOS: () => "" | import("detect-browser").OperatingSystem | NodeJS.Platform;
+declare const isAndroid: () => boolean;
+declare const isMobile: () => boolean;
+type ReactChildArray = ReturnType<typeof React.Children.toArray>;
+declare function flattenChildren(children: React.ReactNode): ReactChildArray;
+export declare const isWalletConnectConnector: (connectorId?: string) => connectorId is "walletConnect";
+export declare const isMetaMaskConnector: (connectorId?: string) => connectorId is "metaMaskSDK";
+export declare const isCoinbaseWalletConnector: (connectorId?: string) => connectorId is "coinbaseWalletSDK";
+export declare const isLedgerConnector: (connectorId?: string) => connectorId is "ledger";
+export declare const isSafeConnector: (connectorId?: string) => connectorId is "safe";
+export declare const isInjectedConnector: (connectorId?: string) => connectorId is "injected";
+export { detectBrowser, detectOS, flattenChildren, isAndroid, isMobile, nFormatter, truncateENSAddress, truncateEthAddress };

package/build/pay/packages/connectkit/src/utils/localstorage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LocalStorage helper functions to save and retrieve data on a per-app basis
+ * e.g recently connected wallets, transactions, etc.
+ */
+export declare const save: (storageKey: string, data: any[]) => any;
+export declare const get: (storageKey: string) => any;
+export declare const add: (storageKey: string, item: any) => any;
+export declare const remove: (storageKey: string, item: any) => any;
+export declare const clear: (storageKey: string) => any;

package/build/pay/packages/connectkit/src/utils/p3.d.ts

@@ -0,0 +1,2 @@
+export declare const hexToP3: (hex: string) => string;
+export declare const p3Hex: (hex: string, property: string) => import("styled-components").FlattenSimpleInterpolation;

package/build/pay/packages/connectkit/src/utils/platform.d.ts

@@ -0,0 +1,2 @@
+import { PlatformType } from "@daimo/pay-common";
+export declare function detectPlatform(ua: string): PlatformType;

package/build/pay/packages/connectkit/src/utils/supportUrl.d.ts

@@ -0,0 +1,2 @@
+import { DaimoPayOrder } from "@daimo/pay-common";
+export declare function getSupportUrl(daimoPayOrder: DaimoPayOrder | undefined, screen: string): string;

package/build/pay/packages/connectkit/src/utils/trpc.d.ts

@@ -0,0 +1,4 @@
+import type { AppRouter } from "@daimo/pay-api";
+import { CreateTRPCClient } from "@trpc/client";
+export type TrpcClient = CreateTRPCClient<AppRouter>;
+export declare function createTrpcClient(apiUrl: string, sessionId: string): TrpcClient;

package/build/pay/packages/connectkit/src/utils/validateInput.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns true if the value is a valid number.
+ * @param value The value to validate.
+ * @param maxDecimals The maximum number of decimal places.
+ * @returns True if the value is a valid number, false otherwise.
+ */
+export declare function isValidNumber(value: string, maxDecimals?: number): boolean;
+/**
+ * Sanitize a number input.
+ * - Remove all non-numeric and non-decimal characters
+ * - If the value is empty, return "0"
+ * - Parse into a number
+ * @param value The value to sanitize.
+ * @returns The sanitized value.
+ */
+export declare function sanitizeNumber(value: string): string;

package/build/pay/packages/connectkit/src/utils/wallets.d.ts

@@ -0,0 +1,24 @@
+declare global {
+    interface Window {
+        trustWallet: any;
+        trustwallet: any;
+    }
+}
+export declare const isWalletInstalled: (name: string) => boolean;
+export declare const isMetaMask: () => boolean;
+export declare const isCoinbaseWallet: () => boolean;
+export declare const isFamily: () => boolean;
+export declare const isBrave: () => boolean;
+export declare const isTokenary: () => boolean;
+export declare const isDawn: () => boolean;
+export declare const isFrame: () => boolean;
+export declare const isPhantom: () => boolean;
+export declare const isInfinityWallet: () => boolean;
+export declare const isRabby: () => boolean;
+export declare const isFrontier: () => boolean;
+export declare const isTrust: () => any;
+export declare const isTokenPocket: () => boolean;
+export declare const isTalisman: () => boolean;
+export declare const isFordefi: () => boolean;
+export declare const isRainbow: () => boolean;
+export declare const isZerion: () => boolean;

package/build/pay/packages/connectkit/src/wallets/index.d.ts

@@ -0,0 +1,5 @@
+import { CreateConnectorFn } from "wagmi";
+/** Ethereum wallets, by name. */
+export declare const wallets: {
+    [key: string]: CreateConnectorFn;
+};

package/build/pay/packages/connectkit/src/wallets/useWallets.d.ts

@@ -0,0 +1,9 @@
+import { Connector } from "wagmi";
+import { WalletConfigProps } from "./walletConfigs";
+export type WalletProps = {
+    id: string;
+    connector: Connector;
+    isInstalled?: boolean;
+} & WalletConfigProps;
+export declare const useWallet: (id: string) => WalletProps | null;
+export declare const useWallets: () => WalletProps[];

package/build/pay/packages/connectkit/src/wallets/walletConfigs.d.ts

@@ -0,0 +1,30 @@
+/**
+ * EIP-6963: Multi Injected Provider Discovery
+ * https://eips.ethereum.org/EIPS/eip-6963
+ *
+ */
+export type WalletConfigProps = {
+    name?: string;
+    shortName?: string;
+    icon?: string | React.ReactNode;
+    iconConnector?: React.ReactNode;
+    iconShape?: "squircle" | "circle" | "square";
+    iconShouldShrink?: boolean;
+    downloadUrls?: {
+        download?: string;
+        website?: string;
+        desktop?: string;
+        android?: string;
+        ios?: string;
+        chrome?: string;
+        firefox?: string;
+        brave?: string;
+        edge?: string;
+        safari?: string;
+    };
+    getWalletConnectDeeplink?: (uri: string) => string;
+    shouldDeeplinkDesktop?: boolean;
+};
+export declare const walletConfigs: {
+    [rdns: string]: WalletConfigProps;
+};