@uniswap/client-liquidity 1.4.26 → 1.4.29

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

@@ -789,11 +789,14 @@ export declare class PoolSummary extends Message<PoolSummary> {
      */
     isDynamicFee?: boolean;
     /**
-     * Live Merkl LP-incentive campaigns for this pool (V3/V4). Composed at read
-     * time from Merkl (not Aurora); empty when the pool has no live allowlisted
-     * campaign or the lookup degrades. One entry per campaign — not aggregated.
+     * DEPRECATED — superseded by token_rewards below, which groups campaigns under
+     * the token they pay and carries that token's summed boost. This field has never
+     * been populated and stays permanently empty; it exists only so consumers that
+     * already read it keep compiling. Removal is tracked in LP-1585 (reserve tag 25
+     * when it goes — a reused tag with a different type is wire-incompatible).
      *
-     * @generated from field: repeated uniswap.liquidity.v2.RewardsCampaign rewards_campaigns = 25;
+     * @generated from field: repeated uniswap.liquidity.v2.RewardsCampaign rewards_campaigns = 25 [deprecated = true];
+     * @deprecated
      */
     rewardsCampaigns: RewardsCampaign[];
     /**
@@ -810,6 +813,17 @@ export declare class PoolSummary extends Message<PoolSummary> {
      * @generated from field: optional double volume_usd_1d_change = 27;
      */
     volumeUsd1dChange?: number;
+    /**
+     * Live LP-incentive rewards, grouped by the token they pay (see
+     * PoolTokenRewards). Sourced from data-api, which owns campaign scoping, so this
+     * agrees with the boost Position.rewards reports for the same pool.
+     *
+     * Empty for V2 (no campaigns), when the pool has no live campaign, and when the
+     * lookup degrades — rewards never fail a pool read.
+     *
+     * @generated from field: repeated uniswap.liquidity.v2.PoolTokenRewards token_rewards = 28;
+     */
+    tokenRewards: PoolTokenRewards[];
     constructor(data?: PartialMessage<PoolSummary>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "uniswap.liquidity.v2.PoolSummary";
@@ -917,6 +931,151 @@ export declare class RewardsCampaign extends Message<RewardsCampaign> {
     static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): RewardsCampaign;
     static equals(a: RewardsCampaign | PlainMessage<RewardsCampaign> | undefined, b: RewardsCampaign | PlainMessage<RewardsCampaign> | undefined): boolean;
 }
+/**
+ * One live campaign behind a pool's per-token boost. It carries no reward token —
+ * campaigns are always grouped under one (see PoolTokenRewards).
+ *
+ * @generated from message uniswap.liquidity.v2.PoolCampaign
+ */
+export declare class PoolCampaign extends Message<PoolCampaign> {
+    /**
+     * Merkl campaign id.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * This campaign's APR alone, in percent. Already included in the parent's
+     * boosted_apr — don't sum these and add them to it.
+     *
+     * @generated from field: double apr = 2;
+     */
+    apr: number;
+    /**
+     * Campaign window, unix seconds.
+     *
+     * @generated from field: int64 start_timestamp = 3;
+     */
+    startTimestamp: bigint;
+    /**
+     * @generated from field: int64 end_timestamp = 4;
+     */
+    endTimestamp: bigint;
+    /**
+     * Total allocation, uint256 decimal string in the reward token's smallest unit.
+     *
+     * @generated from field: string total_reward_allocation = 5;
+     */
+    totalRewardAllocation: string;
+    /**
+     * Emission rate in USD. Derived upstream from the reward token's price at fetch
+     * time, so it drifts with price; daily_rewards below is price-independent.
+     *
+     * @generated from field: optional double daily_rewards_usd = 6;
+     */
+    dailyRewardsUsd?: number;
+    /**
+     * Emission rate in the reward token's smallest unit (uint256 decimal string).
+     *
+     * @generated from field: optional string daily_rewards = 7;
+     */
+    dailyRewards?: string;
+    constructor(data?: PartialMessage<PoolCampaign>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "uniswap.liquidity.v2.PoolCampaign";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): PoolCampaign;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): PoolCampaign;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): PoolCampaign;
+    static equals(a: PoolCampaign | PlainMessage<PoolCampaign> | undefined, b: PoolCampaign | PlainMessage<PoolCampaign> | undefined): boolean;
+}
+/**
+ * A pool's live rewards in one reward token: the summed boost plus the campaigns
+ * it came from. A pool running concurrent campaigns in different tokens yields one
+ * entry per token.
+ *
+ * @generated from message uniswap.liquidity.v2.PoolTokenRewards
+ */
+export declare class PoolTokenRewards extends Message<PoolTokenRewards> {
+    /**
+     * @generated from field: uniswap.liquidity.v2.RewardToken token = 1;
+     */
+    token?: RewardToken;
+    /**
+     * Sum of this token's live campaign APRs on the pool, in percent, on top of the
+     * pool's fee APR (PoolSummary.apr). Same number Position.rewards reports as
+     * boosted_pool_apr for this pool and token.
+     *
+     * @generated from field: double boosted_apr = 2;
+     */
+    boostedApr: number;
+    /**
+     * @generated from field: repeated uniswap.liquidity.v2.PoolCampaign campaigns = 3;
+     */
+    campaigns: PoolCampaign[];
+    constructor(data?: PartialMessage<PoolTokenRewards>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "uniswap.liquidity.v2.PoolTokenRewards";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): PoolTokenRewards;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): PoolTokenRewards;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): PoolTokenRewards;
+    static equals(a: PoolTokenRewards | PlainMessage<PoolTokenRewards> | undefined, b: PoolTokenRewards | PlainMessage<PoolTokenRewards> | undefined): boolean;
+}
+/**
+ * What a position earns in one LP-incentive reward token: the pool's boosted APR
+ * and the position's unclaimed balance. One entry per token, since a pool can run
+ * concurrent campaigns paying different tokens.
+ *
+ * Either half can stand alone. An ended campaign leaves a claimable balance with
+ * no boost (apr 0), and a live campaign can have a boost with nothing accrued —
+ * or, on V3, no per-position attribution at all.
+ *
+ * @generated from message uniswap.liquidity.v2.PositionReward
+ */
+export declare class PositionReward extends Message<PositionReward> {
+    /**
+     * The token both values below refer to, on its own distribution chain (which
+     * can differ from the position's chain).
+     *
+     * @generated from field: uniswap.liquidity.v2.RewardToken token = 1;
+     */
+    token?: RewardToken;
+    /**
+     * The POOL's boosted APR from campaigns paying this token — the sum of that
+     * token's live campaign APRs, in percent, on top of the pool's fee APR. Shared
+     * by every position in the pool, not specific to this one. 0 = no live campaign.
+     *
+     * The same number PoolSummary.token_rewards reports as boosted_apr for this
+     * (pool, token). Distinct from PoolCampaign.apr, which is ONE campaign's APR;
+     * this sums every live campaign paying the token, so don't add the two.
+     *
+     * @generated from field: double boosted_pool_apr = 2;
+     */
+    boostedPoolApr: number;
+    /**
+     * Unclaimed amount in token's smallest unit (uint256 decimal string). Unset
+     * when there is no per-position attribution upstream (V3) — distinct from a
+     * known zero.
+     *
+     * @generated from field: optional string unclaimed_amount = 3;
+     */
+    unclaimedAmount?: string;
+    /**
+     * Unclaimed amount in USD. Unset when the token could not be priced.
+     *
+     * @generated from field: optional double unclaimed_amount_usd = 4;
+     */
+    unclaimedAmountUsd?: number;
+    constructor(data?: PartialMessage<PositionReward>);
+    static readonly runtime: typeof proto3;
+    static readonly typeName = "uniswap.liquidity.v2.PositionReward";
+    static readonly fields: FieldList;
+    static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): PositionReward;
+    static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): PositionReward;
+    static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): PositionReward;
+    static equals(a: PositionReward | PlainMessage<PositionReward> | undefined, b: PositionReward | PlainMessage<PositionReward> | undefined): boolean;
+}
 /**
  * @generated from message uniswap.liquidity.v2.PoolListCursor
  */
@@ -1320,6 +1479,19 @@ export declare class Position extends Message<Position> {
      * @generated from field: optional string total_supply = 37;
      */
     totalSupply?: string;
+    /**
+     * LP-incentive rewards for this position, one entry per reward token (see
+     * PositionReward). Sourced from data-api, which owns campaign scoping and the
+     * reward-token/creator allowlists, so these agree with what its GetRewards
+     * reports for the same wallet.
+     *
+     * Empty for V2 (no campaigns), and empty when the lookup degrades — rewards
+     * never fail a positions read. Populated by GetWalletPositions; GetPosition
+     * leaves it empty for now.
+     *
+     * @generated from field: repeated uniswap.liquidity.v2.PositionReward rewards = 38;
+     */
+    rewards: PositionReward[];
     constructor(data?: PartialMessage<Position>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "uniswap.liquidity.v2.Position";

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

@@ -968,13 +968,27 @@ export class PoolSummary extends Message {
          */
         this.volumeUsd1d = 0;
         /**
-         * Live Merkl LP-incentive campaigns for this pool (V3/V4). Composed at read
-         * time from Merkl (not Aurora); empty when the pool has no live allowlisted
-         * campaign or the lookup degrades. One entry per campaign — not aggregated.
+         * DEPRECATED — superseded by token_rewards below, which groups campaigns under
+         * the token they pay and carries that token's summed boost. This field has never
+         * been populated and stays permanently empty; it exists only so consumers that
+         * already read it keep compiling. Removal is tracked in LP-1585 (reserve tag 25
+         * when it goes — a reused tag with a different type is wire-incompatible).
          *
-         * @generated from field: repeated uniswap.liquidity.v2.RewardsCampaign rewards_campaigns = 25;
+         * @generated from field: repeated uniswap.liquidity.v2.RewardsCampaign rewards_campaigns = 25 [deprecated = true];
+         * @deprecated
          */
         this.rewardsCampaigns = [];
+        /**
+         * Live LP-incentive rewards, grouped by the token they pay (see
+         * PoolTokenRewards). Sourced from data-api, which owns campaign scoping, so this
+         * agrees with the boost Position.rewards reports for the same pool.
+         *
+         * Empty for V2 (no campaigns), when the pool has no live campaign, and when the
+         * lookup degrades — rewards never fail a pool read.
+         *
+         * @generated from field: repeated uniswap.liquidity.v2.PoolTokenRewards token_rewards = 28;
+         */
+        this.tokenRewards = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -1020,6 +1034,7 @@ PoolSummary.fields = proto3.util.newFieldList(() => [
     { no: 25, name: "rewards_campaigns", kind: "message", T: RewardsCampaign, repeated: true },
     { no: 26, name: "tvl_usd_change_1d", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
     { no: 27, name: "volume_usd_1d_change", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+    { no: 28, name: "token_rewards", kind: "message", T: PoolTokenRewards, repeated: true },
 ]);
 /**
  * A reward token's on-chain identity, so a client can interpret and format a
@@ -1138,6 +1153,163 @@ RewardsCampaign.fields = proto3.util.newFieldList(() => [
     { no: 6, name: "distributed_rewards", kind: "scalar", T: 9 /* ScalarType.STRING */ },
     { no: 7, name: "reward_token", kind: "message", T: RewardToken },
 ]);
+/**
+ * One live campaign behind a pool's per-token boost. It carries no reward token —
+ * campaigns are always grouped under one (see PoolTokenRewards).
+ *
+ * @generated from message uniswap.liquidity.v2.PoolCampaign
+ */
+export class PoolCampaign extends Message {
+    constructor(data) {
+        super();
+        /**
+         * Merkl campaign id.
+         *
+         * @generated from field: string id = 1;
+         */
+        this.id = "";
+        /**
+         * This campaign's APR alone, in percent. Already included in the parent's
+         * boosted_apr — don't sum these and add them to it.
+         *
+         * @generated from field: double apr = 2;
+         */
+        this.apr = 0;
+        /**
+         * Campaign window, unix seconds.
+         *
+         * @generated from field: int64 start_timestamp = 3;
+         */
+        this.startTimestamp = protoInt64.zero;
+        /**
+         * @generated from field: int64 end_timestamp = 4;
+         */
+        this.endTimestamp = protoInt64.zero;
+        /**
+         * Total allocation, uint256 decimal string in the reward token's smallest unit.
+         *
+         * @generated from field: string total_reward_allocation = 5;
+         */
+        this.totalRewardAllocation = "";
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new PoolCampaign().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new PoolCampaign().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new PoolCampaign().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(PoolCampaign, a, b);
+    }
+}
+PoolCampaign.runtime = proto3;
+PoolCampaign.typeName = "uniswap.liquidity.v2.PoolCampaign";
+PoolCampaign.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "apr", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 3, name: "start_timestamp", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 4, name: "end_timestamp", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 5, name: "total_reward_allocation", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 6, name: "daily_rewards_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+    { no: 7, name: "daily_rewards", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+]);
+/**
+ * A pool's live rewards in one reward token: the summed boost plus the campaigns
+ * it came from. A pool running concurrent campaigns in different tokens yields one
+ * entry per token.
+ *
+ * @generated from message uniswap.liquidity.v2.PoolTokenRewards
+ */
+export class PoolTokenRewards extends Message {
+    constructor(data) {
+        super();
+        /**
+         * Sum of this token's live campaign APRs on the pool, in percent, on top of the
+         * pool's fee APR (PoolSummary.apr). Same number Position.rewards reports as
+         * boosted_pool_apr for this pool and token.
+         *
+         * @generated from field: double boosted_apr = 2;
+         */
+        this.boostedApr = 0;
+        /**
+         * @generated from field: repeated uniswap.liquidity.v2.PoolCampaign campaigns = 3;
+         */
+        this.campaigns = [];
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new PoolTokenRewards().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new PoolTokenRewards().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new PoolTokenRewards().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(PoolTokenRewards, a, b);
+    }
+}
+PoolTokenRewards.runtime = proto3;
+PoolTokenRewards.typeName = "uniswap.liquidity.v2.PoolTokenRewards";
+PoolTokenRewards.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "token", kind: "message", T: RewardToken },
+    { no: 2, name: "boosted_apr", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 3, name: "campaigns", kind: "message", T: PoolCampaign, repeated: true },
+]);
+/**
+ * What a position earns in one LP-incentive reward token: the pool's boosted APR
+ * and the position's unclaimed balance. One entry per token, since a pool can run
+ * concurrent campaigns paying different tokens.
+ *
+ * Either half can stand alone. An ended campaign leaves a claimable balance with
+ * no boost (apr 0), and a live campaign can have a boost with nothing accrued —
+ * or, on V3, no per-position attribution at all.
+ *
+ * @generated from message uniswap.liquidity.v2.PositionReward
+ */
+export class PositionReward extends Message {
+    constructor(data) {
+        super();
+        /**
+         * The POOL's boosted APR from campaigns paying this token — the sum of that
+         * token's live campaign APRs, in percent, on top of the pool's fee APR. Shared
+         * by every position in the pool, not specific to this one. 0 = no live campaign.
+         *
+         * The same number PoolSummary.token_rewards reports as boosted_apr for this
+         * (pool, token). Distinct from PoolCampaign.apr, which is ONE campaign's APR;
+         * this sums every live campaign paying the token, so don't add the two.
+         *
+         * @generated from field: double boosted_pool_apr = 2;
+         */
+        this.boostedPoolApr = 0;
+        proto3.util.initPartial(data, this);
+    }
+    static fromBinary(bytes, options) {
+        return new PositionReward().fromBinary(bytes, options);
+    }
+    static fromJson(jsonValue, options) {
+        return new PositionReward().fromJson(jsonValue, options);
+    }
+    static fromJsonString(jsonString, options) {
+        return new PositionReward().fromJsonString(jsonString, options);
+    }
+    static equals(a, b) {
+        return proto3.util.equals(PositionReward, a, b);
+    }
+}
+PositionReward.runtime = proto3;
+PositionReward.typeName = "uniswap.liquidity.v2.PositionReward";
+PositionReward.fields = proto3.util.newFieldList(() => [
+    { no: 1, name: "token", kind: "message", T: RewardToken },
+    { no: 2, name: "boosted_pool_apr", kind: "scalar", T: 1 /* ScalarType.DOUBLE */ },
+    { no: 3, name: "unclaimed_amount", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 4, name: "unclaimed_amount_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
+]);
 /**
  * @generated from message uniswap.liquidity.v2.PoolListCursor
  */
@@ -1466,6 +1638,19 @@ export class Position extends Message {
          * @generated from field: uniswap.liquidity.v2.PositionStatus status = 14;
          */
         this.status = PositionStatus.UNSPECIFIED;
+        /**
+         * LP-incentive rewards for this position, one entry per reward token (see
+         * PositionReward). Sourced from data-api, which owns campaign scoping and the
+         * reward-token/creator allowlists, so these agree with what its GetRewards
+         * reports for the same wallet.
+         *
+         * Empty for V2 (no campaigns), and empty when the lookup degrades — rewards
+         * never fail a positions read. Populated by GetWalletPositions; GetPosition
+         * leaves it empty for now.
+         *
+         * @generated from field: repeated uniswap.liquidity.v2.PositionReward rewards = 38;
+         */
+        this.rewards = [];
         proto3.util.initPartial(data, this);
     }
     static fromBinary(bytes, options) {
@@ -1521,6 +1706,7 @@ Position.fields = proto3.util.newFieldList(() => [
     { no: 35, name: "reserve0", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
     { no: 36, name: "reserve1", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
     { no: 37, name: "total_supply", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 38, name: "rewards", kind: "message", T: PositionReward, repeated: 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.26",
+    "version": "1.4.29",
     "publishConfig": {
       "access": "public"
     },