@nadohq/mobile-client 0.54.0 → 0.56.0

package/dist/{types-B_4veFLc.d.ts → types-B021odcS.d.ts}

@@ -1,5 +1,5 @@
-import { l as MobileNotificationPlatform } from "./serverModelTypes-MlqdaMRd.js";
-import { F as MobileSignedRequestParams } from "./clientTypes-P4LAjreY.js";
+import { d as MobileServerAvatarSelection, l as MobileNotificationPlatform } from "./serverModelTypes-DAqEyYtB.js";
+import { V as MobileSignedRequestParams } from "./clientTypes-ws9CDHw4.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { Hex } from "viem";
 
@@ -19,6 +19,15 @@ import { Hex } from "viem";
  * lowercases; unlike bytes32, string fields such as `display_name` are hashed as-is and keep their casing.
  */
 type MobileSignedInner = {
+  type: 'set_bio';
+  bio: string;
+} | {
+  type: 'create_avatar_upload';
+  content_length: number;
+} | {
+  type: 'set_avatar';
+  avatar: MobileServerAvatarSelection | null;
+} | {
   type: 'set_username';
   display_name: string;
 } | {
@@ -68,4 +77,4 @@ interface BuildSignedMobileRequestParams extends MobileSignedRequestParams {
 }
 //#endregion
 export { MobileSignedRequest as a, MobileSignedInnerParams as i, MobileSignedInner as n, MobileSignedInnerByType as r, BuildSignedMobileRequestParams as t };
-//# sourceMappingURL=types-B_4veFLc.d.ts.map
+//# sourceMappingURL=types-B021odcS.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-B021odcS.d.ts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAsBA;;;;;;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAiB,GAAA;AAAA;EACjB,IAAA;EAA8B,cAAA;AAAA;EAE9B,IAAA;EACA,MAAA,EAAQ,2BAAA;AAAA;EAER,IAAA;EAAsB,YAAA;AAAA;EACtB,IAAA;EAA0B,YAAA;AAAA;EAE1B,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAAA;EAGV,MAAA;EACA,WAAA;AAAA;EAGA,IAAA;EACA,UAAA,EAAY,GAAA,EASmB;EAP/B,YAAA;AAAA;;;;KAMM,uBAAA,WAAkC,iBAAA,YAC5C,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;AAAC;AAMtC;KAAY,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,uBAAA,CAAwB,CAAA;;;;;KAQd,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;EAbsB;;;EAiB7B,KAAA;AAAA"}

package/dist/{types-CwpXP7xM.d.cts → types-l47aSWtA.d.cts}

@@ -1,5 +1,5 @@
-import { l as MobileNotificationPlatform } from "./serverModelTypes-MlqdaMRd.cjs";
-import { F as MobileSignedRequestParams } from "./clientTypes-YF5d8bvg.cjs";
+import { d as MobileServerAvatarSelection, l as MobileNotificationPlatform } from "./serverModelTypes-DAqEyYtB.cjs";
+import { V as MobileSignedRequestParams } from "./clientTypes-DnPE1zZO.cjs";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { Hex } from "viem";
 
@@ -19,6 +19,15 @@ import { Hex } from "viem";
  * lowercases; unlike bytes32, string fields such as `display_name` are hashed as-is and keep their casing.
  */
 type MobileSignedInner = {
+  type: 'set_bio';
+  bio: string;
+} | {
+  type: 'create_avatar_upload';
+  content_length: number;
+} | {
+  type: 'set_avatar';
+  avatar: MobileServerAvatarSelection | null;
+} | {
   type: 'set_username';
   display_name: string;
 } | {
@@ -68,4 +77,4 @@ interface BuildSignedMobileRequestParams extends MobileSignedRequestParams {
 }
 //#endregion
 export { MobileSignedRequest as a, MobileSignedInnerParams as i, MobileSignedInner as n, MobileSignedInnerByType as r, BuildSignedMobileRequestParams as t };
-//# sourceMappingURL=types-CwpXP7xM.d.cts.map
+//# sourceMappingURL=types-l47aSWtA.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-l47aSWtA.d.cts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAsBA;;;;;;;;;;;;KAAY,iBAAA;EACN,IAAA;EAAiB,GAAA;AAAA;EACjB,IAAA;EAA8B,cAAA;AAAA;EAE9B,IAAA;EACA,MAAA,EAAQ,2BAAA;AAAA;EAER,IAAA;EAAsB,YAAA;AAAA;EACtB,IAAA;EAA0B,YAAA;AAAA;EAE1B,IAAA;EACA,UAAA;EACA,QAAA,EAAU,0BAAA;EAGV,MAAA;EACA,WAAA;AAAA;EAGA,IAAA;EACA,UAAA,EAAY,GAAA,EASmB;EAP/B,YAAA;AAAA;;;;KAMM,uBAAA,WAAkC,iBAAA,YAC5C,OAAA,CAAQ,iBAAA;EAAqB,IAAA,EAAM,CAAA;AAAA;;;AAAC;AAMtC;KAAY,uBAAA,WAAkC,iBAAA,YAA6B,IAAA,CACzE,uBAAA,CAAwB,CAAA;;;;;KAQd,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;EAbsB;;;EAiB7B,KAAA;AAAA"}

package/dist/utils/index.cjs

@@ -3,6 +3,9 @@ const require_utils_serverResponseGuards = require("./serverResponseGuards.cjs")
 const require_utils_feed = require("./feed.cjs");
 const require_utils_follow = require("./follow.cjs");
 const require_utils_patterns = require("./patterns.cjs");
+const require_utils_profile = require("./profile.cjs");
+exports.MOBILE_AVATAR_MAX_UPLOAD_BYTES = require_utils_profile.MOBILE_AVATAR_MAX_UPLOAD_BYTES;
+exports.MOBILE_BIO_MAX_LENGTH = require_utils_profile.MOBILE_BIO_MAX_LENGTH;
 exports.MOBILE_DISPLAY_NAME_PATTERN = require_utils_patterns.MOBILE_DISPLAY_NAME_PATTERN;
 exports.MOBILE_FEED_MAX_PAGE_SIZE = require_utils_feed.MOBILE_FEED_MAX_PAGE_SIZE;
 exports.MOBILE_FEED_MIN_NOTIONAL_FLOOR = require_utils_feed.MOBILE_FEED_MIN_NOTIONAL_FLOOR;
@@ -12,3 +15,4 @@ exports.MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE = require_utils_follow.MOBILE_FOLLOW_LI
 exports.MOBILE_PROFILES_MAX_BATCH_SIZE = require_utils_follow.MOBILE_PROFILES_MAX_BATCH_SIZE;
 exports.isMobileServerFailureResponse = require_utils_serverResponseGuards.isMobileServerFailureResponse;
 exports.isMobileServerSuccessResponse = require_utils_serverResponseGuards.isMobileServerSuccessResponse;
+exports.isValidMobileBio = require_utils_profile.isValidMobileBio;

package/dist/utils/index.d.cts

@@ -1,5 +1,6 @@
 import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-DTJlsg8W.cjs";
 import { i as MOBILE_PROFILES_MAX_BATCH_SIZE, n as MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, r as MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, t as MOBILE_FOLLOWED_BY_PREVIEW_LIMIT } from "../follow-D6Mg8GHx.cjs";
 import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-BE0Audp5.cjs";
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-DIj9MIrJ.cjs";
-export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+import { n as MOBILE_BIO_MAX_LENGTH, r as isValidMobileBio, t as MOBILE_AVATAR_MAX_UPLOAD_BYTES } from "../profile-BozA3yVP.cjs";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-DGhrUL_c.cjs";
+export { MOBILE_AVATAR_MAX_UPLOAD_BYTES, MOBILE_BIO_MAX_LENGTH, MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE, isMobileServerFailureResponse, isMobileServerSuccessResponse, isValidMobileBio };

package/dist/utils/index.d.ts

@@ -1,5 +1,6 @@
 import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-DTJlsg8W.js";
 import { i as MOBILE_PROFILES_MAX_BATCH_SIZE, n as MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, r as MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, t as MOBILE_FOLLOWED_BY_PREVIEW_LIMIT } from "../follow-D6Mg8GHx.js";
 import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-BE0Audp5.js";
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-DY_8lAo7.js";
-export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+import { n as MOBILE_BIO_MAX_LENGTH, r as isValidMobileBio, t as MOBILE_AVATAR_MAX_UPLOAD_BYTES } from "../profile-BozA3yVP.js";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-BGHTBbtz.js";
+export { MOBILE_AVATAR_MAX_UPLOAD_BYTES, MOBILE_BIO_MAX_LENGTH, MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE, isMobileServerFailureResponse, isMobileServerSuccessResponse, isValidMobileBio };

package/dist/utils/index.js

@@ -2,4 +2,5 @@ import { isMobileServerFailureResponse, isMobileServerSuccessResponse } from "./
 import { MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR } from "./feed.js";
 import { MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE } from "./follow.js";
 import { MOBILE_DISPLAY_NAME_PATTERN } from "./patterns.js";
-export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+import { MOBILE_AVATAR_MAX_UPLOAD_BYTES, MOBILE_BIO_MAX_LENGTH, isValidMobileBio } from "./profile.js";
+export { MOBILE_AVATAR_MAX_UPLOAD_BYTES, MOBILE_BIO_MAX_LENGTH, MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE, isMobileServerFailureResponse, isMobileServerSuccessResponse, isValidMobileBio };

package/dist/utils/profile.cjs

@@ -0,0 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/profile.ts
+/**
+* Maximum biography length in Unicode code points. Exceeding it fails with `INVALID_BIO`.
+*/
+const MOBILE_BIO_MAX_LENGTH = 150;
+/**
+* Maximum JPEG or PNG upload size in bytes. Exceeding it fails with `INVALID_AVATAR`.
+*/
+const MOBILE_AVATAR_MAX_UPLOAD_BYTES = 5 * 1024 * 1024;
+/**
+* Checks biography protocol limits; whitespace-only text is valid and clears the bio.
+*/
+function isValidMobileBio(bio) {
+	return !bio.includes("\0") && Array.from(bio).length <= 150;
+}
+//#endregion
+exports.MOBILE_AVATAR_MAX_UPLOAD_BYTES = MOBILE_AVATAR_MAX_UPLOAD_BYTES;
+exports.MOBILE_BIO_MAX_LENGTH = MOBILE_BIO_MAX_LENGTH;
+exports.isValidMobileBio = isValidMobileBio;
+
+//# sourceMappingURL=profile.cjs.map

package/dist/utils/profile.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.cjs","names":[],"sources":["../../src/utils/profile.ts"],"sourcesContent":["/**\n * Maximum biography length in Unicode code points. Exceeding it fails with `INVALID_BIO`.\n */\nexport const MOBILE_BIO_MAX_LENGTH = 150;\n\n/**\n * Maximum JPEG or PNG upload size in bytes. Exceeding it fails with `INVALID_AVATAR`.\n */\nexport const MOBILE_AVATAR_MAX_UPLOAD_BYTES = 5 * 1024 * 1024;\n\n/**\n * Checks biography protocol limits; whitespace-only text is valid and clears the bio.\n */\nexport function isValidMobileBio(bio: string): boolean {\n  return !bio.includes('\\0') && Array.from(bio).length <= MOBILE_BIO_MAX_LENGTH;\n}\n"],"mappings":";;;;;AAGA,MAAa,wBAAwB;;;;AAKrC,MAAa,iCAAiC,IAAI,OAAO;;;;AAKzD,SAAgB,iBAAiB,KAAsB;CACrD,OAAO,CAAC,IAAI,SAAS,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE,UAAA;AAChD"}

package/dist/utils/profile.d.cts

@@ -0,0 +1,2 @@
+import { n as MOBILE_BIO_MAX_LENGTH, r as isValidMobileBio, t as MOBILE_AVATAR_MAX_UPLOAD_BYTES } from "../profile-BozA3yVP.cjs";
+export { MOBILE_AVATAR_MAX_UPLOAD_BYTES, MOBILE_BIO_MAX_LENGTH, isValidMobileBio };

package/dist/utils/profile.d.ts

@@ -0,0 +1,2 @@
+import { n as MOBILE_BIO_MAX_LENGTH, r as isValidMobileBio, t as MOBILE_AVATAR_MAX_UPLOAD_BYTES } from "../profile-BozA3yVP.js";
+export { MOBILE_AVATAR_MAX_UPLOAD_BYTES, MOBILE_BIO_MAX_LENGTH, isValidMobileBio };

package/dist/utils/profile.js

@@ -0,0 +1,19 @@
+//#region src/utils/profile.ts
+/**
+* Maximum biography length in Unicode code points. Exceeding it fails with `INVALID_BIO`.
+*/
+const MOBILE_BIO_MAX_LENGTH = 150;
+/**
+* Maximum JPEG or PNG upload size in bytes. Exceeding it fails with `INVALID_AVATAR`.
+*/
+const MOBILE_AVATAR_MAX_UPLOAD_BYTES = 5 * 1024 * 1024;
+/**
+* Checks biography protocol limits; whitespace-only text is valid and clears the bio.
+*/
+function isValidMobileBio(bio) {
+	return !bio.includes("\0") && Array.from(bio).length <= 150;
+}
+//#endregion
+export { MOBILE_AVATAR_MAX_UPLOAD_BYTES, MOBILE_BIO_MAX_LENGTH, isValidMobileBio };
+
+//# sourceMappingURL=profile.js.map

package/dist/utils/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","names":[],"sources":["../../src/utils/profile.ts"],"sourcesContent":["/**\n * Maximum biography length in Unicode code points. Exceeding it fails with `INVALID_BIO`.\n */\nexport const MOBILE_BIO_MAX_LENGTH = 150;\n\n/**\n * Maximum JPEG or PNG upload size in bytes. Exceeding it fails with `INVALID_AVATAR`.\n */\nexport const MOBILE_AVATAR_MAX_UPLOAD_BYTES = 5 * 1024 * 1024;\n\n/**\n * Checks biography protocol limits; whitespace-only text is valid and clears the bio.\n */\nexport function isValidMobileBio(bio: string): boolean {\n  return !bio.includes('\\0') && Array.from(bio).length <= MOBILE_BIO_MAX_LENGTH;\n}\n"],"mappings":";;;;AAGA,MAAa,wBAAwB;;;;AAKrC,MAAa,iCAAiC,IAAI,OAAO;;;;AAKzD,SAAgB,iBAAiB,KAAsB;CACrD,OAAO,CAAC,IAAI,SAAS,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE,UAAA;AAChD"}

package/dist/utils/serverResponseGuards.d.cts

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

package/dist/utils/serverResponseGuards.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadohq/mobile-client",
-  "version": "0.54.0",
+  "version": "0.56.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.54.0",
+    "@nadohq/shared": "^0.56.0",
     "axios": "1.16.1"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
     "bignumber.js": "11.1.1",
     "viem": "2.52.0"
   },
-  "gitHead": "83485ee66ad20b239387e271a2945386b39e824e"
+  "gitHead": "1b86723bc243f149ddf9e0d70a6be6d4bf3960a3"
 }

package/src/MobileClient.ts

@@ -6,6 +6,9 @@ import {
 } from '@nadohq/shared';
 import axios, { AxiosInstance, AxiosResponse } from 'axios';
 import {
+  mapMobileAvatarPreset,
+  mapMobileAvatarSelectionToServer,
+  mapMobileAvatarUpload,
   mapMobileFeedPage,
   mapMobileFollowListPage,
   mapMobileFollowListParamsToServer,
@@ -46,6 +49,9 @@ import {
   GetMobileRegisteredWalletParams,
   GetMobileTopTradersFeedParams,
   GetMobileUsernameAvailabilityParams,
+  MobileAvatarPreset,
+  MobileAvatarUpload,
+  MobileCreateAvatarUploadParams,
   MobileFeedPage,
   MobileFollowListPage,
   MobileFollowMutationResult,
@@ -53,6 +59,8 @@ import {
   MobilePublicProfile,
   MobileRegisteredWallet,
   MobileRegisterExpoTokenParams,
+  MobileSetAvatarParams,
+  MobileSetBioParams,
   MobileSetFollowParams,
   MobileSetPrivateModeParams,
   MobileSetUsernameParams,
@@ -110,9 +118,9 @@ export interface MobileClientOpts {
 }
 
 /**
- * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed,
- * session-based social feeds, the follower/following graph, privacy settings, and push notification
- * device/preference management.
+ * Client for the Nado mobile service API: usernames, bios, avatars, public profile lookups, the global
+ * trade feed, session-based social feeds, the follower/following graph, privacy settings, and push
+ * notification device/preference management.
  */
 export class MobileClient {
   readonly opts: MobileClientOpts;
@@ -143,6 +151,19 @@ export class MobileClient {
   Public queries
    */
 
+  /**
+   * Returns the current server-owned avatar catalogue in display order.
+   *
+   * @throws {MobileServerFailureError} With `SERVICE_UNAVAILABLE` when avatar storage is not configured.
+   */
+  async getAvatarPresets(): Promise<MobileAvatarPreset[]> {
+    const body: MobileServerPublicQueryRequest<'avatar_presets'> = {
+      type: 'avatar_presets',
+    };
+    const data = await this.publicQuery(body);
+    return data.presets.map(mapMobileAvatarPreset);
+  }
+
   /**
    * Checks whether a username derived from the given display name is available to claim.
    */
@@ -510,10 +531,70 @@ export class MobileClient {
   Signed executes
    */
 
+  /**
+   * Updates the biography, or clears it when the text is whitespace-only.
+   *
+   * Serialize this with {@link MobileClient.setAvatar}, {@link MobileClient.setUsername} and
+   * {@link MobileClient.setPrivateMode} for the same subaccount: all share the identity update nonce.
+   *
+   * @throws {MobileServerFailureError} With `INVALID_BIO` for exceeding `MOBILE_BIO_MAX_LENGTH` or null
+   * characters, `INVALID_IDENTITY_TARGET` for an isolated subaccount, or `STALE_IDENTITY_UPDATE` when a
+   * later write has committed (re-read the profile before retrying).
+   */
+  async setBio(
+    params: MobileSetBioParams,
+  ): Promise<MobileServerSuccessResponse> {
+    const signedRequest = await this.getSignedRequest('set_bio', params, {
+      bio: params.bio,
+    });
+    return this.execute(signedRequest);
+  }
+
+  /**
+   * Creates a short-lived upload grant. The caller uploads an image meeting {@link MobileAvatarUpload}'s requirements;
+   * file access and transport remain platform-specific. This does not change the saved avatar.
+   *
+   * @throws {MobileServerFailureError} With `INVALID_AVATAR` for a zero or oversized upload,
+   * `INVALID_IDENTITY_TARGET` for an isolated subaccount, or `SERVICE_UNAVAILABLE` when storage is unavailable.
+   */
+  async createAvatarUpload(
+    params: MobileCreateAvatarUploadParams,
+  ): Promise<MobileAvatarUpload> {
+    const signedRequest = await this.getSignedRequest(
+      'create_avatar_upload',
+      params,
+      { content_length: params.contentLength },
+    );
+    const data = await this.execute(signedRequest);
+    return mapMobileAvatarUpload(data);
+  }
+
+  /**
+   * Publishes a preset/staged upload, or clears the saved avatar when avatar is null.
+   * Uploaded JPEG/PNG images must be square, at most 4096 × 4096 pixels, and within
+   * `MOBILE_AVATAR_MAX_UPLOAD_BYTES`. A successful PUT can still fail this publication check.
+   *
+   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.
+   *
+   * @throws {MobileServerFailureError} With `INVALID_AVATAR` for an invalid preset, staging key, or image,
+   * `INVALID_IDENTITY_TARGET` for an isolated subaccount, `SERVICE_UNAVAILABLE` when storage is unavailable,
+   * or `STALE_IDENTITY_UPDATE` when a later write has committed (re-read the profile before retrying).
+   */
+  async setAvatar(
+    params: MobileSetAvatarParams,
+  ): Promise<MobileServerSuccessResponse> {
+    const signedRequest = await this.getSignedRequest('set_avatar', params, {
+      avatar: mapMobileAvatarSelectionToServer(params.avatar),
+    });
+    return this.execute(signedRequest);
+  }
+
   /**
    * 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.
    *
+   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.
+   *
    * @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
@@ -531,6 +612,7 @@ export class MobileClient {
 
   /**
    * Sets whether a subaccount's profile is private.
+   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.
    */
   async setPrivateMode(
     params: MobileSetPrivateModeParams,

package/src/dataMappers.ts

@@ -1,6 +1,9 @@
 import { removeDecimals, subaccountToHex, toBigNumber } from '@nadohq/shared';
 import {
   GetMobileFollowListParams,
+  MobileAvatarPreset,
+  MobileAvatarSelection,
+  MobileAvatarUpload,
   MobileFeedPage,
   MobileFeedTrade,
   MobileFollowListPage,
@@ -34,8 +37,13 @@ import {
   MobileSocialFeedTraderBadge,
   MobileSocialFeedUpdates,
 } from './types/clientTypes';
-import { MobileServerFollowMutationResponse } from './types/serverExecuteTypes';
 import {
+  MobileServerAvatarUploadResponse,
+  MobileServerFollowMutationResponse,
+} from './types/serverExecuteTypes';
+import {
+  MobileServerAvatarPreset,
+  MobileServerAvatarSelection,
   MobileServerFeedTrade,
   MobileServerFollowSummary,
   MobileServerIdentitySummary,
@@ -74,6 +82,44 @@ import {
   MobileServerSocialFeedReadParams,
 } from './types/serverRequestTypes';
 
+/**
+ * Maps a server-side avatar preset to its client-side representation.
+ */
+export function mapMobileAvatarPreset(
+  server: MobileServerAvatarPreset,
+): MobileAvatarPreset {
+  return { id: server.id, avatarUrl: server.avatar_url };
+}
+
+/**
+ * Maps an upload grant, preserving the signed PUT headers and server-provided lifetime.
+ */
+export function mapMobileAvatarUpload(
+  server: MobileServerAvatarUploadResponse,
+): MobileAvatarUpload {
+  return {
+    uploadKey: server.upload_key,
+    uploadUrl: server.upload_url,
+    headers: server.headers,
+    expiresInSeconds: server.expires_in_seconds,
+  };
+}
+
+/**
+ * Maps a client-side avatar selection to the signed wire payload; null clears the saved avatar.
+ */
+export function mapMobileAvatarSelectionToServer(
+  avatar: MobileAvatarSelection | null,
+): MobileServerAvatarSelection | null {
+  if (avatar === null) {
+    return null;
+  }
+  if (avatar.type === 'preset') {
+    return { type: 'preset', id: avatar.id };
+  }
+  return { type: 'upload', upload_key: avatar.uploadKey };
+}
+
 /**
  * Maps a server-side public profile (snake_case) to its client-side (camelCase) representation. The three
  * include-gated fields stay `undefined` when the backend omitted them, rather than being coerced to `null`
@@ -83,9 +129,8 @@ export function mapMobilePublicProfile(
   server: MobileServerProfile,
 ): MobilePublicProfile {
   return {
-    subaccount: server.subaccount,
-    username: server.username,
-    displayName: server.display_name,
+    ...mapMobileIdentitySummary(server),
+    bio: server.bio,
     privateMode: server.private_mode,
     followerCount: server.follower_count,
     followingCount: server.following_count,

package/src/signing/canonicalize.ts

@@ -11,6 +11,26 @@ export function canonicalizeMobileInner(
   inner: MobileSignedInner,
 ): MobileSignedInner {
   switch (inner.type) {
+    case 'set_bio':
+      return { type: 'set_bio', bio: inner.bio };
+    case 'create_avatar_upload':
+      return {
+        type: 'create_avatar_upload',
+        content_length: inner.content_length,
+      };
+    case 'set_avatar': {
+      const avatar = inner.avatar;
+      if (avatar === null) {
+        return { type: 'set_avatar', avatar: null };
+      }
+      return {
+        type: 'set_avatar',
+        avatar:
+          avatar.type === 'preset'
+            ? { type: 'preset', id: avatar.id }
+            : { type: 'upload', upload_key: avatar.upload_key },
+      };
+    }
     case 'set_username':
       return { type: 'set_username', display_name: inner.display_name };
     case 'set_private_mode':

package/src/signing/eip712MethodByType.ts

@@ -7,6 +7,9 @@ export const MOBILE_EIP712_METHOD_BY_TYPE: Record<
   MobileSignedInner['type'],
   string
 > = {
+  set_bio: 'mobile:execute_set_bio',
+  create_avatar_upload: 'mobile:execute_create_avatar_upload',
+  set_avatar: 'mobile:execute_set_avatar',
   set_username: 'mobile:execute_set_username',
   set_private_mode: 'mobile:execute_set_private_mode',
   register_expo_token: 'mobile:execute_register_expo_token',

package/src/signing/signing.test.ts

@@ -19,9 +19,18 @@ const FIXED_PRIVATE_KEY =
   '0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b786907' as const;
 const FIXED_VERIFYING_ADDR = '0x0000000000000000000000000000000000000001';
 
-// Every hash here mirrors the backend's pinned fixtures in mobile/src/api/types.rs, so a divergence is a
+// Every hash here mirrors the backend's pinned fixtures in mobile/src/api, so a divergence is a
 // real wire-format break rather than a stale expectation.
 const PINNED_HASHES = {
+  set_bio: '0x96206cad01c9b00d69412721842ca0866bb1a82ec90f3979b8bcc91dc96a1243',
+  create_avatar_upload:
+    '0xb3811340e751e2799d3a24467fa50aeb221e1ecea5aa6599ab09bd2426162495',
+  set_avatar_preset:
+    '0x9113b26919a71b910a4f61f4342121896a106014acaeef5da5a2d2e3f09e17ab',
+  set_avatar_clear:
+    '0x8ed3e0bc36cda8de523a22414c495e12385366d1cb61622be807b939505174ae',
+  set_avatar_upload:
+    '0xe036ffdffa1fdde9104a1cee9bb254352de293550dade21e439a65fc6fbd3d2c',
   set_username:
     '0xb4a55d9eb0be4e5c9457761c0c34c75cf39f7c07bd170700d8dd5e9c7de4a659',
   set_private_mode:
@@ -40,6 +49,53 @@ const FIXTURE_TARGET_SUBACCOUNT =
 
 describe('[mobile-client]: signing (offline)', () => {
   describe('pinned payload hashes', () => {
+    it('set_bio', () => {
+      const inner: MobileSignedInner = {
+        type: 'set_bio',
+        bio: 'Trading 中文 🚀\nBuilding on @inkhq',
+      };
+      expect(getMobilePayloadHash(canonicalizeMobileInner(inner))).toBe(
+        PINNED_HASHES.set_bio,
+      );
+    });
+
+    it('create_avatar_upload', () => {
+      const inner: MobileSignedInner = {
+        type: 'create_avatar_upload',
+        content_length: 12345,
+      };
+      expect(getMobilePayloadHash(canonicalizeMobileInner(inner))).toBe(
+        PINNED_HASHES.create_avatar_upload,
+      );
+    });
+
+    it('set_avatar (preset)', () => {
+      const inner: MobileSignedInner = {
+        type: 'set_avatar',
+        avatar: { type: 'preset', id: 'penguin' },
+      };
+      expect(getMobilePayloadHash(canonicalizeMobileInner(inner))).toBe(
+        PINNED_HASHES.set_avatar_preset,
+      );
+    });
+
+    it('set_avatar (clear)', () => {
+      const inner: MobileSignedInner = { type: 'set_avatar', avatar: null };
+      expect(getMobilePayloadHash(canonicalizeMobileInner(inner))).toBe(
+        PINNED_HASHES.set_avatar_clear,
+      );
+    });
+
+    it('set_avatar (upload)', () => {
+      const inner: MobileSignedInner = {
+        type: 'set_avatar',
+        avatar: { type: 'upload', upload_key: 'staging/avatars/test' },
+      };
+      expect(getMobilePayloadHash(canonicalizeMobileInner(inner))).toBe(
+        PINNED_HASHES.set_avatar_upload,
+      );
+    });
+
     it('set_username', () => {
       const inner: MobileSignedInner = {
         type: 'set_username',
@@ -91,6 +147,16 @@ describe('[mobile-client]: signing (offline)', () => {
     });
   });
 
+  it('canonicalizes nested avatar fields before hashing', () => {
+    const inner: MobileSignedInner = {
+      avatar: { id: 'penguin', type: 'preset' },
+      type: 'set_avatar',
+    };
+    expect(getMobilePayloadHash(canonicalizeMobileInner(inner))).toBe(
+      PINNED_HASHES.set_avatar_preset,
+    );
+  });
+
   it('canonicalizes msgpack key order regardless of input key order', () => {
     // Deliberately construct the inner payload with `type` last — canonicalizeMobileInner must rebuild it
     // with `type` first so the msgpack encoding (and therefore the payload hash) is deterministic.

package/src/signing/types.ts

@@ -1,7 +1,10 @@
 import { WalletClientWithAccount } from '@nadohq/shared';
 import { Hex } from 'viem';
 import { MobileSignedRequestParams } from '../types/clientTypes';
-import { MobileNotificationPlatform } from '../types/serverModelTypes';
+import {
+  MobileNotificationPlatform,
+  MobileServerAvatarSelection,
+} from '../types/serverModelTypes';
 
 /**
  * Unsigned inner payloads that can be authenticated against the mobile service API.
@@ -18,6 +21,12 @@ import { MobileNotificationPlatform } from '../types/serverModelTypes';
  * lowercases; unlike bytes32, string fields such as `display_name` are hashed as-is and keep their casing.
  */
 export type MobileSignedInner =
+  | { type: 'set_bio'; bio: string }
+  | { type: 'create_avatar_upload'; content_length: number }
+  | {
+      type: 'set_avatar';
+      avatar: MobileServerAvatarSelection | null;
+    }
   | { type: 'set_username'; display_name: string }
   | { type: 'set_private_mode'; private_mode: boolean }
   | {