@compass-labs/api-sdk 2.1.25 → 2.1.26-rc.1

package/docs/models/components/compassapibackendv2modelsearnreadresponsepositionsvaultposition.md

@@ -17,11 +17,12 @@ let value: CompassApiBackendV2ModelsEarnReadResponsePositionsVaultPosition = {
 
 ## Fields
 
-| Field                                                          | Type                                                           | Required                                                       | Description                                                    |
-| -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- |
-| `type`                                                         | *"VAULT"*                                                      | :heavy_check_mark:                                             | The market type discriminator.                                 |
-| `id`                                                           | *string*                                                       | :heavy_check_mark:                                             | Base64-encoded position identifier.                            |
-| `vaultAddress`                                                 | *string*                                                       | :heavy_check_mark:                                             | The vault address you are depositing to.                       |
-| `amountInUnderlyingToken`                                      | *string*                                                       | :heavy_check_mark:                                             | The user's position value denominated in the underlying token. |
-| `tokenName`                                                    | *string*                                                       | :heavy_check_mark:                                             | Symbol of the underlying token (e.g., USDC).                   |
-| `vaultName`                                                    | *string*                                                       | :heavy_check_mark:                                             | Name of the vault token (share token).                         |
+| Field                                                            | Type                                                             | Required                                                         | Description                                                      |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `type`                                                           | *"VAULT"*                                                        | :heavy_check_mark:                                               | The market type discriminator.                                   |
+| `id`                                                             | *string*                                                         | :heavy_check_mark:                                               | Base64-encoded position identifier.                              |
+| `vaultAddress`                                                   | *string*                                                         | :heavy_check_mark:                                               | The vault address you are depositing to.                         |
+| `amountInUnderlyingToken`                                        | *string*                                                         | :heavy_check_mark:                                               | The user's position value denominated in the underlying token.   |
+| `tokenName`                                                      | *string*                                                         | :heavy_check_mark:                                               | Symbol of the underlying token (e.g., USDC).                     |
+| `vaultName`                                                      | *string*                                                         | :heavy_check_mark:                                               | Name of the vault token (share token).                           |
+| `pnl`                                                            | [components.PositionPnL](../../models/components/positionpnl.md) | :heavy_minus_sign:                                               | PnL breakdown with full deposit/withdrawal history.              |

package/docs/models/components/cooldownend.md

@@ -8,7 +8,7 @@ When the cooldown period ends. ISO 8601 format. UTC timezone.
 ### `Date`
 
 ```typescript
-const value: Date = new Date("2023-12-07T03:31:58.587Z");
+const value: Date = new Date("2024-12-06T03:31:58.587Z");
 ```
 
 ### `boolean`

package/docs/models/components/cooldownposition.md

@@ -7,7 +7,7 @@ import { CooldownPosition } from "@compass-labs/api-sdk/models/components";
 
 let value: CooldownPosition = {
   amountInUnderlyingAsset: "<value>",
-  cooldownEnd: new Date("2024-06-19T22:17:27.773Z"),
+  cooldownEnd: new Date("2025-06-19T22:17:27.773Z"),
   canBeWithdrawn: false,
 };
 ```

package/docs/models/components/depositevent.md

@@ -0,0 +1,29 @@
+# DepositEvent
+
+Historical deposit event for position transparency.
+
+## Example Usage
+
+```typescript
+import { DepositEvent } from "@compass-labs/api-sdk/models/components";
+
+let value: DepositEvent = {
+  blockNumber: 328246,
+  blockTimestamp: new Date("2026-02-17T17:21:39.534Z"),
+  transactionHash: "<value>",
+  assetsDeposited: "<value>",
+  unitsReceived: "<value>",
+  costPerUnit: "<value>",
+};
+```
+
+## Fields
+
+| Field                                                                                         | Type                                                                                          | Required                                                                                      | Description                                                                                   |
+| --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `blockNumber`                                                                                 | *number*                                                                                      | :heavy_check_mark:                                                                            | Block number when deposit occurred                                                            |
+| `blockTimestamp`                                                                              | [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) | :heavy_check_mark:                                                                            | Timestamp of the deposit                                                                      |
+| `transactionHash`                                                                             | *string*                                                                                      | :heavy_check_mark:                                                                            | Transaction hash of the deposit                                                               |
+| `assetsDeposited`                                                                             | *string*                                                                                      | :heavy_check_mark:                                                                            | Amount of underlying asset deposited                                                          |
+| `unitsReceived`                                                                               | *string*                                                                                      | :heavy_check_mark:                                                                            | Shares (vault) or aTokens (Aave) received                                                     |
+| `costPerUnit`                                                                                 | *string*                                                                                      | :heavy_check_mark:                                                                            | Cost basis per unit at time of deposit                                                        |

package/docs/models/components/pendlegetmarketresponse.md

@@ -8,7 +8,7 @@ import { PendleGetMarketResponse } from "@compass-labs/api-sdk/models/components
 let value: PendleGetMarketResponse = {
   marketAddress: "<value>",
   impliedApy: "<value>",
-  maturityDate: new Date("2023-10-18T22:09:52.103Z"),
+  maturityDate: new Date("2024-10-17T22:09:52.103Z"),
   tokens: {
     underlyingToken: {
       address: "46793 Schneider Mount",

package/docs/models/components/pendlelistmarketsresponse.md

@@ -10,7 +10,7 @@ let value: PendleListMarketsResponse = {
     {
       name: "<value>",
       address: "9178 Rebeca Burgs",
-      expiry: new Date("2025-11-13T22:39:31.641Z"),
+      expiry: new Date("2026-11-13T22:39:31.641Z"),
       pt: "<value>",
       yt: "<value>",
       sy: "<value>",
@@ -29,7 +29,7 @@ let value: PendleListMarketsResponse = {
       },
       isNew: true,
       isPrime: false,
-      timestamp: new Date("2024-03-28T12:44:40.088Z"),
+      timestamp: new Date("2025-03-28T12:44:40.088Z"),
     },
   ],
 };

package/docs/models/components/pendlelistuserpositionsresponse.md

@@ -54,7 +54,7 @@ let value: PendleListUserPositionsResponse = {
           balance: "<value>",
         },
       ],
-      updatedAt: new Date("2024-03-19T22:46:00.938Z"),
+      updatedAt: new Date("2025-03-19T22:46:00.938Z"),
     },
   ],
 };

package/docs/models/components/pendlemarket.md

@@ -8,7 +8,7 @@ import { PendleMarket } from "@compass-labs/api-sdk/models/components";
 let value: PendleMarket = {
   name: "<value>",
   address: "22458 Abshire Plains",
-  expiry: new Date("2023-04-18T01:20:41.264Z"),
+  expiry: new Date("2024-04-17T01:20:41.264Z"),
   pt: "<value>",
   yt: "<value>",
   sy: "<value>",
@@ -27,7 +27,7 @@ let value: PendleMarket = {
   },
   isNew: true,
   isPrime: false,
-  timestamp: new Date("2025-09-13T17:20:16.991Z"),
+  timestamp: new Date("2026-09-13T17:20:16.991Z"),
 };
 ```
 

package/docs/models/components/position.md

@@ -52,7 +52,7 @@ let value: Position = {
       balance: "<value>",
     },
   ],
-  updatedAt: new Date("2024-12-17T04:58:12.701Z"),
+  updatedAt: new Date("2025-12-17T04:58:12.701Z"),
 };
 ```
 

package/docs/models/components/positionpnl.md

@@ -0,0 +1,33 @@
+# PositionPnL
+
+PnL breakdown for a position.
+
+## Example Usage
+
+```typescript
+import { PositionPnL } from "@compass-labs/api-sdk/models/components";
+
+let value: PositionPnL = {
+  totalDeposited: "<value>",
+  totalWithdrawn: "<value>",
+  costBasis: "<value>",
+  unrealizedPnl: "<value>",
+  realizedPnl: "<value>",
+  totalYield: "<value>",
+  totalFeesPaid: "<id>",
+};
+```
+
+## Fields
+
+| Field                                                                      | Type                                                                       | Required                                                                   | Description                                                                |
+| -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `totalDeposited`                                                           | *string*                                                                   | :heavy_check_mark:                                                         | Total assets deposited over all time                                       |
+| `totalWithdrawn`                                                           | *string*                                                                   | :heavy_check_mark:                                                         | Total assets withdrawn over all time                                       |
+| `costBasis`                                                                | *string*                                                                   | :heavy_check_mark:                                                         | FIFO cost basis of remaining position                                      |
+| `unrealizedPnl`                                                            | *string*                                                                   | :heavy_check_mark:                                                         | current_value - cost_basis                                                 |
+| `realizedPnl`                                                              | *string*                                                                   | :heavy_check_mark:                                                         | Sum of profits/losses from all withdrawals                                 |
+| `totalYield`                                                               | *string*                                                                   | :heavy_check_mark:                                                         | unrealized_pnl + realized_pnl                                              |
+| `totalFeesPaid`                                                            | *string*                                                                   | :heavy_check_mark:                                                         | Sum of performance fees paid                                               |
+| `deposits`                                                                 | [components.DepositEvent](../../models/components/depositevent.md)[]       | :heavy_minus_sign:                                                         | All deposit events for this position                                       |
+| `withdrawals`                                                              | [components.WithdrawalEvent](../../models/components/withdrawalevent.md)[] | :heavy_minus_sign:                                                         | All withdrawal events for this position                                    |

package/docs/models/components/withdrawalevent.md

@@ -0,0 +1,33 @@
+# WithdrawalEvent
+
+Historical withdrawal event with realized PnL.
+
+## Example Usage
+
+```typescript
+import { WithdrawalEvent } from "@compass-labs/api-sdk/models/components";
+
+let value: WithdrawalEvent = {
+  blockNumber: 460436,
+  blockTimestamp: new Date("2026-06-27T20:19:44.790Z"),
+  transactionHash: "<value>",
+  assetsReceived: "<value>",
+  unitsWithdrawn: "<value>",
+  costBasisConsumed: "<value>",
+  realizedPnl: "<value>",
+  feeCharged: "<value>",
+};
+```
+
+## Fields
+
+| Field                                                                                         | Type                                                                                          | Required                                                                                      | Description                                                                                   |
+| --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `blockNumber`                                                                                 | *number*                                                                                      | :heavy_check_mark:                                                                            | Block number when withdrawal occurred                                                         |
+| `blockTimestamp`                                                                              | [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) | :heavy_check_mark:                                                                            | Timestamp of the withdrawal                                                                   |
+| `transactionHash`                                                                             | *string*                                                                                      | :heavy_check_mark:                                                                            | Transaction hash of the withdrawal                                                            |
+| `assetsReceived`                                                                              | *string*                                                                                      | :heavy_check_mark:                                                                            | Amount of underlying asset received                                                           |
+| `unitsWithdrawn`                                                                              | *string*                                                                                      | :heavy_check_mark:                                                                            | Shares (vault) or aTokens (Aave) burned                                                       |
+| `costBasisConsumed`                                                                           | *string*                                                                                      | :heavy_check_mark:                                                                            | FIFO cost basis of units withdrawn                                                            |
+| `realizedPnl`                                                                                 | *string*                                                                                      | :heavy_check_mark:                                                                            | Profit/loss: assets_received - cost_basis_consumed                                            |
+| `feeCharged`                                                                                  | *string*                                                                                      | :heavy_check_mark:                                                                            | Performance fee charged on this withdrawal                                                    |

package/docs/sdks/earn/README.md

@@ -15,7 +15,7 @@
 
 ## earnPositions
 
-This endpoint fetches all Compass Earn positions.
+This endpoint fetches all Compass Earn positions with PnL information.
 
 ### Example Usage
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compass-labs/api-sdk",
-  "version": "2.1.25",
+  "version": "2.1.26-rc.1",
   "author": "royalnine",
   "type": "module",
   "tshy": {

package/src/funcs/earnEarnPositions.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * List earn positions
  *
  * @remarks
- * This endpoint fetches all Compass Earn positions.
+ * This endpoint fetches all Compass Earn positions with PnL information.
  */
 export function earnEarnPositions(
   client: CompassApiSDKCore,

package/src/lib/config.ts

@@ -62,7 +62,7 @@ export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.0.1",
   sdkVersion: "2.0.0",
-  genVersion: "2.788.7",
+  genVersion: "2.788.15",
   userAgent:
-    "speakeasy-sdk/typescript 2.0.0 2.788.7 0.0.1 @compass-labs/api-sdk",
+    "speakeasy-sdk/typescript 2.0.0 2.788.15 0.0.1 @compass-labs/api-sdk",
 } as const;

package/src/models/components/aaveposition.ts

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { PositionPnL, PositionPnL$inboundSchema } from "./positionpnl.js";
 
 export type AavePosition = {
   /**
@@ -27,6 +28,10 @@ export type AavePosition = {
    */
   tokenName: string;
   vaultName?: "None" | undefined;
+  /**
+   * PnL breakdown with full deposit/withdrawal history.
+   */
+  pnl?: PositionPnL | null | undefined;
 };
 
 /** @internal */
@@ -41,6 +46,7 @@ export const AavePosition$inboundSchema: z.ZodType<
   amount_in_underlying_token: z.string(),
   token_name: z.string(),
   vault_name: z.literal("None").optional(),
+  pnl: z.nullable(PositionPnL$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
     "vault_address": "vaultAddress",

package/src/models/components/compassapibackendv2modelsearnreadresponsepositionsvaultposition.ts

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { PositionPnL, PositionPnL$inboundSchema } from "./positionpnl.js";
 
 export type CompassApiBackendV2ModelsEarnReadResponsePositionsVaultPosition = {
   /**
@@ -33,6 +34,10 @@ export type CompassApiBackendV2ModelsEarnReadResponsePositionsVaultPosition = {
    * Name of the vault token (share token).
    */
   vaultName: string;
+  /**
+   * PnL breakdown with full deposit/withdrawal history.
+   */
+  pnl?: PositionPnL | null | undefined;
 };
 
 /** @internal */
@@ -48,6 +53,7 @@ export const CompassApiBackendV2ModelsEarnReadResponsePositionsVaultPosition$inb
     amount_in_underlying_token: z.string(),
     token_name: z.string(),
     vault_name: z.string(),
+    pnl: z.nullable(PositionPnL$inboundSchema).optional(),
   }).transform((v) => {
     return remap$(v, {
       "vault_address": "vaultAddress",

package/src/models/components/depositevent.ts

@@ -0,0 +1,74 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Historical deposit event for position transparency.
+ */
+export type DepositEvent = {
+  /**
+   * Block number when deposit occurred
+   */
+  blockNumber: number;
+  /**
+   * Timestamp of the deposit
+   */
+  blockTimestamp: Date;
+  /**
+   * Transaction hash of the deposit
+   */
+  transactionHash: string;
+  /**
+   * Amount of underlying asset deposited
+   */
+  assetsDeposited: string;
+  /**
+   * Shares (vault) or aTokens (Aave) received
+   */
+  unitsReceived: string;
+  /**
+   * Cost basis per unit at time of deposit
+   */
+  costPerUnit: string;
+};
+
+/** @internal */
+export const DepositEvent$inboundSchema: z.ZodType<
+  DepositEvent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  block_number: z.number().int(),
+  block_timestamp: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  transaction_hash: z.string(),
+  assets_deposited: z.string(),
+  units_received: z.string(),
+  cost_per_unit: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "block_number": "blockNumber",
+    "block_timestamp": "blockTimestamp",
+    "transaction_hash": "transactionHash",
+    "assets_deposited": "assetsDeposited",
+    "units_received": "unitsReceived",
+    "cost_per_unit": "costPerUnit",
+  });
+});
+
+export function depositEventFromJSON(
+  jsonString: string,
+): SafeParseResult<DepositEvent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DepositEvent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DepositEvent' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -79,6 +79,7 @@ export * from "./compassapibackendv2modelssafetransactresponsebatchedsafeoperati
 export * from "./cooldownposition.js";
 export * from "./createaccountrequest.js";
 export * from "./createaccountresponse.js";
+export * from "./depositevent.js";
 export * from "./depositforburnrequest.js";
 export * from "./depositforburnresponse.js";
 export * from "./details.js";
@@ -168,6 +169,7 @@ export * from "./permittypeddataresponseinput.js";
 export * from "./permittypeddataresponseoutput.js";
 export * from "./portfolio.js";
 export * from "./position.js";
+export * from "./positionpnl.js";
 export * from "./protocol.js";
 export * from "./repay.js";
 export * from "./reserve.js";
@@ -246,6 +248,7 @@ export * from "./vaultwithdrawrequest.js";
 export * from "./weeklyapys.js";
 export * from "./wildcatgetmarketresponse.js";
 export * from "./withdraw.js";
+export * from "./withdrawalevent.js";
 export * from "./wrapethparams.js";
 export * from "./wrapethrequest.js";
 export * from "./yieldrange.js";

package/src/models/components/positionpnl.ts

@@ -0,0 +1,93 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { DepositEvent, DepositEvent$inboundSchema } from "./depositevent.js";
+import {
+  WithdrawalEvent,
+  WithdrawalEvent$inboundSchema,
+} from "./withdrawalevent.js";
+
+/**
+ * PnL breakdown for a position.
+ */
+export type PositionPnL = {
+  /**
+   * Total assets deposited over all time
+   */
+  totalDeposited: string;
+  /**
+   * Total assets withdrawn over all time
+   */
+  totalWithdrawn: string;
+  /**
+   * FIFO cost basis of remaining position
+   */
+  costBasis: string;
+  /**
+   * current_value - cost_basis
+   */
+  unrealizedPnl: string;
+  /**
+   * Sum of profits/losses from all withdrawals
+   */
+  realizedPnl: string;
+  /**
+   * unrealized_pnl + realized_pnl
+   */
+  totalYield: string;
+  /**
+   * Sum of performance fees paid
+   */
+  totalFeesPaid: string;
+  /**
+   * All deposit events for this position
+   */
+  deposits?: Array<DepositEvent> | undefined;
+  /**
+   * All withdrawal events for this position
+   */
+  withdrawals?: Array<WithdrawalEvent> | undefined;
+};
+
+/** @internal */
+export const PositionPnL$inboundSchema: z.ZodType<
+  PositionPnL,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  total_deposited: z.string(),
+  total_withdrawn: z.string(),
+  cost_basis: z.string(),
+  unrealized_pnl: z.string(),
+  realized_pnl: z.string(),
+  total_yield: z.string(),
+  total_fees_paid: z.string(),
+  deposits: z.array(DepositEvent$inboundSchema).optional(),
+  withdrawals: z.array(WithdrawalEvent$inboundSchema).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "total_deposited": "totalDeposited",
+    "total_withdrawn": "totalWithdrawn",
+    "cost_basis": "costBasis",
+    "unrealized_pnl": "unrealizedPnl",
+    "realized_pnl": "realizedPnl",
+    "total_yield": "totalYield",
+    "total_fees_paid": "totalFeesPaid",
+  });
+});
+
+export function positionPnLFromJSON(
+  jsonString: string,
+): SafeParseResult<PositionPnL, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PositionPnL$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PositionPnL' from JSON`,
+  );
+}

package/src/models/components/withdrawalevent.ts

@@ -0,0 +1,86 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Historical withdrawal event with realized PnL.
+ */
+export type WithdrawalEvent = {
+  /**
+   * Block number when withdrawal occurred
+   */
+  blockNumber: number;
+  /**
+   * Timestamp of the withdrawal
+   */
+  blockTimestamp: Date;
+  /**
+   * Transaction hash of the withdrawal
+   */
+  transactionHash: string;
+  /**
+   * Amount of underlying asset received
+   */
+  assetsReceived: string;
+  /**
+   * Shares (vault) or aTokens (Aave) burned
+   */
+  unitsWithdrawn: string;
+  /**
+   * FIFO cost basis of units withdrawn
+   */
+  costBasisConsumed: string;
+  /**
+   * Profit/loss: assets_received - cost_basis_consumed
+   */
+  realizedPnl: string;
+  /**
+   * Performance fee charged on this withdrawal
+   */
+  feeCharged: string;
+};
+
+/** @internal */
+export const WithdrawalEvent$inboundSchema: z.ZodType<
+  WithdrawalEvent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  block_number: z.number().int(),
+  block_timestamp: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  transaction_hash: z.string(),
+  assets_received: z.string(),
+  units_withdrawn: z.string(),
+  cost_basis_consumed: z.string(),
+  realized_pnl: z.string(),
+  fee_charged: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "block_number": "blockNumber",
+    "block_timestamp": "blockTimestamp",
+    "transaction_hash": "transactionHash",
+    "assets_received": "assetsReceived",
+    "units_withdrawn": "unitsWithdrawn",
+    "cost_basis_consumed": "costBasisConsumed",
+    "realized_pnl": "realizedPnl",
+    "fee_charged": "feeCharged",
+  });
+});
+
+export function withdrawalEventFromJSON(
+  jsonString: string,
+): SafeParseResult<WithdrawalEvent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WithdrawalEvent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WithdrawalEvent' from JSON`,
+  );
+}

package/src/sdk/earn.ts

@@ -20,7 +20,7 @@ export class Earn extends ClientSDK {
    * List earn positions
    *
    * @remarks
-   * This endpoint fetches all Compass Earn positions.
+   * This endpoint fetches all Compass Earn positions with PnL information.
    */
   async earnPositions(
     request: operations.V2EarnPositionsRequest,