@stableflow/pay-widgets 0.0.1-beta-82ede460a5-20260923

package/dist/token-select/index.d.ts

@@ -0,0 +1,165 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+type ChainKind = "evm" | "near" | "solana" | "tron" | "zec";
+type PayChain = {
+    blockchain: string;
+    chainName: string;
+    chainKind: ChainKind;
+    chainId?: string;
+    logo: string;
+    explorer: string;
+};
+type PayToken = {
+    assetId: string;
+    symbol: string;
+    providerSymbol: string;
+    blockchain: string;
+    decimals: number;
+    contractAddress: string | null;
+    price: number;
+    logo: string;
+    supportPayment: boolean;
+    supportReceive: boolean;
+    chain: PayChain;
+};
+/** API-shaped payload. Callers can pass this into their own chain registry. */
+type PayConfigSource = {
+    chains: PayConfigSourceChain[];
+    tokens: PayConfigSourceToken[];
+};
+type PayConfigSourceChain = {
+    network: string;
+    chainId: string;
+    chainName: string;
+    logo: string;
+    explorer: string;
+};
+type PayConfigSourceToken = {
+    symbol: string;
+    network: string;
+    decimals: number;
+    contractAddress: string;
+    price: string;
+    supportPayment: boolean;
+    supportReceive: boolean;
+};
+type PopularTokenRef = {
+    blockchain: string;
+    symbol: string;
+};
+type WalletAccountInput = {
+    address?: string | null;
+    icon?: string | null;
+    connecting?: boolean;
+    /** False inside a Safe App, where the host owns the connection. */
+    canDisconnect?: boolean;
+};
+type PayWallet = {
+    accounts: Partial<Record<ChainKind, WalletAccountInput>>;
+    connect: (kind: ChainKind) => void | Promise<void>;
+    disconnect: (kind: ChainKind) => void | Promise<void>;
+};
+type BalanceReadSuccess = {
+    assetId: string;
+    formatted: string;
+    /** Integer token units, as a decimal string. */
+    raw?: string;
+};
+type BalanceReadFailure = {
+    assetId: string;
+    error: string;
+};
+type BalanceReadResult = BalanceReadSuccess | BalanceReadFailure;
+type ReadBalances = (batch: {
+    owner: string;
+    chainKind: ChainKind;
+    blockchain: string;
+    tokens: PayToken[];
+}) => Promise<BalanceReadResult[]>;
+type TokenSelectRole = "payer" | "receiver";
+type ChainOwners = Partial<Record<ChainKind, string>>;
+type TokenBalanceStatus = "idle" | "loading" | "success" | "error";
+
+type PayWidgetsProviderProps = {
+    apiHost?: string;
+    popularTokens?: PopularTokenRef[];
+    wallet: PayWallet;
+    readBalances: ReadBalances;
+    onConfig?: (config: PayConfigSource) => void;
+    onCopyAddress?: (address: string) => void;
+    chainKinds?: Partial<Record<string, ChainKind>>;
+    children: ReactNode;
+};
+declare function PayWidgetsProvider(props: PayWidgetsProviderProps): react.JSX.Element;
+
+type TokenSelectSelection = {
+    token: PayToken;
+};
+type TokenSelectDialogProps = {
+    open: boolean;
+    onClose: () => void;
+    onSelect: (selection: TokenSelectSelection) => void;
+    role?: TokenSelectRole;
+    title?: string;
+    selectedAssetId?: string | null;
+    balanceOwners?: ChainOwners;
+    allowedBlockchains?: string[] | null;
+    lockChainKind?: ChainKind | null;
+    excludeNative?: boolean;
+    disabledBlockchains?: string[] | null;
+    disabledReason?: string;
+    className?: string;
+    titleClassName?: string;
+    closeClassName?: string;
+    contentClassName?: string;
+    searchClassName?: string;
+    railClassName?: string;
+    rowClassName?: string;
+};
+declare function TokenSelectDialog(props: TokenSelectDialogProps): react.JSX.Element;
+
+type PayConfigStatus = "idle" | "loading" | "success" | "error";
+type PayConfigSnapshot = {
+    apiHost: string;
+    chains: PayChain[];
+    tokens: PayToken[];
+    source: PayConfigSource | null;
+    status: PayConfigStatus;
+    error: string | null;
+    fetchedAt: number | null;
+};
+type ChainKindMap = Partial<Record<string, ChainKind>>;
+declare function mapPayConfigSource(raw: unknown): PayConfigSource;
+declare function normalizePayConfig(source: PayConfigSource, overrides?: ChainKindMap): {
+    chains: PayChain[];
+    tokens: PayToken[];
+};
+declare function usePayConfigSnapshot(): PayConfigSnapshot;
+declare function usePayConfig(options?: {
+    apiHost?: string;
+}): {
+    chains: PayChain[];
+    tokens: PayToken[];
+    source: PayConfigSource | null;
+    status: PayConfigStatus;
+    error: string | null;
+    refetch: () => void;
+};
+
+type TokenBalance = {
+    raw: string | null;
+    formatted: string | null;
+    status: TokenBalanceStatus;
+    error: string | null;
+    updatedAt: number | null;
+};
+declare function clearPayTokenBalances(): void;
+declare function usePayTokenBalance(owner: string | null | undefined, assetId: string | null | undefined): TokenBalance | undefined;
+declare function refreshPayTokenBalance(owner: string, token: PayToken): Promise<TokenBalance | null>;
+
+declare function parsePopularTokens(raw: string | null | undefined): PopularTokenRef[];
+
+declare const DEFAULT_API_HOST = "https://api.stableflow.ai";
+
+export { type BalanceReadResult, type ChainKind, type ChainOwners, DEFAULT_API_HOST, type PayChain, type PayConfigSnapshot, type PayConfigSource, type PayConfigStatus, type PayToken, type PayWallet, PayWidgetsProvider, type PayWidgetsProviderProps, type PopularTokenRef, type ReadBalances, type TokenBalance, TokenSelectDialog, type TokenSelectDialogProps, type TokenSelectRole, type TokenSelectSelection, clearPayTokenBalances, mapPayConfigSource, normalizePayConfig, parsePopularTokens, refreshPayTokenBalance, usePayConfig, usePayConfigSnapshot, usePayTokenBalance };