@uniswap/client-liquidity 1.4.37 → 1.4.39

package/dist/uniswap/liquidity/v2/api_pb.d.ts

@@ -1,7 +1,7 @@
 import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
 import { Message, proto3 } from "@bufbuild/protobuf";
 import { ChainId, NFTPermitData, PermitBatchData, Protocols, TransactionRequest, V3Position } from "../v1/types_pb.js";
-import { ApprovalTransactionRequest, CreatePoolParameters, CreatePositionExistingPoolParameters, CreateToken, GasUrgency, HistoryDuration, HookEntry, LPAction, LPToken, PoolPricePoint, PoolReference, PoolSummary, PoolTick, PoolTransaction, PoolTransactionCursor, PoolVolumeBucket, Position, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
+import { ApprovalTransactionRequest, CreatePoolParameters, CreatePositionExistingPoolParameters, CreateToken, GasUrgency, HistoryDuration, HookEntry, LPAction, LPToken, PoolPricePoint, PoolReference, PoolSummary, PoolTick, PoolTransaction, PoolTransactionCursor, PoolVolumeBucket, Position, PositionGroup, PositionGroupTarget, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
 /**
  * MigrateV2ToV3LPPosition
  *
@@ -1172,6 +1172,39 @@ export declare class GetWalletPositionsRequest extends Message<GetWalletPosition
      * @generated from field: optional string search = 11;
      */
     search?: string;
+    /**
+     * Group a wallet's positions by token pair. When true, positions sharing a
+     * pair on the same chain are collapsed into one PositionGroup and the response
+     * returns `groups` instead of `positions`. The pair key is (chain, token0,
+     * token1) with each chain's wrapped native normalized to native, so a V4
+     * ETH/USDC pool and a V3 WETH/USDC pool group together; protocol version and
+     * fee tier do NOT split a group. Grouping needs resolved token identity, so
+     * (like search/sort) it reads the whole bounded set, enriches, groups, then
+     * pages by offset OVER GROUPS — a group never splits across a page. Composes
+     * with search, statuses, range_statuses, modifier, and sort_by (groups order
+     * by their top-ranked member). Absent/false = the flat `positions` list.
+     *
+     * @generated from field: optional bool group = 12;
+     */
+    group?: boolean;
+    /**
+     * On a grouped read, cap how many positions each group returns inline. The
+     * group-level totals and total_position_count still cover ALL members, so a
+     * capped page keeps correct aggregates. Absent = a service default; 0 = totals
+     * only (no inline positions). Ignored when group is false.
+     *
+     * @generated from field: optional int32 positions_per_group_limit = 13;
+     */
+    positionsPerGroupLimit?: number;
+    /**
+     * Expand a single group: return only that group's positions, paged by offset
+     * within the group. Implies a grouped read (group need not be set) and the
+     * response's `groups` holds just the one targeted group. Its own limit/offset
+     * page the positions inside the group; the top-level limit/cursor are ignored.
+     *
+     * @generated from field: optional uniswap.liquidity.v2.PositionGroupTarget group_target = 14;
+     */
+    groupTarget?: PositionGroupTarget;
     constructor(data?: PartialMessage<GetWalletPositionsRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "uniswap.liquidity.v2.GetWalletPositionsRequest";
@@ -1186,6 +1219,8 @@ export declare class GetWalletPositionsRequest extends Message<GetWalletPosition
  */
 export declare class GetWalletPositionsResponse extends Message<GetWalletPositionsResponse> {
     /**
+     * Populated when the request did not set group=true.
+     *
      * @generated from field: repeated uniswap.liquidity.v2.Position positions = 1;
      */
     positions: Position[];
@@ -1193,6 +1228,12 @@ export declare class GetWalletPositionsResponse extends Message<GetWalletPositio
      * @generated from field: optional uniswap.liquidity.v2.PositionListCursor next_cursor = 2;
      */
     nextCursor?: PositionListCursor;
+    /**
+     * Populated when the request set group=true (and `positions` is then empty).
+     *
+     * @generated from field: repeated uniswap.liquidity.v2.PositionGroup groups = 3;
+     */
+    groups: PositionGroup[];
     constructor(data?: PartialMessage<GetWalletPositionsResponse>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "uniswap.liquidity.v2.GetWalletPositionsResponse";

package/dist/uniswap/liquidity/v2/api_pb.js

@@ -4,7 +4,7 @@
 // @ts-nocheck
 import { Message, proto3 } from "@bufbuild/protobuf";
 import { ChainId, NFTPermitData, PermitBatchData, Protocols, TransactionRequest, V3Position } from "../v1/types_pb.js";
-import { ApprovalTransactionRequest, CreatePoolParameters, CreatePositionExistingPoolParameters, CreateToken, GasUrgency, HistoryDuration, HookEntry, LPAction, LPToken, PoolPricePoint, PoolReference, PoolSummary, PoolTick, PoolTransaction, PoolTransactionCursor, PoolVolumeBucket, Position, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
+import { ApprovalTransactionRequest, CreatePoolParameters, CreatePositionExistingPoolParameters, CreateToken, GasUrgency, HistoryDuration, HookEntry, LPAction, LPToken, PoolPricePoint, PoolReference, PoolSummary, PoolTick, PoolTransaction, PoolTransactionCursor, PoolVolumeBucket, Position, PositionGroup, PositionGroupTarget, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
 /**
  * MigrateV2ToV3LPPosition
  *
@@ -1221,6 +1221,9 @@ GetWalletPositionsRequest.fields = proto3.util.newFieldList(() => [
     { no: 9, name: "sort_by", kind: "enum", T: proto3.getEnumType(PositionSortBy), opt: true },
     { no: 10, name: "ascending", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
     { no: 11, name: "search", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 12, name: "group", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
+    { no: 13, name: "positions_per_group_limit", kind: "scalar", T: 5 /* ScalarType.INT32 */, opt: true },
+    { no: 14, name: "group_target", kind: "message", T: PositionGroupTarget, opt: true },
 ]);
 /**
  * @generated from message uniswap.liquidity.v2.GetWalletPositionsResponse
@@ -1229,9 +1232,17 @@ export class GetWalletPositionsResponse extends Message {
     constructor(data) {
         super();
         /**
+         * Populated when the request did not set group=true.
+         *
          * @generated from field: repeated uniswap.liquidity.v2.Position positions = 1;
          */
         this.positions = [];
+        /**
+         * Populated when the request set group=true (and `positions` is then empty).
+         *
+         * @generated from field: repeated uniswap.liquidity.v2.PositionGroup groups = 3;
+         */
+        this.groups = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -1252,6 +1263,7 @@ GetWalletPositionsResponse.typeName = "uniswap.liquidity.v2.GetWalletPositionsRe
 GetWalletPositionsResponse.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "positions", kind: "message", T: Position, repeated: true },
     { no: 2, name: "next_cursor", kind: "message", T: PositionListCursor, opt: true },
+    { no: 3, name: "groups", kind: "message", T: PositionGroup, repeated: true },
 ]);
 /**
  * GetWalletPositionsBalance — aggregate USD value of a wallet's LP positions

package/dist/uniswap/liquidity/v2/types_pb.d.ts

@@ -1439,6 +1439,137 @@ export declare class Position extends Message<Position> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): Position;
     static equals(a: Position | PlainMessage<Position> | undefined, b: Position | PlainMessage<Position> | undefined): boolean;
 }
+/**
+ * A wallet's positions collapsed by token pair, returned by GetWalletPositions
+ * when the request sets group=true. Every position in a group shares the pair
+ * key (chain_id, token0_address, token1_address) after normalizing each chain's
+ * wrapped native to native — so V2/V3/V4 and all fee tiers of the same pair land
+ * together. Positions whose pool metadata could not be resolved (no token
+ * identity) each form their own singleton group and leave the pair fields unset.
+ *
+ * @generated from message uniswap.liquidity.v2.PositionGroup
+ */
+export declare class PositionGroup extends Message<PositionGroup> {
+    /**
+     * @generated from field: int32 chain_id = 1;
+     */
+    chainId: number;
+    /**
+     * The group's pair, in canonical (token0 < token1) order after wrapped-native
+     * normalization. Prefers a native member's identity when the group holds one
+     * (so an ETH/WETH-mixed group displays ETH), else the wrapped token. Unset for
+     * a singleton group formed from a position with unresolved pool metadata.
+     *
+     * @generated from field: optional string token0_address = 2;
+     */
+    token0Address?: string;
+    /**
+     * @generated from field: optional string token1_address = 3;
+     */
+    token1Address?: string;
+    /**
+     * @generated from field: optional uniswap.liquidity.v2.TokenMetadata token0_metadata = 4;
+     */
+    token0Metadata?: TokenMetadata;
+    /**
+     * @generated from field: optional uniswap.liquidity.v2.TokenMetadata token1_metadata = 5;
+     */
+    token1Metadata?: TokenMetadata;
+    /**
+     * The grouped positions, in the request's sort/default order. Each carries its
+     * own raw pool tokens (a WETH position still reports WETH), untouched by the
+     * group-level native normalization. Capped by the request's
+     * positions_per_group_limit; the totals below still cover ALL members so a
+     * capped page keeps correct aggregates.
+     *
+     * @generated from field: repeated uniswap.liquidity.v2.Position positions = 6;
+     */
+    positions: Position[];
+    /**
+     * Aggregates over ALL positions in the group, not just the returned page, so
+     * a capped `positions` list still shows correct group-level totals. Populated
+     * on a grouped read (group=true). On a single-group expansion (group_target),
+     * only total_value_usd and total_position_count are set — the fee/APR totals
+     * were delivered on the initial grouped read and are not recomputed there
+     * (that would require re-fetching every member's fees/rewards).
+     *
+     * @generated from field: optional double total_value_usd = 7;
+     */
+    totalValueUsd?: number;
+    /**
+     * @generated from field: optional double total_uncollected_fees_usd = 8;
+     */
+    totalUncollectedFeesUsd?: number;
+    /**
+     * Liquidity-weighted mean of members' total_apr, weighted by each member's
+     * value_usd (Σ apr·value / Σ value) — the blended yield on the group's
+     * capital, not a naive per-position average. Unset when no member is priced.
+     *
+     * @generated from field: optional double weighted_apr = 9;
+     */
+    weightedApr?: number;
+    /**
+     * Full member count (all positions in the group), so a capped page can show
+     * "+N more" and drive expansion.
+     *
+     * @generated from field: int32 total_position_count = 10;
+     */
+    totalPositionCount: number;
+    constructor(data?: PartialMessage<PositionGroup>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "uniswap.liquidity.v2.PositionGroup";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): PositionGroup;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): PositionGroup;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): PositionGroup;
+    static equals(a: PositionGroup | PlainMessage<PositionGroup> | undefined, b: PositionGroup | PlainMessage<PositionGroup> | undefined): boolean;
+}
+/**
+ * Targets one PositionGroup for expansion in GetWalletPositions: with this set,
+ * the response returns just that group's positions, paged by offset within the
+ * group. The pair key comes from a prior grouped response's PositionGroup
+ * (chain_id, token0_address, token1_address); addresses are normalized the same
+ * way grouping does (wrapped native -> native), so either the native or the
+ * wrapped address of a slot resolves to the same group. Singleton groups (one
+ * position, unresolved metadata) are not expandable — the caller already holds
+ * their single position.
+ *
+ * @generated from message uniswap.liquidity.v2.PositionGroupTarget
+ */
+export declare class PositionGroupTarget extends Message<PositionGroupTarget> {
+    /**
+     * @generated from field: int32 chain_id = 1;
+     */
+    chainId: number;
+    /**
+     * @generated from field: optional string token0_address = 2;
+     */
+    token0Address?: string;
+    /**
+     * @generated from field: optional string token1_address = 3;
+     */
+    token1Address?: string;
+    /**
+     * Offset within the group's positions (in the group's sort/default order).
+     *
+     * @generated from field: int32 offset = 4;
+     */
+    offset: number;
+    /**
+     * Max positions to return for the group. Default = service default, max 200.
+     *
+     * @generated from field: optional int32 limit = 5;
+     */
+    limit?: number;
+    constructor(data?: PartialMessage<PositionGroupTarget>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "uniswap.liquidity.v2.PositionGroupTarget";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): PositionGroupTarget;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): PositionGroupTarget;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): PositionGroupTarget;
+    static equals(a: PositionGroupTarget | PlainMessage<PositionGroupTarget> | undefined, b: PositionGroupTarget | PlainMessage<PositionGroupTarget> | undefined): boolean;
+}
 /**
  * Keyset cursor for GetWalletPositions. position_key is the last returned
  * position's key within (chain_id, version): V2 pair address, V3 token id,

package/dist/uniswap/liquidity/v2/types_pb.js

@@ -1578,6 +1578,118 @@ Position.fields = proto3.util.newFieldList(() => [
     { no: 39, name: "total_apr", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
     { no: 40, name: "protocol_fee", kind: "scalar", T: 13 /* ScalarType.UINT32 */, opt: true },
 ]);
+/**
+ * A wallet's positions collapsed by token pair, returned by GetWalletPositions
+ * when the request sets group=true. Every position in a group shares the pair
+ * key (chain_id, token0_address, token1_address) after normalizing each chain's
+ * wrapped native to native — so V2/V3/V4 and all fee tiers of the same pair land
+ * together. Positions whose pool metadata could not be resolved (no token
+ * identity) each form their own singleton group and leave the pair fields unset.
+ *
+ * @generated from message uniswap.liquidity.v2.PositionGroup
+ */
+export class PositionGroup extends Message {
+    constructor(data) {
+        super();
+        /**
+         * @generated from field: int32 chain_id = 1;
+         */
+        this.chainId = 0;
+        /**
+         * The grouped positions, in the request's sort/default order. Each carries its
+         * own raw pool tokens (a WETH position still reports WETH), untouched by the
+         * group-level native normalization. Capped by the request's
+         * positions_per_group_limit; the totals below still cover ALL members so a
+         * capped page keeps correct aggregates.
+         *
+         * @generated from field: repeated uniswap.liquidity.v2.Position positions = 6;
+         */
+        this.positions = [];
+        /**
+         * Full member count (all positions in the group), so a capped page can show
+         * "+N more" and drive expansion.
+         *
+         * @generated from field: int32 total_position_count = 10;
+         */
+        this.totalPositionCount = 0;
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new PositionGroup().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new PositionGroup().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new PositionGroup().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(PositionGroup, a, b);
+    }
+}
+PositionGroup.runtime = proto3;
+PositionGroup.typeName = "uniswap.liquidity.v2.PositionGroup";
+PositionGroup.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "chain_id", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 2, name: "token0_address", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 3, name: "token1_address", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 4, name: "token0_metadata", kind: "message", T: TokenMetadata, opt: true },
+    { no: 5, name: "token1_metadata", kind: "message", T: TokenMetadata, opt: true },
+    { no: 6, name: "positions", kind: "message", T: Position, repeated: true },
+    { no: 7, name: "total_value_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+    { no: 8, name: "total_uncollected_fees_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+    { no: 9, name: "weighted_apr", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+    { no: 10, name: "total_position_count", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+]);
+/**
+ * Targets one PositionGroup for expansion in GetWalletPositions: with this set,
+ * the response returns just that group's positions, paged by offset within the
+ * group. The pair key comes from a prior grouped response's PositionGroup
+ * (chain_id, token0_address, token1_address); addresses are normalized the same
+ * way grouping does (wrapped native -> native), so either the native or the
+ * wrapped address of a slot resolves to the same group. Singleton groups (one
+ * position, unresolved metadata) are not expandable — the caller already holds
+ * their single position.
+ *
+ * @generated from message uniswap.liquidity.v2.PositionGroupTarget
+ */
+export class PositionGroupTarget extends Message {
+    constructor(data) {
+        super();
+        /**
+         * @generated from field: int32 chain_id = 1;
+         */
+        this.chainId = 0;
+        /**
+         * Offset within the group's positions (in the group's sort/default order).
+         *
+         * @generated from field: int32 offset = 4;
+         */
+        this.offset = 0;
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new PositionGroupTarget().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new PositionGroupTarget().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new PositionGroupTarget().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(PositionGroupTarget, a, b);
+    }
+}
+PositionGroupTarget.runtime = proto3;
+PositionGroupTarget.typeName = "uniswap.liquidity.v2.PositionGroupTarget";
+PositionGroupTarget.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "chain_id", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 2, name: "token0_address", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 3, name: "token1_address", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 4, name: "offset", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 5, name: "limit", kind: "scalar", T: 5 /* ScalarType.INT32 */, opt: true },
+]);
 /**
  * Keyset cursor for GetWalletPositions. position_key is the last returned
  * position's key within (chain_id, version): V2 pair address, V3 token id,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uniswap/client-liquidity",
-    "version": "1.4.37",
+    "version": "1.4.39",
     "publishConfig": {
       "access": "public"
     },