@nadohq/mobile-client 0.30.0 → 0.31.0

package/dist/types/serverQueryTypes.d.cts

@@ -1,2 +1,2 @@
-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";
+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-9H6P1vJ5.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 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";
+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-Cbjx0bIj.js";
 export { MobileServerFeedResponse, MobileServerNotificationPreferencesResponse, MobileServerProfileResponse, MobileServerPublicQueryRequest, MobileServerPublicQueryResponseByType, MobileServerPublicQuerySuccessResponse, MobileServerRegisteredDevicesResponse, MobileServerSelfIdentityResponse, MobileServerSignedQueryResponseByType, MobileServerSignedQuerySuccessResponse, MobileServerUsernameAvailabilityResponse };

package/dist/types/serverRequestTypes.d.cts

@@ -1,2 +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 };
+import { a as MobileServerPublicQueryRequestType, c as MobileServerSignedQueryRequestType, i as MobileServerPublicQueryRequestByType, n as MobileServerPublicExecuteRequestByType, o as MobileServerRequestType, r as MobileServerPublicExecuteRequestType, s as MobileServerSignedQueryRequestByType, t as MobileServerExecuteRequestType } from "../serverRequestTypes-CHDk6JwE.cjs";
+export { MobileServerExecuteRequestType, MobileServerPublicExecuteRequestByType, MobileServerPublicExecuteRequestType, MobileServerPublicQueryRequestByType, MobileServerPublicQueryRequestType, MobileServerRequestType, MobileServerSignedQueryRequestByType, MobileServerSignedQueryRequestType };

package/dist/types/serverRequestTypes.d.ts

@@ -1,2 +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 };
+import { a as MobileServerPublicQueryRequestType, c as MobileServerSignedQueryRequestType, i as MobileServerPublicQueryRequestByType, n as MobileServerPublicExecuteRequestByType, o as MobileServerRequestType, r as MobileServerPublicExecuteRequestType, s as MobileServerSignedQueryRequestByType, t as MobileServerExecuteRequestType } from "../serverRequestTypes-DYTLrCpz.js";
+export { MobileServerExecuteRequestType, MobileServerPublicExecuteRequestByType, MobileServerPublicExecuteRequestType, MobileServerPublicQueryRequestByType, MobileServerPublicQueryRequestType, MobileServerRequestType, MobileServerSignedQueryRequestByType, MobileServerSignedQueryRequestType };

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

@@ -1,5 +1,5 @@
-import { h as MobileServerNotificationPreferences, l as MobileNotificationPlatform } from "./serverModelTypes-CqnqHY5F.js";
-import { y as MobileSignedRequestParams } from "./clientTypes-BsOps_pY.js";
+import { l as MobileNotificationPlatform } from "./serverModelTypes-DvPs5qs3.js";
+import { y as MobileSignedRequestParams } from "./clientTypes-6utzUU-b.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { Hex } from "viem";
 
@@ -14,10 +14,7 @@ import { Hex } from "viem";
  * {@link canonicalizeMobileInner}, which is the source of truth. Keep the field order here in sync with it.
  */
 type MobileSignedInner = {
-  type: 'claim_username';
-  display_name: string;
-} | {
-  type: 'update_username';
+  type: 'set_username';
   display_name: string;
 } | {
   type: 'set_private_mode';
@@ -30,14 +27,6 @@ type MobileSignedInner = {
   platform: MobileNotificationPlatform;
   locale: string | null;
   app_version: string | null;
-} | {
-  type: 'unregister_expo_token';
-  expo_token: string;
-} | {
-  type: 'update_preferences';
-  preferences: MobileServerNotificationPreferences;
-} | {
-  type: 'notification_preferences';
 } | {
   type: 'registered_devices';
 };
@@ -70,4 +59,4 @@ interface BuildSignedMobileRequestParams extends MobileSignedRequestParams {
 }
 //#endregion
 export { MobileSignedRequest as i, MobileSignedInner as n, MobileSignedInnerParams as r, BuildSignedMobileRequestParams as t };
-//# sourceMappingURL=types-UHjZR-js.d.ts.map
+//# sourceMappingURL=types-CQE3HD2V.d.ts.map

package/dist/types-CQE3HD2V.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CQE3HD2V.d.ts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAcA;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAsB,YAAA;AAAA;EACtB,IAAA;EAA0B,YAAA;AAAA;EAC1B,IAAA;AAAA;EAEA,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAA0B;EAGpC,MAAA;EACA,WAAA;AAAA;EAEA,IAAA;AAAA;;;;;KAMM,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;;;KAQzB,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;EATI;;;EAaX,KAAA;AAAA"}

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

@@ -1,5 +1,5 @@
-import { h as MobileServerNotificationPreferences, l as MobileNotificationPlatform } from "./serverModelTypes-CPZUvVil.cjs";
-import { y as MobileSignedRequestParams } from "./clientTypes-UFInIAQd.cjs";
+import { l as MobileNotificationPlatform } from "./serverModelTypes-BYQcsRrx.cjs";
+import { y as MobileSignedRequestParams } from "./clientTypes-D9qgtNlE.cjs";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { Hex } from "viem";
 
@@ -14,10 +14,7 @@ import { Hex } from "viem";
  * {@link canonicalizeMobileInner}, which is the source of truth. Keep the field order here in sync with it.
  */
 type MobileSignedInner = {
-  type: 'claim_username';
-  display_name: string;
-} | {
-  type: 'update_username';
+  type: 'set_username';
   display_name: string;
 } | {
   type: 'set_private_mode';
@@ -30,14 +27,6 @@ type MobileSignedInner = {
   platform: MobileNotificationPlatform;
   locale: string | null;
   app_version: string | null;
-} | {
-  type: 'unregister_expo_token';
-  expo_token: string;
-} | {
-  type: 'update_preferences';
-  preferences: MobileServerNotificationPreferences;
-} | {
-  type: 'notification_preferences';
 } | {
   type: 'registered_devices';
 };
@@ -70,4 +59,4 @@ interface BuildSignedMobileRequestParams extends MobileSignedRequestParams {
 }
 //#endregion
 export { MobileSignedRequest as i, MobileSignedInner as n, MobileSignedInnerParams as r, BuildSignedMobileRequestParams as t };
-//# sourceMappingURL=types-CzOeSYnW.d.cts.map
+//# sourceMappingURL=types-bNB98pYk.d.cts.map

package/dist/types-bNB98pYk.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-bNB98pYk.d.cts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAcA;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAsB,YAAA;AAAA;EACtB,IAAA;EAA0B,YAAA;AAAA;EAC1B,IAAA;AAAA;EAEA,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAA0B;EAGpC,MAAA;EACA,WAAA;AAAA;EAEA,IAAA;AAAA;;;;;KAMM,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;;;KAQzB,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;EATI;;;EAaX,KAAA;AAAA"}

package/dist/utils/index.d.cts

@@ -1,4 +1,4 @@
 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";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-DRMHmfXh.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,4 +1,4 @@
 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";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-DpbZvJfL.js";
 export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, isMobileServerFailureResponse, isMobileServerSuccessResponse };

package/dist/utils/serverResponseGuards.d.cts

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

package/dist/utils/serverResponseGuards.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadohq/mobile-client",
-  "version": "0.30.0",
+  "version": "0.31.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.30.0",
+    "@nadohq/shared": "^0.31.0",
     "axios": "1.16.1"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
     "bignumber.js": "11.1.1",
     "viem": "2.52.0"
   },
-  "gitHead": "792b9deb17d69d86a8ed6f9ec4e9b3f453bcb3e8"
+  "gitHead": "64989d50de00614c9e437cbac5a6b5785e514df5"
 }

package/src/MobileClient.ts

@@ -1,4 +1,5 @@
 import {
+  subaccountToHex,
   WalletClientWithAccount,
   WalletNotProvidedError,
 } from '@nadohq/shared';
@@ -24,7 +25,6 @@ import {
   GetMobileRegisteredDevicesParams,
   GetMobileSelfIdentityParams,
   GetMobileUsernameAvailabilityParams,
-  MobileClaimUsernameParams,
   MobileFeedPage,
   MobileIdentity,
   MobileNotificationPreferences,
@@ -32,15 +32,18 @@ import {
   MobileRegisteredDevice,
   MobileRegisterExpoTokenParams,
   MobileSetPrivateModeParams,
+  MobileSetUsernameParams,
   MobileSignedRequestParams,
   MobileUnregisterExpoTokenParams,
   MobileUpdateNotificationPreferencesParams,
-  MobileUpdateUsernameParams,
   MobileUsernameAvailability,
 } from './types/clientTypes';
 import { MobileServerFailureError } from './types/MobileServerFailureError';
 import { MobileServerSuccessResponse } from './types/serverBaseTypes';
-import { MobileServerExecuteResult } from './types/serverExecuteTypes';
+import {
+  MobileServerExecuteResult,
+  MobileServerPublicExecuteRequest,
+} from './types/serverExecuteTypes';
 import {
   MobileServerPublicQueryRequest,
   MobileServerPublicQuerySuccessResponse,
@@ -75,8 +78,8 @@ export interface MobileClientOpts {
 }
 
 /**
- * Client for the Nado mobile service API: username claims, public profile lookups, privacy settings, and
- * push notification device/preference management.
+ * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed, privacy
+ * settings, and push notification device/preference management.
  */
 export class MobileClient {
   readonly opts: MobileClientOpts;
@@ -121,27 +124,30 @@ export class MobileClient {
   }
 
   /**
-   * Looks up a subaccount's public profile by username.
+   * Looks up a subaccount's public profile. Every non-isolated subaccount resolves, with `username` and
+   * `displayName` `null` until a username is claimed. Private Mode does not hide the profile itself, only the
+   * account's activity.
    *
-   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if no identity has claimed the
-   * username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.
+   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if the subaccount is in the
+   * engine-created isolated namespace, which cannot own a profile.
    */
   async getPublicProfile(
     params: GetMobilePublicProfileParams,
   ): Promise<MobilePublicProfile> {
     const body: MobileServerPublicQueryRequest<'profile'> = {
       type: 'profile',
-      username: params.username,
+      subaccount: subaccountToHex(params),
     };
     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}.
+   * Fetches a page of the global trade feed: public perpetual trades, newest first, optionally filtered by a
+   * whole-dollar minimum notional (omitted means unfiltered). Trades by subaccounts that have not claimed a
+   * username are included with `null` name fields; only private accounts are filtered out. 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
@@ -159,13 +165,83 @@ export class MobileClient {
     return mapMobileFeedPage(data);
   }
 
+  /**
+   * Fetches the push notification preferences of the wallet that owns the given Expo push token. Unsigned —
+   * the token identifies the wallet on its own. Falls back to the backend's defaults if the wallet has never
+   * updated its preferences.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed, or is
+   * not currently registered to a wallet.
+   */
+  async getNotificationPreferences(
+    params: GetMobileNotificationPreferencesParams,
+  ): Promise<MobileNotificationPreferences> {
+    const body: MobileServerPublicQueryRequest<'notification_preferences'> = {
+      type: 'notification_preferences',
+      expo_token: params.expoToken,
+    };
+    const data = await this.publicQuery(body);
+    return mapMobileNotificationPreferences(data.preferences);
+  }
+
+  /*
+  Public executes
+   */
+
+  /**
+   * Unregisters an Expo push token, stopping delivery to that device. Unsigned, so it still works at logout
+   * when a wallet signature may no longer be obtainable. Idempotent: unregistering an inactive or unknown
+   * well-formed token succeeds.
+   *
+   * A registration that commits after this call re-activates the token, so stop or await any in-flight
+   * {@link MobileClient.registerExpoToken} before unregistering.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed.
+   */
+  async unregisterExpoToken(
+    params: MobileUnregisterExpoTokenParams,
+  ): Promise<MobileServerSuccessResponse> {
+    const body: MobileServerPublicExecuteRequest<'unregister_expo_token'> = {
+      type: 'unregister_expo_token',
+      expo_token: params.expoToken,
+    };
+    return this.publicExecute(body);
+  }
+
+  /**
+   * Replaces the push notification preferences of the wallet that owns the given Expo push token. Possession
+   * of an active token is the credential rather than a signature, so anyone holding the token can overwrite
+   * that wallet's preferences. The backend requires `schemaVersion` of 1, exactly one entry per known
+   * category, and empty `scopes` on every entry.
+   *
+   * Writes are last-write-wins on commit order rather than ordered by a client nonce, so callers must
+   * serialize their own preference writes.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated, or
+   * `INVALID_EXPO_TOKEN` if the token is malformed or is not currently registered to a wallet.
+   */
+  async updateNotificationPreferences(
+    params: MobileUpdateNotificationPreferencesParams,
+  ): Promise<MobileServerSuccessResponse> {
+    const body: MobileServerPublicExecuteRequest<'update_preferences'> = {
+      type: 'update_preferences',
+      expo_token: params.expoToken,
+      preferences: mapMobileNotificationPreferencesToServer(params.preferences),
+    };
+    return this.publicExecute(body);
+  }
+
   /*
   Signed queries
    */
 
   /**
-   * 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.
+   * Fetches the caller's own identity for a subaccount. Every non-isolated subaccount has an implicit
+   * identity, so this resolves for any valid sender with `username` and `displayName` `null` until a username
+   * is claimed.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_IDENTITY_TARGET` if the sender is in the
+   * engine-created isolated namespace, which cannot own an identity.
    */
   async getSelfIdentity(
     params: GetMobileSelfIdentityParams,
@@ -179,22 +255,6 @@ export class MobileClient {
     return data.identity ? mapMobileIdentity(data.identity) : null;
   }
 
-  /**
-   * Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has
-   * never updated its preferences.
-   */
-  async getNotificationPreferences(
-    params: GetMobileNotificationPreferencesParams,
-  ): Promise<MobileNotificationPreferences> {
-    const signedRequest = await this.getSignedRequest(
-      'notification_preferences',
-      params,
-      {},
-    );
-    const data = await this.query<'notification_preferences'>(signedRequest);
-    return mapMobileNotificationPreferences(data.preferences);
-  }
-
   /**
    * Fetches the devices registered for push notifications for a wallet.
    */
@@ -215,32 +275,21 @@ export class MobileClient {
    */
 
   /**
-   * Claims a username for a subaccount, derived from the given display name.
-   */
-  async claimUsername(
-    params: MobileClaimUsernameParams,
-  ): Promise<MobileServerSuccessResponse> {
-    const signedRequest = await this.getSignedRequest(
-      'claim_username',
-      params,
-      {
-        display_name: params.displayName,
-      },
-    );
-    return this.execute(signedRequest);
-  }
-
-  /**
-   * Updates the display name for a subaccount's already-claimed identity.
+   * Sets a subaccount's username, derived from the given display name. Upserts: the same call claims a first
+   * username and renames an existing one, so callers never need to read the current identity first.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_DISPLAY_NAME` if the display name violates
+   * `MOBILE_DISPLAY_NAME_PATTERN`, `USERNAME_UNAVAILABLE` if the derived username is reserved or already
+   * taken by another subaccount, `INVALID_IDENTITY_TARGET` if the sender is in the engine-created isolated
+   * namespace, or `STALE_IDENTITY_UPDATE` if another identity write for this subaccount committed with a
+   * later nonce (re-read the identity before retrying).
    */
-  async updateUsername(
-    params: MobileUpdateUsernameParams,
+  async setUsername(
+    params: MobileSetUsernameParams,
   ): Promise<MobileServerSuccessResponse> {
-    const signedRequest = await this.getSignedRequest(
-      'update_username',
-      params,
-      { display_name: params.displayName },
-    );
+    const signedRequest = await this.getSignedRequest('set_username', params, {
+      display_name: params.displayName,
+    });
     return this.execute(signedRequest);
   }
 
@@ -282,41 +331,6 @@ export class MobileClient {
     return this.execute(signedRequest);
   }
 
-  /**
-   * Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.
-   */
-  async unregisterExpoToken(
-    params: MobileUnregisterExpoTokenParams,
-  ): Promise<MobileServerSuccessResponse> {
-    const signedRequest = await this.getSignedRequest(
-      'unregister_expo_token',
-      params,
-      { expo_token: params.expoToken },
-    );
-    return this.execute(signedRequest);
-  }
-
-  /**
-   * Replaces the wallet's push notification preferences. The backend requires `schemaVersion` of 1, exactly
-   * one entry per known category, and empty `scopes` on every entry.
-   *
-   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated.
-   */
-  async updateNotificationPreferences(
-    params: MobileUpdateNotificationPreferencesParams,
-  ): Promise<MobileServerSuccessResponse> {
-    const signedRequest = await this.getSignedRequest(
-      'update_preferences',
-      params,
-      {
-        preferences: mapMobileNotificationPreferencesToServer(
-          params.preferences,
-        ),
-      },
-    );
-    return this.execute(signedRequest);
-  }
-
   /*
   Base Fns
    */
@@ -355,6 +369,21 @@ export class MobileClient {
     return response.data as MobileServerPublicQuerySuccessResponse<T>;
   }
 
+  protected async publicExecute(
+    body: MobileServerPublicExecuteRequest,
+  ): Promise<MobileServerSuccessResponse> {
+    const response = await this.axiosInstance.post<MobileServerExecuteResult>(
+      `${this.opts.url}/mobile/public_execute`,
+      body,
+    );
+
+    this.checkResponseStatus(response);
+    this.checkServerStatus(response);
+
+    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here
+    return response.data as MobileServerSuccessResponse;
+  }
+
   protected async query<T extends MobileServerSignedQueryRequestType>(
     body: MobileSignedRequest,
   ): Promise<MobileServerSignedQuerySuccessResponse<T>> {

package/src/dataMappers.ts

@@ -41,6 +41,7 @@ export function mapMobilePublicProfile(
     subaccount: server.subaccount,
     username: server.username,
     displayName: server.display_name,
+    privateMode: server.private_mode,
   };
 }
 

package/src/signing/canonicalize.ts

@@ -1,21 +1,18 @@
-import { MobileServerNotificationPreferences } from '../types/serverModelTypes';
 import { MobileSignedInner } from './types';
 
 /**
  * Rebuilds an inner payload with its keys in the backend's struct declaration order (`type` first, then the
  * remaining fields in the exact order the backend serializes them). msgpack encodes object keys in insertion
  * order and the payload hash must be reproducible regardless of how the caller constructed the object, so
- * every inner payload — and each of its sub-types — is canonicalized here before hashing. This function (with
- * {@link canonicalizeNotificationPreferences} for nested preferences) is the source of truth for that order.
+ * every inner payload — and each of its sub-types — is canonicalized here before hashing. This function is
+ * the source of truth for that order.
  */
 export function canonicalizeMobileInner(
   inner: MobileSignedInner,
 ): MobileSignedInner {
   switch (inner.type) {
-    case 'claim_username':
-      return { type: 'claim_username', display_name: inner.display_name };
-    case 'update_username':
-      return { type: 'update_username', display_name: inner.display_name };
+    case 'set_username':
+      return { type: 'set_username', display_name: inner.display_name };
     case 'set_private_mode':
       return { type: 'set_private_mode', private_mode: inner.private_mode };
     case 'self_identity':
@@ -28,15 +25,6 @@ export function canonicalizeMobileInner(
         locale: inner.locale,
         app_version: inner.app_version,
       };
-    case 'unregister_expo_token':
-      return { type: 'unregister_expo_token', expo_token: inner.expo_token };
-    case 'update_preferences':
-      return {
-        type: 'update_preferences',
-        preferences: canonicalizeNotificationPreferences(inner.preferences),
-      };
-    case 'notification_preferences':
-      return { type: 'notification_preferences' };
     case 'registered_devices':
       return { type: 'registered_devices' };
     default: {
@@ -46,24 +34,3 @@ export function canonicalizeMobileInner(
     }
   }
 }
-
-/**
- * Rebuilds notification preferences with keys in the backend's struct declaration order, so the msgpack
- * encoding matches the backend's `rmp_serde::to_vec_named` output field-for-field.
- */
-function canonicalizeNotificationPreferences(
-  preferences: MobileServerNotificationPreferences,
-): MobileServerNotificationPreferences {
-  return {
-    schema_version: preferences.schema_version,
-    categories: preferences.categories.map((category) => ({
-      category: category.category,
-      enabled: category.enabled,
-      scopes: category.scopes.map((scope) =>
-        scope.type === 'subaccount'
-          ? { type: 'subaccount', subaccount: scope.subaccount }
-          : { type: 'product', product_id: scope.product_id },
-      ),
-    })),
-  };
-}

package/src/signing/eip712MethodByType.ts

@@ -7,13 +7,9 @@ export const MOBILE_EIP712_METHOD_BY_TYPE: Record<
   MobileSignedInner['type'],
   string
 > = {
-  claim_username: 'mobile:execute_claim_username',
-  update_username: 'mobile:execute_update_username',
+  set_username: 'mobile:execute_set_username',
   set_private_mode: 'mobile:execute_set_private_mode',
   self_identity: 'mobile:query_self_identity',
   register_expo_token: 'mobile:execute_register_expo_token',
-  unregister_expo_token: 'mobile:execute_unregister_expo_token',
-  update_preferences: 'mobile:execute_update_preferences',
-  notification_preferences: 'mobile:query_notification_preferences',
   registered_devices: 'mobile:query_registered_devices',
 };