@uniswap/client-data-api 0.0.177 → 0.0.179

package/dist/data/v2/api_pb.d.ts

@@ -1768,8 +1768,9 @@ export declare class GetTokenTopTradersRequest extends Message<GetTokenTopTrader
  * flags transferred_in.
  *
  * UNKNOWN-BASIS ROWS: when the server cannot compute a wallet's basis — the
- * wallet transferred tokens in (transferred_in), or its auction spend was
- * not USD-convertible — basis_unknown is true and the four basis-derived
+ * wallet transferred tokens in (transferred_in), its auction spend was not
+ * USD-convertible, or its attributed inventory contradicts its observed
+ * balance — basis_unknown is true and the four basis-derived
  * money fields (cost_basis_usd, avg_cost_usd, realized_pnl_usd,
  * unrealized_pnl_usd) are served as 0 and MUST be read as "unknown", never
  * as a real $0.00. Such wallets rank strictly after every computable-PnL
@@ -1821,8 +1822,12 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
      */
     soldTokens: number;
     /**
-     * Tokens still held per the walk: acquired (bought + claimed +
-     * transferred in) minus sold, floored at 0.
+     * Tokens still held. For launch tokens this is the wallet's OBSERVED net
+     * balance — the same sum over transfer logs GetLaunchHolders serves, so
+     * the two agree and Σ over wallets cannot exceed supply. Tokens outside
+     * that feed fall back to the swap walk (acquired minus sold, floored at
+     * 0), an attribution that can overstate a wallet signing swaps it does
+     * not receive (relayers, bundlers, smart-account signers).
      *
      * @generated from field: double remaining_tokens = 8;
      */
@@ -1836,8 +1841,9 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
      */
     costBasisUsd: number;
     /**
-     * cost_basis_usd ÷ remaining_tokens; 0 for wallets holding nothing.
-     * Meaningless (served 0) when basis_unknown.
+     * cost_basis_usd ÷ the TRACKED quantity the basis was accumulated over
+     * (bought + claimed − sold), which is not necessarily remaining_tokens; 0
+     * when nothing is tracked. Meaningless (served 0) when basis_unknown.
      *
      * @generated from field: double avg_cost_usd = 10;
      */
@@ -1866,7 +1872,7 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
     hasClaims: boolean;
     /**
      * Mark-to-market PnL of the remaining position at the token's latest
-     * known price: remaining_tokens × (spot − avg_cost_usd). The documented
+     * known price: remaining_tokens × spot − cost_basis_usd. The documented
      * ranking tiebreak, served so clients can render it. Meaningless (served
      * 0) when unrealized_pnl_unknown — basis unknown, or no known spot price.
      *
@@ -1883,8 +1889,11 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
     transferredIn: boolean;
     /**
      * True when the wallet's basis could not be computed — it transferred
-     * tokens in (transferred_in), or its auction spend was not
-     * USD-convertible. Clients should render the four basis-derived money
+     * tokens in (transferred_in), its auction spend was not USD-convertible,
+     * or its attributed inventory contradicts its observed balance (the
+     * acquisitions were booked to the wrong address, so the basis they
+     * produced is not this wallet's). Clients should render the four
+     * basis-derived money
      * fields as unknown ("–"), not $0.00; the row ranks after every
      * computable-PnL row (see message doc). Implies unrealized_pnl_unknown.
      *

package/dist/data/v2/api_pb.js

@@ -2156,8 +2156,9 @@ GetTokenTopTradersRequest.fields = proto3.util.newFieldList(() => [
  * flags transferred_in.
  *
  * UNKNOWN-BASIS ROWS: when the server cannot compute a wallet's basis — the
- * wallet transferred tokens in (transferred_in), or its auction spend was
- * not USD-convertible — basis_unknown is true and the four basis-derived
+ * wallet transferred tokens in (transferred_in), its auction spend was not
+ * USD-convertible, or its attributed inventory contradicts its observed
+ * balance — basis_unknown is true and the four basis-derived
  * money fields (cost_basis_usd, avg_cost_usd, realized_pnl_usd,
  * unrealized_pnl_usd) are served as 0 and MUST be read as "unknown", never
  * as a real $0.00. Such wallets rank strictly after every computable-PnL
@@ -2211,8 +2212,12 @@ export class TokenTopTrader extends Message {
          */
         this.soldTokens = 0;
         /**
-         * Tokens still held per the walk: acquired (bought + claimed +
-         * transferred in) minus sold, floored at 0.
+         * Tokens still held. For launch tokens this is the wallet's OBSERVED net
+         * balance — the same sum over transfer logs GetLaunchHolders serves, so
+         * the two agree and Σ over wallets cannot exceed supply. Tokens outside
+         * that feed fall back to the swap walk (acquired minus sold, floored at
+         * 0), an attribution that can overstate a wallet signing swaps it does
+         * not receive (relayers, bundlers, smart-account signers).
          *
          * @generated from field: double remaining_tokens = 8;
          */
@@ -2226,8 +2231,9 @@ export class TokenTopTrader extends Message {
          */
         this.costBasisUsd = 0;
         /**
-         * cost_basis_usd ÷ remaining_tokens; 0 for wallets holding nothing.
-         * Meaningless (served 0) when basis_unknown.
+         * cost_basis_usd ÷ the TRACKED quantity the basis was accumulated over
+         * (bought + claimed − sold), which is not necessarily remaining_tokens; 0
+         * when nothing is tracked. Meaningless (served 0) when basis_unknown.
          *
          * @generated from field: double avg_cost_usd = 10;
          */
@@ -2256,7 +2262,7 @@ export class TokenTopTrader extends Message {
         this.hasClaims = false;
         /**
          * Mark-to-market PnL of the remaining position at the token's latest
-         * known price: remaining_tokens × (spot − avg_cost_usd). The documented
+         * known price: remaining_tokens × spot − cost_basis_usd. The documented
          * ranking tiebreak, served so clients can render it. Meaningless (served
          * 0) when unrealized_pnl_unknown — basis unknown, or no known spot price.
          *
@@ -2273,8 +2279,11 @@ export class TokenTopTrader extends Message {
         this.transferredIn = false;
         /**
          * True when the wallet's basis could not be computed — it transferred
-         * tokens in (transferred_in), or its auction spend was not
-         * USD-convertible. Clients should render the four basis-derived money
+         * tokens in (transferred_in), its auction spend was not USD-convertible,
+         * or its attributed inventory contradicts its observed balance (the
+         * acquisitions were booked to the wrong address, so the basis they
+         * produced is not this wallet's). Clients should render the four
+         * basis-derived money
          * fields as unknown ("–"), not $0.00; the row ranks after every
          * computable-PnL row (see message doc). Implies unrealized_pnl_unknown.
          *

package/dist/data/v2/types_pb.d.ts

@@ -1019,8 +1019,8 @@ export declare class PoolRankStats extends Message<PoolRankStats> {
     static equals(a: PoolRankStats | PlainMessage<PoolRankStats> | undefined, b: PoolRankStats | PlainMessage<PoolRankStats> | undefined): boolean;
 }
 /**
- * A pool with its protocol identity and token pair. No stats — stats live on
- * RankedPool.
+ * A pool's protocol identity, token pair, and current on-chain state. No
+ * pipeline-computed stats (TVL/volume/APR) — those live on RankedPool.
  *
  * @generated from message data.v2.Pool
  */
@@ -1069,6 +1069,24 @@ export declare class Pool extends Message<Pool> {
      * @generated from field: optional string hook_address = 9;
      */
     hookAddress?: string;
+    /**
+     * V3/V4 only; absent when no state row is indexed yet
+     *
+     * @generated from field: optional int32 current_tick = 10;
+     */
+    currentTick?: number;
+    /**
+     * uint160 as decimal string; V3/V4 only
+     *
+     * @generated from field: optional string sqrt_price_x96 = 11;
+     */
+    sqrtPriceX96?: string;
+    /**
+     * uint128 as decimal string; V3/V4 only
+     *
+     * @generated from field: optional string liquidity = 12;
+     */
+    liquidity?: string;
     constructor(data?: PartialMessage<Pool>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.Pool";

package/dist/data/v2/types_pb.js

@@ -1155,8 +1155,8 @@ PoolRankStats.fields = proto3.util.newFieldList(() => [
     { no: 7, name: "volume_1d_tvl_ratio", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
 ]);
 /**
- * A pool with its protocol identity and token pair. No stats — stats live on
- * RankedPool.
+ * A pool's protocol identity, token pair, and current on-chain state. No
+ * pipeline-computed stats (TVL/volume/APR) — those live on RankedPool.
  *
  * @generated from message data.v2.Pool
  */
@@ -1210,6 +1210,9 @@ Pool.fields = proto3.util.newFieldList(() => [
     { no: 7, name: "fee_tier", kind: "scalar", T: 13 /* ScalarType.UINT32 */, opt: true },
     { no: 8, name: "is_dynamic_fee", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
     { no: 9, name: "hook_address", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 10, name: "current_tick", kind: "scalar", T: 5 /* ScalarType.INT32 */, opt: true },
+    { no: 11, name: "sqrt_price_x96", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 12, name: "liquidity", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
 ]);
 /**
  * @generated from message data.v2.PoolTokenFilter

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uniswap/client-data-api",
-    "version": "0.0.177",
+    "version": "0.0.179",
     "publishConfig": {
       "access": "public"
     },