@nadohq/mobile-client 0.29.0 → 0.30.0

package/dist/types/serverModelTypes.d.ts

@@ -1,2 +1,2 @@
-import { a as MobileServerNotificationPreferenceScope, c as MobileServerRegisteredDevice, i as MobileServerNotificationCategoryPreference, n as MobileNotificationPlatform, o as MobileServerNotificationPreferences, r as MobileServerIdentity, s as MobileServerProfile, t as MobileNotificationCategory } from "../serverModelTypes-vEPhHIit.js";
-export { MobileNotificationCategory, MobileNotificationPlatform, MobileServerIdentity, MobileServerNotificationCategoryPreference, MobileServerNotificationPreferenceScope, MobileServerNotificationPreferences, MobileServerProfile, MobileServerRegisteredDevice };
+import { _ as MobileServerRegisteredDevice, a as MobileFeedTradePosition, c as MobileNotificationCategory, d as MobileServerFeedTrade, f as MobileServerIdentity, g as MobileServerProfile, h as MobileServerNotificationPreferences, i as MobileFeedMarginMode, l as MobileNotificationPlatform, m as MobileServerNotificationPreferenceScope, n as MOBILE_FEED_TRADE_POSITION_DIRECTIONS, o as MobileFeedTradePositionDirection, p as MobileServerNotificationCategoryPreference, r as MOBILE_FEED_TRADE_POSITION_EFFECTS, s as MobileFeedTradePositionEffect, t as MOBILE_FEED_MARGIN_MODES, u as MobileServerFeedMargin } from "../serverModelTypes-CqnqHY5F.js";
+export { MOBILE_FEED_MARGIN_MODES, MOBILE_FEED_TRADE_POSITION_DIRECTIONS, MOBILE_FEED_TRADE_POSITION_EFFECTS, MobileFeedMarginMode, MobileFeedTradePosition, MobileFeedTradePositionDirection, MobileFeedTradePositionEffect, MobileNotificationCategory, MobileNotificationPlatform, MobileServerFeedMargin, MobileServerFeedTrade, MobileServerIdentity, MobileServerNotificationCategoryPreference, MobileServerNotificationPreferenceScope, MobileServerNotificationPreferences, MobileServerProfile, MobileServerRegisteredDevice };

package/dist/types/serverModelTypes.js

@@ -1 +1,26 @@
-export {};
+//#region src/types/serverModelTypes.ts
+/**
+* Every {@link MobileFeedTradePositionDirection} the feed can report, for callers that need the values at
+* runtime (validation, filters, UI enumeration).
+*/
+const MOBILE_FEED_TRADE_POSITION_DIRECTIONS = ["long", "short"];
+/**
+* Every {@link MobileFeedTradePositionEffect} the feed can report, for callers that need the values at
+* runtime (validation, filters, UI enumeration).
+*/
+const MOBILE_FEED_TRADE_POSITION_EFFECTS = [
+	"opened",
+	"increased",
+	"reduced",
+	"closed",
+	"flipped"
+];
+/**
+* Every {@link MobileFeedMarginMode} the feed can report, for callers that need the values at runtime
+* (validation, filters, UI enumeration).
+*/
+const MOBILE_FEED_MARGIN_MODES = ["cross", "isolated"];
+//#endregion
+export { MOBILE_FEED_MARGIN_MODES, MOBILE_FEED_TRADE_POSITION_DIRECTIONS, MOBILE_FEED_TRADE_POSITION_EFFECTS };
+
+//# sourceMappingURL=serverModelTypes.js.map

package/dist/types/serverModelTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverModelTypes.js","names":[],"sources":["../../src/types/serverModelTypes.ts"],"sourcesContent":["import { BalanceSide } from '@nadohq/shared';\nimport { Hex } from 'viem';\n\n/**\n * Platform of a device registered for push notifications.\n */\nexport type MobileNotificationPlatform = 'ios' | 'android';\n\n/**\n * Category of push notification.\n */\nexport type MobileNotificationCategory =\n  | 'order_fill'\n  | 'order_update'\n  | 'liquidation'\n  | 'funding'\n  | 'product_listing'\n  | 'announcement';\n\n/**\n * Server-side public profile shape (snake_case).\n */\nexport interface MobileServerProfile {\n  subaccount: Hex;\n  username: string;\n  display_name: string;\n}\n\n/**\n * Server-side identity shape (snake_case) returned by the signed `self_identity` query.\n */\nexport interface MobileServerIdentity {\n  subaccount: Hex;\n  username: string;\n  display_name: string;\n  private_mode: boolean;\n}\n\n/**\n * Direction of the position a feed trade resulted in — for `closed`, the direction that was closed. This is\n * NOT the execution buy/sell side, which the feed does not expose. Aliases {@link BalanceSide} so the feed's\n * direction values stay in lockstep with the rest of the SDK.\n */\nexport type MobileFeedTradePositionDirection = BalanceSide;\n\n/**\n * Every {@link MobileFeedTradePositionDirection} the feed can report, for callers that need the values at\n * runtime (validation, filters, UI enumeration).\n */\nexport const MOBILE_FEED_TRADE_POSITION_DIRECTIONS = [\n  'long',\n  'short',\n] as const satisfies readonly MobileFeedTradePositionDirection[];\n\n/**\n * Every {@link MobileFeedTradePositionEffect} the feed can report, for callers that need the values at\n * runtime (validation, filters, UI enumeration).\n */\nexport const MOBILE_FEED_TRADE_POSITION_EFFECTS = [\n  'opened',\n  'increased',\n  'reduced',\n  'closed',\n  'flipped',\n] as const;\n\n/**\n * How a feed trade changed the trader's position in the product.\n */\nexport type MobileFeedTradePositionEffect =\n  (typeof MOBILE_FEED_TRADE_POSITION_EFFECTS)[number];\n\n/**\n * Position change of a feed trade. Both keys are single words, so the wire and client shapes are identical\n * and this type is shared by {@link MobileServerFeedTrade} and the client-side `MobileFeedTrade`.\n */\nexport interface MobileFeedTradePosition {\n  direction: MobileFeedTradePositionDirection;\n  effect: MobileFeedTradePositionEffect;\n}\n\n/**\n * Every {@link MobileFeedMarginMode} the feed can report, for callers that need the values at runtime\n * (validation, filters, UI enumeration).\n */\nexport const MOBILE_FEED_MARGIN_MODES = ['cross', 'isolated'] as const;\n\n/**\n * Margin mode a feed trade was executed under. Shared by the wire and client margin shapes.\n */\nexport type MobileFeedMarginMode = (typeof MOBILE_FEED_MARGIN_MODES)[number];\n\n/**\n * Server-side margin of a feed trade. Branch on `mode` — do not infer isolated state from leverage presence:\n * `estimated_leverage` (a rounded whole-number estimate, not exact submitted leverage) is omitted on `cross`,\n * and also omitted inside `isolated` when no estimate is available.\n */\nexport interface MobileServerFeedMargin {\n  mode: MobileFeedMarginMode;\n  estimated_leverage?: number;\n}\n\n/**\n * Server-side feed trade shape (snake_case): one row per order digest, enriched at read time with the\n * trader's current identity. Amounts are display-oriented human-unit JSON numbers — do not use them for\n * accounting, order construction, or exact threshold decisions.\n */\nexport interface MobileServerFeedTrade {\n  /** Order digest this row is keyed by; the stable id clients use to reconcile live pagination. */\n  order_digest: Hex;\n  subaccount: Hex;\n  username: string;\n  display_name: string;\n  /** Reserved for a future avatar source; `null` until one is implemented. */\n  avatar_url: string | null;\n  product_id: number;\n  /** Executed quantity in human units. */\n  quantity: number;\n  /** Trade notional in whole-dollar human units. */\n  notional: number;\n  /** Average execution price in human units. */\n  average_price: number;\n  margin: MobileServerFeedMargin;\n  position: MobileFeedTradePosition;\n  /** Realized PnL of the trade in human units; can be negative. */\n  realized_pnl: number;\n  /** Fill time as JavaScript-safe integer Unix milliseconds. */\n  filled_at_ms: number;\n}\n\n/**\n * Server-side scope limiting a notification category preference. Scopes are rejected by the backend for the\n * MVP (`scopes` must be empty) but are part of the wire format.\n */\nexport type MobileServerNotificationPreferenceScope =\n  | { type: 'subaccount'; subaccount: Hex }\n  | { type: 'product'; product_id: number };\n\n/**\n * Server-side per-category notification preference (snake_case).\n */\nexport interface MobileServerNotificationCategoryPreference {\n  category: MobileNotificationCategory;\n  enabled: boolean;\n  scopes: MobileServerNotificationPreferenceScope[];\n}\n\n/**\n * Server-side notification preferences shape (snake_case), used in both the `update_preferences` execute and\n * the `notification_preferences` query response.\n */\nexport interface MobileServerNotificationPreferences {\n  /** Only `1` is accepted by the backend for the MVP. */\n  schema_version: 1;\n  categories: MobileServerNotificationCategoryPreference[];\n}\n\n/**\n * Server-side registered push device shape (snake_case).\n */\nexport interface MobileServerRegisteredDevice {\n  platform: MobileNotificationPlatform;\n  locale: string | null;\n  app_version: string | null;\n  token_fingerprint_prefix: string;\n  last_seen_at: number;\n}\n"],"mappings":";;;;;AAiDA,MAAa,wCAAwC,CACnD,QACA,OACF;;;;;AAMA,MAAa,qCAAqC;CAChD;CACA;CACA;CACA;CACA;AACF;;;;;AAqBA,MAAa,2BAA2B,CAAC,SAAS,UAAU"}

package/dist/types/serverQueryTypes.d.cts

@@ -1,2 +1,2 @@
-import { a as MobileServerRegisteredDevicesResponse, c as MobileServerUsernameAvailabilityResponse, i as MobileServerPublicQueryRequest, n as MobileServerProfileRequest, o as MobileServerSelfIdentityResponse, r as MobileServerProfileResponse, s as MobileServerUsernameAvailabilityRequest, t as MobileServerNotificationPreferencesResponse } from "../serverQueryTypes-D7Yharse.cjs";
-export { MobileServerNotificationPreferencesResponse, MobileServerProfileRequest, MobileServerProfileResponse, MobileServerPublicQueryRequest, MobileServerRegisteredDevicesResponse, MobileServerSelfIdentityResponse, MobileServerUsernameAvailabilityRequest, MobileServerUsernameAvailabilityResponse };
+import { a as MobileServerPublicQueryResponseByType, c as MobileServerSelfIdentityResponse, d as MobileServerUsernameAvailabilityResponse, i as MobileServerPublicQueryRequest, l as MobileServerSignedQueryResponseByType, n as MobileServerNotificationPreferencesResponse, o as MobileServerPublicQuerySuccessResponse, r as MobileServerProfileResponse, s as MobileServerRegisteredDevicesResponse, t as MobileServerFeedResponse, u as MobileServerSignedQuerySuccessResponse } from "../serverQueryTypes-C_cCx0Ac.cjs";
+export { MobileServerFeedResponse, MobileServerNotificationPreferencesResponse, MobileServerProfileResponse, MobileServerPublicQueryRequest, MobileServerPublicQueryResponseByType, MobileServerPublicQuerySuccessResponse, MobileServerRegisteredDevicesResponse, MobileServerSelfIdentityResponse, MobileServerSignedQueryResponseByType, MobileServerSignedQuerySuccessResponse, MobileServerUsernameAvailabilityResponse };

package/dist/types/serverQueryTypes.d.ts

@@ -1,2 +1,2 @@
-import { a as MobileServerRegisteredDevicesResponse, c as MobileServerUsernameAvailabilityResponse, i as MobileServerPublicQueryRequest, n as MobileServerProfileRequest, o as MobileServerSelfIdentityResponse, r as MobileServerProfileResponse, s as MobileServerUsernameAvailabilityRequest, t as MobileServerNotificationPreferencesResponse } from "../serverQueryTypes-BI-2TD8F.js";
-export { MobileServerNotificationPreferencesResponse, MobileServerProfileRequest, MobileServerProfileResponse, MobileServerPublicQueryRequest, MobileServerRegisteredDevicesResponse, MobileServerSelfIdentityResponse, MobileServerUsernameAvailabilityRequest, MobileServerUsernameAvailabilityResponse };
+import { a as MobileServerPublicQueryResponseByType, c as MobileServerSelfIdentityResponse, d as MobileServerUsernameAvailabilityResponse, i as MobileServerPublicQueryRequest, l as MobileServerSignedQueryResponseByType, n as MobileServerNotificationPreferencesResponse, o as MobileServerPublicQuerySuccessResponse, r as MobileServerProfileResponse, s as MobileServerRegisteredDevicesResponse, t as MobileServerFeedResponse, u as MobileServerSignedQuerySuccessResponse } from "../serverQueryTypes-CJLWWZBs.js";
+export { MobileServerFeedResponse, MobileServerNotificationPreferencesResponse, MobileServerProfileResponse, MobileServerPublicQueryRequest, MobileServerPublicQueryResponseByType, MobileServerPublicQuerySuccessResponse, MobileServerRegisteredDevicesResponse, MobileServerSelfIdentityResponse, MobileServerSignedQueryResponseByType, MobileServerSignedQuerySuccessResponse, MobileServerUsernameAvailabilityResponse };

package/dist/types/serverRequestTypes.d.cts

@@ -0,0 +1,2 @@
+import { a as MobileServerSignedQueryRequestByType, i as MobileServerRequestType, n as MobileServerPublicQueryRequestByType, o as MobileServerSignedQueryRequestType, r as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "../serverRequestTypes-DnU_FfMI.cjs";
+export { MobileServerExecuteRequestType, MobileServerPublicQueryRequestByType, MobileServerPublicQueryRequestType, MobileServerRequestType, MobileServerSignedQueryRequestByType, MobileServerSignedQueryRequestType };

package/dist/types/serverRequestTypes.d.ts

@@ -0,0 +1,2 @@
+import { a as MobileServerSignedQueryRequestByType, i as MobileServerRequestType, n as MobileServerPublicQueryRequestByType, o as MobileServerSignedQueryRequestType, r as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "../serverRequestTypes-DQDy3K9O.js";
+export { MobileServerExecuteRequestType, MobileServerPublicQueryRequestByType, MobileServerPublicQueryRequestType, MobileServerRequestType, MobileServerSignedQueryRequestByType, MobileServerSignedQueryRequestType };

package/dist/types/serverRequestTypes.js

@@ -0,0 +1 @@
+export {};

package/dist/{types-uCD4BNZR.d.cts → types-CzOeSYnW.d.cts}

@@ -1,5 +1,5 @@
-import { n as MobileNotificationPlatform, o as MobileServerNotificationPreferences } from "./serverModelTypes-CQgfqgW3.cjs";
-import { h as MobileSignedRequestParams } from "./clientTypes-Et0PUa2d.cjs";
+import { h as MobileServerNotificationPreferences, l as MobileNotificationPlatform } from "./serverModelTypes-CPZUvVil.cjs";
+import { y as MobileSignedRequestParams } from "./clientTypes-UFInIAQd.cjs";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { Hex } from "viem";
 
@@ -70,4 +70,4 @@ interface BuildSignedMobileRequestParams extends MobileSignedRequestParams {
 }
 //#endregion
 export { MobileSignedRequest as i, MobileSignedInner as n, MobileSignedInnerParams as r, BuildSignedMobileRequestParams as t };
-//# sourceMappingURL=types-uCD4BNZR.d.cts.map
+//# sourceMappingURL=types-CzOeSYnW.d.cts.map

package/dist/{types-uCD4BNZR.d.cts.map → types-CzOeSYnW.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-uCD4BNZR.d.cts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAiBA;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAwB,YAAA;AAAA;EACxB,IAAA;EAAyB,YAAA;AAAA;EACzB,IAAA;EAA0B,YAAA;AAAA;EAC1B,IAAA;AAAA;EAEA,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAAA;EAGV,MAAA;EACA,WAAA;AAAA;EAEA,IAAA;EAA+B,UAAA;AAAA;EAE/B,IAAA;EACA,WAAA,EAAa,mCAAmC;AAAA;EAEhD,IAAA;AAAA;EACA,IAAA;AAAA;;;;;KAMM,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;AAAC;AAQtC;KAAY,mBAAA,WACA,iBAAA,GAAoB,iBAAA,IAC5B,CAAA;EACF,SAAA,EAAW,GAAA;EACX,MAAA,EAAQ,GAAA;EACR,KAAA;AAAA;;;;UAMe,8BAAA,SAAuC,yBAAA;EACtD,YAAA,EAAc,uBAAA;EACd,KAAA,EAAO,iBAAA;EAZuB;;;EAgB9B,KAAA;AAAA"}
+{"version":3,"file":"types-CzOeSYnW.d.cts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAiBA;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAwB,YAAA;AAAA;EACxB,IAAA;EAAyB,YAAA;AAAA;EACzB,IAAA;EAA0B,YAAA;AAAA;EAC1B,IAAA;AAAA;EAEA,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAAA;EAGV,MAAA;EACA,WAAA;AAAA;EAEA,IAAA;EAA+B,UAAA;AAAA;EAE/B,IAAA;EACA,WAAA,EAAa,mCAAmC;AAAA;EAEhD,IAAA;AAAA;EACA,IAAA;AAAA;;;;;KAMM,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;AAAC;AAQtC;KAAY,mBAAA,WACA,iBAAA,GAAoB,iBAAA,IAC5B,CAAA;EACF,SAAA,EAAW,GAAA;EACX,MAAA,EAAQ,GAAA;EACR,KAAA;AAAA;;;;UAMe,8BAAA,SAAuC,yBAAA;EACtD,YAAA,EAAc,uBAAA;EACd,KAAA,EAAO,iBAAA;EAZuB;;;EAgB9B,KAAA;AAAA"}

package/dist/{types-B76Pn7Sy.d.ts → types-UHjZR-js.d.ts}

@@ -1,5 +1,5 @@
-import { n as MobileNotificationPlatform, o as MobileServerNotificationPreferences } from "./serverModelTypes-vEPhHIit.js";
-import { h as MobileSignedRequestParams } from "./clientTypes-DWW2N66c.js";
+import { h as MobileServerNotificationPreferences, l as MobileNotificationPlatform } from "./serverModelTypes-CqnqHY5F.js";
+import { y as MobileSignedRequestParams } from "./clientTypes-BsOps_pY.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { Hex } from "viem";
 
@@ -70,4 +70,4 @@ interface BuildSignedMobileRequestParams extends MobileSignedRequestParams {
 }
 //#endregion
 export { MobileSignedRequest as i, MobileSignedInner as n, MobileSignedInnerParams as r, BuildSignedMobileRequestParams as t };
-//# sourceMappingURL=types-B76Pn7Sy.d.ts.map
+//# sourceMappingURL=types-UHjZR-js.d.ts.map

package/dist/{types-B76Pn7Sy.d.ts.map → types-UHjZR-js.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-B76Pn7Sy.d.ts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAiBA;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAwB,YAAA;AAAA;EACxB,IAAA;EAAyB,YAAA;AAAA;EACzB,IAAA;EAA0B,YAAA;AAAA;EAC1B,IAAA;AAAA;EAEA,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAAA;EAGV,MAAA;EACA,WAAA;AAAA;EAEA,IAAA;EAA+B,UAAA;AAAA;EAE/B,IAAA;EACA,WAAA,EAAa,mCAAmC;AAAA;EAEhD,IAAA;AAAA;EACA,IAAA;AAAA;;;;;KAMM,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;AAAC;AAQtC;KAAY,mBAAA,WACA,iBAAA,GAAoB,iBAAA,IAC5B,CAAA;EACF,SAAA,EAAW,GAAA;EACX,MAAA,EAAQ,GAAA;EACR,KAAA;AAAA;;;;UAMe,8BAAA,SAAuC,yBAAA;EACtD,YAAA,EAAc,uBAAA;EACd,KAAA,EAAO,iBAAA;EAZuB;;;EAgB9B,KAAA;AAAA"}
+{"version":3,"file":"types-UHjZR-js.d.ts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAiBA;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAwB,YAAA;AAAA;EACxB,IAAA;EAAyB,YAAA;AAAA;EACzB,IAAA;EAA0B,YAAA;AAAA;EAC1B,IAAA;AAAA;EAEA,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAAA;EAGV,MAAA;EACA,WAAA;AAAA;EAEA,IAAA;EAA+B,UAAA;AAAA;EAE/B,IAAA;EACA,WAAA,EAAa,mCAAmC;AAAA;EAEhD,IAAA;AAAA;EACA,IAAA;AAAA;;;;;KAMM,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;AAAC;AAQtC;KAAY,mBAAA,WACA,iBAAA,GAAoB,iBAAA,IAC5B,CAAA;EACF,SAAA,EAAW,GAAA;EACX,MAAA,EAAQ,GAAA;EACR,KAAA;AAAA;;;;UAMe,8BAAA,SAAuC,yBAAA;EACtD,YAAA,EAAc,uBAAA;EACd,KAAA,EAAO,iBAAA;EAZuB;;;EAgB9B,KAAA;AAAA"}

package/dist/utils/feed.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/feed.ts
+/**
+* Maximum feed page size the backend accepts; also the default when `limit` is omitted. Requests above this
+* fail with `INVALID_FEED_FILTER`.
+*/
+const MOBILE_FEED_MAX_PAGE_SIZE = 50;
+/**
+* Lowest minimum notional the backend accepts, in whole dollars. Filtered requests below this fail with
+* `INVALID_FEED_FILTER`; omitting the filter entirely returns the unfiltered feed.
+*/
+const MOBILE_FEED_MIN_NOTIONAL_FLOOR = 1e3;
+//#endregion
+exports.MOBILE_FEED_MAX_PAGE_SIZE = MOBILE_FEED_MAX_PAGE_SIZE;
+exports.MOBILE_FEED_MIN_NOTIONAL_FLOOR = MOBILE_FEED_MIN_NOTIONAL_FLOOR;
+
+//# sourceMappingURL=feed.cjs.map

package/dist/utils/feed.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.cjs","names":[],"sources":["../../src/utils/feed.ts"],"sourcesContent":["/**\n * Maximum feed page size the backend accepts; also the default when `limit` is omitted. Requests above this\n * fail with `INVALID_FEED_FILTER`.\n */\nexport const MOBILE_FEED_MAX_PAGE_SIZE = 50;\n\n/**\n * Lowest minimum notional the backend accepts, in whole dollars. Filtered requests below this fail with\n * `INVALID_FEED_FILTER`; omitting the filter entirely returns the unfiltered feed.\n */\nexport const MOBILE_FEED_MIN_NOTIONAL_FLOOR = 1_000;\n"],"mappings":";;;;;;AAIA,MAAa,4BAA4B;;;;;AAMzC,MAAa,iCAAiC"}

package/dist/utils/feed.d.cts

@@ -0,0 +1,2 @@
+import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-CBIwOhTO.cjs";
+export { MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR };

package/dist/utils/feed.d.ts

@@ -0,0 +1,2 @@
+import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-BF5k6Ryu.js";
+export { MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR };

package/dist/utils/feed.js

@@ -0,0 +1,15 @@
+//#region src/utils/feed.ts
+/**
+* Maximum feed page size the backend accepts; also the default when `limit` is omitted. Requests above this
+* fail with `INVALID_FEED_FILTER`.
+*/
+const MOBILE_FEED_MAX_PAGE_SIZE = 50;
+/**
+* Lowest minimum notional the backend accepts, in whole dollars. Filtered requests below this fail with
+* `INVALID_FEED_FILTER`; omitting the filter entirely returns the unfiltered feed.
+*/
+const MOBILE_FEED_MIN_NOTIONAL_FLOOR = 1e3;
+//#endregion
+export { MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR };
+
+//# sourceMappingURL=feed.js.map

package/dist/utils/feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.js","names":[],"sources":["../../src/utils/feed.ts"],"sourcesContent":["/**\n * Maximum feed page size the backend accepts; also the default when `limit` is omitted. Requests above this\n * fail with `INVALID_FEED_FILTER`.\n */\nexport const MOBILE_FEED_MAX_PAGE_SIZE = 50;\n\n/**\n * Lowest minimum notional the backend accepts, in whole dollars. Filtered requests below this fail with\n * `INVALID_FEED_FILTER`; omitting the filter entirely returns the unfiltered feed.\n */\nexport const MOBILE_FEED_MIN_NOTIONAL_FLOOR = 1_000;\n"],"mappings":";;;;;AAIA,MAAa,4BAA4B;;;;;AAMzC,MAAa,iCAAiC"}

package/dist/utils/index.cjs

@@ -1,6 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_utils_serverResponseGuards = require("./serverResponseGuards.cjs");
+const require_utils_feed = require("./feed.cjs");
 const require_utils_patterns = require("./patterns.cjs");
 exports.MOBILE_DISPLAY_NAME_PATTERN = require_utils_patterns.MOBILE_DISPLAY_NAME_PATTERN;
+exports.MOBILE_FEED_MAX_PAGE_SIZE = require_utils_feed.MOBILE_FEED_MAX_PAGE_SIZE;
+exports.MOBILE_FEED_MIN_NOTIONAL_FLOOR = require_utils_feed.MOBILE_FEED_MIN_NOTIONAL_FLOOR;
 exports.isMobileServerFailureResponse = require_utils_serverResponseGuards.isMobileServerFailureResponse;
 exports.isMobileServerSuccessResponse = require_utils_serverResponseGuards.isMobileServerSuccessResponse;

package/dist/utils/index.d.cts

@@ -1,3 +1,4 @@
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-B9J2ldpx.cjs";
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-DjCNL3CR.cjs";
-export { MOBILE_DISPLAY_NAME_PATTERN, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-CBIwOhTO.cjs";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-Db6fgz8i.cjs";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-BlvfJjsa.cjs";
+export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, isMobileServerFailureResponse, isMobileServerSuccessResponse };

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-BbxH3_VA.js";
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-C_vZIgGl.js";
-export { MOBILE_DISPLAY_NAME_PATTERN, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-BF5k6Ryu.js";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-B5gi7OfV.js";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-gpHH8SHk.js";
+export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, isMobileServerFailureResponse, isMobileServerSuccessResponse };

package/dist/utils/index.js

@@ -1,3 +1,4 @@
 import { isMobileServerFailureResponse, isMobileServerSuccessResponse } from "./serverResponseGuards.js";
+import { MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR } from "./feed.js";
 import { MOBILE_DISPLAY_NAME_PATTERN } from "./patterns.js";
-export { MOBILE_DISPLAY_NAME_PATTERN, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, isMobileServerFailureResponse, isMobileServerSuccessResponse };

package/dist/utils/patterns.d.cts

@@ -1,2 +1,2 @@
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-B9J2ldpx.cjs";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-Db6fgz8i.cjs";
 export { MOBILE_DISPLAY_NAME_PATTERN };

package/dist/utils/patterns.d.ts

@@ -1,2 +1,2 @@
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-BbxH3_VA.js";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-B5gi7OfV.js";
 export { MOBILE_DISPLAY_NAME_PATTERN };

package/dist/utils/serverResponseGuards.d.cts

@@ -1,2 +1,2 @@
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-DjCNL3CR.cjs";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-BlvfJjsa.cjs";
 export { isMobileServerFailureResponse, isMobileServerSuccessResponse };

package/dist/utils/serverResponseGuards.d.ts

@@ -1,2 +1,2 @@
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-C_vZIgGl.js";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-gpHH8SHk.js";
 export { isMobileServerFailureResponse, isMobileServerSuccessResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadohq/mobile-client",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "type": "module",
   "sideEffects": false,
   "description": "HTTP client for the Nado mobile service API — username claims, profiles, privacy settings, and push notification devices & preferences",
@@ -42,7 +42,7 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "@msgpack/msgpack": "3.1.3",
-    "@nadohq/shared": "^0.29.0",
+    "@nadohq/shared": "^0.30.0",
     "axios": "1.16.1"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
     "bignumber.js": "11.1.1",
     "viem": "2.52.0"
   },
-  "gitHead": "cb15bfd6a018f18a335cb8e7e755d1533767dcd4"
+  "gitHead": "792b9deb17d69d86a8ed6f9ec4e9b3f453bcb3e8"
 }

package/src/MobileClient.ts

@@ -4,6 +4,7 @@ import {
 } from '@nadohq/shared';
 import axios, { AxiosInstance, AxiosResponse } from 'axios';
 import {
+  mapMobileFeedPage,
   mapMobileIdentity,
   mapMobileNotificationPreferences,
   mapMobileNotificationPreferencesToServer,
@@ -17,12 +18,14 @@ import {
   MobileSignedRequest,
 } from './signing';
 import {
+  GetMobileFeedParams,
   GetMobileNotificationPreferencesParams,
   GetMobilePublicProfileParams,
   GetMobileRegisteredDevicesParams,
   GetMobileSelfIdentityParams,
   GetMobileUsernameAvailabilityParams,
   MobileClaimUsernameParams,
+  MobileFeedPage,
   MobileIdentity,
   MobileNotificationPreferences,
   MobilePublicProfile,
@@ -39,14 +42,15 @@ import { MobileServerFailureError } from './types/MobileServerFailureError';
 import { MobileServerSuccessResponse } from './types/serverBaseTypes';
 import { MobileServerExecuteResult } from './types/serverExecuteTypes';
 import {
-  MobileServerNotificationPreferencesResponse,
-  MobileServerProfileRequest,
-  MobileServerProfileResponse,
-  MobileServerRegisteredDevicesResponse,
-  MobileServerSelfIdentityResponse,
-  MobileServerUsernameAvailabilityRequest,
-  MobileServerUsernameAvailabilityResponse,
+  MobileServerPublicQueryRequest,
+  MobileServerPublicQuerySuccessResponse,
+  MobileServerSignedQuerySuccessResponse,
 } from './types/serverQueryTypes';
+import {
+  MobileServerPublicQueryRequestByType,
+  MobileServerPublicQueryRequestType,
+  MobileServerSignedQueryRequestType,
+} from './types/serverRequestTypes';
 import {
   isMobileServerFailureResponse,
   isMobileServerSuccessResponse,
@@ -108,12 +112,11 @@ export class MobileClient {
   async getUsernameAvailability(
     params: GetMobileUsernameAvailabilityParams,
   ): Promise<MobileUsernameAvailability> {
-    const body: MobileServerUsernameAvailabilityRequest = {
+    const body: MobileServerPublicQueryRequest<'username_availability'> = {
       type: 'username_availability',
       display_name: params.displayName,
     };
-    const data =
-      await this.publicQuery<MobileServerUsernameAvailabilityResponse>(body);
+    const data = await this.publicQuery(body);
     return { username: data.username, available: data.available };
   }
 
@@ -126,14 +129,36 @@ export class MobileClient {
   async getPublicProfile(
     params: GetMobilePublicProfileParams,
   ): Promise<MobilePublicProfile> {
-    const body: MobileServerProfileRequest = {
+    const body: MobileServerPublicQueryRequest<'profile'> = {
       type: 'profile',
       username: params.username,
     };
-    const data = await this.publicQuery<MobileServerProfileResponse>(body);
+    const data = await this.publicQuery(body);
     return mapMobilePublicProfile(data.profile);
   }
 
+  /**
+   * Fetches a page of the global trade feed: public, named, perpetual trades, newest first, optionally
+   * filtered by a whole-dollar minimum notional (omitted means unfiltered). The feed is best-effort rather
+   * than authoritative history, and pagination is live (not snapshot), so deduplicate pages by
+   * {@link MobileFeedTrade.orderDigest}.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_FEED_FILTER` if `minimumNotional` or
+   * `limit` is outside its allowed domain (fix the request; do not retry unchanged), or
+   * `INVALID_FEED_CURSOR` if the cursor is malformed or was issued for a different `minimumNotional`
+   * (discard the cursor and restart from the first page).
+   */
+  async getFeed(params: GetMobileFeedParams = {}): Promise<MobileFeedPage> {
+    const body: MobileServerPublicQueryRequest<'feed'> = {
+      type: 'feed',
+      minimum_notional: params.minimumNotional,
+      limit: params.limit,
+      cursor: params.cursor,
+    };
+    const data = await this.publicQuery(body);
+    return mapMobileFeedPage(data);
+  }
+
   /*
   Signed queries
    */
@@ -150,8 +175,7 @@ export class MobileClient {
       params,
       {},
     );
-    const data =
-      await this.query<MobileServerSelfIdentityResponse>(signedRequest);
+    const data = await this.query<'self_identity'>(signedRequest);
     return data.identity ? mapMobileIdentity(data.identity) : null;
   }
 
@@ -167,10 +191,7 @@ export class MobileClient {
       params,
       {},
     );
-    const data =
-      await this.query<MobileServerNotificationPreferencesResponse>(
-        signedRequest,
-      );
+    const data = await this.query<'notification_preferences'>(signedRequest);
     return mapMobileNotificationPreferences(data.preferences);
   }
 
@@ -185,8 +206,7 @@ export class MobileClient {
       params,
       {},
     );
-    const data =
-      await this.query<MobileServerRegisteredDevicesResponse>(signedRequest);
+    const data = await this.query<'registered_devices'>(signedRequest);
     return data.devices.map(mapMobileRegisteredDevice);
   }
 
@@ -318,9 +338,11 @@ export class MobileClient {
     return buildSignedMobileRequest({ ...params, walletClient, inner });
   }
 
-  protected async publicQuery<TResponse extends { status: 'success' }>(
-    body: object,
-  ): Promise<TResponse> {
+  // Spelled out as an intersection rather than `MobileServerPublicQueryRequest<T>`: the latter is an indexed
+  // access on a mapped type, which is not an inference site, so `T` would always widen to the full union.
+  protected async publicQuery<T extends MobileServerPublicQueryRequestType>(
+    body: { type: T } & MobileServerPublicQueryRequestByType[T],
+  ): Promise<MobileServerPublicQuerySuccessResponse<T>> {
     const response = await this.axiosInstance.post<unknown>(
       `${this.opts.url}/mobile/public_query`,
       body,
@@ -330,12 +352,12 @@ export class MobileClient {
     this.checkServerStatus(response);
 
     // checkServerStatus throws on failure responses so the cast to the success response is acceptable here
-    return response.data as TResponse;
+    return response.data as MobileServerPublicQuerySuccessResponse<T>;
   }
 
-  protected async query<TResponse extends { status: 'success' }>(
+  protected async query<T extends MobileServerSignedQueryRequestType>(
     body: MobileSignedRequest,
-  ): Promise<TResponse> {
+  ): Promise<MobileServerSignedQuerySuccessResponse<T>> {
     const response = await this.axiosInstance.post<unknown>(
       `${this.opts.url}/mobile/query`,
       body,
@@ -345,7 +367,7 @@ export class MobileClient {
     this.checkServerStatus(response);
 
     // checkServerStatus throws on failure responses so the cast to the success response is acceptable here
-    return response.data as TResponse;
+    return response.data as MobileServerSignedQuerySuccessResponse<T>;
   }
 
   protected async execute(

package/src/dataMappers.ts

@@ -1,4 +1,6 @@
 import {
+  MobileFeedPage,
+  MobileFeedTrade,
   MobileIdentity,
   MobileNotificationPreferenceScope,
   MobileNotificationPreferences,
@@ -6,12 +8,14 @@ import {
   MobileRegisteredDevice,
 } from './types/clientTypes';
 import {
+  MobileServerFeedTrade,
   MobileServerIdentity,
   MobileServerNotificationPreferenceScope,
   MobileServerNotificationPreferences,
   MobileServerProfile,
   MobileServerRegisteredDevice,
 } from './types/serverModelTypes';
+import { MobileServerFeedResponse } from './types/serverQueryTypes';
 
 /**
  * Maps a server-side identity (snake_case) to its client-side (camelCase) representation.
@@ -90,6 +94,42 @@ function mapMobileNotificationPreferenceScopeToServer(
   return { type: 'product', product_id: scope.productId };
 }
 
+/**
+ * Maps a server-side feed trade (snake_case) to its client-side (camelCase) representation.
+ */
+function mapMobileFeedTrade(server: MobileServerFeedTrade): MobileFeedTrade {
+  return {
+    orderDigest: server.order_digest,
+    subaccount: server.subaccount,
+    username: server.username,
+    displayName: server.display_name,
+    avatarUrl: server.avatar_url,
+    productId: server.product_id,
+    quantity: server.quantity,
+    notional: server.notional,
+    averagePrice: server.average_price,
+    margin: {
+      mode: server.margin.mode,
+      estimatedLeverage: server.margin.estimated_leverage,
+    },
+    position: server.position,
+    realizedPnl: server.realized_pnl,
+    filledAt: server.filled_at_ms,
+  };
+}
+
+/**
+ * Maps a server-side feed response to a client-side {@link MobileFeedPage}.
+ */
+export function mapMobileFeedPage(
+  server: MobileServerFeedResponse,
+): MobileFeedPage {
+  return {
+    trades: server.trades.map(mapMobileFeedTrade),
+    nextCursor: server.next_cursor,
+  };
+}
+
 /**
  * Maps a server-side registered device (snake_case) to its client-side (camelCase) representation.
  */

package/src/types/MobileServerFailureError.ts

@@ -1,8 +1,6 @@
 import { BaseServerFailureError } from '@nadohq/shared';
-import {
-  MobileServerFailureResponse,
-  MobileServerRequestType,
-} from './serverBaseTypes';
+import { MobileServerFailureResponse } from './serverBaseTypes';
+import { MobileServerRequestType } from './serverRequestTypes';
 
 /**
  * Error thrown when the mobile service API returns a failure envelope, either as a non-2xx HTTP response

package/src/types/clientTypes.ts

@@ -1,6 +1,8 @@
 import { SignatureParams, Subaccount } from '@nadohq/shared';
 import { Hex } from 'viem';
 import {
+  MobileFeedMarginMode,
+  MobileFeedTradePosition,
   MobileNotificationCategory,
   MobileNotificationPlatform,
 } from './serverModelTypes';
@@ -44,6 +46,56 @@ export interface MobileUsernameAvailability {
   available: boolean;
 }
 
+/**
+ * Margin of a feed trade. Branch on `mode` — do not infer isolated state from leverage presence:
+ * `estimatedLeverage` (a rounded whole-number estimate, not exact submitted leverage) is `undefined` on
+ * `cross`, and also `undefined` inside `isolated` when no estimate is available.
+ */
+export interface MobileFeedMargin {
+  mode: MobileFeedMarginMode;
+  estimatedLeverage?: number;
+}
+
+/**
+ * A single feed trade: one row per order digest, enriched with the trader's current identity at read time
+ * (a rename can change an already-fetched trade on the next read). Amounts are display-oriented human-unit
+ * numbers — do not use them for accounting, order construction, or exact threshold decisions.
+ */
+export interface MobileFeedTrade {
+  /** Order digest this trade is keyed by; the stable id for reconciling live pagination. */
+  orderDigest: Hex;
+  subaccount: Hex;
+  username: string;
+  displayName: string;
+  /** Reserved for a future avatar source; `null` until one is implemented. */
+  avatarUrl: string | null;
+  productId: number;
+  /** Executed quantity in human units. */
+  quantity: number;
+  /** Trade notional in whole-dollar human units. */
+  notional: number;
+  /** Average execution price in human units. */
+  averagePrice: number;
+  margin: MobileFeedMargin;
+  /** Resulting position change. `position.direction` is NOT the execution buy/sell side. */
+  position: MobileFeedTradePosition;
+  /** Realized PnL of the trade in human units; can be negative. */
+  realizedPnl: number;
+  /** Fill time as a Unix timestamp (milliseconds). */
+  filledAt: number;
+}
+
+/**
+ * A page of feed trades. `nextCursor` is `null` when there was no additional candidate at query time.
+ * Pagination is live, not snapshot, so a later fill can move a trade between pages — deduplicate by
+ * {@link MobileFeedTrade.orderDigest} and treat the merged list as a short-lived view, not an authoritative
+ * cache (removals from Private Mode or blacklists are not signaled).
+ */
+export interface MobileFeedPage {
+  trades: MobileFeedTrade[];
+  nextCursor: string | null;
+}
+
 /**
  * Scope limiting a notification category preference. Scopes are part of the wire format but rejected by the
  * backend for the MVP — `scopes` must be empty.
@@ -112,6 +164,24 @@ export interface GetMobilePublicProfileParams {
   username: string;
 }
 
+/**
+ * Params for {@link MobileClient.getFeed}.
+ */
+export interface GetMobileFeedParams {
+  /**
+   * Minimum notional filter as a whole-dollar safe integer, at least `MOBILE_FEED_MIN_NOTIONAL_FLOOR`
+   * ($1,000). Omit for the unfiltered feed.
+   */
+  minimumNotional?: number;
+  /** Page size, 1–`MOBILE_FEED_MAX_PAGE_SIZE` (50); the backend defaults to 50 when omitted. */
+  limit?: number;
+  /**
+   * Opaque keyset cursor from a prior page's {@link MobileFeedPage.nextCursor}. Send it back unchanged with
+   * the exact same `minimumNotional` it was issued for.
+   */
+  cursor?: string;
+}
+
 /**
  * Params for {@link MobileClient.getSelfIdentity}.
  */

package/src/types/index.ts

@@ -5,3 +5,4 @@ export * from './serverBaseTypes';
 export * from './serverExecuteTypes';
 export * from './serverModelTypes';
 export * from './serverQueryTypes';
+export * from './serverRequestTypes';

package/src/types/mobileErrorCodes.ts

@@ -1,9 +1,9 @@
 import { NADO_ERROR_CODES } from '@nadohq/shared';
 
 /**
- * Numeric error codes returned by the mobile service API. Identity codes (61xx) and notification codes
- * (62xx) are mobile-specific; the remaining codes are shared cross-service codes from the backend's common
- * error enum, inlined via spread from {@link NADO_ERROR_CODES}.
+ * Numeric error codes returned by the mobile service API. Identity codes (61xx), notification codes (62xx),
+ * and feed codes (63xx) are mobile-specific; the remaining codes are shared cross-service codes from the
+ * backend's common error enum, inlined via spread from {@link NADO_ERROR_CODES}.
  */
 export const MOBILE_ERROR_CODES = {
   ...NADO_ERROR_CODES,
@@ -17,6 +17,10 @@ export const MOBILE_ERROR_CODES = {
   INVALID_EXPO_TOKEN: 6200,
   INVALID_DEVICE_METADATA: 6201,
   INVALID_PREFERENCES: 6202,
+  /** Feed `minimumNotional` or `limit` is outside its allowed domain. Fix the request; do not retry unchanged. */
+  INVALID_FEED_FILTER: 6300,
+  /** Feed cursor is malformed or bound to a different filter. Discard it and restart from the first page. */
+  INVALID_FEED_CURSOR: 6301,
 } as const;
 
 /**