@uniswap/client-liquidity 1.4.5 → 1.4.8

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, PoolListCursor, PoolPricePoint, PoolReference, PoolSortBy, PoolSummary, PoolTick, PoolVolumeBucket, Position, PositionListCursor, PositionModifier, PositionPriceBounds, PositionStatus, PositionTickBounds, V2PoolParameters } from "./types_pb.js";
+import { ApprovalTransactionRequest, CreatePoolParameters, CreatePositionExistingPoolParameters, CreateToken, GasUrgency, HistoryDuration, HookEntry, LPAction, LPToken, PoolListCursor, PoolPricePoint, PoolReference, PoolSortBy, PoolSummary, PoolTick, PoolVolumeBucket, Position, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
 /**
  * MigrateV2ToV3LPPosition
  *
@@ -1155,6 +1155,28 @@ export declare class GetWalletPositionsRequest extends Message<GetWalletPosition
      * @generated from field: optional uniswap.liquidity.v2.PositionModifier modifier = 7;
      */
     modifier?: PositionModifier;
+    /**
+     * In/out-of-range filter over open concentrated (V3/V4) positions. Empty = no
+     * range filter. Values union. Composes with `statuses` and `modifier`: e.g.
+     * statuses=[OPEN] + range_statuses=[IN_RANGE] returns open, in-range,
+     * non-spam positions. V2 matches no range bucket.
+     *
+     * @generated from field: repeated uniswap.liquidity.v2.RangeStatus range_statuses = 8;
+     */
+    rangeStatuses: RangeStatus[];
+    /**
+     * Sort order. Unset/UNSPECIFIED = default (chain, version, key). FEES/APR are
+     * accepted but currently no-op (see PositionSortBy).
+     *
+     * @generated from field: optional uniswap.liquidity.v2.PositionSortBy sort_by = 9;
+     */
+    sortBy?: PositionSortBy;
+    /**
+     * Sort direction; defaults to descending (newest / largest first).
+     *
+     * @generated from field: optional bool ascending = 10;
+     */
+    ascending?: boolean;
     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, PoolListCursor, PoolPricePoint, PoolReference, PoolSortBy, PoolSummary, PoolTick, PoolVolumeBucket, Position, PositionListCursor, PositionModifier, PositionPriceBounds, PositionStatus, PositionTickBounds, V2PoolParameters } from "./types_pb.js";
+import { ApprovalTransactionRequest, CreatePoolParameters, CreatePositionExistingPoolParameters, CreateToken, GasUrgency, HistoryDuration, HookEntry, LPAction, LPToken, PoolListCursor, PoolPricePoint, PoolReference, PoolSortBy, PoolSummary, PoolTick, PoolVolumeBucket, Position, PositionListCursor, PositionModifier, PositionPriceBounds, PositionSortBy, PositionStatus, PositionTickBounds, RangeStatus, V2PoolParameters } from "./types_pb.js";
 /**
  * MigrateV2ToV3LPPosition
  *
@@ -1188,6 +1188,15 @@ export class GetWalletPositionsRequest extends Message {
          * @generated from field: repeated uniswap.liquidity.v2.PositionStatus statuses = 6;
          */
         this.statuses = [];
+        /**
+         * In/out-of-range filter over open concentrated (V3/V4) positions. Empty = no
+         * range filter. Values union. Composes with `statuses` and `modifier`: e.g.
+         * statuses=[OPEN] + range_statuses=[IN_RANGE] returns open, in-range,
+         * non-spam positions. V2 matches no range bucket.
+         *
+         * @generated from field: repeated uniswap.liquidity.v2.RangeStatus range_statuses = 8;
+         */
+        this.rangeStatuses = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -1213,6 +1222,9 @@ GetWalletPositionsRequest.fields = proto3.util.newFieldList(() => [
     { no: 5, name: "cursor", kind: "message", T: PositionListCursor, opt: true },
     { no: 6, name: "statuses", kind: "enum", T: proto3.getEnumType(PositionStatus), repeated: true },
     { no: 7, name: "modifier", kind: "message", T: PositionModifier, opt: true },
+    { no: 8, name: "range_statuses", kind: "enum", T: proto3.getEnumType(RangeStatus), repeated: true },
+    { 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 },
 ]);
 /**
  * @generated from message uniswap.liquidity.v2.GetWalletPositionsResponse

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

@@ -154,6 +154,83 @@ export declare enum PositionStatus {
      */
     HIDDEN = 3
 }
+/**
+ * In/out-of-range classification of an open concentrated (V3/V4) position,
+ * derived from the pool's current tick. This is a filter dimension separate
+ * from PositionStatus (lifecycle) and PositionModifier (spam visibility): a
+ * caller can ask for OPEN positions that are additionally IN_RANGE. V2 is
+ * full-range with no ticks, so it matches neither bucket.
+ *
+ * @generated from enum uniswap.liquidity.v2.RangeStatus
+ */
+export declare enum RangeStatus {
+    /**
+     * @generated from enum value: RANGE_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * An open concentrated position (V3/V4) whose pool has a current state row
+     * with tick within [tick_lower, tick_upper).
+     *
+     * @generated from enum value: RANGE_STATUS_IN_RANGE = 1;
+     */
+    IN_RANGE = 1,
+    /**
+     * An open concentrated position (V3/V4) that is not IN_RANGE: the pool's
+     * current tick is outside [tick_lower, tick_upper), OR the pool has no state
+     * row yet (so a position is never dropped from both IN_RANGE and
+     * OUT_OF_RANGE while its pool awaits its first state event).
+     *
+     * @generated from enum value: RANGE_STATUS_OUT_OF_RANGE = 2;
+     */
+    OUT_OF_RANGE = 2
+}
+/**
+ * Sort order for GetWalletPositions. UNSPECIFIED keeps the default deterministic
+ * order (chain asc, version, per-version key). Each real sort still resolves
+ * ties by that key so the keyset cursor stays stable.
+ *
+ * @generated from enum uniswap.liquidity.v2.PositionSortBy
+ */
+export declare enum PositionSortBy {
+    /**
+     * @generated from enum value: POSITION_SORT_BY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * created_at_timestamp — the position's on-chain creation time.
+     *
+     * @generated from enum value: POSITION_SORT_BY_CREATED_AT = 1;
+     */
+    CREATED_AT = 1,
+    /**
+     * Range proximity, derived purely from ticks (current tick vs the position's
+     * [tick_lower, tick_upper)). V3/V4 only; V2 sorts last.
+     *
+     * @generated from enum value: POSITION_SORT_BY_DISTRIBUTION = 2;
+     */
+    DISTRIBUTION = 2,
+    /**
+     * Position USD value, computed read-time (position amounts * token prices —
+     * "sort after join", not materialized). V3/V4 amounts come from pool state +
+     * liquidity; V2 from the LP-token share of pair reserves.
+     *
+     * @generated from enum value: POSITION_SORT_BY_LIQUIDITY = 3;
+     */
+    LIQUIDITY = 3,
+    /**
+     * NO-OP: uncollected-fee data is not ingested yet.
+     *
+     * @generated from enum value: POSITION_SORT_BY_FEES = 4;
+     */
+    FEES = 4,
+    /**
+     * NO-OP: APR depends on fee data that is not ingested yet.
+     *
+     * @generated from enum value: POSITION_SORT_BY_APR = 5;
+     */
+    APR = 5
+}
 /**
  * @generated from message uniswap.liquidity.v2.LPToken
  */
@@ -1017,6 +1094,8 @@ export declare class Position extends Message<Position> {
  */
 export declare class PositionListCursor extends Message<PositionListCursor> {
     /**
+     * Default (unsorted) order uses a keyset cursor: (chain, version, key).
+     *
      * @generated from field: int32 chain_id = 1;
      */
     chainId: number;
@@ -1028,6 +1107,14 @@ export declare class PositionListCursor extends Message<PositionListCursor> {
      * @generated from field: string position_key = 3;
      */
     positionKey: string;
+    /**
+     * Sorted order (sort_by set) uses an offset cursor instead: the count already
+     * returned. A wallet's positions are a bounded set, so sorted requests read +
+     * sort the whole set and page by offset. Unset in default order.
+     *
+     * @generated from field: optional int32 offset = 4;
+     */
+    offset?: number;
     constructor(data?: PartialMessage<PositionListCursor>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "uniswap.liquidity.v2.PositionListCursor";

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

@@ -207,6 +207,100 @@ proto3.util.setEnumType(PositionStatus, "uniswap.liquidity.v2.PositionStatus", [
     { no: 2, name: "POSITION_STATUS_CLOSED" },
     { no: 3, name: "POSITION_STATUS_HIDDEN" },
 ]);
+/**
+ * In/out-of-range classification of an open concentrated (V3/V4) position,
+ * derived from the pool's current tick. This is a filter dimension separate
+ * from PositionStatus (lifecycle) and PositionModifier (spam visibility): a
+ * caller can ask for OPEN positions that are additionally IN_RANGE. V2 is
+ * full-range with no ticks, so it matches neither bucket.
+ *
+ * @generated from enum uniswap.liquidity.v2.RangeStatus
+ */
+export var RangeStatus;
+(function (RangeStatus) {
+    /**
+     * @generated from enum value: RANGE_STATUS_UNSPECIFIED = 0;
+     */
+    RangeStatus[RangeStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * An open concentrated position (V3/V4) whose pool has a current state row
+     * with tick within [tick_lower, tick_upper).
+     *
+     * @generated from enum value: RANGE_STATUS_IN_RANGE = 1;
+     */
+    RangeStatus[RangeStatus["IN_RANGE"] = 1] = "IN_RANGE";
+    /**
+     * An open concentrated position (V3/V4) that is not IN_RANGE: the pool's
+     * current tick is outside [tick_lower, tick_upper), OR the pool has no state
+     * row yet (so a position is never dropped from both IN_RANGE and
+     * OUT_OF_RANGE while its pool awaits its first state event).
+     *
+     * @generated from enum value: RANGE_STATUS_OUT_OF_RANGE = 2;
+     */
+    RangeStatus[RangeStatus["OUT_OF_RANGE"] = 2] = "OUT_OF_RANGE";
+})(RangeStatus || (RangeStatus = {}));
+// Retrieve enum metadata with: proto3.getEnumType(RangeStatus)
+proto3.util.setEnumType(RangeStatus, "uniswap.liquidity.v2.RangeStatus", [
+    { no: 0, name: "RANGE_STATUS_UNSPECIFIED" },
+    { no: 1, name: "RANGE_STATUS_IN_RANGE" },
+    { no: 2, name: "RANGE_STATUS_OUT_OF_RANGE" },
+]);
+/**
+ * Sort order for GetWalletPositions. UNSPECIFIED keeps the default deterministic
+ * order (chain asc, version, per-version key). Each real sort still resolves
+ * ties by that key so the keyset cursor stays stable.
+ *
+ * @generated from enum uniswap.liquidity.v2.PositionSortBy
+ */
+export var PositionSortBy;
+(function (PositionSortBy) {
+    /**
+     * @generated from enum value: POSITION_SORT_BY_UNSPECIFIED = 0;
+     */
+    PositionSortBy[PositionSortBy["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * created_at_timestamp — the position's on-chain creation time.
+     *
+     * @generated from enum value: POSITION_SORT_BY_CREATED_AT = 1;
+     */
+    PositionSortBy[PositionSortBy["CREATED_AT"] = 1] = "CREATED_AT";
+    /**
+     * Range proximity, derived purely from ticks (current tick vs the position's
+     * [tick_lower, tick_upper)). V3/V4 only; V2 sorts last.
+     *
+     * @generated from enum value: POSITION_SORT_BY_DISTRIBUTION = 2;
+     */
+    PositionSortBy[PositionSortBy["DISTRIBUTION"] = 2] = "DISTRIBUTION";
+    /**
+     * Position USD value, computed read-time (position amounts * token prices —
+     * "sort after join", not materialized). V3/V4 amounts come from pool state +
+     * liquidity; V2 from the LP-token share of pair reserves.
+     *
+     * @generated from enum value: POSITION_SORT_BY_LIQUIDITY = 3;
+     */
+    PositionSortBy[PositionSortBy["LIQUIDITY"] = 3] = "LIQUIDITY";
+    /**
+     * NO-OP: uncollected-fee data is not ingested yet.
+     *
+     * @generated from enum value: POSITION_SORT_BY_FEES = 4;
+     */
+    PositionSortBy[PositionSortBy["FEES"] = 4] = "FEES";
+    /**
+     * NO-OP: APR depends on fee data that is not ingested yet.
+     *
+     * @generated from enum value: POSITION_SORT_BY_APR = 5;
+     */
+    PositionSortBy[PositionSortBy["APR"] = 5] = "APR";
+})(PositionSortBy || (PositionSortBy = {}));
+// Retrieve enum metadata with: proto3.getEnumType(PositionSortBy)
+proto3.util.setEnumType(PositionSortBy, "uniswap.liquidity.v2.PositionSortBy", [
+    { no: 0, name: "POSITION_SORT_BY_UNSPECIFIED" },
+    { no: 1, name: "POSITION_SORT_BY_CREATED_AT" },
+    { no: 2, name: "POSITION_SORT_BY_DISTRIBUTION" },
+    { no: 3, name: "POSITION_SORT_BY_LIQUIDITY" },
+    { no: 4, name: "POSITION_SORT_BY_FEES" },
+    { no: 5, name: "POSITION_SORT_BY_APR" },
+]);
 /**
  * @generated from message uniswap.liquidity.v2.LPToken
  */
@@ -1254,6 +1348,8 @@ export class PositionListCursor extends Message {
     constructor(data) {
         super();
         /**
+         * Default (unsorted) order uses a keyset cursor: (chain, version, key).
+         *
          * @generated from field: int32 chain_id = 1;
          */
         this.chainId = 0;
@@ -1286,6 +1382,7 @@ PositionListCursor.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "chain_id", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
     { no: 2, name: "version", kind: "enum", T: proto3.getEnumType(Protocols) },
     { no: 3, name: "position_key", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "offset", kind: "scalar", T: 5 /* ScalarType.INT32 */, opt: true },
 ]);
 /**
  * One initialized tick of a V3/V4 pool's liquidity distribution.

package/package.json

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