@0xmonaco/types 1.0.67 → 1.0.69

package/dist/buildercodes/index.d.ts

@@ -18,9 +18,9 @@ import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, Ge
 export interface BuildercodesAPI extends BaseAPI {
     /** Read this authenticated frontend's enrollment, payout address, and live budget. */
     getConfig(): Promise<GetBuildercodesConfigResponse>;
-    /** List this authenticated frontend's per-trade BuilderCodes credits. */
+    /** List this authenticated frontend's per-trade BuilderCodes credits, optionally of one payout `kind`. */
     listPayouts(params?: ListBuildercodePayoutsParams): Promise<ListBuildercodePayoutsResponse>;
-    /** Summarize this authenticated frontend's BuilderCodes credits by token. */
+    /** Summarize this authenticated frontend's BuilderCodes credits by token, and by token and payout kind. */
     getPayoutSummary(): Promise<GetBuildercodePayoutSummaryResponse>;
     /** Read the authenticated wallet's available reserved reward balances. */
     getRewardsBalance(): Promise<GetBuildercodeRewardsBalanceResponse>;
@@ -67,5 +67,5 @@ export interface BuildercodesAPI extends BaseAPI {
      */
     claimBuildercodeRewards(params: ClaimBuildercodeRewardsParams): Promise<ClaimBuildercodeRewardsResponse>;
 }
-export type { BuildercodePayout, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, } from "./responses";
-export { BuildercodePayoutSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export type { BuildercodePayout, BuildercodePayoutKind, BuildercodePayoutTokenKindTotal, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";

package/dist/buildercodes/index.js

@@ -4,4 +4,4 @@
  * Types for the BuilderCodes API: reading and claiming an enrolled frontend's
  * per-trade revenue share.
  */
-export { BuildercodePayoutSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";

package/dist/buildercodes/responses.d.ts

@@ -13,10 +13,23 @@ export declare const GetBuildercodesConfigResponseSchema: z.ZodObject<{
     buildercodesEnabled: z.ZodBoolean;
     buildercodesBudgetBps: z.ZodNumber;
 }, z.core.$strip>;
-/** Pagination accepted by the per-trade payout history endpoint. */
+/**
+ * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` is the
+ * frontend's share of Monaco's fee; `BUILDER_FEE` is the frontend's own builder
+ * fee, paid by the taker. Both land in the same claimable balance.
+ */
+export declare const BuildercodePayoutKindSchema: z.ZodEnum<{
+    REVENUE_SHARE: "REVENUE_SHARE";
+    BUILDER_FEE: "BUILDER_FEE";
+}>;
+/** Pagination and filter accepted by the per-trade payout history endpoint. */
 export declare const ListBuildercodePayoutsParamsSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodNumber>;
     pageSize: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>>;
 }, z.core.$strip>;
 /** One per-trade BuilderCodes credit. Amounts are RAW atomic units. */
 export declare const BuildercodePayoutSchema: z.ZodObject<{
@@ -26,6 +39,10 @@ export declare const BuildercodePayoutSchema: z.ZodObject<{
     amount: z.ZodString;
     appliedBps: z.ZodNumber;
     createdAt: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>>;
 }, z.core.$strip>;
 /** Schema for the paginated per-trade payout history. */
 export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
@@ -36,6 +53,10 @@ export declare const ListBuildercodePayoutsResponseSchema: z.ZodObject<{
         amount: z.ZodString;
         appliedBps: z.ZodNumber;
         createdAt: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<{
+            REVENUE_SHARE: "REVENUE_SHARE";
+            BUILDER_FEE: "BUILDER_FEE";
+        }>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
     page: z.ZodNumber;
@@ -49,6 +70,17 @@ export declare const BuildercodePayoutTokenTotalSchema: z.ZodObject<{
     payoutCount: z.ZodNumber;
     lastCreditedAt: z.ZodString;
 }, z.core.$strip>;
+/** One token-denominated BuilderCodes earnings total for one payout kind. */
+export declare const BuildercodePayoutTokenKindTotalSchema: z.ZodObject<{
+    token: z.ZodString;
+    kind: z.ZodEnum<{
+        REVENUE_SHARE: "REVENUE_SHARE";
+        BUILDER_FEE: "BUILDER_FEE";
+    }>;
+    totalAmount: z.ZodString;
+    payoutCount: z.ZodNumber;
+    lastCreditedAt: z.ZodString;
+}, z.core.$strip>;
 /** Schema for this frontend's payout summary. */
 export declare const GetBuildercodePayoutSummaryResponseSchema: z.ZodObject<{
     totalPayouts: z.ZodNumber;
@@ -59,6 +91,16 @@ export declare const GetBuildercodePayoutSummaryResponseSchema: z.ZodObject<{
         payoutCount: z.ZodNumber;
         lastCreditedAt: z.ZodString;
     }, z.core.$strip>>;
+    byTokenAndKind: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        token: z.ZodString;
+        kind: z.ZodEnum<{
+            REVENUE_SHARE: "REVENUE_SHARE";
+            BUILDER_FEE: "BUILDER_FEE";
+        }>;
+        totalAmount: z.ZodString;
+        payoutCount: z.ZodNumber;
+        lastCreditedAt: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 /** One available balance in the reserved BuilderCodes reward bucket. */
 export declare const BuildercodeRewardsBalanceSchema: z.ZodObject<{
@@ -86,9 +128,11 @@ export type ClaimBuildercodeRewardsParams = z.infer<typeof ClaimBuildercodeRewar
 export type ClaimBuildercodeRewardsResponse = z.infer<typeof ClaimBuildercodeRewardsResponseSchema>;
 export type GetBuildercodesConfigResponse = z.infer<typeof GetBuildercodesConfigResponseSchema>;
 export type ListBuildercodePayoutsParams = z.infer<typeof ListBuildercodePayoutsParamsSchema>;
+export type BuildercodePayoutKind = z.infer<typeof BuildercodePayoutKindSchema>;
 export type BuildercodePayout = z.infer<typeof BuildercodePayoutSchema>;
 export type ListBuildercodePayoutsResponse = z.infer<typeof ListBuildercodePayoutsResponseSchema>;
 export type BuildercodePayoutTokenTotal = z.infer<typeof BuildercodePayoutTokenTotalSchema>;
+export type BuildercodePayoutTokenKindTotal = z.infer<typeof BuildercodePayoutTokenKindTotalSchema>;
 export type GetBuildercodePayoutSummaryResponse = z.infer<typeof GetBuildercodePayoutSummaryResponseSchema>;
 export type BuildercodeRewardsBalance = z.infer<typeof BuildercodeRewardsBalanceSchema>;
 export type GetBuildercodeRewardsBalanceResponse = z.infer<typeof GetBuildercodeRewardsBalanceResponseSchema>;

package/dist/buildercodes/responses.js

@@ -17,10 +17,18 @@ export const GetBuildercodesConfigResponseSchema = z.object({
     buildercodesEnabled: z.boolean(),
     buildercodesBudgetBps: z.number().int().min(0).max(10_000),
 });
-/** Pagination accepted by the per-trade payout history endpoint. */
+/**
+ * The payout stream a BuilderCodes credit belongs to. `REVENUE_SHARE` is the
+ * frontend's share of Monaco's fee; `BUILDER_FEE` is the frontend's own builder
+ * fee, paid by the taker. Both land in the same claimable balance.
+ */
+export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE"]);
+/** Pagination and filter accepted by the per-trade payout history endpoint. */
 export const ListBuildercodePayoutsParamsSchema = z.object({
     page: z.number().int().min(1).max(10_000).optional(),
     pageSize: z.number().int().min(1).max(100).optional(),
+    /** Only return credits of this kind; `total` counts the filtered rows. Omit for every kind. */
+    kind: BuildercodePayoutKindSchema.optional(),
 });
 /** One per-trade BuilderCodes credit. Amounts are RAW atomic units. */
 export const BuildercodePayoutSchema = z.object({
@@ -30,6 +38,8 @@ export const BuildercodePayoutSchema = z.object({
     amount: z.string(),
     appliedBps: z.number().int(),
     createdAt: z.string(),
+    /** Payout stream of this credit. Absent from servers older than this field, whose credits are all `REVENUE_SHARE`. */
+    kind: BuildercodePayoutKindSchema.optional(),
 });
 /** Schema for the paginated per-trade payout history. */
 export const ListBuildercodePayoutsResponseSchema = z.object({
@@ -46,11 +56,25 @@ export const BuildercodePayoutTokenTotalSchema = z.object({
     payoutCount: z.number().int().nonnegative(),
     lastCreditedAt: z.string(),
 });
+/** One token-denominated BuilderCodes earnings total for one payout kind. */
+export const BuildercodePayoutTokenKindTotalSchema = z.object({
+    token: z.string(),
+    kind: BuildercodePayoutKindSchema,
+    totalAmount: z.string(),
+    payoutCount: z.number().int().nonnegative(),
+    lastCreditedAt: z.string(),
+});
 /** Schema for this frontend's payout summary. */
 export const GetBuildercodePayoutSummaryResponseSchema = z.object({
     totalPayouts: z.number().int().nonnegative(),
     lastCreditedAt: z.string().nullable().optional(),
+    /** Per-token totals, summed across every payout kind. */
     byToken: z.array(BuildercodePayoutTokenTotalSchema),
+    /**
+     * The same totals split by token AND kind; a token's rows sum to its
+     * `byToken` total. Absent from servers older than this field.
+     */
+    byTokenAndKind: z.array(BuildercodePayoutTokenKindTotalSchema).optional(),
 });
 /** One available balance in the reserved BuilderCodes reward bucket. */
 export const BuildercodeRewardsBalanceSchema = z.object({

package/dist/faucet/index.d.ts

@@ -117,8 +117,9 @@ export interface FaucetAPI extends BaseAPI {
      * Fetches the authenticated wallet's faucet quota and recent requests.
      *
      * Read-only: remaining requests in the rolling 24h window, when the next
-     * request becomes available, and the 5 most recent requests. Wallet-scoped
-     * across apps, matching mint enforcement.
+     * request becomes available, and the 5 most recent requests. Scoped to the
+     * wallet on this app (each app has its own quota), matching mint
+     * enforcement.
      *
      * @returns Promise resolving to the quota and recent-request history
      */

package/dist/positions/index.d.ts

@@ -66,11 +66,16 @@ export interface Position {
     /**
      * Lifetime realized PnL net of trading fees and funding. Terminal rows
      * only; absent when the position's reducing executions are unavailable.
+     * Deducts whole-life `cumFees` once. Also absent until its final close is
+     * recorded in the PnL sample and fee history is complete; poll again while
+     * pending. With no sample, remains absent for 28 days after close, then
+     * falls back to closing-execution net without unavailable opening fees.
      */
     netRealizedPnl?: string;
     /**
      * Lifetime realized return on the total allocated initial margin, as a
-     * percentage. Terminal rows only; absent when unavailable.
+     * percentage. Terminal rows only; absent when unavailable, including under
+     * the same conditions as `netRealizedPnl`.
      */
     realizedRoe?: string;
     /**
@@ -101,7 +106,8 @@ export interface Position {
      * terminal rows alike. Null when the opening-fill fees are unavailable —
      * before the position's first PnL sample flushes, after its samples age out
      * of PnL retention, or for positions predating the PnL service — rather than
-     * an understated partial.
+     * an understated partial. On a terminal row it is also null until the
+     * final close is recorded in its PnL sample, or while fee data is incomplete.
      */
     cumFees?: string;
     /**

package/dist/profile/index.d.ts

@@ -235,8 +235,21 @@ export interface UserTrade {
     quoteVolume: string;
     /** Side of the trade */
     side: OrderSide;
-    /** Fee paid for this trade (as string to preserve precision) */
+    /**
+     * Total fee paid for this trade (as string to preserve precision). For a
+     * taker this is Monaco's taker fee plus the frontend's builder fee; for a
+     * maker it is the maker fee (negative for a rebate). Equals
+     * `monacoFee + builderFee`.
+     */
     fee: string;
+    /** Monaco's component of `fee`. Absent from servers older than this field. */
+    monacoFee?: string;
+    /**
+     * The frontend's builder fee component of `fee`. Always `"0"` for a maker:
+     * builder fees are charged to takers only. Absent from servers older than
+     * this field.
+     */
+    builderFee?: string;
     /** Timestamp when the trade was executed (ISO string) */
     executedAt: string;
 }

package/dist/sdk/index.d.ts

@@ -120,7 +120,7 @@ export interface MonacoSDK {
     /** Deposit-address registration (sweeper) API; requires a session */
     sweeper: SweeperAPI;
     managedMarkets: ManagedMarketsAPI;
-    /** Public whitelist (waitlist) submission API */
+    /** @deprecated Public whitelist applications are closed; submissions return HTTP 403. */
     whitelist: WhitelistAPI;
     /** Profile operations API */
     profile: ProfileAPI;

package/dist/trading/orders.d.ts

@@ -125,6 +125,12 @@ export interface Order {
      * close means unknown, not "placed by hand". Wire: `conditionalOrderId`.
      */
     conditionalOrderId?: string;
+    /**
+     * Present only on a TWAP child order: the TWAP parent that placed it. The
+     * same id the `orders` WebSocket frames and snapshot rows carry for the
+     * child. Wire: `parentOrderId`.
+     */
+    parentOrderId?: string;
     /**
      * Opaque, compare-only revision counter for this order's state: a strictly
      * higher value is strictly newer state for that order, and equal values

package/dist/trading/responses.d.ts

@@ -609,18 +609,14 @@ export interface ConditionalOrder {
      * the sequencer step that wrote it (0XM-2440). A strictly higher value is
      * strictly newer state for that conditional order.
      *
-     * Present on REST reads and on the subscribe-time `conditional_orders`
-     * snapshot frame. **Absent on live conditional events**, by design: those are
-     * emitted from a model captured before the sequencer acted, so the only value
-     * available there is the one the row held *before* the change being
-     * announced — a client merging on `>=` would let a snapshot read at that
-     * version win the tie and undo the transition.
-     *
-     * So seed conditional state from the snapshot and REST, comparing with
-     * `snapshot.version >= local.version`, and apply live events as state without
-     * ranking them. `>=` rather than `>`: one sequencer step can write several
+     * Present on REST reads, on live `conditionalOrders` updates and on the
+     * subscribe-time snapshot frame, always the version of the row described.
+     * When both sides carry one, merge with `incoming.version >= local.version`:
+     * `>=` rather than `>`, because one sequencer step can write several
      * conditional rows (a trigger writes the triggered row and cancels its OCO
-     * sibling), so equal means "same step", not identical state.
+     * sibling), so equal means "same step", not identical state. Never compare
+     * an absent version numerically: a versioned row supersedes an unversioned
+     * one, and two unversioned rows compare on `updatedAt`.
      *
      * Absent means unknown — a row last written before the field existed — never
      * zero. Wire: `version`.

package/dist/websocket/events/conditional-order-events.d.ts

@@ -8,12 +8,32 @@ import type { ConditionalOrderConditionType, ConditionalOrderState, ConditionalO
  * alias is documentation and a narrowing aid only. Match on it with a default
  * branch; see `ConditionalOrderEventData.reason`.
  *
+ * Every transition of a conditional order sends exactly one update:
+ *
+ * - `created`: the order was placed (`ACTIVE`, or `PENDING_PARENT` while it
+ *   waits on an entry order).
+ * - `activated`: a `PENDING_PARENT` order went `ACTIVE` when its entry order
+ *   filled as a resting maker.
+ * - `triggered`: the trigger fired and placed its close; `state` is
+ *   `TRIGGERED` and `triggeredOrderId` / `triggeredAt` name that close.
+ * - `oco_cancelled`: cancelled because its linked sibling triggered.
+ * - `parent_cancelled`: a `PENDING_PARENT` order cancelled because its entry
+ *   order was cancelled, expired, replaced away or swept.
+ * - `position_closed`: cancelled because its position closed.
+ * - `cancelled`: any other cancel — a user cancel, a new full-close order
+ *   superseding it, or a trailing stop refused because its position already
+ *   has one (`failureReason` says so).
+ * - `reparented`: a `PENDING_PARENT` order moved onto the entry order's
+ *   replacement; `parentOrderId` names the replacement, `state` is unchanged.
+ * - `failed`: the trigger fired but its close could not be placed.
+ * - `expired`: the trigger found its position no longer open.
+ *
  * A `TRAILING_STOP` row adds two: `armed` when tracking begins (its
  * `activationPrice` was reached, or immediately when none was set) and
  * `ratcheted` on every move of its trigger, carrying the new `triggerPrice`
  * and the `watermarkPrice` it was derived from (0XM-2827).
  */
-export type ConditionalOrderEventReason = "created" | "activated" | "cancelled" | "parent_cancelled" | "triggered" | "failed" | "oco_cancelled" | "armed" | "ratcheted";
+export type ConditionalOrderEventReason = "created" | "activated" | "cancelled" | "parent_cancelled" | "position_closed" | "reparented" | "triggered" | "failed" | "expired" | "oco_cancelled" | "armed" | "ratcheted";
 /**
  * A conditional (TP/SL) order's current state.
  *
@@ -81,6 +101,10 @@ export interface ConditionalOrderEventData {
      */
     timeInForce?: TimeInForce | (string & {});
     state: ConditionalOrderState | (string & {});
+    /**
+     * The close order the trigger placed. Set from the `triggered` update on,
+     * together with `triggeredAt`. Wire: `triggered_order_id`.
+     */
     triggeredOrderId?: string;
     triggeredAt?: string;
     activatedAt?: string;
@@ -130,21 +154,17 @@ export interface ConditionalOrderEventData {
      * the sequencer step that wrote it (0XM-2440). A strictly higher value is
      * strictly newer state for that conditional order.
      *
-     * Present on REST reads and on the subscribe-time `conditional_orders`
-     * snapshot frame. **Absent on live conditional events**, by design: those are
-     * emitted from a model captured before the sequencer acted, so the only value
-     * available there is the one the row held *before* the change being
-     * announced — a client merging on `>=` would let a snapshot read at that
-     * version win the tie and undo the transition.
-     *
-     * So seed conditional state from the snapshot and REST, comparing with
-     * `snapshot.version >= local.version`, and apply live events as state without
-     * ranking them. `>=` rather than `>`: one sequencer step can write several
-     * conditional rows (a trigger writes the triggered row and cancels its OCO
-     * sibling), so equal means "same step", not identical state.
+     * Present on live updates, on the subscribe-time `conditional_orders`
+     * snapshot frame and on REST reads, always the version of the row the
+     * update describes. When both sides carry one, merge with `incoming.version
+     * >= local.version`: `>=` rather than `>`, because one step can write several
+     * conditional rows at one version (a trigger writes the triggered row and
+     * cancels its OCO sibling), so equal means "same step", not identical state.
      *
      * Absent means unknown — a row last written before the field existed — never
-     * zero. Wire: `version`.
+     * zero, so never compare it numerically (`42 >= undefined` is false). A
+     * versioned row supersedes an unversioned one; between two unversioned rows,
+     * compare `updatedAt`. Wire: `version`.
      */
     version?: number;
 }

package/dist/websocket/events/orders-events.d.ts

@@ -150,6 +150,17 @@ export interface CommonOrderEventData {
      * Wire: `self_trade_prevention_mode`.
      */
     selfTradePreventionMode?: SelfTradePreventionMode | (string & {});
+    /**
+     * The TWAP parent of a child order: the same id REST `getOrder` returns as
+     * `parentOrderId`, so a subscriber can group a TWAP's children from the
+     * socket alone. Carried on every frame of a TWAP child: its `OrderPlaced`
+     * acknowledgement, taker fills and remainder cancels, maker fills,
+     * cancellation and expiry frames, and its `orders` snapshot row. Omitted
+     * for an order that is not a TWAP child, and by servers predating the
+     * field.
+     * Wire: `parent_order_id`.
+     */
+    parentOrderId?: string;
 }
 /**
  * OrderPlaced event - emitted when a new order is placed
@@ -197,10 +208,11 @@ export interface OrderMatchedEvent extends OrderEvent {
         /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
         remainingQuantityRaw: string;
         /**
-         * Monaco fee for the fills this event covers, in normalized decimal QUOTE
-         * units (negative = maker rebate). Excludes the application taker fee, so
-         * it is smaller than the order echo's `totalTakerFees` for an application
-         * that charges one, and equal to it for one that does not. Wire: `fee`.
+         * Total fee for the fills this event covers, in normalized decimal QUOTE
+         * units (negative = maker rebate): `monacoFee + builderFee`. For a taker
+         * this is Monaco's taker fee plus the frontend's builder fee, the same
+         * total as the order echo's `totalTakerFees`; for a maker it is the maker
+         * fee. Wire: `fee`.
          */
         fee: string;
         /**
@@ -210,6 +222,22 @@ export interface OrderMatchedEvent extends OrderEvent {
          * 10^quoteDecimals, and `BigInt(feeRaw)` is safe. Wire: `fee_raw`.
          */
         feeRaw: string;
+        /**
+         * Monaco's component of `fee`, in normalized decimal QUOTE units. Optional
+         * because a server older than this field omits it. Wire: `monaco_fee`.
+         */
+        monacoFee?: string;
+        /** `monacoFee` in RAW quote-unit precision. Wire: `monaco_fee_raw`. */
+        monacoFeeRaw?: string;
+        /**
+         * The frontend's builder fee component of `fee`, in normalized decimal
+         * QUOTE units. Always `"0"` for a maker: builder fees are charged to
+         * takers only. Optional because a server older than this field omits it.
+         * Wire: `builder_fee`.
+         */
+        builderFee?: string;
+        /** `builderFee` in RAW quote-unit precision. Wire: `builder_fee_raw`. */
+        builderFeeRaw?: string;
         /** Execution timestamp of the first trade this event covers (ISO 8601). `null` when it covers none. */
         executedAt: string | null;
         /** Reference price used for slippage calculation. `null` when unset. */
@@ -289,14 +317,16 @@ export interface OrderPartiallyFilledEvent extends OrderEvent {
         /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
         remainingQuantityRaw?: string;
         /**
-         * Monaco fee for the fills this event covers, in normalized decimal QUOTE
-         * units (negative = maker rebate). The wire field is `fee`, not `makerFee`;
-         * taker and maker carry the same field. A taker event aggregates every
-         * trade it covers; a maker event is one trade.
+         * Total fee for the fills this event covers, in normalized decimal QUOTE
+         * units (negative = maker rebate): `monacoFee + builderFee`. The wire
+         * field is `fee`, not `makerFee`; taker and maker carry the same field. A
+         * taker event aggregates every trade it covers; a maker event is one
+         * trade.
          *
-         * Excludes the application taker fee, so it is NOT the order echo's
-         * `totalTakerFees` (which is `fee + applicationTakerFee`). It previously
-         * held the raw integer value now exposed as `feeRaw`.
+         * For a taker this is Monaco's taker fee plus the frontend's builder fee,
+         * the same total as the order echo's `totalTakerFees`; for a maker it is
+         * the maker fee. It previously held the raw integer value now exposed as
+         * `feeRaw`, and before that Monaco's fee alone.
          */
         fee?: string;
         /**
@@ -306,6 +336,18 @@ export interface OrderPartiallyFilledEvent extends OrderEvent {
          * 10^quoteDecimals, and `BigInt(feeRaw)` is safe. Wire: `fee_raw`.
          */
         feeRaw?: string;
+        /** Monaco's component of `fee`, in normalized decimal QUOTE units. Wire: `monaco_fee`. */
+        monacoFee?: string;
+        /** `monacoFee` in RAW quote-unit precision. Wire: `monaco_fee_raw`. */
+        monacoFeeRaw?: string;
+        /**
+         * The frontend's builder fee component of `fee`, in normalized decimal
+         * QUOTE units. Always `"0"` for a maker: builder fees are charged to
+         * takers only. Wire: `builder_fee`.
+         */
+        builderFee?: string;
+        /** `builderFee` in RAW quote-unit precision. Wire: `builder_fee_raw`. */
+        builderFeeRaw?: string;
         /** Trade execution timestamp (maker orders only) */
         executedAt?: string;
         /** Role of the order in the trade (taker or maker) */
@@ -369,14 +411,16 @@ export interface OrderFilledEvent extends OrderEvent {
         /** `remainingQuantity` in RAW (integer, base-unit) precision. Wire: `remaining_quantity_raw`. */
         remainingQuantityRaw?: string;
         /**
-         * Monaco fee for the fills this event covers, in normalized decimal QUOTE
-         * units (negative = maker rebate). The wire field is `fee`, not `makerFee`;
-         * taker and maker carry the same field. A taker event aggregates every
-         * trade it covers; a maker event is one trade.
+         * Total fee for the fills this event covers, in normalized decimal QUOTE
+         * units (negative = maker rebate): `monacoFee + builderFee`. The wire
+         * field is `fee`, not `makerFee`; taker and maker carry the same field. A
+         * taker event aggregates every trade it covers; a maker event is one
+         * trade.
          *
-         * Excludes the application taker fee, so it is NOT the order echo's
-         * `totalTakerFees` (which is `fee + applicationTakerFee`). It previously
-         * held the raw integer value now exposed as `feeRaw`.
+         * For a taker this is Monaco's taker fee plus the frontend's builder fee,
+         * the same total as the order echo's `totalTakerFees`; for a maker it is
+         * the maker fee. It previously held the raw integer value now exposed as
+         * `feeRaw`, and before that Monaco's fee alone.
          */
         fee?: string;
         /**
@@ -386,6 +430,18 @@ export interface OrderFilledEvent extends OrderEvent {
          * 10^quoteDecimals, and `BigInt(feeRaw)` is safe. Wire: `fee_raw`.
          */
         feeRaw?: string;
+        /** Monaco's component of `fee`, in normalized decimal QUOTE units. Wire: `monaco_fee`. */
+        monacoFee?: string;
+        /** `monacoFee` in RAW quote-unit precision. Wire: `monaco_fee_raw`. */
+        monacoFeeRaw?: string;
+        /**
+         * The frontend's builder fee component of `fee`, in normalized decimal
+         * QUOTE units. Always `"0"` for a maker: builder fees are charged to
+         * takers only. Wire: `builder_fee`.
+         */
+        builderFee?: string;
+        /** `builderFee` in RAW quote-unit precision. Wire: `builder_fee_raw`. */
+        builderFeeRaw?: string;
         /** Trade execution timestamp (maker orders only) */
         executedAt?: string;
         /** Role of the order in the trade (taker or maker) */

package/dist/websocket/snapshots.d.ts

@@ -53,7 +53,8 @@ export type SnapshotHandler<T> = (items: T[]) => void;
  * The change-only fill metadata of an order EVENT is deliberately absent: a
  * snapshot describes resting state, not a fill, so there is no `eventType`,
  * `tradeId`, `executionPrice`, `lastFillQuantity`, `role`, `fee`, `feeRaw`,
- * `tradesCount` or slippage. The cumulative `filledQuantity` /
+ * `monacoFee`, `builderFee` (and their `Raw` twins), `tradesCount` or
+ * slippage. The cumulative `filledQuantity` /
  * `averageFillPrice` totals are present, because those are state.
  *
  * Nullability mirrors the wire exactly. Every optional field below is a Rust
@@ -130,6 +131,12 @@ export interface OrderSnapshotItem {
      * never the resolved wallet or platform default.
      */
     selfTradePreventionMode?: SelfTradePreventionMode | (string & {});
+    /**
+     * The TWAP parent of a child order: the same id REST `getOrder` returns as
+     * `parentOrderId`. Omitted — not `null` — for an order that is not a TWAP
+     * child, matching the live event payload. Wire: `parent_order_id`.
+     */
+    parentOrderId?: string;
     /**
      * Sequencer step this order's state was last written by — the SAME counter
      * the live order events and the REST endpoints carry (0XM-2440).

package/dist/whitelist/index.d.ts

@@ -1,12 +1,6 @@
 /**
- * Whitelist Types
- *
- * Types for the public whitelist (waitlist) application endpoint. Wire shapes
- * are snake_case.
- *
- * NOTE: This endpoint is **public (unauthenticated)** and creates an inactive
- * user pending manual approval — it is an onboarding/waitlist submission, not a
- * trading operation.
+ * Compatibility types for the retired public whitelist endpoint.
+ * Submissions return HTTP 403 FORBIDDEN without changing applicant data.
  */
 import type { BaseAPI } from "../api";
 /** Body for a whitelist application. */
@@ -20,7 +14,7 @@ export interface SubmitWhitelistRequest {
     /** Applicant Telegram username (5-32 chars) */
     telegramUsername?: string;
 }
-/** Response to a whitelist application. */
+/** Legacy success response, retained for compatibility; retired submissions return HTTP 403. */
 export interface SubmitWhitelistResponse {
     /** Human-readable status message */
     message: string;
@@ -32,13 +26,8 @@ export interface SubmitWhitelistResponse {
  */
 export interface WhitelistAPI extends BaseAPI {
     /**
-     * Submits a whitelist (waitlist) application.
-     *
-     * Public/unauthenticated. The server validates and de-duplicates by wallet
-     * address and email, creating an inactive user pending approval.
-     *
-     * @param body - Applicant details
-     * @returns Promise resolving to the status message and created user id
+     * @deprecated Public whitelist applications are closed. The server returns HTTP 403.
+     * @param body - Legacy applicant details; the request shape is retained for compatibility.
      */
     submit(body: SubmitWhitelistRequest): Promise<SubmitWhitelistResponse>;
 }

package/dist/whitelist/index.js

@@ -1,10 +1,4 @@
 /**
- * Whitelist Types
- *
- * Types for the public whitelist (waitlist) application endpoint. Wire shapes
- * are snake_case.
- *
- * NOTE: This endpoint is **public (unauthenticated)** and creates an inactive
- * user pending manual approval — it is an onboarding/waitlist submission, not a
- * trading operation.
+ * Compatibility types for the retired public whitelist endpoint.
+ * Submissions return HTTP 403 FORBIDDEN without changing applicant data.
  */

package/dist/wire/schema.d.ts

@@ -998,9 +998,9 @@ export interface paths {
          *
          *      Returns the authenticated wallet's remaining faucet requests in the
          *      rolling 24h window, when the next request becomes available, and the
-         *      5 most recent faucet requests. Quota is wallet-scoped: it aggregates
-         *      across all user rows sharing the wallet address, matching mint
-         *      enforcement.
+         *      5 most recent faucet requests. Quota is per wallet and app: the same
+         *      wallet has its own quota on each app, and only the calling app's
+         *      requests are counted and listed, matching mint enforcement.
          */
         get: operations["get_faucet_info"];
         put?: never;
@@ -1025,7 +1025,8 @@ export interface paths {
          * @description Mint all testnet tokens.
          *
          *      Mint all available testnet tokens to the authenticated user's address.
-         *      Rate limited per 24 hours. The request is synchronous: it returns 200
+         *      Rate limited per 24 hours, per wallet and app: the same wallet has its
+         *      own quota on each app. The request is synchronous: it returns 200
          *      only once every faucet transaction is confirmed on-chain.
          */
         post: operations["mint_tokens"];
@@ -2576,11 +2577,13 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Submit whitelist application
-         * @description Submit whitelist application.
+         * Whitelist applications closed
+         * @deprecated
+         * @description Public whitelist applications are closed.
          *
-         *      Submit a whitelist application to join Monaco Protocol. The user will be
-         *      created with is_active = false and will need to be approved by an admin.
+         *      Retained for client compatibility. Every decoded submission is rejected with
+         *      HTTP 403 Forbidden / gRPC PERMISSION_DENIED and no applicant data is changed.
+         *      Existing applications and administrative approvals remain available.
          */
         post: operations["submit_whitelist"];
         delete?: never;
@@ -3406,6 +3409,40 @@ export interface components {
              * @description RFC 3339 credit timestamp.
              */
             createdAt?: string | null;
+            /**
+             * @description Payout stream this credit belongs to: `REVENUE_SHARE` (the frontend's share of Monaco's fee) or `BUILDER_FEE` (the frontend's own builder fee, paid by the taker). Both land in the same claimable balance.
+             * @example REVENUE_SHARE
+             * @enum {string|null}
+             */
+            kind?: "REVENUE_SHARE" | "BUILDER_FEE" | null;
+        };
+        BuildercodePayoutTokenKindTotal: {
+            /**
+             * @description Credit token contract address.
+             * @example 0x0000000000000000000000000000000000000002
+             */
+            token?: string | null;
+            /**
+             * @description Payout stream these totals cover: `REVENUE_SHARE` or `BUILDER_FEE`.
+             * @example REVENUE_SHARE
+             * @enum {string|null}
+             */
+            kind?: "REVENUE_SHARE" | "BUILDER_FEE" | null;
+            /**
+             * @description Summed credits of this kind in RAW atomic units of this token.
+             * @example 5000000
+             */
+            totalAmount?: string | null;
+            /**
+             * Format: int64
+             * @description Number of credits of this kind included in this total.
+             */
+            payoutCount?: number | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 timestamp of the newest credit of this kind in this token.
+             */
+            lastCreditedAt?: string | null;
         };
         BuildercodePayoutTokenTotal: {
             /**
@@ -3691,7 +3728,7 @@ export interface components {
             activatedAt?: string | null;
             /**
              * Format: int64
-             * @description Opaque, compare-only revision counter for this conditional order's state: the sequencer step that wrote it. A strictly higher value is strictly newer state for that conditional order. The SAME counter is carried on the `conditional_orders` WebSocket SNAPSHOT frame — but deliberately NOT on the live `conditional_orders` events, which build from the row as it stood before the sequencer acted and so could only report the version the row held BEFORE the change they announce. So seed conditional state from the snapshot frame and REST, reconciling on `(conditionalOrderId, version)` — take the REST row when `snapshot.version >= local.version`, else keep local state — and apply the live events as state without ranking them. Note `>=`, not `>`: equal versions mean the SAME STEP rather than identical state, because one step can write several conditional rows (a trigger writes the triggered row and cancels its OCO sibling under one step). A REST row is that step's FINAL state, so it wins a tie. One consequence to plan for: the snapshot is read from the database, which lags the matching engine, so a transition that fires during the read is in neither the snapshot nor the delivered stream and cannot be ranked — re-read the affected rows if a conditional order's state matters at reconnect. Do not read anything else into the number: it is drawn from the same global sequence plain orders use, so values are sparse, gaps are normal, and it is not comparable across different conditional orders — nor against a plain order's version. Absent means unknown: a row last written before this field existed. Fall back to a full field comparison for those rather than treating absent as version zero.
+             * @description Opaque, compare-only revision counter for this conditional order's state: the sequencer step that wrote it. A strictly higher value is strictly newer state for that conditional order. The SAME counter is carried on every live `conditional_orders` WebSocket event and on the subscribe-time snapshot frame, always the version of the row the frame describes. Reconcile all three on `(conditionalOrderId, version)`: take the incoming row when `incoming.version >= local.version`, else keep local state. Note `>=`, not `>`: equal versions mean the SAME STEP rather than identical state, because one step can write several conditional rows (a trigger writes the triggered row and cancels its OCO sibling under one step). A REST row is that step's FINAL state, so it wins a tie. One consequence to plan for: the snapshot is read from the database, which lags the matching engine, so a transition that fires during the read is in neither the snapshot nor the delivered stream and cannot be ranked — re-read the affected rows if a conditional order's state matters at reconnect. Do not read anything else into the number: it is drawn from the same global sequence plain orders use, so values are sparse, gaps are normal, and it is not comparable across different conditional orders — nor against a plain order's version. Absent means unknown: a row last written before this field existed. Fall back to a full field comparison for those rather than treating absent as version zero.
              * @example 918342
              */
             version?: number | null;
@@ -4521,8 +4558,10 @@ export interface components {
              * @description RFC 3339 timestamp of the newest credit, or null when none exists.
              */
             lastCreditedAt?: string | null;
-            /** @description Per-token earnings totals. Empty when this application has no payouts. */
+            /** @description Per-token earnings totals, summed across every payout kind. Empty when this application has no payouts. */
             byToken?: components["schemas"]["BuildercodePayoutTokenTotal"][] | null;
+            /** @description The same totals split by token AND payout kind. One row per (token, kind) pair with at least one credit; a token's rows sum to its `byToken` total. Empty when this application has no payouts. */
+            byTokenAndKind?: components["schemas"]["BuildercodePayoutTokenKindTotal"][] | null;
         };
         GetBuildercodeRewardsBalanceResponse: {
             /** @description One entry per reward token with a non-zero available balance. */
@@ -5541,6 +5580,11 @@ export interface components {
             /**
              * @description Lifetime realized PnL net of trading fees and funding. Terminal rows
              *      only; absent when the position's reducing executions are unavailable.
+             *      Deducts whole-life `cum_fees` once. Also absent after close until the
+             *      final close is recorded in the PnL sample and the fee history is complete.
+             *      A position with no PnL sample stays absent for 28 days after close while
+             *      its sample may be pending. Beyond that it serves the closing-execution
+             *      net, without opening fees that are no longer available.
              */
             netRealizedPnl?: string | null;
             /**
@@ -5550,7 +5594,8 @@ export interface components {
              *      costs rather than posted collateral, and funding is signed, so folding it
              *      into the denominator could drive it to zero or negative. Terminal rows
              *      only; absent when unavailable, including when the position's reducing
-             *      executions do not account for its whole lifetime.
+             *      executions do not account for its whole lifetime, and under the same
+             *      conditions as `net_realized_pnl`.
              */
             realizedRoe?: string | null;
             /**
@@ -5583,7 +5628,8 @@ export interface components {
              *      Null when the opening-fill fees are unavailable — before the position's
              *      first PnL sample flushes, after its samples age out of PnL retention, or
              *      for positions predating the PnL service — rather than an understated
-             *      partial.
+             *      partial. On a terminal row it is also null until the final close is
+             *      recorded in the position's PnL sample, or while fee data is incomplete.
              */
             cumFees?: string | null;
             /**
@@ -7219,6 +7265,11 @@ export interface components {
             /**
              * @description Lifetime realized PnL net of trading fees and funding. Terminal rows
              *      only; absent when the position's reducing executions are unavailable.
+             *      Deducts whole-life `cum_fees` once. Also absent after close until the
+             *      final close is recorded in the PnL sample and the fee history is complete.
+             *      A position with no PnL sample stays absent for 28 days after close while
+             *      its sample may be pending. Beyond that it serves the closing-execution
+             *      net, without opening fees that are no longer available.
              */
             netRealizedPnl?: string | null;
             /**
@@ -7228,7 +7279,8 @@ export interface components {
              *      costs rather than posted collateral, and funding is signed, so folding it
              *      into the denominator could drive it to zero or negative. Terminal rows
              *      only; absent when unavailable, including when the position's reducing
-             *      executions do not account for its whole lifetime.
+             *      executions do not account for its whole lifetime, and under the same
+             *      conditions as `net_realized_pnl`.
              */
             realizedRoe?: string | null;
             /**
@@ -7261,7 +7313,8 @@ export interface components {
              *      Null when the opening-fill fees are unavailable — before the position's
              *      first PnL sample flushes, after its samples age out of PnL retention, or
              *      for positions predating the PnL service — rather than an understated
-             *      partial.
+             *      partial. On a terminal row it is also null until the final close is
+             *      recorded in the position's PnL sample, or while fee data is incomplete.
              */
             cumFees?: string | null;
             /**
@@ -8346,13 +8399,13 @@ export interface components {
         };
         SubmitWhitelistResponse: {
             /**
-             * @description Human-readable status message
+             * @description Legacy success message; submissions now return HTTP 403 / gRPC PERMISSION_DENIED
              * @example Your whitelist application has been submitted successfully! We'll review it and get back to you soon.
              */
             message?: string | null;
             /**
              * Format: uuid
-             * @description Created user UUID (pending approval)
+             * @description Legacy created user UUID; retired submissions do not create users
              * @example 123e4567-e89b-12d3-a456-426614174000
              */
             userId?: string | null;
@@ -9169,9 +9222,21 @@ export interface components {
             price?: string | null;
             quantity?: string | null;
             liquidityRole?: string | null;
+            /**
+             * @description Total fee this user paid on the trade, in raw quote units: for a taker,
+             *      Monaco's taker fee plus the frontend's builder fee; for a maker, the maker
+             *      fee (negative for a rebate). Equals `monaco_fee + builder_fee`.
+             */
             fee?: string | null;
             realizedPnl?: string | null;
             timestamp?: string | null;
+            /** @description Monaco's component of `fee`, in raw quote units. */
+            monacoFee?: string | null;
+            /**
+             * @description The frontend's builder fee component of `fee`, in raw quote units. Always
+             *      "0" for a maker: builder fees are charged to takers only.
+             */
+            builderFee?: string | null;
         };
         VerifyRequest: {
             /**
@@ -10997,6 +11062,8 @@ export interface operations {
                 page?: number;
                 /** @description Items per page (max 100) */
                 pageSize?: number;
+                /** @description Only return BuilderCodes payouts of this payout kind: REVENUE_SHARE (the frontend's share of Monaco's fee) or BUILDER_FEE (the frontend's own builder fee). Omit for every kind. */
+                kind?: "REVENUE_SHARE" | "BUILDER_FEE";
             };
             header?: never;
             path?: never;
@@ -14724,8 +14791,8 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Wallet address or email already registered */
-            409: {
+            /** @description Public whitelist applications are closed. No applicant data is changed. */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.67",
+	"version": "1.0.69",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.67",
+		"@0xmonaco/contracts": "1.0.69",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {