@uniswap/client-liquidity 1.4.7 → 1.4.9

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, RangeStatus, 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
  *
@@ -1164,6 +1164,19 @@ export declare class GetWalletPositionsRequest extends Message<GetWalletPosition
      * @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, RangeStatus, 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
  *
@@ -1223,6 +1223,8 @@ GetWalletPositionsRequest.fields = proto3.util.newFieldList(() => [
     { 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

@@ -185,6 +185,52 @@ export declare enum RangeStatus {
      */
     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
  */
@@ -738,11 +784,16 @@ export declare class PoolReference extends Message<PoolReference> {
      */
     addressOrId: string;
     /**
-     * POOL_PROTOCOL_UNSPECIFIED rejected as invalid_argument
+     * Optional for GetPool: a pool-detail URL has only address + chain, so the
+     * service resolves the version from address_or_id (V4 pool ids are 64-hex; a
+     * 40-hex address is probed against v3 then v2 metadata). Required by the other
+     * pool endpoints (ticks/history), whose callers already have the version from
+     * GetPool's response. When set, it's authoritative and skips resolution.
+     * Unset (or POOL_PROTOCOL_UNSPECIFIED) means "resolve from the identifier".
      *
-     * @generated from field: uniswap.liquidity.v2.PoolProtocol version = 3;
+     * @generated from field: optional uniswap.liquidity.v2.PoolProtocol version = 3;
      */
-    version: PoolProtocol;
+    version?: PoolProtocol;
     constructor(data?: PartialMessage<PoolReference>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "uniswap.liquidity.v2.PoolReference";
@@ -1048,6 +1099,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;
@@ -1059,6 +1112,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

@@ -245,6 +245,62 @@ proto3.util.setEnumType(RangeStatus, "uniswap.liquidity.v2.RangeStatus", [
     { 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
  */
@@ -973,12 +1029,6 @@ export class PoolReference extends Message {
          * @generated from field: string address_or_id = 2;
          */
         this.addressOrId = "";
-        /**
-         * POOL_PROTOCOL_UNSPECIFIED rejected as invalid_argument
-         *
-         * @generated from field: uniswap.liquidity.v2.PoolProtocol version = 3;
-         */
-        this.version = PoolProtocol.UNSPECIFIED;
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -999,7 +1049,7 @@ PoolReference.typeName = "uniswap.liquidity.v2.PoolReference";
 PoolReference.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "chain_id", kind: "enum", T: proto3.getEnumType(ChainId) },
     { no: 2, name: "address_or_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
-    { no: 3, name: "version", kind: "enum", T: proto3.getEnumType(PoolProtocol) },
+    { no: 3, name: "version", kind: "enum", T: proto3.getEnumType(PoolProtocol), opt: true },
 ]);
 /**
  * One point of a pool's relative-price history, in raw pool-token
@@ -1292,6 +1342,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;
@@ -1324,6 +1376,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.7",
+    "version": "1.4.9",
     "publishConfig": {
       "access": "public"
     },