@pear-protocol/types 1.32.0 → 1.33.0

package/dist/users/entities.d.ts

@@ -24,6 +24,7 @@ export declare const BoundReferralReferee: z.ZodObject<{
     address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
     referredAt: z.ZodOptional<z.ZodNumber>;
     tradeCount: z.ZodNumber;
+    volumeUsd: z.ZodString;
 }, z.core.$strip>;
 export declare const PendingReferralReferee: z.ZodObject<{
     status: z.ZodLiteral<"PENDING">;
@@ -34,6 +35,7 @@ export declare const ReferralReferee: z.ZodDiscriminatedUnion<[z.ZodObject<{
     address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
     referredAt: z.ZodOptional<z.ZodNumber>;
     tradeCount: z.ZodNumber;
+    volumeUsd: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     status: z.ZodLiteral<"PENDING">;
     address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;

package/dist/users/entities.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { EthereumAddress } from '../common/address';
+import { UnsignedDecimalString } from '../common/schema';
 
 const UserPreferences = z.object({
   slippageToleranceBps: z.int().describe("User slippage preference in basis points")
@@ -28,7 +29,8 @@ const BoundReferralReferee = z.object({
   status: z.literal("BOUND").describe("The referee resolves to a V3 user with a permanent binding"),
   address: EthereumAddress.optional().describe("Linked EVM wallet address when the referee has one"),
   referredAt: z.number().int().nonnegative().optional().describe("V3 attribution time in epoch milliseconds; not the original legacy on-chain referral time, and absent on a historical binding without a recoverable date"),
-  tradeCount: z.number().int().nonnegative().describe("Distinct Pear executions with at least one real confirmed fill")
+  tradeCount: z.number().int().nonnegative().describe("Distinct Pear executions with at least one real confirmed fill"),
+  volumeUsd: UnsignedDecimalString.describe("Post-binding V3 volume from real confirmed Pear fills, in USD")
 });
 const PendingReferralReferee = z.object({
   status: z.literal("PENDING").describe("A verified legacy referee that has no V3 identity yet"),

package/dist/users/response.d.ts

@@ -40,11 +40,13 @@ export declare const ReferralRefereeListResponse: z.ZodObject<{
     nextCursor: z.ZodOptional<z.ZodString>;
     count: z.ZodNumber;
     pendingCount: z.ZodNumber;
+    totalVolumeUsd: z.ZodString;
     referees: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         status: z.ZodLiteral<"BOUND">;
         address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
         referredAt: z.ZodOptional<z.ZodNumber>;
         tradeCount: z.ZodNumber;
+        volumeUsd: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         status: z.ZodLiteral<"PENDING">;
         address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;

package/dist/users/response.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { CursorResponse } from '../common/response';
+import { UnsignedDecimalString } from '../common/schema';
 import { UserPreferences, UserProfile, ReferralReferee } from './entities';
 
 const ProfileResponse = z.object({
@@ -19,6 +20,7 @@ const ReferralStatusResponse = z.object({
 const ReferralRefereeListResponse = CursorResponse.extend({
   count: z.number().int().nonnegative().describe("Total referees this list yields, counting bound V3 users and pending legacy wallets together"),
   pendingCount: z.number().int().nonnegative().describe("Subset of count whose verified legacy wallet has no V3 identity yet, so no binding exists"),
+  totalVolumeUsd: UnsignedDecimalString.describe("Post-binding V3 volume from real confirmed Pear fills across the complete bound referee set, independent of pagination"),
   referees: z.array(ReferralReferee)
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/types",
-  "version": "1.32.0",
+  "version": "1.33.0",
   "description": "Pear Protocol Types definitions",
   "private": false,
   "type": "module",