@nadohq/mobile-client 0.35.0 → 0.37.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-CClB00EN.d.cts","names":[],"sources":["../src/signing/src/signing/types.ts"],"mappings":";;;;;;;;AAmBA;;;;;;;;;;;;KAAY,iBAAA;EACN,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,EAUZ;EARA,YAAA;AAAA;EAGA,IAAA;EACA,UAAA,EAAY,GAAA,EAYZ;EAVA,MAAA,iBAUK;EARL,KAAA;AAAA;EAGA,IAAA;EACA,UAAA,EAAY,GAAA,EAWR;EATJ,MAAA,iBASJ;EAPI,KAAA;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/follow.cjs

@@ -0,0 +1,28 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/follow.ts
+/**
+* Maximum Followers/Following page size the backend accepts. Requests outside 1–50 fail with
+* `INVALID_FOLLOW_LIMIT`.
+*/
+const MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE = 50;
+/**
+* Page size the backend uses when `limit` is omitted from a Followers or Following request.
+*/
+const MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE = 25;
+/**
+* Number of Followed By preview identities a follow summary carries. Fixed by the backend rather than
+* requested, so use it to size the preview UI; `followedByCount` still reports the full intersection.
+*/
+const MOBILE_FOLLOWED_BY_PREVIEW_LIMIT = 2;
+/**
+* Maximum number of subaccounts a single profiles lookup accepts. An empty list, a duplicate, or more than
+* this many fail with `INVALID_PROFILES_REQUEST`.
+*/
+const MOBILE_PROFILES_MAX_BATCH_SIZE = 25;
+//#endregion
+exports.MOBILE_FOLLOWED_BY_PREVIEW_LIMIT = MOBILE_FOLLOWED_BY_PREVIEW_LIMIT;
+exports.MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE = MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE;
+exports.MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE = MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE;
+exports.MOBILE_PROFILES_MAX_BATCH_SIZE = MOBILE_PROFILES_MAX_BATCH_SIZE;
+
+//# sourceMappingURL=follow.cjs.map

package/dist/utils/follow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.cjs","names":[],"sources":["../../src/utils/follow.ts"],"sourcesContent":["/**\n * Maximum Followers/Following page size the backend accepts. Requests outside 1–50 fail with\n * `INVALID_FOLLOW_LIMIT`.\n */\nexport const MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE = 50;\n\n/**\n * Page size the backend uses when `limit` is omitted from a Followers or Following request.\n */\nexport const MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE = 25;\n\n/**\n * Number of Followed By preview identities a follow summary carries. Fixed by the backend rather than\n * requested, so use it to size the preview UI; `followedByCount` still reports the full intersection.\n */\nexport const MOBILE_FOLLOWED_BY_PREVIEW_LIMIT = 2;\n\n/**\n * Maximum number of subaccounts a single profiles lookup accepts. An empty list, a duplicate, or more than\n * this many fail with `INVALID_PROFILES_REQUEST`.\n */\nexport const MOBILE_PROFILES_MAX_BATCH_SIZE = 25;\n"],"mappings":";;;;;;AAIA,MAAa,mCAAmC;;;;AAKhD,MAAa,uCAAuC;;;;;AAMpD,MAAa,mCAAmC;;;;;AAMhD,MAAa,iCAAiC"}

package/dist/utils/follow.d.cts

@@ -0,0 +1,2 @@
+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-Bh3UmXMc.cjs";
+export { MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE };

package/dist/utils/follow.d.ts

@@ -0,0 +1,2 @@
+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-DjkQm1vR.js";
+export { MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE };

package/dist/utils/follow.js

@@ -0,0 +1,24 @@
+//#region src/utils/follow.ts
+/**
+* Maximum Followers/Following page size the backend accepts. Requests outside 1–50 fail with
+* `INVALID_FOLLOW_LIMIT`.
+*/
+const MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE = 50;
+/**
+* Page size the backend uses when `limit` is omitted from a Followers or Following request.
+*/
+const MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE = 25;
+/**
+* Number of Followed By preview identities a follow summary carries. Fixed by the backend rather than
+* requested, so use it to size the preview UI; `followedByCount` still reports the full intersection.
+*/
+const MOBILE_FOLLOWED_BY_PREVIEW_LIMIT = 2;
+/**
+* Maximum number of subaccounts a single profiles lookup accepts. An empty list, a duplicate, or more than
+* this many fail with `INVALID_PROFILES_REQUEST`.
+*/
+const MOBILE_PROFILES_MAX_BATCH_SIZE = 25;
+//#endregion
+export { MOBILE_FOLLOWED_BY_PREVIEW_LIMIT, MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE, MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE, MOBILE_PROFILES_MAX_BATCH_SIZE };
+
+//# sourceMappingURL=follow.js.map

package/dist/utils/follow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.js","names":[],"sources":["../../src/utils/follow.ts"],"sourcesContent":["/**\n * Maximum Followers/Following page size the backend accepts. Requests outside 1–50 fail with\n * `INVALID_FOLLOW_LIMIT`.\n */\nexport const MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE = 50;\n\n/**\n * Page size the backend uses when `limit` is omitted from a Followers or Following request.\n */\nexport const MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE = 25;\n\n/**\n * Number of Followed By preview identities a follow summary carries. Fixed by the backend rather than\n * requested, so use it to size the preview UI; `followedByCount` still reports the full intersection.\n */\nexport const MOBILE_FOLLOWED_BY_PREVIEW_LIMIT = 2;\n\n/**\n * Maximum number of subaccounts a single profiles lookup accepts. An empty list, a duplicate, or more than\n * this many fail with `INVALID_PROFILES_REQUEST`.\n */\nexport const MOBILE_PROFILES_MAX_BATCH_SIZE = 25;\n"],"mappings":";;;;;AAIA,MAAa,mCAAmC;;;;AAKhD,MAAa,uCAAuC;;;;;AAMpD,MAAa,mCAAmC;;;;;AAMhD,MAAa,iCAAiC"}

package/dist/utils/index.cjs

@@ -1,9 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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");
 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;
+exports.MOBILE_FOLLOWED_BY_PREVIEW_LIMIT = require_utils_follow.MOBILE_FOLLOWED_BY_PREVIEW_LIMIT;
+exports.MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE = require_utils_follow.MOBILE_FOLLOW_LIST_DEFAULT_PAGE_SIZE;
+exports.MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE = require_utils_follow.MOBILE_FOLLOW_LIST_MAX_PAGE_SIZE;
+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;

package/dist/utils/index.d.cts

@@ -1,4 +1,5 @@
 import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-CBIwOhTO.cjs";
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-Db6fgz8i.cjs";
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-Dxt9_aGh.cjs";
-export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+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-Bh3UmXMc.cjs";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-DS8P5LH0.cjs";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-k6xK1bZ1.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 };

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 import { n as MOBILE_FEED_MIN_NOTIONAL_FLOOR, t as MOBILE_FEED_MAX_PAGE_SIZE } from "../feed-BF5k6Ryu.js";
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-B5gi7OfV.js";
-import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-Cep5s7j5.js";
-export { MOBILE_DISPLAY_NAME_PATTERN, MOBILE_FEED_MAX_PAGE_SIZE, MOBILE_FEED_MIN_NOTIONAL_FLOOR, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+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-DjkQm1vR.js";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-C-aUAnKl.js";
+import { n as isMobileServerSuccessResponse, t as isMobileServerFailureResponse } from "../serverResponseGuards-BcdkKV30.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 };

package/dist/utils/index.js

@@ -1,4 +1,5 @@
 import { isMobileServerFailureResponse, isMobileServerSuccessResponse } from "./serverResponseGuards.js";
 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, isMobileServerFailureResponse, isMobileServerSuccessResponse };
+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 };

package/dist/utils/patterns.d.cts

@@ -1,2 +1,2 @@
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-Db6fgz8i.cjs";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-DS8P5LH0.cjs";
 export { MOBILE_DISPLAY_NAME_PATTERN };

package/dist/utils/patterns.d.ts

@@ -1,2 +1,2 @@
-import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-B5gi7OfV.js";
+import { t as MOBILE_DISPLAY_NAME_PATTERN } from "../patterns-C-aUAnKl.js";
 export { MOBILE_DISPLAY_NAME_PATTERN };

package/dist/utils/serverResponseGuards.d.cts

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

package/dist/utils/serverResponseGuards.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadohq/mobile-client",
-  "version": "0.35.0",
+  "version": "0.37.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.35.0",
+    "@nadohq/shared": "^0.37.0",
     "axios": "1.16.1"
   },
   "peerDependencies": {
@@ -54,5 +54,5 @@
     "bignumber.js": "11.1.1",
     "viem": "2.52.0"
   },
-  "gitHead": "232349cb0f432b024dab1b1c623e8ad3b74b8f85"
+  "gitHead": "35e47d01ea725fea6311fa911febdf7483118ef4"
 }

package/src/MobileClient.ts

@@ -7,28 +7,37 @@ import {
 import axios, { AxiosInstance, AxiosResponse } from 'axios';
 import {
   mapMobileFeedPage,
+  mapMobileFollowListPage,
+  mapMobileFollowMutationResult,
   mapMobileNotificationPreferences,
   mapMobileNotificationPreferencesToServer,
+  mapMobileProfilesIncludeToServer,
   mapMobilePublicProfile,
   mapMobileRegisteredWallet,
 } from './dataMappers';
 import {
   buildSignedMobileRequest,
   MobileSignedInner,
+  MobileSignedInnerByType,
   MobileSignedInnerParams,
   MobileSignedRequest,
 } from './signing';
 import {
   GetMobileFeedParams,
+  GetMobileFollowersParams,
+  GetMobileFollowingParams,
   GetMobileNotificationPreferencesParams,
-  GetMobilePublicProfileParams,
+  GetMobileProfilesParams,
   GetMobileRegisteredWalletParams,
   GetMobileUsernameAvailabilityParams,
   MobileFeedPage,
+  MobileFollowListPage,
+  MobileFollowMutationResult,
   MobileNotificationPreferences,
   MobilePublicProfile,
   MobileRegisteredWallet,
   MobileRegisterExpoTokenParams,
+  MobileSetFollowParams,
   MobileSetPrivateModeParams,
   MobileSetUsernameParams,
   MobileSignedRequestParams,
@@ -40,15 +49,19 @@ import { MobileServerFailureError } from './types/MobileServerFailureError';
 import { MobileServerSuccessResponse } from './types/serverBaseTypes';
 import {
   MobileServerExecuteResult,
+  MobileServerExecuteSuccessResponse,
   MobileServerPublicExecuteRequest,
 } from './types/serverExecuteTypes';
 import {
   MobileServerPublicQueryRequest,
   MobileServerPublicQuerySuccessResponse,
+  MobileServerSignedQuerySuccessResponse,
 } from './types/serverQueryTypes';
 import {
+  MobileServerExecuteRequestType,
   MobileServerPublicQueryRequestByType,
   MobileServerPublicQueryRequestType,
+  MobileServerSignedQueryRequestType,
 } from './types/serverRequestTypes';
 import {
   isMobileServerFailureResponse,
@@ -78,8 +91,8 @@ export interface MobileClientOpts {
 }
 
 /**
- * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed, privacy
- * settings, and push notification device/preference management.
+ * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed, the
+ * follower/following graph, privacy settings, and push notification device/preference management.
  */
 export class MobileClient {
   readonly opts: MobileClientOpts;
@@ -125,22 +138,32 @@ export class MobileClient {
   }
 
   /**
-   * Looks up a subaccount's public profile. Every non-isolated subaccount resolves, with `username` and
-   * `displayName` `null` until a username is claimed. Private Mode does not hide the profile itself, only the
-   * account's activity.
+   * Looks up public profiles, optionally with follower totals and a follow summary. Returns one profile per
+   * requested subaccount, in the requested order, so callers can correlate positionally. Every non-isolated
+   * subaccount resolves, with `username` and `displayName` `null` until a username is claimed. Private Mode
+   * does not hide the profile itself, only the account's activity.
    *
-   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if the subaccount is in the
-   * engine-created isolated namespace, which cannot own a profile.
+   * This is the only profile route, so use it for a single subaccount too. It is unsigned, which means
+   * `include.followSummary.viewAs` is an unauthenticated claim: the follow *lists* remain signed precisely
+   * because they prove the viewer.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_PROFILES_REQUEST` if `subaccounts` is empty,
+   * holds duplicates, or exceeds `MOBILE_PROFILES_MAX_BATCH_SIZE` (25), or `PROFILE_NOT_FOUND` if any
+   * requested subaccount — or the follow summary's `viewAs` — is in the engine-created isolated namespace.
+   * One isolated member fails the whole batch rather than being omitted.
    */
-  async getPublicProfile(
-    params: GetMobilePublicProfileParams,
-  ): Promise<MobilePublicProfile> {
-    const body: MobileServerPublicQueryRequest<'profile'> = {
-      type: 'profile',
-      subaccount: subaccountToHex(params),
+  async getProfiles(
+    params: GetMobileProfilesParams,
+  ): Promise<MobilePublicProfile[]> {
+    const body: MobileServerPublicQueryRequest<'profiles'> = {
+      type: 'profiles',
+      subaccounts: params.subaccounts.map(subaccountToHex),
+      include: params.include
+        ? mapMobileProfilesIncludeToServer(params.include)
+        : undefined,
     };
     const data = await this.publicQuery(body);
-    return mapMobilePublicProfile(data.profile);
+    return data.profiles.map(mapMobilePublicProfile);
   }
 
   /**
@@ -253,6 +276,52 @@ export class MobileClient {
     return this.publicExecute(body);
   }
 
+  /*
+  Signed queries
+   */
+
+  /**
+   * Fetches a page of the accounts that follow the given Profile.
+   *
+   * Familiar accounts (those the signing Viewer follows) come first, unfamiliar second, and within each group
+   * the newest listed relationship first with a bytes32 tie-break. The grouping is evaluated per request
+   * against the live graph, so following an account from inside the list moves it between groups on the next
+   * page — deduplicate by subaccount and do not re-sort locally.
+   *
+   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if the viewed Profile is isolated,
+   * `INVALID_FOLLOW_CURSOR` if the cursor is malformed or was issued for a different Viewer, Profile, or list
+   * direction (discard it and restart from the first page), or `INVALID_FOLLOW_LIMIT` if `limit` is outside
+   * 1–50.
+   */
+  async getFollowers(
+    params: GetMobileFollowersParams,
+  ): Promise<MobileFollowListPage> {
+    const signedRequest = await this.getSignedRequest('followers', params, {
+      subaccount: subaccountToHex(params.target),
+      cursor: params.cursor ?? null,
+      limit: params.limit ?? null,
+    });
+    const data = await this.signedQuery(signedRequest);
+    return mapMobileFollowListPage(data);
+  }
+
+  /**
+   * Fetches a page of the accounts the given Profile follows. Ordering, cursor rules, and errors match
+   * {@link MobileClient.getFollowers}. When the Viewer reads their own Following list every row is familiar,
+   * so every `isFollowing` is `true`.
+   */
+  async getFollowing(
+    params: GetMobileFollowingParams,
+  ): Promise<MobileFollowListPage> {
+    const signedRequest = await this.getSignedRequest('following', params, {
+      subaccount: subaccountToHex(params.target),
+      cursor: params.cursor ?? null,
+      limit: params.limit ?? null,
+    });
+    const data = await this.signedQuery(signedRequest);
+    return mapMobileFollowListPage(data);
+  }
+
   /*
   Signed executes
    */
@@ -314,15 +383,43 @@ export class MobileClient {
     return this.execute(signedRequest);
   }
 
+  /**
+   * Sets whether the signing subaccount follows a Profile. Both directions are idempotent: following again
+   * keeps the original relationship creation time, so it does not move the account in recency order, and
+   * unfollowing a relationship that does not exist succeeds with `isFollowing: false`. Unfollowing deletes
+   * the relationship rather than deactivating it, so a later follow gets a new creation time and moves the
+   * account to the front of recency order.
+   *
+   * Only `isFollowing: true` is checked against the canonical Query DB subaccount index, so unfollowing still
+   * works while that index lags.
+   *
+   * @throws {MobileServerFailureError} With error code `INVALID_FOLLOW_TARGET` if the target is the sender or
+   * either party is isolated, `FOLLOWER_NOT_ELIGIBLE` if the sender is not yet in the canonical Query DB
+   * subaccount index, or `FOLLOWING_NOT_FOUND` if the target is not. Both index errors are transient for an
+   * account that is being recorded, so they are retryable after catch-up — unlike `INVALID_FOLLOW_TARGET`.
+   */
+  async setFollow(
+    params: MobileSetFollowParams,
+  ): Promise<MobileFollowMutationResult> {
+    const signedRequest = await this.getSignedRequest('set_follow', params, {
+      subaccount: subaccountToHex(params.target),
+      is_following: params.isFollowing,
+    });
+    const data = await this.execute(signedRequest);
+    return mapMobileFollowMutationResult(data);
+  }
+
   /*
   Base Fns
    */
 
+  // Returns the request narrowed to `type` so `execute` and `signedQuery` can infer their response from the
+  // request they are given, instead of being told the type a second time at the call site.
   protected async getSignedRequest<T extends MobileSignedInner['type']>(
     type: T,
     params: MobileSignedRequestParams,
     innerParams: MobileSignedInnerParams<T>,
-  ): Promise<MobileSignedRequest> {
+  ): Promise<MobileSignedRequest<MobileSignedInnerByType<T>>> {
     // Use the linked signer if provided, otherwise use the default signer provided to the client
     const walletClient =
       this.opts.linkedSignerWalletClient ?? this.opts.walletClient;
@@ -331,7 +428,10 @@ export class MobileClient {
       throw new WalletNotProvidedError();
     }
 
-    const inner = { type, ...innerParams } as unknown as MobileSignedInner;
+    const inner = {
+      type,
+      ...innerParams,
+    } as unknown as MobileSignedInnerByType<T>;
     return buildSignedMobileRequest({ ...params, walletClient, inner });
   }
 
@@ -367,9 +467,11 @@ export class MobileClient {
     return response.data as MobileServerSuccessResponse;
   }
 
-  protected async execute(
-    body: MobileSignedRequest,
-  ): Promise<MobileServerSuccessResponse> {
+  // `T` is inferred from the body's `type` rather than declared by the caller, for the same reason
+  // `publicQuery` spells its body out as an intersection: an indexed access is not an inference site.
+  protected async execute<T extends MobileServerExecuteRequestType>(
+    body: MobileSignedRequest & { type: T },
+  ): Promise<MobileServerExecuteSuccessResponse<T>> {
     const response = await this.axiosInstance.post<MobileServerExecuteResult>(
       `${this.opts.url}/mobile/execute`,
       body,
@@ -379,7 +481,22 @@ export class MobileClient {
     this.checkServerStatus(response);
 
     // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here
-    return response.data as MobileServerSuccessResponse;
+    return response.data as MobileServerExecuteSuccessResponse<T>;
+  }
+
+  protected async signedQuery<T extends MobileServerSignedQueryRequestType>(
+    body: MobileSignedRequest & { type: T },
+  ): Promise<MobileServerSignedQuerySuccessResponse<T>> {
+    const response = await this.axiosInstance.post<unknown>(
+      `${this.opts.url}/mobile/query`,
+      body,
+    );
+
+    this.checkResponseStatus(response);
+    this.checkServerStatus(response);
+
+    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here
+    return response.data as MobileServerSignedQuerySuccessResponse<T>;
   }
 
   /**

package/src/dataMappers.ts

@@ -1,24 +1,37 @@
+import { subaccountToHex } from '@nadohq/shared';
 import {
   MobileFeedPage,
   MobileFeedTrade,
+  MobileFollowListPage,
+  MobileFollowMutationResult,
+  MobileFollowSummary,
+  MobileIdentitySummary,
   MobileNotificationPreferenceScope,
   MobileNotificationPreferences,
+  MobileProfilesInclude,
   MobilePublicProfile,
   MobileRegisteredWallet,
 } from './types/clientTypes';
+import { MobileServerFollowMutationResponse } from './types/serverExecuteTypes';
 import {
   MobileServerFeedTrade,
+  MobileServerFollowSummary,
+  MobileServerIdentitySummary,
   MobileServerNotificationPreferenceScope,
   MobileServerNotificationPreferences,
   MobileServerProfile,
 } from './types/serverModelTypes';
 import {
   MobileServerFeedResponse,
+  MobileServerFollowListResponse,
   MobileServerRegisteredWalletResponse,
 } from './types/serverQueryTypes';
+import { MobileServerProfilesInclude } from './types/serverRequestTypes';
 
 /**
- * Maps a server-side public profile (snake_case) to its client-side (camelCase) representation.
+ * 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`
+ * or zero, so callers can tell "not requested" from a real value.
  */
 export function mapMobilePublicProfile(
   server: MobileServerProfile,
@@ -28,6 +41,66 @@ export function mapMobilePublicProfile(
     username: server.username,
     displayName: server.display_name,
     privateMode: server.private_mode,
+    followerCount: server.follower_count,
+    followingCount: server.following_count,
+    followSummary: server.follow_summary
+      ? mapMobileFollowSummary(server.follow_summary)
+      : undefined,
+  };
+}
+
+/**
+ * Maps a server-side identity summary (snake_case) to its client-side (camelCase) representation.
+ */
+function mapMobileIdentitySummary(
+  server: MobileServerIdentitySummary,
+): MobileIdentitySummary {
+  return {
+    subaccount: server.subaccount,
+    username: server.username,
+    displayName: server.display_name,
+    avatarUrl: server.avatar_url,
+  };
+}
+
+/**
+ * Maps a server-side follow summary to its client-side representation.
+ */
+function mapMobileFollowSummary(
+  server: MobileServerFollowSummary,
+): MobileFollowSummary {
+  return {
+    isFollowing: server.is_following,
+    followedByCount: server.followed_by_count,
+    followedBy: server.followed_by.map(mapMobileIdentitySummary),
+  };
+}
+
+/**
+ * Maps a server-side Followers or Following response to a client-side {@link MobileFollowListPage}.
+ */
+export function mapMobileFollowListPage(
+  server: MobileServerFollowListResponse,
+): MobileFollowListPage {
+  return {
+    accounts: server.accounts.map((account) => ({
+      identity: mapMobileIdentitySummary(account.identity),
+      isFollowing: account.is_following,
+      followerCount: account.follower_count,
+    })),
+    nextCursor: server.next_cursor,
+  };
+}
+
+/**
+ * Maps a server-side follow or unfollow response to its client-side representation.
+ */
+export function mapMobileFollowMutationResult(
+  server: MobileServerFollowMutationResponse,
+): MobileFollowMutationResult {
+  return {
+    isFollowing: server.is_following,
+    followerCount: server.follower_count,
   };
 }
 
@@ -56,6 +129,20 @@ function mapMobileNotificationPreferenceScope(
   return { type: 'product', productId: server.product_id };
 }
 
+/**
+ * Maps client-side profiles includes (camelCase) to the server-side (snake_case) wire shape.
+ */
+export function mapMobileProfilesIncludeToServer(
+  include: MobileProfilesInclude,
+): MobileServerProfilesInclude {
+  return {
+    follow_counts: include.followCounts,
+    follow_summary: include.followSummary
+      ? { view_as: subaccountToHex(include.followSummary.viewAs) }
+      : undefined,
+  };
+}
+
 /**
  * Maps client-side notification preferences (camelCase) to the server-side (snake_case) wire shape.
  */
@@ -86,11 +173,8 @@ function mapMobileNotificationPreferenceScopeToServer(
  */
 function mapMobileFeedTrade(server: MobileServerFeedTrade): MobileFeedTrade {
   return {
+    ...mapMobileIdentitySummary(server),
     orderDigest: server.order_digest,
-    subaccount: server.subaccount,
-    username: server.username,
-    displayName: server.display_name,
-    avatarUrl: server.avatar_url,
     productId: server.product_id,
     quantity: server.quantity,
     notional: server.notional,

package/src/signing/canonicalize.ts

@@ -23,6 +23,26 @@ export function canonicalizeMobileInner(
         locale: inner.locale,
         app_version: inner.app_version,
       };
+    case 'set_follow':
+      return {
+        type: 'set_follow',
+        subaccount: inner.subaccount,
+        is_following: inner.is_following,
+      };
+    case 'followers':
+      return {
+        type: 'followers',
+        subaccount: inner.subaccount,
+        cursor: inner.cursor,
+        limit: inner.limit,
+      };
+    case 'following':
+      return {
+        type: 'following',
+        subaccount: inner.subaccount,
+        cursor: inner.cursor,
+        limit: inner.limit,
+      };
     default: {
       throw new Error(
         `canonicalizeMobileInner: unhandled inner payload type: ${JSON.stringify(inner)}`,

package/src/signing/eip712MethodByType.ts

@@ -10,4 +10,7 @@ export const MOBILE_EIP712_METHOD_BY_TYPE: Record<
   set_username: 'mobile:execute_set_username',
   set_private_mode: 'mobile:execute_set_private_mode',
   register_expo_token: 'mobile:execute_register_expo_token',
+  set_follow: 'mobile:execute_set_follow',
+  followers: 'mobile:query_followers',
+  following: 'mobile:query_following',
 };