@0xmonaco/react 1.0.73 → 1.0.74-develop.367860f

package/README.md

@@ -234,22 +234,28 @@ await withdraw(assetId, amount);
 Access user profile and account information.
 
 ```tsx
-const { getProfile, getUserBalances, getUserMovements } = useProfile();
+const { fetchProfile, getUserBalances, getPaginatedUserMovements } = useProfile();
 
-// Get profile
-const profile = await getProfile();
+// Get profile (also populates the hook's balances/movements/orders state)
+const profile = await fetchProfile();
 
-// Get balances
+// Get balances — cursor paged: omit pageToken to start, then follow
+// nextPageToken until it comes back empty.
 const balances = await getUserBalances({
-  page: 1,
-  page_size: 10,
+  pageSize: 10,
 });
 
 // Get movements (transaction history)
-const movements = await getUserMovements({
-  page: 1,
-  page_size: 20,
+const firstPage = await getPaginatedUserMovements({
+  pageSize: 20,
 });
+
+// Walk the rest
+let pageToken = firstPage.nextPageToken;
+while (pageToken) {
+  const next = await getPaginatedUserMovements({ pageSize: 20, pageToken });
+  pageToken = next.nextPageToken;
+}
 ```
 
 ### WebSocket Hooks

package/dist/coverage.d.ts

@@ -51,6 +51,7 @@ export declare const COVERED: {
     get_rewards_balance: string;
     get_my_referral_position: string;
     get_my_referral_downline: string;
+    get_my_referral_tree: string;
     get_trader_code_info: string;
     get_trades: string;
     get_user_balance_by_asset: string;
@@ -139,6 +140,12 @@ export declare const INTENTIONALLY_EXCLUDED: {
     transfer_collateral_to_margin_account: string;
     transfer_collateral_to_parent_margin_account: string;
     transfer_collateral_to_risk_bucket: string;
+    create_sub_account: string;
+    close_sub_account: string;
+    get_margin_account_pnl: string;
+    transfer_collateral: string;
+    transfer_collateral_to_sub_account: string;
+    transfer_collateral_from_sub_account: string;
     update_sub_account_limit: string;
     upsert_delegated_agent: string;
     verify_signature: string;

package/dist/coverage.js

@@ -51,6 +51,7 @@ export const COVERED = {
     get_rewards_balance: "useRewardsBalance",
     get_my_referral_position: "useMyReferralPosition",
     get_my_referral_downline: "useMyReferralDownline",
+    get_my_referral_tree: "useMyReferralTree",
     get_trader_code_info: "useTraderCodeInfo",
     get_trades: "useTradeFeed",
     get_user_balance_by_asset: "useProfile",
@@ -83,8 +84,8 @@ export const INTENTIONALLY_EXCLUDED = {
     create_twap_order: "TWAP parent orders are an advanced execution-algo surface (covered by @0xmonaco/core); no React hook yet.",
     create_sub_account_limit: "Sub-account administration; no React hook.",
     delete_sub_account_limit: "Sub-account administration; no React hook.",
-    get_application_config: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
-    get_application_stats: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    get_application_config: "Application operator configuration endpoint; not a user-wallet React workflow.",
+    get_application_stats: "Application reporting endpoint (public, selected by clientId) for frontend operators; not a user-wallet React workflow.",
     get_available_collateral: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
     get_buildercode_payout_summary: "BuilderCodes frontend-operator reporting is covered by @0xmonaco/core; no React hook.",
     get_buildercode_rewards_balance: "BuilderCodes frontend-operator reporting is covered by @0xmonaco/core; no React hook.",
@@ -114,10 +115,10 @@ export const INTENTIONALLY_EXCLUDED = {
     get_twap_order_tca: "TWAP parent orders are an advanced execution-algo surface (covered by @0xmonaco/core); no React hook yet.",
     get_user_trades: "Trade-history lookup with a core client method but no dedicated React hook yet.",
     health_check: "Infrastructure liveness probe (GET /health); not part of the data SDK surface.",
-    list_application_balances: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
-    list_application_movements: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
-    list_application_orders: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
-    list_application_users: "Application/backend (server-key) admin endpoint; not a user-wallet React workflow.",
+    list_application_balances: "Application reporting endpoint (public, selected by clientId) for frontend operators; not a user-wallet React workflow.",
+    list_application_movements: "Application reporting endpoint (public, selected by clientId) for frontend operators; not a user-wallet React workflow.",
+    list_application_orders: "Application reporting endpoint (public, selected by clientId) for frontend operators; not a user-wallet React workflow.",
+    list_application_users: "Application reporting endpoint (public, selected by clientId) for frontend operators; not a user-wallet React workflow.",
     list_buildercode_payouts: "BuilderCodes frontend-operator reporting is covered by @0xmonaco/core; no React hook.",
     list_builder_fee_changes: "BuilderCodes frontend-operator audit reporting is covered by @0xmonaco/core; no React hook.",
     list_delegated_agent_owners: "Delegated-agent management is an automation/agent surface, not a UI workflow; no React hook.",
@@ -139,6 +140,12 @@ export const INTENTIONALLY_EXCLUDED = {
     transfer_collateral_to_margin_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
     transfer_collateral_to_parent_margin_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
     transfer_collateral_to_risk_bucket: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    create_sub_account: "Margin sub-account management; no React hook yet.",
+    close_sub_account: "Margin sub-account management; no React hook yet.",
+    get_margin_account_pnl: "Margin sub-account read; no React hook yet.",
+    transfer_collateral: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    transfer_collateral_to_sub_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
+    transfer_collateral_from_sub_account: "Margin-account management/collateral/simulation endpoint; no React hook yet.",
     update_sub_account_limit: "Sub-account administration; no React hook.",
     upsert_delegated_agent: "Delegated-agent management is an automation/agent surface, not a UI workflow; no React hook.",
     verify_signature: "Auth verification runs inside login()/authenticate(); useAuth does not expose verifySignature as its own hook method.",

package/dist/hooks/usePitpass/index.d.ts

@@ -1,7 +1,8 @@
-export type { UseClearTraderCodeReturn, UseMyReferralDownlineReturn, UseMyReferralPositionReturn, UseMyTraderCodeReturn, UseRewardsBalanceReturn, UseSetTraderCodeReturn, UseTraderCodeAvailabilityReturn, UseTraderCodeInfoReturn, UseTransferRewardsReturn, } from "./types";
+export type { UseClearTraderCodeReturn, UseMyReferralDownlineReturn, UseMyReferralPositionReturn, UseMyReferralTreeReturn, UseMyTraderCodeReturn, UseRewardsBalanceReturn, UseSetTraderCodeReturn, UseTraderCodeAvailabilityReturn, UseTraderCodeInfoReturn, UseTransferRewardsReturn, } from "./types";
 export { useClearTraderCode } from "./useClearTraderCode";
 export { useMyReferralDownline } from "./useMyReferralDownline";
 export { useMyReferralPosition } from "./useMyReferralPosition";
+export { useMyReferralTree } from "./useMyReferralTree";
 export { useMyTraderCode } from "./useMyTraderCode";
 export { useRewardsBalance } from "./useRewardsBalance";
 export { useSetTraderCode } from "./useSetTraderCode";

package/dist/hooks/usePitpass/index.js

@@ -1,6 +1,7 @@
 export { useClearTraderCode } from "./useClearTraderCode";
 export { useMyReferralDownline } from "./useMyReferralDownline";
 export { useMyReferralPosition } from "./useMyReferralPosition";
+export { useMyReferralTree } from "./useMyReferralTree";
 export { useMyTraderCode } from "./useMyTraderCode";
 export { useRewardsBalance } from "./useRewardsBalance";
 export { useSetTraderCode } from "./useSetTraderCode";

package/dist/hooks/usePitpass/types.d.ts

@@ -1,4 +1,4 @@
-import type { GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetRewardsBalanceResponse, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
+import type { GetMyReferralDownlineParams, GetMyReferralDownlineResponse, GetMyReferralPositionResponse, GetMyReferralTreeParams, GetMyReferralTreeResponse, GetRewardsBalanceResponse, TraderCodeAvailabilityResponse, TraderCodeInfoResponse, TraderCodeResponse, TransferRewardsParams, TransferRewardsResponse } from "@0xmonaco/types";
 export interface UseMyTraderCodeReturn {
     /** Read the caller's TraderCode identity (wallet-derived `code` plus the custom-handle fields). */
     getMyTraderCode: () => Promise<TraderCodeResponse>;
@@ -28,10 +28,14 @@ export interface UseTransferRewardsReturn {
     transferRewards: (params: TransferRewardsParams) => Promise<TransferRewardsResponse>;
 }
 export interface UseMyReferralPositionReturn {
-    /** Read the caller's own referral position: L1 referrer, total earned, and recent rewards. */
+    /** Read the caller's own referral position: upline (as deep as PitPass rewards), L1 referrer, total earned, and recent rewards. */
     getMyReferralPosition: () => Promise<GetMyReferralPositionResponse>;
 }
 export interface UseMyReferralDownlineReturn {
-    /** Read the caller's own downline: earnings by source (L1/L2/L3), L1 roster, and per-level summary. */
-    getMyReferralDownline: () => Promise<GetMyReferralDownlineResponse>;
+    /** Read the caller's own downline: one page of earnings by source (every level), L1 roster, and per-level summary. */
+    getMyReferralDownline: (params?: GetMyReferralDownlineParams) => Promise<GetMyReferralDownlineResponse>;
+}
+export interface UseMyReferralTreeReturn {
+    /** Read one level of the caller's own referral tree: `parent`'s direct referees (the caller when omitted), paginated. */
+    getMyReferralTree: (params?: GetMyReferralTreeParams) => Promise<GetMyReferralTreeResponse>;
 }

package/dist/hooks/usePitpass/useMyReferralDownline.d.ts

@@ -1,8 +1,10 @@
 import type { UseMyReferralDownlineReturn } from "./types";
 /**
- * Read the authenticated caller's own downline: earnings by source across
- * L1/L2/L3, their L1 direct-referee roster (including referees who have not
- * traded yet), and a per-level earnings summary.
+ * Read the authenticated caller's own downline: one page of earnings by source
+ * across every reward level, their L1 direct-referee roster (including
+ * referees who have not traded yet), and a per-level earnings summary covering
+ * every level. Pass `pageToken` from the previous response's `nextPageToken`
+ * to read the next page.
  *
  * Self-scoped and read-only. Every source and referee is a public wallet
  * address plus a `display` handle-or-wallet variant, never an internal id.

package/dist/hooks/usePitpass/useMyReferralDownline.js

@@ -1,19 +1,21 @@
 import { useCallback } from "react";
 import { useMonacoSDK } from "../useMonaco";
 /**
- * Read the authenticated caller's own downline: earnings by source across
- * L1/L2/L3, their L1 direct-referee roster (including referees who have not
- * traded yet), and a per-level earnings summary.
+ * Read the authenticated caller's own downline: one page of earnings by source
+ * across every reward level, their L1 direct-referee roster (including
+ * referees who have not traded yet), and a per-level earnings summary covering
+ * every level. Pass `pageToken` from the previous response's `nextPageToken`
+ * to read the next page.
  *
  * Self-scoped and read-only. Every source and referee is a public wallet
  * address plus a `display` handle-or-wallet variant, never an internal id.
  */
 export const useMyReferralDownline = () => {
     const { sdk } = useMonacoSDK();
-    const getMyReferralDownline = useCallback(async () => {
+    const getMyReferralDownline = useCallback(async (params) => {
         if (!sdk)
             throw new Error("SDK not available");
-        return await sdk.pitpass.getMyReferralDownline();
+        return await sdk.pitpass.getMyReferralDownline(params);
     }, [sdk]);
     return { getMyReferralDownline };
 };

package/dist/hooks/usePitpass/useMyReferralTree.d.ts

@@ -0,0 +1,10 @@
+import type { UseMyReferralTreeReturn } from "./types";
+/**
+ * Read one level of the authenticated caller's own referral tree: the wallets
+ * `parent` directly referred (the caller when omitted), a page at a time,
+ * newest first. Expand a node by calling again with `parent` set to its wallet.
+ *
+ * Self-scoped and read-only: `parent` must be the caller or one of their own
+ * L1/L2 referees, otherwise the request fails with a 404.
+ */
+export declare const useMyReferralTree: () => UseMyReferralTreeReturn;

package/dist/hooks/usePitpass/useMyReferralTree.js

@@ -0,0 +1,19 @@
+import { useCallback } from "react";
+import { useMonacoSDK } from "../useMonaco";
+/**
+ * Read one level of the authenticated caller's own referral tree: the wallets
+ * `parent` directly referred (the caller when omitted), a page at a time,
+ * newest first. Expand a node by calling again with `parent` set to its wallet.
+ *
+ * Self-scoped and read-only: `parent` must be the caller or one of their own
+ * L1/L2 referees, otherwise the request fails with a 404.
+ */
+export const useMyReferralTree = () => {
+    const { sdk } = useMonacoSDK();
+    const getMyReferralTree = useCallback(async (params) => {
+        if (!sdk)
+            throw new Error("SDK not available");
+        return await sdk.pitpass.getMyReferralTree(params);
+    }, [sdk]);
+    return { getMyReferralTree };
+};

package/dist/hooks/useProfile/useProfile.js

@@ -51,10 +51,14 @@ export const useProfile = () => {
         try {
             const [userProfileResult, balancesResult, movementsResult, ordersResult] = await Promise.allSettled([
                 sdk.profile.getProfile(),
-                sdk.profile.getUserBalances({ pageSize: DEFAULT_PAGE_SIZE, page: 1 }),
-                sdk.profile.getPaginatedUserMovements({ page: 1, pageSize: DEFAULT_PAGE_SIZE }),
-                // Cursor mode (pageToken "") reads the newest orders; legacy
-                // page-number mode is deprecated.
+                // Cursor mode (pageToken "") reads the first page of balances;
+                // page-number mode was removed (0XM-2821).
+                sdk.profile.getUserBalances({ pageToken: "", pageSize: DEFAULT_PAGE_SIZE }),
+                // Cursor mode (pageToken "") reads the newest movements; page-number
+                // mode was removed (0XM-2820).
+                sdk.profile.getPaginatedUserMovements({ pageToken: "", pageSize: DEFAULT_PAGE_SIZE }),
+                // Cursor mode (pageToken "") reads the newest orders; page-number
+                // mode was removed (0XM-2963).
                 sdk.trading.getPaginatedOrders({ pageSize: DEFAULT_PAGE_SIZE, pageToken: "" }),
             ]);
             const userProfile = getSettledValueOrThrow(userProfileResult);

package/dist/hooks/useTradeFeed/useTradeFeed.js

@@ -19,7 +19,10 @@ export function useTradeFeed(tradingPairId) {
         if (!sdk?.ws || !sdk?.trades || !tradingPairId) {
             return;
         }
-        const fetchInitialTrades = () => sdk.trades.getTrades(tradingPairId, { pageSize: MAX_TRADES });
+        // One page is the whole need here: the provider keeps only the newest
+        // MAX_TRADES and the WebSocket feed takes over from there, so the cursor
+        // (0XM-2821) is not walked — just unwrapped.
+        const fetchInitialTrades = async () => (await sdk.trades.getTrades(tradingPairId, { pageSize: MAX_TRADES })).trades;
         const subscribeToWs = (handler) => sdk.ws.trades(tradingPairId, handler);
         return subscribe(tradingPairId, fetchInitialTrades, subscribeToWs);
     }, [sdk?.ws, sdk?.trades, tradingPairId, subscribe]);

package/dist/hooks/useUserBalances/useUserBalances.js

@@ -1,14 +1,14 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useMonacoSDK } from "../useMonaco";
 /**
- * Page size for the balance read. The endpoint caps it at 100, and asking for
- * the maximum keeps a full account to one request in practice.
+ * Page size for the balance read. The endpoint caps it at 1000, and 100 keeps
+ * a full account to one request in practice.
  */
 const BALANCES_PAGE_SIZE = 100;
 /**
  * Hard ceiling on pages walked, mirroring the server snapshot's own guard: a
- * malformed `totalPages` must not drive an unbounded read loop. At the page
- * size above this covers far more assets than an account can hold.
+ * server that kept minting tokens must not drive an unbounded read loop. At
+ * the page size above this covers far more assets than an account can hold.
  */
 const MAX_BALANCE_PAGES = 20;
 /**
@@ -19,22 +19,23 @@ const MAX_BALANCE_PAGES = 20;
  * page permanently unreachable, and a snapshot naming one would ask for a
  * repair read that could never satisfy it.
  *
- * Termination is progress-based rather than trusting `totalPages`: a page
- * shorter than the one requested is the last one, whatever the count claims,
- * and the ceiling bounds the loop regardless.
+ * Cursor paged (0XM-2788/0XM-2821): the walk follows `nextPageToken` until it
+ * comes back empty. The server over-fetches, so an empty token is the
+ * definitive end — this no longer has to infer the end from a short page or
+ * trust `totalPages`. The page ceiling still bounds the loop.
  *
- * Rows are deduplicated by token, keeping the first occurrence, the same way
- * `useUserOrders` deduplicates its paginated read. Offset paging is re-derived
- * against whatever the table looks like when each page runs, so a row that
- * moves between two reads can be returned twice — and a duplicate here would
- * become two list entries for one asset, only the first of which any later
- * update would find.
+ * Rows are still deduplicated by token, keeping the first occurrence, the same
+ * way `useUserOrders` deduplicates its paginated read. The cursor walks an
+ * immutable key now, so a row that moves between two reads is no longer served
+ * twice — but a duplicate here would become two list entries for one asset,
+ * only the first of which any later update would find, so the guard stays.
  */
 async function readAllBalances(profile) {
     const all = [];
     const seen = new Set();
+    let pageToken = "";
     for (let page = 1; page <= MAX_BALANCE_PAGES; page++) {
-        const response = await profile.getUserBalances({ page, pageSize: BALANCES_PAGE_SIZE });
+        const response = await profile.getUserBalances({ pageToken, pageSize: BALANCES_PAGE_SIZE });
         for (const row of response.balances) {
             const token = row.token.toLowerCase();
             if (seen.has(token))
@@ -42,10 +43,11 @@ async function readAllBalances(profile) {
             seen.add(token);
             all.push(row);
         }
-        if (response.balances.length < BALANCES_PAGE_SIZE)
-            break;
-        if (Number.isFinite(response.totalPages) && page >= response.totalPages)
+        // A server that predates the cursor contract sends no token at all; treat
+        // that as the end rather than re-reading the first page forever.
+        if (!response.nextPageToken)
             break;
+        pageToken = response.nextPageToken;
     }
     return all;
 }

package/dist/hooks/useUserMovements/types.d.ts

@@ -2,7 +2,14 @@ import type { GetUserMovementsParams, UserMovementEvent } from "@0xmonaco/types"
 /**
  * Options for the useUserMovements hook
  */
-export interface UseUserMovementsOptions extends Omit<GetUserMovementsParams, "page"> {
+/**
+ * `pageToken` and `orderBy` are omitted deliberately. The hook reads one
+ * newest-first page and then keeps it current from the `movements` WebSocket
+ * channel, so there is no walk for a cursor to resume and no way to honour a
+ * different sort — exposing either would let a caller set a value the hook
+ * silently ignores.
+ */
+export interface UseUserMovementsOptions extends Omit<GetUserMovementsParams, "pageToken" | "orderBy"> {
     /** Maximum number of movements to keep in state (default: 50) */
     maxMovements?: number;
 }

package/dist/hooks/useUserOrders/useUserOrders.js

@@ -849,8 +849,11 @@ export function orderFromEvent(event) {
         side,
         price: data.price,
         quantity: data.quantity || "0",
-        filledQuantity: "0",
-        averageFillPrice: undefined,
+        // An edit's replacement is acknowledged with the fill carried over from
+        // the original order and its average, as REST reports the edited order;
+        // any other placement omits both and starts unfilled.
+        filledQuantity: typeof data.filledQuantity === "string" ? data.filledQuantity : "0",
+        averageFillPrice: typeof data.averageFillPrice === "string" ? data.averageFillPrice : undefined,
         // Not an invented value: an `OrderPlaced` event IS a submitted order by
         // construction, whatever status string it carries.
         status: asOrderStatus(data.status) ?? "SUBMITTED",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/react",
-	"version": "1.0.73",
+	"version": "1.0.74-develop.367860f",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,8 +16,8 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/core": "1.0.73",
-		"@0xmonaco/types": "1.0.73"
+		"@0xmonaco/core": "1.0.74-develop.367860f",
+		"@0xmonaco/types": "1.0.74-develop.367860f"
 	},
 	"devDependencies": {
 		"@types/react": "^19.2.18",
@@ -25,8 +25,8 @@
 	},
 	"peerDependencies": {
 		"react": "^17.0.0 || ^18.0.0 || ^19.0.0",
-		"wagmi": "^2.0.0 || ^3.0.0",
-		"viem": "^2.45.2"
+		"viem": "^2.45.2",
+		"wagmi": "^2.0.0 || ^3.0.0"
 	},
 	"exports": {
 		".": {