@uniswap/client-liquidity 1.4.38 → 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, PositionGroup, 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
  *
@@ -1187,6 +1187,24 @@ export declare class GetWalletPositionsRequest extends Message<GetWalletPosition
      * @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";

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, PositionGroup, 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
  *
@@ -1222,6 +1222,8 @@ GetWalletPositionsRequest.fields = proto3.util.newFieldList(() => [
     { 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

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

@@ -1478,11 +1478,43 @@ export declare class PositionGroup extends Message<PositionGroup> {
     /**
      * 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.
+     * 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";
@@ -1492,6 +1524,52 @@ export declare class PositionGroup extends Message<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

@@ -1598,11 +1598,20 @@ export class PositionGroup extends Message {
         /**
          * 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.
+         * 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) {
@@ -1627,6 +1636,59 @@ PositionGroup.fields = proto3.util.newFieldList(() => [
     { 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

package/package.json

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