@pear-protocol/types 1.18.0 → 1.20.0

package/dist/auth/payloads.d.ts

@@ -13,11 +13,13 @@ export declare const LinkEmailRequest: z.ZodObject<{
 export declare const LinkWalletRequest: z.ZodObject<{
     address: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     signature: z.ZodString;
+    nonce: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const WalletLoginRequest: z.ZodObject<{
     method: z.ZodLiteral<"wallet">;
     address: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     signature: z.ZodString;
+    nonce: z.ZodOptional<z.ZodString>;
     accessCode: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const EmailLoginRequest: z.ZodObject<{
@@ -44,6 +46,7 @@ export declare const LoginRequest: z.ZodDiscriminatedUnion<[z.ZodObject<{
     method: z.ZodLiteral<"wallet">;
     address: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     signature: z.ZodString;
+    nonce: z.ZodOptional<z.ZodString>;
     accessCode: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     method: z.ZodLiteral<"email">;

package/dist/auth/payloads.js

@@ -4,6 +4,7 @@ const EthereumAddress = z.string().regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereu
 const Email = z.email("Invalid email address").transform((val) => val.toLowerCase()).describe("Email address (lowercase)");
 const Password = z.string().min(8, "Password must be at least 8 characters").max(128, "Password must be at most 128 characters").describe("Password for authentication");
 const AccessCode = z.string().trim().max(64).optional().describe("Optional beta access code");
+const SignedNonce = z.string().min(1).max(128).optional().describe("Nonce of the signed challenge, as returned by the nonce endpoint");
 const RequestNonceRequest = z.object({
   address: EthereumAddress
 }).describe("Request a nonce for wallet authentication");
@@ -17,12 +18,14 @@ const LinkEmailRequest = z.object({
 }).describe("Link email credentials to the authenticated account");
 const LinkWalletRequest = z.object({
   address: EthereumAddress,
-  signature: z.string().min(1, "Signature is required").describe("Signature of the nonce message")
+  signature: z.string().min(1, "Signature is required").describe("Signature of the nonce message"),
+  nonce: SignedNonce
 }).describe("Link wallet credentials to the authenticated account");
 const WalletLoginRequest = z.object({
   method: z.literal("wallet").describe('Must be "wallet" for wallet authentication'),
   address: EthereumAddress,
   signature: z.string().min(1, "Signature is required").describe("Signature of the nonce message"),
+  nonce: SignedNonce,
   accessCode: AccessCode
 }).describe("Wallet-based authentication using nonce signature");
 const EmailLoginRequest = z.object({

package/dist/sync/payloads.d.ts

@@ -348,6 +348,7 @@ export type SyncMeta = z.output<typeof SyncMeta>;
 export declare const CreateApplicablesMeta: z.ZodObject<{
     externalMaxTs: z.ZodNullable<z.ZodNumber>;
     firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
+    newestFillTs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type CreateApplicablesMeta = z.output<typeof CreateApplicablesMeta>;
 /**
@@ -429,6 +430,7 @@ export declare const CreateApplicablesRequest: z.ZodObject<{
     meta: z.ZodObject<{
         externalMaxTs: z.ZodNullable<z.ZodNumber>;
         firstSyncStartedAt: z.ZodOptional<z.ZodNumber>;
+        newestFillTs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type CreateApplicablesRequest = z.output<typeof CreateApplicablesRequest>;

package/dist/sync/payloads.js

@@ -111,7 +111,11 @@ const SyncMeta = z.object({
   ).nullable().describe("watermark advance source")
 });
 const CreateApplicablesMeta = SyncMeta.extend({
-  firstSyncStartedAt: z.number().int().nonnegative().optional().describe("backend-issued timestamp returned before the first fill-history fetch")
+  firstSyncStartedAt: z.number().int().nonnegative().optional().describe("backend-issued timestamp returned before the first fill-history fetch"),
+  newestFillTs: z.number().int().nonnegative().refine(
+    (timestamp) => timestamp <= Date.now() + WATERMARK_FUTURE_SKEW_MS,
+    "newestFillTs must not be ahead of server time"
+  ).optional().describe("raw newest fetched fill \u2014 settle-gate source, never trim-advanced")
 });
 const CreateApplicablesRequest = z.object({
   applicables: z.array(ApplicablePosition),

package/dist/trade/responses.d.ts

@@ -1095,277 +1095,5 @@ export declare const CreateTradeReverseResponse: z.ZodObject<{
     }, z.core.$strip>], "intent">], "orderType">;
 }, z.core.$strip>;
 export type CreateTradeReverseResponse = z.output<typeof CreateTradeReverseResponse>;
-export declare const CreateTradeCloseAllResponse: z.ZodObject<{
-    executions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
-        id: z.ZodUUID;
-        connector: z.ZodEnum<{
-            hyperliquid: "hyperliquid";
-            binance: "binance";
-            bybit: "bybit";
-            okx: "okx";
-            lighter: "lighter";
-        }>;
-        status: z.ZodEnum<{
-            CANCELLED: "CANCELLED";
-            IDLE: "IDLE";
-            ACTIVE: "ACTIVE";
-            COMPLETED: "COMPLETED";
-            FAILED: "FAILED";
-        }>;
-        error: z.ZodOptional<z.ZodString>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            id: z.ZodUUID;
-            connector: z.ZodEnum<{
-                hyperliquid: "hyperliquid";
-                binance: "binance";
-                bybit: "bybit";
-                okx: "okx";
-                lighter: "lighter";
-            }>;
-            status: z.ZodEnum<{
-                PENDING: "PENDING";
-                PARTIAL: "PARTIAL";
-                FILLED: "FILLED";
-                CANCELLED: "CANCELLED";
-                REJECTED: "REJECTED";
-            }>;
-            error: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodString;
-            updatedAt: z.ZodString;
-            type: z.ZodLiteral<"MARKET">;
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            reduceOnly: z.ZodBoolean;
-            quantity: z.ZodString;
-            price: z.ZodString;
-            filledQuantity: z.ZodString;
-            filledPrice: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>], "type">>>;
-        intent: z.ZodLiteral<"OPEN">;
-        orderType: z.ZodLiteral<"MARKET">;
-        legs: z.ZodTuple<[z.ZodObject<{
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            mode: z.ZodEnum<{
-                QUANTITY: "QUANTITY";
-                USD: "USD";
-            }>;
-            amount: z.ZodString;
-            reduceOnly: z.ZodBoolean;
-        }, z.core.$strip>], z.ZodObject<{
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            mode: z.ZodEnum<{
-                QUANTITY: "QUANTITY";
-                USD: "USD";
-            }>;
-            amount: z.ZodString;
-            reduceOnly: z.ZodBoolean;
-        }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
-        id: z.ZodUUID;
-        connector: z.ZodEnum<{
-            hyperliquid: "hyperliquid";
-            binance: "binance";
-            bybit: "bybit";
-            okx: "okx";
-            lighter: "lighter";
-        }>;
-        status: z.ZodEnum<{
-            CANCELLED: "CANCELLED";
-            IDLE: "IDLE";
-            ACTIVE: "ACTIVE";
-            COMPLETED: "COMPLETED";
-            FAILED: "FAILED";
-        }>;
-        error: z.ZodOptional<z.ZodString>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            id: z.ZodUUID;
-            connector: z.ZodEnum<{
-                hyperliquid: "hyperliquid";
-                binance: "binance";
-                bybit: "bybit";
-                okx: "okx";
-                lighter: "lighter";
-            }>;
-            status: z.ZodEnum<{
-                PENDING: "PENDING";
-                PARTIAL: "PARTIAL";
-                FILLED: "FILLED";
-                CANCELLED: "CANCELLED";
-                REJECTED: "REJECTED";
-            }>;
-            error: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodString;
-            updatedAt: z.ZodString;
-            type: z.ZodLiteral<"MARKET">;
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            reduceOnly: z.ZodBoolean;
-            quantity: z.ZodString;
-            price: z.ZodString;
-            filledQuantity: z.ZodString;
-            filledPrice: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>], "type">>>;
-        intent: z.ZodLiteral<"ADJUST">;
-        orderType: z.ZodLiteral<"MARKET">;
-        position: z.ZodObject<{
-            id: z.ZodUUID;
-            exposure: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
-        }, z.core.$strip>;
-        legs: z.ZodTuple<[z.ZodObject<{
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            mode: z.ZodEnum<{
-                QUANTITY: "QUANTITY";
-                USD: "USD";
-            }>;
-            amount: z.ZodString;
-            reduceOnly: z.ZodBoolean;
-        }, z.core.$strip>], z.ZodObject<{
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            mode: z.ZodEnum<{
-                QUANTITY: "QUANTITY";
-                USD: "USD";
-            }>;
-            amount: z.ZodString;
-            reduceOnly: z.ZodBoolean;
-        }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
-        id: z.ZodUUID;
-        connector: z.ZodEnum<{
-            hyperliquid: "hyperliquid";
-            binance: "binance";
-            bybit: "bybit";
-            okx: "okx";
-            lighter: "lighter";
-        }>;
-        status: z.ZodEnum<{
-            CANCELLED: "CANCELLED";
-            IDLE: "IDLE";
-            ACTIVE: "ACTIVE";
-            COMPLETED: "COMPLETED";
-            FAILED: "FAILED";
-        }>;
-        error: z.ZodOptional<z.ZodString>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            id: z.ZodUUID;
-            connector: z.ZodEnum<{
-                hyperliquid: "hyperliquid";
-                binance: "binance";
-                bybit: "bybit";
-                okx: "okx";
-                lighter: "lighter";
-            }>;
-            status: z.ZodEnum<{
-                PENDING: "PENDING";
-                PARTIAL: "PARTIAL";
-                FILLED: "FILLED";
-                CANCELLED: "CANCELLED";
-                REJECTED: "REJECTED";
-            }>;
-            error: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodString;
-            updatedAt: z.ZodString;
-            type: z.ZodLiteral<"MARKET">;
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            reduceOnly: z.ZodBoolean;
-            quantity: z.ZodString;
-            price: z.ZodString;
-            filledQuantity: z.ZodString;
-            filledPrice: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>], "type">>>;
-        intent: z.ZodLiteral<"CLOSE">;
-        orderType: z.ZodLiteral<"MARKET">;
-        position: z.ZodObject<{
-            id: z.ZodUUID;
-            exposure: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
-        }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-        id: z.ZodUUID;
-        connector: z.ZodEnum<{
-            hyperliquid: "hyperliquid";
-            binance: "binance";
-            bybit: "bybit";
-            okx: "okx";
-            lighter: "lighter";
-        }>;
-        status: z.ZodEnum<{
-            CANCELLED: "CANCELLED";
-            IDLE: "IDLE";
-            ACTIVE: "ACTIVE";
-            COMPLETED: "COMPLETED";
-            FAILED: "FAILED";
-        }>;
-        error: z.ZodOptional<z.ZodString>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-        orders: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            id: z.ZodUUID;
-            connector: z.ZodEnum<{
-                hyperliquid: "hyperliquid";
-                binance: "binance";
-                bybit: "bybit";
-                okx: "okx";
-                lighter: "lighter";
-            }>;
-            status: z.ZodEnum<{
-                PENDING: "PENDING";
-                PARTIAL: "PARTIAL";
-                FILLED: "FILLED";
-                CANCELLED: "CANCELLED";
-                REJECTED: "REJECTED";
-            }>;
-            error: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodString;
-            updatedAt: z.ZodString;
-            type: z.ZodLiteral<"MARKET">;
-            symbol: z.ZodString;
-            side: z.ZodEnum<{
-                BUY: "BUY";
-                SELL: "SELL";
-            }>;
-            reduceOnly: z.ZodBoolean;
-            quantity: z.ZodString;
-            price: z.ZodString;
-            filledQuantity: z.ZodString;
-            filledPrice: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>], "type">>>;
-        intent: z.ZodLiteral<"REVERSE">;
-        orderType: z.ZodLiteral<"MARKET">;
-        position: z.ZodObject<{
-            id: z.ZodUUID;
-            exposure: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
-        }, z.core.$strip>;
-    }, z.core.$strip>], "intent">], "orderType">>;
-}, z.core.$strip>;
+export declare const CreateTradeCloseAllResponse: z.ZodObject<{}, z.core.$strip>;
 export type CreateTradeCloseAllResponse = z.output<typeof CreateTradeCloseAllResponse>;

package/dist/trade/responses.js

@@ -5,6 +5,6 @@ const CreateTradeOpenResponse = z.object({ execution: Execution });
 const CreateTradeAdjustResponse = z.object({ execution: Execution });
 const CreateTradeCloseResponse = z.object({ execution: Execution });
 const CreateTradeReverseResponse = z.object({ execution: Execution });
-const CreateTradeCloseAllResponse = z.object({ executions: z.array(Execution) });
+const CreateTradeCloseAllResponse = z.object({});
 
 export { CreateTradeAdjustResponse, CreateTradeCloseAllResponse, CreateTradeCloseResponse, CreateTradeOpenResponse, CreateTradeReverseResponse };

package/dist/users/entities.d.ts

@@ -15,3 +15,9 @@ 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<{
+    address: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    referredAt: z.ZodOptional<z.ZodNumber>;
+    tradeCount: z.ZodNumber;
+}, z.core.$strip>;
+export type ReferralReferee = z.infer<typeof ReferralReferee>;

package/dist/users/entities.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { EthereumAddress } from '../common/address';
 
 const UserPreferences = z.object({
   slippageToleranceBps: z.int().describe("User slippage preference in basis points")
@@ -11,5 +12,10 @@ const UserProfile = z.object({
   email: z.string().nullable().describe("Linked email address (for email provider)"),
   emailVerified: z.boolean().describe("Whether the email is verified")
 }).describe("User profile of the authenticated user");
+const ReferralReferee = z.object({
+  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"),
+  tradeCount: z.number().int().nonnegative().describe("Distinct Pear executions with at least one real confirmed fill")
+});
 
-export { UserPreferences, UserProfile };
+export { ReferralReferee, UserPreferences, UserProfile };

package/dist/users/index.d.ts

@@ -1,3 +1,4 @@
 export * from './entities';
 export * from './payloads';
+export * from './queries';
 export * from './response';

package/dist/users/index.js

@@ -1,3 +1,4 @@
 export * from './entities';
 export * from './payloads';
+export * from './queries';
 export * from './response';

package/dist/users/queries.d.ts

@@ -0,0 +1,8 @@
+/** Query contracts for authenticated referral history. */
+import { z } from 'zod';
+export declare const ReferralRefereeListParams: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<number>>>;
+}, z.core.$strip>;
+export type ReferralRefereeListParamsInput = z.input<typeof ReferralRefereeListParams>;
+export type ReferralRefereeListParams = z.output<typeof ReferralRefereeListParams>;

package/dist/users/queries.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { CursorFindParams } from '../common/request';
+
+const ReferralRefereeListParams = CursorFindParams.extend({
+  limit: z.coerce.number().int().positive().max(100).optional().default(20)
+});
+
+export { ReferralRefereeListParams };

package/dist/users/response.d.ts

@@ -28,6 +28,17 @@ export declare const UpdateUserDisplayNameResponse: z.ZodObject<{
 export type UpdateUserDisplayNameResponse = z.infer<typeof UpdateUserDisplayNameResponse>;
 export declare const ReferralStatusResponse: z.ZodObject<{
     ownedCodes: z.ZodArray<z.ZodString>;
-    referrerUserId: z.ZodOptional<z.ZodUUID>;
+    referrerCode: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ReferralStatusResponse = z.infer<typeof ReferralStatusResponse>;
+export declare const ReferralRefereeListResponse: z.ZodObject<{
+    limit: z.ZodNumber;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    count: z.ZodNumber;
+    referees: z.ZodArray<z.ZodObject<{
+        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>;
+export type ReferralRefereeListResponse = z.infer<typeof ReferralRefereeListResponse>;

package/dist/users/response.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { UserPreferences, UserProfile } from './entities';
+import { CursorResponse } from '../common/response';
+import { UserPreferences, UserProfile, ReferralReferee } from './entities';
 
 const ProfileResponse = z.object({
   profile: UserProfile,
@@ -13,7 +14,11 @@ const UpdateUserDisplayNameResponse = z.object({
 });
 const ReferralStatusResponse = z.object({
   ownedCodes: z.array(z.string()).describe("Exact case-sensitive referral codes owned by the authenticated user"),
-  referrerUserId: z.uuid().optional().describe("User that permanently referred the authenticated user")
+  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"),
+  referees: z.array(ReferralReferee)
 });
 
-export { ProfileResponse, ReferralStatusResponse, UpdateUserDisplayNameResponse, UpdateUserPreferencesResponse };
+export { ProfileResponse, ReferralRefereeListResponse, ReferralStatusResponse, UpdateUserDisplayNameResponse, UpdateUserPreferencesResponse };

package/package.json

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