@chainberry/ui-components 1.0.33 → 1.0.35

package/dist/index.d.ts

@@ -699,6 +699,9 @@ declare type DateField = 'createdAt' | 'confirmedAt';
 /** Default (English) tier column headers; override via the `tierLabels` prop. */
 export declare const DEFAULT_TIER_LABELS: Record<WalletTier, string>;
 
+/** Default (English) copy; override any subset via the `labels` prop. */
+export declare const DEFAULT_USER_WALLETS_LABELS: UserWalletsTableLabels;
+
 /** Default (English) copy; override any subset via the `labels` prop. */
 export declare const DEFAULT_V3_LABELS: WalletBalancesTableV3Labels;
 
@@ -944,6 +947,11 @@ declare function filterMatches_2(r: TreasuryActivityRecord, f: ActivityFilter):
 /** A short, human name summarizing the selection — used to prefill the preset name. */
 declare function filterToName(f: TxFilter): string;
 
+/** Filter the user groups by a query. A hit on the userId keeps the whole group;
+ otherwise only the address rows that match are kept, dropping empty groups.
+ Powers the page search box. */
+export declare function filterUserGroups(groups: UserWalletGroup[], query: string): UserWalletGroup[];
+
 export declare function findNavItem(id: string): NavItemConfig | undefined;
 
 export declare type FooterAction = {
@@ -2356,6 +2364,9 @@ export declare function UiBadge({ className, variant, asChild, ...props }: React
 
 export declare function useHeaderExtension(): HeaderStickyValue;
 
+/** Deposit addresses grouped by end user. */
+declare const USER_WALLET_GROUPS: UserWalletGroup[];
+
 export declare function UserMenu({ name, avatarSrc, navMode, onNavModeChange, headerMode, onHeaderModeChange, onAccount, onLogout, onTakeTour, onResetDemo, collapsed, side, align, fullWidth, }: {
     name?: string;
     avatarSrc?: string;
@@ -2379,6 +2390,73 @@ export declare function UserMenu({ name, avatarSrc, navMode, onNavModeChange, he
     fullWidth?: boolean;
 }): JSX.Element;
 
+/** An end user and the deposit addresses they hold across networks. */
+export declare type UserWalletGroup = {
+    /** userId — group key + React key. */
+    id: string;
+    userId: string;
+    /** Band heading, when the group is keyed by something other than an end user
+     (e.g. a vault account). Defaults to `userId`. */
+    label?: string;
+    rows: UserWalletRow[];
+};
+
+/** One deposit address held by a user — a single table row. */
+export declare type UserWalletRow = {
+    id: string;
+    /** On-chain deposit address (rendered as a link). */
+    address: string;
+    /** Destination tag / memo — only networks that share one address across users
+     (e.g. TON) carry it; omitted elsewhere. */
+    tag?: string;
+    /** Network code for the badge logo (resolved via coinSrc), e.g. "TRX". */
+    network: string;
+    /** Network label shown in the row, e.g. "TRON". */
+    networkName: string;
+    /** Block-explorer URL for this address. Defaults to the "#" placeholder. */
+    addressUrl?: string;
+    /** Network logo URL, when the caller resolves its own chain artwork.
+     Defaults to `coinSrc(network)`. */
+    networkSrc?: string;
+    /** Asset code (e.g. "USDT"). Rows carrying one render an asset chip before
+     the address — needed when a group holds addresses across several coins,
+     which the by-network sample data never does. */
+    symbol?: string;
+    /** Asset logo URL. Defaults to `coinSrc(symbol)`. */
+    symbolSrc?: string;
+};
+
+export declare namespace userWalletsData {
+    export {
+        filterUserGroups,
+        UserWalletRow,
+        UserWalletGroup,
+        USER_WALLET_GROUPS
+    }
+}
+
+export declare function UserWalletsPage(): JSX.Element;
+
+export declare function UserWalletsTable({ groups, labels, className, }: {
+    groups: UserWalletGroup[];
+    /** Translated copy; unset keys fall back to English. */
+    labels?: Partial<UserWalletsTableLabels>;
+    className?: string;
+}): JSX.Element;
+
+/** Translatable strings the table renders itself. Everything else — the band
+ headings, addresses, tags and network names — comes in through `groups`. */
+export declare type UserWalletsTableLabels = {
+    /** Address column header. */
+    address: string;
+    /** Tag column header. */
+    tag: string;
+    /** Network column header. */
+    network: string;
+    /** A group's address count, e.g. (3) => "3 wallets". */
+    wallets: (count: number) => string;
+};
+
 /** A vault and the currency/network rows it holds. */
 declare type Vault = {
     kind: VaultKind;