@0xmonaco/core 1.0.77 → 1.0.81

package/dist/api/pitpass/api.d.ts

@@ -1,7 +1,7 @@
 /**
- * PitPass TraderCode API Implementation
+ * TraderCodes API Implementation (`sdk.pitpass`)
  *
- * Provides methods for the PitPass referral system: reading your wallet-derived
+ * Provides methods for the TraderCodes referral program: reading your wallet-derived
  * TraderCode, a public lookup to validate a referral code at sign-up, reading
  * your accrued rewards balance, and transferring rewards into a tradeable balance.
  *
@@ -69,18 +69,20 @@ export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
      */
     getTraderCodeInfo(code: string): Promise<TraderCodeInfoResponse>;
     /**
-     * Return the caller's current PitPass rewards-bucket balances.
+     * Return the caller's current TraderCodes rewards-bucket balances.
      */
     getRewardsBalance(): Promise<GetRewardsBalanceResponse>;
     /**
-     * Transfer earned PitPass rewards into a trading balance.
+     * Transfer earned TraderCodes rewards into a trading balance.
      */
     transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
     /**
-     * Read the caller's own referral position: their upline (L1, L2, ...), their
-     * L1 referrer, total earned, and recent rewards. Self-scoped — no id is sent,
-     * so it can only ever return your own chain. `referrer` is "" and `upline` is
-     * empty when you were not referred.
+     * Read the caller's own referral position: their upline (L1, L2, ..., as
+     * many levels as their trades on this client application pay), their L1
+     * referrer, total earned, and recent rewards. Self-scoped — no id is sent,
+     * so it can only ever return your own chain. `referrer` is "" when you were
+     * not referred; `upline` is also empty when this client application pays no
+     * referral levels.
      */
     getMyReferralPosition(): Promise<GetMyReferralPositionResponse>;
     /**
@@ -96,7 +98,8 @@ export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
      * Read one level of the caller's own referral tree: the wallets `parent`
      * directly referred (the caller when omitted), a page at a time, newest
      * first. `parent` must be the caller or one of their own referees above the
-     * deepest rewarded level; any other wallet is a 404.
+     * deepest level any client application rewards (at most 10); any other
+     * wallet is a 404. The caller's direct referees (L1) are always listed.
      */
     getMyReferralTree(params?: GetMyReferralTreeParams): Promise<GetMyReferralTreeResponse>;
 }

package/dist/api/pitpass/api.js

@@ -1,7 +1,7 @@
 /**
- * PitPass TraderCode API Implementation
+ * TraderCodes API Implementation (`sdk.pitpass`)
  *
- * Provides methods for the PitPass referral system: reading your wallet-derived
+ * Provides methods for the TraderCodes referral program: reading your wallet-derived
  * TraderCode, a public lookup to validate a referral code at sign-up, reading
  * your accrued rewards balance, and transferring rewards into a tradeable balance.
  *
@@ -93,13 +93,13 @@ export class PitpassAPIImpl extends BaseAPI {
         return await this.makePublicRequest(`/api/v1/pitpass/codes/${encoded}`, { method: "GET" });
     }
     /**
-     * Return the caller's current PitPass rewards-bucket balances.
+     * Return the caller's current TraderCodes rewards-bucket balances.
      */
     async getRewardsBalance() {
         return await this.makeAuthenticatedRequest("/api/v1/pitpass/rewards/balance", { method: "GET" });
     }
     /**
-     * Transfer earned PitPass rewards into a trading balance.
+     * Transfer earned TraderCodes rewards into a trading balance.
      */
     async transferRewards(params) {
         const validated = validate(TransferRewardsParamsSchema, params);
@@ -109,10 +109,12 @@ export class PitpassAPIImpl extends BaseAPI {
         });
     }
     /**
-     * Read the caller's own referral position: their upline (L1, L2, ...), their
-     * L1 referrer, total earned, and recent rewards. Self-scoped — no id is sent,
-     * so it can only ever return your own chain. `referrer` is "" and `upline` is
-     * empty when you were not referred.
+     * Read the caller's own referral position: their upline (L1, L2, ..., as
+     * many levels as their trades on this client application pay), their L1
+     * referrer, total earned, and recent rewards. Self-scoped — no id is sent,
+     * so it can only ever return your own chain. `referrer` is "" when you were
+     * not referred; `upline` is also empty when this client application pays no
+     * referral levels.
      */
     async getMyReferralPosition() {
         return await this.makeAuthenticatedRequest("/api/v1/pitpass/referrals/me", {
@@ -146,7 +148,8 @@ export class PitpassAPIImpl extends BaseAPI {
      * Read one level of the caller's own referral tree: the wallets `parent`
      * directly referred (the caller when omitted), a page at a time, newest
      * first. `parent` must be the caller or one of their own referees above the
-     * deepest rewarded level; any other wallet is a 404.
+     * deepest level any client application rewards (at most 10); any other
+     * wallet is a 404. The caller's direct referees (L1) are always listed.
      */
     async getMyReferralTree(params) {
         if (params) {

package/dist/api/pitpass/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * PitPass API Module
+ * TraderCodes API Module (`sdk.pitpass`)
  *
- * Exports the PitPass TraderCode API implementation.
+ * Exports the TraderCodes API implementation.
  */
 export { PitpassAPIImpl } from "./api";

package/dist/api/pitpass/index.js

@@ -1,6 +1,6 @@
 /**
- * PitPass API Module
+ * TraderCodes API Module (`sdk.pitpass`)
  *
- * Exports the PitPass TraderCode API implementation.
+ * Exports the TraderCodes API implementation.
  */
 export { PitpassAPIImpl } from "./api";

package/dist/api/positions/api.d.ts

@@ -11,10 +11,11 @@ export declare class PositionsAPIImpl extends BaseAPI implements PositionsAPI {
      * paging loop off it — follow `nextPageToken`.
      *
      * Order depends on the filter: `status: "OPEN"` is served from the engine's
-     * live view in `(marginAccountId, tradingPairId, positionId)` order, every
-     * other filter from persisted rows newest-opened first. The two are
-     * separate cursor spaces, so a token is only valid in the one that minted
-     * it.
+     * live view in `(marginAccountId, tradingPairId, positionId)` order;
+     * `status: "CLOSED"` and `status: "LIQUIDATED"` from persisted rows
+     * newest-closed first; every other filter from persisted rows
+     * newest-opened first. Each is a separate cursor space, so a token is only
+     * valid in the one that minted it.
      */
     listPositions(params?: ListPositionsParams): Promise<ListPositionsResponse>;
     getPosition(positionId: string): Promise<GetPositionResponse>;

package/dist/api/positions/api.js

@@ -12,10 +12,11 @@ export class PositionsAPIImpl extends BaseAPI {
      * paging loop off it — follow `nextPageToken`.
      *
      * Order depends on the filter: `status: "OPEN"` is served from the engine's
-     * live view in `(marginAccountId, tradingPairId, positionId)` order, every
-     * other filter from persisted rows newest-opened first. The two are
-     * separate cursor spaces, so a token is only valid in the one that minted
-     * it.
+     * live view in `(marginAccountId, tradingPairId, positionId)` order;
+     * `status: "CLOSED"` and `status: "LIQUIDATED"` from persisted rows
+     * newest-closed first; every other filter from persisted rows
+     * newest-opened first. Each is a separate cursor space, so a token is only
+     * valid in the one that minted it.
      */
     async listPositions(params) {
         if (params) {

package/dist/api/websocket/websocket.js

@@ -256,6 +256,9 @@ function parsePositionEventData(raw) {
         // every `>=` comparison, so the server omits the key rather than sending
         // zero.
         version: readOptionalSequence(data, "version"),
+        // Lifetime funding since open. Optional: an older deployment does not
+        // send it, and the server omits it when it cannot serve the whole value.
+        fundingPaid: readOptionalString(data, "fundingPaid"),
     };
 }
 function parsePositionEvent(rawData) {
@@ -468,6 +471,85 @@ function parseMarketStatsAllEvent(rawData) {
         markets: rawData.markets.map(parseMarketStatsSummary),
     };
 }
+function parseRiskTier(raw) {
+    if (!isRecord(raw)) {
+        throw new Error("Invalid instrument event: each riskTiers entry must be an object");
+    }
+    const tierLevel = raw.tierLevel;
+    if (typeof tierLevel !== "number" || !Number.isSafeInteger(tierLevel) || tierLevel < 1) {
+        throw new Error("Invalid WebSocket event: tierLevel must be a positive integer");
+    }
+    return {
+        tierLevel,
+        lowerBoundNotional: readString(raw, "lowerBoundNotional"),
+        maxLeverage: readOptionalString(raw, "maxLeverage"),
+        initialMarginRatio: readString(raw, "initialMarginRatio"),
+        maintenanceMarginRatio: readString(raw, "maintenanceMarginRatio"),
+        initialMarginDeduction: readString(raw, "initialMarginDeduction"),
+        maintenanceMarginDeduction: readString(raw, "maintenanceMarginDeduction"),
+        maxPositionNotional: readOptionalString(raw, "maxPositionNotional"),
+    };
+}
+/**
+ * Read the perp-only margin ladder. Absent (a spot market, or a server that
+ * predates the key) is `undefined`, never a made-up empty ladder; a present
+ * value that is not an array of well-formed tiers throws like any other
+ * malformed field.
+ */
+function readOptionalRiskTiers(source, field) {
+    const value = source[field];
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Array.isArray(value)) {
+        throw new Error(`Invalid WebSocket event: ${field} must be an array`);
+    }
+    return value.map(parseRiskTier);
+}
+/**
+ * Parse one `trades` snapshot row: the live trade frame's `data` body.
+ *
+ * Strict, unlike the live trade handler's casts: a snapshot is delivered
+ * all-or-nothing, so a row with a missing or non-string field must throw for
+ * {@link snapshotFrameHandler} to withhold the frame. The output is the same
+ * `TradeEventData` the live handler builds, `makerSide` uppercased likewise.
+ */
+function parseTradeEventData(raw) {
+    if (!isRecord(raw)) {
+        throw new Error("Invalid trade snapshot row: must be an object");
+    }
+    return {
+        tradeId: readString(raw, "trade_id"),
+        price: readString(raw, "price"),
+        quantity: readString(raw, "quantity"),
+        makerSide: readString(raw, "maker_side").toUpperCase(),
+        executedAt: readString(raw, "executed_at"),
+    };
+}
+/**
+ * Parse one `ohlcv` snapshot row: the live candle frame's `data` body.
+ *
+ * Strict, unlike the live OHLCV handler's casts: a snapshot is delivered
+ * all-or-nothing, so a row with a missing or mistyped field must throw for
+ * {@link snapshotFrameHandler} to withhold the frame. The output is the live
+ * candlestick minus `s`; `i` is the subscription's interval, since the row
+ * carries no envelope.
+ */
+function parseOHLCVSnapshotCandle(raw, interval) {
+    if (!isRecord(raw)) {
+        throw new Error("Invalid ohlcv snapshot row: must be an object");
+    }
+    return {
+        T: readSequence(raw, "period_start"),
+        t: readSequence(raw, "period_end"),
+        o: readString(raw, "open"),
+        h: readString(raw, "high"),
+        l: readString(raw, "low"),
+        c: readString(raw, "close"),
+        v: readString(raw, "volume"),
+        i: interval,
+        n: readSequence(raw, "trades_count"),
+    };
+}
 function parseInstrumentEventData(raw) {
     if (!isRecord(raw)) {
         throw new Error("Invalid instrument event: data must be an object");
@@ -514,6 +596,7 @@ function parseInstrumentEventData(raw) {
         maxLeverage: readOptionalString(data, "maxLeverage"),
         initialMarginRate: readOptionalString(data, "initialMarginRate"),
         maintenanceMarginRate: readOptionalString(data, "maintenanceMarginRate"),
+        riskTiers: readOptionalRiskTiers(data, "riskTiers"),
         // Values are snake_case wire field NAMES (e.g. "tick_size"); only object
         // keys are camelCased, so they pass through untouched.
         changedFields: readStringArray(data, "changedFields"),
@@ -1413,7 +1496,7 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
             }
         });
     };
-    const subscribeOHLCV = (tradingPairId, tradingMode, interval, handler, priceType) => {
+    const subscribeOHLCV = (tradingPairId, tradingMode, interval, handler, priceType, onSnapshot) => {
         // Four-token channel selects the trade-derived candles (back-compat); the
         // optional fifth token selects the price series (`mark` = close-only mark
         // series, `*` = both).
@@ -1459,9 +1542,9 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
             catch (err) {
                 console.error("WebSocket: Error processing OHLCV event", err);
             }
-        });
+        }, onSnapshot && snapshotFrameHandler("ohlcv", (raw) => parseOHLCVSnapshotCandle(raw, interval), onSnapshot));
     };
-    const subscribeTrades = (tradingPairId, handler) => {
+    const subscribeTrades = (tradingPairId, handler, onSnapshot) => {
         const channel = `trades:${tradingPairId}`;
         return subscribe(channel, (rawData) => {
             try {
@@ -1484,7 +1567,7 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
             catch (err) {
                 console.error("WebSocket: Error processing trade event", err);
             }
-        });
+        }, onSnapshot && snapshotFrameHandler("trades", parseTradeEventData, onSnapshot));
     };
     const subscribeMovements = (handler) => {
         // User is identified from the authenticated session, so channel is just "movements"

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.77",
+	"version": "1.0.81",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -19,8 +19,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.77",
-		"@0xmonaco/types": "1.0.77",
+		"@0xmonaco/contracts": "1.0.81",
+		"@0xmonaco/types": "1.0.81",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"