@liberfi.io/types 0.4.29 → 0.4.30

package/dist/api/index.d.mts

@@ -321,10 +321,14 @@ interface GetTradesOptions extends CursorListOptions {
 }
 /**
  * Sort field for activity list (Phase 3).
- * - `timestamp` — order by activity time (default, descending)
+ * - `timestamp` — order by activity time
  * - `totalUsd` — order by USD amount (useful for finding whale trades)
  */
 type ActivitiesSortBy = "timestamp" | "totalUsd";
+/**
+ * Sort direction for activity list (Phase 3).
+ */
+type ActivitiesSortDirection = "asc" | "desc";
 /**
  * Options for getting activities.
  */
@@ -342,10 +346,15 @@ interface GetActivitiesOptions extends CursorListOptions {
     /** filter activities by pool address */
     poolAddress?: string;
     /**
-     * Sort field (Phase 3). Defaults to `timestamp` on the server. When changing
-     * `sortBy`, the caller must discard the previous cursor and restart from page 1.
+     * Sort field (Phase 3). Defaults to `timestamp` on the server.
      */
     sortBy?: ActivitiesSortBy;
+    /**
+     * Sort direction (Phase 3). Defaults to `desc` on the server. When changing
+     * `sortBy` or `sortDirection`, the caller must discard the previous cursor
+     * and restart from page 1.
+     */
+    sortDirection?: ActivitiesSortDirection;
 }
 
 /**
@@ -1690,7 +1699,7 @@ interface SearchTokenCursorList extends CursorList<Token> {
  * - `holdingUsd`     — order by holding value in USD (default, descending)
  * - `lastActiveAt`   — order by wallet's last activity time
  */
-type TokenHoldersSortBy = "holdingUsd" | "lastActiveAt" | "realizedPnl" | "buyVolume" | "sellVolume";
+type TokenHoldersSortBy = "amountPercentage" | "holdingUsd" | "usdValue" | "totalPnl" | "lastActiveAt" | "realizedPnl" | "unrealizedPnl" | "buyVolume" | "sellVolume" | "netflowUsd" | "createdAt";
 /**
  * Options for getting token holders (Phase 3).
  */
@@ -1700,19 +1709,34 @@ interface GetTokenHoldersOptions extends CursorListOptions {
      * Switching `sortBy` requires discarding the old cursor and restarting from page 1.
      */
     sortBy?: TokenHoldersSortBy;
+    /**
+     * Sort direction. Defaults to `desc` on the server.
+     * Switching `sortDirection` requires discarding the old cursor and restarting from page 1.
+     */
+    sortDirection?: "asc" | "desc";
 }
 /**
  * Sort field for token top-traders query.
  */
-type TokenTopTradersSortBy = "profit" | "buyVolume" | "sellVolume" | "lastActiveAt" | "netflowUsd";
+type TokenTopTradersSortBy = "profit" | "totalPnl" | "realizedPnl" | "unrealizedPnl" | "buyVolume" | "sellVolume" | "lastActiveAt" | "netflowUsd" | "createdAt";
+/**
+ * Sort direction for token top-traders query.
+ */
+type TokenTopTradersSortDirection = "asc" | "desc";
 /**
  * Options for getting token top traders.
  */
 interface GetTokenTopTradersOptions extends CursorListOptions {
     /**
-     * Sort field. Defaults to `profit` on the server.
+     * Sort field. Defaults to `totalPnl` on the server.
+     *
+     * `profit` is kept for backward compatibility and maps to `totalPnl`.
      */
     sortBy?: TokenTopTradersSortBy;
+    /**
+     * Sort direction. Defaults to `desc` on the server.
+     */
+    sortDirection?: TokenTopTradersSortDirection;
     /**
      * Filter by wallet tag.
      */
@@ -2153,4 +2177,4 @@ interface ISubscribeClient {
     subscribeStockTokens(chain: Chain, callback: (data: Array<TokenSubscribed>) => void): ISubscription;
 }
 
-export { type ActivityToken as A, type ActivitiesSortBy, type Portfolio as B, type BlockchainLatestBlock, Chain as C, type CursorList, type CursorListOptions, type CursorPagination, type WalletPnl as D, type WalletPortfolioPnls as E, type WalletPortfolios as F, type GetActivitiesOptions, type GetTokenCandlesOptions, type GetTokenHoldersOptions, type GetTokenListOptions, type GetTokenTopTradersOptions, type GetTokensByCreatorOptions, type GetTradesOptions, type GetWalletLimitOrdersOptions, type GetWalletPortfolioPnlsOptions, type IClient, type ISubscribeClient, type ISubscription, type LimitOrderSide as L, type LatestBlockParams, type PoolDex as P, type PortfolioPnlSubscribed, type PortfolioSubscribed, type PositionState, SolanaTokenProtocol as S, type SearchTokenCursorList, type SearchTokensOptions, type SendTxParams, type SendTxResult, type SwapDex, SwapMode, type SwapParams, type SwapRoute, type SwapRoutePlan, type Trade as T, type TokenFieldOption, type TokenFilterOption, type TokenHoldersSortBy, type TokenSubscribed, type TokenTopTradersSortBy, type TrendingResolution, type WalletTag as W, type WalletPnlResolution, type WalletPnlSortBy, type WalletPnlSubscribed, type ActivityDex as a, type ActivityType as b, type Activity as c, ChainNamespace as d, type LimitOrderState as e, type LimitOrder as f, type PoolBalance as g, type Pool as h, type PoolSubscribed as i, type TokenProtocol as j, SOLANA_TOKEN_PROTOCOLS as k, type Token as l, type TokenCreator as m, type TokenLaunchedFrom as n, type TokenMigratedTo as o, type TokenSocialMedias as p, type TokenStats as q, type TokenStatsByResolution as r, type TokenMarketData as s, type TokenLiquidity as t, type TokenSecurity as u, type TokenResolution as v, type TokenCandle as w, type TokenHolder as x, type TokenTopTrader as y, type PortfolioPnl as z };
+export { type ActivityToken as A, type ActivitiesSortBy, type ActivitiesSortDirection, type Portfolio as B, type BlockchainLatestBlock, Chain as C, type CursorList, type CursorListOptions, type CursorPagination, type WalletPnl as D, type WalletPortfolioPnls as E, type WalletPortfolios as F, type GetActivitiesOptions, type GetTokenCandlesOptions, type GetTokenHoldersOptions, type GetTokenListOptions, type GetTokenTopTradersOptions, type GetTokensByCreatorOptions, type GetTradesOptions, type GetWalletLimitOrdersOptions, type GetWalletPortfolioPnlsOptions, type IClient, type ISubscribeClient, type ISubscription, type LimitOrderSide as L, type LatestBlockParams, type PoolDex as P, type PortfolioPnlSubscribed, type PortfolioSubscribed, type PositionState, SolanaTokenProtocol as S, type SearchTokenCursorList, type SearchTokensOptions, type SendTxParams, type SendTxResult, type SwapDex, SwapMode, type SwapParams, type SwapRoute, type SwapRoutePlan, type Trade as T, type TokenFieldOption, type TokenFilterOption, type TokenHoldersSortBy, type TokenSubscribed, type TokenTopTradersSortBy, type TokenTopTradersSortDirection, type TrendingResolution, type WalletTag as W, type WalletPnlResolution, type WalletPnlSortBy, type WalletPnlSubscribed, type ActivityDex as a, type ActivityType as b, type Activity as c, ChainNamespace as d, type LimitOrderState as e, type LimitOrder as f, type PoolBalance as g, type Pool as h, type PoolSubscribed as i, type TokenProtocol as j, SOLANA_TOKEN_PROTOCOLS as k, type Token as l, type TokenCreator as m, type TokenLaunchedFrom as n, type TokenMigratedTo as o, type TokenSocialMedias as p, type TokenStats as q, type TokenStatsByResolution as r, type TokenMarketData as s, type TokenLiquidity as t, type TokenSecurity as u, type TokenResolution as v, type TokenCandle as w, type TokenHolder as x, type TokenTopTrader as y, type PortfolioPnl as z };

package/dist/api/index.d.ts

@@ -321,10 +321,14 @@ interface GetTradesOptions extends CursorListOptions {
 }
 /**
  * Sort field for activity list (Phase 3).
- * - `timestamp` — order by activity time (default, descending)
+ * - `timestamp` — order by activity time
  * - `totalUsd` — order by USD amount (useful for finding whale trades)
  */
 type ActivitiesSortBy = "timestamp" | "totalUsd";
+/**
+ * Sort direction for activity list (Phase 3).
+ */
+type ActivitiesSortDirection = "asc" | "desc";
 /**
  * Options for getting activities.
  */
@@ -342,10 +346,15 @@ interface GetActivitiesOptions extends CursorListOptions {
     /** filter activities by pool address */
     poolAddress?: string;
     /**
-     * Sort field (Phase 3). Defaults to `timestamp` on the server. When changing
-     * `sortBy`, the caller must discard the previous cursor and restart from page 1.
+     * Sort field (Phase 3). Defaults to `timestamp` on the server.
      */
     sortBy?: ActivitiesSortBy;
+    /**
+     * Sort direction (Phase 3). Defaults to `desc` on the server. When changing
+     * `sortBy` or `sortDirection`, the caller must discard the previous cursor
+     * and restart from page 1.
+     */
+    sortDirection?: ActivitiesSortDirection;
 }
 
 /**
@@ -1690,7 +1699,7 @@ interface SearchTokenCursorList extends CursorList<Token> {
  * - `holdingUsd`     — order by holding value in USD (default, descending)
  * - `lastActiveAt`   — order by wallet's last activity time
  */
-type TokenHoldersSortBy = "holdingUsd" | "lastActiveAt" | "realizedPnl" | "buyVolume" | "sellVolume";
+type TokenHoldersSortBy = "amountPercentage" | "holdingUsd" | "usdValue" | "totalPnl" | "lastActiveAt" | "realizedPnl" | "unrealizedPnl" | "buyVolume" | "sellVolume" | "netflowUsd" | "createdAt";
 /**
  * Options for getting token holders (Phase 3).
  */
@@ -1700,19 +1709,34 @@ interface GetTokenHoldersOptions extends CursorListOptions {
      * Switching `sortBy` requires discarding the old cursor and restarting from page 1.
      */
     sortBy?: TokenHoldersSortBy;
+    /**
+     * Sort direction. Defaults to `desc` on the server.
+     * Switching `sortDirection` requires discarding the old cursor and restarting from page 1.
+     */
+    sortDirection?: "asc" | "desc";
 }
 /**
  * Sort field for token top-traders query.
  */
-type TokenTopTradersSortBy = "profit" | "buyVolume" | "sellVolume" | "lastActiveAt" | "netflowUsd";
+type TokenTopTradersSortBy = "profit" | "totalPnl" | "realizedPnl" | "unrealizedPnl" | "buyVolume" | "sellVolume" | "lastActiveAt" | "netflowUsd" | "createdAt";
+/**
+ * Sort direction for token top-traders query.
+ */
+type TokenTopTradersSortDirection = "asc" | "desc";
 /**
  * Options for getting token top traders.
  */
 interface GetTokenTopTradersOptions extends CursorListOptions {
     /**
-     * Sort field. Defaults to `profit` on the server.
+     * Sort field. Defaults to `totalPnl` on the server.
+     *
+     * `profit` is kept for backward compatibility and maps to `totalPnl`.
      */
     sortBy?: TokenTopTradersSortBy;
+    /**
+     * Sort direction. Defaults to `desc` on the server.
+     */
+    sortDirection?: TokenTopTradersSortDirection;
     /**
      * Filter by wallet tag.
      */
@@ -2153,4 +2177,4 @@ interface ISubscribeClient {
     subscribeStockTokens(chain: Chain, callback: (data: Array<TokenSubscribed>) => void): ISubscription;
 }
 
-export { type ActivityToken as A, type ActivitiesSortBy, type Portfolio as B, type BlockchainLatestBlock, Chain as C, type CursorList, type CursorListOptions, type CursorPagination, type WalletPnl as D, type WalletPortfolioPnls as E, type WalletPortfolios as F, type GetActivitiesOptions, type GetTokenCandlesOptions, type GetTokenHoldersOptions, type GetTokenListOptions, type GetTokenTopTradersOptions, type GetTokensByCreatorOptions, type GetTradesOptions, type GetWalletLimitOrdersOptions, type GetWalletPortfolioPnlsOptions, type IClient, type ISubscribeClient, type ISubscription, type LimitOrderSide as L, type LatestBlockParams, type PoolDex as P, type PortfolioPnlSubscribed, type PortfolioSubscribed, type PositionState, SolanaTokenProtocol as S, type SearchTokenCursorList, type SearchTokensOptions, type SendTxParams, type SendTxResult, type SwapDex, SwapMode, type SwapParams, type SwapRoute, type SwapRoutePlan, type Trade as T, type TokenFieldOption, type TokenFilterOption, type TokenHoldersSortBy, type TokenSubscribed, type TokenTopTradersSortBy, type TrendingResolution, type WalletTag as W, type WalletPnlResolution, type WalletPnlSortBy, type WalletPnlSubscribed, type ActivityDex as a, type ActivityType as b, type Activity as c, ChainNamespace as d, type LimitOrderState as e, type LimitOrder as f, type PoolBalance as g, type Pool as h, type PoolSubscribed as i, type TokenProtocol as j, SOLANA_TOKEN_PROTOCOLS as k, type Token as l, type TokenCreator as m, type TokenLaunchedFrom as n, type TokenMigratedTo as o, type TokenSocialMedias as p, type TokenStats as q, type TokenStatsByResolution as r, type TokenMarketData as s, type TokenLiquidity as t, type TokenSecurity as u, type TokenResolution as v, type TokenCandle as w, type TokenHolder as x, type TokenTopTrader as y, type PortfolioPnl as z };
+export { type ActivityToken as A, type ActivitiesSortBy, type ActivitiesSortDirection, type Portfolio as B, type BlockchainLatestBlock, Chain as C, type CursorList, type CursorListOptions, type CursorPagination, type WalletPnl as D, type WalletPortfolioPnls as E, type WalletPortfolios as F, type GetActivitiesOptions, type GetTokenCandlesOptions, type GetTokenHoldersOptions, type GetTokenListOptions, type GetTokenTopTradersOptions, type GetTokensByCreatorOptions, type GetTradesOptions, type GetWalletLimitOrdersOptions, type GetWalletPortfolioPnlsOptions, type IClient, type ISubscribeClient, type ISubscription, type LimitOrderSide as L, type LatestBlockParams, type PoolDex as P, type PortfolioPnlSubscribed, type PortfolioSubscribed, type PositionState, SolanaTokenProtocol as S, type SearchTokenCursorList, type SearchTokensOptions, type SendTxParams, type SendTxResult, type SwapDex, SwapMode, type SwapParams, type SwapRoute, type SwapRoutePlan, type Trade as T, type TokenFieldOption, type TokenFilterOption, type TokenHoldersSortBy, type TokenSubscribed, type TokenTopTradersSortBy, type TokenTopTradersSortDirection, type TrendingResolution, type WalletTag as W, type WalletPnlResolution, type WalletPnlSortBy, type WalletPnlSubscribed, type ActivityDex as a, type ActivityType as b, type Activity as c, ChainNamespace as d, type LimitOrderState as e, type LimitOrder as f, type PoolBalance as g, type Pool as h, type PoolSubscribed as i, type TokenProtocol as j, SOLANA_TOKEN_PROTOCOLS as k, type Token as l, type TokenCreator as m, type TokenLaunchedFrom as n, type TokenMigratedTo as o, type TokenSocialMedias as p, type TokenStats as q, type TokenStatsByResolution as r, type TokenMarketData as s, type TokenLiquidity as t, type TokenSecurity as u, type TokenResolution as v, type TokenCandle as w, type TokenHolder as x, type TokenTopTrader as y, type PortfolioPnl as z };

package/dist/index.d.mts

@@ -1 +1 @@
-export { ActivitiesSortBy, c as Activity, a as ActivityDex, A as ActivityToken, b as ActivityType, BlockchainLatestBlock, C as Chain, d as ChainNamespace, CursorList, CursorListOptions, CursorPagination, GetActivitiesOptions, GetTokenCandlesOptions, GetTokenHoldersOptions, GetTokenListOptions, GetTokenTopTradersOptions, GetTokensByCreatorOptions, GetTradesOptions, GetWalletLimitOrdersOptions, GetWalletPortfolioPnlsOptions, IClient, ISubscribeClient, ISubscription, LatestBlockParams, f as LimitOrder, L as LimitOrderSide, e as LimitOrderState, h as Pool, g as PoolBalance, P as PoolDex, i as PoolSubscribed, B as Portfolio, z as PortfolioPnl, PortfolioPnlSubscribed, PortfolioSubscribed, PositionState, k as SOLANA_TOKEN_PROTOCOLS, SearchTokenCursorList, SearchTokensOptions, SendTxParams, SendTxResult, S as SolanaTokenProtocol, SwapDex, SwapMode, SwapParams, SwapRoute, SwapRoutePlan, l as Token, w as TokenCandle, m as TokenCreator, TokenFieldOption, TokenFilterOption, x as TokenHolder, TokenHoldersSortBy, n as TokenLaunchedFrom, t as TokenLiquidity, s as TokenMarketData, o as TokenMigratedTo, j as TokenProtocol, v as TokenResolution, u as TokenSecurity, p as TokenSocialMedias, q as TokenStats, r as TokenStatsByResolution, TokenSubscribed, y as TokenTopTrader, TokenTopTradersSortBy, T as Trade, TrendingResolution, D as WalletPnl, WalletPnlResolution, WalletPnlSortBy, WalletPnlSubscribed, E as WalletPortfolioPnls, F as WalletPortfolios, W as WalletTag } from './api/index.mjs';
+export { ActivitiesSortBy, ActivitiesSortDirection, c as Activity, a as ActivityDex, A as ActivityToken, b as ActivityType, BlockchainLatestBlock, C as Chain, d as ChainNamespace, CursorList, CursorListOptions, CursorPagination, GetActivitiesOptions, GetTokenCandlesOptions, GetTokenHoldersOptions, GetTokenListOptions, GetTokenTopTradersOptions, GetTokensByCreatorOptions, GetTradesOptions, GetWalletLimitOrdersOptions, GetWalletPortfolioPnlsOptions, IClient, ISubscribeClient, ISubscription, LatestBlockParams, f as LimitOrder, L as LimitOrderSide, e as LimitOrderState, h as Pool, g as PoolBalance, P as PoolDex, i as PoolSubscribed, B as Portfolio, z as PortfolioPnl, PortfolioPnlSubscribed, PortfolioSubscribed, PositionState, k as SOLANA_TOKEN_PROTOCOLS, SearchTokenCursorList, SearchTokensOptions, SendTxParams, SendTxResult, S as SolanaTokenProtocol, SwapDex, SwapMode, SwapParams, SwapRoute, SwapRoutePlan, l as Token, w as TokenCandle, m as TokenCreator, TokenFieldOption, TokenFilterOption, x as TokenHolder, TokenHoldersSortBy, n as TokenLaunchedFrom, t as TokenLiquidity, s as TokenMarketData, o as TokenMigratedTo, j as TokenProtocol, v as TokenResolution, u as TokenSecurity, p as TokenSocialMedias, q as TokenStats, r as TokenStatsByResolution, TokenSubscribed, y as TokenTopTrader, TokenTopTradersSortBy, TokenTopTradersSortDirection, T as Trade, TrendingResolution, D as WalletPnl, WalletPnlResolution, WalletPnlSortBy, WalletPnlSubscribed, E as WalletPortfolioPnls, F as WalletPortfolios, W as WalletTag } from './api/index.mjs';

package/dist/index.d.ts

@@ -1 +1 @@
-export { ActivitiesSortBy, c as Activity, a as ActivityDex, A as ActivityToken, b as ActivityType, BlockchainLatestBlock, C as Chain, d as ChainNamespace, CursorList, CursorListOptions, CursorPagination, GetActivitiesOptions, GetTokenCandlesOptions, GetTokenHoldersOptions, GetTokenListOptions, GetTokenTopTradersOptions, GetTokensByCreatorOptions, GetTradesOptions, GetWalletLimitOrdersOptions, GetWalletPortfolioPnlsOptions, IClient, ISubscribeClient, ISubscription, LatestBlockParams, f as LimitOrder, L as LimitOrderSide, e as LimitOrderState, h as Pool, g as PoolBalance, P as PoolDex, i as PoolSubscribed, B as Portfolio, z as PortfolioPnl, PortfolioPnlSubscribed, PortfolioSubscribed, PositionState, k as SOLANA_TOKEN_PROTOCOLS, SearchTokenCursorList, SearchTokensOptions, SendTxParams, SendTxResult, S as SolanaTokenProtocol, SwapDex, SwapMode, SwapParams, SwapRoute, SwapRoutePlan, l as Token, w as TokenCandle, m as TokenCreator, TokenFieldOption, TokenFilterOption, x as TokenHolder, TokenHoldersSortBy, n as TokenLaunchedFrom, t as TokenLiquidity, s as TokenMarketData, o as TokenMigratedTo, j as TokenProtocol, v as TokenResolution, u as TokenSecurity, p as TokenSocialMedias, q as TokenStats, r as TokenStatsByResolution, TokenSubscribed, y as TokenTopTrader, TokenTopTradersSortBy, T as Trade, TrendingResolution, D as WalletPnl, WalletPnlResolution, WalletPnlSortBy, WalletPnlSubscribed, E as WalletPortfolioPnls, F as WalletPortfolios, W as WalletTag } from './api/index.js';
+export { ActivitiesSortBy, ActivitiesSortDirection, c as Activity, a as ActivityDex, A as ActivityToken, b as ActivityType, BlockchainLatestBlock, C as Chain, d as ChainNamespace, CursorList, CursorListOptions, CursorPagination, GetActivitiesOptions, GetTokenCandlesOptions, GetTokenHoldersOptions, GetTokenListOptions, GetTokenTopTradersOptions, GetTokensByCreatorOptions, GetTradesOptions, GetWalletLimitOrdersOptions, GetWalletPortfolioPnlsOptions, IClient, ISubscribeClient, ISubscription, LatestBlockParams, f as LimitOrder, L as LimitOrderSide, e as LimitOrderState, h as Pool, g as PoolBalance, P as PoolDex, i as PoolSubscribed, B as Portfolio, z as PortfolioPnl, PortfolioPnlSubscribed, PortfolioSubscribed, PositionState, k as SOLANA_TOKEN_PROTOCOLS, SearchTokenCursorList, SearchTokensOptions, SendTxParams, SendTxResult, S as SolanaTokenProtocol, SwapDex, SwapMode, SwapParams, SwapRoute, SwapRoutePlan, l as Token, w as TokenCandle, m as TokenCreator, TokenFieldOption, TokenFilterOption, x as TokenHolder, TokenHoldersSortBy, n as TokenLaunchedFrom, t as TokenLiquidity, s as TokenMarketData, o as TokenMigratedTo, j as TokenProtocol, v as TokenResolution, u as TokenSecurity, p as TokenSocialMedias, q as TokenStats, r as TokenStatsByResolution, TokenSubscribed, y as TokenTopTrader, TokenTopTradersSortBy, TokenTopTradersSortDirection, T as Trade, TrendingResolution, D as WalletPnl, WalletPnlResolution, WalletPnlSortBy, WalletPnlSubscribed, E as WalletPortfolioPnls, F as WalletPortfolios, W as WalletTag } from './api/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liberfi.io/types",
-  "version": "0.4.29",
+  "version": "0.4.30",
   "description": "Liberfi React SDK types",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -24,7 +24,7 @@
   "devDependencies": {
     "tsup": "^8.5.0",
     "typedoc": "^0.28.12",
-    "tsconfig": "0.1.212"
+    "tsconfig": "0.1.213"
   },
   "publishConfig": {
     "access": "public"