@nadohq/mobile-client 0.28.0 → 0.30.0

package/dist/{MobileClient-9JSAzblH.cjs → MobileClient-CfDtaEeL.cjs}

@@ -76,6 +76,26 @@ var MobileClient = class {
 		return require_dataMappers.mapMobilePublicProfile((await this.publicQuery(body)).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 = {}) {
+		const body = {
+			type: "feed",
+			minimum_notional: params.minimumNotional,
+			limit: params.limit,
+			cursor: params.cursor
+		};
+		return require_dataMappers.mapMobileFeedPage(await this.publicQuery(body));
+	}
+	/**
 	* Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a
 	* username yet — this is normal data, not an error.
 	*/
@@ -215,4 +235,4 @@ Object.defineProperty(exports, "__toESM", {
 	}
 });
 
-//# sourceMappingURL=MobileClient-9JSAzblH.cjs.map
+//# sourceMappingURL=MobileClient-CfDtaEeL.cjs.map

package/dist/MobileClient-CfDtaEeL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileClient-CfDtaEeL.cjs","names":["mapMobilePublicProfile","mapMobileFeedPage","mapMobileIdentity","mapMobileNotificationPreferences","mapMobileRegisteredDevice","mapMobileNotificationPreferencesToServer","WalletNotProvidedError","buildSignedMobileRequest","isMobileServerFailureResponse","MobileServerFailureError","isMobileServerSuccessResponse"],"sources":["../src/MobileClient.ts"],"sourcesContent":["import {\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  mapMobileFeedPage,\n  mapMobileIdentity,\n  mapMobileNotificationPreferences,\n  mapMobileNotificationPreferencesToServer,\n  mapMobilePublicProfile,\n  mapMobileRegisteredDevice,\n} from './dataMappers';\nimport {\n  buildSignedMobileRequest,\n  MobileSignedInner,\n  MobileSignedInnerParams,\n  MobileSignedRequest,\n} from './signing';\nimport {\n  GetMobileFeedParams,\n  GetMobileNotificationPreferencesParams,\n  GetMobilePublicProfileParams,\n  GetMobileRegisteredDevicesParams,\n  GetMobileSelfIdentityParams,\n  GetMobileUsernameAvailabilityParams,\n  MobileClaimUsernameParams,\n  MobileFeedPage,\n  MobileIdentity,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredDevice,\n  MobileRegisterExpoTokenParams,\n  MobileSetPrivateModeParams,\n  MobileSignedRequestParams,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUpdateUsernameParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport { MobileServerExecuteResult } from './types/serverExecuteTypes';\nimport {\n  MobileServerPublicQueryRequest,\n  MobileServerPublicQuerySuccessResponse,\n  MobileServerSignedQuerySuccessResponse,\n} from './types/serverQueryTypes';\nimport {\n  MobileServerPublicQueryRequestByType,\n  MobileServerPublicQueryRequestType,\n  MobileServerSignedQueryRequestType,\n} from './types/serverRequestTypes';\nimport {\n  isMobileServerFailureResponse,\n  isMobileServerSuccessResponse,\n} from './utils/serverResponseGuards';\n\n/**\n * Options for constructing a {@link MobileClient}.\n */\nexport interface MobileClientOpts {\n  /**\n   * Base URL of the mobile service API, e.g. {@link MOBILE_CLIENT_ENDPOINTS}.\n   */\n  url: string;\n  /**\n   * Wallet client used to sign requests.\n   */\n  walletClient?: WalletClientWithAccount;\n  /**\n   * If provided, this signer is used instead of `walletClient` for all signed requests.\n   */\n  linkedSignerWalletClient?: WalletClientWithAccount;\n}\n\n/**\n * Client for the Nado mobile service API: username claims, public profile lookups, privacy settings, and\n * push notification device/preference management.\n */\nexport class MobileClient {\n  readonly opts: MobileClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: MobileClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n    });\n  }\n\n  /**\n   * Sets the linked signer for requests\n   *\n   * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer\n   */\n  public setLinkedSigner(\n    linkedSignerWalletClient: WalletClientWithAccount | null,\n  ) {\n    this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? undefined;\n  }\n\n  /*\n  Public queries\n   */\n\n  /**\n   * Checks whether a username derived from the given display name is available to claim.\n   */\n  async getUsernameAvailability(\n    params: GetMobileUsernameAvailabilityParams,\n  ): Promise<MobileUsernameAvailability> {\n    const body: MobileServerPublicQueryRequest<'username_availability'> = {\n      type: 'username_availability',\n      display_name: params.displayName,\n    };\n    const data = await this.publicQuery(body);\n    return { username: data.username, available: data.available };\n  }\n\n  /**\n   * Looks up a subaccount's public profile by username.\n   *\n   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if no identity has claimed the\n   * username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.\n   */\n  async getPublicProfile(\n    params: GetMobilePublicProfileParams,\n  ): Promise<MobilePublicProfile> {\n    const body: MobileServerPublicQueryRequest<'profile'> = {\n      type: 'profile',\n      username: params.username,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobilePublicProfile(data.profile);\n  }\n\n  /**\n   * Fetches a page of the global trade feed: public, named, perpetual trades, newest first, optionally\n   * filtered by a whole-dollar minimum notional (omitted means unfiltered). The feed is best-effort rather\n   * than authoritative history, and pagination is live (not snapshot), so deduplicate pages by\n   * {@link MobileFeedTrade.orderDigest}.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_FEED_FILTER` if `minimumNotional` or\n   * `limit` is outside its allowed domain (fix the request; do not retry unchanged), or\n   * `INVALID_FEED_CURSOR` if the cursor is malformed or was issued for a different `minimumNotional`\n   * (discard the cursor and restart from the first page).\n   */\n  async getFeed(params: GetMobileFeedParams = {}): Promise<MobileFeedPage> {\n    const body: MobileServerPublicQueryRequest<'feed'> = {\n      type: 'feed',\n      minimum_notional: params.minimumNotional,\n      limit: params.limit,\n      cursor: params.cursor,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileFeedPage(data);\n  }\n\n  /*\n  Signed queries\n   */\n\n  /**\n   * Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a\n   * username yet — this is normal data, not an error.\n   */\n  async getSelfIdentity(\n    params: GetMobileSelfIdentityParams,\n  ): Promise<MobileIdentity | null> {\n    const signedRequest = await this.getSignedRequest(\n      'self_identity',\n      params,\n      {},\n    );\n    const data = await this.query<'self_identity'>(signedRequest);\n    return data.identity ? mapMobileIdentity(data.identity) : null;\n  }\n\n  /**\n   * Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has\n   * never updated its preferences.\n   */\n  async getNotificationPreferences(\n    params: GetMobileNotificationPreferencesParams,\n  ): Promise<MobileNotificationPreferences> {\n    const signedRequest = await this.getSignedRequest(\n      'notification_preferences',\n      params,\n      {},\n    );\n    const data = await this.query<'notification_preferences'>(signedRequest);\n    return mapMobileNotificationPreferences(data.preferences);\n  }\n\n  /**\n   * Fetches the devices registered for push notifications for a wallet.\n   */\n  async getRegisteredDevices(\n    params: GetMobileRegisteredDevicesParams,\n  ): Promise<MobileRegisteredDevice[]> {\n    const signedRequest = await this.getSignedRequest(\n      'registered_devices',\n      params,\n      {},\n    );\n    const data = await this.query<'registered_devices'>(signedRequest);\n    return data.devices.map(mapMobileRegisteredDevice);\n  }\n\n  /*\n  Signed executes\n   */\n\n  /**\n   * Claims a username for a subaccount, derived from the given display name.\n   */\n  async claimUsername(\n    params: MobileClaimUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'claim_username',\n      params,\n      {\n        display_name: params.displayName,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Updates the display name for a subaccount's already-claimed identity.\n   */\n  async updateUsername(\n    params: MobileUpdateUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_username',\n      params,\n      { display_name: params.displayName },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Sets whether a subaccount's profile is private.\n   */\n  async setPrivateMode(\n    params: MobileSetPrivateModeParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'set_private_mode',\n      params,\n      { private_mode: params.privateMode },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Registers an Expo push token for the wallet, transferring active ownership of the token if another\n   * wallet had registered it. Idempotent per `(wallet, token)`.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is not a valid Expo\n   * push token, or `INVALID_DEVICE_METADATA` if `locale` (max 35 chars) or `appVersion` (max 64 chars) is\n   * too long.\n   */\n  async registerExpoToken(\n    params: MobileRegisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'register_expo_token',\n      params,\n      {\n        expo_token: params.expoToken,\n        platform: params.platform,\n        locale: params.locale ?? null,\n        app_version: params.appVersion ?? null,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.\n   */\n  async unregisterExpoToken(\n    params: MobileUnregisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'unregister_expo_token',\n      params,\n      { expo_token: params.expoToken },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Replaces the wallet's push notification preferences. The backend requires `schemaVersion` of 1, exactly\n   * one entry per known category, and empty `scopes` on every entry.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated.\n   */\n  async updateNotificationPreferences(\n    params: MobileUpdateNotificationPreferencesParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_preferences',\n      params,\n      {\n        preferences: mapMobileNotificationPreferencesToServer(\n          params.preferences,\n        ),\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /*\n  Base Fns\n   */\n\n  protected async getSignedRequest<T extends MobileSignedInner['type']>(\n    type: T,\n    params: MobileSignedRequestParams,\n    innerParams: MobileSignedInnerParams<T>,\n  ): Promise<MobileSignedRequest> {\n    // Use the linked signer if provided, otherwise use the default signer provided to the client\n    const walletClient =\n      this.opts.linkedSignerWalletClient ?? this.opts.walletClient;\n\n    if (walletClient == null) {\n      throw new WalletNotProvidedError();\n    }\n\n    const inner = { type, ...innerParams } as MobileSignedInner;\n    return buildSignedMobileRequest({ ...params, walletClient, inner });\n  }\n\n  // Spelled out as an intersection rather than `MobileServerPublicQueryRequest<T>`: the latter is an indexed\n  // access on a mapped type, which is not an inference site, so `T` would always widen to the full union.\n  protected async publicQuery<T extends MobileServerPublicQueryRequestType>(\n    body: { type: T } & MobileServerPublicQueryRequestByType[T],\n  ): Promise<MobileServerPublicQuerySuccessResponse<T>> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/public_query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as MobileServerPublicQuerySuccessResponse<T>;\n  }\n\n  protected async query<T extends MobileServerSignedQueryRequestType>(\n    body: MobileSignedRequest,\n  ): Promise<MobileServerSignedQuerySuccessResponse<T>> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as MobileServerSignedQuerySuccessResponse<T>;\n  }\n\n  protected async execute(\n    body: MobileSignedRequest,\n  ): Promise<MobileServerSuccessResponse> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/mobile/execute`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as MobileServerSuccessResponse;\n  }\n\n  /**\n   * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns\n   * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a\n   * failure envelope still throws the typed error; anything else is a transport-level error.\n   */\n  private checkResponseStatus(response: AxiosResponse<unknown>) {\n    if (response.status >= 200 && response.status < 300) {\n      return;\n    }\n    if (isMobileServerFailureResponse(response.data)) {\n      throw new MobileServerFailureError(response.data, response.status);\n    }\n    throw new Error(\n      `Unexpected response from mobile service: ${response.status} ${response.statusText}. Data: ${JSON.stringify(response.data)}`,\n    );\n  }\n\n  private checkServerStatus(response: AxiosResponse<unknown>) {\n    const { data } = response;\n\n    if (isMobileServerFailureResponse(data)) {\n      throw new MobileServerFailureError(data, response.status);\n    }\n    if (!isMobileServerSuccessResponse(data)) {\n      throw new Error(\n        `Unexpected response from mobile service: missing success envelope. Data: ${JSON.stringify(data)}`,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/MobileClient.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_MobileClient = require("./MobileClient-9JSAzblH.cjs");
+const require_MobileClient = require("./MobileClient-CfDtaEeL.cjs");
 require("./signing/index.cjs");
 exports.MobileClient = require_MobileClient.MobileClient;

package/dist/MobileClient.d.cts

@@ -1,6 +1,8 @@
-import { _ as MobileUpdateNotificationPreferencesParams, a as GetMobileUsernameAvailabilityParams, d as MobilePublicProfile, f as MobileRegisterExpoTokenParams, g as MobileUnregisterExpoTokenParams, h as MobileSignedRequestParams, i as GetMobileSelfIdentityParams, m as MobileSetPrivateModeParams, n as GetMobilePublicProfileParams, o as MobileClaimUsernameParams, p as MobileRegisteredDevice, r as GetMobileRegisteredDevicesParams, s as MobileIdentity, t as GetMobileNotificationPreferencesParams, u as MobileNotificationPreferences, v as MobileUpdateUsernameParams, y as MobileUsernameAvailability } from "./clientTypes-Et0PUa2d.cjs";
-import { i as MobileSignedRequest, n as MobileSignedInner, r as MobileSignedInnerParams } from "./types-uCD4BNZR.cjs";
-import { a as MobileServerSuccessResponse } from "./serverBaseTypes-BicXMrZV.cjs";
+import { C as MobileUsernameAvailability, S as MobileUpdateUsernameParams, _ as MobileRegisteredDevice, a as GetMobileSelfIdentityParams, b as MobileUnregisterExpoTokenParams, d as MobileIdentity, g as MobileRegisterExpoTokenParams, h as MobilePublicProfile, i as GetMobileRegisteredDevicesParams, l as MobileFeedPage, m as MobileNotificationPreferences, n as GetMobileNotificationPreferencesParams, o as GetMobileUsernameAvailabilityParams, r as GetMobilePublicProfileParams, s as MobileClaimUsernameParams, t as GetMobileFeedParams, v as MobileSetPrivateModeParams, x as MobileUpdateNotificationPreferencesParams, y as MobileSignedRequestParams } from "./clientTypes-UFInIAQd.cjs";
+import { i as MobileSignedRequest, n as MobileSignedInner, r as MobileSignedInnerParams } from "./types-CzOeSYnW.cjs";
+import { n as MobileServerPublicQueryRequestByType, o as MobileServerSignedQueryRequestType, r as MobileServerPublicQueryRequestType } from "./serverRequestTypes-DnU_FfMI.cjs";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-A16onlPN.cjs";
+import { o as MobileServerPublicQuerySuccessResponse, u as MobileServerSignedQuerySuccessResponse } from "./serverQueryTypes-C_cCx0Ac.cjs";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -47,6 +49,18 @@ declare class MobileClient {
    * username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.
    */
   getPublicProfile(params: GetMobilePublicProfileParams): Promise<MobilePublicProfile>;
+  /**
+   * 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).
+   */
+  getFeed(params?: GetMobileFeedParams): Promise<MobileFeedPage>;
   /**
    * Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a
    * username yet — this is normal data, not an error.
@@ -94,12 +108,10 @@ declare class MobileClient {
    */
   updateNotificationPreferences(params: MobileUpdateNotificationPreferencesParams): Promise<MobileServerSuccessResponse>;
   protected getSignedRequest<T extends MobileSignedInner['type']>(type: T, params: MobileSignedRequestParams, innerParams: MobileSignedInnerParams<T>): Promise<MobileSignedRequest>;
-  protected publicQuery<TResponse extends {
-    status: 'success';
-  }>(body: object): Promise<TResponse>;
-  protected query<TResponse extends {
-    status: 'success';
-  }>(body: MobileSignedRequest): Promise<TResponse>;
+  protected publicQuery<T extends MobileServerPublicQueryRequestType>(body: {
+    type: T;
+  } & MobileServerPublicQueryRequestByType[T]): Promise<MobileServerPublicQuerySuccessResponse<T>>;
+  protected query<T extends MobileServerSignedQueryRequestType>(body: MobileSignedRequest): Promise<MobileServerSignedQuerySuccessResponse<T>>;
   protected execute(body: MobileSignedRequest): Promise<MobileServerSuccessResponse>;
   /**
    * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns

package/dist/MobileClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;UAyDiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAImC;AAAA;AAOpD;EAPE,wBAAA,GAA2B,uBAAuB;AAAA;;;;;cAOvC,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EA+CP;;;;;EAjCJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAoEjB;;;EAxDL,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAwER;;;;;;EAxDG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,mBAAA;EAuGD;;;;EAtFJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,cAAA;EAwGR;;;;EAzFG,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EA2HA;;;EA3GL,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,sBAAA;EA4HD;;;EA1GJ,aAAA,CACJ,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,2BAAA;EA0GR;;;EA5FG,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAwHA;;;EA5GL,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAyHR;;;;;;;;EAxGG,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EA1KC;;;EA2LN,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAlKL;;;;;;EAiLA,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAAA,UAiBK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA;EAAA,UAaK,WAAA;IAAgC,MAAA;EAAA,EAAA,CAC9C,IAAA,WACC,OAAA,CAAQ,SAAA;EAAA,UAaK,KAAA;IAA0B,MAAA;EAAA,EAAA,CACxC,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,SAAA;EAAA,UAaK,OAAA,CACd,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,2BAAA;EA/LL;;;;;EAAA,QAiNE,mBAAA;EAAA,QAYA,iBAAA;AAAA"}
+{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;UA6DiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAImC;AAAA;AAOpD;EAPE,wBAAA,GAA2B,uBAAuB;AAAA;;;;;cAOvC,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EA8CP;;;;;EAhCJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAwEjB;;;EA5DL,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EA0ER;;;;;;EA3DG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,mBAAA;EA0GD;;;;;;;;;;;EAtFJ,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EA2J/C;;;;EAxIJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,cAAA;EA0JD;;;;EA5IJ,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EA2J2B;;;EA9IhC,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,sBAAA;EA8IuC;;;EA7H5C,aAAA,CACJ,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,2BAAA;EAyIH;;;EA3HF,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAwIH;;;EA5HF,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EA2HD;;;;;;;;EA1GJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EA3KiB;;;EA4LtB,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAjLT;;;;;;EAgMI,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAAA,UAiBK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA;EAAA,UAeK,WAAA,WAAsB,kCAAA,CAAA,CACpC,IAAA;IAAQ,IAAA,EAAM,CAAA;EAAA,IAAM,oCAAA,CAAqC,CAAA,IACxD,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,KAAA,WAAgB,kCAAA,CAAA,CAC9B,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,OAAA,CACd,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,2BAAA;EA7ML;;;;;EAAA,QA+NE,mBAAA;EAAA,QAYA,iBAAA;AAAA"}

package/dist/MobileClient.d.ts

@@ -1,6 +1,8 @@
-import { _ as MobileUpdateNotificationPreferencesParams, a as GetMobileUsernameAvailabilityParams, d as MobilePublicProfile, f as MobileRegisterExpoTokenParams, g as MobileUnregisterExpoTokenParams, h as MobileSignedRequestParams, i as GetMobileSelfIdentityParams, m as MobileSetPrivateModeParams, n as GetMobilePublicProfileParams, o as MobileClaimUsernameParams, p as MobileRegisteredDevice, r as GetMobileRegisteredDevicesParams, s as MobileIdentity, t as GetMobileNotificationPreferencesParams, u as MobileNotificationPreferences, v as MobileUpdateUsernameParams, y as MobileUsernameAvailability } from "./clientTypes-DWW2N66c.js";
-import { i as MobileSignedRequest, n as MobileSignedInner, r as MobileSignedInnerParams } from "./types-B76Pn7Sy.js";
-import { a as MobileServerSuccessResponse } from "./serverBaseTypes-ewbo8l4R.js";
+import { C as MobileUsernameAvailability, S as MobileUpdateUsernameParams, _ as MobileRegisteredDevice, a as GetMobileSelfIdentityParams, b as MobileUnregisterExpoTokenParams, d as MobileIdentity, g as MobileRegisterExpoTokenParams, h as MobilePublicProfile, i as GetMobileRegisteredDevicesParams, l as MobileFeedPage, m as MobileNotificationPreferences, n as GetMobileNotificationPreferencesParams, o as GetMobileUsernameAvailabilityParams, r as GetMobilePublicProfileParams, s as MobileClaimUsernameParams, t as GetMobileFeedParams, v as MobileSetPrivateModeParams, x as MobileUpdateNotificationPreferencesParams, y as MobileSignedRequestParams } from "./clientTypes-BsOps_pY.js";
+import { i as MobileSignedRequest, n as MobileSignedInner, r as MobileSignedInnerParams } from "./types-UHjZR-js.js";
+import { n as MobileServerPublicQueryRequestByType, o as MobileServerSignedQueryRequestType, r as MobileServerPublicQueryRequestType } from "./serverRequestTypes-DQDy3K9O.js";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-m3zEi0X9.js";
+import { o as MobileServerPublicQuerySuccessResponse, u as MobileServerSignedQuerySuccessResponse } from "./serverQueryTypes-CJLWWZBs.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -47,6 +49,18 @@ declare class MobileClient {
    * username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.
    */
   getPublicProfile(params: GetMobilePublicProfileParams): Promise<MobilePublicProfile>;
+  /**
+   * 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).
+   */
+  getFeed(params?: GetMobileFeedParams): Promise<MobileFeedPage>;
   /**
    * Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a
    * username yet — this is normal data, not an error.
@@ -94,12 +108,10 @@ declare class MobileClient {
    */
   updateNotificationPreferences(params: MobileUpdateNotificationPreferencesParams): Promise<MobileServerSuccessResponse>;
   protected getSignedRequest<T extends MobileSignedInner['type']>(type: T, params: MobileSignedRequestParams, innerParams: MobileSignedInnerParams<T>): Promise<MobileSignedRequest>;
-  protected publicQuery<TResponse extends {
-    status: 'success';
-  }>(body: object): Promise<TResponse>;
-  protected query<TResponse extends {
-    status: 'success';
-  }>(body: MobileSignedRequest): Promise<TResponse>;
+  protected publicQuery<T extends MobileServerPublicQueryRequestType>(body: {
+    type: T;
+  } & MobileServerPublicQueryRequestByType[T]): Promise<MobileServerPublicQuerySuccessResponse<T>>;
+  protected query<T extends MobileServerSignedQueryRequestType>(body: MobileSignedRequest): Promise<MobileServerSignedQuerySuccessResponse<T>>;
   protected execute(body: MobileSignedRequest): Promise<MobileServerSuccessResponse>;
   /**
    * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns

package/dist/MobileClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;UAyDiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAImC;AAAA;AAOpD;EAPE,wBAAA,GAA2B,uBAAuB;AAAA;;;;;cAOvC,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EA+CP;;;;;EAjCJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAoEjB;;;EAxDL,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAwER;;;;;;EAxDG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,mBAAA;EAuGD;;;;EAtFJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,cAAA;EAwGR;;;;EAzFG,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EA2HA;;;EA3GL,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,sBAAA;EA4HD;;;EA1GJ,aAAA,CACJ,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,2BAAA;EA0GR;;;EA5FG,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAwHA;;;EA5GL,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAyHR;;;;;;;;EAxGG,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EA1KC;;;EA2LN,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAlKL;;;;;;EAiLA,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAAA,UAiBK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA;EAAA,UAaK,WAAA;IAAgC,MAAA;EAAA,EAAA,CAC9C,IAAA,WACC,OAAA,CAAQ,SAAA;EAAA,UAaK,KAAA;IAA0B,MAAA;EAAA,EAAA,CACxC,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,SAAA;EAAA,UAaK,OAAA,CACd,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,2BAAA;EA/LL;;;;;EAAA,QAiNE,mBAAA;EAAA,QAYA,iBAAA;AAAA"}
+{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;UA6DiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAImC;AAAA;AAOpD;EAPE,wBAAA,GAA2B,uBAAuB;AAAA;;;;;cAOvC,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EA8CP;;;;;EAhCJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAwEjB;;;EA5DL,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EA0ER;;;;;;EA3DG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,mBAAA;EA0GD;;;;;;;;;;;EAtFJ,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EA2J/C;;;;EAxIJ,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,cAAA;EA0JD;;;;EA5IJ,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EA2J2B;;;EA9IhC,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,sBAAA;EA8IuC;;;EA7H5C,aAAA,CACJ,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,2BAAA;EAyIH;;;EA3HF,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAwIH;;;EA5HF,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EA2HD;;;;;;;;EA1GJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EA3KiB;;;EA4LtB,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAjLT;;;;;;EAgMI,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAAA,UAiBK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA;EAAA,UAeK,WAAA,WAAsB,kCAAA,CAAA,CACpC,IAAA;IAAQ,IAAA,EAAM,CAAA;EAAA,IAAM,oCAAA,CAAqC,CAAA,IACxD,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,KAAA,WAAgB,kCAAA,CAAA,CAC9B,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,OAAA,CACd,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,2BAAA;EA7ML;;;;;EAAA,QA+NE,mBAAA;EAAA,QAYA,iBAAA;AAAA"}

package/dist/MobileClient.js

@@ -1,4 +1,4 @@
-import { mapMobileIdentity, mapMobileNotificationPreferences, mapMobileNotificationPreferencesToServer, mapMobilePublicProfile, mapMobileRegisteredDevice } from "./dataMappers.js";
+import { mapMobileFeedPage, mapMobileIdentity, mapMobileNotificationPreferences, mapMobileNotificationPreferencesToServer, mapMobilePublicProfile, mapMobileRegisteredDevice } from "./dataMappers.js";
 import { buildSignedMobileRequest } from "./signing/buildSignedMobileRequest.js";
 import "./signing/index.js";
 import { MobileServerFailureError } from "./types/MobileServerFailureError.js";
@@ -54,6 +54,26 @@ var MobileClient = class {
 		return mapMobilePublicProfile((await this.publicQuery(body)).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 = {}) {
+		const body = {
+			type: "feed",
+			minimum_notional: params.minimumNotional,
+			limit: params.limit,
+			cursor: params.cursor
+		};
+		return mapMobileFeedPage(await this.publicQuery(body));
+	}
+	/**
 	* Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a
 	* username yet — this is normal data, not an error.
 	*/

package/dist/MobileClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.js","names":[],"sources":["../src/MobileClient.ts"],"sourcesContent":["import {\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  mapMobileIdentity,\n  mapMobileNotificationPreferences,\n  mapMobileNotificationPreferencesToServer,\n  mapMobilePublicProfile,\n  mapMobileRegisteredDevice,\n} from './dataMappers';\nimport {\n  buildSignedMobileRequest,\n  MobileSignedInner,\n  MobileSignedInnerParams,\n  MobileSignedRequest,\n} from './signing';\nimport {\n  GetMobileNotificationPreferencesParams,\n  GetMobilePublicProfileParams,\n  GetMobileRegisteredDevicesParams,\n  GetMobileSelfIdentityParams,\n  GetMobileUsernameAvailabilityParams,\n  MobileClaimUsernameParams,\n  MobileIdentity,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredDevice,\n  MobileRegisterExpoTokenParams,\n  MobileSetPrivateModeParams,\n  MobileSignedRequestParams,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUpdateUsernameParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport { MobileServerExecuteResult } from './types/serverExecuteTypes';\nimport {\n  MobileServerNotificationPreferencesResponse,\n  MobileServerProfileRequest,\n  MobileServerProfileResponse,\n  MobileServerRegisteredDevicesResponse,\n  MobileServerSelfIdentityResponse,\n  MobileServerUsernameAvailabilityRequest,\n  MobileServerUsernameAvailabilityResponse,\n} from './types/serverQueryTypes';\nimport {\n  isMobileServerFailureResponse,\n  isMobileServerSuccessResponse,\n} from './utils/serverResponseGuards';\n\n/**\n * Options for constructing a {@link MobileClient}.\n */\nexport interface MobileClientOpts {\n  /**\n   * Base URL of the mobile service API, e.g. {@link MOBILE_CLIENT_ENDPOINTS}.\n   */\n  url: string;\n  /**\n   * Wallet client used to sign requests.\n   */\n  walletClient?: WalletClientWithAccount;\n  /**\n   * If provided, this signer is used instead of `walletClient` for all signed requests.\n   */\n  linkedSignerWalletClient?: WalletClientWithAccount;\n}\n\n/**\n * Client for the Nado mobile service API: username claims, public profile lookups, privacy settings, and\n * push notification device/preference management.\n */\nexport class MobileClient {\n  readonly opts: MobileClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: MobileClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n    });\n  }\n\n  /**\n   * Sets the linked signer for requests\n   *\n   * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer\n   */\n  public setLinkedSigner(\n    linkedSignerWalletClient: WalletClientWithAccount | null,\n  ) {\n    this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? undefined;\n  }\n\n  /*\n  Public queries\n   */\n\n  /**\n   * Checks whether a username derived from the given display name is available to claim.\n   */\n  async getUsernameAvailability(\n    params: GetMobileUsernameAvailabilityParams,\n  ): Promise<MobileUsernameAvailability> {\n    const body: MobileServerUsernameAvailabilityRequest = {\n      type: 'username_availability',\n      display_name: params.displayName,\n    };\n    const data =\n      await this.publicQuery<MobileServerUsernameAvailabilityResponse>(body);\n    return { username: data.username, available: data.available };\n  }\n\n  /**\n   * Looks up a subaccount's public profile by username.\n   *\n   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if no identity has claimed the\n   * username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.\n   */\n  async getPublicProfile(\n    params: GetMobilePublicProfileParams,\n  ): Promise<MobilePublicProfile> {\n    const body: MobileServerProfileRequest = {\n      type: 'profile',\n      username: params.username,\n    };\n    const data = await this.publicQuery<MobileServerProfileResponse>(body);\n    return mapMobilePublicProfile(data.profile);\n  }\n\n  /*\n  Signed queries\n   */\n\n  /**\n   * Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a\n   * username yet — this is normal data, not an error.\n   */\n  async getSelfIdentity(\n    params: GetMobileSelfIdentityParams,\n  ): Promise<MobileIdentity | null> {\n    const signedRequest = await this.getSignedRequest(\n      'self_identity',\n      params,\n      {},\n    );\n    const data =\n      await this.query<MobileServerSelfIdentityResponse>(signedRequest);\n    return data.identity ? mapMobileIdentity(data.identity) : null;\n  }\n\n  /**\n   * Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has\n   * never updated its preferences.\n   */\n  async getNotificationPreferences(\n    params: GetMobileNotificationPreferencesParams,\n  ): Promise<MobileNotificationPreferences> {\n    const signedRequest = await this.getSignedRequest(\n      'notification_preferences',\n      params,\n      {},\n    );\n    const data =\n      await this.query<MobileServerNotificationPreferencesResponse>(\n        signedRequest,\n      );\n    return mapMobileNotificationPreferences(data.preferences);\n  }\n\n  /**\n   * Fetches the devices registered for push notifications for a wallet.\n   */\n  async getRegisteredDevices(\n    params: GetMobileRegisteredDevicesParams,\n  ): Promise<MobileRegisteredDevice[]> {\n    const signedRequest = await this.getSignedRequest(\n      'registered_devices',\n      params,\n      {},\n    );\n    const data =\n      await this.query<MobileServerRegisteredDevicesResponse>(signedRequest);\n    return data.devices.map(mapMobileRegisteredDevice);\n  }\n\n  /*\n  Signed executes\n   */\n\n  /**\n   * Claims a username for a subaccount, derived from the given display name.\n   */\n  async claimUsername(\n    params: MobileClaimUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'claim_username',\n      params,\n      {\n        display_name: params.displayName,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Updates the display name for a subaccount's already-claimed identity.\n   */\n  async updateUsername(\n    params: MobileUpdateUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_username',\n      params,\n      { display_name: params.displayName },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Sets whether a subaccount's profile is private.\n   */\n  async setPrivateMode(\n    params: MobileSetPrivateModeParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'set_private_mode',\n      params,\n      { private_mode: params.privateMode },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Registers an Expo push token for the wallet, transferring active ownership of the token if another\n   * wallet had registered it. Idempotent per `(wallet, token)`.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is not a valid Expo\n   * push token, or `INVALID_DEVICE_METADATA` if `locale` (max 35 chars) or `appVersion` (max 64 chars) is\n   * too long.\n   */\n  async registerExpoToken(\n    params: MobileRegisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'register_expo_token',\n      params,\n      {\n        expo_token: params.expoToken,\n        platform: params.platform,\n        locale: params.locale ?? null,\n        app_version: params.appVersion ?? null,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.\n   */\n  async unregisterExpoToken(\n    params: MobileUnregisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'unregister_expo_token',\n      params,\n      { expo_token: params.expoToken },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Replaces the wallet's push notification preferences. The backend requires `schemaVersion` of 1, exactly\n   * one entry per known category, and empty `scopes` on every entry.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated.\n   */\n  async updateNotificationPreferences(\n    params: MobileUpdateNotificationPreferencesParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_preferences',\n      params,\n      {\n        preferences: mapMobileNotificationPreferencesToServer(\n          params.preferences,\n        ),\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /*\n  Base Fns\n   */\n\n  protected async getSignedRequest<T extends MobileSignedInner['type']>(\n    type: T,\n    params: MobileSignedRequestParams,\n    innerParams: MobileSignedInnerParams<T>,\n  ): Promise<MobileSignedRequest> {\n    // Use the linked signer if provided, otherwise use the default signer provided to the client\n    const walletClient =\n      this.opts.linkedSignerWalletClient ?? this.opts.walletClient;\n\n    if (walletClient == null) {\n      throw new WalletNotProvidedError();\n    }\n\n    const inner = { type, ...innerParams } as MobileSignedInner;\n    return buildSignedMobileRequest({ ...params, walletClient, inner });\n  }\n\n  protected async publicQuery<TResponse extends { status: 'success' }>(\n    body: object,\n  ): Promise<TResponse> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/public_query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as TResponse;\n  }\n\n  protected async query<TResponse extends { status: 'success' }>(\n    body: MobileSignedRequest,\n  ): Promise<TResponse> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as TResponse;\n  }\n\n  protected async execute(\n    body: MobileSignedRequest,\n  ): Promise<MobileServerSuccessResponse> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/mobile/execute`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as MobileServerSuccessResponse;\n  }\n\n  /**\n   * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns\n   * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a\n   * failure envelope still throws the typed error; anything else is a transport-level error.\n   */\n  private checkResponseStatus(response: AxiosResponse<unknown>) {\n    if (response.status >= 200 && response.status < 300) {\n      return;\n    }\n    if (isMobileServerFailureResponse(response.data)) {\n      throw new MobileServerFailureError(response.data, response.status);\n    }\n    throw new Error(\n      `Unexpected response from mobile service: ${response.status} ${response.statusText}. Data: ${JSON.stringify(response.data)}`,\n    );\n  }\n\n  private checkServerStatus(response: AxiosResponse<unknown>) {\n    const { data } = response;\n\n    if (isMobileServerFailureResponse(data)) {\n      throw new MobileServerFailureError(data, response.status);\n    }\n    if (!isMobileServerSuccessResponse(data)) {\n      throw new Error(\n        `Unexpected response from mobile service: missing success envelope. Data: ${JSON.stringify(data)}`,\n      );\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"MobileClient.js","names":[],"sources":["../src/MobileClient.ts"],"sourcesContent":["import {\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  mapMobileFeedPage,\n  mapMobileIdentity,\n  mapMobileNotificationPreferences,\n  mapMobileNotificationPreferencesToServer,\n  mapMobilePublicProfile,\n  mapMobileRegisteredDevice,\n} from './dataMappers';\nimport {\n  buildSignedMobileRequest,\n  MobileSignedInner,\n  MobileSignedInnerParams,\n  MobileSignedRequest,\n} from './signing';\nimport {\n  GetMobileFeedParams,\n  GetMobileNotificationPreferencesParams,\n  GetMobilePublicProfileParams,\n  GetMobileRegisteredDevicesParams,\n  GetMobileSelfIdentityParams,\n  GetMobileUsernameAvailabilityParams,\n  MobileClaimUsernameParams,\n  MobileFeedPage,\n  MobileIdentity,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredDevice,\n  MobileRegisterExpoTokenParams,\n  MobileSetPrivateModeParams,\n  MobileSignedRequestParams,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUpdateUsernameParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport { MobileServerExecuteResult } from './types/serverExecuteTypes';\nimport {\n  MobileServerPublicQueryRequest,\n  MobileServerPublicQuerySuccessResponse,\n  MobileServerSignedQuerySuccessResponse,\n} from './types/serverQueryTypes';\nimport {\n  MobileServerPublicQueryRequestByType,\n  MobileServerPublicQueryRequestType,\n  MobileServerSignedQueryRequestType,\n} from './types/serverRequestTypes';\nimport {\n  isMobileServerFailureResponse,\n  isMobileServerSuccessResponse,\n} from './utils/serverResponseGuards';\n\n/**\n * Options for constructing a {@link MobileClient}.\n */\nexport interface MobileClientOpts {\n  /**\n   * Base URL of the mobile service API, e.g. {@link MOBILE_CLIENT_ENDPOINTS}.\n   */\n  url: string;\n  /**\n   * Wallet client used to sign requests.\n   */\n  walletClient?: WalletClientWithAccount;\n  /**\n   * If provided, this signer is used instead of `walletClient` for all signed requests.\n   */\n  linkedSignerWalletClient?: WalletClientWithAccount;\n}\n\n/**\n * Client for the Nado mobile service API: username claims, public profile lookups, privacy settings, and\n * push notification device/preference management.\n */\nexport class MobileClient {\n  readonly opts: MobileClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: MobileClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n    });\n  }\n\n  /**\n   * Sets the linked signer for requests\n   *\n   * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer\n   */\n  public setLinkedSigner(\n    linkedSignerWalletClient: WalletClientWithAccount | null,\n  ) {\n    this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? undefined;\n  }\n\n  /*\n  Public queries\n   */\n\n  /**\n   * Checks whether a username derived from the given display name is available to claim.\n   */\n  async getUsernameAvailability(\n    params: GetMobileUsernameAvailabilityParams,\n  ): Promise<MobileUsernameAvailability> {\n    const body: MobileServerPublicQueryRequest<'username_availability'> = {\n      type: 'username_availability',\n      display_name: params.displayName,\n    };\n    const data = await this.publicQuery(body);\n    return { username: data.username, available: data.available };\n  }\n\n  /**\n   * Looks up a subaccount's public profile by username.\n   *\n   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if no identity has claimed the\n   * username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.\n   */\n  async getPublicProfile(\n    params: GetMobilePublicProfileParams,\n  ): Promise<MobilePublicProfile> {\n    const body: MobileServerPublicQueryRequest<'profile'> = {\n      type: 'profile',\n      username: params.username,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobilePublicProfile(data.profile);\n  }\n\n  /**\n   * Fetches a page of the global trade feed: public, named, perpetual trades, newest first, optionally\n   * filtered by a whole-dollar minimum notional (omitted means unfiltered). The feed is best-effort rather\n   * than authoritative history, and pagination is live (not snapshot), so deduplicate pages by\n   * {@link MobileFeedTrade.orderDigest}.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_FEED_FILTER` if `minimumNotional` or\n   * `limit` is outside its allowed domain (fix the request; do not retry unchanged), or\n   * `INVALID_FEED_CURSOR` if the cursor is malformed or was issued for a different `minimumNotional`\n   * (discard the cursor and restart from the first page).\n   */\n  async getFeed(params: GetMobileFeedParams = {}): Promise<MobileFeedPage> {\n    const body: MobileServerPublicQueryRequest<'feed'> = {\n      type: 'feed',\n      minimum_notional: params.minimumNotional,\n      limit: params.limit,\n      cursor: params.cursor,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileFeedPage(data);\n  }\n\n  /*\n  Signed queries\n   */\n\n  /**\n   * Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a\n   * username yet — this is normal data, not an error.\n   */\n  async getSelfIdentity(\n    params: GetMobileSelfIdentityParams,\n  ): Promise<MobileIdentity | null> {\n    const signedRequest = await this.getSignedRequest(\n      'self_identity',\n      params,\n      {},\n    );\n    const data = await this.query<'self_identity'>(signedRequest);\n    return data.identity ? mapMobileIdentity(data.identity) : null;\n  }\n\n  /**\n   * Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has\n   * never updated its preferences.\n   */\n  async getNotificationPreferences(\n    params: GetMobileNotificationPreferencesParams,\n  ): Promise<MobileNotificationPreferences> {\n    const signedRequest = await this.getSignedRequest(\n      'notification_preferences',\n      params,\n      {},\n    );\n    const data = await this.query<'notification_preferences'>(signedRequest);\n    return mapMobileNotificationPreferences(data.preferences);\n  }\n\n  /**\n   * Fetches the devices registered for push notifications for a wallet.\n   */\n  async getRegisteredDevices(\n    params: GetMobileRegisteredDevicesParams,\n  ): Promise<MobileRegisteredDevice[]> {\n    const signedRequest = await this.getSignedRequest(\n      'registered_devices',\n      params,\n      {},\n    );\n    const data = await this.query<'registered_devices'>(signedRequest);\n    return data.devices.map(mapMobileRegisteredDevice);\n  }\n\n  /*\n  Signed executes\n   */\n\n  /**\n   * Claims a username for a subaccount, derived from the given display name.\n   */\n  async claimUsername(\n    params: MobileClaimUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'claim_username',\n      params,\n      {\n        display_name: params.displayName,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Updates the display name for a subaccount's already-claimed identity.\n   */\n  async updateUsername(\n    params: MobileUpdateUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_username',\n      params,\n      { display_name: params.displayName },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Sets whether a subaccount's profile is private.\n   */\n  async setPrivateMode(\n    params: MobileSetPrivateModeParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'set_private_mode',\n      params,\n      { private_mode: params.privateMode },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Registers an Expo push token for the wallet, transferring active ownership of the token if another\n   * wallet had registered it. Idempotent per `(wallet, token)`.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is not a valid Expo\n   * push token, or `INVALID_DEVICE_METADATA` if `locale` (max 35 chars) or `appVersion` (max 64 chars) is\n   * too long.\n   */\n  async registerExpoToken(\n    params: MobileRegisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'register_expo_token',\n      params,\n      {\n        expo_token: params.expoToken,\n        platform: params.platform,\n        locale: params.locale ?? null,\n        app_version: params.appVersion ?? null,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.\n   */\n  async unregisterExpoToken(\n    params: MobileUnregisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'unregister_expo_token',\n      params,\n      { expo_token: params.expoToken },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Replaces the wallet's push notification preferences. The backend requires `schemaVersion` of 1, exactly\n   * one entry per known category, and empty `scopes` on every entry.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated.\n   */\n  async updateNotificationPreferences(\n    params: MobileUpdateNotificationPreferencesParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_preferences',\n      params,\n      {\n        preferences: mapMobileNotificationPreferencesToServer(\n          params.preferences,\n        ),\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /*\n  Base Fns\n   */\n\n  protected async getSignedRequest<T extends MobileSignedInner['type']>(\n    type: T,\n    params: MobileSignedRequestParams,\n    innerParams: MobileSignedInnerParams<T>,\n  ): Promise<MobileSignedRequest> {\n    // Use the linked signer if provided, otherwise use the default signer provided to the client\n    const walletClient =\n      this.opts.linkedSignerWalletClient ?? this.opts.walletClient;\n\n    if (walletClient == null) {\n      throw new WalletNotProvidedError();\n    }\n\n    const inner = { type, ...innerParams } as MobileSignedInner;\n    return buildSignedMobileRequest({ ...params, walletClient, inner });\n  }\n\n  // Spelled out as an intersection rather than `MobileServerPublicQueryRequest<T>`: the latter is an indexed\n  // access on a mapped type, which is not an inference site, so `T` would always widen to the full union.\n  protected async publicQuery<T extends MobileServerPublicQueryRequestType>(\n    body: { type: T } & MobileServerPublicQueryRequestByType[T],\n  ): Promise<MobileServerPublicQuerySuccessResponse<T>> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/public_query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as MobileServerPublicQuerySuccessResponse<T>;\n  }\n\n  protected async query<T extends MobileServerSignedQueryRequestType>(\n    body: MobileSignedRequest,\n  ): Promise<MobileServerSignedQuerySuccessResponse<T>> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as MobileServerSignedQuerySuccessResponse<T>;\n  }\n\n  protected async execute(\n    body: MobileSignedRequest,\n  ): Promise<MobileServerSuccessResponse> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/mobile/execute`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as MobileServerSuccessResponse;\n  }\n\n  /**\n   * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns\n   * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a\n   * failure envelope still throws the typed error; anything else is a transport-level error.\n   */\n  private checkResponseStatus(response: AxiosResponse<unknown>) {\n    if (response.status >= 200 && response.status < 300) {\n      return;\n    }\n    if (isMobileServerFailureResponse(response.data)) {\n      throw new MobileServerFailureError(response.data, response.status);\n    }\n    throw new Error(\n      `Unexpected response from mobile service: ${response.status} ${response.statusText}. Data: ${JSON.stringify(response.data)}`,\n    );\n  }\n\n  private checkServerStatus(response: AxiosResponse<unknown>) {\n    const { data } = response;\n\n    if (isMobileServerFailureResponse(data)) {\n      throw new MobileServerFailureError(data, response.status);\n    }\n    if (!isMobileServerSuccessResponse(data)) {\n      throw new Error(\n        `Unexpected response from mobile service: missing success envelope. Data: ${JSON.stringify(data)}`,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/{MobileServerFailureError-DUXjO_3w.d.ts → MobileServerFailureError-B11rr9O5.d.cts}

@@ -1,28 +1,23 @@
-import { i as MobileServerRequestType, t as MobileServerFailureResponse } from "./serverBaseTypes-ewbo8l4R.js";
+import { i as MobileServerRequestType } from "./serverRequestTypes-DnU_FfMI.cjs";
+import { t as MobileServerFailureResponse } from "./serverBaseTypes-A16onlPN.cjs";
+import { BaseServerFailureError } from "@nadohq/shared";
 
 //#region src/types/MobileServerFailureError.d.ts
 /**
  * Error thrown when the mobile service API returns a failure envelope, either as a non-2xx HTTP response
  * or a 2xx response with `status: 'failure'`. The numeric error code is exposed directly on
- * {@link errorCode} for comparison against {@link MOBILE_ERROR_CODES}.
+ * {@link BaseServerFailureError.errorCode} for comparison against {@link MOBILE_ERROR_CODES}.
  */
-declare class MobileServerFailureError extends Error {
+declare class MobileServerFailureError extends BaseServerFailureError {
   readonly responseData: MobileServerFailureResponse;
+  readonly requestType: MobileServerRequestType;
   /**
    * HTTP status code of the response, e.g. `404` for `PROFILE_NOT_FOUND`. Unlike the engine, the mobile
    * backend maps domain failures onto HTTP statuses.
    */
   readonly httpStatus: number;
-  /**
-   * Numeric mobile service API error code, see {@link MOBILE_ERROR_CODES}.
-   */
-  readonly errorCode: number;
-  /**
-   * The request type that failed, e.g. `public_query_profile`, `execute_claim_username`.
-   */
-  readonly requestType: MobileServerRequestType;
   constructor(responseData: MobileServerFailureResponse, httpStatus: number);
 }
 //#endregion
 export { MobileServerFailureError as t };
-//# sourceMappingURL=MobileServerFailureError-DUXjO_3w.d.ts.map
+//# sourceMappingURL=MobileServerFailureError-B11rr9O5.d.cts.map

package/dist/MobileServerFailureError-B11rr9O5.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileServerFailureError-B11rr9O5.d.cts","names":[],"sources":["../src/types/src/types/MobileServerFailureError.ts"],"mappings":";;;;;;;AASA;;;cAAa,wBAAA,SAAiC,sBAAA;EAAA,SAC3B,YAAA,EAAc,2BAAA;EAAA,SACd,WAAA,EAAa,uBAAA;EAFc;;;;EAAA,SAQnC,UAAA;cAEG,YAAA,EAAc,2BAAA,EAA6B,UAAA;AAAA"}

package/dist/{MobileServerFailureError-BfdqvDBi.d.cts → MobileServerFailureError-DoIvXqYV.d.ts}

@@ -1,28 +1,23 @@
-import { i as MobileServerRequestType, t as MobileServerFailureResponse } from "./serverBaseTypes-BicXMrZV.cjs";
+import { i as MobileServerRequestType } from "./serverRequestTypes-DQDy3K9O.js";
+import { t as MobileServerFailureResponse } from "./serverBaseTypes-m3zEi0X9.js";
+import { BaseServerFailureError } from "@nadohq/shared";
 
 //#region src/types/MobileServerFailureError.d.ts
 /**
  * Error thrown when the mobile service API returns a failure envelope, either as a non-2xx HTTP response
  * or a 2xx response with `status: 'failure'`. The numeric error code is exposed directly on
- * {@link errorCode} for comparison against {@link MOBILE_ERROR_CODES}.
+ * {@link BaseServerFailureError.errorCode} for comparison against {@link MOBILE_ERROR_CODES}.
  */
-declare class MobileServerFailureError extends Error {
+declare class MobileServerFailureError extends BaseServerFailureError {
   readonly responseData: MobileServerFailureResponse;
+  readonly requestType: MobileServerRequestType;
   /**
    * HTTP status code of the response, e.g. `404` for `PROFILE_NOT_FOUND`. Unlike the engine, the mobile
    * backend maps domain failures onto HTTP statuses.
    */
   readonly httpStatus: number;
-  /**
-   * Numeric mobile service API error code, see {@link MOBILE_ERROR_CODES}.
-   */
-  readonly errorCode: number;
-  /**
-   * The request type that failed, e.g. `public_query_profile`, `execute_claim_username`.
-   */
-  readonly requestType: MobileServerRequestType;
   constructor(responseData: MobileServerFailureResponse, httpStatus: number);
 }
 //#endregion
 export { MobileServerFailureError as t };
-//# sourceMappingURL=MobileServerFailureError-BfdqvDBi.d.cts.map
+//# sourceMappingURL=MobileServerFailureError-DoIvXqYV.d.ts.map

package/dist/MobileServerFailureError-DoIvXqYV.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileServerFailureError-DoIvXqYV.d.ts","names":[],"sources":["../src/types/src/types/MobileServerFailureError.ts"],"mappings":";;;;;;;AASA;;;cAAa,wBAAA,SAAiC,sBAAA;EAAA,SAC3B,YAAA,EAAc,2BAAA;EAAA,SACd,WAAA,EAAa,uBAAA;EAFc;;;;EAAA,SAQnC,UAAA;cAEG,YAAA,EAAc,2BAAA,EAA6B,UAAA;AAAA"}

package/dist/{buildSignedMobileRequest-CDRsRNHm.d.ts → buildSignedMobileRequest-B4KJ6T1y.d.ts}

@@ -1,4 +1,4 @@
-import { i as MobileSignedRequest, n as MobileSignedInner, t as BuildSignedMobileRequestParams } from "./types-B76Pn7Sy.js";
+import { i as MobileSignedRequest, n as MobileSignedInner, t as BuildSignedMobileRequestParams } from "./types-UHjZR-js.js";
 
 //#region src/signing/buildSignedMobileRequest.d.ts
 /**
@@ -11,4 +11,4 @@ declare function buildSignedMobileRequest<T extends MobileSignedInner>(params: B
 }): Promise<MobileSignedRequest<T>>;
 //#endregion
 export { buildSignedMobileRequest as t };
-//# sourceMappingURL=buildSignedMobileRequest-CDRsRNHm.d.ts.map
+//# sourceMappingURL=buildSignedMobileRequest-B4KJ6T1y.d.ts.map

package/dist/{buildSignedMobileRequest-CDRsRNHm.d.ts.map → buildSignedMobileRequest-B4KJ6T1y.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"buildSignedMobileRequest-CDRsRNHm.d.ts","names":[],"sources":["../src/signing/src/signing/buildSignedMobileRequest.ts"],"mappings":";;;;;AAgBA;;;iBAAsB,wBAAA,WAAmC,iBAAA,CAAA,CACvD,MAAA,EAAQ,8BAAA;EAAmC,KAAA,EAAO,CAAA;AAAA,IACjD,OAAA,CAAQ,mBAAA,CAAoB,CAAA"}
+{"version":3,"file":"buildSignedMobileRequest-B4KJ6T1y.d.ts","names":[],"sources":["../src/signing/src/signing/buildSignedMobileRequest.ts"],"mappings":";;;;;AAgBA;;;iBAAsB,wBAAA,WAAmC,iBAAA,CAAA,CACvD,MAAA,EAAQ,8BAAA;EAAmC,KAAA,EAAO,CAAA;AAAA,IACjD,OAAA,CAAQ,mBAAA,CAAoB,CAAA"}

package/dist/{buildSignedMobileRequest-BsbBkU0K.d.cts → buildSignedMobileRequest-EEnDgZF8.d.cts}

@@ -1,4 +1,4 @@
-import { i as MobileSignedRequest, n as MobileSignedInner, t as BuildSignedMobileRequestParams } from "./types-uCD4BNZR.cjs";
+import { i as MobileSignedRequest, n as MobileSignedInner, t as BuildSignedMobileRequestParams } from "./types-CzOeSYnW.cjs";
 
 //#region src/signing/buildSignedMobileRequest.d.ts
 /**
@@ -11,4 +11,4 @@ declare function buildSignedMobileRequest<T extends MobileSignedInner>(params: B
 }): Promise<MobileSignedRequest<T>>;
 //#endregion
 export { buildSignedMobileRequest as t };
-//# sourceMappingURL=buildSignedMobileRequest-BsbBkU0K.d.cts.map
+//# sourceMappingURL=buildSignedMobileRequest-EEnDgZF8.d.cts.map

package/dist/{buildSignedMobileRequest-BsbBkU0K.d.cts.map → buildSignedMobileRequest-EEnDgZF8.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"buildSignedMobileRequest-BsbBkU0K.d.cts","names":[],"sources":["../src/signing/src/signing/buildSignedMobileRequest.ts"],"mappings":";;;;;AAgBA;;;iBAAsB,wBAAA,WAAmC,iBAAA,CAAA,CACvD,MAAA,EAAQ,8BAAA;EAAmC,KAAA,EAAO,CAAA;AAAA,IACjD,OAAA,CAAQ,mBAAA,CAAoB,CAAA"}
+{"version":3,"file":"buildSignedMobileRequest-EEnDgZF8.d.cts","names":[],"sources":["../src/signing/src/signing/buildSignedMobileRequest.ts"],"mappings":";;;;;AAgBA;;;iBAAsB,wBAAA,WAAmC,iBAAA,CAAA,CACvD,MAAA,EAAQ,8BAAA;EAAmC,KAAA,EAAO,CAAA;AAAA,IACjD,OAAA,CAAQ,mBAAA,CAAoB,CAAA"}

package/dist/{canonicalize-Dm7sXwPg.d.cts → canonicalize-CDdYnhL3.d.cts}

@@ -1,4 +1,4 @@
-import { n as MobileSignedInner } from "./types-uCD4BNZR.cjs";
+import { n as MobileSignedInner } from "./types-CzOeSYnW.cjs";
 
 //#region src/signing/canonicalize.d.ts
 /**
@@ -11,4 +11,4 @@ import { n as MobileSignedInner } from "./types-uCD4BNZR.cjs";
 declare function canonicalizeMobileInner(inner: MobileSignedInner): MobileSignedInner;
 //#endregion
 export { canonicalizeMobileInner as t };
-//# sourceMappingURL=canonicalize-Dm7sXwPg.d.cts.map
+//# sourceMappingURL=canonicalize-CDdYnhL3.d.cts.map

package/dist/canonicalize-CDdYnhL3.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalize-CDdYnhL3.d.cts","names":[],"sources":["../src/signing/src/signing/canonicalize.ts"],"mappings":";;;;;AAUA;;;;;iBAAgB,uBAAA,CACd,KAAA,EAAO,iBAAA,GACN,iBAAiB"}

package/dist/{canonicalize-PX6dTIdF.d.ts → canonicalize-Cc7hdZLJ.d.ts}

@@ -1,4 +1,4 @@
-import { n as MobileSignedInner } from "./types-B76Pn7Sy.js";
+import { n as MobileSignedInner } from "./types-UHjZR-js.js";
 
 //#region src/signing/canonicalize.d.ts
 /**
@@ -11,4 +11,4 @@ import { n as MobileSignedInner } from "./types-B76Pn7Sy.js";
 declare function canonicalizeMobileInner(inner: MobileSignedInner): MobileSignedInner;
 //#endregion
 export { canonicalizeMobileInner as t };
-//# sourceMappingURL=canonicalize-PX6dTIdF.d.ts.map
+//# sourceMappingURL=canonicalize-Cc7hdZLJ.d.ts.map

package/dist/canonicalize-Cc7hdZLJ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalize-Cc7hdZLJ.d.ts","names":[],"sources":["../src/signing/src/signing/canonicalize.ts"],"mappings":";;;;;AAUA;;;;;iBAAgB,uBAAA,CACd,KAAA,EAAO,iBAAA,GACN,iBAAiB"}

package/dist/{clientTypes-DWW2N66c.d.ts → clientTypes-BsOps_pY.d.ts}

@@ -1,4 +1,4 @@
-import { n as MobileNotificationPlatform, t as MobileNotificationCategory } from "./serverModelTypes-vEPhHIit.js";
+import { a as MobileFeedTradePosition, c as MobileNotificationCategory, i as MobileFeedMarginMode, l as MobileNotificationPlatform } from "./serverModelTypes-CqnqHY5F.js";
 import { SignatureParams, Subaccount } from "@nadohq/shared";
 import { Hex } from "viem";
 
@@ -39,6 +39,53 @@ interface MobileUsernameAvailability {
   username: string;
   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.
+ */
+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.
+ */
+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).
+ */
+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.
@@ -103,6 +150,23 @@ interface GetMobileUsernameAvailabilityParams {
 interface GetMobilePublicProfileParams {
   username: string;
 }
+/**
+ * Params for {@link MobileClient.getFeed}.
+ */
+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}.
  */
@@ -164,5 +228,5 @@ type GetMobileNotificationPreferencesParams = MobileSignedRequestParams;
  */
 type GetMobileRegisteredDevicesParams = MobileSignedRequestParams;
 //#endregion
-export { MobileUpdateNotificationPreferencesParams as _, GetMobileUsernameAvailabilityParams as a, MobileNotificationCategoryPreference as c, MobilePublicProfile as d, MobileRegisterExpoTokenParams as f, MobileUnregisterExpoTokenParams as g, MobileSignedRequestParams as h, GetMobileSelfIdentityParams as i, MobileNotificationPreferenceScope as l, MobileSetPrivateModeParams as m, GetMobilePublicProfileParams as n, MobileClaimUsernameParams as o, MobileRegisteredDevice as p, GetMobileRegisteredDevicesParams as r, MobileIdentity as s, GetMobileNotificationPreferencesParams as t, MobileNotificationPreferences as u, MobileUpdateUsernameParams as v, MobileUsernameAvailability as y };
-//# sourceMappingURL=clientTypes-DWW2N66c.d.ts.map
+export { MobileUsernameAvailability as C, MobileUpdateUsernameParams as S, MobileRegisteredDevice as _, GetMobileSelfIdentityParams as a, MobileUnregisterExpoTokenParams as b, MobileFeedMargin as c, MobileIdentity as d, MobileNotificationCategoryPreference as f, MobileRegisterExpoTokenParams as g, MobilePublicProfile as h, GetMobileRegisteredDevicesParams as i, MobileFeedPage as l, MobileNotificationPreferences as m, GetMobileNotificationPreferencesParams as n, GetMobileUsernameAvailabilityParams as o, MobileNotificationPreferenceScope as p, GetMobilePublicProfileParams as r, MobileClaimUsernameParams as s, GetMobileFeedParams as t, MobileFeedTrade as u, MobileSetPrivateModeParams as v, MobileUpdateNotificationPreferencesParams as x, MobileSignedRequestParams as y };
+//# sourceMappingURL=clientTypes-BsOps_pY.d.ts.map

package/dist/clientTypes-BsOps_pY.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTypes-BsOps_pY.d.ts","names":[],"sources":["../src/types/src/types/clientTypes.ts"],"mappings":";;;;;;;AAiBA;;;;;;UAAiB,cAAA;EACf,UAAA,EAAY,GAAG;EAUf;;AAAW;AAMb;EAXE,QAAA;;;;EAIA,WAAA;EACA,WAAA;AAAA;;AASW;AAMb;UATiB,mBAAA;EACf,UAAA,EAAY,GAAG;EACf,QAAA;EACA,WAAA;AAAA;;;;UAMe,0BAAA;EACf,QAAA;EACA,SAAS;AAAA;AAUQ;AAQnB;;;;AARmB,UAFF,gBAAA;EACf,IAAA,EAAM,oBAAoB;EAC1B,iBAAA;AAAA;;;;;;UAQe,eAAA;EAKf;EAHA,WAAA,EAAa,GAAA;EACb,UAAA,EAAY,GAAA;EACZ,QAAA;EACA,WAAA;EASA;EAPA,SAAA;EACA,SAAA;EASA;EAPA,QAAA;EASA;EAPA,QAAA;EASQ;EAPR,YAAA;EACA,MAAA,EAAQ,gBAAA;EAeqB;EAb7B,QAAA,EAAU,uBAAA;EAca;EAZvB,WAAA;EAYQ;EAVR,QAAA;AAAA;AAWU;AAOZ;;;;;AAPY,UAFK,cAAA;EACf,MAAA,EAAQ,eAAe;EACvB,UAAA;AAAA;;AAS8B;AAKhC;;KAPY,iCAAA;EACN,IAAA;EAAoB,UAAA,EAAY,GAAG;AAAA;EACnC,IAAA;EAAiB,SAAA;AAAA;;AAQoB;AAO3C;UAViB,oCAAA;EACf,QAAA,EAAU,0BAAA;EACV,OAAA;EACA,MAAA,EAAQ,iCAAiC;AAAA;;;AAUO;AAMlD;UATiB,6BAAA;;EAEf,aAAA;EACA,UAAA,EAAY,oCAAoC;AAAA;;;;UAMjC,sBAAA;EAeL;EAbV,QAAA,EAAU,0BAA0B;EAmBrB;EAjBf,MAAA;;EAEA,UAAA;EAgBmC;AAKrC;;;EAhBE,sBAAA;EAiBW;AAMb;;EAnBE,UAAA;AAAA;AAoBQ;AAMV;;AANU,UAdO,yBAAA,SACP,UAAA,EAAY,eAAe;;;;UAKpB,mCAAA;EACf,WAAW;AAAA;;;;UAMI,4BAAA;EACf,QAAQ;AAAA;;;AA8BG;UAxBI,mBAAA;EA8B2B;;;AAC/B;EA1BX,eAAA;EAgC0C;EA9B1C,KAAA;EA8BkD;AACvC;AAMb;;EAhCE,MAAA;AAAA;;;;KAMU,2BAAA,GAA8B,yBAAyB;;;;UAKlD,yBAAA,SAAkC,yBAAyB;EAC1E,WAAW;AAAA;;;AAwCF;UAlCM,0BAAA,SAAmC,yBAAyB;EAC3E,WAAW;AAAA;;;;UAMI,0BAAA,SAAmC,yBAAyB;EAC3E,WAAW;AAAA;AAuCb;;;AAAA,UAjCiB,6BAAA,SAAsC,yBAAyB;EAiCF;AAK9E;;EAlCE,SAAA;EACA,QAAA,EAAU,0BAAA;EAiC4D;;;EA7BtE,MAAA;;;;EAIA,UAAA;AAAA;;;;UAMe,+BAAA,SAAwC,yBAAyB;EAChF,SAAS;AAAA;;;;UAMM,yCAAA,SAAkD,yBAAyB;EAC1F,WAAA,EAAa,6BAAA;AAAA;;;;KAMH,sCAAA,GAAyC,yBAAyB;;;;KAKlE,gCAAA,GAAmC,yBAAyB"}