@0xmonaco/types 1.0.72 → 1.0.73

package/dist/buildercodes/index.d.ts

@@ -5,7 +5,7 @@
  * per-trade revenue share.
  */
 import type { BaseAPI } from "../api";
-import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse } from "./responses";
+import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, ListBuilderFeeChangesParams, ListBuilderFeeChangesResponse, SetBuilderFeeParams, SetBuilderFeeResponse } from "./responses";
 /**
  * BuilderCodes payout API interface.
  *
@@ -18,6 +18,10 @@ import type { ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, Ge
 export interface BuildercodesAPI extends BaseAPI {
     /** Read this authenticated frontend's enrollment, payout address, and live budget. */
     getConfig(): Promise<GetBuildercodesConfigResponse>;
+    /** Set this frontend's stored builder fee in basis points. */
+    setBuilderFee(params: SetBuilderFeeParams): Promise<SetBuilderFeeResponse>;
+    /** List this frontend's builder-fee audit log, newest first. */
+    listBuilderFeeChanges(params?: ListBuilderFeeChangesParams): Promise<ListBuilderFeeChangesResponse>;
     /** 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, and by token and payout kind. */
@@ -67,5 +71,5 @@ export interface BuildercodesAPI extends BaseAPI {
      */
     claimBuildercodeRewards(params: ClaimBuildercodeRewardsParams): Promise<ClaimBuildercodeRewardsResponse>;
 }
-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";
+export type { BuildercodePayout, BuildercodePayoutKind, BuildercodePayoutTokenKindTotal, BuildercodePayoutTokenTotal, BuildercodeRewardsBalance, BuilderFeeActorType, BuilderFeeChange, ClaimBuildercodeRewardsParams, ClaimBuildercodeRewardsResponse, GetBuildercodePayoutSummaryResponse, GetBuildercodeRewardsBalanceResponse, GetBuildercodesConfigResponse, ListBuildercodePayoutsParams, ListBuildercodePayoutsResponse, ListBuilderFeeChangesParams, ListBuilderFeeChangesResponse, SetBuilderFeeParams, SetBuilderFeeResponse, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, BuilderFeeActorTypeSchema, BuilderFeeChangeSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, ListBuilderFeeChangesParamsSchema, ListBuilderFeeChangesResponseSchema, SetBuilderFeeParamsSchema, SetBuilderFeeResponseSchema, } 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 { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, } from "./responses";
+export { BuildercodePayoutKindSchema, BuildercodePayoutSchema, BuildercodePayoutTokenKindTotalSchema, BuildercodePayoutTokenTotalSchema, BuildercodeRewardsBalanceSchema, BuilderFeeActorTypeSchema, BuilderFeeChangeSchema, ClaimBuildercodeRewardsParamsSchema, ClaimBuildercodeRewardsResponseSchema, GetBuildercodePayoutSummaryResponseSchema, GetBuildercodeRewardsBalanceResponseSchema, GetBuildercodesConfigResponseSchema, ListBuildercodePayoutsParamsSchema, ListBuildercodePayoutsResponseSchema, ListBuilderFeeChangesParamsSchema, ListBuilderFeeChangesResponseSchema, SetBuilderFeeParamsSchema, SetBuilderFeeResponseSchema, } from "./responses";

package/dist/buildercodes/responses.d.ts

@@ -12,11 +12,62 @@ export declare const GetBuildercodesConfigResponseSchema: z.ZodObject<{
     payoutAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     buildercodesEnabled: z.ZodBoolean;
     buildercodesBudgetBps: z.ZodNumber;
+    builderFeeEnabled: z.ZodBoolean;
+    builderFeeBps: z.ZodNumber;
+    builderFeeCapBps: z.ZodNumber;
+    changesRemaining: z.ZodNumber;
+    nextChangeAllowedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** Schema for changing this frontend's builder fee. */
+export declare const SetBuilderFeeParamsSchema: z.ZodObject<{
+    bps: z.ZodNumber;
+}, z.core.$strip>;
+/** Schema returned after setting this frontend's builder fee. */
+export declare const SetBuilderFeeResponseSchema: z.ZodObject<{
+    builderFeeBps: z.ZodNumber;
+    previousBuilderFeeBps: z.ZodNumber;
+    changesRemaining: z.ZodNumber;
+    nextChangeAllowedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** Builder-fee change actor exposed by the audit log. */
+export declare const BuilderFeeActorTypeSchema: z.ZodEnum<{
+    BUILDER: "BUILDER";
+    ADMIN: "ADMIN";
+}>;
+/** One builder-fee audit-log entry. */
+export declare const BuilderFeeChangeSchema: z.ZodObject<{
+    actorType: z.ZodEnum<{
+        BUILDER: "BUILDER";
+        ADMIN: "ADMIN";
+    }>;
+    actor: z.ZodString;
+    oldBps: z.ZodNumber;
+    newBps: z.ZodNumber;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/** Cursor pagination accepted by the builder-fee change log. */
+export declare const ListBuilderFeeChangesParamsSchema: z.ZodObject<{
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Schema for one page of builder-fee changes, newest first. */
+export declare const ListBuilderFeeChangesResponseSchema: z.ZodObject<{
+    changes: z.ZodArray<z.ZodObject<{
+        actorType: z.ZodEnum<{
+            BUILDER: "BUILDER";
+            ADMIN: "ADMIN";
+        }>;
+        actor: z.ZodString;
+        oldBps: z.ZodNumber;
+        newBps: z.ZodNumber;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextPageToken: z.ZodString;
 }, z.core.$strip>;
 /**
  * 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.
+ * active frontend-revenue-share category; `BUILDER_FEE` is reserved and is not
+ * currently emitted.
  */
 export declare const BuildercodePayoutKindSchema: z.ZodEnum<{
     REVENUE_SHARE: "REVENUE_SHARE";
@@ -127,6 +178,12 @@ export declare const ClaimBuildercodeRewardsResponseSchema: z.ZodObject<{
 export type ClaimBuildercodeRewardsParams = z.infer<typeof ClaimBuildercodeRewardsParamsSchema>;
 export type ClaimBuildercodeRewardsResponse = z.infer<typeof ClaimBuildercodeRewardsResponseSchema>;
 export type GetBuildercodesConfigResponse = z.infer<typeof GetBuildercodesConfigResponseSchema>;
+export type SetBuilderFeeParams = z.infer<typeof SetBuilderFeeParamsSchema>;
+export type SetBuilderFeeResponse = z.infer<typeof SetBuilderFeeResponseSchema>;
+export type BuilderFeeActorType = z.infer<typeof BuilderFeeActorTypeSchema>;
+export type BuilderFeeChange = z.infer<typeof BuilderFeeChangeSchema>;
+export type ListBuilderFeeChangesParams = z.infer<typeof ListBuilderFeeChangesParamsSchema>;
+export type ListBuilderFeeChangesResponse = z.infer<typeof ListBuilderFeeChangesResponseSchema>;
 export type ListBuildercodePayoutsParams = z.infer<typeof ListBuildercodePayoutsParamsSchema>;
 export type BuildercodePayoutKind = z.infer<typeof BuildercodePayoutKindSchema>;
 export type BuildercodePayout = z.infer<typeof BuildercodePayoutSchema>;

package/dist/buildercodes/responses.js

@@ -16,11 +16,47 @@ export const GetBuildercodesConfigResponseSchema = z.object({
     payoutAddress: z.string().nullable().optional(),
     buildercodesEnabled: z.boolean(),
     buildercodesBudgetBps: z.number().int().min(0).max(10_000),
+    builderFeeEnabled: z.boolean(),
+    builderFeeBps: z.number().int().min(0).max(100),
+    builderFeeCapBps: z.number().int().min(0).max(100),
+    changesRemaining: z.number().int().min(0).max(2),
+    nextChangeAllowedAt: z.string().nullable().optional(),
+});
+/** Schema for changing this frontend's builder fee. */
+export const SetBuilderFeeParamsSchema = z.object({
+    bps: z.number().int().min(0).max(100),
+});
+/** Schema returned after setting this frontend's builder fee. */
+export const SetBuilderFeeResponseSchema = z.object({
+    builderFeeBps: z.number().int().min(0).max(100),
+    previousBuilderFeeBps: z.number().int().min(0).max(100),
+    changesRemaining: z.number().int().min(0).max(2),
+    nextChangeAllowedAt: z.string().nullable().optional(),
+});
+/** Builder-fee change actor exposed by the audit log. */
+export const BuilderFeeActorTypeSchema = z.enum(["BUILDER", "ADMIN"]);
+/** One builder-fee audit-log entry. */
+export const BuilderFeeChangeSchema = z.object({
+    actorType: BuilderFeeActorTypeSchema,
+    actor: z.string(),
+    oldBps: z.number().int().min(0).max(100),
+    newBps: z.number().int().min(0).max(100),
+    createdAt: z.string(),
+});
+/** Cursor pagination accepted by the builder-fee change log. */
+export const ListBuilderFeeChangesParamsSchema = z.object({
+    pageSize: z.number().int().min(1).max(100).optional(),
+    pageToken: z.string().optional(),
+});
+/** Schema for one page of builder-fee changes, newest first. */
+export const ListBuilderFeeChangesResponseSchema = z.object({
+    changes: z.array(BuilderFeeChangeSchema),
+    nextPageToken: z.string(),
 });
 /**
  * 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.
+ * active frontend-revenue-share category; `BUILDER_FEE` is reserved and is not
+ * currently emitted.
  */
 export const BuildercodePayoutKindSchema = z.enum(["REVENUE_SHARE", "BUILDER_FEE"]);
 /** Pagination and filter accepted by the per-trade payout history endpoint. */

package/dist/trading/responses.d.ts

@@ -159,7 +159,7 @@ export interface ReplaceOrderResponse {
     status: "SUCCESS" | "FAILED";
     /** Operation message */
     message: string;
-    /** Fields that were updated */
+    /** The replacement's price and total quantity (see {@link UpdatedFields}) */
     updatedFields: UpdatedFields;
     /** Original order identifier that was replaced */
     originalOrderId?: string;
@@ -167,12 +167,19 @@ export interface ReplaceOrderResponse {
     matchResult?: MatchResult;
 }
 /**
- * Fields that were updated in the replace operation
+ * The replacement's price and quantity, as the replace operation placed them
  */
 export interface UpdatedFields {
-    /** Updated price (if changed) */
+    /** The replacement's price: the requested price, or the original order's when omitted */
     price?: string;
-    /** Updated quantity (if changed) */
+    /**
+     * The replacement's TOTAL quantity, not its resting size: the requested
+     * quantity, or the original order's total when omitted. A 100-lot with 60
+     * filled reports "100" and rests 40; read the order's `remainingQuantity`
+     * for the resting size. For a margin reduce-only replacement it is the close
+     * size placed (the requested quantity, or the original's remaining quantity
+     * when omitted).
+     */
     quantity?: string;
 }
 /**
@@ -336,7 +343,7 @@ export interface BatchReplaceResult {
     originalOrderId: string;
     /** New order identifier (if successful) */
     newOrderId?: string;
-    /** Fields that were updated (if successful) */
+    /** The replacement's price and total quantity, if successful (see {@link UpdatedFields}) */
     updatedFields?: UpdatedFields;
     /** Match result information if the new order was processed */
     matchResult?: MatchResult;
@@ -435,7 +442,12 @@ export interface BatchReplaceOrderParams {
     orderId: string;
     /** New order price (optional) */
     price?: string;
-    /** New order quantity (optional) */
+    /**
+     * New TOTAL order quantity (optional): the replacement rests this total
+     * minus the already-filled amount, so it must exceed the filled amount.
+     * Omitted, the order keeps its total. A margin reduce-only quantity is a
+     * close size, placed as given.
+     */
     quantity?: string;
     /** For sub-accounts: use master's balance (optional) */
     useMasterBalance?: boolean;

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_follow_position_margin", "attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_all_copy_positions", "close_follow_positions", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_follow_position_margin", "attach_position_tp_sl", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "cancel_twap_order", "check_trader_code_availability", "claim_buildercode_rewards", "claim_managed_market_lease", "clear_trader_code", "close_all_copy_positions", "close_follow_positions", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "create_twap_order", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_buildercode_payout_summary", "get_buildercode_rewards_balance", "get_buildercodes_config", "get_candles", "get_conditional_order", "get_faucet_info", "get_follow", "get_funding_state", "get_index_price", "get_lead_trader", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_my_lead_trader", "get_my_referral_downline", "get_my_referral_position", "get_my_trader_code", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_pulse", "get_rewards_balance", "get_screener", "get_self_trade_prevention_default", "get_sub_account_limits", "get_sweeper_chains", "get_trade_by_id", "get_trader_code_info", "get_trades", "get_trading_pair_by_id", "get_twap_order", "get_twap_order_tca", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_all_funding_history", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_builder_fee_changes", "list_buildercode_payouts", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_follow_leader_positions", "list_funding_history", "list_funding_payments", "list_lead_trader_closed_trades", "list_lead_trader_open_positions", "list_lead_traders", "list_managed_market_assignments", "list_margin_accounts", "list_my_followers", "list_my_follows", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "list_twap_orders", "mint_tokens", "preview_follow", "refresh_managed_market_quotes", "refresh_session", "register_deposit_address", "replace_order", "revoke_delegated_agent", "revoke_session", "set_builder_fee", "set_self_trade_prevention_default", "set_trader_code", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "stop_follow", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "upsert_follow", "upsert_lead_trader", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -101,6 +101,7 @@ export const OPERATION_IDS = [
     "list_application_movements",
     "list_application_orders",
     "list_application_users",
+    "list_builder_fee_changes",
     "list_buildercode_payouts",
     "list_conditional_orders",
     "list_delegated_agent_owners",
@@ -129,6 +130,7 @@ export const OPERATION_IDS = [
     "replace_order",
     "revoke_delegated_agent",
     "revoke_session",
+    "set_builder_fee",
     "set_self_trade_prevention_default",
     "set_trader_code",
     "simulate_fees",

package/dist/wire/schema.d.ts

@@ -706,6 +706,74 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/buildercodes/builder-fee": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Set your builder fee
+         * @description Set this application's builder fee.
+         *
+         *      The builder fee is an additional taker fee, in basis points, that this
+         *      frontend charges its own users on top of Monaco's fee. The application is
+         *      taken from the authenticated session; the caller must be the application's
+         *      BuilderCodes payout wallet, and delegated-agent sessions are refused.
+         *
+         *      `bps` must be between 0 and the current builder-fee cap
+         *      (`builderFeeCapBps` on `GetBuildercodesConfig`) inclusive. The application
+         *      must be enrolled in BuilderCodes with a payout address. At most two changes
+         *      are allowed in any rolling 24 hours; changes Monaco makes on the
+         *      application's behalf do not count. Setting the fee it already has is a
+         *      no-op that succeeds and does not use up a change.
+         *
+         *      The fee can be set while builder fees are switched off
+         *      (`builderFeeEnabled` false): it is stored and nothing is charged until they
+         *      are switched on. Once charged, a new fee applies to orders placed after the
+         *      change within a few seconds; resting orders keep the fee they were placed
+         *      with.
+         *
+         *      A refused change is **HTTP 409** / **FAILED_PRECONDITION** when the
+         *      application is not enrolled with a payout address or has no changes left
+         *      (REST adds `details.nextChangeAllowedAt`), and **HTTP 400** /
+         *      **INVALID_ARGUMENT** when `bps` is above the cap.
+         */
+        put: operations["set_builder_fee"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/buildercodes/builder-fee/changes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List your builder-fee changes
+         * @description List this application's builder-fee changes.
+         *
+         *      Newest first, cursor-paginated. Includes every change to this
+         *      application's builder fee: those its payout wallet made (`BUILDER`) and
+         *      those Monaco made on its behalf (`ADMIN`). The application is taken from
+         *      the authenticated session.
+         */
+        get: operations["list_builder_fee_changes"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/buildercodes/config": {
         parameters: {
             query?: never;
@@ -3823,6 +3891,36 @@ export interface components {
             matchResult?: components["schemas"]["MatchResult"];
             error?: components["schemas"]["BatchReplaceError"];
         };
+        BuilderFeeChange: {
+            /**
+             * @description Who made the change: `BUILDER` (this application's payout wallet) or `ADMIN` (Monaco, on the application's behalf).
+             * @example BUILDER
+             * @enum {string|null}
+             */
+            actorType?: "BUILDER" | "ADMIN" | null;
+            /**
+             * @description The lowercase payout wallet address for a `BUILDER` change, or the Monaco operator's email for an `ADMIN` change.
+             * @example 0x0000000000000000000000000000000000000001
+             */
+            actor?: string | null;
+            /**
+             * Format: uint32
+             * @description Builder fee before the change, in basis points.
+             * @example 0
+             */
+            oldBps?: number | null;
+            /**
+             * Format: uint32
+             * @description Builder fee after the change, in basis points.
+             * @example 10
+             */
+            newBps?: number | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time of the change.
+             */
+            createdAt?: string | null;
+        };
         BuildercodePayout: {
             /**
              * Format: uuid
@@ -3856,7 +3954,7 @@ export interface components {
              */
             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.
+             * @description Payout category for this credit. `REVENUE_SHARE` is active; `BUILDER_FEE` is reserved and is not currently emitted.
              * @example REVENUE_SHARE
              * @enum {string|null}
              */
@@ -5193,6 +5291,31 @@ export interface components {
              * @example 1000
              */
             buildercodesBudgetBps?: number | null;
+            /** @description Whether builder fees are currently charged. While false, `builderFeeBps` is stored but no builder fee is charged. */
+            builderFeeEnabled?: boolean | null;
+            /**
+             * Format: uint32
+             * @description This application's stored builder fee in basis points: the additional taker fee it charges its users. The fee charged is this value capped at `builderFeeCapBps`, and 0 while `builderFeeEnabled` is false or the application is not enrolled with a payout address.
+             * @example 10
+             */
+            builderFeeBps?: number | null;
+            /**
+             * Format: uint32
+             * @description The highest builder fee, in basis points, that can currently be set or charged.
+             * @example 100
+             */
+            builderFeeCapBps?: number | null;
+            /**
+             * Format: uint32
+             * @description Builder-fee changes this application can still make in the current rolling 24 hours (at most 2).
+             * @example 2
+             */
+            changesRemaining?: number | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time at which the next builder-fee change becomes allowed, or null while `changesRemaining` is above 0.
+             */
+            nextChangeAllowedAt?: string | null;
         };
         /** @description OHLCV candlestick data. */
         GetCandlesResponse: {
@@ -6997,6 +7120,12 @@ export interface components {
              */
             totalPages?: number | null;
         };
+        ListBuilderFeeChangesResponse: {
+            /** @description Builder-fee changes, newest first. */
+            changes?: components["schemas"]["BuilderFeeChange"][] | null;
+            /** @description Cursor for the next page; empty when there are no more. */
+            nextPageToken?: string | null;
+        };
         ListBuildercodePayoutsResponse: {
             /** @description Per-trade credits, newest first. */
             payouts?: components["schemas"]["BuildercodePayout"][] | null;
@@ -8820,6 +8949,39 @@ export interface components {
              */
             isCustom?: boolean | null;
         };
+        SetBuilderFeeRequest: {
+            /**
+             * Format: uint32
+             * @description New builder fee in basis points, from 0 up to the current `builderFeeCapBps` inclusive. 0 stops charging a builder fee.
+             * @example 10
+             */
+            bps: number;
+        };
+        SetBuilderFeeResponse: {
+            /**
+             * Format: uint32
+             * @description The builder fee now stored, in basis points.
+             * @example 10
+             */
+            builderFeeBps?: number | null;
+            /**
+             * Format: uint32
+             * @description The builder fee this change replaced, in basis points. Equal to `builderFeeBps` when the request set the fee it already had, which changes nothing.
+             * @example 0
+             */
+            previousBuilderFeeBps?: number | null;
+            /**
+             * Format: uint32
+             * @description Builder-fee changes this application can still make in the current rolling 24 hours (at most 2).
+             * @example 1
+             */
+            changesRemaining?: number | null;
+            /**
+             * Format: date-time
+             * @description RFC 3339 time at which the next builder-fee change becomes allowed, or null while `changesRemaining` is above 0.
+             */
+            nextChangeAllowedAt?: string | null;
+        };
         SetSelfTradePreventionDefaultRequest: {
             /**
              * @description The self-trade-prevention mode applied when an order from this wallet would match the wallet family's own resting order and the order names no override: `CANCEL_MAKER` (cancel the resting order — the platform default), `CANCEL_TAKER` (cancel the incoming order), `CANCEL_BOTH`, or `SKIP` (trade around own orders). Input is case-insensitive.
@@ -9963,12 +10125,12 @@ export interface components {
         };
         UpdatedFields: {
             /**
-             * @description New price (if changed)
+             * @description The replacement's limit price: the requested price, or the original order's price when price was omitted.
              * @example 35500.00
              */
             price?: string | null;
             /**
-             * @description New quantity (if changed)
+             * @description The replacement's total quantity: the requested quantity, or the original order's total when quantity was omitted. It is not the resting size: the replacement rests this total minus the already-filled amount, so a 100-lot with 60 filled reports 100 here and rests 40. Read the order's remainingQuantity for the resting size. Margin reduce-only replacements are the exception: this is the close size placed, which is the requested quantity or, when omitted, the original's remaining quantity.
              * @example 0.7
              */
             quantity?: string | null;
@@ -11928,6 +12090,135 @@ export interface operations {
             };
         };
     };
+    set_builder_fee: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SetBuilderFeeRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SetBuilderFeeResponse"];
+                };
+            };
+            /** @description bps is above the current builder-fee cap (gRPC: INVALID_ARGUMENT) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authenticated application not found (gRPC: NOT_FOUND) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The application is not enrolled in BuilderCodes with a payout address, or it has already made two changes in the last 24 hours; the latter carries `details.nextChangeAllowedAt` (gRPC: FAILED_PRECONDITION) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_builder_fee_changes: {
+        parameters: {
+            query?: {
+                /** @description Items per page (max 100) */
+                pageSize?: number;
+                /**
+                 * @description Opaque cursor from a previous response's `nextPageToken`; omit or send an
+                 *      empty string for the first page.
+                 */
+                pageToken?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ListBuilderFeeChangesResponse"];
+                };
+            };
+            /** @description Invalid page size or page token */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Refused: BuilderCodes is disabled, the caller is delegated, or the caller is not this application's payout wallet (gRPC: PERMISSION_DENIED) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authenticated application not found (gRPC: NOT_FOUND) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_buildercodes_config: {
         parameters: {
             query?: never;
@@ -11983,7 +12274,7 @@ 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. */
+                /** @description Only return BuilderCodes payouts of this payout kind: REVENUE_SHARE (the frontend's share of Monaco's fee) or BUILDER_FEE (reserved and not currently emitted). Omit for every kind. */
                 kind?: "REVENUE_SHARE" | "BUILDER_FEE";
             };
             header?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.72",
+	"version": "1.0.73",
 	"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.72",
+		"@0xmonaco/contracts": "1.0.73",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {