@nadohq/mobile-client 0.36.0 → 0.38.0

package/README.md

@@ -1,7 +1,8 @@
 # `@nadohq/mobile-client`
 
 HTTP client for the Nado mobile service API. Manages usernames, public profile lookups, the global trade feed,
-privacy settings, and push notification devices/preferences, using EIP-712 + msgpack signed authentication.
+the follower/following graph, privacy settings, and push notification devices/preferences, using EIP-712 +
+msgpack signed authentication.
 
 [Full SDK Documentation](https://nadohq.github.io/nado-typescript-sdk/index.html)
 
@@ -26,9 +27,9 @@ const mobile = new MobileClient({
 
 // Unsigned public lookups
 const availability = await mobile.getUsernameAvailability({ displayName: 'Alice.One' });
-const profile = await mobile.getPublicProfile({
-  subaccountOwner: '0x...',
-  subaccountName: 'default',
+const [profile] = await mobile.getProfiles({
+  subaccounts: [{ subaccountOwner: '0x...', subaccountName: 'default' }],
+  include: { followCounts: true },
 });
 
 // Signed operations
@@ -45,7 +46,19 @@ await mobile.setUsername({
 
 ### Public Queries
 
-`getUsernameAvailability`, `getPublicProfile`, `getFeed`, `getNotificationPreferences`, `getRegisteredWallet`.
+`getUsernameAvailability`, `getProfiles`, `getFollowers`, `getFollowing`, `getFeed`,
+`getNotificationPreferences`, `getRegisteredWallet`.
+
+`getProfiles` is the only profile route: it batches up to 25 subaccounts, returns them in the requested order,
+and carries follower totals (`include.followCounts`) and a follow summary (`include.followSummary.viewAs`) as
+opt-in includes, so use it for a single subaccount too. The backend still serves the older singular `profile`
+request for compatibility, but it returns base fields only and costs more weight than the batched equivalent,
+so the SDK does not expose it.
+
+`getFollowers` and `getFollowing` take an optional `viewAs`, which selects a viewer perspective rather than
+proving one: with it the page is ordered familiar-first and every row carries an `isFollowing`, without it the
+page is ordered by the listed relationship alone and `isFollowing` is absent rather than `false`. As with
+`include.followSummary.viewAs`, an unsigned route means the claimed viewer is not verified.
 
 ### Public Executes
 
@@ -54,7 +67,7 @@ push token rather than a wallet signature, so they still work at logout when a s
 
 ### Signed Executes
 
-`setUsername`, `setPrivateMode`, `registerExpoToken`.
+`setUsername`, `setPrivateMode`, `registerExpoToken`, `setFollow`.
 
 ### Linked Signers
 

package/dist/{MobileClient-D5TNTnLx.cjs → MobileClient-wjTrqP9z.cjs}

@@ -29,8 +29,8 @@ 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, 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.
 */
 var MobileClient = class {
 	constructor(opts) {
@@ -64,19 +64,60 @@ var MobileClient = class {
 		};
 	}
 	/**
-	* 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.
+	*
+	* @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 getProfiles(params) {
+		const body = {
+			type: "profiles",
+			subaccounts: params.subaccounts.map(_nadohq_shared.subaccountToHex),
+			include: params.include ? require_dataMappers.mapMobileProfilesIncludeToServer(params.include) : void 0
+		};
+		return (await this.publicQuery(body)).profiles.map(require_dataMappers.mapMobilePublicProfile);
+	}
+	/**
+	* Fetches a page of the accounts that follow the given Profile.
+	*
+	* Ordering depends on `viewAs`. With it, accounts the Viewer already follows come first, unfamiliar
+	* accounts second, and every row carries an `isFollowing`. Without it, the page is ordered by the listed
+	* relationship alone and no row carries an `isFollowing`. In both cases the newest listed relationship
+	* comes first within a group, 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 or `viewAs`
+	* is isolated, `INVALID_FOLLOW_CURSOR` if the cursor is malformed or was issued for a different `viewAs`,
+	* Profile, or list direction (discard it and restart from the first page), or `INVALID_FOLLOW_LIMIT` if
+	* `limit` is outside 1–50.
 	*/
-	async getPublicProfile(params) {
+	async getFollowers(params) {
 		const body = {
-			type: "profile",
-			subaccount: (0, _nadohq_shared.subaccountToHex)(params)
+			type: "followers",
+			...require_dataMappers.mapMobileFollowListParamsToServer(params)
 		};
-		return require_dataMappers.mapMobilePublicProfile((await this.publicQuery(body)).profile);
+		return require_dataMappers.mapMobileFollowListPage(await this.publicQuery(body));
+	}
+	/**
+	* Fetches a page of the accounts the given Profile follows. Ordering, cursor rules, and errors match
+	* {@link MobileClient.getFollowers}. When `viewAs` reads its own Following list every row is familiar, so
+	* every `isFollowing` is `true`.
+	*/
+	async getFollowing(params) {
+		const body = {
+			type: "following",
+			...require_dataMappers.mapMobileFollowListParamsToServer(params)
+		};
+		return require_dataMappers.mapMobileFollowListPage(await this.publicQuery(body));
 	}
 	/**
 	* Fetches a page of the global trade feed: public perpetual trades, newest first, optionally filtered by a
@@ -206,6 +247,28 @@ var MobileClient = class {
 		});
 		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) {
+		const signedRequest = await this.getSignedRequest("set_follow", params, {
+			subaccount: (0, _nadohq_shared.subaccountToHex)(params.target),
+			is_following: params.isFollowing
+		});
+		return require_dataMappers.mapMobileFollowMutationResult(await this.execute(signedRequest));
+	}
 	async getSignedRequest(type, params, innerParams) {
 		const walletClient = this.opts.linkedSignerWalletClient ?? this.opts.walletClient;
 		if (walletClient == null) throw new _nadohq_shared.WalletNotProvidedError();
@@ -267,4 +330,4 @@ Object.defineProperty(exports, "__toESM", {
 	}
 });
 
-//# sourceMappingURL=MobileClient-D5TNTnLx.cjs.map
+//# sourceMappingURL=MobileClient-wjTrqP9z.cjs.map

package/dist/MobileClient-wjTrqP9z.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileClient-wjTrqP9z.cjs","names":["subaccountToHex","mapMobileProfilesIncludeToServer","mapMobilePublicProfile","mapMobileFollowListParamsToServer","mapMobileFollowListPage","mapMobileFeedPage","mapMobileNotificationPreferences","mapMobileRegisteredWallet","mapMobileNotificationPreferencesToServer","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  mapMobileFeedPage,\n  mapMobileFollowListPage,\n  mapMobileFollowListParamsToServer,\n  mapMobileFollowMutationResult,\n  mapMobileNotificationPreferences,\n  mapMobileNotificationPreferencesToServer,\n  mapMobileProfilesIncludeToServer,\n  mapMobilePublicProfile,\n  mapMobileRegisteredWallet,\n} from './dataMappers';\nimport {\n  buildSignedMobileRequest,\n  MobileSignedInner,\n  MobileSignedInnerByType,\n  MobileSignedInnerParams,\n  MobileSignedRequest,\n} from './signing';\nimport {\n  GetMobileFeedParams,\n  GetMobileFollowersParams,\n  GetMobileFollowingParams,\n  GetMobileNotificationPreferencesParams,\n  GetMobileProfilesParams,\n  GetMobileRegisteredWalletParams,\n  GetMobileUsernameAvailabilityParams,\n  MobileFeedPage,\n  MobileFollowListPage,\n  MobileFollowMutationResult,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredWallet,\n  MobileRegisterExpoTokenParams,\n  MobileSetFollowParams,\n  MobileSetPrivateModeParams,\n  MobileSetUsernameParams,\n  MobileSignedRequestParams,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport {\n  MobileServerExecuteResult,\n  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, public profile lookups, the global trade feed, the\n * follower/following graph, privacy settings, and push notification device/preference management.\n */\nexport class MobileClient {\n  readonly opts: MobileClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: MobileClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n      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   * 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 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   * Sets a subaccount's username, derived from the given display name. Upserts: the same call claims a first\n   * username and renames an existing one, so callers never need to read the current identity first.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_DISPLAY_NAME` if the display name violates\n   * `MOBILE_DISPLAY_NAME_PATTERN`, `USERNAME_UNAVAILABLE` if the derived username is reserved or already\n   * taken by another subaccount, `INVALID_IDENTITY_TARGET` if the sender is in the engine-created isolated\n   * namespace, or `STALE_IDENTITY_UPDATE` if another identity write for this subaccount committed with a\n   * later nonce (re-read the identity before retrying).\n   */\n  async setUsername(\n    params: MobileSetUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest('set_username', params, {\n      display_name: params.displayName,\n    });\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Sets whether a subaccount's profile is private.\n   */\n  async setPrivateMode(\n    params: MobileSetPrivateModeParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'set_private_mode',\n      params,\n      { private_mode: params.privateMode },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Registers an Expo push token for the wallet, transferring active ownership of the token if another\n   * wallet had registered it. Idempotent per `(wallet, token)`.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is not a valid Expo\n   * push token, or `INVALID_DEVICE_METADATA` if `locale` (max 35 chars) or `appVersion` (max 64 chars) is\n   * too long.\n   */\n  async registerExpoToken(\n    params: MobileRegisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'register_expo_token',\n      params,\n      {\n        expo_token: params.expoToken,\n        platform: params.platform,\n        locale: params.locale ?? null,\n        app_version: params.appVersion ?? null,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * 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}/mobile/public_query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as MobileServerPublicQuerySuccessResponse<T>;\n  }\n\n  protected async publicExecute(\n    body: MobileServerPublicExecuteRequest,\n  ): Promise<MobileServerSuccessResponse> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/mobile/public_execute`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as MobileServerSuccessResponse;\n  }\n\n  // `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}/mobile/execute`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as 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-D5TNTnLx.cjs");
+const require_MobileClient = require("./MobileClient-wjTrqP9z.cjs");
 require("./signing/index.cjs");
 exports.MobileClient = require_MobileClient.MobileClient;

package/dist/MobileClient.d.cts

@@ -1,9 +1,9 @@
-import { _ as MobileSignedRequestParams, a as GetMobileUsernameAvailabilityParams, b as MobileUsernameAvailability, d as MobileNotificationPreferences, f as MobilePublicProfile, g as MobileSetUsernameParams, h as MobileSetPrivateModeParams, i as GetMobileRegisteredWalletParams, m as MobileRegisteredWallet, n as GetMobileNotificationPreferencesParams, p as MobileRegisterExpoTokenParams, r as GetMobilePublicProfileParams, s as MobileFeedPage, t as GetMobileFeedParams, v as MobileUnregisterExpoTokenParams, y as MobileUpdateNotificationPreferencesParams } from "./clientTypes-BwakovWk.cjs";
-import { i as MobileSignedRequest, n as MobileSignedInner, r as MobileSignedInnerParams } from "./types-47IPsDyA.cjs";
-import { a as MobileServerPublicQueryRequestType, i as MobileServerPublicQueryRequestByType } from "./serverRequestTypes-GAtVYIda.cjs";
-import { n as MobileServerSuccessResponse } from "./serverBaseTypes-C8KjE9Fm.cjs";
-import { n as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-Cb5v7y0A.cjs";
-import { o as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-DwE1iJ9f.cjs";
+import { A as MobileUsernameAvailability, C as MobileRegisteredWallet, D as MobileSignedRequestParams, E as MobileSetUsernameParams, O as MobileUnregisterExpoTokenParams, S as MobileRegisterExpoTokenParams, T as MobileSetPrivateModeParams, a as GetMobileNotificationPreferencesParams, c as GetMobileUsernameAvailabilityParams, i as GetMobileFollowingParams, k as MobileUpdateNotificationPreferencesParams, m as MobileFollowMutationResult, o as GetMobileProfilesParams, p as MobileFollowListPage, r as GetMobileFollowersParams, s as GetMobileRegisteredWalletParams, t as GetMobileFeedParams, u as MobileFeedPage, w as MobileSetFollowParams, x as MobilePublicProfile, y as MobileNotificationPreferences } from "./clientTypes-CceWsQzi.cjs";
+import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-UmYaeq1C.cjs";
+import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-Ddws3yXc.cjs";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-YkCmgmt1.cjs";
+import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-DPZbs9ym.cjs";
+import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-RdcIqRnM.cjs";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -30,8 +30,8 @@ interface MobileClientOpts {
   clientType?: string;
 }
 /**
- * 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.
  */
 declare class MobileClient {
   readonly opts: MobileClientOpts;
@@ -48,14 +48,42 @@ declare class MobileClient {
    */
   getUsernameAvailability(params: GetMobileUsernameAvailabilityParams): Promise<MobileUsernameAvailability>;
   /**
-   * 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.
+   *
+   * @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.
+   */
+  getProfiles(params: GetMobileProfilesParams): Promise<MobilePublicProfile[]>;
+  /**
+   * Fetches a page of the accounts that follow the given Profile.
+   *
+   * Ordering depends on `viewAs`. With it, accounts the Viewer already follows come first, unfamiliar
+   * accounts second, and every row carries an `isFollowing`. Without it, the page is ordered by the listed
+   * relationship alone and no row carries an `isFollowing`. In both cases the newest listed relationship
+   * comes first within a group, 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 or `viewAs`
+   * is isolated, `INVALID_FOLLOW_CURSOR` if the cursor is malformed or was issued for a different `viewAs`,
+   * Profile, or list direction (discard it and restart from the first page), or `INVALID_FOLLOW_LIMIT` if
+   * `limit` is outside 1–50.
+   */
+  getFollowers(params: GetMobileFollowersParams): Promise<MobileFollowListPage>;
+  /**
+   * Fetches a page of the accounts the given Profile follows. Ordering, cursor rules, and errors match
+   * {@link MobileClient.getFollowers}. When `viewAs` reads its own Following list every row is familiar, so
+   * every `isFollowing` is `true`.
    */
-  getPublicProfile(params: GetMobilePublicProfileParams): Promise<MobilePublicProfile>;
+  getFollowing(params: GetMobileFollowingParams): Promise<MobileFollowListPage>;
   /**
    * Fetches a page of the global trade feed: public perpetual trades, newest first, optionally filtered by a
    * whole-dollar minimum notional (omitted means unfiltered). Trades by subaccounts that have not claimed a
@@ -137,12 +165,30 @@ declare class MobileClient {
    * too long.
    */
   registerExpoToken(params: MobileRegisterExpoTokenParams): Promise<MobileServerSuccessResponse>;
-  protected getSignedRequest<T extends MobileSignedInner['type']>(type: T, params: MobileSignedRequestParams, innerParams: MobileSignedInnerParams<T>): Promise<MobileSignedRequest>;
+  /**
+   * 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`.
+   */
+  setFollow(params: MobileSetFollowParams): Promise<MobileFollowMutationResult>;
+  protected getSignedRequest<T extends MobileSignedInner['type']>(type: T, params: MobileSignedRequestParams, innerParams: MobileSignedInnerParams<T>): Promise<MobileSignedRequest<MobileSignedInnerByType<T>>>;
   protected publicQuery<T extends MobileServerPublicQueryRequestType>(body: {
     type: T;
   } & MobileServerPublicQueryRequestByType[T]): Promise<MobileServerPublicQuerySuccessResponse<T>>;
   protected publicExecute(body: MobileServerPublicExecuteRequest): Promise<MobileServerSuccessResponse>;
-  protected execute(body: MobileSignedRequest): Promise<MobileServerSuccessResponse>;
+  protected execute<T extends MobileServerExecuteRequestType>(body: MobileSignedRequest & {
+    type: T;
+  }): Promise<MobileServerExecuteSuccessResponse<T>>;
   /**
    * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns
    * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a

package/dist/MobileClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;;UA4DiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAQf;;AAAU;EAJV,wBAAA,GAA2B,uBAAuB;EAW3B;;;EAPvB,UAAA;AAAA;;;;;cAOW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAsEuC;;;;;EAvDlD,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAgGjB;;;EApFL,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EA2GR;;;;;;;;EA1FG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,mBAAA;EAmJR;;;;;;;;;;;;EA9HG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EAuLnC;;;;;;;;EApKhB,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAiMA;;;;;;;;;;EA9KL,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAjGJ;;;;;;;;;;EAwHD,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAxFR;;;;;;;;;;;;EA4GG,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAhDD;;;;;;;;;;EAuEJ,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EA1BT;;;EAoCI,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAbD;;;;;;;;EA8BJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAAA,UAkBK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA;EAAA,UAeK,WAAA,WAAsB,kCAAA,CAAA,CACpC,IAAA;IAAQ,IAAA,EAAM,CAAA;EAAA,IAAM,oCAAA,CAAqC,CAAA,IACxD,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,aAAA,CACd,IAAA,EAAM,gCAAA,GACL,OAAA,CAAQ,2BAAA;EAAA,UAaK,OAAA,CACd,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,2BAAA;EAnDsB;;;;;EAAA,QAqEzB,mBAAA;EAAA,QAYA,iBAAA;AAAA"}
+{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;;UAwEiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAQf;;AAAU;EAJV,wBAAA,GAA2B,uBAAuB;EAW3B;;;EAPvB,UAAA;AAAA;;;;;cAOW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAoFP;;;;;EArEJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAyG6B;;;EA7FnD,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAgHR;;;;;;;;;;;;;;EAzFG,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,mBAAA;EAgMR;;;;;;;;;;;;;;;EArKG,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA0P2B;;;;;EA5OhC,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA4OR;;;;;;;;;;;;EAvNG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EA5H1C;;;;;;;;EA+IT,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAlHL;;;;;;;;;;EAqIA,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAhFD;;;;;;;;;;EAuGJ,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAnEG;;;;;;;;;;;;EAuFR,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAxBL;;;;;;;;;;EA+CA,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EADD;;;EAWJ,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAFL;;;;;;;;EAmBA,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAAA;;;;;;;;;;;;;;;EA6BL,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;EAjC9B;;;;;EAAA,QAmDR,mBAAA;EAAA,QAYA,iBAAA;AAAA"}

package/dist/MobileClient.d.ts

@@ -1,9 +1,9 @@
-import { _ as MobileSignedRequestParams, a as GetMobileUsernameAvailabilityParams, b as MobileUsernameAvailability, d as MobileNotificationPreferences, f as MobilePublicProfile, g as MobileSetUsernameParams, h as MobileSetPrivateModeParams, i as GetMobileRegisteredWalletParams, m as MobileRegisteredWallet, n as GetMobileNotificationPreferencesParams, p as MobileRegisterExpoTokenParams, r as GetMobilePublicProfileParams, s as MobileFeedPage, t as GetMobileFeedParams, v as MobileUnregisterExpoTokenParams, y as MobileUpdateNotificationPreferencesParams } from "./clientTypes-D-o1_2Yc.js";
-import { i as MobileSignedRequest, n as MobileSignedInner, r as MobileSignedInnerParams } from "./types-D5kFJzEX.js";
-import { a as MobileServerPublicQueryRequestType, i as MobileServerPublicQueryRequestByType } from "./serverRequestTypes-516zXnQ6.js";
-import { n as MobileServerSuccessResponse } from "./serverBaseTypes-B_KHFDab.js";
-import { n as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-GFjZj_DC.js";
-import { o as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-NIrPm2Sl.js";
+import { A as MobileUsernameAvailability, C as MobileRegisteredWallet, D as MobileSignedRequestParams, E as MobileSetUsernameParams, O as MobileUnregisterExpoTokenParams, S as MobileRegisterExpoTokenParams, T as MobileSetPrivateModeParams, a as GetMobileNotificationPreferencesParams, c as GetMobileUsernameAvailabilityParams, i as GetMobileFollowingParams, k as MobileUpdateNotificationPreferencesParams, m as MobileFollowMutationResult, o as GetMobileProfilesParams, p as MobileFollowListPage, r as GetMobileFollowersParams, s as GetMobileRegisteredWalletParams, t as GetMobileFeedParams, u as MobileFeedPage, w as MobileSetFollowParams, x as MobilePublicProfile, y as MobileNotificationPreferences } from "./clientTypes-CB_itU4Z.js";
+import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-BIIvIzG2.js";
+import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-Dv9NR-hQ.js";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-C2JGib--.js";
+import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-C2NoNEwu.js";
+import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-B0xI1G39.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -30,8 +30,8 @@ interface MobileClientOpts {
   clientType?: string;
 }
 /**
- * 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.
  */
 declare class MobileClient {
   readonly opts: MobileClientOpts;
@@ -48,14 +48,42 @@ declare class MobileClient {
    */
   getUsernameAvailability(params: GetMobileUsernameAvailabilityParams): Promise<MobileUsernameAvailability>;
   /**
-   * 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.
+   *
+   * @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.
+   */
+  getProfiles(params: GetMobileProfilesParams): Promise<MobilePublicProfile[]>;
+  /**
+   * Fetches a page of the accounts that follow the given Profile.
+   *
+   * Ordering depends on `viewAs`. With it, accounts the Viewer already follows come first, unfamiliar
+   * accounts second, and every row carries an `isFollowing`. Without it, the page is ordered by the listed
+   * relationship alone and no row carries an `isFollowing`. In both cases the newest listed relationship
+   * comes first within a group, 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 or `viewAs`
+   * is isolated, `INVALID_FOLLOW_CURSOR` if the cursor is malformed or was issued for a different `viewAs`,
+   * Profile, or list direction (discard it and restart from the first page), or `INVALID_FOLLOW_LIMIT` if
+   * `limit` is outside 1–50.
+   */
+  getFollowers(params: GetMobileFollowersParams): Promise<MobileFollowListPage>;
+  /**
+   * Fetches a page of the accounts the given Profile follows. Ordering, cursor rules, and errors match
+   * {@link MobileClient.getFollowers}. When `viewAs` reads its own Following list every row is familiar, so
+   * every `isFollowing` is `true`.
    */
-  getPublicProfile(params: GetMobilePublicProfileParams): Promise<MobilePublicProfile>;
+  getFollowing(params: GetMobileFollowingParams): Promise<MobileFollowListPage>;
   /**
    * Fetches a page of the global trade feed: public perpetual trades, newest first, optionally filtered by a
    * whole-dollar minimum notional (omitted means unfiltered). Trades by subaccounts that have not claimed a
@@ -137,12 +165,30 @@ declare class MobileClient {
    * too long.
    */
   registerExpoToken(params: MobileRegisterExpoTokenParams): Promise<MobileServerSuccessResponse>;
-  protected getSignedRequest<T extends MobileSignedInner['type']>(type: T, params: MobileSignedRequestParams, innerParams: MobileSignedInnerParams<T>): Promise<MobileSignedRequest>;
+  /**
+   * 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`.
+   */
+  setFollow(params: MobileSetFollowParams): Promise<MobileFollowMutationResult>;
+  protected getSignedRequest<T extends MobileSignedInner['type']>(type: T, params: MobileSignedRequestParams, innerParams: MobileSignedInnerParams<T>): Promise<MobileSignedRequest<MobileSignedInnerByType<T>>>;
   protected publicQuery<T extends MobileServerPublicQueryRequestType>(body: {
     type: T;
   } & MobileServerPublicQueryRequestByType[T]): Promise<MobileServerPublicQuerySuccessResponse<T>>;
   protected publicExecute(body: MobileServerPublicExecuteRequest): Promise<MobileServerSuccessResponse>;
-  protected execute(body: MobileSignedRequest): Promise<MobileServerSuccessResponse>;
+  protected execute<T extends MobileServerExecuteRequestType>(body: MobileSignedRequest & {
+    type: T;
+  }): Promise<MobileServerExecuteSuccessResponse<T>>;
   /**
    * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns
    * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a

package/dist/MobileClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;;UA4DiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAQf;;AAAU;EAJV,wBAAA,GAA2B,uBAAuB;EAW3B;;;EAPvB,UAAA;AAAA;;;;;cAOW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAsEuC;;;;;EAvDlD,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAgGjB;;;EApFL,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EA2GR;;;;;;;;EA1FG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,mBAAA;EAmJR;;;;;;;;;;;;EA9HG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EAuLnC;;;;;;;;EApKhB,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAiMA;;;;;;;;;;EA9KL,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAjGJ;;;;;;;;;;EAwHD,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAxFR;;;;;;;;;;;;EA4GG,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAhDD;;;;;;;;;;EAuEJ,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EA1BT;;;EAoCI,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAbD;;;;;;;;EA8BJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAAA,UAkBK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA;EAAA,UAeK,WAAA,WAAsB,kCAAA,CAAA,CACpC,IAAA;IAAQ,IAAA,EAAM,CAAA;EAAA,IAAM,oCAAA,CAAqC,CAAA,IACxD,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,aAAA,CACd,IAAA,EAAM,gCAAA,GACL,OAAA,CAAQ,2BAAA;EAAA,UAaK,OAAA,CACd,IAAA,EAAM,mBAAA,GACL,OAAA,CAAQ,2BAAA;EAnDsB;;;;;EAAA,QAqEzB,mBAAA;EAAA,QAYA,iBAAA;AAAA"}
+{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;;UAwEiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAQf;;AAAU;EAJV,wBAAA,GAA2B,uBAAuB;EAW3B;;;EAPvB,UAAA;AAAA;;;;;cAOW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAoFP;;;;;EArEJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAyG6B;;;EA7FnD,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAgHR;;;;;;;;;;;;;;EAzFG,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,mBAAA;EAgMR;;;;;;;;;;;;;;;EArKG,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA0P2B;;;;;EA5OhC,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA4OR;;;;;;;;;;;;EAvNG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EA5H1C;;;;;;;;EA+IT,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAlHL;;;;;;;;;;EAqIA,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAhFD;;;;;;;;;;EAuGJ,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAnEG;;;;;;;;;;;;EAuFR,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAxBL;;;;;;;;;;EA+CA,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EADD;;;EAWJ,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAFL;;;;;;;;EAmBA,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAAA;;;;;;;;;;;;;;;EA6BL,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;EAjC9B;;;;;EAAA,QAmDR,mBAAA;EAAA,QAYA,iBAAA;AAAA"}

package/dist/MobileClient.js

@@ -1,4 +1,4 @@
-import { mapMobileFeedPage, mapMobileNotificationPreferences, mapMobileNotificationPreferencesToServer, mapMobilePublicProfile, mapMobileRegisteredWallet } from "./dataMappers.js";
+import { mapMobileFeedPage, mapMobileFollowListPage, mapMobileFollowListParamsToServer, mapMobileFollowMutationResult, mapMobileNotificationPreferences, mapMobileNotificationPreferencesToServer, mapMobileProfilesIncludeToServer, mapMobilePublicProfile, mapMobileRegisteredWallet } from "./dataMappers.js";
 import { buildSignedMobileRequest } from "./signing/buildSignedMobileRequest.js";
 import "./signing/index.js";
 import { MobileServerFailureError } from "./types/MobileServerFailureError.js";
@@ -7,8 +7,8 @@ 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, 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.
 */
 var MobileClient = class {
 	constructor(opts) {
@@ -42,19 +42,60 @@ var MobileClient = class {
 		};
 	}
 	/**
-	* 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.
+	*
+	* @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 getProfiles(params) {
+		const body = {
+			type: "profiles",
+			subaccounts: params.subaccounts.map(subaccountToHex),
+			include: params.include ? mapMobileProfilesIncludeToServer(params.include) : void 0
+		};
+		return (await this.publicQuery(body)).profiles.map(mapMobilePublicProfile);
+	}
+	/**
+	* Fetches a page of the accounts that follow the given Profile.
+	*
+	* Ordering depends on `viewAs`. With it, accounts the Viewer already follows come first, unfamiliar
+	* accounts second, and every row carries an `isFollowing`. Without it, the page is ordered by the listed
+	* relationship alone and no row carries an `isFollowing`. In both cases the newest listed relationship
+	* comes first within a group, 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 or `viewAs`
+	* is isolated, `INVALID_FOLLOW_CURSOR` if the cursor is malformed or was issued for a different `viewAs`,
+	* Profile, or list direction (discard it and restart from the first page), or `INVALID_FOLLOW_LIMIT` if
+	* `limit` is outside 1–50.
 	*/
-	async getPublicProfile(params) {
+	async getFollowers(params) {
 		const body = {
-			type: "profile",
-			subaccount: subaccountToHex(params)
+			type: "followers",
+			...mapMobileFollowListParamsToServer(params)
 		};
-		return mapMobilePublicProfile((await this.publicQuery(body)).profile);
+		return mapMobileFollowListPage(await this.publicQuery(body));
+	}
+	/**
+	* Fetches a page of the accounts the given Profile follows. Ordering, cursor rules, and errors match
+	* {@link MobileClient.getFollowers}. When `viewAs` reads its own Following list every row is familiar, so
+	* every `isFollowing` is `true`.
+	*/
+	async getFollowing(params) {
+		const body = {
+			type: "following",
+			...mapMobileFollowListParamsToServer(params)
+		};
+		return mapMobileFollowListPage(await this.publicQuery(body));
 	}
 	/**
 	* Fetches a page of the global trade feed: public perpetual trades, newest first, optionally filtered by a
@@ -184,6 +225,28 @@ var MobileClient = class {
 		});
 		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) {
+		const signedRequest = await this.getSignedRequest("set_follow", params, {
+			subaccount: subaccountToHex(params.target),
+			is_following: params.isFollowing
+		});
+		return mapMobileFollowMutationResult(await this.execute(signedRequest));
+	}
 	async getSignedRequest(type, params, innerParams) {
 		const walletClient = this.opts.linkedSignerWalletClient ?? this.opts.walletClient;
 		if (walletClient == null) throw new WalletNotProvidedError();