@nadohq/mobile-client 0.29.0 → 0.31.0

package/dist/MobileClient.d.ts

@@ -1,6 +1,9 @@
-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 { S as MobileUsernameAvailability, _ as MobileSetPrivateModeParams, a as GetMobileSelfIdentityParams, b as MobileUnregisterExpoTokenParams, c as MobileFeedPage, g as MobileRegisteredDevice, h as MobileRegisterExpoTokenParams, i as GetMobileRegisteredDevicesParams, m as MobilePublicProfile, n as GetMobileNotificationPreferencesParams, o as GetMobileUsernameAvailabilityParams, p as MobileNotificationPreferences, r as GetMobilePublicProfileParams, t as GetMobileFeedParams, u as MobileIdentity, v as MobileSetUsernameParams, x as MobileUpdateNotificationPreferencesParams, y as MobileSignedRequestParams } from "./clientTypes-6utzUU-b.js";
+import { i as MobileSignedRequest, n as MobileSignedInner, r as MobileSignedInnerParams } from "./types-CQE3HD2V.js";
+import { a as MobileServerPublicQueryRequestType, c as MobileServerSignedQueryRequestType, i as MobileServerPublicQueryRequestByType } from "./serverRequestTypes-DYTLrCpz.js";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-CzRgwUvA.js";
+import { n as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-CI3NBW2Z.js";
+import { o as MobileServerPublicQuerySuccessResponse, u as MobileServerSignedQuerySuccessResponse } from "./serverQueryTypes-Cbjx0bIj.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -23,8 +26,8 @@ interface MobileClientOpts {
   linkedSignerWalletClient?: WalletClientWithAccount;
 }
 /**
- * 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.
  */
 declare class MobileClient {
   readonly opts: MobileClientOpts;
@@ -41,34 +44,84 @@ declare class MobileClient {
    */
   getUsernameAvailability(params: GetMobileUsernameAvailabilityParams): Promise<MobileUsernameAvailability>;
   /**
-   * 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.
    */
   getPublicProfile(params: GetMobilePublicProfileParams): Promise<MobilePublicProfile>;
   /**
-   * 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 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
+   * `INVALID_FEED_CURSOR` if the cursor is malformed or was issued for a different `minimumNotional`
+   * (discard the cursor and restart from the first page).
    */
-  getSelfIdentity(params: GetMobileSelfIdentityParams): Promise<MobileIdentity | null>;
+  getFeed(params?: GetMobileFeedParams): Promise<MobileFeedPage>;
   /**
-   * Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has
-   * never updated its preferences.
+   * 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.
    */
   getNotificationPreferences(params: GetMobileNotificationPreferencesParams): Promise<MobileNotificationPreferences>;
   /**
-   * Fetches the devices registered for push notifications for a wallet.
+   * 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.
    */
-  getRegisteredDevices(params: GetMobileRegisteredDevicesParams): Promise<MobileRegisteredDevice[]>;
+  unregisterExpoToken(params: MobileUnregisterExpoTokenParams): Promise<MobileServerSuccessResponse>;
   /**
-   * Claims a username for a subaccount, derived from the given display name.
+   * 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.
    */
-  claimUsername(params: MobileClaimUsernameParams): Promise<MobileServerSuccessResponse>;
+  updateNotificationPreferences(params: MobileUpdateNotificationPreferencesParams): Promise<MobileServerSuccessResponse>;
   /**
-   * Updates the display name for a subaccount's already-claimed identity.
+   * 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.
    */
-  updateUsername(params: MobileUpdateUsernameParams): Promise<MobileServerSuccessResponse>;
+  getSelfIdentity(params: GetMobileSelfIdentityParams): Promise<MobileIdentity | null>;
+  /**
+   * Fetches the devices registered for push notifications for a wallet.
+   */
+  getRegisteredDevices(params: GetMobileRegisteredDevicesParams): Promise<MobileRegisteredDevice[]>;
+  /**
+   * 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).
+   */
+  setUsername(params: MobileSetUsernameParams): Promise<MobileServerSuccessResponse>;
   /**
    * Sets whether a subaccount's profile is private.
    */
@@ -82,24 +135,12 @@ declare class MobileClient {
    * too long.
    */
   registerExpoToken(params: MobileRegisterExpoTokenParams): Promise<MobileServerSuccessResponse>;
-  /**
-   * Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.
-   */
-  unregisterExpoToken(params: MobileUnregisterExpoTokenParams): Promise<MobileServerSuccessResponse>;
-  /**
-   * 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.
-   */
-  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 publicExecute(body: MobileServerPublicExecuteRequest): Promise<MobileServerSuccessResponse>;
+  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":";;;;;;;;;;;;;UAgEiB,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;EAgDP;;;;;EAlCJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EA2EjB;;;EA/DL,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAsFR;;;;;;;;EArEG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,mBAAA;EA+HR;;;;;;;;;;;;EA1GG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EAwLlB;;;;;;;;EArKjC,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAqLA;;;;;;;;;;EA9JL,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAyMA;;;;;;;;;;;;EArLL,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EA1HT;;;;;;;;EA+II,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,cAAA;EAhHR;;;EA6HG,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,sBAAA;EA1GG;;;;;;;;;;EAkIR,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EAtFR;;;EAgGG,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EA7ET;;;;;;;;EA8FI,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAAA,UAkBK,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,aAAA,CACd,IAAA,EAAM,gCAAA,GACL,OAAA,CAAQ,2BAAA;EAAA,UAaK,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;EAnHR;;;;;EAAA,QAqIK,mBAAA;EAAA,QAYA,iBAAA;AAAA"}

package/dist/MobileClient.js

@@ -1,14 +1,14 @@
-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";
 import { isMobileServerFailureResponse, isMobileServerSuccessResponse } from "./utils/serverResponseGuards.js";
-import { WalletNotProvidedError } from "@nadohq/shared";
+import { WalletNotProvidedError, subaccountToHex } from "@nadohq/shared";
 import axios from "axios";
 //#region src/MobileClient.ts
 /**
-* 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.
 */
 var MobileClient = class {
 	constructor(opts) {
@@ -41,34 +41,105 @@ var MobileClient = class {
 		};
 	}
 	/**
-	* 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) {
 		const body = {
 			type: "profile",
-			username: params.username
+			subaccount: subaccountToHex(params)
 		};
 		return mapMobilePublicProfile((await this.publicQuery(body)).profile);
 	}
 	/**
-	* 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 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
+	* `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 getSelfIdentity(params) {
-		const signedRequest = await this.getSignedRequest("self_identity", params, {});
-		const data = await this.query(signedRequest);
-		return data.identity ? mapMobileIdentity(data.identity) : null;
+	async getFeed(params = {}) {
+		const body = {
+			type: "feed",
+			minimum_notional: params.minimumNotional,
+			limit: params.limit,
+			cursor: params.cursor
+		};
+		return mapMobileFeedPage(await this.publicQuery(body));
 	}
 	/**
-	* Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has
-	* never updated its preferences.
+	* 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) {
-		const signedRequest = await this.getSignedRequest("notification_preferences", params, {});
-		return mapMobileNotificationPreferences((await this.query(signedRequest)).preferences);
+		const body = {
+			type: "notification_preferences",
+			expo_token: params.expoToken
+		};
+		return mapMobileNotificationPreferences((await this.publicQuery(body)).preferences);
+	}
+	/**
+	* 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) {
+		const body = {
+			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) {
+		const body = {
+			type: "update_preferences",
+			expo_token: params.expoToken,
+			preferences: mapMobileNotificationPreferencesToServer(params.preferences)
+		};
+		return this.publicExecute(body);
+	}
+	/**
+	* 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) {
+		const signedRequest = await this.getSignedRequest("self_identity", params, {});
+		const data = await this.query(signedRequest);
+		return data.identity ? mapMobileIdentity(data.identity) : null;
 	}
 	/**
 	* Fetches the devices registered for push notifications for a wallet.
@@ -78,17 +149,17 @@ var MobileClient = class {
 		return (await this.query(signedRequest)).devices.map(mapMobileRegisteredDevice);
 	}
 	/**
-	* Claims a username for a subaccount, derived from the given display name.
-	*/
-	async claimUsername(params) {
-		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) {
-		const signedRequest = await this.getSignedRequest("update_username", params, { display_name: params.displayName });
+	async setUsername(params) {
+		const signedRequest = await this.getSignedRequest("set_username", params, { display_name: params.displayName });
 		return this.execute(signedRequest);
 	}
 	/**
@@ -115,23 +186,6 @@ var MobileClient = class {
 		});
 		return this.execute(signedRequest);
 	}
-	/**
-	* Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.
-	*/
-	async unregisterExpoToken(params) {
-		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) {
-		const signedRequest = await this.getSignedRequest("update_preferences", params, { preferences: mapMobileNotificationPreferencesToServer(params.preferences) });
-		return this.execute(signedRequest);
-	}
 	async getSignedRequest(type, params, innerParams) {
 		const walletClient = this.opts.linkedSignerWalletClient ?? this.opts.walletClient;
 		if (walletClient == null) throw new WalletNotProvidedError();
@@ -151,6 +205,12 @@ var MobileClient = class {
 		this.checkServerStatus(response);
 		return response.data;
 	}
+	async publicExecute(body) {
+		const response = await this.axiosInstance.post(`${this.opts.url}/mobile/public_execute`, body);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data;
+	}
 	async query(body) {
 		const response = await this.axiosInstance.post(`${this.opts.url}/mobile/query`, body);
 		this.checkResponseStatus(response);

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  subaccountToHex,\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  MobileFeedPage,\n  MobileIdentity,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredDevice,\n  MobileRegisterExpoTokenParams,\n  MobileSetPrivateModeParams,\n  MobileSetUsernameParams,\n  MobileSignedRequestParams,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport {\n  MobileServerExecuteResult,\n  MobileServerPublicExecuteRequest,\n} 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: usernames, public profile lookups, the global trade feed, privacy\n * settings, and 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. Every non-isolated subaccount resolves, with `username` and\n   * `displayName` `null` until a username is claimed. Private Mode does not hide the profile itself, only the\n   * account's activity.\n   *\n   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if the subaccount is in the\n   * engine-created isolated namespace, which cannot own a profile.\n   */\n  async getPublicProfile(\n    params: GetMobilePublicProfileParams,\n  ): Promise<MobilePublicProfile> {\n    const body: MobileServerPublicQueryRequest<'profile'> = {\n      type: 'profile',\n      subaccount: subaccountToHex(params),\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 perpetual trades, newest first, optionally filtered by a\n   * whole-dollar minimum notional (omitted means unfiltered). Trades by subaccounts that have not claimed a\n   * username are included with `null` name fields; only private accounts are filtered out. The feed is\n   * best-effort rather than authoritative history, and pagination is live (not snapshot), so deduplicate pages\n   * by {@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   * Fetches the push notification preferences of the wallet that owns the given Expo push token. Unsigned —\n   * the token identifies the wallet on its own. Falls back to the backend's defaults if the wallet has never\n   * updated its preferences.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed, or is\n   * not currently registered to a wallet.\n   */\n  async getNotificationPreferences(\n    params: GetMobileNotificationPreferencesParams,\n  ): Promise<MobileNotificationPreferences> {\n    const body: MobileServerPublicQueryRequest<'notification_preferences'> = {\n      type: 'notification_preferences',\n      expo_token: params.expoToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileNotificationPreferences(data.preferences);\n  }\n\n  /*\n  Public executes\n   */\n\n  /**\n   * Unregisters an Expo push token, stopping delivery to that device. Unsigned, so it still works at logout\n   * when a wallet signature may no longer be obtainable. Idempotent: unregistering an inactive or unknown\n   * well-formed token succeeds.\n   *\n   * A registration that commits after this call re-activates the token, so stop or await any in-flight\n   * {@link MobileClient.registerExpoToken} before unregistering.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed.\n   */\n  async unregisterExpoToken(\n    params: MobileUnregisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const body: MobileServerPublicExecuteRequest<'unregister_expo_token'> = {\n      type: 'unregister_expo_token',\n      expo_token: params.expoToken,\n    };\n    return this.publicExecute(body);\n  }\n\n  /**\n   * Replaces the push notification preferences of the wallet that owns the given Expo push token. Possession\n   * of an active token is the credential rather than a signature, so anyone holding the token can overwrite\n   * that wallet's preferences. The backend requires `schemaVersion` of 1, exactly one entry per known\n   * category, and empty `scopes` on every entry.\n   *\n   * Writes are last-write-wins on commit order rather than ordered by a client nonce, so callers must\n   * serialize their own preference writes.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated, or\n   * `INVALID_EXPO_TOKEN` if the token is malformed or is not currently registered to a wallet.\n   */\n  async updateNotificationPreferences(\n    params: MobileUpdateNotificationPreferencesParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const body: MobileServerPublicExecuteRequest<'update_preferences'> = {\n      type: 'update_preferences',\n      expo_token: params.expoToken,\n      preferences: mapMobileNotificationPreferencesToServer(params.preferences),\n    };\n    return this.publicExecute(body);\n  }\n\n  /*\n  Signed queries\n   */\n\n  /**\n   * Fetches the caller's own identity for a subaccount. Every non-isolated subaccount has an implicit\n   * identity, so this resolves for any valid sender with `username` and `displayName` `null` until a username\n   * is claimed.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_IDENTITY_TARGET` if the sender is in the\n   * engine-created isolated namespace, which cannot own an identity.\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 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   * Sets a subaccount's username, derived from the given display name. Upserts: the same call claims a first\n   * username and renames an existing one, so callers never need to read the current identity first.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_DISPLAY_NAME` if the display name violates\n   * `MOBILE_DISPLAY_NAME_PATTERN`, `USERNAME_UNAVAILABLE` if the derived username is reserved or already\n   * taken by another subaccount, `INVALID_IDENTITY_TARGET` if the sender is in the engine-created isolated\n   * namespace, or `STALE_IDENTITY_UPDATE` if another identity write for this subaccount committed with a\n   * later nonce (re-read the identity before retrying).\n   */\n  async setUsername(\n    params: MobileSetUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest('set_username', 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  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 publicExecute(\n    body: MobileServerPublicExecuteRequest,\n  ): Promise<MobileServerSuccessResponse> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/mobile/public_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  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":";;;;;;;;;;;;AAmFA,IAAa,eAAb,MAA0B;CAIxB,YAAY,MAAwB;EAClC,KAAK,OAAO;EACZ,KAAK,gBAAgB,MAAM,OAAO;GAChC,iBAAiB;GAEjB,sBAAsB;EACxB,CAAC;CACH;;;;;;CAOA,gBACE,0BACA;EACA,KAAK,KAAK,2BAA2B,4BAA4B,KAAA;CACnE;;;;CASA,MAAM,wBACJ,QACqC;EACrC,MAAM,OAAgE;GACpE,MAAM;GACN,cAAc,OAAO;EACvB;EACA,MAAM,OAAO,MAAM,KAAK,YAAY,IAAI;EACxC,OAAO;GAAE,UAAU,KAAK;GAAU,WAAW,KAAK;EAAU;CAC9D;;;;;;;;;CAUA,MAAM,iBACJ,QAC8B;EAC9B,MAAM,OAAkD;GACtD,MAAM;GACN,YAAY,gBAAgB,MAAM;EACpC;EAEA,OAAO,wBAAuB,MADX,KAAK,YAAY,IAAI,GACL,OAAO;CAC5C;;;;;;;;;;;;;CAcA,MAAM,QAAQ,SAA8B,CAAC,GAA4B;EACvE,MAAM,OAA+C;GACnD,MAAM;GACN,kBAAkB,OAAO;GACzB,OAAO,OAAO;GACd,QAAQ,OAAO;EACjB;EAEA,OAAO,kBAAkB,MADN,KAAK,YAAY,IAAI,CACX;CAC/B;;;;;;;;;CAUA,MAAM,2BACJ,QACwC;EACxC,MAAM,OAAmE;GACvE,MAAM;GACN,YAAY,OAAO;EACrB;EAEA,OAAO,kCAAiC,MADrB,KAAK,YAAY,IAAI,GACK,WAAW;CAC1D;;;;;;;;;;;CAgBA,MAAM,oBACJ,QACsC;EACtC,MAAM,OAAkE;GACtE,MAAM;GACN,YAAY,OAAO;EACrB;EACA,OAAO,KAAK,cAAc,IAAI;CAChC;;;;;;;;;;;;;CAcA,MAAM,8BACJ,QACsC;EACtC,MAAM,OAA+D;GACnE,MAAM;GACN,YAAY,OAAO;GACnB,aAAa,yCAAyC,OAAO,WAAW;EAC1E;EACA,OAAO,KAAK,cAAc,IAAI;CAChC;;;;;;;;;CAcA,MAAM,gBACJ,QACgC;EAChC,MAAM,gBAAgB,MAAM,KAAK,iBAC/B,iBACA,QACA,CAAC,CACH;EACA,MAAM,OAAO,MAAM,KAAK,MAAuB,aAAa;EAC5D,OAAO,KAAK,WAAW,kBAAkB,KAAK,QAAQ,IAAI;CAC5D;;;;CAKA,MAAM,qBACJ,QACmC;EACnC,MAAM,gBAAgB,MAAM,KAAK,iBAC/B,sBACA,QACA,CAAC,CACH;EAEA,QAAO,MADY,KAAK,MAA4B,aAAa,GACrD,QAAQ,IAAI,yBAAyB;CACnD;;;;;;;;;;;CAgBA,MAAM,YACJ,QACsC;EACtC,MAAM,gBAAgB,MAAM,KAAK,iBAAiB,gBAAgB,QAAQ,EACxE,cAAc,OAAO,YACvB,CAAC;EACD,OAAO,KAAK,QAAQ,aAAa;CACnC;;;;CAKA,MAAM,eACJ,QACsC;EACtC,MAAM,gBAAgB,MAAM,KAAK,iBAC/B,oBACA,QACA,EAAE,cAAc,OAAO,YAAY,CACrC;EACA,OAAO,KAAK,QAAQ,aAAa;CACnC;;;;;;;;;CAUA,MAAM,kBACJ,QACsC;EACtC,MAAM,gBAAgB,MAAM,KAAK,iBAC/B,uBACA,QACA;GACE,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,QAAQ,OAAO,UAAU;GACzB,aAAa,OAAO,cAAc;EACpC,CACF;EACA,OAAO,KAAK,QAAQ,aAAa;CACnC;CAMA,MAAgB,iBACd,MACA,QACA,aAC8B;EAE9B,MAAM,eACJ,KAAK,KAAK,4BAA4B,KAAK,KAAK;EAElD,IAAI,gBAAgB,MAClB,MAAM,IAAI,uBAAuB;EAGnC,MAAM,QAAQ;GAAE;GAAM,GAAG;EAAY;EACrC,OAAO,yBAAyB;GAAE,GAAG;GAAQ;GAAc;EAAM,CAAC;CACpE;CAIA,MAAgB,YACd,MACoD;EACpD,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,uBACjB,IACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;CAEA,MAAgB,cACd,MACsC;EACtC,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,yBACjB,IACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;CAEA,MAAgB,MACd,MACoD;EACpD,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,gBACjB,IACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;CAEA,MAAgB,QACd,MACsC;EACtC,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,kBACjB,IACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;;;;;;CAOA,oBAA4B,UAAkC;EAC5D,IAAI,SAAS,UAAU,OAAO,SAAS,SAAS,KAC9C;EAEF,IAAI,8BAA8B,SAAS,IAAI,GAC7C,MAAM,IAAI,yBAAyB,SAAS,MAAM,SAAS,MAAM;EAEnE,MAAM,IAAI,MACR,4CAA4C,SAAS,OAAO,GAAG,SAAS,WAAW,UAAU,KAAK,UAAU,SAAS,IAAI,GAC3H;CACF;CAEA,kBAA0B,UAAkC;EAC1D,MAAM,EAAE,SAAS;EAEjB,IAAI,8BAA8B,IAAI,GACpC,MAAM,IAAI,yBAAyB,MAAM,SAAS,MAAM;EAE1D,IAAI,CAAC,8BAA8B,IAAI,GACrC,MAAM,IAAI,MACR,4EAA4E,KAAK,UAAU,IAAI,GACjG;CAEJ;AACF"}

package/dist/{MobileServerFailureError-ZggEcEda.d.cts → MobileServerFailureError-BoyAfEZA.d.cts}

@@ -1,4 +1,5 @@
-import { i as MobileServerRequestType, t as MobileServerFailureResponse } from "./serverBaseTypes-BicXMrZV.cjs";
+import { o as MobileServerRequestType } from "./serverRequestTypes-CHDk6JwE.cjs";
+import { t as MobileServerFailureResponse } from "./serverBaseTypes-DSRgU2Fb.cjs";
 import { BaseServerFailureError } from "@nadohq/shared";
 
 //#region src/types/MobileServerFailureError.d.ts
@@ -19,4 +20,4 @@ declare class MobileServerFailureError extends BaseServerFailureError {
 }
 //#endregion
 export { MobileServerFailureError as t };
-//# sourceMappingURL=MobileServerFailureError-ZggEcEda.d.cts.map
+//# sourceMappingURL=MobileServerFailureError-BoyAfEZA.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MobileServerFailureError-BoyAfEZA.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-f9KhKnJj.d.ts → MobileServerFailureError-MgYVBh5p.d.ts}

@@ -1,4 +1,5 @@
-import { i as MobileServerRequestType, t as MobileServerFailureResponse } from "./serverBaseTypes-ewbo8l4R.js";
+import { o as MobileServerRequestType } from "./serverRequestTypes-DYTLrCpz.js";
+import { t as MobileServerFailureResponse } from "./serverBaseTypes-CzRgwUvA.js";
 import { BaseServerFailureError } from "@nadohq/shared";
 
 //#region src/types/MobileServerFailureError.d.ts
@@ -19,4 +20,4 @@ declare class MobileServerFailureError extends BaseServerFailureError {
 }
 //#endregion
 export { MobileServerFailureError as t };
-//# sourceMappingURL=MobileServerFailureError-f9KhKnJj.d.ts.map
+//# sourceMappingURL=MobileServerFailureError-MgYVBh5p.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MobileServerFailureError-MgYVBh5p.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-BsbBkU0K.d.cts → buildSignedMobileRequest-CBMt97aY.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-bNB98pYk.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-CBMt97aY.d.cts.map

package/dist/{buildSignedMobileRequest-BsbBkU0K.d.cts.map → buildSignedMobileRequest-CBMt97aY.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-CBMt97aY.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/{buildSignedMobileRequest-CDRsRNHm.d.ts → buildSignedMobileRequest-qEC4gWaI.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-CQE3HD2V.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-qEC4gWaI.d.ts.map

package/dist/{buildSignedMobileRequest-CDRsRNHm.d.ts.map → buildSignedMobileRequest-qEC4gWaI.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-qEC4gWaI.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/{canonicalize-PX6dTIdF.d.ts → canonicalize-QNARV_Xc.d.cts}

@@ -1,14 +1,14 @@
-import { n as MobileSignedInner } from "./types-B76Pn7Sy.js";
+import { n as MobileSignedInner } from "./types-bNB98pYk.cjs";
 
 //#region src/signing/canonicalize.d.ts
 /**
  * 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.
  */
 declare function canonicalizeMobileInner(inner: MobileSignedInner): MobileSignedInner;
 //#endregion
 export { canonicalizeMobileInner as t };
-//# sourceMappingURL=canonicalize-PX6dTIdF.d.ts.map
+//# sourceMappingURL=canonicalize-QNARV_Xc.d.cts.map

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

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

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

@@ -1,14 +1,14 @@
-import { n as MobileSignedInner } from "./types-uCD4BNZR.cjs";
+import { n as MobileSignedInner } from "./types-CQE3HD2V.js";
 
 //#region src/signing/canonicalize.d.ts
 /**
  * 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.
  */
 declare function canonicalizeMobileInner(inner: MobileSignedInner): MobileSignedInner;
 //#endregion
 export { canonicalizeMobileInner as t };
-//# sourceMappingURL=canonicalize-Dm7sXwPg.d.cts.map
+//# sourceMappingURL=canonicalize-wVdGejB1.d.ts.map

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

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