@0xmonaco/core 1.0.61 → 1.0.64

package/dist/api/auth/api.js

@@ -228,6 +228,12 @@ export class AuthAPIImpl extends BaseAPI {
                 address: responseBody.user.address,
                 username: responseBody.user.username,
             },
+            // Signup signals (0XM-2781): first-time-user gating and referral-landed
+            // confirmation for the FE. Only spread them when the server actually sent
+            // them, so `AuthState` keeps its original shape against a server that
+            // predates the fields (no `isNewUser: undefined` key).
+            ...(responseBody.isNewUser !== undefined ? { isNewUser: responseBody.isNewUser } : {}),
+            ...(responseBody.referralApplied !== undefined ? { referralApplied: responseBody.referralApplied } : {}),
         };
     }
     /**

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

@@ -33,7 +33,7 @@
  * console.log(`Rewards remaining: ${result.rewardsBalance}`);
  * ```
  */
-import type { GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
+import type { GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetRewardsBalanceResponse, PitpassAPI, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
 import { BaseAPI } from "../base";
 export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
     /**
@@ -76,4 +76,16 @@ export declare class PitpassAPIImpl extends BaseAPI implements PitpassAPI {
      * Transfer earned PitPass rewards into a trading balance.
      */
     transferRewards(params: TransferRewardsParams): Promise<TransferRewardsResponse>;
+    /**
+     * Read the caller's own referral position: 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.
+     */
+    getMyReferralPosition(): Promise<GetMyReferralPositionResponse>;
+    /**
+     * Read the caller's own downline: earnings by source across L1/L2/L3, the L1
+     * direct-referee roster (including referees who haven't traded), and a
+     * per-level earnings summary. Self-scoped, read-only.
+     */
+    getMyReferralDownline(): Promise<GetMyReferralDownlineResponse>;
 }

package/dist/api/pitpass/api.js

@@ -108,4 +108,24 @@ export class PitpassAPIImpl extends BaseAPI {
             body: JSON.stringify({ token: validated.token, amount: validated.amount }),
         });
     }
+    /**
+     * Read the caller's own referral position: 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.
+     */
+    async getMyReferralPosition() {
+        return await this.makeAuthenticatedRequest("/api/v1/pitpass/referrals/me", {
+            method: "GET",
+        });
+    }
+    /**
+     * Read the caller's own downline: earnings by source across L1/L2/L3, the L1
+     * direct-referee roster (including referees who haven't traded), and a
+     * per-level earnings summary. Self-scoped, read-only.
+     */
+    async getMyReferralDownline() {
+        return await this.makeAuthenticatedRequest("/api/v1/pitpass/referrals/me/downline", {
+            method: "GET",
+        });
+    }
 }

package/dist/api/trading/api.d.ts

@@ -302,16 +302,18 @@ export declare class TradingAPIImpl extends BaseAPI implements TradingAPI {
      * working set.
      * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
      * pagination: it starts a cursor walk from the newest (or oldest, for
-     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Cursor
-     * responses carry no exact totals (`total`/`page`/`totalPages` are 0).
+     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Both modes
+     * populate `total`/`totalPages` (bounded by the server count ceiling — see
+     * `totalCapped`); only `page` is 0 in cursor mode.
      *
      * @param params - Query parameters for filtering orders
      * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED"), or by
      * any of several statuses at once by passing an array (e.g., ["SUBMITTED", "PARTIALLY_FILLED"]) (optional)
      * @param params.tradingPairId - Filter by trading pair UUID (optional)
      * @param params.page - Deprecated: page number for legacy offset pagination (must be > 0).
-     * Passing it selects legacy page-number mode, which only sees recent (hot) history and
-     * populates `total`/`totalPages`. Use cursor pagination (`pageToken`) instead.
+     * Passing it selects legacy page-number mode, which only sees recent (hot) history. Both
+     * modes populate `total`/`totalPages` (bounded — see `totalCapped`); use cursor
+     * pagination (`pageToken`) instead for full history.
      * @param params.pageSize - Number of orders per page (defaults to 10, must be > 0; max 100
      * in page-number mode, up to 1000 when pageToken is present)
      * @param params.pageToken - Pagination cursor: pass `""` to start a cursor walk from

package/dist/api/trading/api.js

@@ -468,16 +468,18 @@ export class TradingAPIImpl extends BaseAPI {
      * working set.
      * When neither `page` nor `pageToken` is passed, the SDK drives cursor (pageToken)
      * pagination: it starts a cursor walk from the newest (or oldest, for
-     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Cursor
-     * responses carry no exact totals (`total`/`page`/`totalPages` are 0).
+     * `orderBy: "ASC"`) row and the response's `nextPageToken` resumes it. Both modes
+     * populate `total`/`totalPages` (bounded by the server count ceiling — see
+     * `totalCapped`); only `page` is 0 in cursor mode.
      *
      * @param params - Query parameters for filtering orders
      * @param params.status - Filter by order status (e.g., "SUBMITTED", "FILLED"), or by
      * any of several statuses at once by passing an array (e.g., ["SUBMITTED", "PARTIALLY_FILLED"]) (optional)
      * @param params.tradingPairId - Filter by trading pair UUID (optional)
      * @param params.page - Deprecated: page number for legacy offset pagination (must be > 0).
-     * Passing it selects legacy page-number mode, which only sees recent (hot) history and
-     * populates `total`/`totalPages`. Use cursor pagination (`pageToken`) instead.
+     * Passing it selects legacy page-number mode, which only sees recent (hot) history. Both
+     * modes populate `total`/`totalPages` (bounded — see `totalCapped`); use cursor
+     * pagination (`pageToken`) instead for full history.
      * @param params.pageSize - Number of orders per page (defaults to 10, must be > 0; max 100
      * in page-number mode, up to 1000 when pageToken is present)
      * @param params.pageToken - Pagination cursor: pass `""` to start a cursor walk from

package/dist/api/websocket/websocket.js

@@ -292,9 +292,13 @@ function parseAccountEventData(raw) {
     return {
         marginAccountId: readString(data, "marginAccountId"),
         // Monotonic per-account publish counter (0XM-2498): a plain JSON number on
-        // the wire, used to order/dedupe frames across reconnect races. Must be a
-        // non-negative safe integer — anything else is a malformed frame.
-        sequence: readSequence(data, "sequence"),
+        // the wire, used to order/dedupe frames across reconnect races. Present on
+        // a live frame and ABSENT on a subscribe-time snapshot row (0XM-2674) — the
+        // counter lives in the matching engine's producer process and the snapshot
+        // is served by ws-api, which cannot mint one. Read optionally so the
+        // snapshot parses; still validated as a non-negative safe integer when
+        // present, because a malformed one would corrupt ordering/dedup.
+        sequence: readOptionalSequence(data, "sequence"),
         equity: readString(data, "equity"),
         collateral: readString(data, "collateral"),
         freeCollateral: readString(data, "freeCollateral"),

package/dist/coverage.d.ts

@@ -44,6 +44,8 @@ export declare const COVERED: {
     get_sweeper_chains: string;
     get_my_trader_code: string;
     get_rewards_balance: string;
+    get_my_referral_position: string;
+    get_my_referral_downline: string;
     get_self_trade_prevention_default: string;
     get_trader_code_info: string;
     set_self_trade_prevention_default: string;

package/dist/coverage.js

@@ -44,6 +44,8 @@ export const COVERED = {
     get_sweeper_chains: "sweeper.getChains",
     get_my_trader_code: "pitpass.getMyTraderCode",
     get_rewards_balance: "pitpass.getRewardsBalance",
+    get_my_referral_position: "pitpass.getMyReferralPosition",
+    get_my_referral_downline: "pitpass.getMyReferralDownline",
     get_self_trade_prevention_default: "profile.getSelfTradePreventionDefault",
     get_trader_code_info: "pitpass.getTraderCodeInfo",
     set_self_trade_prevention_default: "profile.setSelfTradePreventionDefault",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "1.0.61",
+	"version": "1.0.64",
 	"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.61",
-		"@0xmonaco/types": "1.0.61",
+		"@0xmonaco/contracts": "1.0.64",
+		"@0xmonaco/types": "1.0.64",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^2.4.0",
 		"http-status-codes": "^2.3.0"