@nadohq/mobile-client 0.54.0 → 0.56.0

package/README.md

@@ -1,7 +1,7 @@
 # `@nadohq/mobile-client`
 
-HTTP client for the Nado mobile service API. Manages usernames, public profile lookups, global and
-session-based trade feeds, the follower/following graph, privacy settings, and push notification
+HTTP client for the Nado mobile service API. Manages usernames, bios, avatars, public profile lookups,
+global and session-based trade feeds, the follower/following graph, privacy settings, and push notification
 devices/preferences. Public queries require no wallet; authenticated operations use EIP-712 + msgpack signing.
 
 [Full SDK Documentation](https://nadohq.github.io/nado-typescript-sdk/index.html)
@@ -46,7 +46,7 @@ await mobile.setUsername({
 
 ### Public Queries
 
-`getUsernameAvailability`, `getProfiles`, `getFollowers`, `getFollowing`, `getFeed`,
+`getAvatarPresets`, `getUsernameAvailability`, `getProfiles`, `getFollowers`, `getFollowing`, `getFeed`,
 `getNotificationPreferences`, `getRegisteredWallet`, `getForYouFeed`, `getTopTradersFeed`,
 `getFriendsFeed`, `getProfileFeed`, `getMarketFeed`, `getPositionFeed`, `getFeedItem`, `getFeedUpdates`.
 
@@ -75,7 +75,7 @@ push token rather than a wallet signature, so they still work at logout when a s
 
 ### Signed Executes
 
-`setUsername`, `setPrivateMode`, `registerExpoToken`, `setFollow`.
+`setUsername`, `setBio`, `createAvatarUpload`, `setAvatar`, `setPrivateMode`, `registerExpoToken`, `setFollow`.
 
 ### Linked Signers
 

package/dist/{MobileClient-BbTaqTzi.cjs → MobileClient-DjNpN7Dw.cjs}

@@ -29,9 +29,9 @@ let axios = require("axios");
 axios = __toESM(axios, 1);
 //#region src/MobileClient.ts
 /**
-* 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.
 */
 var MobileClient = class {
 	constructor(opts) {
@@ -51,6 +51,14 @@ var MobileClient = class {
 		this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? void 0;
 	}
 	/**
+	* Returns the current server-owned avatar catalogue in display order.
+	*
+	* @throws {MobileServerFailureError} With `SERVICE_UNAVAILABLE` when avatar storage is not configured.
+	*/
+	async getAvatarPresets() {
+		return (await this.publicQuery({ type: "avatar_presets" })).presets.map(require_dataMappers.mapMobileAvatarPreset);
+	}
+	/**
 	* Checks whether a username derived from the given display name is available to claim.
 	*/
 	async getUsernameAvailability(params) {
@@ -348,9 +356,51 @@ var MobileClient = class {
 		return this.publicExecute(body);
 	}
 	/**
+	* 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) {
+		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) {
+		const signedRequest = await this.getSignedRequest("create_avatar_upload", params, { content_length: params.contentLength });
+		return require_dataMappers.mapMobileAvatarUpload(await this.execute(signedRequest));
+	}
+	/**
+	* 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) {
+		const signedRequest = await this.getSignedRequest("set_avatar", params, { avatar: require_dataMappers.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
@@ -363,6 +413,7 @@ var MobileClient = class {
 	}
 	/**
 	* Sets whether a subaccount's profile is private.
+	* Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.
 	*/
 	async setPrivateMode(params) {
 		const signedRequest = await this.getSignedRequest("set_private_mode", params, { private_mode: params.privateMode });
@@ -462,4 +513,4 @@ Object.defineProperty(exports, "MobileClient", {
 	}
 });
 
-//# sourceMappingURL=MobileClient-BbTaqTzi.cjs.map
+//# sourceMappingURL=MobileClient-DjNpN7Dw.cjs.map

package/dist/MobileClient-DjNpN7Dw.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileClient-DjNpN7Dw.cjs","names":["mapMobileAvatarPreset","subaccountToHex","mapMobileProfilesIncludeToServer","mapMobilePublicProfile","mapMobileFollowListParamsToServer","mapMobileFollowListPage","mapMobileFeedPage","mapMobileSocialFeedListParamsToServer","mapMobileSocialFeedReadParamsToServer","mapMobileSocialFeedRankedPage","mapMobileSocialFeedTopTradersPage","mapMobileSocialFeedPage","mapMobileSocialFeedItemResponse","mapMobileSocialFeedUpdates","mapMobileNotificationPreferences","mapMobileRegisteredWallet","mapMobileNotificationPreferencesToServer","mapMobileAvatarUpload","mapMobileAvatarSelectionToServer","mapMobileFollowMutationResult","WalletNotProvidedError","buildSignedMobileRequest","isMobileServerFailureResponse","MobileServerFailureError","isMobileServerSuccessResponse"],"sources":["../src/MobileClient.ts"],"sourcesContent":["import {\n  getNadoClientTypeHeaders,\n  subaccountToHex,\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  mapMobileAvatarPreset,\n  mapMobileAvatarSelectionToServer,\n  mapMobileAvatarUpload,\n  mapMobileFeedPage,\n  mapMobileFollowListPage,\n  mapMobileFollowListParamsToServer,\n  mapMobileFollowMutationResult,\n  mapMobileNotificationPreferences,\n  mapMobileNotificationPreferencesToServer,\n  mapMobileProfilesIncludeToServer,\n  mapMobilePublicProfile,\n  mapMobileRegisteredWallet,\n  mapMobileSocialFeedItemResponse,\n  mapMobileSocialFeedListParamsToServer,\n  mapMobileSocialFeedPage,\n  mapMobileSocialFeedRankedPage,\n  mapMobileSocialFeedReadParamsToServer,\n  mapMobileSocialFeedTopTradersPage,\n  mapMobileSocialFeedUpdates,\n} from './dataMappers';\nimport {\n  buildSignedMobileRequest,\n  MobileSignedInner,\n  MobileSignedInnerByType,\n  MobileSignedInnerParams,\n  MobileSignedRequest,\n} from './signing';\nimport {\n  GetMobileFeedItemParams,\n  GetMobileFeedParams,\n  GetMobileFeedUpdatesParams,\n  GetMobileFollowersParams,\n  GetMobileFollowingParams,\n  GetMobileForYouFeedParams,\n  GetMobileFriendsFeedParams,\n  GetMobileMarketFeedParams,\n  GetMobileNotificationPreferencesParams,\n  GetMobilePositionFeedParams,\n  GetMobileProfileFeedParams,\n  GetMobileProfilesParams,\n  GetMobileRegisteredWalletParams,\n  GetMobileTopTradersFeedParams,\n  GetMobileUsernameAvailabilityParams,\n  MobileAvatarPreset,\n  MobileAvatarUpload,\n  MobileCreateAvatarUploadParams,\n  MobileFeedPage,\n  MobileFollowListPage,\n  MobileFollowMutationResult,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredWallet,\n  MobileRegisterExpoTokenParams,\n  MobileSetAvatarParams,\n  MobileSetBioParams,\n  MobileSetFollowParams,\n  MobileSetPrivateModeParams,\n  MobileSetUsernameParams,\n  MobileSignedRequestParams,\n  MobileSocialFeedItemResponse,\n  MobileSocialFeedPage,\n  MobileSocialFeedRankedPage,\n  MobileSocialFeedTopTradersPage,\n  MobileSocialFeedUpdates,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport {\n  MobileServerExecuteResult,\n  MobileServerExecuteSuccessResponse,\n  MobileServerPublicExecuteRequest,\n} from './types/serverExecuteTypes';\nimport {\n  MobileServerPublicQueryRequest,\n  MobileServerPublicQuerySuccessResponse,\n} from './types/serverQueryTypes';\nimport {\n  MobileServerExecuteRequestType,\n  MobileServerPublicQueryRequestByType,\n  MobileServerPublicQueryRequestType,\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   * If provided, identifies the calling client, sent as a header with every request.\n   */\n  clientType?: string;\n}\n\n/**\n * Client for the Nado mobile service API: usernames, bios, avatars, public profile lookups, the global\n * trade feed, session-based social feeds, the follower/following graph, privacy settings, and push\n * 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      headers: getNadoClientTypeHeaders(opts.clientType),\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   * Returns the current server-owned avatar catalogue in display order.\n   *\n   * @throws {MobileServerFailureError} With `SERVICE_UNAVAILABLE` when avatar storage is not configured.\n   */\n  async getAvatarPresets(): Promise<MobileAvatarPreset[]> {\n    const body: MobileServerPublicQueryRequest<'avatar_presets'> = {\n      type: 'avatar_presets',\n    };\n    const data = await this.publicQuery(body);\n    return data.presets.map(mapMobileAvatarPreset);\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 public profiles, optionally with follower totals and a follow summary. Returns one profile per\n   * requested subaccount, in the requested order, so callers can correlate positionally. Every non-isolated\n   * subaccount resolves, with `username` and `displayName` `null` until a username is claimed. Private Mode\n   * does not hide the profile itself, only the account's activity.\n   *\n   * This is the only profile route, so use it for a single subaccount too. It is unsigned, which means\n   * `include.followSummary.viewAs` is an unauthenticated claim.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PROFILES_REQUEST` if `subaccounts` is empty,\n   * holds duplicates, or exceeds `MOBILE_PROFILES_MAX_BATCH_SIZE` (25), or `PROFILE_NOT_FOUND` if any\n   * requested subaccount — or the follow summary's `viewAs` — is in the engine-created isolated namespace.\n   * One isolated member fails the whole batch rather than being omitted.\n   */\n  async getProfiles(\n    params: GetMobileProfilesParams,\n  ): Promise<MobilePublicProfile[]> {\n    const body: MobileServerPublicQueryRequest<'profiles'> = {\n      type: 'profiles',\n      subaccounts: params.subaccounts.map(subaccountToHex),\n      include: params.include\n        ? mapMobileProfilesIncludeToServer(params.include)\n        : undefined,\n    };\n    const data = await this.publicQuery(body);\n    return data.profiles.map(mapMobilePublicProfile);\n  }\n\n  /**\n   * Fetches a page of the accounts that follow the given Profile.\n   *\n   * Ordering depends on `viewAs`. With it, accounts the Viewer already follows come first, unfamiliar\n   * accounts second, and every row carries an `isFollowing`. Without it, the page is ordered by the listed\n   * relationship alone and no row carries an `isFollowing`. In both cases the newest listed relationship\n   * comes first within a group, with a bytes32 tie-break. The grouping is evaluated per request against the\n   * live graph, so following an account from inside the list moves it between groups on the next page —\n   * deduplicate by subaccount and do not re-sort locally.\n   *\n   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if the viewed Profile or `viewAs`\n   * is isolated, `INVALID_FOLLOW_CURSOR` if the cursor is malformed or was issued for a different `viewAs`,\n   * Profile, or list direction (discard it and restart from the first page), or `INVALID_FOLLOW_LIMIT` if\n   * `limit` is outside 1–50.\n   */\n  async getFollowers(\n    params: GetMobileFollowersParams,\n  ): Promise<MobileFollowListPage> {\n    const body: MobileServerPublicQueryRequest<'followers'> = {\n      type: 'followers',\n      ...mapMobileFollowListParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileFollowListPage(data);\n  }\n\n  /**\n   * Fetches a page of the accounts the given Profile follows. Ordering, cursor rules, and errors match\n   * {@link MobileClient.getFollowers}. When `viewAs` reads its own Following list every row is familiar, so\n   * every `isFollowing` is `true`.\n   */\n  async getFollowing(\n    params: GetMobileFollowingParams,\n  ): Promise<MobileFollowListPage> {\n    const body: MobileServerPublicQueryRequest<'following'> = {\n      type: 'following',\n      ...mapMobileFollowListParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileFollowListPage(data);\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 chronological For You recommendations with server-side author/thread constraints.\n   * Always public, with optional viewAs for relationship state. Preserve the session, viewAs, filters, and limit\n   * when paging, including through empty pages with a nextCursor. A 6312 error requires a refresh.\n   * @param params - Filters, pagination, optional viewing account, and browser credential; no signing identity.\n   * @returns A fixed-session page with its ranking version and new-content watermark.\n   * @throws {MobileServerFailureError} On invalid parameters, session mismatch/expiry, or unavailable data.\n   */\n  async getForYouFeed(\n    params: GetMobileForYouFeedParams = {},\n  ): Promise<MobileSocialFeedRankedPage> {\n    const body: MobileServerPublicQueryRequest<'for_you_feed'> = {\n      type: 'for_you_feed',\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedRankedPage(data);\n  }\n\n  /**\n   * Fetches chronological content by qualified Top Traders, with official account PnL badges.\n   * Always public; neither a wallet nor one-click trading setup is required.\n   * @param params - Filters, pagination, optional viewing account, and browser credential.\n   * @returns A page with its qualification cohort; an unavailable cohort fails instead of returning an empty ranking.\n   * @throws {MobileServerFailureError} On request/session errors or unavailable cohort data.\n   */\n  async getTopTradersFeed(\n    params: GetMobileTopTradersFeedParams = {},\n  ): Promise<MobileSocialFeedTopTradersPage> {\n    const body: MobileServerPublicQueryRequest<'top_traders_feed'> = {\n      type: 'top_traders_feed',\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedTopTradersPage(data);\n  }\n\n  /**\n   * Fetches public content by authors followed by viewAs, without a signature. One-way following is sufficient.\n   * @param params - Required viewing account on every request, filters, pagination, and browser credential.\n   * @returns A chronological Friends page and reading session.\n   * @throws {MobileServerFailureError} On invalid viewing account, session errors, or feed query failure.\n   */\n  async getFriendsFeed(\n    params: GetMobileFriendsFeedParams,\n  ): Promise<MobileSocialFeedRankedPage> {\n    const body: MobileServerPublicQueryRequest<'friends_feed'> = {\n      type: 'friends_feed',\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      view_as: subaccountToHex(params.viewAs),\n      viewer_token: params.viewerToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedRankedPage(data);\n  }\n\n  /**\n   * Fetches an author's content visible to viewAs, including that account's own hidden content.\n   * @param params - Target identity, filters, pagination, and optional public viewing account.\n   * @returns An author page without main-feed ranking or cohort fields.\n   * @throws {MobileServerFailureError} On invalid parameters, session errors, or inaccessible content.\n   */\n  async getProfileFeed(\n    params: GetMobileProfileFeedParams,\n  ): Promise<MobileSocialFeedPage> {\n    const body: MobileServerPublicQueryRequest<'profile_feed'> = {\n      type: 'profile_feed',\n      subaccount: subaccountToHex(params.subaccount),\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedPage(data);\n  }\n\n  /**\n   * Fetches published content for one market.\n   * @param params - Product ID, content/size filters, pagination, and public viewing account.\n   * @returns A market page without main-feed ranking fields.\n   * @throws {MobileServerFailureError} On an unknown market, session errors, or unavailable data.\n   */\n  async getMarketFeed(\n    params: GetMobileMarketFeedParams,\n  ): Promise<MobileSocialFeedPage> {\n    const body: MobileServerPublicQueryRequest<'market_feed'> = {\n      type: 'market_feed',\n      product_id: params.productId,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedPage(data);\n  }\n\n  /**\n   * Fetches already published content for a position lifecycle. This is not full position history\n   * and includes hidden content owned by viewAs under account_view. It does not recreate suppressed activity.\n   * @param params - Position UUID, filters, pagination, and public viewing account.\n   * @returns A fixed-session position feed page.\n   * @throws {MobileServerFailureError} On inaccessible content, session errors, or unavailable data.\n   */\n  async getPositionFeed(\n    params: GetMobilePositionFeedParams,\n  ): Promise<MobileSocialFeedPage> {\n    const body: MobileServerPublicQueryRequest<'position_feed'> = {\n      type: 'position_feed',\n      position_id: params.positionId,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedPage(data);\n  }\n\n  /**\n   * Reads one item visible to viewAs, including that account's own hidden content.\n   * Creates an item session directly when sessionId is omitted.\n   * @param params - Item UUID, preview limit, and optional existing session/read identity.\n   * @returns The complete item and authorized reading session.\n   * @throws {MobileServerFailureError} On inaccessible content or session mismatch/expiry.\n   */\n  async getFeedItem(\n    params: GetMobileFeedItemParams,\n  ): Promise<MobileSocialFeedItemResponse> {\n    const body: MobileServerPublicQueryRequest<'feed_item'> = {\n      type: 'feed_item',\n      item_id: params.itemId,\n      comment_preview_limit: params.commentPreviewLimit,\n      session_id: params.sessionId,\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedItemResponse(data);\n  }\n\n  /**\n   * Polls authorized visible items and positions without inserting or reordering list members.\n   * Increment requestSeq across the entire session, including viewport changes; never reset it for a new viewport.\n   * Accept only the current session and viewportRevision's latest requestSeq; discard stale patches and cursors together.\n   * Updates currently always return reset=true. Apply current author details, follow state, and badges even if the item version is unchanged.\n   * Null patches clear values;\n   * omitted fields leave them unchanged. Stop polling off-screen and refresh on error 6312.\n   * @param params - Session, visible IDs, update baseline, sequence, and matching read identity.\n   * @returns Item/position patches, revoked targets, and a new-content hint.\n   * @throws {MobileServerFailureError} On invalid or unauthorized targets, session expiry, or unavailable data.\n   */\n  async getFeedUpdates(\n    params: GetMobileFeedUpdatesParams,\n  ): Promise<MobileSocialFeedUpdates> {\n    const body: MobileServerPublicQueryRequest<'feed_updates'> = {\n      type: 'feed_updates',\n      session_id: params.sessionId,\n      visible_item_ids: params.visibleItemIds,\n      visible_position_ids: params.visiblePositionIds,\n      update_cursor: params.updateCursor,\n      viewport_revision: params.viewportRevision,\n      request_seq: params.requestSeq,\n      viewer_token: params.viewerToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedUpdates(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   * Resolves the wallet that an Expo push token is currently registered to, along with the redacted metadata\n   * of the device that registered it. Unsigned — the token identifies the wallet on its own. Use it to check\n   * whether a locally held token is still active and which wallet currently owns it, since registering the\n   * same token under another wallet transfers ownership.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed, or is\n   * not currently registered to a wallet — including a token that was unregistered. The backend does not\n   * distinguish those cases.\n   */\n  async getRegisteredWallet(\n    params: GetMobileRegisteredWalletParams,\n  ): Promise<MobileRegisteredWallet> {\n    const body: MobileServerPublicQueryRequest<'registered_wallet'> = {\n      type: 'registered_wallet',\n      expo_token: params.expoToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileRegisteredWallet(data);\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 executes\n   */\n\n  /**\n   * Updates the biography, or clears it when the text is whitespace-only.\n   *\n   * Serialize this with {@link MobileClient.setAvatar}, {@link MobileClient.setUsername} and\n   * {@link MobileClient.setPrivateMode} for the same subaccount: all share the identity update nonce.\n   *\n   * @throws {MobileServerFailureError} With `INVALID_BIO` for exceeding `MOBILE_BIO_MAX_LENGTH` or null\n   * characters, `INVALID_IDENTITY_TARGET` for an isolated subaccount, or `STALE_IDENTITY_UPDATE` when a\n   * later write has committed (re-read the profile before retrying).\n   */\n  async setBio(\n    params: MobileSetBioParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest('set_bio', params, {\n      bio: params.bio,\n    });\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Creates a short-lived upload grant. The caller uploads an image meeting {@link MobileAvatarUpload}'s requirements;\n   * file access and transport remain platform-specific. This does not change the saved avatar.\n   *\n   * @throws {MobileServerFailureError} With `INVALID_AVATAR` for a zero or oversized upload,\n   * `INVALID_IDENTITY_TARGET` for an isolated subaccount, or `SERVICE_UNAVAILABLE` when storage is unavailable.\n   */\n  async createAvatarUpload(\n    params: MobileCreateAvatarUploadParams,\n  ): Promise<MobileAvatarUpload> {\n    const signedRequest = await this.getSignedRequest(\n      'create_avatar_upload',\n      params,\n      { content_length: params.contentLength },\n    );\n    const data = await this.execute(signedRequest);\n    return mapMobileAvatarUpload(data);\n  }\n\n  /**\n   * Publishes a preset/staged upload, or clears the saved avatar when avatar is null.\n   * Uploaded JPEG/PNG images must be square, at most 4096 × 4096 pixels, and within\n   * `MOBILE_AVATAR_MAX_UPLOAD_BYTES`. A successful PUT can still fail this publication check.\n   *\n   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.\n   *\n   * @throws {MobileServerFailureError} With `INVALID_AVATAR` for an invalid preset, staging key, or image,\n   * `INVALID_IDENTITY_TARGET` for an isolated subaccount, `SERVICE_UNAVAILABLE` when storage is unavailable,\n   * or `STALE_IDENTITY_UPDATE` when a later write has committed (re-read the profile before retrying).\n   */\n  async setAvatar(\n    params: MobileSetAvatarParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest('set_avatar', params, {\n      avatar: mapMobileAvatarSelectionToServer(params.avatar),\n    });\n    return this.execute(signedRequest);\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   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.\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   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.\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   * Sets whether the signing subaccount follows a Profile. Both directions are idempotent: following again\n   * keeps the original relationship creation time, so it does not move the account in recency order, and\n   * unfollowing a relationship that does not exist succeeds with `isFollowing: false`. Unfollowing deletes\n   * the relationship rather than deactivating it, so a later follow gets a new creation time and moves the\n   * account to the front of recency order.\n   *\n   * Only `isFollowing: true` is checked against the canonical Query DB subaccount index, so unfollowing still\n   * works while that index lags.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_FOLLOW_TARGET` if the target is the sender or\n   * either party is isolated, `FOLLOWER_NOT_ELIGIBLE` if the sender is not yet in the canonical Query DB\n   * subaccount index, or `FOLLOWING_NOT_FOUND` if the target is not. Both index errors are transient for an\n   * account that is being recorded, so they are retryable after catch-up — unlike `INVALID_FOLLOW_TARGET`.\n   */\n  async setFollow(\n    params: MobileSetFollowParams,\n  ): Promise<MobileFollowMutationResult> {\n    const signedRequest = await this.getSignedRequest('set_follow', params, {\n      subaccount: subaccountToHex(params.target),\n      is_following: params.isFollowing,\n    });\n    const data = await this.execute(signedRequest);\n    return mapMobileFollowMutationResult(data);\n  }\n\n  /*\n  Base Fns\n   */\n\n  // Returns the request narrowed to `type` so `execute` can infer its response from the request it is given,\n  // instead of being told the type a second time at the call site.\n  protected async getSignedRequest<T extends MobileSignedInner['type']>(\n    type: T,\n    params: MobileSignedRequestParams,\n    innerParams: MobileSignedInnerParams<T>,\n  ): Promise<MobileSignedRequest<MobileSignedInnerByType<T>>> {\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 = {\n      type,\n      ...innerParams,\n    } as unknown as MobileSignedInnerByType<T>;\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}/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}/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  // `T` is inferred from the body's `type` rather than declared by the caller, for the same reason\n  // `publicQuery` spells its body out as an intersection: an indexed access is not an inference site.\n  protected async execute<T extends MobileServerExecuteRequestType>(\n    body: MobileSignedRequest & { type: T },\n  ): Promise<MobileServerExecuteSuccessResponse<T>> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/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 MobileServerExecuteSuccessResponse<T>;\n  }\n\n  /**\n   * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns\n   * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a\n   * failure envelope still throws the typed error; anything else is a transport-level error.\n   */\n  private checkResponseStatus(response: AxiosResponse<unknown>) {\n    if (response.status >= 200 && response.status < 300) {\n      return;\n    }\n    if (isMobileServerFailureResponse(response.data)) {\n      throw new MobileServerFailureError(response.data, response.status);\n    }\n    throw new Error(\n      `Unexpected response from mobile service: ${response.status} ${response.statusText}. Data: ${JSON.stringify(response.data)}`,\n    );\n  }\n\n  private checkServerStatus(response: AxiosResponse<unknown>) {\n    const { data } = response;\n\n    if (isMobileServerFailureResponse(data)) {\n      throw new MobileServerFailureError(data, response.status);\n    }\n    if (!isMobileServerSuccessResponse(data)) {\n      throw new Error(\n        `Unexpected response from mobile service: missing success envelope. Data: ${JSON.stringify(data)}`,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/MobileClient.cjs

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

package/dist/MobileClient.d.cts

@@ -1,9 +1,9 @@
-import { $ as MobileSocialFeedRankedPage, A as MobileRegisterExpoTokenParams, D as MobileNotificationPreferences, F as MobileSignedRequestParams, K as MobileSocialFeedItemResponse, M as MobileSetFollowParams, N as MobileSetPrivateModeParams, P as MobileSetUsernameParams, S as MobileFollowMutationResult, Y as MobileSocialFeedPage, a as GetMobileFollowersParams, c as GetMobileFriendsFeedParams, d as GetMobilePositionFeedParams, dt as MobileUsernameAvailability, f as GetMobileProfileFeedParams, g as GetMobileUsernameAvailabilityParams, h as GetMobileTopTradersFeedParams, j as MobileRegisteredWallet, k as MobilePublicProfile, l as GetMobileMarketFeedParams, lt as MobileUnregisterExpoTokenParams, m as GetMobileRegisteredWalletParams, n as GetMobileFeedParams, nt as MobileSocialFeedTopTradersPage, o as GetMobileFollowingParams, p as GetMobileProfilesParams, r as GetMobileFeedUpdatesParams, s as GetMobileForYouFeedParams, st as MobileSocialFeedUpdates, t as GetMobileFeedItemParams, u as GetMobileNotificationPreferencesParams, ut as MobileUpdateNotificationPreferencesParams, v as MobileFeedPage, x as MobileFollowListPage } from "./clientTypes-YF5d8bvg.cjs";
-import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-CwpXP7xM.cjs";
-import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-XbnLUsXT.cjs";
-import { n as MobileServerSuccessResponse } from "./serverBaseTypes-CuMsGXgc.cjs";
-import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-TPX0GCgv.cjs";
-import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-BZOoJBpb.cjs";
+import { B as MobileSetUsernameParams, E as MobileFollowMutationResult, F as MobileRegisteredWallet, I as MobileSetAvatarParams, L as MobileSetBioParams, N as MobilePublicProfile, P as MobileRegisterExpoTokenParams, Q as MobileSocialFeedItemResponse, R as MobileSetFollowParams, S as MobileFeedPage, T as MobileFollowListPage, V as MobileSignedRequestParams, _ as MobileAvatarPreset, _t as MobileUsernameAvailability, a as GetMobileFollowersParams, at as MobileSocialFeedRankedPage, b as MobileCreateAvatarUploadParams, c as GetMobileFriendsFeedParams, ct as MobileSocialFeedTopTradersPage, d as GetMobilePositionFeedParams, f as GetMobileProfileFeedParams, g as GetMobileUsernameAvailabilityParams, gt as MobileUpdateNotificationPreferencesParams, h as GetMobileTopTradersFeedParams, ht as MobileUnregisterExpoTokenParams, j as MobileNotificationPreferences, l as GetMobileMarketFeedParams, m as GetMobileRegisteredWalletParams, n as GetMobileFeedParams, o as GetMobileFollowingParams, p as GetMobileProfilesParams, pt as MobileSocialFeedUpdates, r as GetMobileFeedUpdatesParams, s as GetMobileForYouFeedParams, t as GetMobileFeedItemParams, tt as MobileSocialFeedPage, u as GetMobileNotificationPreferencesParams, y as MobileAvatarUpload, z as MobileSetPrivateModeParams } from "./clientTypes-DnPE1zZO.cjs";
+import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-l47aSWtA.cjs";
+import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-DGGqQMK3.cjs";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-CcWT_ZBe.cjs";
+import { a as MobileServerExecuteSuccessResponse, s as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-CgjzwBaA.cjs";
+import { c as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-H_mI6fPl.cjs";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -30,9 +30,9 @@ interface MobileClientOpts {
   clientType?: string;
 }
 /**
- * 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.
  */
 declare class MobileClient {
   readonly opts: MobileClientOpts;
@@ -44,6 +44,12 @@ declare class MobileClient {
    * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer
    */
   setLinkedSigner(linkedSignerWalletClient: WalletClientWithAccount | null): void;
+  /**
+   * Returns the current server-owned avatar catalogue in display order.
+   *
+   * @throws {MobileServerFailureError} With `SERVICE_UNAVAILABLE` when avatar storage is not configured.
+   */
+  getAvatarPresets(): Promise<MobileAvatarPreset[]>;
   /**
    * Checks whether a username derived from the given display name is available to claim.
    */
@@ -208,10 +214,43 @@ declare class MobileClient {
    * `INVALID_EXPO_TOKEN` if the token is malformed or is not currently registered to a wallet.
    */
   updateNotificationPreferences(params: MobileUpdateNotificationPreferencesParams): Promise<MobileServerSuccessResponse>;
+  /**
+   * 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).
+   */
+  setBio(params: MobileSetBioParams): Promise<MobileServerSuccessResponse>;
+  /**
+   * 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.
+   */
+  createAvatarUpload(params: MobileCreateAvatarUploadParams): Promise<MobileAvatarUpload>;
+  /**
+   * 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).
+   */
+  setAvatar(params: MobileSetAvatarParams): Promise<MobileServerSuccessResponse>;
   /**
    * 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
@@ -221,6 +260,7 @@ declare class MobileClient {
   setUsername(params: MobileSetUsernameParams): Promise<MobileServerSuccessResponse>;
   /**
    * Sets whether a subaccount's profile is private.
+   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.
    */
   setPrivateMode(params: MobileSetPrivateModeParams): Promise<MobileServerSuccessResponse>;
   /**

package/dist/MobileClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":"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"}
+{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":"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"}

package/dist/MobileClient.d.ts

@@ -1,9 +1,9 @@
-import { $ as MobileSocialFeedRankedPage, A as MobileRegisterExpoTokenParams, D as MobileNotificationPreferences, F as MobileSignedRequestParams, K as MobileSocialFeedItemResponse, M as MobileSetFollowParams, N as MobileSetPrivateModeParams, P as MobileSetUsernameParams, S as MobileFollowMutationResult, Y as MobileSocialFeedPage, a as GetMobileFollowersParams, c as GetMobileFriendsFeedParams, d as GetMobilePositionFeedParams, dt as MobileUsernameAvailability, f as GetMobileProfileFeedParams, g as GetMobileUsernameAvailabilityParams, h as GetMobileTopTradersFeedParams, j as MobileRegisteredWallet, k as MobilePublicProfile, l as GetMobileMarketFeedParams, lt as MobileUnregisterExpoTokenParams, m as GetMobileRegisteredWalletParams, n as GetMobileFeedParams, nt as MobileSocialFeedTopTradersPage, o as GetMobileFollowingParams, p as GetMobileProfilesParams, r as GetMobileFeedUpdatesParams, s as GetMobileForYouFeedParams, st as MobileSocialFeedUpdates, t as GetMobileFeedItemParams, u as GetMobileNotificationPreferencesParams, ut as MobileUpdateNotificationPreferencesParams, v as MobileFeedPage, x as MobileFollowListPage } from "./clientTypes-P4LAjreY.js";
-import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-B_4veFLc.js";
-import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-BULjZnnz.js";
-import { n as MobileServerSuccessResponse } from "./serverBaseTypes-DKCLDn3x.js";
-import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-DKG1mqy1.js";
-import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-BLUe10AI.js";
+import { B as MobileSetUsernameParams, E as MobileFollowMutationResult, F as MobileRegisteredWallet, I as MobileSetAvatarParams, L as MobileSetBioParams, N as MobilePublicProfile, P as MobileRegisterExpoTokenParams, Q as MobileSocialFeedItemResponse, R as MobileSetFollowParams, S as MobileFeedPage, T as MobileFollowListPage, V as MobileSignedRequestParams, _ as MobileAvatarPreset, _t as MobileUsernameAvailability, a as GetMobileFollowersParams, at as MobileSocialFeedRankedPage, b as MobileCreateAvatarUploadParams, c as GetMobileFriendsFeedParams, ct as MobileSocialFeedTopTradersPage, d as GetMobilePositionFeedParams, f as GetMobileProfileFeedParams, g as GetMobileUsernameAvailabilityParams, gt as MobileUpdateNotificationPreferencesParams, h as GetMobileTopTradersFeedParams, ht as MobileUnregisterExpoTokenParams, j as MobileNotificationPreferences, l as GetMobileMarketFeedParams, m as GetMobileRegisteredWalletParams, n as GetMobileFeedParams, o as GetMobileFollowingParams, p as GetMobileProfilesParams, pt as MobileSocialFeedUpdates, r as GetMobileFeedUpdatesParams, s as GetMobileForYouFeedParams, t as GetMobileFeedItemParams, tt as MobileSocialFeedPage, u as GetMobileNotificationPreferencesParams, y as MobileAvatarUpload, z as MobileSetPrivateModeParams } from "./clientTypes-ws9CDHw4.js";
+import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-B021odcS.js";
+import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-BY0f5woc.js";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-CWBdZomv.js";
+import { a as MobileServerExecuteSuccessResponse, s as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-jyr5aO5q.js";
+import { c as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-DPRP61yA.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -30,9 +30,9 @@ interface MobileClientOpts {
   clientType?: string;
 }
 /**
- * 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.
  */
 declare class MobileClient {
   readonly opts: MobileClientOpts;
@@ -44,6 +44,12 @@ declare class MobileClient {
    * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer
    */
   setLinkedSigner(linkedSignerWalletClient: WalletClientWithAccount | null): void;
+  /**
+   * Returns the current server-owned avatar catalogue in display order.
+   *
+   * @throws {MobileServerFailureError} With `SERVICE_UNAVAILABLE` when avatar storage is not configured.
+   */
+  getAvatarPresets(): Promise<MobileAvatarPreset[]>;
   /**
    * Checks whether a username derived from the given display name is available to claim.
    */
@@ -208,10 +214,43 @@ declare class MobileClient {
    * `INVALID_EXPO_TOKEN` if the token is malformed or is not currently registered to a wallet.
    */
   updateNotificationPreferences(params: MobileUpdateNotificationPreferencesParams): Promise<MobileServerSuccessResponse>;
+  /**
+   * 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).
+   */
+  setBio(params: MobileSetBioParams): Promise<MobileServerSuccessResponse>;
+  /**
+   * 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.
+   */
+  createAvatarUpload(params: MobileCreateAvatarUploadParams): Promise<MobileAvatarUpload>;
+  /**
+   * 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).
+   */
+  setAvatar(params: MobileSetAvatarParams): Promise<MobileServerSuccessResponse>;
   /**
    * 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
@@ -221,6 +260,7 @@ declare class MobileClient {
   setUsername(params: MobileSetUsernameParams): Promise<MobileServerSuccessResponse>;
   /**
    * Sets whether a subaccount's profile is private.
+   * Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.
    */
   setPrivateMode(params: MobileSetPrivateModeParams): Promise<MobileServerSuccessResponse>;
   /**

package/dist/MobileClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":"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"}
+{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;;UAoGiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAQf;;AAAU;EAJV,wBAAA,GAA2B,uBAAuB;EAY3B;;;EARvB,UAAA;AAAA;;;;;;cAQW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAgGR;;;;;EAjFH,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAsHN;;;;;EAxGhB,gBAAA,CAAA,GAAoB,OAAA,CAAQ,kBAAA;EAgJxB;;;EArIJ,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAuJA;;;;;;;;;;;;;;EAhIL,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,mBAAA;EAuOA;;;;;;;;;;;;;;;EA5ML,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EAgUR;;;;;EAlTG,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EAuVR;;;;;;;;;;;;EAlUG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EAqad;;;;;;;;EAlZrC,aAAA,CACJ,MAAA,GAAQ,yBAAA,GACP,OAAA,CAAQ,0BAAA;EAsa2B;;;;;;;EApZhC,iBAAA,CACJ,MAAA,GAAQ,6BAAA,GACP,OAAA,CAAQ,8BAAA;EAmaA;;;;;;EAlZL,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,0BAAA;EAiaR;;;;;;EA/YG,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,oBAAA;;;;;;;EAkBL,aAAA,CACJ,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,oBAAA;EA5Me;;;;;;;EA8NpB,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,oBAAA;EA3LD;;;;;;;EA6MJ,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,4BAAA;EAjLA;;;;;;;;;;;EAwML,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,uBAAA;EAjJD;;;;;;;;EAwKJ,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EApIL;;;;;;;;;;EAuJA,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAhHD;;;;;;;;;;EAuIJ,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAjGT;;;;;;;;;;;;EAqHI,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAjDL;;;;;;;;;;EAwEA,MAAA,CACJ,MAAA,EAAQ,kBAAA,GACP,OAAA,CAAQ,2BAAA;EA1BD;;;;;;;EAwCJ,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,kBAAA;EAhBA;;;;;;;;;;;EAqCL,SAAA,CACJ,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,2BAAA;EAoBD;;;;;;;;;;;;EADJ,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EAgCA;;;;EArBL,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAkDA;;;;;;;;EAjCL,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAiD4B;;;;;;;;;;;;;;;EApBjC,SAAA,CACJ,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,0BAAA;EAAA,UAeK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA,CAAoB,uBAAA,CAAwB,CAAA;EAAA,UAkBvC,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,UAeK,OAAA,WAAkB,8BAAA,CAAA,CAChC,IAAA,EAAM,mBAAA;IAAwB,IAAA,EAAM,CAAA;EAAA,IACnC,OAAA,CAAQ,kCAAA,CAAmC,CAAA;EAFZ;;;;;EAAA,QAoB1B,mBAAA;EAAA,QAYA,iBAAA;AAAA"}

package/dist/MobileClient.js

@@ -1,4 +1,4 @@
-import { mapMobileFeedPage, mapMobileFollowListPage, mapMobileFollowListParamsToServer, mapMobileFollowMutationResult, mapMobileNotificationPreferences, mapMobileNotificationPreferencesToServer, mapMobileProfilesIncludeToServer, mapMobilePublicProfile, mapMobileRegisteredWallet, mapMobileSocialFeedItemResponse, mapMobileSocialFeedListParamsToServer, mapMobileSocialFeedPage, mapMobileSocialFeedRankedPage, mapMobileSocialFeedReadParamsToServer, mapMobileSocialFeedTopTradersPage, mapMobileSocialFeedUpdates } from "./dataMappers.js";
+import { mapMobileAvatarPreset, mapMobileAvatarSelectionToServer, mapMobileAvatarUpload, mapMobileFeedPage, mapMobileFollowListPage, mapMobileFollowListParamsToServer, mapMobileFollowMutationResult, mapMobileNotificationPreferences, mapMobileNotificationPreferencesToServer, mapMobileProfilesIncludeToServer, mapMobilePublicProfile, mapMobileRegisteredWallet, mapMobileSocialFeedItemResponse, mapMobileSocialFeedListParamsToServer, mapMobileSocialFeedPage, mapMobileSocialFeedRankedPage, mapMobileSocialFeedReadParamsToServer, mapMobileSocialFeedTopTradersPage, mapMobileSocialFeedUpdates } from "./dataMappers.js";
 import { buildSignedMobileRequest } from "./signing/buildSignedMobileRequest.js";
 import "./signing/index.js";
 import { MobileServerFailureError } from "./types/MobileServerFailureError.js";
@@ -7,9 +7,9 @@ import { WalletNotProvidedError, getNadoClientTypeHeaders, subaccountToHex } fro
 import axios from "axios";
 //#region src/MobileClient.ts
 /**
-* 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.
 */
 var MobileClient = class {
 	constructor(opts) {
@@ -29,6 +29,14 @@ var MobileClient = class {
 		this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? void 0;
 	}
 	/**
+	* Returns the current server-owned avatar catalogue in display order.
+	*
+	* @throws {MobileServerFailureError} With `SERVICE_UNAVAILABLE` when avatar storage is not configured.
+	*/
+	async getAvatarPresets() {
+		return (await this.publicQuery({ type: "avatar_presets" })).presets.map(mapMobileAvatarPreset);
+	}
+	/**
 	* Checks whether a username derived from the given display name is available to claim.
 	*/
 	async getUsernameAvailability(params) {
@@ -326,9 +334,51 @@ var MobileClient = class {
 		return this.publicExecute(body);
 	}
 	/**
+	* 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) {
+		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) {
+		const signedRequest = await this.getSignedRequest("create_avatar_upload", params, { content_length: params.contentLength });
+		return mapMobileAvatarUpload(await this.execute(signedRequest));
+	}
+	/**
+	* 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) {
+		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
@@ -341,6 +391,7 @@ var MobileClient = class {
 	}
 	/**
 	* Sets whether a subaccount's profile is private.
+	* Serialize identity writes for the same subaccount; see {@link MobileClient.setBio}.
 	*/
 	async setPrivateMode(params) {
 		const signedRequest = await this.getSignedRequest("set_private_mode", params, { private_mode: params.privateMode });