@0xmonaco/core 1.0.77 → 1.0.80

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

@@ -77,10 +77,12 @@ export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
      */
     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

@@ -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/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

@@ -468,6 +468,60 @@ 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"),
+    };
+}
 function parseInstrumentEventData(raw) {
     if (!isRecord(raw)) {
         throw new Error("Invalid instrument event: data must be an object");
@@ -514,6 +568,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"),
@@ -1461,7 +1516,7 @@ export function createMonacoWebSocket(baseUrl, options = {}, serverClock = new S
             }
         });
     };
-    const subscribeTrades = (tradingPairId, handler) => {
+    const subscribeTrades = (tradingPairId, handler, onSnapshot) => {
         const channel = `trades:${tradingPairId}`;
         return subscribe(channel, (rawData) => {
             try {
@@ -1484,7 +1539,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.80",
 	"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.80",
+		"@0xmonaco/types": "1.0.80",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"