@uniswap/client-data-api 0.0.177 → 0.0.178

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/package.json

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