@uniswap/client-data-api 0.0.180 → 0.0.183

package/dist/data/v2/api_pb.d.ts

@@ -1627,9 +1627,49 @@ export declare class CreatorFeeTotals extends Message<CreatorFeeTotals> {
      * LP position), NOT per-beneficiary — whoever holds the vault NFT at
      * claim time receives it.
      *
+     * SETTLED-ONLY. Fees reach the beneficiary vault only when somebody calls
+     * the permissionless FeeSplitter.collectFees(tokenIds), so this
+     * UNDERSTATES the creator's earnings by everything the launch's Uniswap
+     * v4 position has accrued since the last collect. Its meaning is
+     * unchanged and will not change — see claimable_including_uncollected for
+     * the figure to show a creator as "your earnings".
+     *
      * @generated from field: data.v2.LaunchCreatorFeeAmounts claimable = 3;
      */
     claimable?: LaunchCreatorFeeAmounts;
+    /**
+     * `claimable` PLUS the creator's share of the fees still sitting
+     * uncollected in the launch's Uniswap v4 position: what a
+     * collectFees + claim sent right now would actually pay out.
+     *
+     * Computed by simulating FeeSplitter.collectFees(tokenIds) against the
+     * chain head (eth_simulateV1) and reading the beneficiary vault's
+     * amounts(tokenId) inside that same simulated state — no transaction is
+     * sent and no state is written. Aggregated across every LP position of
+     * the launch, exactly like `claimable`.
+     *
+     * Always populated: when the simulation cannot run (RPC error, or a
+     * collect that reverts) this degrades to the vault's settled on-chain
+     * balance, and finally to `claimable` itself, so a creator sees a
+     * slightly stale number rather than an error.
+     *
+     * Read claimable_includes_uncollected before deciding how to treat this.
+     *
+     * WHEN IT IS TRUE this is the post-collect figure: normally >=
+     * `claimable`, but it comes from chain state rather than indexed events,
+     * so it can also come in LOWER when the indexer is behind a claim that
+     * already landed. It is the authoritative figure in that case — do not
+     * max() the two.
+     *
+     * WHEN IT IS FALSE the collect could not be simulated and this degraded
+     * to a settled balance (or to `claimable` itself). It then carries no
+     * uncollected remainder and can only UNDERSTATE the creator's earnings,
+     * so max() with `claimable` is the right defence and the number must not
+     * be labelled "your earnings".
+     *
+     * @generated from field: data.v2.LaunchCreatorFeeAmounts claimable_including_uncollected = 4;
+     */
+    claimableIncludingUncollected?: LaunchCreatorFeeAmounts;
     constructor(data?: PartialMessage<CreatorFeeTotals>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.CreatorFeeTotals";
@@ -1688,11 +1728,13 @@ export declare class GetLaunchCreatorFeesResponse extends Message<GetLaunchCreat
      */
     positionTokenId?: string;
     /**
-     * Current beneficiary: the vault-NFT holder (EIP-55) of the
-     * position_token_id position, who may claim and re-point the fee stream
-     * by transferring the NFT. Unset when creator fees are off, while vault
-     * ingestion lags (for a CCA launch: until the creator's graffiti claim
-     * mints the vault NFT), or transiently mid re-registration (NFT burned).
+     * Current beneficiary: the CREATOR'S WALLET (EIP-55) — the holder of the
+     * beneficiary ERC721 for the position_token_id position, who may claim
+     * and re-point the fee stream by transferring the NFT. This is NOT the
+     * vault contract; that is beneficiary_vault. Unset when creator fees are
+     * off, while vault ingestion lags (for a CCA launch: until the creator's
+     * graffiti claim mints the vault NFT), or transiently mid re-registration
+     * (NFT burned).
      *
      * @generated from field: optional string fee_beneficiary = 5;
      */
@@ -1708,6 +1750,50 @@ export declare class GetLaunchCreatorFeesResponse extends Message<GetLaunchCreat
      * @generated from field: int64 as_of_timestamp = 6;
      */
     asOfTimestamp: bigint;
+    /**
+     * The launch's own FeeSplitter (EIP-55) — the contract to send the
+     * permissionless collectFees([position_token_id]) to, which sweeps the v4
+     * position's fees into the beneficiary vault and is what makes
+     * creator.claimable_including_uncollected actually claimable.
+     *
+     * PER LAUNCH, NOT A CHAIN CONSTANT: several FeeSplitter generations are
+     * deployed and live on the same chain (Robinhood Chain runs two), and a
+     * launch's fees only ever flow through the one its strategy was wired to.
+     * Clients MUST call the address in this field — a hardcoded per-chain
+     * splitter silently targets the wrong generation. Unset when the launch
+     * has neither an indexed launch row nor a fee event yet.
+     *
+     * @generated from field: optional string fee_splitter = 7;
+     */
+    feeSplitter?: string;
+    /**
+     * The launch's own UERC20BeneficiaryVault (EIP-55) — the contract that
+     * custodies the creator's share and that claim(position_token_id, 0, 0)
+     * is sent to. Per launch for the same reason fee_splitter is. Unset until
+     * the position's beneficiary NFT has been ingested.
+     *
+     * @generated from field: optional string beneficiary_vault = 8;
+     */
+    beneficiaryVault?: string;
+    /**
+     * False when the collect could not be simulated and
+     * creator.claimable_including_uncollected is a settled balance (or the
+     * event-derived claimable) rather than the post-collect figure. Clients
+     * should not present it as "your earnings" when false.
+     *
+     * as_of_timestamp does NOT cover for this: that marker is computed from
+     * indexed events only, so it reads perfectly fresh during an RPC outage
+     * while the amount beside it has silently gone stale. This is the only
+     * signal that distinguishes the two.
+     *
+     * `optional` is load-bearing. A bare proto3 bool reads as false when
+     * absent, so a client built against <= 0.0.180 would see "degraded" on
+     * every response; the presence bit separates "this server does not send
+     * it" from "this response is degraded".
+     *
+     * @generated from field: optional bool claimable_includes_uncollected = 9;
+     */
+    claimableIncludesUncollected?: boolean;
     constructor(data?: PartialMessage<GetLaunchCreatorFeesResponse>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.GetLaunchCreatorFeesResponse";

package/dist/data/v2/api_pb.js

@@ -2045,6 +2045,7 @@ CreatorFeeTotals.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "accumulated", kind: "message", T: LaunchCreatorFeeAmounts },
     { no: 2, name: "claimed", kind: "message", T: LaunchCreatorFeeAmounts },
     { no: 3, name: "claimable", kind: "message", T: LaunchCreatorFeeAmounts },
+    { no: 4, name: "claimable_including_uncollected", kind: "message", T: LaunchCreatorFeeAmounts },
 ]);
 /**
  * @generated from message data.v2.GetLaunchCreatorFeesResponse
@@ -2096,6 +2097,9 @@ GetLaunchCreatorFeesResponse.fields = proto3.util.newFieldList(() => [
     { no: 4, name: "position_token_id", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
     { no: 5, name: "fee_beneficiary", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
     { no: 6, name: "as_of_timestamp", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 7, name: "fee_splitter", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 8, name: "beneficiary_vault", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 9, name: "claimable_includes_uncollected", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
 ]);
 /**
  * Server-computed Top Traders leaderboard for a launch token: the token's

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uniswap/client-data-api",
-    "version": "0.0.180",
+    "version": "0.0.183",
     "publishConfig": {
       "access": "public"
     },