@pear-protocol/types 1.26.1 → 1.28.0

package/dist/execution/entities.d.ts

@@ -81,6 +81,7 @@ export declare const BaseExecution: z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -132,6 +133,7 @@ export declare const MarketOpenExecution: z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -210,6 +212,7 @@ export declare const MarketAdjustExecution: z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -292,6 +295,7 @@ export declare const MarketCloseExecution: z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -349,6 +353,7 @@ export declare const MarketReverseExecution: z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -406,6 +411,7 @@ export declare const MarketExecution: z.ZodDiscriminatedUnion<[z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -483,6 +489,7 @@ export declare const MarketExecution: z.ZodDiscriminatedUnion<[z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -564,6 +571,7 @@ export declare const MarketExecution: z.ZodDiscriminatedUnion<[z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -620,6 +628,7 @@ export declare const MarketExecution: z.ZodDiscriminatedUnion<[z.ZodObject<{
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -677,6 +686,7 @@ export declare const Execution: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -754,6 +764,7 @@ export declare const Execution: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -835,6 +846,7 @@ export declare const Execution: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;
@@ -891,6 +903,7 @@ export declare const Execution: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion
             REJECTED: "REJECTED";
         }>;
         error: z.ZodOptional<z.ZodString>;
+        errorCode: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         type: z.ZodLiteral<"MARKET">;

package/dist/execution/responses.d.ts

@@ -38,6 +38,7 @@ export declare const ExecutionListResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -115,6 +116,7 @@ export declare const ExecutionListResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -196,6 +198,7 @@ export declare const ExecutionListResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -252,6 +255,7 @@ export declare const ExecutionListResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -312,6 +316,7 @@ export declare const GetExecutionResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -389,6 +394,7 @@ export declare const GetExecutionResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -470,6 +476,7 @@ export declare const GetExecutionResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -526,6 +533,7 @@ export declare const GetExecutionResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;

package/dist/misc/payloads.d.ts

@@ -48,3 +48,45 @@ export declare const SubmitLighterFastWithdrawParams: z.ZodObject<{
     l1Signature: z.ZodString;
 }, z.core.$strip>;
 export type SubmitLighterFastWithdrawParams = z.output<typeof SubmitLighterFastWithdrawParams>;
+/** The Lighter account tiers a user can switch between, spelled the way Lighter spells them. */
+export declare const LighterAccountTier: z.ZodEnum<{
+    standard: "standard";
+    plus: "plus";
+    premium: "premium";
+}>;
+export type LighterAccountTier = z.output<typeof LighterAccountTier>;
+export declare const ChangeLighterAccountTierParams: z.ZodObject<{
+    accountIndex: z.ZodNumber;
+    apiKeyIndex: z.ZodNumber;
+    apiPrivateKey: z.ZodString;
+    tier: z.ZodEnum<{
+        standard: "standard";
+        plus: "plus";
+        premium: "premium";
+    }>;
+}, z.core.$strip>;
+export type ChangeLighterAccountTierParams = z.output<typeof ChangeLighterAccountTierParams>;
+/**
+ * The wallet a Fun.xyz universal deposit address (UDA) is minted for.
+ *
+ * The bridge mints one address set per (wallet, market, asset) triple and reuses it, so the same
+ * request answers for a wallet Lighter has never seen and for one that already holds an account.
+ */
+export declare const CreateLighterUdaParams: z.ZodObject<{
+    walletAddress: z.ZodString;
+    market: z.ZodEnum<{
+        spot: "spot";
+        perps: "perps";
+    }>;
+    asset: z.ZodEnum<{
+        USDC: "USDC";
+        ETH: "ETH";
+    }>;
+    accountIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateLighterUdaParams = z.output<typeof CreateLighterUdaParams>;
+/** The wallet whose Fun.xyz bridge transactions are being read. */
+export declare const ListLighterUdaDepositsParams: z.ZodObject<{
+    walletAddress: z.ZodString;
+}, z.core.$strip>;
+export type ListLighterUdaDepositsParams = z.output<typeof ListLighterUdaDepositsParams>;

package/dist/misc/payloads.js

@@ -42,5 +42,32 @@ const SubmitLighterFastWithdrawParams = z.object({
   txInfo: z.string(),
   l1Signature: z.string()
 });
+const LighterAccountTier = z.enum([
+  "standard",
+  "plus",
+  "premium"
+]);
+const ChangeLighterAccountTierParams = z.object({
+  accountIndex: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
+  apiKeyIndex: z.number().int().nonnegative().max(254),
+  apiPrivateKey: z.string(),
+  tier: LighterAccountTier
+});
+const CreateLighterUdaParams = z.object({
+  walletAddress: z.string().regex(/^0x[0-9a-fA-F]{40}$/),
+  market: z.enum([
+    "perps",
+    "spot"
+  ]),
+  asset: z.enum([
+    "USDC",
+    "ETH"
+  ]),
+  // Targets a sub-account; absent credits the wallet's master account index.
+  accountIndex: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).optional()
+});
+const ListLighterUdaDepositsParams = z.object({
+  walletAddress: z.string().regex(/^0x[0-9a-fA-F]{40}$/)
+});
 
-export { CreateAuthTokenParams, CreateLighterApiKeyParams, PrepareApproveIntegratorParams, PrepareLighterFastWithdrawParams, SubmitApproveIntegratorParams, SubmitChangePubKeyParams, SubmitLighterFastWithdrawParams };
+export { ChangeLighterAccountTierParams, CreateAuthTokenParams, CreateLighterApiKeyParams, CreateLighterUdaParams, LighterAccountTier, ListLighterUdaDepositsParams, PrepareApproveIntegratorParams, PrepareLighterFastWithdrawParams, SubmitApproveIntegratorParams, SubmitChangePubKeyParams, SubmitLighterFastWithdrawParams };

package/dist/misc/responses.d.ts

@@ -35,3 +35,92 @@ export declare const SubmitLighterFastWithdrawResult: z.ZodObject<{
     txHash: z.ZodString;
 }, z.core.$strip>;
 export type SubmitLighterFastWithdrawResult = z.output<typeof SubmitLighterFastWithdrawResult>;
+export declare const ChangeLighterAccountTierResult: z.ZodObject<{
+    tier: z.ZodEnum<{
+        standard: "standard";
+        plus: "plus";
+        premium: "premium";
+    }>;
+}, z.core.$strip>;
+export type ChangeLighterAccountTierResult = z.output<typeof ChangeLighterAccountTierResult>;
+/**
+ * Where the Fun.xyz bridge will credit anything sent to a minted address.
+ *
+ * `userId` names the wallet this answer is for, and a caller must refuse any resolution whose
+ * `userId` is not the wallet it asked about — an answer naming another one describes somebody
+ * else's deposit address. `recipientAddr` then names the Lighter account: its index once the
+ * account exists, and the literal `l1` while it does not, because the first deposit is what
+ * creates it.
+ */
+export declare const LighterUdaResolution: z.ZodObject<{
+    toChainId: z.ZodString;
+    toTokenAddress: z.ZodString;
+    actionType: z.ZodString;
+    recipientAddr: z.ZodString;
+    userId: z.ZodString;
+}, z.core.$strip>;
+export type LighterUdaResolution = z.output<typeof LighterUdaResolution>;
+/**
+ * The bridge's answer for one wallet: its deposit addresses, or a refusal to serve it.
+ *
+ * Reading `status` is what makes the addresses available. A served wallet always names the EVM
+ * deposit address and what it credits, and a refusal carries neither — so a caller cannot reach an
+ * address without first learning the bridge agreed to serve it. A chain family the bridge cannot
+ * currently serve stays absent rather than blank, because a present-but-empty key would read as an
+ * address someone could send funds to.
+ *
+ * The union sits under `uda` rather than at the top level so the response stays an object, matching
+ * `RebalanceManualResponse`. A bare top-level union does build, but nestjs-zod publishes it behind a
+ * synthetic `root` key that only `cleanupOpenApiDoc` unwraps.
+ */
+export declare const CreateLighterUdaResult: z.ZodObject<{
+    uda: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"blocked">;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"served">;
+        depositAddr: z.ZodString;
+        resolved: z.ZodObject<{
+            toChainId: z.ZodString;
+            toTokenAddress: z.ZodString;
+            actionType: z.ZodString;
+            recipientAddr: z.ZodString;
+            userId: z.ZodString;
+        }, z.core.$strip>;
+        solanaAddr: z.ZodOptional<z.ZodString>;
+        tronAddr: z.ZodOptional<z.ZodString>;
+        btcAddrSegwit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "status">;
+}, z.core.$strip>;
+export type CreateLighterUdaResult = z.output<typeof CreateLighterUdaResult>;
+/**
+ * One deposit the bridge has seen for a wallet, from source transfer to Lighter credit.
+ *
+ * `status` stays an open string because the bridge documents only PROCESSING and COMPLETED, and
+ * rejecting an undocumented state here would hide a deposit that genuinely happened.
+ */
+export declare const LighterUdaTransaction: z.ZodObject<{
+    fromChainId: z.ZodString;
+    fromTokenAddress: z.ZodString;
+    fromAmountBaseUnit: z.ZodString;
+    toChainId: z.ZodString;
+    toTokenAddress: z.ZodString;
+    txHash: z.ZodString;
+    createdTimeMs: z.ZodNumber;
+    status: z.ZodString;
+    depositAddr: z.ZodString;
+}, z.core.$strip>;
+export type LighterUdaTransaction = z.output<typeof LighterUdaTransaction>;
+export declare const ListLighterUdaDepositsResult: z.ZodObject<{
+    transactions: z.ZodArray<z.ZodObject<{
+        fromChainId: z.ZodString;
+        fromTokenAddress: z.ZodString;
+        fromAmountBaseUnit: z.ZodString;
+        toChainId: z.ZodString;
+        toTokenAddress: z.ZodString;
+        txHash: z.ZodString;
+        createdTimeMs: z.ZodNumber;
+        status: z.ZodString;
+        depositAddr: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ListLighterUdaDepositsResult = z.output<typeof ListLighterUdaDepositsResult>;

package/dist/misc/responses.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { LighterAccountTier } from './payloads';
 
 const CreateApiKeyWithMessageResult = z.object({
   privateKey: z.string(),
@@ -31,5 +32,46 @@ const PrepareLighterFastWithdrawResult = z.object({
 const SubmitLighterFastWithdrawResult = z.object({
   txHash: z.string()
 });
+const ChangeLighterAccountTierResult = z.object({
+  // The tier Lighter accepted. Its own acknowledgement names no tier, so this echoes the request.
+  tier: LighterAccountTier
+});
+const LighterUdaResolution = z.object({
+  toChainId: z.string(),
+  toTokenAddress: z.string(),
+  actionType: z.string(),
+  recipientAddr: z.string(),
+  userId: z.string()
+});
+const CreateLighterUdaResult = z.object({
+  uda: z.discriminatedUnion("status", [
+    z.object({
+      status: z.literal("blocked")
+    }),
+    z.object({
+      status: z.literal("served"),
+      depositAddr: z.string(),
+      resolved: LighterUdaResolution,
+      // Absent rather than blank on a chain family the bridge does not currently serve.
+      solanaAddr: z.string().min(1).optional(),
+      tronAddr: z.string().min(1).optional(),
+      btcAddrSegwit: z.string().min(1).optional()
+    })
+  ])
+});
+const LighterUdaTransaction = z.object({
+  fromChainId: z.string(),
+  fromTokenAddress: z.string(),
+  fromAmountBaseUnit: z.string(),
+  toChainId: z.string(),
+  toTokenAddress: z.string(),
+  txHash: z.string(),
+  createdTimeMs: z.number(),
+  status: z.string(),
+  depositAddr: z.string()
+});
+const ListLighterUdaDepositsResult = z.object({
+  transactions: z.array(LighterUdaTransaction)
+});
 
-export { CreateApiKeyWithMessageResult, CreateAuthTokenResult, PrepareApproveIntegratorResult, PrepareLighterFastWithdrawResult, SubmitApproveIntegratorResult, SubmitChangePubKeyResult, SubmitLighterFastWithdrawResult };
+export { ChangeLighterAccountTierResult, CreateApiKeyWithMessageResult, CreateAuthTokenResult, CreateLighterUdaResult, LighterUdaResolution, LighterUdaTransaction, ListLighterUdaDepositsResult, PrepareApproveIntegratorResult, PrepareLighterFastWithdrawResult, SubmitApproveIntegratorResult, SubmitChangePubKeyResult, SubmitLighterFastWithdrawResult };

package/dist/order/entities.d.ts

@@ -24,6 +24,7 @@ export declare const MarketOrder: z.ZodObject<{
         REJECTED: "REJECTED";
     }>;
     error: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"MARKET">;
@@ -55,6 +56,7 @@ export declare const Order: z.ZodDiscriminatedUnion<[z.ZodObject<{
         REJECTED: "REJECTED";
     }>;
     error: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"MARKET">;

package/dist/order/entities.js

@@ -28,6 +28,10 @@ const BaseOrder = z.object({
   */
   error: z.string().optional(),
   /**
+  * Venue-specific error code for the failure, when the venue provided one
+  */
+  errorCode: z.string().optional(),
+  /**
   * Created at timestamp
   */
   createdAt: z.string(),

package/dist/statistics/entities.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export declare const LeaderboardRow: z.ZodObject<{
     tradeAccountId: z.ZodString;
-    exchangeIdentifier: z.ZodString;
+    userId: z.ZodString;
     connector: z.ZodEnum<{
         hyperliquid: "hyperliquid";
         binance: "binance";

package/dist/statistics/entities.js

@@ -2,11 +2,14 @@ import { z } from 'zod';
 import { Connector } from '../connector';
 
 const LeaderboardRow = z.object({
-  // The row's identity. Two accounts may register the same exchange identifier, so this
-  // is the only field that separates their rows — and the only safe key to render by.
+  // The row's identity, and the only safe key to render or join by.
   tradeAccountId: z.string(),
-  // Address for Hyperliquid/Lighter, exchange account UID for CEXes.
-  exchangeIdentifier: z.string(),
+  // The trader the account belongs to, so a consumer can group the several rows one person
+  // earns across venues. The board deliberately publishes no exchange identifier: a wallet
+  // address beside a real name and a PnL deanonymizes a trader for good, and an address is
+  // not reversible once scraped. Neither id here is a credential — every route that takes
+  // one checks ownership or role, never knowledge of the id.
+  userId: z.string(),
   connector: Connector,
   // Every fill inside the window, whatever period its position began in — so unlike the
   // money fields below, this can report trading whose fees and PnL belong to another window.
@@ -46,11 +49,10 @@ const LeaderboardRow = z.object({
   // window left its open positions unpriced, when every position it opened in the window
   // closed after it, or when a position recorded no opening size.
   roi: z.string().optional(),
-  // The trader's linked X account. Absent for an account whose owner has connected no X
-  // account, and absent for an anonymous caller: the board itself is public, but pairing a
-  // real name with a wallet address and a PnL for the open internet is a wider promise than
-  // the one the user accepted when connecting X. Never null-with-a-key: absence is the
-  // signal.
+  // The trader's linked X account, published to every caller — the board names its traders
+  // on the open internet, signed in or not. Absent for an account whose owner has connected
+  // no X account, and absent for one who hid the link from the board. Never null-with-a-key:
+  // absence is the signal.
   //
   // Whatever X reported at the owner's last authorization. Nothing re-reads X in between,
   // so a trader who renamed and has not signed in since is named by their old handle.

package/dist/statistics/queries.d.ts

@@ -75,6 +75,7 @@ export declare const LeaderboardQueryParams: z.ZodObject<{
     }>>;
     startDate: z.ZodOptional<z.ZodPipe<z.ZodCoercedNumber<number>, z.ZodTransform<Date, number>>>;
     endDate: z.ZodOptional<z.ZodPipe<z.ZodCoercedNumber<number>, z.ZodTransform<Date, number>>>;
+    includeUnlinkedX: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodCodec<z.ZodString, z.ZodBoolean>]>>>;
     limit: z.ZodDefault<z.ZodCoercedNumber<number>>;
 }, z.core.$strip>;
 export type LeaderboardQueryParamsInput = z.input<typeof LeaderboardQueryParams>;

package/dist/statistics/queries.js

@@ -71,6 +71,20 @@ const LeaderboardQueryParams = z.object({
   // is settled and reproducible, and only there is unrealized PnL omitted: it is a value as
   // of now, and now is outside such a window.
   endDate: UnixSeconds.optional(),
+  // Whether an account whose owner linked no X account may hold a row. Off by default,
+  // because a trader who has not linked X does not qualify for the campaign the board
+  // feeds. Eligibility turns on linking, so admission does too: a trader who linked X
+  // and then withheld the handle keeps their rank and loses only their name.
+  // The gate is on the account, not on the viewer: it applies before the top-N cut, so
+  // it selects who makes the board rather than thinning the rows that came back, and
+  // every caller is served exactly the same board.
+  //
+  // Deliberately not `z.coerce.boolean()`, which reads the string "false" as true and
+  // would leave the default impossible to restore explicitly from a URL.
+  includeUnlinkedX: z.union([
+    z.boolean(),
+    z.stringbool()
+  ]).optional().default(false),
   limit: z.coerce.number().int().positive().max(LEADERBOARD_MAX_LIMIT).default(LEADERBOARD_MAX_LIMIT)
 }).refine((data) => !data.startDate || !data.endDate || data.startDate < data.endDate, {
   message: "startDate must be before endDate"

package/dist/statistics/responses.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 export declare const LeaderboardResponse: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         tradeAccountId: z.ZodString;
-        exchangeIdentifier: z.ZodString;
+        userId: z.ZodString;
         connector: z.ZodEnum<{
             hyperliquid: "hyperliquid";
             binance: "binance";

package/dist/trade/responses.d.ts

@@ -36,6 +36,7 @@ export declare const CreateTradeOpenResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -113,6 +114,7 @@ export declare const CreateTradeOpenResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -194,6 +196,7 @@ export declare const CreateTradeOpenResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -250,6 +253,7 @@ export declare const CreateTradeOpenResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -310,6 +314,7 @@ export declare const CreateTradeAdjustResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -387,6 +392,7 @@ export declare const CreateTradeAdjustResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -468,6 +474,7 @@ export declare const CreateTradeAdjustResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -524,6 +531,7 @@ export declare const CreateTradeAdjustResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -584,6 +592,7 @@ export declare const CreateTradeCloseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -661,6 +670,7 @@ export declare const CreateTradeCloseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -742,6 +752,7 @@ export declare const CreateTradeCloseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -798,6 +809,7 @@ export declare const CreateTradeCloseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -858,6 +870,7 @@ export declare const CreateTradeReverseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -935,6 +948,7 @@ export declare const CreateTradeReverseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -1016,6 +1030,7 @@ export declare const CreateTradeReverseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -1072,6 +1087,7 @@ export declare const CreateTradeReverseResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -1132,6 +1148,7 @@ export declare const CreateTradeCloseAllResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -1209,6 +1226,7 @@ export declare const CreateTradeCloseAllResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -1290,6 +1308,7 @@ export declare const CreateTradeCloseAllResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;
@@ -1346,6 +1365,7 @@ export declare const CreateTradeCloseAllResponse: z.ZodObject<{
                 REJECTED: "REJECTED";
             }>;
             error: z.ZodOptional<z.ZodString>;
+            errorCode: z.ZodOptional<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
             type: z.ZodLiteral<"MARKET">;

package/dist/users/entities.d.ts

@@ -19,9 +19,25 @@ export declare const UserProfile: z.ZodObject<{
 }, z.core.$strip>;
 export type UserPreferences = z.infer<typeof UserPreferences>;
 export type UserProfile = z.infer<typeof UserProfile>;
-export declare const ReferralReferee: z.ZodObject<{
+export declare const BoundReferralReferee: 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;
 }, z.core.$strip>;
+export declare const PendingReferralReferee: z.ZodObject<{
+    status: z.ZodLiteral<"PENDING">;
+    address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strip>;
+export declare const ReferralReferee: 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;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"PENDING">;
+    address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strip>], "status">;
+export type BoundReferralReferee = z.infer<typeof BoundReferralReferee>;
+export type PendingReferralReferee = z.infer<typeof PendingReferralReferee>;
 export type ReferralReferee = z.infer<typeof ReferralReferee>;

package/dist/users/entities.js

@@ -24,10 +24,19 @@ const UserProfile = z.object({
   // linked it describes what would happen once one is.
   xHidden: z.boolean().describe("Whether the leaderboard withholds the linked X account")
 }).describe("User profile of the authenticated user");
-const ReferralReferee = z.object({
+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"),
+  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")
 });
+const PendingReferralReferee = z.object({
+  status: z.literal("PENDING").describe("A verified legacy referee that has no V3 identity yet"),
+  address: EthereumAddress.describe("The verified legacy wallet, the only fact a pending referee carries")
+});
+const ReferralReferee = z.discriminatedUnion("status", [
+  BoundReferralReferee,
+  PendingReferralReferee
+]).describe("One referral-history entry, shaped by whether the referee is bound to a V3 user yet");
 
-export { ReferralReferee, UserPreferences, UserProfile };
+export { BoundReferralReferee, PendingReferralReferee, ReferralReferee, UserPreferences, UserProfile };

package/dist/users/response.d.ts

@@ -39,10 +39,15 @@ export declare const ReferralRefereeListResponse: z.ZodObject<{
     limit: z.ZodNumber;
     nextCursor: z.ZodOptional<z.ZodString>;
     count: z.ZodNumber;
-    referees: z.ZodArray<z.ZodObject<{
+    pendingCount: z.ZodNumber;
+    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;
-    }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"PENDING">;
+        address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>], "status">>;
 }, z.core.$strip>;
 export type ReferralRefereeListResponse = z.infer<typeof ReferralRefereeListResponse>;

package/dist/users/response.js

@@ -17,7 +17,8 @@ const ReferralStatusResponse = z.object({
   referrerCode: z.string().optional().describe("Exact case-sensitive code owned by the permanent referrer")
 });
 const ReferralRefereeListResponse = CursorResponse.extend({
-  count: z.number().int().nonnegative().describe("Total V3 users permanently bound to the authenticated referrer"),
+  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"),
   referees: z.array(ReferralReferee)
 });
 

package/package.json

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