@pear-protocol/types 2.5.0 → 2.7.0

package/dist/portfolio/responses.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 export declare const PortfolioResponse: z.ZodObject<{
+    hasProvisionalFills: z.ZodBoolean;
     realizedCashflow: z.ZodObject<{
         grossPnl: z.ZodNumber;
         tradeFees: z.ZodNumber;
@@ -120,6 +121,7 @@ export declare const PortfolioAnalyticsResponse: z.ZodObject<{
         startDate: z.ZodString;
         endDate: z.ZodString;
     }, z.core.$strip>;
+    hasProvisionalFills: z.ZodBoolean;
     realizedCashflow: z.ZodObject<{
         grossPnl: z.ZodNumber;
         tradeFees: z.ZodNumber;

package/dist/portfolio/responses.js

@@ -2,6 +2,8 @@ import { z } from 'zod';
 import { PortfolioOpenSnapshot, PortfolioClosedPositionStats, PortfolioVolumeAmounts, PortfolioVolumeIntervals, PortfolioCashflowAmounts, PortfolioCashflowIntervals, PortfolioAnalyticsConfig, PortfolioVolumeSeriesPoint, PortfolioPairBreakdown, PortfolioCashflowSeriesPoint } from './entities';
 
 const PortfolioResponse = z.object({
+  /** Historical accounting or the current open snapshot still uses provisional fills. */
+  hasProvisionalFills: z.boolean(),
   realizedCashflow: PortfolioCashflowAmounts.extend({
     fundingSynced: z.boolean(),
     intervals: PortfolioCashflowIntervals.optional()
@@ -14,6 +16,8 @@ const PortfolioResponse = z.object({
 });
 const PortfolioAnalyticsResponse = z.object({
   config: PortfolioAnalyticsConfig,
+  /** Historical accounting or the current open snapshot still uses provisional fills. */
+  hasProvisionalFills: z.boolean(),
   realizedCashflow: PortfolioCashflowAmounts.extend({
     fundingSynced: z.boolean(),
     series: z.array(PortfolioCashflowSeriesPoint).optional()

package/dist/position/entities.d.ts

@@ -259,6 +259,7 @@ export declare const ClosedPosition: z.ZodObject<{
     exitNotional: z.ZodString;
     exitNotionalComplete: z.ZodBoolean;
     hasSyntheticFills: z.ZodBoolean;
+    hasProvisionalFills: z.ZodBoolean;
     unstableHistoricalData: z.ZodBoolean;
     longAssets: z.ZodArray<z.ZodString>;
     shortAssets: z.ZodArray<z.ZodString>;
@@ -570,6 +571,7 @@ export declare const VaultClosedPosition: z.ZodObject<{
     netPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
     positionId: z.ZodUUID;
     openedAt: z.ZodString;
+    hasProvisionalFills: z.ZodBoolean;
     legs: z.ZodArray<z.ZodObject<{
         side: z.ZodEnum<{
             LONG: "LONG";

package/dist/position/entities.js

@@ -220,6 +220,8 @@ const ClosedPosition = z.object({
   exitNotionalComplete: z.boolean(),
   /** Whether any fill on the position was a synthetic bridge fill (gap/gone reconstruction). */
   hasSyntheticFills: z.boolean(),
+  /** Whether any fill is still PROVISIONAL, so fees and net PnL may still settle. */
+  hasProvisionalFills: z.boolean(),
   /** Whether a backfilled fill made this position's historical metrics unreliable. */
   unstableHistoricalData: z.boolean(),
   longAssets: z.array(InstrumentId),
@@ -406,7 +408,8 @@ const VaultClosedPosition = ClosedPosition.pick({
   closedAt: true,
   closedReason: true,
   grossPnl: true,
-  netPnl: true
+  netPnl: true,
+  hasProvisionalFills: true
 }).extend({
   legs: z.array(VaultClosedPositionLeg)
 });

package/dist/position/responses.d.ts

@@ -126,6 +126,7 @@ export declare const ClosedPositionListResponse: z.ZodObject<{
         exitNotional: z.ZodString;
         exitNotionalComplete: z.ZodBoolean;
         hasSyntheticFills: z.ZodBoolean;
+        hasProvisionalFills: z.ZodBoolean;
         unstableHistoricalData: z.ZodBoolean;
         longAssets: z.ZodArray<z.ZodString>;
         shortAssets: z.ZodArray<z.ZodString>;
@@ -371,6 +372,7 @@ export declare const VaultClosedPositionListResponse: z.ZodObject<{
         netPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
         positionId: z.ZodUUID;
         openedAt: z.ZodString;
+        hasProvisionalFills: z.ZodBoolean;
         legs: z.ZodArray<z.ZodObject<{
             side: z.ZodEnum<{
                 LONG: "LONG";

package/dist/trade/payloads.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+export declare const BOUNDED_MARKET_MAX_TTL_MS = 10000;
 export declare const CreateMarketOpen: z.ZodObject<{
     type: z.ZodLiteral<"MARKET">;
     legs: z.ZodTuple<[z.ZodObject<{
@@ -100,6 +101,39 @@ export declare const CreateMarketOpen: z.ZodObject<{
     }, z.core.$strip>]>>;
     clientId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** Explicit price protection: legacy gateways reject this request type instead of stripping limits. */
+export declare const CreateBoundedMarketOpen: z.ZodObject<{
+    type: z.ZodLiteral<"BOUNDED_MARKET">;
+    expiresAt: z.ZodNumber;
+    legs: z.ZodTuple<[z.ZodObject<{
+        symbol: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        side: z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>;
+        mode: z.ZodEnum<{
+            QUANTITY: "QUANTITY";
+            USD: "USD";
+        }>;
+        amount: z.ZodString;
+        limitPrice: z.ZodString;
+    }, z.core.$strip>], z.ZodObject<{
+        symbol: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        side: z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>;
+        mode: z.ZodEnum<{
+            QUANTITY: "QUANTITY";
+            USD: "USD";
+        }>;
+        amount: z.ZodString;
+        limitPrice: z.ZodString;
+    }, z.core.$strip>>;
+    clientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const CreateMarketAdjust: z.ZodObject<{
     type: z.ZodLiteral<"MARKET">;
     legs: z.ZodTuple<[z.ZodObject<{
@@ -243,6 +277,37 @@ export declare const CreateTradeOpen: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>]>>;
     clientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"BOUNDED_MARKET">;
+    expiresAt: z.ZodNumber;
+    legs: z.ZodTuple<[z.ZodObject<{
+        symbol: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        side: z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>;
+        mode: z.ZodEnum<{
+            QUANTITY: "QUANTITY";
+            USD: "USD";
+        }>;
+        amount: z.ZodString;
+        limitPrice: z.ZodString;
+    }, z.core.$strip>], z.ZodObject<{
+        symbol: z.ZodString;
+        id: z.ZodOptional<z.ZodString>;
+        side: z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>;
+        mode: z.ZodEnum<{
+            QUANTITY: "QUANTITY";
+            USD: "USD";
+        }>;
+        amount: z.ZodString;
+        limitPrice: z.ZodString;
+    }, z.core.$strip>>;
+    clientId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 export declare const CreateTradeAdjust: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"MARKET">;
@@ -288,6 +353,7 @@ export declare const CreateTradeCloseAll: z.ZodDiscriminatedUnion<[z.ZodObject<{
     clientId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 export type CreateMarketOpen = z.output<typeof CreateMarketOpen>;
+export type CreateBoundedMarketOpen = z.output<typeof CreateBoundedMarketOpen>;
 export type CreateMarketAdjust = z.output<typeof CreateMarketAdjust>;
 export type CreateMarketClose = z.output<typeof CreateMarketClose>;
 export type CreateMarketReverse = z.output<typeof CreateMarketReverse>;

package/dist/trade/payloads.js

@@ -1,9 +1,14 @@
 import { z } from 'zod';
 import { ClientIdCode } from '../common/client-id';
 import { RefineMinimumOneSymbol, RefineUniqueSymbols } from '../common/refinement';
+import { UnsignedDecimalString } from '../common/schema';
 import { TradeLegPostOnly, TradeLeg } from '../common/trade-legs';
 import { AttachTriggerMarketClose } from '../trigger';
 
+const BOUNDED_MARKET_MAX_TTL_MS = 1e4;
+const BoundedTradeLeg = TradeLegPostOnly.safeExtend({
+  limitPrice: UnsignedDecimalString.refine((value) => Number.isFinite(Number(value)) && Number(value) > 0)
+});
 const CreateMarketOpen = z.object({
   type: z.literal("MARKET"),
   /**
@@ -21,6 +26,14 @@ const CreateMarketOpen = z.object({
   */
   clientId: ClientIdCode
 });
+const CreateBoundedMarketOpen = z.object({
+  type: z.literal("BOUNDED_MARKET"),
+  expiresAt: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+  legs: z.tuple([
+    BoundedTradeLeg
+  ]).rest(BoundedTradeLeg).superRefine(RefineMinimumOneSymbol).superRefine(RefineUniqueSymbols),
+  clientId: ClientIdCode
+});
 const CreateMarketAdjust = z.object({
   type: z.literal("MARKET"),
   /**
@@ -56,7 +69,8 @@ const CreateMarketCloseAll = z.object({
   clientId: ClientIdCode
 });
 const CreateTradeOpen = z.discriminatedUnion("type", [
-  CreateMarketOpen
+  CreateMarketOpen,
+  CreateBoundedMarketOpen
 ]);
 const CreateTradeAdjust = z.discriminatedUnion("type", [
   CreateMarketAdjust
@@ -71,4 +85,4 @@ const CreateTradeCloseAll = z.discriminatedUnion("type", [
   CreateMarketCloseAll
 ]);
 
-export { CreateMarketAdjust, CreateMarketClose, CreateMarketCloseAll, CreateMarketOpen, CreateMarketReverse, CreateTradeAdjust, CreateTradeClose, CreateTradeCloseAll, CreateTradeOpen, CreateTradeReverse };
+export { BOUNDED_MARKET_MAX_TTL_MS, CreateBoundedMarketOpen, CreateMarketAdjust, CreateMarketClose, CreateMarketCloseAll, CreateMarketOpen, CreateMarketReverse, CreateTradeAdjust, CreateTradeClose, CreateTradeCloseAll, CreateTradeOpen, CreateTradeReverse };

package/dist/trade/responses.d.ts

@@ -1,4 +1,13 @@
 import { z } from 'zod';
+/** An authenticated admission capability; old workers also reject the new persisted discriminant. */
+export declare const TradeCapabilities: z.ZodObject<{
+    boundedMarketOpen: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        maxTtlMs: z.ZodLiteral<10000>;
+        connectors: z.ZodArray<z.ZodLiteral<"hyperliquid">>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type TradeCapabilities = z.output<typeof TradeCapabilities>;
 export declare const CreateTradeOpenResponse: z.ZodObject<{
     execution: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodUUID;

package/dist/trade/responses.js

@@ -2,7 +2,15 @@ import { z } from 'zod';
 import { CursorResponse } from '../common';
 import { Execution } from '../execution/entities';
 import { TradeGroup } from './entities';
+import { BOUNDED_MARKET_MAX_TTL_MS } from './payloads';
 
+const TradeCapabilities = z.object({
+  boundedMarketOpen: z.object({
+    version: z.literal(1),
+    maxTtlMs: z.literal(BOUNDED_MARKET_MAX_TTL_MS),
+    connectors: z.array(z.literal("hyperliquid"))
+  })
+});
 const CreateTradeOpenResponse = z.object({
   execution: Execution
 });
@@ -22,4 +30,4 @@ const TradeListResponse = CursorResponse.extend({
   groups: z.array(TradeGroup)
 });
 
-export { CreateTradeAdjustResponse, CreateTradeCloseAllResponse, CreateTradeCloseResponse, CreateTradeOpenResponse, CreateTradeReverseResponse, TradeListResponse };
+export { CreateTradeAdjustResponse, CreateTradeCloseAllResponse, CreateTradeCloseResponse, CreateTradeOpenResponse, CreateTradeReverseResponse, TradeCapabilities, TradeListResponse };

package/package.json

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