@uniswap/client-liquidity 1.4.37 → 1.4.38

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, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
 /**
  * MigrateV2ToV3LPPosition
  *
@@ -1172,6 +1172,21 @@ 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;
     constructor(data?: PartialMessage<GetWalletPositionsRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "uniswap.liquidity.v2.GetWalletPositionsRequest";
@@ -1186,6 +1201,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 +1210,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, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
 /**
  * MigrateV2ToV3LPPosition
  *
@@ -1221,6 +1221,7 @@ 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 },
 ]);
 /**
  * @generated from message uniswap.liquidity.v2.GetWalletPositionsResponse
@@ -1229,9 +1230,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 +1261,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,59 @@ 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.
+     *
+     * @generated from field: repeated uniswap.liquidity.v2.Position positions = 6;
+     */
+    positions: Position[];
+    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;
+}
 /**
  * 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,56 @@ 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.
+         *
+         * @generated from field: repeated uniswap.liquidity.v2.Position positions = 6;
+         */
+        this.positions = [];
+        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 },
+]);
 /**
  * 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.38",
     "publishConfig": {
       "access": "public"
     },