@liberfi.io/ui-portfolio 0.1.161 → 2.0.0

package/README.md

@@ -94,6 +94,17 @@ function useAccountInfo(): UseAccountInfoResult;
 | `holdings`               | `SpotHolding[]`                | User's spot holdings (sorted by value desc) |
 | `isHoldingsLoading`      | `boolean`                      | Whether holdings query is loading           |
 
+### Components — Portfolio (Phase 3)
+
+Portfolio widgets introduced alongside the Phase 3 server migration. Every script calls `@liberfi.io/react` hooks directly and never touches `@chainstream-io/sdk`; the UI layers are pure presentational tables driven by props. All three widgets accept a `chain` + `address` (wallet address) pair and manage their own cursor-pagination state.
+
+| Export                          | Kind   | Description                                                                                                                                                                                 |
+| ------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `PortfolioActivitiesWidget`     | Widget | Wallet activities table (Phase 3 `/v2/trade/{chain}/activities`) with `sortBy` (`timestamp` / `totalUsd`), type filter, trader tags, and gas fee.                                           |
+| `PortfolioNetWorthTokensWidget` | Widget | Net-worth-by-token holdings table (Phase 3 `/v2/wallet/{chain}/{wallet}/net-worth/tokens`) with `avgCostUsd`, wallet tags, and last-active-at.                                              |
+| `PortfolioPnlDetailsWidget`     | Widget | Per-token PnL details (Phase 3 `/v2/wallet/{chain}/{wallet}/pnl-details`) with `resolution` / `positionState` / `sortBy` selectors and new fields (`isClosed`, `firstBuyAt`, `lastSellAt`). |
+| `TagBadge` / `TagBadgeList`     | UI     | Shared classification chip primitive used across the Phase 3 widgets.                                                                                                                       |
+
 ### Other exports
 
 The package also exports portfolio page components (`PortfolioPageWidget`, `usePortfolioPage`, etc.), holdings, hooks (`useWalletSummary`, `useOverviewQuery`, etc.), providers, contexts, and types. See `src/index.ts` and `src/components/index.tsx` for the full list.
@@ -137,8 +148,29 @@ Omit callbacks to hide the corresponding UI elements:
 <AccountInfoWidget />
 ```
 
+### Composing the portfolio page
+
+```tsx
+import {
+  PortfolioActivitiesWidget,
+  PortfolioNetWorthTokensWidget,
+  PortfolioPnlDetailsWidget,
+} from "@liberfi.io/ui-portfolio";
+
+function PortfolioPage({ chain, address }: { chain: Chain; address: string }) {
+  return (
+    <div className="flex flex-col gap-6">
+      <PortfolioNetWorthTokensWidget chain={chain} address={address} />
+      <PortfolioPnlDetailsWidget chain={chain} address={address} />
+      <PortfolioActivitiesWidget chain={chain} address={address} />
+    </div>
+  );
+}
+```
+
 ## Future Improvements
 
 - Optional portfolio context so the account widget can render outside `PortfolioProvider` with placeholder balances.
 - ARIA and keyboard improvements for the popover trigger.
 - Perps tab integration when perps positions data is available.
+- Portfolio Phase 3 widgets: add CSV / image export, and support grouped tokens (by chain) for multi-chain wallets.

package/dist/index.d.mts

@@ -7,7 +7,7 @@ import { A as AssetTab, C as CurveType, a as CurvePeriod, P as PortfolioQuery, b
 export { q as CURVE_PERIOD_VALUE, x as ChartDataPointDTO, F as CurvePoint, H as DistributionItem, G as GetPortfolioChartReply, y as GetSpotHoldingsReply, B as GetTradeHistoryReply, r as PerpsPositionSide, J as PerpsTradeRecord, w as PortfolioOverviewDTO, t as PredictionBetStatus, u as PredictionResult, K as PredictionSettledRecord, v as PredictionSource, E as SpotHistoryRecord, s as SpotHistoryType, T as TokenHoldingDTO, z as TradeRecordDTO } from './index-Bq_qim6b.mjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions } from '@tanstack/react-query';
-import { Chain, Portfolio, PortfolioPnl } from '@liberfi.io/types';
+import { API, Activity, Chain, WalletPortfolios, Portfolio, WalletPortfolioPnls, PortfolioPnl } from '@liberfi.io/types';
 
 declare global {
     interface Window {
@@ -16,7 +16,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.161";
+declare const _default: "2.0.0";
 
 /** Action button rendered in the popover action bar. */
 interface AccountAction {
@@ -296,6 +296,230 @@ interface BatchActionButtonProps {
 }
 declare function BatchActionButton({ label, disabled, onClick, }: BatchActionButtonProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Format the elapsed time between `from` and `now` as a short age string
+ * (e.g. "5m", "2h", "3d"). Returns "--" if `from` is unavailable.
+ */
+declare function formatAgeShort(from: Date | string | number | undefined, now?: Date | number): string;
+declare function truncateMiddle(input: string | undefined, head?: number, tail?: number): string;
+
+interface TagBadgeProps {
+    tag: string;
+    className?: string;
+}
+/**
+ * Classification tag chip used across portfolio widgets (mirrors the
+ * `HolderTagBadge` / `TraderTagBadge` palette from `@liberfi.io/ui-tokens`).
+ */
+declare function TagBadge({ tag, className }: TagBadgeProps): react_jsx_runtime.JSX.Element;
+interface TagBadgeListProps {
+    tags?: Array<string>;
+    className?: string;
+    max?: number;
+}
+declare function TagBadgeList({ tags, className, max }: TagBadgeListProps): react_jsx_runtime.JSX.Element | null;
+
+type PortfolioActivitiesSortBy = API.ActivitiesSortBy;
+type PortfolioActivitiesTypeFilter = "all" | "buy" | "sell";
+interface PortfolioActivitiesProps {
+    activities: Array<Activity>;
+    isLoading?: boolean;
+    sortBy: PortfolioActivitiesSortBy;
+    onSortByChange: (sortBy: PortfolioActivitiesSortBy) => void;
+    typeFilter?: PortfolioActivitiesTypeFilter;
+    onTypeFilterChange?: (t: PortfolioActivitiesTypeFilter) => void;
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+    now?: number;
+    /** native token decimals for gas-fee formatting */
+    nativeDecimals?: number;
+    /** native token symbol (e.g. "SOL") */
+    nativeSymbol?: string;
+    className?: string;
+    onRowClick?: (activity: Activity) => void;
+}
+/**
+ * Presentational wallet activities table (Phase 3). Shows per-activity token,
+ * side, trader-tags, token-amount, usd-amount, gas-fee and age.
+ */
+declare function PortfolioActivities({ activities, isLoading, sortBy, onSortByChange, typeFilter, onTypeFilterChange, onLoadMore, hasMore, now, nativeDecimals, nativeSymbol, className, onRowClick, }: PortfolioActivitiesProps): react_jsx_runtime.JSX.Element;
+
+interface UsePortfolioActivitiesScriptParams {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialSortBy?: PortfolioActivitiesSortBy;
+    initialTypeFilter?: PortfolioActivitiesTypeFilter;
+}
+interface UsePortfolioActivitiesScriptResult {
+    activities: Array<Activity>;
+    isLoading: boolean;
+    sortBy: PortfolioActivitiesSortBy;
+    setSortBy: (s: PortfolioActivitiesSortBy) => void;
+    typeFilter: PortfolioActivitiesTypeFilter;
+    setTypeFilter: (t: PortfolioActivitiesTypeFilter) => void;
+    hasMore: boolean;
+    loadMore: () => void;
+}
+/**
+ * Script for the Phase 3 wallet-activities list. Mirrors the semantics of the
+ * token-activities list script: cursor pagination with reset on
+ * (sortBy / typeFilter / chain / address), plus live prepend when on the
+ * default view.
+ */
+declare function usePortfolioActivitiesScript({ chain, address, limit, initialSortBy, initialTypeFilter, }: UsePortfolioActivitiesScriptParams): UsePortfolioActivitiesScriptResult;
+
+interface PortfolioActivitiesWidgetProps {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialSortBy?: PortfolioActivitiesSortBy;
+    initialTypeFilter?: PortfolioActivitiesTypeFilter;
+    nativeDecimals?: number;
+    nativeSymbol?: string;
+    className?: string;
+    onRowClick?: (activity: Activity) => void;
+}
+/**
+ * Phase 3 wallet activities widget. Consumes
+ * `GET /v2/trade/{chain}/activities?walletAddress=…` via `useWalletActivitiesQuery`.
+ */
+declare function PortfolioActivitiesWidget({ chain, address, limit, initialSortBy, initialTypeFilter, nativeDecimals, nativeSymbol, className, onRowClick, }: PortfolioActivitiesWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface PortfolioNetWorthTokensProps {
+    data?: WalletPortfolios;
+    isLoading?: boolean;
+    className?: string;
+    now?: number;
+    onRowClick?: (portfolio: Portfolio) => void;
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+}
+/**
+ * Presentational net-worth-by-token table (Phase 3).
+ *
+ * Columns:
+ * - Token (symbol + truncated address)
+ * - Amount (native token)
+ * - Value (USD)
+ * - Avg cost (USD) — sparse (~0.2% fill)
+ * - Tags (wallet-for-token classifications)
+ * - Last active
+ */
+declare function PortfolioNetWorthTokens({ data, isLoading, className, now, onRowClick, onLoadMore, hasMore, }: PortfolioNetWorthTokensProps): react_jsx_runtime.JSX.Element;
+
+interface UsePortfolioNetWorthTokensScriptParams {
+    chain: Chain;
+    address: string;
+    /** page size */
+    limit?: number;
+}
+interface UsePortfolioNetWorthTokensScriptResult {
+    data?: WalletPortfolios;
+    isLoading: boolean;
+    hasMore: boolean;
+    loadMore: () => void;
+}
+/**
+ * Script for the Phase 3 portfolio net-worth-tokens list.
+ *
+ * Pagination: we accumulate pages into a single `WalletPortfolios` object so
+ * the UI can show the full list with infinite-scroll semantics while still
+ * carrying the summary fields (`balanceInUsd`, `balanceInNative`) from the
+ * first page.
+ */
+declare function usePortfolioNetWorthTokensScript({ chain, address, limit, }: UsePortfolioNetWorthTokensScriptParams): UsePortfolioNetWorthTokensScriptResult;
+
+interface PortfolioNetWorthTokensWidgetProps {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    className?: string;
+    onRowClick?: (portfolio: Portfolio) => void;
+}
+/**
+ * Phase 3 net-worth-by-token widget. Consumes
+ * `GET /v2/wallet/{chain}/{wallet}/net-worth/tokens` via
+ * `useWalletPortfoliosQuery` and surfaces the new fields
+ * (`isActive`, `avgCostUsd`, `lastActiveAt`, `walletTokenTags`).
+ */
+declare function PortfolioNetWorthTokensWidget({ chain, address, limit, className, onRowClick, }: PortfolioNetWorthTokensWidgetProps): react_jsx_runtime.JSX.Element;
+
+type PnlResolution = API.WalletPnlResolution;
+type PositionState = API.PositionState;
+type PnlSortBy = API.WalletPnlSortBy;
+interface PortfolioPnlDetailsProps {
+    data?: WalletPortfolioPnls;
+    isLoading?: boolean;
+    resolution: PnlResolution;
+    onResolutionChange: (r: PnlResolution) => void;
+    positionState: PositionState;
+    onPositionStateChange: (p: PositionState) => void;
+    sortBy: PnlSortBy;
+    onSortByChange: (s: PnlSortBy) => void;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+    now?: number;
+    className?: string;
+    onRowClick?: (pnl: PortfolioPnl) => void;
+}
+/**
+ * Presentational PnL details table (Phase 3). Shows per-position realized /
+ * unrealized / total PnL and the new Phase 3 fields (`isClosed`, `firstBuyAt`,
+ * `lastSellAt`). The summary row at the top shows aggregate PnL and win rate.
+ */
+declare function PortfolioPnlDetails({ data, isLoading, resolution, onResolutionChange, positionState, onPositionStateChange, sortBy, onSortByChange, hasMore, onLoadMore, now, className, onRowClick, }: PortfolioPnlDetailsProps): react_jsx_runtime.JSX.Element;
+
+interface UsePortfolioPnlDetailsScriptParams {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialResolution?: PnlResolution;
+    initialPositionState?: PositionState;
+    initialSortBy?: PnlSortBy;
+}
+interface UsePortfolioPnlDetailsScriptResult {
+    data?: WalletPortfolioPnls;
+    isLoading: boolean;
+    resolution: PnlResolution;
+    setResolution: (r: PnlResolution) => void;
+    positionState: PositionState;
+    setPositionState: (p: PositionState) => void;
+    sortBy: PnlSortBy;
+    setSortBy: (s: PnlSortBy) => void;
+    hasMore: boolean;
+    loadMore: () => void;
+}
+/**
+ * Script for the Phase 3 PnL-details widget.
+ *
+ * Pagination: accumulates cursor pages into a single `WalletPortfolioPnls`
+ * while keeping the header summary from the first page. Any of
+ * `resolution` / `positionState` / `sortBy` / `chain` / `address` changing
+ * triggers a full reset — the server invalidates cursors on any of these
+ * changes.
+ */
+declare function usePortfolioPnlDetailsScript({ chain, address, limit, initialResolution, initialPositionState, initialSortBy, }: UsePortfolioPnlDetailsScriptParams): UsePortfolioPnlDetailsScriptResult;
+
+interface PortfolioPnlDetailsWidgetProps {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialResolution?: PnlResolution;
+    initialPositionState?: PositionState;
+    initialSortBy?: PnlSortBy;
+    className?: string;
+    onRowClick?: (pnl: PortfolioPnl) => void;
+}
+/**
+ * Phase 3 PnL-details widget. Consumes
+ * `GET /v2/wallet/{chain}/{wallet}/pnl-details` via
+ * `useWalletPortfolioPnlsQuery` and renders the new fields (`isClosed`,
+ * `firstBuyAt`, `lastSellAt`) alongside resolution / positionState / sortBy
+ * selectors.
+ */
+declare function PortfolioPnlDetailsWidget({ chain, address, limit, initialResolution, initialPositionState, initialSortBy, className, onRowClick, }: PortfolioPnlDetailsWidgetProps): react_jsx_runtime.JSX.Element;
+
 declare const PortfolioClientContext: react.Context<IPortfolioClient | null>;
 
 /** Refetch function for wallet summary. */
@@ -453,4 +677,4 @@ declare function computeDistribution(holdings: SpotHolding[]): DistributionData;
  */
 declare function formatTime(epochMs: number): string;
 
-export { type AccountAction, AccountInfoUI, type AccountInfoUIProps, AccountInfoWidget, type AccountInfoWidgetProps, AddressRowUI, type AddressRowUIProps, AssetTab, AssetTabsUI, type AssetTabsUIProps, AsyncStatus, BalanceRowUI, type BalanceRowUIProps, BatchActionButton, type BatchActionButtonProps, ConfirmDialog, type ConfirmDialogProps, CurveCardUI, type CurveCardUIProps, CurveData, CurvePeriod, CurveQuery, CurveType, DistributionCardUI, type DistributionCardUIProps, DistributionData, HoldingsEmpty, type HoldingsEmptyProps, type HoldingsRenderProps, HoldingsSearch, type HoldingsSearchProps, HoldingsSectionWidget, type HoldingsSectionWidgetProps, HoldingsSubTabs, type HoldingsSubTabsProps, IPortfolioClient, PerpsHistoryData, PerpsHistoryQuery, PerpsPanelUI, type PerpsPanelUIProps, PerpsPosition, PerpsPositionsData, type PerpsSubTab, PortfolioClientContext, PortfolioClientProvider, type PortfolioClientProviderProps, PortfolioContext, type PortfolioContextValue, PortfolioOverview, PortfolioPageSkeleton, PortfolioPageWidget, type PortfolioPageWidgetProps, PortfolioProvider, type PortfolioProviderProps, PortfolioQuery, PredictionBet, PredictionBetsData, PredictionPanelUI, type PredictionPanelUIProps, PredictionSettledData, PredictionSettledQuery, type PredictionSubTab, type RefetchWalletSummaryFn, SpotHistoryData, SpotHistoryQuery, SpotHolding, SpotHoldingsData, SpotPanelUI, type SpotPanelUIProps, type SpotSubTab, type TokenPortfolio, type UseAccountInfoResult, type UseHoldingsSectionOptions, type UseHoldingsSectionResult, type UsePortfolioPageOptions, type UsePortfolioPageResult, type UseWalletPortfoliosParams, ViewingBannerUI, type ViewingBannerUIProps, type WalletOption, WalletSummary, computeDistribution, curveDataQueryKey, distributionQueryKey, formatPercent, formatSignedUsd, formatTime, formatTokenBalance, formatUsd, getExplorerUrl, overviewQueryKey, parseDecimal, perpsHistoryQueryKey, perpsPositionsQueryKey, predictionBetsQueryKey, predictionSettledQueryKey, splitUsd, spotHistoryQueryKey, spotHoldingsQueryKey, truncateAddress, useAccountInfo, useCurveDataQuery, useDistributionQuery, useHoldingsSection, useOverviewQuery, usePerpsHistoryQuery, usePerpsPositionsQuery, usePortfolioClient, usePortfolioContext, usePortfolioPage, usePredictionBetsQuery, usePredictionSettledQuery, useRefetchWalletSummary, useSpotHistoryQuery, useSpotHoldingsQuery, useWalletPortfolios, useWalletSummary, _default as version };
+export { type AccountAction, AccountInfoUI, type AccountInfoUIProps, AccountInfoWidget, type AccountInfoWidgetProps, AddressRowUI, type AddressRowUIProps, AssetTab, AssetTabsUI, type AssetTabsUIProps, AsyncStatus, BalanceRowUI, type BalanceRowUIProps, BatchActionButton, type BatchActionButtonProps, ConfirmDialog, type ConfirmDialogProps, CurveCardUI, type CurveCardUIProps, CurveData, CurvePeriod, CurveQuery, CurveType, DistributionCardUI, type DistributionCardUIProps, DistributionData, HoldingsEmpty, type HoldingsEmptyProps, type HoldingsRenderProps, HoldingsSearch, type HoldingsSearchProps, HoldingsSectionWidget, type HoldingsSectionWidgetProps, HoldingsSubTabs, type HoldingsSubTabsProps, IPortfolioClient, PerpsHistoryData, PerpsHistoryQuery, PerpsPanelUI, type PerpsPanelUIProps, PerpsPosition, PerpsPositionsData, type PerpsSubTab, type PnlResolution, type PnlSortBy, PortfolioActivities, type PortfolioActivitiesProps, type PortfolioActivitiesSortBy, type PortfolioActivitiesTypeFilter, PortfolioActivitiesWidget, type PortfolioActivitiesWidgetProps, PortfolioClientContext, PortfolioClientProvider, type PortfolioClientProviderProps, PortfolioContext, type PortfolioContextValue, PortfolioNetWorthTokens, type PortfolioNetWorthTokensProps, PortfolioNetWorthTokensWidget, type PortfolioNetWorthTokensWidgetProps, PortfolioOverview, PortfolioPageSkeleton, PortfolioPageWidget, type PortfolioPageWidgetProps, PortfolioPnlDetails, type PortfolioPnlDetailsProps, PortfolioPnlDetailsWidget, type PortfolioPnlDetailsWidgetProps, PortfolioProvider, type PortfolioProviderProps, PortfolioQuery, type PositionState, PredictionBet, PredictionBetsData, PredictionPanelUI, type PredictionPanelUIProps, PredictionSettledData, PredictionSettledQuery, type PredictionSubTab, type RefetchWalletSummaryFn, SpotHistoryData, SpotHistoryQuery, SpotHolding, SpotHoldingsData, SpotPanelUI, type SpotPanelUIProps, type SpotSubTab, TagBadge, TagBadgeList, type TagBadgeListProps, type TagBadgeProps, type TokenPortfolio, type UseAccountInfoResult, type UseHoldingsSectionOptions, type UseHoldingsSectionResult, type UsePortfolioActivitiesScriptParams, type UsePortfolioActivitiesScriptResult, type UsePortfolioNetWorthTokensScriptParams, type UsePortfolioNetWorthTokensScriptResult, type UsePortfolioPageOptions, type UsePortfolioPageResult, type UsePortfolioPnlDetailsScriptParams, type UsePortfolioPnlDetailsScriptResult, type UseWalletPortfoliosParams, ViewingBannerUI, type ViewingBannerUIProps, type WalletOption, WalletSummary, computeDistribution, curveDataQueryKey, distributionQueryKey, formatAgeShort, formatPercent, formatSignedUsd, formatTime, formatTokenBalance, formatUsd, getExplorerUrl, overviewQueryKey, parseDecimal, perpsHistoryQueryKey, perpsPositionsQueryKey, predictionBetsQueryKey, predictionSettledQueryKey, splitUsd, spotHistoryQueryKey, spotHoldingsQueryKey, truncateAddress, truncateMiddle, useAccountInfo, useCurveDataQuery, useDistributionQuery, useHoldingsSection, useOverviewQuery, usePerpsHistoryQuery, usePerpsPositionsQuery, usePortfolioActivitiesScript, usePortfolioClient, usePortfolioContext, usePortfolioNetWorthTokensScript, usePortfolioPage, usePortfolioPnlDetailsScript, usePredictionBetsQuery, usePredictionSettledQuery, useRefetchWalletSummary, useSpotHistoryQuery, useSpotHoldingsQuery, useWalletPortfolios, useWalletSummary, _default as version };

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import { A as AssetTab, C as CurveType, a as CurvePeriod, P as PortfolioQuery, b
 export { q as CURVE_PERIOD_VALUE, x as ChartDataPointDTO, F as CurvePoint, H as DistributionItem, G as GetPortfolioChartReply, y as GetSpotHoldingsReply, B as GetTradeHistoryReply, r as PerpsPositionSide, J as PerpsTradeRecord, w as PortfolioOverviewDTO, t as PredictionBetStatus, u as PredictionResult, K as PredictionSettledRecord, v as PredictionSource, E as SpotHistoryRecord, s as SpotHistoryType, T as TokenHoldingDTO, z as TradeRecordDTO } from './index-Bq_qim6b.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions } from '@tanstack/react-query';
-import { Chain, Portfolio, PortfolioPnl } from '@liberfi.io/types';
+import { API, Activity, Chain, WalletPortfolios, Portfolio, WalletPortfolioPnls, PortfolioPnl } from '@liberfi.io/types';
 
 declare global {
     interface Window {
@@ -16,7 +16,7 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.161";
+declare const _default: "2.0.0";
 
 /** Action button rendered in the popover action bar. */
 interface AccountAction {
@@ -296,6 +296,230 @@ interface BatchActionButtonProps {
 }
 declare function BatchActionButton({ label, disabled, onClick, }: BatchActionButtonProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Format the elapsed time between `from` and `now` as a short age string
+ * (e.g. "5m", "2h", "3d"). Returns "--" if `from` is unavailable.
+ */
+declare function formatAgeShort(from: Date | string | number | undefined, now?: Date | number): string;
+declare function truncateMiddle(input: string | undefined, head?: number, tail?: number): string;
+
+interface TagBadgeProps {
+    tag: string;
+    className?: string;
+}
+/**
+ * Classification tag chip used across portfolio widgets (mirrors the
+ * `HolderTagBadge` / `TraderTagBadge` palette from `@liberfi.io/ui-tokens`).
+ */
+declare function TagBadge({ tag, className }: TagBadgeProps): react_jsx_runtime.JSX.Element;
+interface TagBadgeListProps {
+    tags?: Array<string>;
+    className?: string;
+    max?: number;
+}
+declare function TagBadgeList({ tags, className, max }: TagBadgeListProps): react_jsx_runtime.JSX.Element | null;
+
+type PortfolioActivitiesSortBy = API.ActivitiesSortBy;
+type PortfolioActivitiesTypeFilter = "all" | "buy" | "sell";
+interface PortfolioActivitiesProps {
+    activities: Array<Activity>;
+    isLoading?: boolean;
+    sortBy: PortfolioActivitiesSortBy;
+    onSortByChange: (sortBy: PortfolioActivitiesSortBy) => void;
+    typeFilter?: PortfolioActivitiesTypeFilter;
+    onTypeFilterChange?: (t: PortfolioActivitiesTypeFilter) => void;
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+    now?: number;
+    /** native token decimals for gas-fee formatting */
+    nativeDecimals?: number;
+    /** native token symbol (e.g. "SOL") */
+    nativeSymbol?: string;
+    className?: string;
+    onRowClick?: (activity: Activity) => void;
+}
+/**
+ * Presentational wallet activities table (Phase 3). Shows per-activity token,
+ * side, trader-tags, token-amount, usd-amount, gas-fee and age.
+ */
+declare function PortfolioActivities({ activities, isLoading, sortBy, onSortByChange, typeFilter, onTypeFilterChange, onLoadMore, hasMore, now, nativeDecimals, nativeSymbol, className, onRowClick, }: PortfolioActivitiesProps): react_jsx_runtime.JSX.Element;
+
+interface UsePortfolioActivitiesScriptParams {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialSortBy?: PortfolioActivitiesSortBy;
+    initialTypeFilter?: PortfolioActivitiesTypeFilter;
+}
+interface UsePortfolioActivitiesScriptResult {
+    activities: Array<Activity>;
+    isLoading: boolean;
+    sortBy: PortfolioActivitiesSortBy;
+    setSortBy: (s: PortfolioActivitiesSortBy) => void;
+    typeFilter: PortfolioActivitiesTypeFilter;
+    setTypeFilter: (t: PortfolioActivitiesTypeFilter) => void;
+    hasMore: boolean;
+    loadMore: () => void;
+}
+/**
+ * Script for the Phase 3 wallet-activities list. Mirrors the semantics of the
+ * token-activities list script: cursor pagination with reset on
+ * (sortBy / typeFilter / chain / address), plus live prepend when on the
+ * default view.
+ */
+declare function usePortfolioActivitiesScript({ chain, address, limit, initialSortBy, initialTypeFilter, }: UsePortfolioActivitiesScriptParams): UsePortfolioActivitiesScriptResult;
+
+interface PortfolioActivitiesWidgetProps {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialSortBy?: PortfolioActivitiesSortBy;
+    initialTypeFilter?: PortfolioActivitiesTypeFilter;
+    nativeDecimals?: number;
+    nativeSymbol?: string;
+    className?: string;
+    onRowClick?: (activity: Activity) => void;
+}
+/**
+ * Phase 3 wallet activities widget. Consumes
+ * `GET /v2/trade/{chain}/activities?walletAddress=…` via `useWalletActivitiesQuery`.
+ */
+declare function PortfolioActivitiesWidget({ chain, address, limit, initialSortBy, initialTypeFilter, nativeDecimals, nativeSymbol, className, onRowClick, }: PortfolioActivitiesWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface PortfolioNetWorthTokensProps {
+    data?: WalletPortfolios;
+    isLoading?: boolean;
+    className?: string;
+    now?: number;
+    onRowClick?: (portfolio: Portfolio) => void;
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+}
+/**
+ * Presentational net-worth-by-token table (Phase 3).
+ *
+ * Columns:
+ * - Token (symbol + truncated address)
+ * - Amount (native token)
+ * - Value (USD)
+ * - Avg cost (USD) — sparse (~0.2% fill)
+ * - Tags (wallet-for-token classifications)
+ * - Last active
+ */
+declare function PortfolioNetWorthTokens({ data, isLoading, className, now, onRowClick, onLoadMore, hasMore, }: PortfolioNetWorthTokensProps): react_jsx_runtime.JSX.Element;
+
+interface UsePortfolioNetWorthTokensScriptParams {
+    chain: Chain;
+    address: string;
+    /** page size */
+    limit?: number;
+}
+interface UsePortfolioNetWorthTokensScriptResult {
+    data?: WalletPortfolios;
+    isLoading: boolean;
+    hasMore: boolean;
+    loadMore: () => void;
+}
+/**
+ * Script for the Phase 3 portfolio net-worth-tokens list.
+ *
+ * Pagination: we accumulate pages into a single `WalletPortfolios` object so
+ * the UI can show the full list with infinite-scroll semantics while still
+ * carrying the summary fields (`balanceInUsd`, `balanceInNative`) from the
+ * first page.
+ */
+declare function usePortfolioNetWorthTokensScript({ chain, address, limit, }: UsePortfolioNetWorthTokensScriptParams): UsePortfolioNetWorthTokensScriptResult;
+
+interface PortfolioNetWorthTokensWidgetProps {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    className?: string;
+    onRowClick?: (portfolio: Portfolio) => void;
+}
+/**
+ * Phase 3 net-worth-by-token widget. Consumes
+ * `GET /v2/wallet/{chain}/{wallet}/net-worth/tokens` via
+ * `useWalletPortfoliosQuery` and surfaces the new fields
+ * (`isActive`, `avgCostUsd`, `lastActiveAt`, `walletTokenTags`).
+ */
+declare function PortfolioNetWorthTokensWidget({ chain, address, limit, className, onRowClick, }: PortfolioNetWorthTokensWidgetProps): react_jsx_runtime.JSX.Element;
+
+type PnlResolution = API.WalletPnlResolution;
+type PositionState = API.PositionState;
+type PnlSortBy = API.WalletPnlSortBy;
+interface PortfolioPnlDetailsProps {
+    data?: WalletPortfolioPnls;
+    isLoading?: boolean;
+    resolution: PnlResolution;
+    onResolutionChange: (r: PnlResolution) => void;
+    positionState: PositionState;
+    onPositionStateChange: (p: PositionState) => void;
+    sortBy: PnlSortBy;
+    onSortByChange: (s: PnlSortBy) => void;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+    now?: number;
+    className?: string;
+    onRowClick?: (pnl: PortfolioPnl) => void;
+}
+/**
+ * Presentational PnL details table (Phase 3). Shows per-position realized /
+ * unrealized / total PnL and the new Phase 3 fields (`isClosed`, `firstBuyAt`,
+ * `lastSellAt`). The summary row at the top shows aggregate PnL and win rate.
+ */
+declare function PortfolioPnlDetails({ data, isLoading, resolution, onResolutionChange, positionState, onPositionStateChange, sortBy, onSortByChange, hasMore, onLoadMore, now, className, onRowClick, }: PortfolioPnlDetailsProps): react_jsx_runtime.JSX.Element;
+
+interface UsePortfolioPnlDetailsScriptParams {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialResolution?: PnlResolution;
+    initialPositionState?: PositionState;
+    initialSortBy?: PnlSortBy;
+}
+interface UsePortfolioPnlDetailsScriptResult {
+    data?: WalletPortfolioPnls;
+    isLoading: boolean;
+    resolution: PnlResolution;
+    setResolution: (r: PnlResolution) => void;
+    positionState: PositionState;
+    setPositionState: (p: PositionState) => void;
+    sortBy: PnlSortBy;
+    setSortBy: (s: PnlSortBy) => void;
+    hasMore: boolean;
+    loadMore: () => void;
+}
+/**
+ * Script for the Phase 3 PnL-details widget.
+ *
+ * Pagination: accumulates cursor pages into a single `WalletPortfolioPnls`
+ * while keeping the header summary from the first page. Any of
+ * `resolution` / `positionState` / `sortBy` / `chain` / `address` changing
+ * triggers a full reset — the server invalidates cursors on any of these
+ * changes.
+ */
+declare function usePortfolioPnlDetailsScript({ chain, address, limit, initialResolution, initialPositionState, initialSortBy, }: UsePortfolioPnlDetailsScriptParams): UsePortfolioPnlDetailsScriptResult;
+
+interface PortfolioPnlDetailsWidgetProps {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialResolution?: PnlResolution;
+    initialPositionState?: PositionState;
+    initialSortBy?: PnlSortBy;
+    className?: string;
+    onRowClick?: (pnl: PortfolioPnl) => void;
+}
+/**
+ * Phase 3 PnL-details widget. Consumes
+ * `GET /v2/wallet/{chain}/{wallet}/pnl-details` via
+ * `useWalletPortfolioPnlsQuery` and renders the new fields (`isClosed`,
+ * `firstBuyAt`, `lastSellAt`) alongside resolution / positionState / sortBy
+ * selectors.
+ */
+declare function PortfolioPnlDetailsWidget({ chain, address, limit, initialResolution, initialPositionState, initialSortBy, className, onRowClick, }: PortfolioPnlDetailsWidgetProps): react_jsx_runtime.JSX.Element;
+
 declare const PortfolioClientContext: react.Context<IPortfolioClient | null>;
 
 /** Refetch function for wallet summary. */
@@ -453,4 +677,4 @@ declare function computeDistribution(holdings: SpotHolding[]): DistributionData;
  */
 declare function formatTime(epochMs: number): string;
 
-export { type AccountAction, AccountInfoUI, type AccountInfoUIProps, AccountInfoWidget, type AccountInfoWidgetProps, AddressRowUI, type AddressRowUIProps, AssetTab, AssetTabsUI, type AssetTabsUIProps, AsyncStatus, BalanceRowUI, type BalanceRowUIProps, BatchActionButton, type BatchActionButtonProps, ConfirmDialog, type ConfirmDialogProps, CurveCardUI, type CurveCardUIProps, CurveData, CurvePeriod, CurveQuery, CurveType, DistributionCardUI, type DistributionCardUIProps, DistributionData, HoldingsEmpty, type HoldingsEmptyProps, type HoldingsRenderProps, HoldingsSearch, type HoldingsSearchProps, HoldingsSectionWidget, type HoldingsSectionWidgetProps, HoldingsSubTabs, type HoldingsSubTabsProps, IPortfolioClient, PerpsHistoryData, PerpsHistoryQuery, PerpsPanelUI, type PerpsPanelUIProps, PerpsPosition, PerpsPositionsData, type PerpsSubTab, PortfolioClientContext, PortfolioClientProvider, type PortfolioClientProviderProps, PortfolioContext, type PortfolioContextValue, PortfolioOverview, PortfolioPageSkeleton, PortfolioPageWidget, type PortfolioPageWidgetProps, PortfolioProvider, type PortfolioProviderProps, PortfolioQuery, PredictionBet, PredictionBetsData, PredictionPanelUI, type PredictionPanelUIProps, PredictionSettledData, PredictionSettledQuery, type PredictionSubTab, type RefetchWalletSummaryFn, SpotHistoryData, SpotHistoryQuery, SpotHolding, SpotHoldingsData, SpotPanelUI, type SpotPanelUIProps, type SpotSubTab, type TokenPortfolio, type UseAccountInfoResult, type UseHoldingsSectionOptions, type UseHoldingsSectionResult, type UsePortfolioPageOptions, type UsePortfolioPageResult, type UseWalletPortfoliosParams, ViewingBannerUI, type ViewingBannerUIProps, type WalletOption, WalletSummary, computeDistribution, curveDataQueryKey, distributionQueryKey, formatPercent, formatSignedUsd, formatTime, formatTokenBalance, formatUsd, getExplorerUrl, overviewQueryKey, parseDecimal, perpsHistoryQueryKey, perpsPositionsQueryKey, predictionBetsQueryKey, predictionSettledQueryKey, splitUsd, spotHistoryQueryKey, spotHoldingsQueryKey, truncateAddress, useAccountInfo, useCurveDataQuery, useDistributionQuery, useHoldingsSection, useOverviewQuery, usePerpsHistoryQuery, usePerpsPositionsQuery, usePortfolioClient, usePortfolioContext, usePortfolioPage, usePredictionBetsQuery, usePredictionSettledQuery, useRefetchWalletSummary, useSpotHistoryQuery, useSpotHoldingsQuery, useWalletPortfolios, useWalletSummary, _default as version };
+export { type AccountAction, AccountInfoUI, type AccountInfoUIProps, AccountInfoWidget, type AccountInfoWidgetProps, AddressRowUI, type AddressRowUIProps, AssetTab, AssetTabsUI, type AssetTabsUIProps, AsyncStatus, BalanceRowUI, type BalanceRowUIProps, BatchActionButton, type BatchActionButtonProps, ConfirmDialog, type ConfirmDialogProps, CurveCardUI, type CurveCardUIProps, CurveData, CurvePeriod, CurveQuery, CurveType, DistributionCardUI, type DistributionCardUIProps, DistributionData, HoldingsEmpty, type HoldingsEmptyProps, type HoldingsRenderProps, HoldingsSearch, type HoldingsSearchProps, HoldingsSectionWidget, type HoldingsSectionWidgetProps, HoldingsSubTabs, type HoldingsSubTabsProps, IPortfolioClient, PerpsHistoryData, PerpsHistoryQuery, PerpsPanelUI, type PerpsPanelUIProps, PerpsPosition, PerpsPositionsData, type PerpsSubTab, type PnlResolution, type PnlSortBy, PortfolioActivities, type PortfolioActivitiesProps, type PortfolioActivitiesSortBy, type PortfolioActivitiesTypeFilter, PortfolioActivitiesWidget, type PortfolioActivitiesWidgetProps, PortfolioClientContext, PortfolioClientProvider, type PortfolioClientProviderProps, PortfolioContext, type PortfolioContextValue, PortfolioNetWorthTokens, type PortfolioNetWorthTokensProps, PortfolioNetWorthTokensWidget, type PortfolioNetWorthTokensWidgetProps, PortfolioOverview, PortfolioPageSkeleton, PortfolioPageWidget, type PortfolioPageWidgetProps, PortfolioPnlDetails, type PortfolioPnlDetailsProps, PortfolioPnlDetailsWidget, type PortfolioPnlDetailsWidgetProps, PortfolioProvider, type PortfolioProviderProps, PortfolioQuery, type PositionState, PredictionBet, PredictionBetsData, PredictionPanelUI, type PredictionPanelUIProps, PredictionSettledData, PredictionSettledQuery, type PredictionSubTab, type RefetchWalletSummaryFn, SpotHistoryData, SpotHistoryQuery, SpotHolding, SpotHoldingsData, SpotPanelUI, type SpotPanelUIProps, type SpotSubTab, TagBadge, TagBadgeList, type TagBadgeListProps, type TagBadgeProps, type TokenPortfolio, type UseAccountInfoResult, type UseHoldingsSectionOptions, type UseHoldingsSectionResult, type UsePortfolioActivitiesScriptParams, type UsePortfolioActivitiesScriptResult, type UsePortfolioNetWorthTokensScriptParams, type UsePortfolioNetWorthTokensScriptResult, type UsePortfolioPageOptions, type UsePortfolioPageResult, type UsePortfolioPnlDetailsScriptParams, type UsePortfolioPnlDetailsScriptResult, type UseWalletPortfoliosParams, ViewingBannerUI, type ViewingBannerUIProps, type WalletOption, WalletSummary, computeDistribution, curveDataQueryKey, distributionQueryKey, formatAgeShort, formatPercent, formatSignedUsd, formatTime, formatTokenBalance, formatUsd, getExplorerUrl, overviewQueryKey, parseDecimal, perpsHistoryQueryKey, perpsPositionsQueryKey, predictionBetsQueryKey, predictionSettledQueryKey, splitUsd, spotHistoryQueryKey, spotHoldingsQueryKey, truncateAddress, truncateMiddle, useAccountInfo, useCurveDataQuery, useDistributionQuery, useHoldingsSection, useOverviewQuery, usePerpsHistoryQuery, usePerpsPositionsQuery, usePortfolioActivitiesScript, usePortfolioClient, usePortfolioContext, usePortfolioNetWorthTokensScript, usePortfolioPage, usePortfolioPnlDetailsScript, usePredictionBetsQuery, usePredictionSettledQuery, useRefetchWalletSummary, useSpotHistoryQuery, useSpotHoldingsQuery, useWalletPortfolios, useWalletSummary, _default as version };