aftermath-ts-sdk 2.1.0 → 2.2.0-abort.1

package/dist/index.js

@@ -8,11 +8,229 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/general/utils/grpcCasting.ts
+import { fromBase64, toBase64 } from "@mysten/sui/utils";
+var _GrpcCasting, GrpcCasting;
+var init_grpcCasting = __esm({
+  "src/general/utils/grpcCasting.ts"() {
+    "use strict";
+    _GrpcCasting = class _GrpcCasting {
+    };
+    // =========================================================================
+    //  Coins
+    // =========================================================================
+    /**
+     * Reshapes a gRPC `Coin` into JSON-RPC's `CoinStruct`.
+     *
+     * Differences that callers may observe:
+     * - `coinType` is derived from the coin object's `type`
+     *   (`0x2::coin::Coin<T>` -> `T`) and is therefore fully zero-padded, where
+     *   JSON-RPC echoed the node's abbreviated form (e.g. `0x2::sui::SUI`).
+     *   Compare coin types through `Helpers.addLeadingZeroesToType` — as this
+     *   SDK already does everywhere — and the two are equal.
+     * - `previousTransaction` is **not returned by `listCoins`** and is set to
+     *   the empty string. Nothing in this SDK reads it. Fetch the object with
+     *   `include: { previousTransaction: true }` if you need it.
+     */
+    _GrpcCasting.coinStructFromGrpcCoin = (coin) => ({
+      coinType: _GrpcCasting.innerCoinTypeFromCoinObjectType(coin.type),
+      coinObjectId: coin.objectId,
+      version: coin.version,
+      digest: coin.digest,
+      balance: coin.balance,
+      previousTransaction: ""
+    });
+    /**
+     * Extracts `T` from a `0x2::coin::Coin<T>` object type. Returns the input
+     * unchanged when it is not a generic type.
+     */
+    _GrpcCasting.innerCoinTypeFromCoinObjectType = (objectType) => {
+      const start = objectType.indexOf("<");
+      const end = objectType.lastIndexOf(">");
+      if (start < 0 || end < start) {
+        return objectType;
+      }
+      return objectType.slice(start + 1, end);
+    };
+    // =========================================================================
+    //  Dynamic Fields
+    // =========================================================================
+    /**
+     * Reshapes a gRPC `DynamicFieldEntry` into JSON-RPC's `DynamicFieldInfo`.
+     *
+     * Field mapping (verified live against a real parent object):
+     * - `fieldId` -> `objectId`
+     * - `valueType` -> `objectType`
+     * - `$kind` -> `type` (`"DynamicField"` | `"DynamicObject"`)
+     * - `name.bcs` -> `bcsName` (base64), `bcsEncoding: "base64"`
+     *
+     * Differences that callers may observe:
+     * - `name.value` was the **parsed** field name under JSON-RPC. gRPC returns
+     *   only its BCS bytes and this SDK does not carry Move type layouts, so
+     *   `name.value` is the base64 of those bytes. `name.type` is unchanged.
+     * - `version` and `digest` are **not returned by `listDynamicFields`**.
+     *   They are omitted rather than zero-filled. Nothing in this SDK reads
+     *   them; fetch the field object if you need them.
+     */
+    _GrpcCasting.dynamicFieldInfoFromGrpcEntry = (entry) => ({
+      name: {
+        type: entry.name.type,
+        value: toBase64(entry.name.bcs)
+      },
+      bcsEncoding: "base64",
+      bcsName: toBase64(entry.name.bcs),
+      type: entry.$kind,
+      objectType: entry.valueType,
+      objectId: entry.fieldId
+    });
+    // =========================================================================
+    //  Objects
+    // =========================================================================
+    /**
+     * Builds a `SuiObjectResponse` carrying only the fields available from a
+     * gRPC `getObject({ include: { content: true } })` — enough for
+     * {@link Casting.castObjectBcs}, which reads `data.bcs.bcsBytes`.
+     *
+     * The BCS bytes gRPC returns under `content` were verified byte-identical
+     * to JSON-RPC's `bcs.bcsBytes` for every object probed (a `SuiSystemState`,
+     * three Aftermath pools and three `Coin<SUI>` objects).
+     *
+     * `hasPublicTransfer` is not returned by gRPC. It is omitted; nothing in
+     * this SDK reads it.
+     */
+    _GrpcCasting.suiObjectResponseFromGrpcObjectBcs = (object) => ({
+      data: {
+        objectId: object.objectId,
+        version: object.version,
+        digest: object.digest,
+        type: object.type,
+        owner: object.owner,
+        bcs: {
+          dataType: "moveObject",
+          type: object.type,
+          version: object.version,
+          bcsBytes: toBase64(object.content)
+        }
+      }
+    });
+    /**
+     * Reshapes a gRPC `Display` into JSON-RPC's `DisplayFieldsResponse`, so the
+     * NFT/SuiFren display casters keep reading `.data` / `.error` unchanged.
+     *
+     * Two shape differences are reconciled here:
+     * - `output` values are typed `unknown` (Display v2 templates can render
+     *   structured JSON), where `data` was `Record<string, string>`. Non-string
+     *   values are dropped rather than stringified — a caster that assigned an
+     *   object into a `string` field would produce `"[object Object]"` in the UI.
+     * - `errors` is **per-field**, where `error` was whole-object. Surfacing a
+     *   single bad field as a whole-object error would blank out an NFT's entire
+     *   display, so `error` is only populated when `output` is absent entirely.
+     *   Per-field failures simply do not appear in `data`.
+     */
+    _GrpcCasting.displayFieldsResponseFromGrpcDisplay = (display) => {
+      const output = display?.output ?? null;
+      if (output === null) {
+        const errors = display?.errors ?? null;
+        return {
+          data: null,
+          error: errors ? {
+            code: "displayError",
+            error: Object.entries(errors).map(([field, message]) => `${field}: ${message}`).join("; ")
+          } : null
+        };
+      }
+      const data = {};
+      for (const [key, value] of Object.entries(output)) {
+        if (typeof value === "string") {
+          data[key] = value;
+        }
+      }
+      return { data, error: null };
+    };
+    // =========================================================================
+    //  Move Field Shapes
+    // =========================================================================
+    /**
+     * Decodes a `vector<u8>` Move field into a number array.
+     *
+     * gRPC's `json` view base64-encodes byte vectors (`"CQk="`), where JSON-RPC
+     * returned a number array (`[9, 9]`). Indexing the gRPC form directly yields
+     * a one-character **string**, so `Number(...)` of it is `NaN` — a silently
+     * wrong value rather than an error. Always route a byte vector through here.
+     *
+     * Total by design: a number array (or `Uint8Array`) passes through unchanged,
+     * so a caster that has been ported still works when handed a JSON-RPC-shaped
+     * fixture.
+     */
+    _GrpcCasting.bytesFieldToNumbers = (value) => {
+      if (typeof value === "string") {
+        return Array.from(fromBase64(value));
+      }
+      return Array.from(value);
+    };
+    /**
+     * Unwraps a nested Move struct out of JSON-RPC's `{ type, fields }` envelope.
+     *
+     * gRPC's `json` view returns nested structs bare — `{ value: "…" }` where
+     * JSON-RPC returned
+     * `{ type: "0x2::balance::Supply<…>", fields: { value: "…" } }`. The `type`
+     * gRPC drops is not recoverable from the nested value itself; where a caster
+     * needs it, take it from the **enclosing object's** own type parameters via
+     * {@link Helpers.getObjectType}.
+     *
+     * Total by design: a bare struct passes through unchanged.
+     */
+    _GrpcCasting.unwrapStructField = (value) => {
+      if (value !== null && typeof value === "object" && "fields" in value && value.fields !== void 0) {
+        return value.fields;
+      }
+      return value;
+    };
+    /**
+     * Reads a Move `UID` as a bare object id.
+     *
+     * gRPC's `json` view flattens `UID` to a plain string, where JSON-RPC nested
+     * it as `{ id: "0x…" }` (and, one level up, `{ id: { id: "0x…" } }`).
+     * Resolves either shape, recursively, so it is total across both protocols.
+     */
+    _GrpcCasting.unwrapUid = (value) => {
+      if (typeof value === "string") {
+        return value;
+      }
+      if (value !== null && typeof value === "object" && "id" in value) {
+        return _GrpcCasting.unwrapUid(value.id);
+      }
+      return value;
+    };
+    // =========================================================================
+    //  Transactions
+    // =========================================================================
+    /**
+     * Reads the transaction out of a gRPC `simulateTransaction` /
+     * `executeTransaction` result.
+     *
+     * The result is a `$kind`-discriminated union: a simulation that **fails
+     * on-chain** still returns effects, but under `FailedTransaction` rather
+     * than `Transaction`. Reading only the success arm silently drops the gas
+     * estimate exactly when the caller most needs it, so always go through
+     * this helper.
+     */
+    _GrpcCasting.transactionFromResult = (result) => result.$kind === "Transaction" ? result.Transaction : result.FailedTransaction;
+    // =========================================================================
+    //  Bytes
+    // =========================================================================
+    /** Decodes base64 BCS bytes, for symmetry with {@link toBase64}. */
+    _GrpcCasting.bytesFromBase64 = (base64) => fromBase64(base64);
+    GrpcCasting = _GrpcCasting;
+  }
+});
+
 // src/general/apiHelpers/dynamicFieldsApiHelpers.ts
 var _DynamicFieldsApiHelpers, DynamicFieldsApiHelpers;
 var init_dynamicFieldsApiHelpers = __esm({
   "src/general/apiHelpers/dynamicFieldsApiHelpers.ts"() {
     "use strict";
+    init_grpcCasting();
     _DynamicFieldsApiHelpers = class _DynamicFieldsApiHelpers {
       // =========================================================================
       //  Constructor
@@ -90,15 +308,18 @@ var init_dynamicFieldsApiHelpers = __esm({
         };
         this.fetchDynamicFieldsOfTypeWithCursor = async (inputs) => {
           const { parentObjectId, dynamicFieldType } = inputs;
-          const dynamicFieldsResponse = await this.api.client.getDynamicFields({
-            ...inputs,
+          const dynamicFieldsResponse = await this.api.client.listDynamicFields({
+            cursor: inputs.cursor,
             limit: inputs.limit ?? _DynamicFieldsApiHelpers.constants.defaultLimitStepSize,
             parentId: parentObjectId
           });
-          const dynamicFields = dynamicFieldType === void 0 ? dynamicFieldsResponse.data : dynamicFieldsResponse.data.filter(
+          const allDynamicFields = dynamicFieldsResponse.dynamicFields.map(
+            GrpcCasting.dynamicFieldInfoFromGrpcEntry
+          );
+          const dynamicFields = dynamicFieldType === void 0 ? allDynamicFields : allDynamicFields.filter(
             (dynamicField) => typeof dynamicFieldType === "string" ? dynamicField.objectType === dynamicFieldType : dynamicFieldType(dynamicField.objectType)
           );
-          const nextCursor = dynamicFieldsResponse.nextCursor;
+          const nextCursor = dynamicFieldsResponse.cursor;
           return {
             dynamicFields,
             nextCursor
@@ -107,8 +328,27 @@ var init_dynamicFieldsApiHelpers = __esm({
         // =========================================================================
         //  Dynamic Field Objects
         // =========================================================================
-        this.fetchDynamicFieldObject = (inputs) => {
-          return this.api.client.getDynamicFieldObject(inputs);
+        /**
+         * @remarks Ported to `client.core.getDynamicObjectField`.
+         *
+         * ⚠️ **Not** gRPC's `getDynamicField`, which is the obvious-looking target and
+         * the wrong one: it returns the field's value as `{ type, bcs }` only — no
+         * `json` view and no `objectId` — so it cannot feed an object caster.
+         * `getDynamicObjectField` returns `{ object }` in the same shape as
+         * `getObject`, which can. (It lives on `client.core`, not on the client root,
+         * which is why an earlier pass recorded it as unavailable.)
+         *
+         * The return type changes from `SuiObjectResponse` to {@link SuiObjectView},
+         * in step with every other object fetcher here. This helper has **zero
+         * internal callers**, so nothing inside the SDK is affected.
+         */
+        this.fetchDynamicFieldObject = async (inputs) => {
+          const { object } = await this.api.client.core.getDynamicObjectField({
+            parentId: inputs.parentId,
+            name: inputs.name,
+            include: { json: true, display: true }
+          });
+          return object;
         };
       }
     };
@@ -142,17 +382,36 @@ var init_eventsApiHelpers = __esm({
         // TODO: make this filter by looking ONLY at all relevant AF packages
         // TODO: move to wallet package ?
         /**
-         * @deprecated `subscribeEvent` was removed from `SuiJsonRpcClient` in
-         * `@mysten/sui` v2. Poll `queryEvents` instead or use a WebSocket transport.
+         * @deprecated Not implemented. gRPC's
+         * `SubscriptionService.SubscribeEvents` is the replacement — reach it via
+         * `AftermathApi["client"].subscriptionService` — or poll
+         * {@link EventsApiHelpers.fetchCastEventsWithCursor}.
          */
         this.fetchSubscribeToUserEvents = async (_inputs) => {
           throw new Error(
-            "fetchSubscribeToUserEvents is not supported in @mysten/sui v2. subscribeEvent was removed from SuiJsonRpcClient. Poll queryEvents instead or use a WebSocket transport."
+            "fetchSubscribeToUserEvents is not implemented. Use gRPC's SubscriptionService.SubscribeEvents (available on `AftermathApi.client.subscriptionService`), or poll fetchCastEventsWithCursor."
           );
         };
+        /**
+         * @remarks **Remaining JSON-RPC surface** — see
+         * {@link AftermathApi.jsonRpcClient}. `suix_queryEvents` has no
+         * `SuiGrpcClient` equivalent: the only gRPC path is the raw
+         * `ledgerService.ListEvents`, whose filter model and cursor differ from
+         * `SuiEventFilter` / `EventId`, and whose events carry BCS bytes instead of
+         * the `parsedJson` that every `eventFromEventOnChain` caster reads. Porting
+         * it would change this helper's semantics, so it still goes through
+         * JSON-RPC and will stop working when that is removed from fullnodes
+         * (scheduled for mid-October 2026).
+         *
+         * @throws If no `jsonRpcClient` was passed to {@link AftermathApi}, since it
+         * is optional there.
+         */
         this.fetchCastEventsWithCursor = async (inputs) => {
           const { query, eventFromEventOnChain, cursor, limit } = inputs;
-          const fetchedEvents = await this.api.client.queryEvents({
+          const jsonRpcClient = this.api.requireJsonRpcClient(
+            "Events().fetchCastEventsWithCursor"
+          );
+          const fetchedEvents = await jsonRpcClient.queryEvents({
             query,
             cursor: cursor ? { ...cursor, eventSeq: cursor.eventSeq.toString() } : void 0,
             limit
@@ -269,10 +528,12 @@ var init_eventsApiHelpers = __esm({
 });
 
 // src/general/apiHelpers/inspectionsApiHelpers.ts
+import { Transaction } from "@mysten/sui/transactions";
 var _InspectionsApiHelpers, InspectionsApiHelpers;
 var init_inspectionsApiHelpers = __esm({
   "src/general/apiHelpers/inspectionsApiHelpers.ts"() {
     "use strict";
+    init_grpcCasting();
     _InspectionsApiHelpers = class _InspectionsApiHelpers {
       // =========================================================================
       //  Constructor
@@ -293,26 +554,48 @@ var init_inspectionsApiHelpers = __esm({
           const { allBytes } = await this.fetchAllBytesFromTx(inputs);
           return allBytes[allBytes.length - 1];
         };
+        /**
+         * Simulates `tx` and returns the BCS bytes each command returned.
+         *
+         * @remarks Ported from JSON-RPC's `devInspectTransactionBlock` to gRPC's
+         * `simulateTransaction`. Three things differ:
+         * - the sender is taken from the transaction (`tx.setSenderIfNotSet`), not
+         *   passed as a separate option;
+         * - `checksEnabled: false` is what makes inspecting non-entry / non-public
+         *   Move functions possible (with checks on, the node rejects an unsigned
+         *   transaction touching objects the sender does not own);
+         * - return values arrive as `commandResults[i].returnValues[j].bcs`
+         *   (`Uint8Array`) instead of JSON-RPC's `[number[], type]` tuples. Note
+         *   `commandResults` is requested **inside** `include`.
+         *
+         * `events` and `effects` are now gRPC-shaped (`SuiClientTypes.Event` /
+         * `SuiClientTypes.TransactionEffects`) rather than the JSON-RPC types — a
+         * `success: boolean` status instead of `status: "success" | "failure"`, and
+         * BCS bytes rather than `parsedJson` on events. Nothing in this SDK reads
+         * either field.
+         */
         this.fetchAllBytesFromTx = async (inputs) => {
           const sender = inputs.sender ?? _InspectionsApiHelpers.constants.devInspectSigner;
-          const response = await this.api.client.devInspectTransactionBlock({
-            sender,
-            transactionBlock: inputs.tx
+          const tx = Transaction.from(inputs.tx.serialize());
+          tx.setSenderIfNotSet(sender);
+          const simulation = await this.api.client.simulateTransaction({
+            transaction: tx,
+            include: { effects: true, events: true, commandResults: true },
+            checksEnabled: false
           });
-          if (response.effects.status.status === "failure") {
-            throw new Error(
-              response.effects.status.error ?? response.error ?? "dev inspect failed"
-            );
+          const { effects, events, status } = GrpcCasting.transactionFromResult(simulation);
+          if (!status.success) {
+            throw new Error(status.error?.message ?? "dev inspect failed");
           }
-          if (!response.results) {
+          if (!simulation.commandResults) {
             throw new Error("dev inspect move call returned no results");
           }
-          const resultBytes = response.results.map(
-            (result) => result.returnValues?.map((val) => val[0]) ?? []
+          const resultBytes = simulation.commandResults.map(
+            (result) => result.returnValues.map((val) => Array.from(val.bcs))
           );
           return {
-            events: response.events,
-            effects: response.effects,
+            events,
+            effects,
             allBytes: resultBytes
           };
         };
@@ -326,11 +609,16 @@ var init_inspectionsApiHelpers = __esm({
 });
 
 // src/general/apiHelpers/objectsApiHelpers.ts
-var _ObjectsApiHelpers, ObjectsApiHelpers;
+var casterInclude, _ObjectsApiHelpers, ObjectsApiHelpers;
 var init_objectsApiHelpers = __esm({
   "src/general/apiHelpers/objectsApiHelpers.ts"() {
     "use strict";
+    init_grpcCasting();
     init_helpers();
+    casterInclude = (withDisplay) => ({
+      json: true,
+      display: withDisplay === true
+    });
     _ObjectsApiHelpers = class _ObjectsApiHelpers {
       // =========================================================================
       //  Constructor
@@ -344,13 +632,17 @@ var init_objectsApiHelpers = __esm({
         //  Fetching
         // =========================================================================
         this.fetchDoesObjectExist = async (objectId) => {
-          const object = await this.api.client.getObject({ id: objectId });
-          return object.error === void 0;
+          try {
+            await this.api.client.getObject({ objectId });
+            return true;
+          } catch (_e) {
+            return false;
+          }
         };
         this.fetchIsObjectOwnedByAddress = async (inputs) => {
           const { objectId, walletAddress } = inputs;
           const object = await this.fetchObject({ objectId });
-          const objectOwner = object.data?.owner;
+          const objectOwner = object.owner;
           if (!objectOwner || typeof objectOwner !== "object") {
             return false;
           }
@@ -363,74 +655,71 @@ var init_objectsApiHelpers = __esm({
           return false;
         };
         this.fetchObjectsOfTypeOwnedByAddress = async (inputs) => {
-          return this.fetchOwnedObjects({
-            ...inputs,
-            filter: {
-              StructType: Helpers.stripLeadingZeroesFromType(inputs.objectType)
-            }
-          });
+          return this.fetchOwnedObjects(inputs);
         };
         this.fetchOwnedObjects = async (inputs) => {
-          const { walletAddress, withDisplay, filter } = inputs;
+          const { walletAddress, withDisplay, objectType } = inputs;
           let allObjectData = [];
           let cursor;
           do {
-            const paginatedObjects = await this.api.client.getOwnedObjects({
+            const paginatedObjects = await this.api.client.listOwnedObjects({
               owner: walletAddress,
-              options: inputs.options ?? {
-                showContent: true,
-                showDisplay: withDisplay,
-                showOwner: true,
-                showType: true
-              },
+              type: objectType,
+              include: casterInclude(withDisplay),
               limit: _ObjectsApiHelpers.constants.maxObjectFetchingLimit,
-              cursor,
-              filter
+              cursor
             });
-            const objectData = paginatedObjects.data;
-            allObjectData = [...allObjectData, ...objectData];
-            if (paginatedObjects.data.length === 0 || !paginatedObjects.hasNextPage || !paginatedObjects.nextCursor) {
+            allObjectData = [...allObjectData, ...paginatedObjects.objects];
+            if (paginatedObjects.objects.length === 0 || !paginatedObjects.hasNextPage || !paginatedObjects.cursor) {
               return allObjectData;
             }
-            cursor = paginatedObjects.nextCursor;
+            cursor = paginatedObjects.cursor;
           } while (true);
         };
         this.fetchObject = async (inputs) => {
           const { objectId, withDisplay } = inputs;
           return await this.fetchObjectGeneral({
             objectId,
-            options: {
-              showContent: true,
-              showDisplay: withDisplay,
-              showOwner: true,
-              showType: true
-            }
+            include: casterInclude(withDisplay)
           });
         };
         this.fetchObjectGeneral = async (inputs) => {
-          const { objectId, options } = inputs;
-          const object = await this.api.client.getObject({
-            id: objectId,
-            options
-          });
-          if (object.error !== void 0) {
+          const { objectId, include } = inputs;
+          try {
+            const { object } = await this.api.client.getObject({
+              objectId,
+              include: include ?? casterInclude()
+            });
+            return object;
+          } catch (e) {
             throw new Error(
-              `an error occured fetching object: ${object.error?.code}`
+              `an error occured fetching object: ${e instanceof Error ? e.message : String(e)}`
             );
           }
-          return object;
         };
         this.fetchCastObject = async (inputs) => {
           return inputs.objectFromSuiObjectResponse(await this.fetchObject(inputs));
         };
         this.fetchCastObjectGeneral = async (inputs) => {
-          const { objectId, objectFromSuiObjectResponse, options } = inputs;
+          const { objectId, objectFromSuiObjectResponse, include } = inputs;
           return objectFromSuiObjectResponse(
-            await this.fetchObjectGeneral({ objectId, options })
+            await this.fetchObjectGeneral({ objectId, include })
           );
         };
+        /**
+         * @remarks gRPC's `getObjects` returns `(Object | Error)[]` — a **per-object
+         * error arm JSON-RPC's `multiGetObjects` did not have**, delivered as real
+         * `Error` instances. Those entries are dropped rather than handed to a caster:
+         * spreading one into `objectFromSuiObjectResponse` would throw deep inside the
+         * cast with a message that names neither the batch nor the missing id.
+         *
+         * This is a deliberate behaviour change and the more forgiving one. Previously
+         * a single missing object in a batch threw from inside the caster and lost the
+         * whole batch; now the surviving objects are returned. `nftsFromSuiObjects`
+         * already filtered its input, so the app-visible result is unchanged.
+         */
         this.fetchObjectBatch = async (inputs) => {
-          const { objectIds, options } = inputs;
+          const { objectIds, include, withDisplay } = inputs;
           const objectIdsBatches = [];
           let endIndex = 0;
           while (true) {
@@ -444,51 +733,43 @@ var init_objectsApiHelpers = __esm({
           }
           const objectBatches = await Promise.all(
             objectIdsBatches.map(
-              (objectIds2) => this.api.client.multiGetObjects({
-                ids: objectIds2,
-                options: options === void 0 ? {
-                  showContent: true,
-                  showOwner: true,
-                  showType: true
-                } : options
+              (batchIds) => this.api.client.getObjects({
+                objectIds: batchIds,
+                include: include ?? casterInclude(withDisplay)
               })
             )
           );
-          const objectBatch = objectBatches.reduce(
-            (acc, objects) => [...acc, ...objects],
-            []
+          return objectBatches.flatMap(
+            (batch) => batch.objects.filter(
+              (object) => !(object instanceof Error)
+            )
           );
-          return objectBatch;
         };
         this.fetchCastObjectBatch = async (inputs) => {
           return (await this.fetchObjectBatch(inputs)).map(
-            (SuiObjectResponse) => {
-              return inputs.objectFromSuiObjectResponse(SuiObjectResponse);
-            }
+            (object) => inputs.objectFromSuiObjectResponse(object)
           );
         };
         this.fetchCastObjectsOwnedByAddressOfType = async (inputs) => {
-          const objects = (await this.fetchObjectsOfTypeOwnedByAddress(inputs)).map(
-            (SuiObjectResponse) => {
-              return inputs.objectFromSuiObjectResponse(SuiObjectResponse);
-            }
+          return (await this.fetchObjectsOfTypeOwnedByAddress(inputs)).map(
+            (object) => inputs.objectFromSuiObjectResponse(object)
           );
-          return objects;
         };
         // =========================================================================
         //  BCS
         // =========================================================================
         this.fetchObjectBcs = async (objectId) => {
-          const objectResponse = await this.api.client.getObject({
-            id: objectId,
-            options: { showBcs: true }
-          });
-          if (objectResponse.error !== void 0) {
+          try {
+            const { object } = await this.api.client.getObject({
+              objectId,
+              include: { content: true }
+            });
+            return GrpcCasting.suiObjectResponseFromGrpcObjectBcs(object);
+          } catch (e) {
             throw new Error(
-              `an error occured fetching object: ${objectResponse.error?.code}`
+              `an error occured fetching object: ${e instanceof Error ? e.message : String(e)}`
             );
           }
-          return objectResponse;
         };
         this.fetchCastObjectBcs = async (inputs) => {
           const { objectId } = inputs;
@@ -539,12 +820,13 @@ var init_objectsApiHelpers = __esm({
 
 // src/general/apiHelpers/transactionsApiHelpers.ts
 import {
-  Transaction
+  Transaction as Transaction2
 } from "@mysten/sui/transactions";
 var _TransactionsApiHelpers, TransactionsApiHelpers;
 var init_transactionsApiHelpers = __esm({
   "src/general/apiHelpers/transactionsApiHelpers.ts"() {
     "use strict";
+    init_grpcCasting();
     init_helpers();
     _TransactionsApiHelpers = class _TransactionsApiHelpers {
       // =========================================================================
@@ -558,22 +840,34 @@ var init_transactionsApiHelpers = __esm({
         // =========================================================================
         //  Fetching
         // =========================================================================
+        /**
+         * @remarks **Remaining JSON-RPC surface.** `suix_queryTransactionBlocks` has
+         * no gRPC equivalent — Sui's own migration cookbook directs callers to
+         * GraphQL or an indexer — so this helper still goes through
+         * {@link AftermathApi.jsonRpcClient} and will stop working when JSON-RPC is
+         * removed from fullnodes (scheduled for mid-October 2026). Prefer the
+         * Aftermath API's transaction-history endpoints.
+         *
+         * @throws If no `jsonRpcClient` was passed to {@link AftermathApi}, since it
+         * is optional there.
+         */
         this.fetchTransactionsWithCursor = async (inputs) => {
           const { query, cursor, limit } = inputs;
-          const transactionsWithCursor = await this.api.client.queryTransactionBlocks(
-            {
-              ...query,
-              cursor,
-              limit,
-              options: {
-                showEvents: true,
-                showBalanceChanges: true,
-                showEffects: true,
-                showObjectChanges: true,
-                showInput: true
-              }
-            }
+          const jsonRpcClient = this.api.requireJsonRpcClient(
+            "Transactions().fetchTransactionsWithCursor"
           );
+          const transactionsWithCursor = await jsonRpcClient.queryTransactionBlocks({
+            ...query,
+            cursor,
+            limit,
+            options: {
+              showEvents: true,
+              showBalanceChanges: true,
+              showEffects: true,
+              showObjectChanges: true,
+              showInput: true
+            }
+          });
           return {
             transactions: transactionsWithCursor.data,
             nextCursor: transactionsWithCursor.nextCursor ?? null
@@ -581,15 +875,17 @@ var init_transactionsApiHelpers = __esm({
         };
         this.fetchSetGasBudgetForTx = async (inputs) => {
           const { tx } = inputs;
-          const [txResponse, referenceGasPrice] = await Promise.all([
-            this.api.client.dryRunTransactionBlock({
-              transactionBlock: await tx.build({
+          const [simulation, { referenceGasPrice }] = await Promise.all([
+            this.api.client.simulateTransaction({
+              transaction: await tx.build({
                 client: this.api.client
-              })
+              }),
+              include: { effects: true }
             }),
             this.api.client.getReferenceGasPrice()
           ]);
-          const gasData = txResponse.effects.gasUsed;
+          const { effects } = GrpcCasting.transactionFromResult(simulation);
+          const gasData = effects.gasUsed;
           const gasUsed = BigInt(gasData.computationCost) + BigInt(gasData.storageCost);
           const safeGasBudget = gasUsed + gasUsed / BigInt(10);
           tx.setGasBudget(safeGasBudget);
@@ -643,7 +939,7 @@ var init_transactionsApiHelpers = __esm({
     _TransactionsApiHelpers.createTxTarget = (packageAddress, packageName, functionName) => `${packageAddress}::${packageName}::${functionName}`;
     _TransactionsApiHelpers.createBuildTxFunc = (func) => {
       const builderFunc = (someInputs) => {
-        const tx = new Transaction();
+        const tx = new Transaction2();
         tx.setSender(someInputs.walletAddress);
         func({
           tx,
@@ -838,6 +1134,7 @@ var init_helpers = __esm({
   "src/general/utils/helpers.ts"() {
     "use strict";
     init_dynamicFieldsApiHelpers();
+    init_grpcCasting();
     init_eventsApiHelpers();
     init_inspectionsApiHelpers();
     init_objectsApiHelpers();
@@ -915,63 +1212,113 @@ var init_helpers = __esm({
       //  Sui Object Parsing
       // =========================================================================
       /**
-       * Extracts the fully qualified type (e.g., "0x2::coin::Coin<...>") from a `SuiObjectResponse`,
-       * normalizing it with leading zeroes if necessary.
-       *
-       * @param data - The object response from Sui.
+       * Extracts the fully qualified type (e.g., "0x2::coin::Coin<...>") from a
+       * gRPC object view, normalizing it with leading zeroes if necessary.
+       *
+       * ⚠️ **Not byte-invariant across protocols when the type has generic
+       * parameters.** Measured on real mainnet objects:
+       * - For a type with **no** generic parameters the two protocols agree after
+       *   normalization: gRPC serves `0x0000…0002::kiosk::KioskOwnerCap` and
+       *   JSON-RPC serves `0x2::kiosk::KioskOwnerCap`, and
+       *   {@link Helpers.addLeadingZeroesToType} maps both to the same string.
+       * - **Inside** a generic parameter they differ: gRPC fully zero-pads every
+       *   address (`OneTimeAdminCap<0x0000…0002::sui::SUI>`) where JSON-RPC echoes
+       *   the node's abbreviated form (`OneTimeAdminCap<0x2::sui::SUI>`), and gRPC
+       *   emits no space after a generic's comma. `addLeadingZeroesToType`
+       *   normalizes only the **outer** address — and separately strips `0x` from
+       *   the first generic parameter — so the difference survives into this
+       *   accessor's output.
+       *
+       * That divergence is **cosmetic and accepted**: it is purely address padding
+       * and comma spacing, semantically the same Move type. It is pinned by
+       * `tests/objectCasters.test.ts` ("FINDING: generic `objectType` differs
+       * across protocols"). The underlying `addLeadingZeroesToType` generics bug
+       * pre-dates the gRPC migration and is filed as its own plan — do not fix it
+       * here.
+       *
+       * Still **load-bearing**, and still safe for it: the type's *semantic* content
+       * is protocol-invariant, which is what lets a caster recover the `type` of a
+       * nested struct that gRPC's `json` view drops (see
+       * {@link GrpcCasting.unwrapStructField}) from the enclosing object's own type
+       * parameters — as `poolObjectFromSuiObject` does for its LP coin.
+       *
+       * @param data - The object view from Sui.
        * @returns The normalized object type string.
        * @throws If the type is not found.
        */
       static getObjectType(data) {
-        const objectType = data.data?.type;
+        const objectType = data?.type;
         if (objectType) {
           return _Helpers.addLeadingZeroesToType(objectType);
         }
-        throw new Error(`no object type found on ${data.data?.objectId}`);
+        throw new Error(`no object type found on ${data?.objectId}`);
       }
       /**
-       * Extracts the object ID from a `SuiObjectResponse`, normalizing it with leading zeroes.
+       * Extracts the object ID from a gRPC object view, normalizing it with
+       * leading zeroes.
        *
-       * @param data - The object response from Sui.
+       * @param data - The object view from Sui.
        * @returns A zero-padded `ObjectId`.
        * @throws If the objectId is not found.
        */
       static getObjectId(data) {
-        const objectId = data.data?.objectId;
+        const objectId = data?.objectId;
         if (objectId) {
           return _Helpers.addLeadingZeroesToType(objectId);
         }
-        throw new Error(`no object id found on ${data.data?.type}`);
+        throw new Error(`no object id found on ${data?.type}`);
       }
       /**
-       * Retrieves the fields of a Move object from a `SuiObjectResponse`.
+       * Retrieves the Move fields of an object from a gRPC object view.
+       *
+       * ⚠️ This is the gRPC **`json` view**, which is *not* shape-identical to
+       * JSON-RPC's `content.fields`: nested structs arrive without their
+       * `{ type, fields }` envelope, `vector<u8>` arrives base64-encoded, and
+       * `UID` arrives as a bare string. Route those through
+       * {@link GrpcCasting.unwrapStructField}, {@link GrpcCasting.bytesFieldToNumbers}
+       * and {@link GrpcCasting.unwrapUid} respectively.
        *
-       * @param data - The Sui object response containing a Move object.
+       * ⚠️ The return type is `Record<string, any>`, so **no field read below this
+       * point is typechecked**. A wrong read is a silently wrong value, not a
+       * build error. `tests/objectCasters.test.ts` is the only guard.
+       *
+       * `json` is `undefined` unless `include: { json: true }` was passed at the
+       * fetch site.
+       *
+       * @param data - The Sui object view containing a Move object.
        * @returns A record of fields for that object.
        * @throws If no fields are found.
        */
       // biome-ignore lint/suspicious/noExplicitAny: Move fields are dynamic — callers access nested properties directly; typing as `unknown` would cascade casts through dozens of call sites
       static getObjectFields(data) {
-        try {
-          const content = data.data?.content;
-          return content.fields;
-        } catch (_e) {
-          throw new Error(`no object fields found on ${data.data?.objectId}`);
+        const fields = data?.json;
+        if (fields) {
+          return fields;
         }
+        throw new Error(`no object fields found on ${data?.objectId}`);
       }
       /**
-       * Retrieves display metadata from a Sui object response, if present.
+       * Retrieves display metadata from a gRPC object view, if present.
+       *
+       * Reshaped onto JSON-RPC's `DisplayFieldsResponse` so the display casters are
+       * unaffected by the transport change — see
+       * {@link GrpcCasting.displayFieldsResponseFromGrpcDisplay} for the two
+       * semantic differences that reshape absorbs.
+       *
+       * `display` is `undefined` unless `include: { display: true }` was passed at
+       * the fetch site (`withDisplay` on the `ObjectsApiHelpers` fetchers), and
+       * `null` when the object's type has no Display template.
        *
-       * @param data - The Sui object response.
+       * @param data - The Sui object view.
        * @returns The display fields for that object.
-       * @throws If display fields are not found.
+       * @throws If display was not requested at the fetch site.
        */
       static getObjectDisplay(data) {
-        const display = data.data?.display;
-        if (display) {
-          return display;
+        const display = data?.display;
+        if (display === void 0) {
+          throw new Error(`no object display found on ${data?.objectId}`);
         }
-        throw new Error(`no object display found on ${data.data?.objectId}`);
+        return GrpcCasting.displayFieldsResponseFromGrpcDisplay(display);
       }
       // =========================================================================
       //  Error Parsing
@@ -1521,8 +1868,150 @@ var init_helpers = __esm({
   }
 });
 
+// src/general/utils/transportError.ts
+function defaultMessage(kind, status) {
+  if (kind === "http") {
+    return status === void 0 ? "Aftermath HTTP request failed" : `Aftermath HTTP request failed with status ${status}`;
+  }
+  if (kind === "network") {
+    return "Aftermath network request failed";
+  }
+  if (kind === "abort") {
+    return "Aftermath request was aborted";
+  }
+  if (kind === "timeout") {
+    return "Aftermath request timed out";
+  }
+  return "Aftermath response could not be decoded";
+}
+function isAftermathTransportError(error) {
+  return error instanceof AftermathTransportError;
+}
+function getProperty(value, property) {
+  if (value === null || typeof value !== "object" && typeof value !== "function") {
+    return void 0;
+  }
+  try {
+    return value[property];
+  } catch {
+    return void 0;
+  }
+}
+function getStringProperty(value, property) {
+  const propertyValue = getProperty(value, property);
+  return typeof propertyValue === "string" ? propertyValue : void 0;
+}
+function getStringCode(value) {
+  return getStringProperty(value, "code");
+}
+function isTimeoutCode(code) {
+  return code !== void 0 && TIMEOUT_CODES.has(code);
+}
+function isTimeoutReason(reason) {
+  if (isAftermathTransportError(reason) && (reason.kind === "timeout" || reason.abortSource === "timeout")) {
+    return true;
+  }
+  return getProperty(reason, "name") === "TimeoutError" || isTimeoutCode(getStringCode(reason));
+}
+function parseRetryAfter(headerValue, nowMs = Date.now()) {
+  if (headerValue === null) {
+    return void 0;
+  }
+  const value = headerValue.trim();
+  if (value === "") {
+    return void 0;
+  }
+  if (DELTA_SECONDS_REGEX.test(value)) {
+    const milliseconds = BigInt(value) * 1000n;
+    return milliseconds <= MAX_SAFE_INTEGER_BIGINT ? Number(milliseconds) : void 0;
+  }
+  if (!HTTP_DATE_REGEX.test(value)) {
+    return void 0;
+  }
+  const dateMs = Date.parse(value);
+  if (!Number.isFinite(dateMs)) {
+    return void 0;
+  }
+  const retryAfterMs = dateMs - nowMs;
+  return retryAfterMs >= 0 && Number.isSafeInteger(retryAfterMs) ? retryAfterMs : void 0;
+}
+function normalizeAftermathTransportError(error, signal) {
+  if (isAftermathTransportError(error)) {
+    return error;
+  }
+  const errorCode = getStringCode(error);
+  const signalReason = signal?.aborted ? signal.reason : void 0;
+  const signalReasonCode = getStringCode(signalReason);
+  const code = errorCode ?? signalReasonCode;
+  if (signal?.aborted) {
+    const timeout = isTimeoutReason(signalReason) || isTimeoutReason(error);
+    return new AftermathTransportError(timeout ? "timeout" : "abort", {
+      abortSource: timeout ? "timeout" : "caller",
+      cause: error,
+      code
+    });
+  }
+  if (isTimeoutReason(error)) {
+    return new AftermathTransportError("timeout", {
+      abortSource: "timeout",
+      cause: error,
+      code: errorCode
+    });
+  }
+  return new AftermathTransportError("network", {
+    cause: error,
+    code: errorCode
+  });
+}
+var MAX_SAFE_INTEGER_BIGINT, DELTA_SECONDS_REGEX, HTTP_DATE_REGEX, TIMEOUT_CODES, AftermathTransportError;
+var init_transportError = __esm({
+  "src/general/utils/transportError.ts"() {
+    "use strict";
+    MAX_SAFE_INTEGER_BIGINT = BigInt(Number.MAX_SAFE_INTEGER);
+    DELTA_SECONDS_REGEX = /^\d+$/;
+    HTTP_DATE_REGEX = /^(?:[A-Za-z]{3}, \d{2} [A-Za-z]{3} \d{4} \d{2}:\d{2}:\d{2} GMT|[A-Za-z]+, \d{2}-[A-Za-z]{3}-\d{2} \d{2}:\d{2}:\d{2} GMT|[A-Za-z]{3} [A-Za-z]{3} {1,2}\d{1,2} \d{2}:\d{2}:\d{2} \d{4})$/;
+    TIMEOUT_CODES = /* @__PURE__ */ new Set([
+      "UND_ERR_BODY_TIMEOUT",
+      "UND_ERR_CONNECT_TIMEOUT",
+      "UND_ERR_HEADERS_TIMEOUT",
+      "ETIMEDOUT"
+    ]);
+    AftermathTransportError = class extends Error {
+      constructor(kind, options = {}) {
+        const causeMessage = getStringProperty(options.cause, "message");
+        super(
+          options.message ?? causeMessage ?? defaultMessage(kind, options.status)
+        );
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.name = options.name ?? getStringProperty(options.cause, "name") ?? "AftermathTransportError";
+        this.kind = kind;
+        if (options.status !== void 0) {
+          this.status = options.status;
+        }
+        if (options.retryAfterMs !== void 0) {
+          this.retryAfterMs = options.retryAfterMs;
+        }
+        if (options.code !== void 0) {
+          this.code = options.code;
+        }
+        if (options.abortSource !== void 0) {
+          this.abortSource = options.abortSource;
+        }
+        if (options.cause !== void 0) {
+          Object.defineProperty(this, "cause", {
+            configurable: true,
+            enumerable: false,
+            value: options.cause,
+            writable: false
+          });
+        }
+      }
+    };
+  }
+});
+
 // src/general/utils/caller.ts
-import { Transaction as Transaction2 } from "@mysten/sui/transactions";
+import { Transaction as Transaction3 } from "@mysten/sui/transactions";
 function bigIntReplacer(_key, value) {
   if (typeof value === "bigint") {
     return `${value.toString()}n`;
@@ -1534,6 +2023,7 @@ var init_caller = __esm({
   "src/general/utils/caller.ts"() {
     "use strict";
     init_helpers();
+    init_transportError();
     _Caller = class _Caller {
       // =========================================================================
       //  Constructor
@@ -1544,7 +2034,8 @@ var init_caller = __esm({
             throw new Error("no apiBaseUrl: unable to fetch data");
           }
           const safeUrl = this.apiBaseUrl.slice(-1) === "/" ? this.apiBaseUrl.slice(0, -1) : this.apiBaseUrl;
-          return `${safeUrl}/${this.apiEndpoint}/${this.apiUrlPrefix + (url === "" ? "" : "/")}${url}`;
+          const endpointSegment = this.apiEndpoint ? `${this.apiEndpoint}/` : "";
+          return `${safeUrl}/${endpointSegment}${this.apiUrlPrefix + (url === "" ? "" : "/")}${url}`;
         };
         this.setAccessToken = (accessToken) => {
           this.config.accessToken = accessToken;
@@ -1560,11 +2051,26 @@ var init_caller = __esm({
       static async fetchResponseToType(response, disableBigIntJsonParsing) {
         if (!response.ok) {
           const status = response.status;
+          const retryAfterMs = parseRetryAfter(response.headers.get("Retry-After"));
+          const statusText = response.statusText;
           const body = await response.text();
-          throw new Error(`HTTP ${status} ${response.statusText}: ${body}`);
+          throw new AftermathTransportError("http", {
+            message: `HTTP ${status} ${statusText}: ${body}`,
+            name: "Error",
+            retryAfterMs,
+            status
+          });
         }
         const text = await response.text();
-        const output = disableBigIntJsonParsing ? JSON.parse(text, (_key, value) => value === null ? void 0 : value) : Helpers.parseJsonWithBigint(text);
+        let output;
+        try {
+          output = disableBigIntJsonParsing ? JSON.parse(
+            text,
+            (_key, value) => value === null ? void 0 : value
+          ) : Helpers.parseJsonWithBigint(text);
+        } catch (cause) {
+          throw new AftermathTransportError("decode", { cause });
+        }
         return output ?? void 0;
       }
       /**
@@ -1589,21 +2095,25 @@ var init_caller = __esm({
       //  Api Calling
       // =========================================================================
       async fetchApi(url, body, signal, options) {
-        const apiCallUrl = this.urlForApiCall(url);
-        const headers = {
-          "Content-Type": "application/json",
-          ...this.config.accessToken ? { Authorization: `Bearer ${this.config.accessToken}` } : {}
-        };
-        const uncastResponse = await (body === void 0 ? fetch(apiCallUrl, { headers, signal }) : fetch(apiCallUrl, {
-          method: "POST",
-          body: JSON.stringify(body, bigIntReplacer),
-          headers,
-          signal
-        }));
-        return _Caller.fetchResponseToType(
-          uncastResponse,
-          !!options?.disableBigIntJsonParsing
-        );
+        try {
+          const apiCallUrl = this.urlForApiCall(url);
+          const headers = {
+            "Content-Type": "application/json",
+            ...this.config.accessToken ? { Authorization: `Bearer ${this.config.accessToken}` } : {}
+          };
+          const uncastResponse = await (body === void 0 ? fetch(apiCallUrl, { headers, signal }) : fetch(apiCallUrl, {
+            method: "POST",
+            body: JSON.stringify(body, bigIntReplacer),
+            headers,
+            signal
+          }));
+          return await _Caller.fetchResponseToType(
+            uncastResponse,
+            !!options?.disableBigIntJsonParsing
+          );
+        } catch (error) {
+          throw normalizeAftermathTransportError(error, signal);
+        }
       }
       async fetchApiTransaction(url, body, signal, options) {
         const txKind = await this.fetchApi(
@@ -1612,7 +2122,7 @@ var init_caller = __esm({
           signal,
           options
         );
-        const tx = options?.txKind ? Transaction2.fromKind(txKind) : Transaction2.from(txKind);
+        const tx = options?.txKind ? Transaction3.fromKind(txKind) : Transaction3.from(txKind);
         if (body?.walletAddress) {
           tx.setSender(body.walletAddress);
         }
@@ -1625,7 +2135,7 @@ var init_caller = __esm({
           signal,
           options
         );
-        const tx = response.sponsorSignature ? Transaction2.from(response.txKind) : Transaction2.fromKind(response.txKind);
+        const tx = response.sponsorSignature ? Transaction3.from(response.txKind) : Transaction3.fromKind(response.txKind);
         const { txKind, ...rest } = response;
         return { ...rest, tx };
       }
@@ -1665,7 +2175,8 @@ var init_caller = __esm({
             ""
           );
           const baseWs = baseHttp.replace(_Caller.HTTP_PROTOCOL_REGEX, "ws$1://");
-          const prefix = `${this.apiEndpoint}/${this.apiUrlPrefix}`;
+          const endpointSegment = this.apiEndpoint ? `${this.apiEndpoint}/` : "";
+          const prefix = `${endpointSegment}${this.apiUrlPrefix}`;
           const normalizedPrefix = prefix.replace(
             _Caller.TRAILING_SLASHES_REGEX,
             ""
@@ -1768,10 +2279,13 @@ var init_prices = __esm({
        * console.log(suiPriceInfo.price, suiPriceInfo.priceChange24HoursPercentage);
        * ```
        */
-      async getCoinPriceInfo(inputs) {
-        const coinsToPriceInfo = await this.getCoinsToPriceInfo({
-          coins: [inputs.coin]
-        });
+      async getCoinPriceInfo(inputs, abortSignal) {
+        const coinsToPriceInfo = await this.getCoinsToPriceInfo(
+          {
+            coins: [inputs.coin]
+          },
+          abortSignal
+        );
         return Object.values(coinsToPriceInfo)[0];
       }
       /**
@@ -1790,8 +2304,8 @@ var init_prices = __esm({
        * console.log(info);
        * ```
        */
-      async getCoinsToPriceInfo(inputs) {
-        return this.fetchApi("", inputs);
+      async getCoinsToPriceInfo(inputs, abortSignal) {
+        return this.fetchApi("", inputs, abortSignal);
       }
       /**
        * Fetches only the current price in USD for a single coin.
@@ -1806,8 +2320,8 @@ var init_prices = __esm({
        * console.log("SUI price in USD:", suiPrice);
        * ```
        */
-      async getCoinPrice(inputs) {
-        const priceInfo = await this.getCoinPriceInfo(inputs);
+      async getCoinPrice(inputs, abortSignal) {
+        const priceInfo = await this.getCoinPriceInfo(inputs, abortSignal);
         return priceInfo.price;
       }
       /**
@@ -1823,8 +2337,11 @@ var init_prices = __esm({
        * console.log(multiPrices["0x2::sui::SUI"]); // e.g. 1.23
        * ```
        */
-      async getCoinsToPrice(inputs) {
-        const coinsToPriceInfo = await this.getCoinsToPriceInfo(inputs);
+      async getCoinsToPrice(inputs, abortSignal) {
+        const coinsToPriceInfo = await this.getCoinsToPriceInfo(
+          inputs,
+          abortSignal
+        );
         const coinsToPrice = Object.entries(coinsToPriceInfo).reduce(
           (acc, [coinType, info]) => ({
             ...acc,
@@ -1885,9 +2402,9 @@ var init_coin = __esm({
        * console.log(decimals); // { "0x2::sui::SUI": 9, "0x<...>": 6 }
        * ```
        */
-      async getCoinsToDecimals(inputs) {
+      async getCoinsToDecimals(inputs, abortSignal) {
         const { coins } = inputs;
-        const metadatas = await this.getCoinMetadatas(inputs);
+        const metadatas = await this.getCoinMetadatas(inputs, abortSignal);
         const coinsToDecimals = metadatas.map((data) => data.decimals).reduce((acc, decimals, index) => {
           return { ...acc, [coins[index]]: decimals };
         }, {});
@@ -1907,7 +2424,7 @@ var init_coin = __esm({
        * console.log(metadata.name, metadata.symbol, metadata.decimals);
        * ```
        */
-      async getCoinMetadata(coin) {
+      async getCoinMetadata(coin, abortSignal) {
         if (this.metadata) {
           return this.metadata;
         }
@@ -1915,7 +2432,10 @@ var init_coin = __esm({
         if (!coinType) {
           throw new Error("no valid coin type");
         }
-        const [metadata] = await this.getCoinMetadatas({ coins: [coinType] });
+        const [metadata] = await this.getCoinMetadatas(
+          { coins: [coinType] },
+          abortSignal
+        );
         this.setCoinMetadata(metadata);
         return metadata;
       }
@@ -1934,12 +2454,13 @@ var init_coin = __esm({
        * console.log(metas[0].symbol, metas[1].symbol);
        * ```
        */
-      async getCoinMetadatas(inputs) {
+      async getCoinMetadatas(inputs, abortSignal) {
         return this.fetchApi(
           "metadata",
           {
             coins: inputs.coins.map((coin) => Helpers.addLeadingZeroesToType(coin))
-          }
+          },
+          abortSignal
         );
       }
       /**
@@ -1964,7 +2485,7 @@ var init_coin = __esm({
        * console.log(priceInfo.price, priceInfo.priceChange24HoursPercentage);
        * ```
        */
-      async getPrice(coin) {
+      async getPrice(coin, abortSignal) {
         if (this.priceInfo !== void 0) {
           return this.priceInfo;
         }
@@ -1972,9 +2493,12 @@ var init_coin = __esm({
         if (!coinType) {
           throw new Error("no valid coin type");
         }
-        const priceInfo = await new Prices(this.config).getCoinPriceInfo({
-          coin: coinType
-        });
+        const priceInfo = await new Prices(this.config).getCoinPriceInfo(
+          {
+            coin: coinType
+          },
+          abortSignal
+        );
         this.setPriceInfo(priceInfo);
         return priceInfo;
       }
@@ -2362,10 +2886,11 @@ var init_farmsApiCasting = __esm({
       const fields = Helpers.getObjectFields(
         data
       );
+      const cap = GrpcCasting.unwrapStructField(fields.cap);
       return {
         objectType,
         objectId: Helpers.getObjectId(data),
-        stakingPoolId: fields.cap.fields.for
+        stakingPoolId: cap.for
       };
     };
     // =========================================================================
@@ -2774,8 +3299,9 @@ var init_poolsApiCasting = __esm({
         suiObject
       );
       const lpCoinType = Helpers.addLeadingZeroesToType(
-        Coin.getInnerCoinType(poolFieldsOnChain.lp_supply.type)
+        Coin.getInnerCoinType(objectType)
       );
+      const coinDecimals = poolFieldsOnChain.coin_decimals === void 0 ? void 0 : GrpcCasting.bytesFieldToNumbers(poolFieldsOnChain.coin_decimals);
       const coins = poolFieldsOnChain.type_names.reduce(
         (acc, cur, index) => ({
           ...acc,
@@ -2790,9 +3316,7 @@ var init_poolsApiCasting = __esm({
               poolFieldsOnChain.normalized_balances[index]
             ),
             decimalsScalar: BigInt(poolFieldsOnChain.decimal_scalars[index]),
-            ...poolFieldsOnChain.coin_decimals ? {
-              decimals: Number(poolFieldsOnChain.coin_decimals[index])
-            } : {}
+            ...coinDecimals ? { decimals: coinDecimals[index] } : {}
           }
         }),
         {}
@@ -2803,7 +3327,9 @@ var init_poolsApiCasting = __esm({
         lpCoinType,
         name: poolFieldsOnChain.name,
         creator: poolFieldsOnChain.creator,
-        lpCoinSupply: BigInt(poolFieldsOnChain.lp_supply.fields.value),
+        lpCoinSupply: BigInt(
+          GrpcCasting.unwrapStructField(poolFieldsOnChain.lp_supply).value
+        ),
         illiquidLpCoinSupply: BigInt(poolFieldsOnChain.illiquid_lp_supply),
         flatness: BigInt(poolFieldsOnChain.flatness),
         lpCoinDecimals: Number(poolFieldsOnChain.lp_decimals),
@@ -2895,6 +3421,34 @@ var init_nftAmmApiCasting = __esm({
     // =========================================================================
     //  Objects
     // =========================================================================
+    /**
+     * @remarks ⚠️ **Two of this caster's reads need a *nested* Move struct's own
+     * `type`, which neither protocol supplies — so it throws, exactly as it did
+     * before the gRPC port.** It is kept source-compatible (same signature, same
+     * `NftAmmMarketObject` shape) rather than deleted, and the blocked reads are
+     * marked inline.
+     *
+     * - `fields.pool` is a nested `Pool<L>` handed to
+     *   {@link PoolsApiCasting.poolObjectFromSuiObject}, which needs the pool's
+     *   Move type for `objectType` and `lpCoinType`.
+     * - `fields.supply` is a nested `Supply<F>` whose `type` gave
+     *   `fractionalizedCoinType`.
+     *
+     * Under JSON-RPC a nested struct arrived as `{ type, fields }`, which is not
+     * a `SuiObjectResponse`, so the pre-port code already threw
+     * `no object id found on undefined` at its first nested read (verified
+     * against the source at `d4706127`). Under gRPC nested structs lose `type`
+     * outright, so the `lp_supply` recovery that fixed the *top-level* pool
+     * caster does not apply: the market's own type parameters do not name the
+     * pool's package. Recovering it needs the Move type layouts this SDK does not
+     * carry, and guessing a generic's position would produce a silently wrong
+     * `lpCoinType`, so the failure is left to surface.
+     *
+     * NftAmm is also **not deployed on mainnet** — `getAddresses()` returns empty
+     * strings for every `nftAmm` package and object — which is why there is no
+     * captured fixture for it. Fix the nested reads by fetching the pool as a
+     * top-level object by id.
+     */
     NftAmmApiCasting.marketObjectFromSuiObject = (suiObject) => {
       const objectId = Helpers.getObjectId(suiObject);
       const marketType = Helpers.getObjectType(suiObject);
@@ -2904,8 +3458,16 @@ var init_nftAmmApiCasting = __esm({
       const fields = Helpers.getObjectFields(
         suiObject
       );
-      const pool = PoolsApiCasting.poolObjectFromSuiObject(fields.pool);
-      const fractionalizedCoinType = Coin.getInnerCoinType(fields.supply.type);
+      const nfts = GrpcCasting.unwrapStructField(fields.nfts);
+      const supply = GrpcCasting.unwrapStructField(fields.supply);
+      const pool = PoolsApiCasting.poolObjectFromSuiObject({
+        ...GrpcCasting.unwrapStructField(fields.pool),
+        objectId: void 0,
+        type: void 0
+      });
+      const fractionalizedCoinType = Coin.getInnerCoinType(
+        fields.supply.type
+      );
       const innerMarketTypes = Coin.getInnerCoinType(marketType);
       const genericTypes = innerMarketTypes.replaceAll(" ", "").split(",");
       const assetCoinType = genericTypes[2];
@@ -2915,10 +3477,10 @@ var init_nftAmmApiCasting = __esm({
         pool,
         objectType: marketType,
         nftsTable: {
-          objectId: fields.nfts.fields.id.id,
-          size: BigInt(fields.nfts.fields.size)
+          objectId: GrpcCasting.unwrapUid(nfts.id),
+          size: BigInt(nfts.size)
         },
-        fractionalizedSupply: BigInt(fields.supply.fields.value),
+        fractionalizedSupply: BigInt(supply.value),
         fractionalizedCoinAmount: BigInt(fields.fractions_amount),
         fractionalizedCoinType,
         assetCoinType,
@@ -2930,27 +3492,31 @@ var init_nftAmmApiCasting = __esm({
 });
 
 // src/packages/perpetuals/perpetualsTypes.ts
-var PerpetualsOrderSide, PerpetualsOrderType, PerpetualsStopOrderType, isUpdatedMarketVersion, isWithdrewCollateralEvent, isDepositedCollateralEvent, isDeallocatedCollateralEvent, isAllocatedCollateralEvent, isSettledFundingEvent, isLiquidatedEvent, isCanceledOrderEvent, isPostedOrderEvent, isFilledMakerOrdersEvent, isFilledTakerOrderEvent, isReducedOrderEvent, isUpdatedPremiumTwapEvent, isUpdatedSpreadTwapEvent, isUpdatedFundingEvent;
+var PerpetualsOrderSide, PerpetualsOrderType, PerpetualsStopOrderType, PerpetualsStopOrderTriggerPriceType, isUpdatedMarketVersion, isWithdrewCollateralEvent, isDepositedCollateralEvent, isDeallocatedCollateralEvent, isAllocatedCollateralEvent, isSettledFundingEvent, isLiquidatedEvent, isCanceledOrderEvent, isPostedOrderEvent, isFilledMakerOrdersEvent, isFilledTakerOrderEvent, isReducedOrderEvent, isUpdatedPremiumTwapEvent, isUpdatedSpreadTwapEvent, isUpdatedFundingEvent;
 var init_perpetualsTypes = __esm({
   "src/packages/perpetuals/perpetualsTypes.ts"() {
     "use strict";
-    PerpetualsOrderSide = /* @__PURE__ */ ((PerpetualsOrderSide2) => {
-      PerpetualsOrderSide2[PerpetualsOrderSide2["Ask"] = 1] = "Ask";
-      PerpetualsOrderSide2[PerpetualsOrderSide2["Bid"] = 0] = "Bid";
-      return PerpetualsOrderSide2;
-    })(PerpetualsOrderSide || {});
-    PerpetualsOrderType = /* @__PURE__ */ ((PerpetualsOrderType2) => {
-      PerpetualsOrderType2[PerpetualsOrderType2["Standard"] = 0] = "Standard";
-      PerpetualsOrderType2[PerpetualsOrderType2["FillOrKill"] = 1] = "FillOrKill";
-      PerpetualsOrderType2[PerpetualsOrderType2["PostOnly"] = 2] = "PostOnly";
-      PerpetualsOrderType2[PerpetualsOrderType2["ImmediateOrCancel"] = 3] = "ImmediateOrCancel";
-      return PerpetualsOrderType2;
-    })(PerpetualsOrderType || {});
-    PerpetualsStopOrderType = /* @__PURE__ */ ((PerpetualsStopOrderType2) => {
-      PerpetualsStopOrderType2[PerpetualsStopOrderType2["SlTp"] = 0] = "SlTp";
-      PerpetualsStopOrderType2[PerpetualsStopOrderType2["Standalone"] = 1] = "Standalone";
-      return PerpetualsStopOrderType2;
-    })(PerpetualsStopOrderType || {});
+    PerpetualsOrderSide = {
+      Ask: 1,
+      // true
+      Bid: 0
+      // false
+    };
+    PerpetualsOrderType = {
+      Standard: 0,
+      FillOrKill: 1,
+      PostOnly: 2,
+      ImmediateOrCancel: 3
+    };
+    PerpetualsStopOrderType = {
+      SlTp: 0,
+      Standalone: 1
+    };
+    PerpetualsStopOrderTriggerPriceType = {
+      IndexPrice: 0,
+      BookMidPrice: 1,
+      MarkPrice: 2
+    };
     isUpdatedMarketVersion = (event) => {
       return event.type.toLowerCase().endsWith("::updatedclearinghouseversion");
     };
@@ -3146,13 +3712,10 @@ var init_perpetualsApiCasting = __esm({
         liquidationFeesUsd: Casting.IFixed.numberFromIFixed(
           BigInt(fields.liquidation_fees)
         ),
-        forceCancelFeesUsd: Casting.IFixed.numberFromIFixed(
-          BigInt(fields.force_cancel_fees)
-        ),
         insuranceFundFeesUsd: Casting.IFixed.numberFromIFixed(
           BigInt(fields.insurance_fund_fees)
         ),
-        side: fields.is_liqee_long ? 0 /* Bid */ : 1 /* Ask */,
+        side: fields.is_liqee_long ? PerpetualsOrderSide.Bid : PerpetualsOrderSide.Ask,
         timestamp: Number(eventOnChain.timestampMs),
         txnDigest: eventOnChain.id.txDigest,
         type: eventOnChain.type
@@ -3634,19 +4197,21 @@ var init_stakingApiCasting = __esm({
       const fields = Helpers.getObjectFields(
         data
       );
+      const protocolConfig = GrpcCasting.unwrapStructField(
+        fields.protocol_config
+      );
+      const atomicUnstakeProtocolFee = GrpcCasting.unwrapStructField(
+        protocolConfig.atomic_unstake_protocol_fee
+      );
       return {
         objectId,
         objectType,
         atomicUnstakeSuiReservesTargetValue: BigInt(
-          fields.protocol_config.fields.atomic_unstake_sui_reserves_target_value
+          protocolConfig.atomic_unstake_sui_reserves_target_value
         ),
         atomicUnstakeSuiReserves: BigInt(fields.atomic_unstake_sui_reserves),
-        minAtomicUnstakeFee: BigInt(
-          fields.protocol_config.fields.atomic_unstake_protocol_fee.fields.min_fee
-        ),
-        maxAtomicUnstakeFee: BigInt(
-          fields.protocol_config.fields.atomic_unstake_protocol_fee.fields.max_fee
-        ),
+        minAtomicUnstakeFee: BigInt(atomicUnstakeProtocolFee.min_fee),
+        maxAtomicUnstakeFee: BigInt(atomicUnstakeProtocolFee.max_fee),
         totalSuiAmount: BigInt(fields.total_sui_amount),
         totalRewardsAmount: BigInt(fields.total_rewards_amount),
         activeEpoch: BigInt(fields.active_epoch)
@@ -3822,11 +4387,14 @@ var init_suiFrensApiCasting = __esm({
       const fields = Helpers.getObjectFields(
         data
       );
+      const suiFrensMetadata = GrpcCasting.unwrapStructField(
+        fields.suifrens_metadata
+      );
       return {
         objectType,
         objectId: Helpers.getObjectId(data),
         totalMixes: BigInt(fields.mixed),
-        stakedSuiFrens: BigInt(fields.suifrens_metadata.fields.size)
+        stakedSuiFrens: BigInt(suiFrensMetadata.size)
       };
     };
     _SuiFrensApiCasting.accessoryObjectFromSuiObjectResponse = (data) => {
@@ -3901,6 +4469,7 @@ var _NftsApiCasting, NftsApiCasting;
 var init_nftsApiCasting = __esm({
   "src/general/nfts/nftsApiCasting.ts"() {
     "use strict";
+    init_grpcCasting();
     init_helpers();
     _NftsApiCasting = class _NftsApiCasting {
     };
@@ -3911,7 +4480,7 @@ var init_nftsApiCasting = __esm({
     //  Objects
     // =========================================================================
     _NftsApiCasting.nftsFromSuiObjects = (objects) => {
-      const nfts = objects.filter((object) => object.data?.display);
+      const nfts = objects.filter((object) => object.display);
       return nfts.map((nft) => _NftsApiCasting.nftFromSuiObject(nft)).filter(
         (nft) => Object.keys(nft.display.suggested).length > 0 || Object.keys(nft.display.other).length > 0
       );
@@ -3939,10 +4508,11 @@ var init_nftsApiCasting = __esm({
       const fields = Helpers.getObjectFields(object);
       const objectId = Helpers.getObjectId(object);
       const objectType = Helpers.getObjectType(object);
+      const cap = GrpcCasting.unwrapStructField(fields.cap);
       return {
         objectId,
         objectType,
-        kioskObjectId: Helpers.addLeadingZeroesToType(fields.cap.fields.for)
+        kioskObjectId: Helpers.addLeadingZeroesToType(cap.for)
       };
     };
     // =========================================================================
@@ -4397,7 +4967,9 @@ var init_utils = __esm({
   "src/general/utils/index.ts"() {
     "use strict";
     init_casting();
+    init_grpcCasting();
     init_helpers();
+    init_transportError();
   }
 });
 
@@ -4896,10 +5468,13 @@ var init_farmsStakingPool = __esm({
        * console.log(poolTvl);
        * ```
        */
-      async getTVL() {
-        return new Farms(this.config, this.api).getTVL({
-          farmIds: [this.stakingPool.objectId]
-        });
+      async getTVL(abortSignal) {
+        return new Farms(this.config, this.api).getTVL(
+          {
+            farmIds: [this.stakingPool.objectId]
+          },
+          abortSignal
+        );
       }
       /**
        * Fetches the total value locked (TVL) of the reward coins in this specific staking pool.
@@ -4912,10 +5487,13 @@ var init_farmsStakingPool = __esm({
        * console.log(rewardTvl);
        * ```
        */
-      async getRewardsTVL() {
-        return new Farms(this.config, this.api).getRewardsTVL({
-          farmIds: [this.stakingPool.objectId]
-        });
+      async getRewardsTVL(abortSignal) {
+        return new Farms(this.config, this.api).getRewardsTVL(
+          {
+            farmIds: [this.stakingPool.objectId]
+          },
+          abortSignal
+        );
       }
       // =========================================================================
       //  Transactions
@@ -4988,6 +5566,38 @@ var init_farmsStakingPool = __esm({
         };
         return this.version() === 1 ? this.farmsApi().buildSetStakingPoolMinStakeAmountTxV1(args) : this.farmsApi().buildSetStakingPoolMinStakeAmountTxV2(args);
       }
+      /**
+       * Builds a transaction to set the pool's minimum lock duration (ms).
+       * Owner-cap only. V2 pools only — V1 vaults do not expose this entry.
+       */
+      getSetMinLockDurationMsTransaction(inputs) {
+        if (this.version() === 1) {
+          throw new Error(
+            "set_min_lock_duration_ms is not supported on V1 staking pools"
+          );
+        }
+        return this.farmsApi().buildSetStakingPoolMinLockDurationMsTxV2({
+          ...inputs,
+          stakeCoinType: this.stakingPool.stakeCoinType,
+          stakingPoolId: this.stakingPool.objectId
+        });
+      }
+      /**
+       * Builds a transaction to set the pool's maximum lock duration (ms).
+       * Owner-cap only. V2 pools only.
+       */
+      getSetMaxLockDurationMsTransaction(inputs) {
+        if (this.version() === 1) {
+          throw new Error(
+            "set_max_lock_duration_ms is not supported on V1 staking pools"
+          );
+        }
+        return this.farmsApi().buildSetStakingPoolMaxLockDurationMsTxV2({
+          ...inputs,
+          stakeCoinType: this.stakingPool.stakeCoinType,
+          stakingPoolId: this.stakingPool.objectId
+        });
+      }
       /**
        * Builds a transaction granting a one-time admin cap to another address, allowing them to perform specific
        * one-time administrative actions (like initializing a reward).
@@ -5603,9 +6213,11 @@ var init_farms = __esm({
        * console.log(pool.stakingPool);
        * ```
        */
-      async getStakingPool(inputs) {
+      async getStakingPool(inputs, abortSignal) {
         const stakingPool = await this.fetchApi(
-          inputs.objectId
+          inputs.objectId,
+          void 0,
+          abortSignal
         );
         return new FarmsStakingPool(stakingPool, this.config, this.api);
       }
@@ -5623,10 +6235,14 @@ var init_farms = __esm({
        * console.log(pools[0].stakingPool, pools[1].stakingPool);
        * ```
        */
-      async getStakingPools(inputs) {
-        const stakingPools = await this.fetchApi("", {
-          farmIds: inputs.objectIds
-        });
+      async getStakingPools(inputs, abortSignal) {
+        const stakingPools = await this.fetchApi(
+          "",
+          {
+            farmIds: inputs.objectIds
+          },
+          abortSignal
+        );
         return stakingPools.map(
           (stakingPool) => new FarmsStakingPool(stakingPool, this.config, this.api)
         );
@@ -5642,8 +6258,12 @@ var init_farms = __esm({
        * console.log(allPools.map(pool => pool.stakingPool));
        * ```
        */
-      async getAllStakingPools() {
-        const stakingPools = await this.fetchApi("", {});
+      async getAllStakingPools(abortSignal) {
+        const stakingPools = await this.fetchApi(
+          "",
+          {},
+          abortSignal
+        );
         return stakingPools.map(
           (pool) => new FarmsStakingPool(pool, this.config, this.api)
         );
@@ -5722,8 +6342,8 @@ var init_farms = __esm({
        * console.log("Specific farm's TVL:", tvlForSpecificFarm);
        * ```
        */
-      async getTVL(inputs) {
-        return this.fetchApi("tvl", inputs ?? {});
+      async getTVL(inputs, abortSignal) {
+        return this.fetchApi("tvl", inputs ?? {}, abortSignal);
       }
       /**
        * Retrieves the total value locked (TVL) of reward coins across specified farm IDs or all farms if none are specified.
@@ -5740,8 +6360,19 @@ var init_farms = __esm({
        * console.log("Single farm's rewards TVL:", singleFarmRewardsTvl);
        * ```
        */
-      async getRewardsTVL(inputs) {
-        return this.fetchApi("rewards-tvl", inputs ?? {});
+      async getRewardsTVL(inputs, abortSignal) {
+        return this.fetchApi("rewards-tvl", inputs ?? {}, abortSignal);
+      }
+      /**
+       * Fetches TVL and reward TVL for multiple farms in a single batch response.
+       * When `farmIds` is omitted, the API returns summaries for all farms.
+       *
+       * @param inputs - Optionally provide the farm IDs to include.
+       * @param abortSignal - An optional signal for cancelling the request.
+       * @returns TVL and reward TVL metrics for each requested farm.
+       */
+      async getFarmSummaries(inputs, abortSignal) {
+        return this.fetchApi("summary", inputs ?? {}, abortSignal);
       }
       // =========================================================================
       //  Transactions
@@ -5861,29 +6492,19 @@ var init_faucet = __esm({
       // =========================================================================
       //  Inspections
       // =========================================================================
-      async getSupportedCoins() {
+      getSupportedCoins() {
         return this.fetchApi("supported-coins");
       }
       // =========================================================================
-      //  Events
-      // =========================================================================
-      // TODO: add mint coin event getter ?
-      // =========================================================================
       //  Transactions
       // =========================================================================
-      async getRequestCoinTransaction(inputs) {
+      getRequestCoinTransaction(inputs) {
         return this.faucetApi().buildRequestCoinTx(inputs);
       }
-      async getMintSuiFrenTransaction(inputs) {
+      getMintSuiFrenTransaction(inputs) {
         return this.faucetApi().fetchBuildMintSuiFrenTx(inputs);
       }
     };
-    // =========================================================================
-    //  Constants
-    // =========================================================================
-    Faucet.constants = {
-      defaultRequestAmountUsd: 10
-    };
   }
 });
 
@@ -6004,24 +6625,25 @@ var init_gasPools = __esm({
         );
       }
       /**
-       * Builds a transaction to sponsor (rebate) the transaction sender
-       * using SUI from the gas pool.
+       * Requests a gas-pool-sponsored transaction. Returns a complete transaction
+       * with the gas payment and epoch bound attached, the sponsor's signature, and
+       * the digest both signatures commit to — the caller signs `transaction` as the
+       * sender and submits it together with `sponsorSignature`.
        *
-       * @param inputs.walletAddress - Wallet address submitting the sponsor transaction.
-       * @param inputs.amount - Amount of SUI to rebate in MIST.
-       * @param inputs.tx - Optional transaction to extend.
-       * @returns {@link SdkTransactionResponse} with `tx`.
+       * @param inputs.walletAddress - Wallet address requesting the sponsorship.
+       * @param inputs.bytes - Base64 of the signed `SPONSOR_GAS` auth message.
+       * @param inputs.signature - Signature over `bytes`.
+       * @param inputs.tx - Optional transaction to sponsor (appended as a tx kind).
+       * @returns {@link ApiGasPoolSponsorResponse}.
        */
-      async getSponsorTx(inputs) {
+      async getSponsoredTransaction(inputs) {
         const { tx, ...otherInputs } = inputs;
-        return this.fetchApiTxObject(
+        return this.fetchApi(
           "transactions/sponsor",
           {
             ...otherInputs,
-            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx })
-          },
-          void 0,
-          { txKind: true }
+            txKind: tx ? await this.api?.Transactions().fetchBase64TxKindFromTx({ tx }) : void 0
+          }
         );
       }
       /**
@@ -8150,10 +8772,13 @@ var init_pools = __esm({
          * console.log(poolId);
          * ```
          */
-        this.getPoolObjectIdForLpCoinType = (inputs) => {
-          return this.getPoolObjectIdsForLpCoinTypes({
-            lpCoinTypes: [inputs.lpCoinType]
-          });
+        this.getPoolObjectIdForLpCoinType = (inputs, abortSignal) => {
+          return this.getPoolObjectIdsForLpCoinTypes(
+            {
+              lpCoinTypes: [inputs.lpCoinType]
+            },
+            abortSignal
+          );
         };
         /**
          * Checks if a given coin type is recognized as an LP coin.
@@ -8162,8 +8787,8 @@ var init_pools = __esm({
          * @param inputs - Contains the `lpCoinType` to check.
          * @returns `true` if the coin is an LP token, `false` otherwise.
          */
-        this.isLpCoinType = async (inputs) => {
-          const result = await this.getPoolObjectIdForLpCoinType(inputs);
+        this.isLpCoinType = async (inputs, abortSignal) => {
+          const result = await this.getPoolObjectIdForLpCoinType(inputs, abortSignal);
           return result.some((id) => id !== void 0);
         };
         /**
@@ -8213,8 +8838,12 @@ var init_pools = __esm({
        * console.log(pool.pool.lpCoinType, pool.pool.name);
        * ```
        */
-      async getPool(inputs) {
-        const pool = await this.fetchApi(inputs.objectId);
+      async getPool(inputs, abortSignal) {
+        const pool = await this.fetchApi(
+          inputs.objectId,
+          void 0,
+          abortSignal
+        );
         return new Pool(pool, this.config, this.api);
       }
       /**
@@ -8229,10 +8858,14 @@ var init_pools = __esm({
        * console.log(poolArray.length);
        * ```
        */
-      async getPools(inputs) {
-        const pools = await this.fetchApi("", {
-          poolIds: inputs.objectIds
-        });
+      async getPools(inputs, abortSignal) {
+        const pools = await this.fetchApi(
+          "",
+          {
+            poolIds: inputs.objectIds
+          },
+          abortSignal
+        );
         return pools.map((pool) => new Pool(pool, this.config, this.api));
       }
       /**
@@ -8246,8 +8879,8 @@ var init_pools = __esm({
        * console.log(allPools.map(p => p.pool.name));
        * ```
        */
-      async getAllPools() {
-        const pools = await this.fetchApi("", {});
+      async getAllPools(abortSignal) {
+        const pools = await this.fetchApi("", {}, abortSignal);
         return pools.map((pool) => new Pool(pool, this.config, this.api));
       }
       /**
@@ -8337,8 +8970,8 @@ var init_pools = __esm({
        * console.log(poolIds);
        * ```
        */
-      async getPoolObjectIdsForLpCoinTypes(inputs) {
-        return this.fetchApi("pool-object-ids", inputs);
+      async getPoolObjectIdsForLpCoinTypes(inputs, abortSignal) {
+        return this.fetchApi("pool-object-ids", inputs, abortSignal);
       }
       /**
        * Retrieves the total value locked (TVL) across all or specific pool IDs.
@@ -8368,8 +9001,19 @@ var init_pools = __esm({
        * console.log(stats[0].volume, stats[1].tvl);
        * ```
        */
-      async getPoolsStats(inputs) {
-        return this.fetchApi("stats", inputs);
+      async getPoolsStats(inputs, abortSignal) {
+        return this.fetchApi("stats", inputs, abortSignal);
+      }
+      /**
+       * Fetches pool objects and their statistics in a single batch response.
+       * When `poolIds` is omitted, the API returns summaries for all pools.
+       *
+       * @param inputs - Optionally provide the pool IDs to include.
+       * @param abortSignal - An optional signal for cancelling the request.
+       * @returns Pool objects paired with their current statistics.
+       */
+      async getPoolSummaries(inputs, abortSignal) {
+        return this.fetchApi("summary", inputs ?? {}, abortSignal);
       }
       /**
        * Returns all DAO fee pool owner capabilities owned by a particular user.
@@ -8987,7 +9631,7 @@ var init_types2 = __esm({
 
 // src/packages/perpetuals/perpetualsAccount.ts
 import {
-  Transaction as Transaction3
+  Transaction as Transaction4
 } from "@mysten/sui/transactions";
 var PerpetualsAccount;
 var init_perpetualsAccount = __esm({
@@ -9068,7 +9712,7 @@ var init_perpetualsAccount = __esm({
             accountId: this.accountCap.accountId,
             accountCapId: this.accountCap.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction3()
+              tx: tx ?? new Transaction4()
             })
           },
           void 0,
@@ -9116,7 +9760,7 @@ var init_perpetualsAccount = __esm({
             walletAddress: this.ownerAddress(),
             accountId: this.accountCap.accountId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: txFromInputs ?? new Transaction3()
+              tx: txFromInputs ?? new Transaction4()
             })
           },
           void 0,
@@ -9152,7 +9796,7 @@ var init_perpetualsAccount = __esm({
               vaultId: void 0
             },
             walletAddress: this.ownerAddress(),
-            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx: tx ?? new Transaction3() })
+            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx: tx ?? new Transaction4() })
           },
           void 0,
           {
@@ -9187,7 +9831,7 @@ var init_perpetualsAccount = __esm({
               vaultId: void 0
             },
             walletAddress: this.ownerAddress(),
-            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx: tx ?? new Transaction3() })
+            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx: tx ?? new Transaction4() })
           },
           void 0,
           {
@@ -9220,7 +9864,7 @@ var init_perpetualsAccount = __esm({
             walletAddress: this.ownerAddress(),
             fromAccountId: this.accountCap.accountId,
             fromAccountCapId: this.accountCap.objectId,
-            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx: tx ?? new Transaction3() })
+            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx: tx ?? new Transaction4() })
           },
           void 0,
           {
@@ -9268,7 +9912,7 @@ var init_perpetualsAccount = __esm({
        */
       async getPlaceMarketOrderTx(inputs) {
         const { tx: txFromInputs, ...otherInputs } = inputs;
-        const tx = txFromInputs ?? new Transaction3();
+        const tx = txFromInputs ?? new Transaction4();
         return this.fetchApiTxObject(
           `${this.vaultId ? "vault" : "account"}/transactions/place-market-order`,
           {
@@ -9310,7 +9954,7 @@ var init_perpetualsAccount = __esm({
        */
       async getPlaceLimitOrderTx(inputs) {
         const { tx: txFromInputs, ...otherInputs } = inputs;
-        const tx = txFromInputs ?? new Transaction3();
+        const tx = txFromInputs ?? new Transaction4();
         return this.fetchApiTxObject(
           `${this.vaultId ? "vault" : "account"}/transactions/place-limit-order`,
           {
@@ -9347,7 +9991,7 @@ var init_perpetualsAccount = __esm({
        */
       async getPlaceScaleOrderTx(inputs) {
         const { tx: txFromInputs, ...otherInputs } = inputs;
-        const tx = txFromInputs ?? new Transaction3();
+        const tx = txFromInputs ?? new Transaction4();
         return this.fetchApiTxObject(
           `${this.vaultId ? "vault" : "account"}/transactions/place-scale-order`,
           {
@@ -9382,7 +10026,7 @@ var init_perpetualsAccount = __esm({
        */
       async getCancelAndPlaceOrdersTx(inputs) {
         const { tx: txFromInputs, ...otherInputs } = inputs;
-        const tx = txFromInputs ?? new Transaction3();
+        const tx = txFromInputs ?? new Transaction4();
         return this.fetchApiTxObject(
           `${this.vaultId ? "vault" : "account"}/transactions/cancel-and-place-orders`,
           {
@@ -9497,7 +10141,7 @@ var init_perpetualsAccount = __esm({
        */
       async getPlaceStopOrdersTx(inputs) {
         const { tx: txFromInputs, ...otherInputs } = inputs;
-        const tx = txFromInputs ?? new Transaction3();
+        const tx = txFromInputs ?? new Transaction4();
         return this.fetchApiTxObject(
           `${this.vaultId ? "vault" : "account"}/transactions/place-stop-orders`,
           {
@@ -9541,7 +10185,7 @@ var init_perpetualsAccount = __esm({
         if (!position) {
           throw new Error("you have no position for this market");
         }
-        const tx = txFromInputs ?? new Transaction3();
+        const tx = txFromInputs ?? new Transaction4();
         return this.fetchApiTxObject(
           `${this.vaultId ? "vault" : "account"}/transactions/place-sl-tp-orders`,
           {
@@ -9577,16 +10221,110 @@ var init_perpetualsAccount = __esm({
        * - This is typically used to adjust trigger prices, sizes, expiries, or the
        *   embedded limit-order parameters.
        *
-       * @param inputs.stopOrders - Full updated stop-order payloads to apply.
+       * @param inputs.stopOrders - Full updated stop-order payloads to apply.
+       * @param inputs.tx - Optional transaction to extend.
+       *
+       * @returns Transaction response containing `tx`.
+       */
+      async getEditStopOrdersTx(inputs) {
+        const { tx: txFromInputs, ...otherInputs } = inputs;
+        const tx = txFromInputs ?? new Transaction4();
+        return this.fetchApiTxObject(
+          `${this.vaultId ? "vault" : "account"}/transactions/edit-stop-orders`,
+          {
+            ...otherInputs,
+            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx }),
+            walletAddress: this.ownerAddress(),
+            ..."vaultId" in this.accountCap ? {
+              vaultId: this.accountCap.vaultId,
+              accountId: void 0
+            } : {
+              accountId: this.accountCap.accountId,
+              accountCapId: this.accountCap.objectId,
+              vaultId: void 0
+            }
+          },
+          void 0,
+          {
+            txKind: true
+          }
+        );
+      }
+      /**
+       * Build a `create-twap-orders` transaction for this account.
+       *
+       * @param inputs - See {@link SdkPerpetualsCreateTwapOrdersInputs}.
+       *
+       * @returns Transaction response containing `tx`.
+       */
+      async getCreateTwapOrdersTx(inputs) {
+        const { tx, ...otherInputs } = inputs;
+        return this.fetchApiTxObject(
+          `${this.vaultId ? "vault" : "account"}/transactions/create-twap-orders`,
+          {
+            ...otherInputs,
+            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx }),
+            walletAddress: this.ownerAddress(),
+            ..."vaultId" in this.accountCap ? {
+              vaultId: this.accountCap.vaultId,
+              accountId: void 0
+            } : {
+              accountId: this.accountCap.accountId,
+              accountCapId: this.accountCap.objectId,
+              vaultId: void 0
+            }
+          },
+          void 0,
+          {
+            txKind: true
+          }
+        );
+      }
+      /**
+       * Build an `edit-twap-orders` transaction for this account.
+       * `newTwapOrders` maps each TWAP order object id to the edit to apply.
+       *
+       * @param inputs.newTwapOrders - Map of TWAP order id to the edit to apply.
+       * @param inputs.tx - Optional transaction to extend.
+       *
+       * @returns Transaction response containing `tx`.
+       */
+      async getEditTwapOrdersTx(inputs) {
+        const { tx, ...otherInputs } = inputs;
+        return this.fetchApiTxObject(
+          `${this.vaultId ? "vault" : "account"}/transactions/edit-twap-orders`,
+          {
+            ...otherInputs,
+            txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx }),
+            walletAddress: this.ownerAddress(),
+            ..."vaultId" in this.accountCap ? {
+              vaultId: this.accountCap.vaultId,
+              accountId: void 0
+            } : {
+              accountId: this.accountCap.accountId,
+              accountCapId: this.accountCap.objectId,
+              vaultId: void 0
+            }
+          },
+          void 0,
+          {
+            txKind: true
+          }
+        );
+      }
+      /**
+       * Build a `cancel-twap-orders` transaction for this account.
+       * This cancels TWAP order objects by their object IDs.
+       *
        * @param inputs.tx - Optional transaction to extend.
+       * @param inputs.twapOrderIds - Array of TWAP order object IDs to cancel.
        *
        * @returns Transaction response containing `tx`.
        */
-      async getEditStopOrdersTx(inputs) {
-        const { tx: txFromInputs, ...otherInputs } = inputs;
-        const tx = txFromInputs ?? new Transaction3();
+      async getCancelTwapOrdersTx(inputs) {
+        const { tx, ...otherInputs } = inputs;
         return this.fetchApiTxObject(
-          `${this.vaultId ? "vault" : "account"}/transactions/edit-stop-orders`,
+          `${this.vaultId ? "vault" : "account"}/transactions/cancel-twap-orders`,
           {
             ...otherInputs,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({ tx }),
@@ -9606,6 +10344,29 @@ var init_perpetualsAccount = __esm({
           }
         );
       }
+      /**
+       * Fetch TWAP-order data for this account, using an off-chain signed payload.
+       *
+       * @param inputs.bytes - Serialized message that was signed.
+       * @param inputs.signature - Signature over `bytes`.
+       * @param inputs.marketIds - Optional subset of markets to filter results by.
+       *
+       * @returns {@link ApiPerpetualsTwapOrderDatasResponse} containing `twapOrderDatas`.
+       */
+      async getTwapOrderDatas(inputs) {
+        const { bytes, signature, marketIds } = inputs;
+        return await this.fetchApi(`${this.vaultId ? "vault" : "account"}/twap-order-datas`, {
+          bytes,
+          signature,
+          walletAddress: this.ownerAddress(),
+          marketIds: marketIds ?? [],
+          ..."vaultId" in this.accountCap ? {
+            vaultId: this.accountCap.vaultId
+          } : {
+            accountId: this.accountCap.accountId
+          }
+        });
+      }
       // public async getReduceOrderTx(inputs: {
       // 	tx?: Transaction;
       // 	collateralChange: number;
@@ -10174,7 +10935,7 @@ var init_perpetualsAccount = __esm({
             recipientAddress,
             accountId: this.accountCap.accountId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction3()
+              tx: tx ?? new Transaction4()
             })
           },
           void 0,
@@ -10206,7 +10967,7 @@ var init_perpetualsAccount = __esm({
             accountCapId,
             accountId: this.accountCap.accountId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction3()
+              tx: tx ?? new Transaction4()
             })
           },
           void 0,
@@ -10337,7 +11098,7 @@ var init_perpetualsAccount = __esm({
        * - Market ID matches the input market.
        * - `slTp` field is present.
        * - Order side is opposite of the position side.
-       * - At least a `stopLossIndexPrice` or `takeProfitIndexPrice` is set.
+       * - At least a `stopLossPrice` or `takeProfitPrice` is set.
        *
        * Notes on matching:
        * - The side comparison uses the current position side derived from the account snapshot.
@@ -10361,10 +11122,10 @@ var init_perpetualsAccount = __esm({
         }
         const side = position ? Perpetuals.positionSide(position) : void 0;
         const fullSlTpOrder = stopOrderDatas.find(
-          (order) => order.marketId === marketId && order.slTp && order.side !== side && (order.slTp.stopLossIndexPrice || order.slTp.takeProfitIndexPrice) && order.size >= Casting.i64MaxBigInt && !order.limitOrder
+          (order) => order.marketId === marketId && order.slTp && order.side !== side && (order.slTp.stopLossPrice || order.slTp.takeProfitPrice) && order.size >= Casting.i64MaxBigInt && !order.limitOrder
         );
         const partialSlTpOrders = stopOrderDatas.filter(
-          (order) => order.marketId === marketId && order.slTp && order.side !== side && (order.slTp.stopLossIndexPrice || order.slTp.takeProfitIndexPrice) && order.size < Casting.i64MaxBigInt && !order.limitOrder
+          (order) => order.marketId === marketId && order.slTp && order.side !== side && (order.slTp.stopLossPrice || order.slTp.takeProfitPrice) && order.size < Casting.i64MaxBigInt && !order.limitOrder
         );
         return {
           fullSlTpOrder,
@@ -10374,10 +11135,10 @@ var init_perpetualsAccount = __esm({
       slTpStopOrderDatasForLimitOrder(inputs) {
         const { stopOrderDatas, limitOrderId } = inputs;
         const fullSlTpOrder = stopOrderDatas.find(
-          (order) => order.slTp && order.slTp.limitOrderId === limitOrderId && (order.slTp.stopLossIndexPrice || order.slTp.takeProfitIndexPrice) && order.size >= Casting.i64MaxBigInt
+          (order) => order.slTp && order.slTp.limitOrderId === limitOrderId && (order.slTp.stopLossPrice || order.slTp.takeProfitPrice) && order.size >= Casting.i64MaxBigInt
         );
         const partialSlTpOrders = stopOrderDatas.filter(
-          (order) => order.slTp && order.slTp.limitOrderId === limitOrderId && (order.slTp.stopLossIndexPrice || order.slTp.takeProfitIndexPrice) && order.size < Casting.i64MaxBigInt
+          (order) => order.slTp && order.slTp.limitOrderId === limitOrderId && (order.slTp.stopLossPrice || order.slTp.takeProfitPrice) && order.size < Casting.i64MaxBigInt
         );
         return {
           fullSlTpOrder,
@@ -10562,12 +11323,13 @@ var init_perpetualsMarket = __esm({
        * @param marketData - Snapshot of market configuration and state.
        * @param config - Optional {@link CallerConfig} (network, base URL, etc.).
        * @param api - Optional shared {@link AftermathApi} provider instance.
+       * @param metadata - Optional display metadata for the market.
        *
        * @remarks
        * This class extends {@link Caller} with the `"perpetuals"` route prefix, meaning
        * all HTTP requests resolve under `/perpetuals/...`.
        */
-      constructor(marketData, config, api) {
+      constructor(marketData, config, api, metadata) {
         super(config, "perpetuals");
         this.marketData = marketData;
         this.api = api;
@@ -10765,10 +11527,6 @@ var init_perpetualsMarket = __esm({
             asksQuantity: 0,
             bidsQuantity: 0,
             pendingOrders: [],
-            makerFee: 1,
-            // 100% (placeholder default)
-            takerFee: 1,
-            // 100% (placeholder default)
             leverage: 1,
             entryPrice: 0,
             freeCollateral: 0,
@@ -10785,6 +11543,7 @@ var init_perpetualsMarket = __esm({
         this.collateralCoinType = marketData.collateralCoinType;
         this.marketParams = marketData.marketParams;
         this.marketState = marketData.marketState;
+        this.metadata = metadata ?? null;
       }
       // =========================================================================
       //  Inspections
@@ -10998,7 +11757,7 @@ var init_perpetualsMarket = __esm({
 
 // src/packages/perpetuals/perpetualsVault.ts
 import {
-  Transaction as Transaction4
+  Transaction as Transaction5
 } from "@mysten/sui/transactions";
 var PerpetualsVault;
 var init_perpetualsVault = __esm({
@@ -11051,7 +11810,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11067,7 +11826,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11093,7 +11852,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11119,7 +11878,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11142,7 +11901,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11166,7 +11925,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11195,7 +11954,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11220,7 +11979,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: txFromInputs ?? new Transaction4()
+              tx: txFromInputs ?? new Transaction5()
             })
           },
           void 0,
@@ -11246,7 +12005,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11277,7 +12036,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11308,7 +12067,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11331,7 +12090,7 @@ var init_perpetualsVault = __esm({
             ...otherInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11377,7 +12136,7 @@ var init_perpetualsVault = __esm({
             ...depositInputs,
             vaultId: this.vaultObject.objectId,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction4()
+              tx: tx ?? new Transaction5()
             })
           },
           void 0,
@@ -11692,7 +12451,7 @@ var init_perpetualsOrderUtils = __esm({
     // Return price of given `order_id`, (works for ask or bid)
     _PerpetualsOrderUtils.price = (orderId) => {
       const side = Perpetuals.orderIdToSide(orderId);
-      if (side === 1 /* Ask */) {
+      if (side === PerpetualsOrderSide.Ask) {
         return _PerpetualsOrderUtils.priceAsk(orderId);
       }
       return _PerpetualsOrderUtils.priceBid(orderId);
@@ -11725,7 +12484,7 @@ var init_utils2 = __esm({
 
 // src/packages/perpetuals/perpetuals.ts
 import {
-  Transaction as Transaction5
+  Transaction as Transaction6
 } from "@mysten/sui/transactions";
 var _Perpetuals, Perpetuals;
 var init_perpetuals = __esm({
@@ -11833,7 +12592,12 @@ var init_perpetuals = __esm({
         const res = await this.fetchApi("markets", inputs);
         return {
           markets: res.marketDatas.map(
-            (marketData) => new PerpetualsMarket(marketData.market, this.config, this.api)
+            (marketData) => new PerpetualsMarket(
+              marketData.market,
+              this.config,
+              this.api,
+              marketData.metadata
+            )
           )
         };
       }
@@ -12095,12 +12859,12 @@ var init_perpetuals = __esm({
        */
       // TODO: move to market class ?
       getMarketCandleHistory(inputs) {
-        const { marketId, fromTimestamp, toTimestamp, intervalMs } = inputs;
+        const { marketId, fromTimestamp, toTimestamp, resolution } = inputs;
         return this.fetchApi("market/candle-history", {
           marketId,
           fromTimestamp,
           toTimestamp,
-          intervalMs
+          resolution
         });
       }
       /**
@@ -12194,7 +12958,7 @@ var init_perpetuals = __esm({
           {
             ...otherInputs,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction5()
+              tx: tx ?? new Transaction6()
             })
           },
           void 0,
@@ -12253,7 +13017,7 @@ var init_perpetuals = __esm({
           {
             ...otherInputs,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction5()
+              tx: tx ?? new Transaction6()
             })
           },
           void 0,
@@ -12288,7 +13052,7 @@ var init_perpetuals = __esm({
           {
             ...otherInputs,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction5()
+              tx: tx ?? new Transaction6()
             })
           },
           void 0,
@@ -12418,8 +13182,8 @@ var init_perpetuals = __esm({
        *
        * This endpoint creates a transaction that allows a user to grant permission to an
        * integrator to receive fees on orders placed on their behalf. The user specifies
-       * a maximum taker fee that the integrator can charge. The integrator can then
-       * include their address and fee (up to the maximum) when placing orders for the user.
+       * a maximum integrator fee that the integrator can charge. The integrator can then
+       * include their id and fee (up to the maximum) when placing orders for the user.
        *
        * The resulting transaction must be signed by the account owner and executed on-chain.
        *
@@ -12430,8 +13194,8 @@ var init_perpetuals = __esm({
        * ```ts
        * const tx = await perps.getCreateBuilderCodeIntegratorConfigTx({
        *   accountId: 123n,
-       *   integratorAddress: "0x...",
-       *   maxTakerFee: 0.001, // 0.1% max fee
+       *   integratorId: 7,
+       *   maxIntegratorFee: 0.001, // 0.1% max fee
        * });
        * ```
        */
@@ -12467,7 +13231,7 @@ var init_perpetuals = __esm({
        * ```ts
        * const tx = await perps.getRemoveBuilderCodeIntegratorConfigTx({
        *   accountId: 123n,
-       *   integratorAddress: "0x...",
+       *   integratorId: 7,
        * });
        * ```
        */
@@ -12486,13 +13250,12 @@ var init_perpetuals = __esm({
         );
       }
       /**
-       * Build a transaction to initialize an integrator fee vault for a specific market.
+       * Build a transaction to initialize an integrator's global fee vault.
        *
-       * This endpoint creates a transaction that initializes a vault where an integrator's
-       * fees will accumulate for a specific market (clearing house). This is a one-time
-       * setup operation that must be performed before the integrator can claim fees from
-       * that market. Once created, the vault will automatically collect fees as the
-       * integrator submits orders on behalf of users in that market.
+       * This endpoint creates a transaction that initializes the global vault where an
+       * integrator's fees accumulate across all markets. This is a one-time setup that
+       * must be performed before the integrator can claim fees. The integrator's identity
+       * is taken from the transaction sender on-chain.
        *
        * The resulting transaction must be signed by the integrator and executed on-chain.
        *
@@ -12501,10 +13264,7 @@ var init_perpetuals = __esm({
        *
        * @example
        * ```ts
-       * const tx = await perps.getCreateBuilderCodeIntegratorVaultTx({
-       *   marketId: "0x...",
-       *   integratorAddress: "0x...",
-       * });
+       * const tx = await perps.getCreateBuilderCodeIntegratorVaultTx({});
        * ```
        */
       async getCreateBuilderCodeIntegratorVaultTx(inputs) {
@@ -12525,36 +13285,34 @@ var init_perpetuals = __esm({
        * Build a transaction to claim accumulated integrator fees from a vault.
        *
        * This endpoint creates a transaction that allows an integrator to claim the fees
-       * they have earned from orders placed on behalf of users. Fees accumulate in a vault
-       * specific to each market (clearing house) and can be claimed at any moment by the
-       * integrator. The fees are proportional to the taker volume generated by the users'
-       * orders that the integrator submitted.
+       * they have earned from orders placed on behalf of users. Fees accumulate in the
+       * integrator's global vault (across all markets) and can be claimed at any moment.
+       * The fees are proportional to the taker volume generated by the users' orders that
+       * the integrator submitted.
        *
        * If a `recipientAddress` is provided, the claimed fees will be automatically
-       * transferred to that address. Otherwise, the coin output is exposed as a transaction
-       * argument for further use in the transaction.
+       * transferred to that address. Otherwise, the coin outputs are exposed as transaction
+       * arguments for further use in the transaction (one per non-zero collateral balance).
        *
        * The resulting transaction must be signed by the integrator and executed on-chain.
        *
        * @param inputs - {@link ApiPerpetualsBuilderCodesClaimIntegratorVaultFeesTxBody}.
        * @returns {@link ApiPerpetualsBuilderCodesClaimIntegratorVaultFeesTxResponse} containing
-       *   `txKind` and optionally `coinOutArg`.
+       *   `txKind` and optionally `coinOutArgs`.
        *
        * @example
        * ```ts
        * // Claim with automatic transfer to recipient
        * const response = await perps.getClaimBuilderCodeIntegratorVaultFeesTx({
-       *   marketId: "0x...",
-       *   integratorAddress: "0x...",
+       *   integratorId: 7,
        *   recipientAddress: "0x...",
        * });
        *
-       * // Claim with coin output for further use
+       * // Claim with coin outputs for further use
        * const response = await perps.getClaimBuilderCodeIntegratorVaultFeesTx({
-       *   marketId: "0x...",
-       *   integratorAddress: "0x...",
+       *   integratorId: 7,
        * });
-       * // response.coinOutArg can be used in subsequent transaction commands
+       * // response.coinOutArgs can be used in subsequent transaction commands
        * ```
        */
       async getClaimBuilderCodeIntegratorVaultFeesTx(inputs) {
@@ -12579,24 +13337,24 @@ var init_perpetuals = __esm({
        *
        * This endpoint queries whether an integrator has been approved by an account to collect
        * fees on orders placed on behalf of the account. If approved, it returns the maximum
-       * taker fee the integrator is authorized to charge. This information is useful for:
+       * integrator fee the integrator is authorized to charge. This information is useful for:
        * - Verifying integrator permissions before placing orders
        * - Displaying authorized integrators and their fee limits in UIs
        * - Validating that an integrator's requested fee doesn't exceed the approved maximum
        *
        * @param inputs - {@link ApiPerpetualsBuilderCodesIntegratorConfigBody}.
        * @returns {@link ApiPerpetualsBuilderCodesIntegratorConfigResponse} containing
-       *   `maxTakerFee` and `exists` flag.
+       *   `maxIntegratorFee` and `exists` flag.
        *
        * @example
        * ```ts
        * const config = await perps.getBuilderCodeIntegratorConfig({
        *   accountId: 123n,
-       *   integratorAddress: "0x...",
+       *   integratorId: 7,
        * });
        *
        * if (config.exists) {
-       *   console.log(`Integrator is approved with max fee: ${config.maxTakerFee}`);
+       *   console.log(`Integrator is approved with max fee: ${config.maxIntegratorFee}`);
        * } else {
        *   console.log("Integrator is not approved for this account");
        * }
@@ -12606,36 +13364,35 @@ var init_perpetuals = __esm({
         return this.fetchApi("builder-codes/integrator-config", inputs);
       }
       /**
-       * Fetch accumulated integrator vault fees across multiple markets.
+       * Fetch accumulated integrator vault fees.
        *
-       * This endpoint queries the total fees an integrator has earned and accumulated in their
-       * vaults across one or more markets (clearing houses). Integrators earn fees proportional
-       * to the taker volume generated by orders they submit on behalf of users. These fees
-       * accumulate in per-market vaults and can be claimed at any time using
-       * {@link getClaimIntegratorVaultFeesTx}.
+       * This endpoint queries the total fees an integrator has earned and accumulated in
+       * their global vault, grouped by collateral coin type. Integrators earn fees
+       * proportional to the taker volume generated by orders they submit on behalf of
+       * users. These fees can be claimed at any time using
+       * {@link getClaimBuilderCodeIntegratorVaultFeesTx}.
        *
        * This information is useful for:
        * - Displaying total claimable fees to integrators in dashboards
-       * - Monitoring fee accrual across different markets
-       * - Determining which markets have fees ready to be claimed
+       * - Monitoring fee accrual across collateral types
+       * - Determining whether fees are ready to be claimed
        *
        * @param inputs - {@link ApiPerpetualsBuilderCodesIntegratorVaultsBody}.
        * @returns {@link ApiPerpetualsBuilderCodesIntegratorVaultsResponse} containing
-       *   a vector of market vault data with accumulated fees.
+       *   a vector of per-collateral vault data with accumulated fees.
        *
        * @example
        * ```ts
        * const vaultFees = await perps.getBuilderCodeIntegratorVaults({
-       *   marketIds: ["0x...BTCUSD", "0x...SUIUSD"],
-       *   integratorAddress: "0x...",
+       *   integratorId: 7,
        * });
        *
        * for (const vault of vaultFees.integratorVaults) {
-       *   console.log(`Market ${vault.marketId}: ${vault.fees} collateral units claimable`);
+       *   console.log(`${vault.collateralCoinType}: ${vault.fees} collateral units claimable`);
        * }
        *
-       * const totalFees = vaultFees.integratorVaults.reduce((sum, vault) => sum + vault.fees, 0);
-       * console.log(`Total claimable: ${totalFees}`);
+       * const totalFeesUsd = vaultFees.integratorVaults.reduce((sum, vault) => sum + vault.feesUsd, 0);
+       * console.log(`Total claimable (USD): ${totalFeesUsd}`);
        * ```
        */
       async getBuilderCodeIntegratorVaults(inputs) {
@@ -12653,7 +13410,7 @@ var init_perpetuals = __esm({
       static positionSide(inputs) {
         const baseAmount = inputs.baseAssetAmount;
         const isLong = Math.sign(baseAmount);
-        const side = isLong >= 0 ? 0 /* Bid */ : 1 /* Ask */;
+        const side = isLong >= 0 ? PerpetualsOrderSide.Bid : PerpetualsOrderSide.Ask;
         return side;
       }
       /**
@@ -12849,6 +13606,20 @@ var init_perpetuals = __esm({
             }
           }
         });
+        const subscribeMarketCandles = ({
+          marketId,
+          interval
+        }) => ctl.send({
+          action: "subscribe",
+          subscriptionType: { marketCandles: { marketId, interval } }
+        });
+        const unsubscribeMarketCandles = ({
+          marketId,
+          interval
+        }) => ctl.send({
+          action: "unsubscribe",
+          subscriptionType: { marketCandles: { marketId, interval } }
+        });
         return {
           ws: ctl.ws,
           subscribeMarket,
@@ -12867,6 +13638,8 @@ var init_perpetuals = __esm({
           unsubscribeUserCollateralChanges,
           subscribeTopOfOrderbook,
           unsubscribeTopOfOrderbook,
+          subscribeMarketCandles,
+          unsubscribeMarketCandles,
           close: ctl.close
         };
       }
@@ -12896,19 +13669,27 @@ var init_perpetuals = __esm({
        * ```
        */
       openMarketCandlesWebsocketStream(args) {
-        const { marketId, intervalMs, onMessage, onOpen, onError, onClose } = args;
-        const path = `ws/market-candles/${encodeURIComponent(
-          marketId
-        )}/${intervalMs}`;
-        const ctl = this.openWsStream(
-          {
-            path,
-            onMessage,
-            onOpen,
-            onError,
-            onClose
-          }
-        );
+        const { marketId, interval, onMessage, onOpen, onError, onClose } = args;
+        const ctl = this.openWsStream({
+          path: "ws/updates",
+          onMessage: (env) => {
+            if ("marketCandles" in env) {
+              onMessage({
+                marketId: env.marketCandles.marketId,
+                lastCandle: env.marketCandles.lastCandle
+              });
+            }
+          },
+          onOpen: (ev) => {
+            ctl.send({
+              action: "subscribe",
+              subscriptionType: { marketCandles: { marketId, interval } }
+            });
+            onOpen?.(ev);
+          },
+          onError,
+          onClose
+        });
         return {
           ws: ctl.ws,
           close: ctl.close
@@ -12953,7 +13734,7 @@ var init_perpetuals = __esm({
      * @returns {@link PerpetualsOrderSide}.
      */
     _Perpetuals.orderIdToSide = (orderId) => {
-      return _Perpetuals.OrderUtils.isAsk(orderId) ? 1 /* Ask */ : 0 /* Bid */;
+      return _Perpetuals.OrderUtils.isAsk(orderId) ? PerpetualsOrderSide.Ask : PerpetualsOrderSide.Bid;
     };
     /**
      * Construct a collateral-specialized Move event type string.
@@ -13048,7 +13829,7 @@ var init_referralVault2 = __esm({
 });
 
 // src/packages/router/router.ts
-import { Transaction as Transaction6 } from "@mysten/sui/transactions";
+import { Transaction as Transaction7 } from "@mysten/sui/transactions";
 var Router;
 var init_router = __esm({
   "src/packages/router/router.ts"() {
@@ -13249,7 +14030,7 @@ var init_router = __esm({
           serializedTx: tx.serialize()
         });
         return {
-          tx: Transaction6.from(newTx),
+          tx: Transaction7.from(newTx),
           coinOutId
         };
       }
@@ -14808,7 +15589,7 @@ var init_referrals = __esm({
 });
 
 // src/packages/rewards/rewards.ts
-import { Transaction as Transaction7 } from "@mysten/sui/transactions";
+import { Transaction as Transaction8 } from "@mysten/sui/transactions";
 var Rewards;
 var init_rewards = __esm({
   "src/packages/rewards/rewards.ts"() {
@@ -14837,6 +15618,15 @@ var init_rewards = __esm({
       async getClaimable(inputs) {
         return this.fetchApi("claimable", inputs);
       }
+      /**
+       * Preview a single account's expected rewards for an epoch, broken down by
+       * domain (trading, referral, AFLP, integrator) plus totals. Backed by the
+       * newer `rewards/expectedRewards` endpoint. Provide exactly one of `address`
+       * or `accountId`; omit `epoch` for the current epoch.
+       */
+      async getExpectedRewards(inputs) {
+        return this.fetchApi("expectedRewards", inputs);
+      }
       // =========================================================================
       //  Transactions
       // =========================================================================
@@ -14847,7 +15637,7 @@ var init_rewards = __esm({
           {
             ...otherInputs,
             txKind: await this.api?.Transactions().fetchBase64TxKindFromTx({
-              tx: tx ?? new Transaction7()
+              tx: tx ?? new Transaction8()
             })
           },
           void 0,
@@ -14899,7 +15689,7 @@ var init_userData = __esm({
        */
       async getUserPublicKey(inputs) {
         return this.fetchApi(
-          `public-key`,
+          "public-key",
           inputs
         );
       }
@@ -14922,7 +15712,7 @@ var init_userData = __esm({
        */
       async createUserPublicKey(inputs) {
         return this.fetchApi(
-          `save-public-key`,
+          "save-public-key",
           inputs
         );
       }
@@ -14942,7 +15732,7 @@ var init_userData = __esm({
        */
       createUserAccountMessageToSign() {
         return {
-          action: `CREATE_USER_ACCOUNT`
+          action: "CREATE_USER_ACCOUNT"
         };
       }
       /**
@@ -14961,7 +15751,7 @@ var init_userData = __esm({
        */
       createSignTermsAndConditionsMessageToSign() {
         return {
-          action: `SIGN_TERMS_AND_CONDITIONS`
+          action: "SIGN_TERMS_AND_CONDITIONS"
         };
       }
     };
@@ -15136,6 +15926,7 @@ var init_coinApi = __esm({
   "src/packages/coin/api/coinApi.ts"() {
     "use strict";
     init_transactionsApiHelpers();
+    init_grpcCasting();
     init_helpers();
     init_coin();
     _CoinApi = class _CoinApi {
@@ -15188,14 +15979,16 @@ var init_coinApi = __esm({
           let allCoinData = [];
           let cursor;
           do {
-            const paginatedCoins = await this.api.client.getCoins({
-              ...inputs,
+            const paginatedCoins = await this.api.client.listCoins({
+              coinType: inputs.coinType,
               owner: inputs.walletAddress,
               cursor
             });
-            const coinData = paginatedCoins.data;
+            const coinData = paginatedCoins.objects.map(
+              GrpcCasting.coinStructFromGrpcCoin
+            );
             allCoinData = [...allCoinData, ...coinData];
-            if (paginatedCoins.data.length === 0 || !paginatedCoins.hasNextPage || !paginatedCoins.nextCursor) {
+            if (paginatedCoins.objects.length === 0 || !paginatedCoins.hasNextPage || !paginatedCoins.cursor) {
               allCoinData.sort(
                 (b, a) => Number(BigInt(a.balance) - BigInt(b.balance))
               );
@@ -15210,7 +16003,7 @@ var init_coinApi = __esm({
               }
               throw new Error("wallet does not have coins of sufficient balance");
             }
-            cursor = paginatedCoins.nextCursor;
+            cursor = paginatedCoins.cursor;
           } while (true);
         };
         // fetchCoinsUntilAmountReachedOrEnd
@@ -15218,19 +16011,21 @@ var init_coinApi = __esm({
           let allCoinData = [];
           let cursor;
           do {
-            const paginatedCoins = await this.api.client.getCoins({
-              ...inputs,
+            const paginatedCoins = await this.api.client.listCoins({
+              coinType: inputs.coinType,
               owner: inputs.walletAddress,
               cursor
             });
-            const coinData = paginatedCoins.data;
+            const coinData = paginatedCoins.objects.map(
+              GrpcCasting.coinStructFromGrpcCoin
+            );
             allCoinData = [...allCoinData, ...coinData];
-            if (paginatedCoins.data.length === 0 || !paginatedCoins.hasNextPage || !paginatedCoins.nextCursor) {
+            if (paginatedCoins.objects.length === 0 || !paginatedCoins.hasNextPage || !paginatedCoins.cursor) {
               return allCoinData.sort(
                 (b, a) => Number(BigInt(b.coinObjectId) - BigInt(a.coinObjectId))
               );
             }
-            cursor = paginatedCoins.nextCursor;
+            cursor = paginatedCoins.cursor;
           } while (true);
         };
       }
@@ -15377,7 +16172,7 @@ var init_dcaApi = __esm({
 
 // src/packages/farms/api/farmsApi.ts
 import {
-  Transaction as Transaction8
+  Transaction as Transaction9
 } from "@mysten/sui/transactions";
 var _FarmsApi, FarmsApi;
 var init_farmsApi = __esm({
@@ -16439,6 +17234,49 @@ var init_farmsApi = __esm({
             ]
           });
         };
+        /**
+         * Creates a transaction command to set the minimum lock duration (ms) for a
+         * staking pool. Owner-cap only; V2 vault module. Mirrors
+         * `setStakingPoolMinStakeAmountTxV2`.
+         */
+        this.setStakingPoolMinLockDurationMsTxV2 = (inputs) => {
+          const { tx } = inputs;
+          return tx.moveCall({
+            target: Helpers.transactions.createTxTarget(
+              this.addresses.packages.vaultsV2,
+              _FarmsApi.constants.moduleNames.vaultV2,
+              "set_min_lock_duration_ms"
+            ),
+            typeArguments: [inputs.stakeCoinType],
+            arguments: [
+              tx.object(inputs.ownerCapId),
+              tx.object(inputs.stakingPoolId),
+              tx.object(this.addresses.objects.version),
+              tx.pure.u64(inputs.lockDurationMs)
+            ]
+          });
+        };
+        /**
+         * Creates a transaction command to set the maximum lock duration (ms) for a
+         * staking pool. Owner-cap only; V2 vault module.
+         */
+        this.setStakingPoolMaxLockDurationMsTxV2 = (inputs) => {
+          const { tx } = inputs;
+          return tx.moveCall({
+            target: Helpers.transactions.createTxTarget(
+              this.addresses.packages.vaultsV2,
+              _FarmsApi.constants.moduleNames.vaultV2,
+              "set_max_lock_duration_ms"
+            ),
+            typeArguments: [inputs.stakeCoinType],
+            arguments: [
+              tx.object(inputs.ownerCapId),
+              tx.object(inputs.stakingPoolId),
+              tx.object(this.addresses.objects.version),
+              tx.pure.u64(inputs.lockDurationMs)
+            ]
+          });
+        };
         /**
          * Creates a Move call (V1) to **remove undistributed reward coins** from a staking pool.
          * Only callable by the pool **owner** (validated via `ownerCapId`). This does not claw back
@@ -16563,7 +17401,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildStakeTxV1 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const stakeCoinId = await this.api.Coin().fetchCoinWithAmountTx({
             tx,
@@ -16587,7 +17425,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildStakeTxV2 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const stakeCoinId = await this.api.Coin().fetchCoinWithAmountTx({
             tx,
@@ -16613,7 +17451,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildDepositPrincipalTxV1 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const stakeCoinId = await this.api.Coin().fetchCoinWithAmountTx({
             tx,
@@ -16636,7 +17474,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildDepositPrincipalTxV2 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const stakeCoinId = await this.api.Coin().fetchCoinWithAmountTx({
             tx,
@@ -16660,7 +17498,7 @@ var init_farmsApi = __esm({
          */
         this.buildWithdrawPrincipalTxV1 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const withdrawnCoin = this.withdrawPrincipalTxV1({
             ...inputs,
@@ -16676,7 +17514,7 @@ var init_farmsApi = __esm({
          */
         this.buildWithdrawPrincipalTxV2 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const withdrawnCoin = this.withdrawPrincipalTxV2({
             ...inputs,
@@ -16700,7 +17538,7 @@ var init_farmsApi = __esm({
               stakedPositionIds: [inputs.stakedPositionId]
             });
           } else {
-            tx = new Transaction8();
+            tx = new Transaction9();
             tx.setSender(walletAddress);
           }
           const withdrawnCoin = this.withdrawPrincipalTxV1({
@@ -16730,7 +17568,7 @@ var init_farmsApi = __esm({
               stakedPositionIds: [inputs.stakedPositionId]
             });
           } else {
-            tx = new Transaction8();
+            tx = new Transaction9();
             tx.setSender(walletAddress);
           }
           const withdrawnCoin = this.withdrawPrincipalTxV2({
@@ -16823,7 +17661,7 @@ var init_farmsApi = __esm({
          */
         this.buildHarvestRewardsTxV1 = (inputs) => {
           const { walletAddress, stakedPositionIds } = inputs;
-          const tx = inputs.tx ?? new Transaction8();
+          const tx = inputs.tx ?? new Transaction9();
           tx.setSender(walletAddress);
           const harvestRewardsCap = this.beginHarvestTxV1({
             ...inputs,
@@ -16875,7 +17713,7 @@ var init_farmsApi = __esm({
          */
         this.buildHarvestRewardsTxV2 = (inputs) => {
           const { walletAddress, stakedPositionIds } = inputs;
-          const tx = inputs.tx ?? new Transaction8();
+          const tx = inputs.tx ?? new Transaction9();
           tx.setSender(walletAddress);
           const firstPositionId = stakedPositionIds[0];
           const harvestRewardsCap = this.beginHarvestTxV2({
@@ -16933,7 +17771,7 @@ var init_farmsApi = __esm({
          */
         this.buildCreateStakingPoolTxV1 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const [stakingPoolId, ownerCapId] = this.newStakingPoolTxV1({
             ...inputs,
@@ -16959,7 +17797,7 @@ var init_farmsApi = __esm({
          */
         this.buildCreateStakingPoolTxV2 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const [stakingPoolId, ownerCapId] = this.newStakingPoolTxV2({
             ...inputs,
@@ -16985,7 +17823,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildInitializeStakingPoolRewardTxV1 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const rewardCoinId = await this.api.Coin().fetchCoinWithAmountTx({
             tx,
@@ -17004,7 +17842,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildInitializeStakingPoolRewardTxV2 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           const rewardCoinId = await this.api.Coin().fetchCoinWithAmountTx({
             tx,
@@ -17024,7 +17862,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildTopUpStakingPoolRewardsTxV1 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           for (const reward of inputs.rewards) {
             const rewardCoinId = await this.api.Coin().fetchCoinWithAmountTx({
@@ -17050,7 +17888,7 @@ var init_farmsApi = __esm({
          */
         this.fetchBuildTopUpStakingPoolRewardsTxV2 = async (inputs) => {
           const { walletAddress, isSponsoredTx } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           for (const reward of inputs.rewards) {
             const rewardCoinId = await this.api.Coin().fetchCoinWithAmountTx({
@@ -17077,7 +17915,7 @@ var init_farmsApi = __esm({
          */
         this.buildIncreaseStakingPoolRewardsEmissionsTxV1 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           for (const reward of inputs.rewards) {
             this.increaseStakingPoolRewardEmissionsTxV1({
@@ -17095,7 +17933,7 @@ var init_farmsApi = __esm({
          */
         this.buildIncreaseStakingPoolRewardsEmissionsTxV2 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           for (const reward of inputs.rewards) {
             this.increaseStakingPoolRewardEmissionsTxV2({
@@ -17123,6 +17961,12 @@ var init_farmsApi = __esm({
         this.buildSetStakingPoolMinStakeAmountTxV2 = Helpers.transactions.createBuildTxFunc(
           this.setStakingPoolMinStakeAmountTxV2
         );
+        this.buildSetStakingPoolMinLockDurationMsTxV2 = Helpers.transactions.createBuildTxFunc(
+          this.setStakingPoolMinLockDurationMsTxV2
+        );
+        this.buildSetStakingPoolMaxLockDurationMsTxV2 = Helpers.transactions.createBuildTxFunc(
+          this.setStakingPoolMaxLockDurationMsTxV2
+        );
         /**
          * Builds a transaction for **removing undistributed reward coins** from a staking pool (V1).
          * Requires the pool **OwnerCap**. The removal is specific to a `rewardCoinType`.
@@ -17132,7 +17976,7 @@ var init_farmsApi = __esm({
          */
         this.buildRemoveStakingPoolRewardTxV1 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           for (const reward of inputs.rewards) {
             this.removeStakingPoolRewardTxV1({
@@ -17152,7 +17996,7 @@ var init_farmsApi = __esm({
          */
         this.buildRemoveStakingPoolRewardTxV2 = (inputs) => {
           const { walletAddress } = inputs;
-          const tx = new Transaction8();
+          const tx = new Transaction9();
           tx.setSender(walletAddress);
           for (const reward of inputs.rewards) {
             this.removeStakingPoolRewardTxV2({
@@ -17561,7 +18405,7 @@ var init_farmsApi = __esm({
 
 // src/packages/faucet/api/faucetApi.ts
 import {
-  Transaction as Transaction9
+  Transaction as Transaction10
 } from "@mysten/sui/transactions";
 var _FaucetApi, FaucetApi;
 var init_faucetApi = __esm({
@@ -17569,7 +18413,6 @@ var init_faucetApi = __esm({
     "use strict";
     init_eventsApiHelpers();
     init_transactionsApiHelpers();
-    init_utils();
     init_coin2();
     init_sui2();
     init_faucetApiCasting();
@@ -17590,35 +18433,24 @@ var init_faucetApi = __esm({
         // =========================================================================
         //  Transaction Commands
         // =========================================================================
-        // public addCoinTx = (inputs: {
-        // 	tx: Transaction;
-        // 	treasuryCapId: ObjectId;
-        // 	treasuryCapType: AnyObjectType;
-        // }) => {
-        // 	const { tx, treasuryCapId, treasuryCapType } = inputs;
-        // 	return tx.moveCall({
-        // 		target: TransactionsApiHelpers.createTxTarget(
-        // 			this.addresses.packages.faucet,
-        // 			FaucetApi.constants.moduleNames.faucet,
-        // 			"add_coin"
-        // 		),
-        // 		typeArguments: [treasuryCapType],
-        // 		arguments: [
-        // 			tx.object(this.addresses.objects.faucet),
-        // 			tx.object(treasuryCapId),
-        // 		],
-        // 	});
-        // };
+        /**
+         * Mints `coinType`'s configured default amount and returns the resulting
+         * `Coin<T>`. Use {@link buildRequestCoinTx} to mint and transfer it to a
+         * wallet in one transaction.
+         */
         this.requestCoinTx = (inputs) => {
           const { tx, coinType } = inputs;
           return tx.moveCall({
             target: TransactionsApiHelpers.createTxTarget(
               this.addresses.packages.faucet,
               _FaucetApi.constants.moduleNames.faucet,
-              "request_default_amount"
+              "mint"
             ),
             typeArguments: [coinType],
-            arguments: [tx.object(this.addresses.objects.faucet)]
+            arguments: [
+              tx.object(this.addresses.objects.faucet),
+              tx.object(this.addresses.objects.config)
+            ]
           });
         };
         this.mintSuiFrenTx = (inputs) => {
@@ -17643,12 +18475,17 @@ var init_faucetApi = __esm({
         // =========================================================================
         //  Transaction Builders
         // =========================================================================
-        this.buildRequestCoinTx = Helpers.transactions.createBuildTxFunc(
-          this.requestCoinTx
-        );
+        this.buildRequestCoinTx = (inputs) => {
+          const { walletAddress, coinType } = inputs;
+          const tx = new Transaction10();
+          tx.setSender(walletAddress);
+          const coin = this.requestCoinTx({ tx, coinType });
+          tx.transferObjects([coin], walletAddress);
+          return tx;
+        };
         this.fetchBuildMintSuiFrenTx = async (inputs) => {
           const { walletAddress, mintFee, suiFrenType } = inputs;
-          const tx = new Transaction9();
+          const tx = new Transaction10();
           tx.setSender(walletAddress);
           const suiPaymentCoinId = await this.api.Coin().fetchCoinWithAmountTx({
             tx,
@@ -17662,7 +18499,6 @@ var init_faucetApi = __esm({
         // =========================================================================
         //  Events
         // =========================================================================
-        // TODO: add to indexer
         this.fetchMintCoinEvents = async (inputs) => await this.api.Events().fetchCastEventsWithCursor({
           ...inputs,
           query: {
@@ -17670,7 +18506,6 @@ var init_faucetApi = __esm({
           },
           eventFromEventOnChain: FaucetApiCasting.faucetMintCoinEventFromOnChain
         });
-        // TODO: add to indexer
         this.fetchAddCoinEvents = async (inputs) => await this.api.Events().fetchCastEventsWithCursor(
           {
             ...inputs,
@@ -17721,7 +18556,7 @@ var init_faucetApi = __esm({
       },
       eventNames: {
         mintCoin: "MintedCoin",
-        addCoin: "AddedCoinEvent"
+        addCoin: "AddedCoin"
       }
     };
     FaucetApi = _FaucetApi;
@@ -17812,7 +18647,7 @@ var init_multisigApi = __esm({
 
 // src/packages/nftAmm/api/nftAmmApi.ts
 import {
-  Transaction as Transaction10
+  Transaction as Transaction11
 } from "@mysten/sui/transactions";
 var _NftAmmApi, NftAmmApi;
 var init_nftAmmApi = __esm({
@@ -17857,7 +18692,7 @@ var init_nftAmmApi = __esm({
         //  Transaction Builders
         // =========================================================================
         this.fetchBuildBuyTx = async (inputs) => {
-          const tx = new Transaction10();
+          const tx = new Transaction11();
           tx.setSender(inputs.walletAddress);
           const { market } = inputs;
           const marketObject = market.market;
@@ -17883,7 +18718,7 @@ var init_nftAmmApi = __esm({
           return tx;
         };
         this.fetchBuildSellTx = async (inputs) => {
-          const tx = new Transaction10();
+          const tx = new Transaction11();
           tx.setSender(inputs.walletAddress);
           const { market } = inputs;
           const marketObject = market.market;
@@ -17903,7 +18738,7 @@ var init_nftAmmApi = __esm({
           return tx;
         };
         this.fetchBuildDepositTx = async (inputs) => {
-          const tx = new Transaction10();
+          const tx = new Transaction11();
           tx.setSender(inputs.walletAddress);
           const { market } = inputs;
           const marketObject = market.market;
@@ -17930,7 +18765,7 @@ var init_nftAmmApi = __esm({
           return tx;
         };
         this.fetchBuildWithdrawTx = async (inputs) => {
-          const tx = new Transaction10();
+          const tx = new Transaction11();
           tx.setSender(inputs.walletAddress);
           const { market } = inputs;
           const marketObject = market.market;
@@ -19547,9 +20382,9 @@ var init_perpetualsApi = __esm({
 // src/packages/pools/api/poolsApi.ts
 import { bcs as bcs2 } from "@mysten/sui/bcs";
 import {
-  Transaction as Transaction11
+  Transaction as Transaction12
 } from "@mysten/sui/transactions";
-import { fromBase64, normalizeSuiObjectId } from "@mysten/sui/utils";
+import { fromBase64 as fromBase642, normalizeSuiObjectId } from "@mysten/sui/utils";
 var _PoolsApi, PoolsApi;
 var init_poolsApi = __esm({
   "src/packages/pools/api/poolsApi.ts"() {
@@ -19754,7 +20589,7 @@ var init_poolsApi = __esm({
           const compiledModulesAndDeps = JSON.parse(compilations[lpCoinDecimals]);
           return tx.publish({
             modules: compiledModulesAndDeps.modules.map(
-              (m) => Array.from(fromBase64(m))
+              (m) => Array.from(fromBase642(m))
             ),
             dependencies: compiledModulesAndDeps.dependencies.map(
               (addr) => normalizeSuiObjectId(addr)
@@ -20072,7 +20907,7 @@ var init_poolsApi = __esm({
             referrer,
             isSponsoredTx
           } = inputs;
-          const tx = new Transaction11();
+          const tx = new Transaction12();
           tx.setSender(walletAddress);
           if (referrer) {
             this.api.ReferralVault().updateReferrerTx({
@@ -20168,7 +21003,7 @@ var init_poolsApi = __esm({
             referrer,
             isSponsoredTx
           } = inputs;
-          const tx = new Transaction11();
+          const tx = new Transaction12();
           tx.setSender(walletAddress);
           if (referrer) {
             this.api.ReferralVault().updateReferrerTx({
@@ -20234,7 +21069,7 @@ var init_poolsApi = __esm({
             slippage,
             referrer
           } = inputs;
-          const tx = new Transaction11();
+          const tx = new Transaction12();
           tx.setSender(walletAddress);
           if (referrer) {
             this.api.ReferralVault().updateReferrerTx({
@@ -20279,7 +21114,7 @@ var init_poolsApi = __esm({
          */
         this.fetchBuildAllCoinWithdrawTx = async (inputs) => {
           const { walletAddress, pool, lpCoinAmount, referrer } = inputs;
-          const tx = new Transaction11();
+          const tx = new Transaction12();
           tx.setSender(walletAddress);
           if (referrer) {
             this.api.ReferralVault().updateReferrerTx({
@@ -20325,7 +21160,7 @@ var init_poolsApi = __esm({
          */
         this.buildPublishLpCoinTx = (inputs) => {
           const { lpCoinDecimals } = inputs;
-          const tx = new Transaction11();
+          const tx = new Transaction12();
           tx.setSender(inputs.walletAddress);
           const upgradeCap = this.publishLpCoinTx({ tx, lpCoinDecimals });
           tx.transferObjects([upgradeCap], inputs.walletAddress);
@@ -20567,7 +21402,7 @@ var init_poolsApi = __esm({
 
 // src/packages/referralVault/api/referralVaultApi.ts
 import { bcs as bcs3 } from "@mysten/sui/bcs";
-import { Transaction as Transaction12 } from "@mysten/sui/transactions";
+import { Transaction as Transaction13 } from "@mysten/sui/transactions";
 var _ReferralVaultApi, ReferralVaultApi;
 var init_referralVaultApi = __esm({
   "src/packages/referralVault/api/referralVaultApi.ts"() {
@@ -20668,7 +21503,7 @@ var init_referralVaultApi = __esm({
         //  Inspections
         // =========================================================================
         this.fetchBalanceOfRebate = async (inputs) => {
-          const tx = new Transaction12();
+          const tx = new Transaction13();
           this.balanceOfRebateTx({ ...inputs, tx });
           const bytes = await this.api.Inspections().fetchFirstBytesFromTxOutput({
             tx
@@ -20676,7 +21511,7 @@ var init_referralVaultApi = __esm({
           return Casting.bigIntFromBytes(bytes);
         };
         this.fetchReferrer = async (inputs) => {
-          const tx = new Transaction12();
+          const tx = new Transaction13();
           this.referrerForTx({ ...inputs, tx });
           const bytes = await this.api.Inspections().fetchFirstBytesFromTxOutput({
             tx
@@ -20799,7 +21634,7 @@ var init_routerApi = __esm({
 
 // src/packages/staking/api/stakingApi.ts
 import {
-  Transaction as Transaction13
+  Transaction as Transaction14
 } from "@mysten/sui/transactions";
 var _StakingApi, StakingApi;
 var init_stakingApi = __esm({
@@ -21083,7 +21918,7 @@ var init_stakingApi = __esm({
           if (externalFee) {
             _StakingApi.assertValidExternalFee(externalFee);
           }
-          const tx = new Transaction13();
+          const tx = new Transaction14();
           tx.setSender(inputs.walletAddress);
           if (referrer) {
             this.api.ReferralVault().updateReferrerTx({
@@ -21124,7 +21959,7 @@ var init_stakingApi = __esm({
           if (externalFee) {
             _StakingApi.assertValidExternalFee(externalFee);
           }
-          const tx = new Transaction13();
+          const tx = new Transaction14();
           tx.setSender(inputs.walletAddress);
           if (referrer) {
             this.api.ReferralVault().updateReferrerTx({
@@ -21172,7 +22007,7 @@ var init_stakingApi = __esm({
          */
         this.fetchBuildStakeStakedSuiTx = async (inputs) => {
           const { referrer } = inputs;
-          const tx = new Transaction13();
+          const tx = new Transaction14();
           tx.setSender(inputs.walletAddress);
           if (referrer) {
             this.api.ReferralVault().updateReferrerTx({
@@ -21189,7 +22024,7 @@ var init_stakingApi = __esm({
           return tx;
         };
         this.buildUpdateValidatorFeeTx = async (inputs) => {
-          const tx = new Transaction13();
+          const tx = new Transaction14();
           tx.setSender(inputs.walletAddress);
           this.updateValidatorFeeTx({
             ...inputs,
@@ -21434,6 +22269,28 @@ var init_suiApi = __esm({
         /**
          * @deprecated Use `getSystemState()` method instead.
          * This method will be removed in a future release.
+         *
+         * @remarks **Remaining JSON-RPC surface** — see
+         * {@link AftermathApi.jsonRpcClient}. gRPC has no `SuiSystemStateSummary`
+         * equivalent. `client.core.getCurrentSystemState()` carries no validators at
+         * all, and while `client.ledgerService.getEpoch({ readMask: { paths:
+         * ["system_state"] } })` does return them (verified: 125 active validators on
+         * mainnet, under the runtime key `validators`, not the generated
+         * `validatorSet`), its validator shape is not a superset of
+         * `SuiValidatorSummary`: keys are renamed (`address`/`p2PAddress`/
+         * `networkAddress`/`protocolPublicKey` vs `suiAddress`/`p2pAddress`/
+         * `netAddress`/`protocolPubkeyBytes`), the staking-pool fields are nested
+         * rather than flattened, numbers are `bigint` rather than decimal strings,
+         * public keys are `Uint8Array` rather than base64, and
+         * `stakingPoolDeactivationEpoch` / `validatorVeryLowStakeThreshold` are
+         * absent entirely. Remapping it would change what this method returns.
+         *
+         * Note `Sui().getSystemState()` — the public method — does not touch the
+         * fullnode; it reads the Aftermath API. Only this deprecated helper does.
+         *
+         * @throws If no `jsonRpcClient` was passed to {@link AftermathApi}, since it
+         * is optional there.
+         *
          * @example
          * ```typescript
          * const afSdk = await Aftermath.create({ network: "MAINNET" });
@@ -21444,7 +22301,10 @@ var init_suiApi = __esm({
          * console.log(systemState.epoch, systemState.validators);
          */
         this.fetchSystemState = async () => {
-          const systemState = await this.api.client.getLatestSuiSystemState();
+          const jsonRpcClient = this.api.requireJsonRpcClient(
+            "Sui().fetchSystemState"
+          );
+          const systemState = await jsonRpcClient.getLatestSuiSystemState();
           const activeValidators = systemState.activeValidators.map((validator) => ({
             ...validator,
             suiAddress: Helpers.addLeadingZeroesToType(validator.suiAddress)
@@ -21461,7 +22321,7 @@ var init_suiApi = __esm({
 
 // src/packages/suiFrens/api/suiFrensApi.ts
 import {
-  Transaction as Transaction14
+  Transaction as Transaction15
 } from "@mysten/sui/transactions";
 import { bcs as bcs4 } from "@mysten/sui/bcs";
 var _SuiFrensApi, SuiFrensApi;
@@ -21487,7 +22347,7 @@ var init_suiFrensApi = __esm({
         //  Inspections
         // =========================================================================
         this.fetchMixingLimitsAndLastEpochMixeds = async (inputs) => {
-          const tx = new Transaction14();
+          const tx = new Transaction15();
           this.devInspectMixLimitAndLastEpochMixedMulTx({ ...inputs, tx });
           const [mixLimitBytes, lastEpochMixedBytes] = await this.api.Inspections().fetchAllBytesFromTxOutput({
             tx
@@ -21501,7 +22361,7 @@ var init_suiFrensApi = __esm({
         };
         this.fetchMixingLimit = async (inputs) => {
           if (inputs.suiFrenType === this.objectTypes.bullshark) return void 0;
-          const tx = new Transaction14();
+          const tx = new Transaction15();
           this.mixingLimitTx({ tx, ...inputs });
           const bytes = await this.api.Inspections().fetchFirstBytesFromTxOutput(
             {
@@ -21513,7 +22373,7 @@ var init_suiFrensApi = __esm({
         };
         this.fetchLastEpochMixed = async (inputs) => {
           if (inputs.suiFrenType === this.objectTypes.bullshark) return void 0;
-          const tx = new Transaction14();
+          const tx = new Transaction15();
           this.lastEpochMixedTx({ tx, ...inputs });
           const bytes = await this.api.Inspections().fetchFirstBytesFromTxOutput(
             {
@@ -21525,7 +22385,7 @@ var init_suiFrensApi = __esm({
         };
         this.fetchStakedSuiFrenMetadataIds = async (inputs) => {
           const { suiFrenIds } = inputs;
-          const tx = new Transaction14();
+          const tx = new Transaction15();
           this.devInspectMetadataObjectIdMulTx({ tx, suiFrenIds });
           const idBytes = await this.api.Inspections().fetchFirstBytesFromTxOutput({
             tx
@@ -21590,11 +22450,7 @@ var init_suiFrensApi = __esm({
           const partialSuiFrens = await this.api.Objects().fetchCastObjectBatch({
             objectIds: suiFrenIds,
             objectFromSuiObjectResponse: Casting.suiFrens.partialSuiFrenObjectFromSuiObjectResponse,
-            options: {
-              showDisplay: true,
-              showType: true,
-              showContent: true
-            }
+            withDisplay: true
           });
           return this.fetchCompletePartialSuiFrenObjects({
             partialSuiFrens,
@@ -21626,11 +22482,7 @@ var init_suiFrensApi = __esm({
           const stakedSuiFrenData = await this.api.Objects().fetchCastObjectBatch({
             objectIds: stakedSuiFrenIds,
             objectFromSuiObjectResponse: Casting.suiFrens.partialSuiFrenAndStakedSuiFrenMetadataV1ObjectFromSuiObjectResponse,
-            options: {
-              showDisplay: true,
-              showType: true,
-              showContent: true
-            }
+            withDisplay: true
           });
           const suiFrens = await this.fetchCompletePartialSuiFrenObjects({
             partialSuiFrens: stakedSuiFrenData.map((data) => data.partialSuiFren),
@@ -21675,11 +22527,7 @@ var init_suiFrensApi = __esm({
           return this.api.Objects().fetchCastObjectBatch({
             objectIds,
             objectFromSuiObjectResponse: Casting.suiFrens.accessoryObjectFromSuiObjectResponse,
-            options: {
-              showDisplay: true,
-              showType: true,
-              showContent: true
-            }
+            withDisplay: true
           });
         };
         // =========================================================================
@@ -22085,7 +22933,7 @@ var init_suiFrensApi = __esm({
             baseFee,
             isSponsoredTx
           } = inputs;
-          const tx = new Transaction14();
+          const tx = new Transaction15();
           tx.setSender(walletAddress);
           const totalFee = baseFee + SuiFrens.calcTotalInternalMixFee({
             mixFee1: suiFrenParentOne.mixFee,
@@ -22135,7 +22983,7 @@ var init_suiFrensApi = __esm({
         // =========================================================================
         this.fetchBuildHarvestFeesTx = async (inputs) => {
           const { stakedPositionIds } = inputs;
-          const tx = new Transaction14();
+          const tx = new Transaction15();
           tx.setSender(inputs.walletAddress);
           const harvestFeesEventMetadataId = this.beginHarvestTx({ tx });
           let harvestedCoins = [];
@@ -22398,26 +23246,17 @@ var init_nftsApi = __esm({
         this.fetchOwnedNfts = async (inputs) => {
           const objects = await this.api.Objects().fetchOwnedObjects({
             ...inputs,
-            options: {
-              // NOTE: do we need all of this ?
-              showContent: true,
-              showOwner: true,
-              showType: true,
-              showDisplay: true
-            }
+            // @dev: `showDisplay` -> `withDisplay`, which becomes
+            // `include: { display: true }`. `nftFromSuiObject` reads display, so
+            // dropping this would leave every NFT with an empty one.
+            withDisplay: true
           });
           return Casting.nfts.nftsFromSuiObjects(objects);
         };
         this.fetchNfts = async (inputs) => {
           const objects = await this.api.Objects().fetchObjectBatch({
             ...inputs,
-            options: {
-              // NOTE: do we need all of this ?
-              showContent: true,
-              showOwner: true,
-              showType: true,
-              showDisplay: true
-            }
+            withDisplay: true
           });
           return Casting.nfts.nftsFromSuiObjects(objects);
         };
@@ -22451,7 +23290,7 @@ var init_nftsApi = __esm({
           const { kioskOwnerCapIds } = inputs;
           return this.api.Objects().fetchCastObjectBatch({
             objectIds: kioskOwnerCapIds,
-            objectFromSuiObjectResponse: (response) => response.data?.type && Helpers.addLeadingZeroesToType(response.data?.type) === this.objectTypes.personalKioskCap ? Casting.nfts.kioskOwnerCapFromPersonalKioskCapSuiObject(response) : Casting.nfts.kioskOwnerCapFromSuiObject(response)
+            objectFromSuiObjectResponse: (object) => object.type && Helpers.addLeadingZeroesToType(object.type) === this.objectTypes.personalKioskCap ? Casting.nfts.kioskOwnerCapFromPersonalKioskCapSuiObject(object) : Casting.nfts.kioskOwnerCapFromSuiObject(object)
           });
         };
         this.fetchKiosks = async (inputs) => {
@@ -22524,25 +23363,35 @@ var init_walletApi = __esm({
         // =========================================================================
         this.fetchCoinBalance = async (inputs) => {
           const { walletAddress, coin } = inputs;
-          const coinBalance = await this.api.client.getBalance({
+          const { balance } = await this.api.client.getBalance({
             owner: walletAddress,
             coinType: Helpers.stripLeadingZeroesFromType(coin)
           });
-          return BigInt(coinBalance.totalBalance);
+          return BigInt(balance.balance);
         };
         // TODO: make toBigIntSafe function ?
         // TODO: return prices here as well and sort ?
         this.fetchAllCoinBalances = async (inputs) => {
           const { walletAddress } = inputs;
-          const allBalances = await this.api.client.getAllBalances({
-            owner: walletAddress
-          });
+          const allBalances = [];
+          let cursor;
+          do {
+            const page = await this.api.client.listBalances({
+              owner: walletAddress,
+              cursor
+            });
+            allBalances.push(...page.balances);
+            if (page.balances.length === 0 || !page.hasNextPage || !page.cursor) {
+              break;
+            }
+            cursor = page.cursor;
+          } while (true);
           const coinsToBalance = allBalances.reduce(
             (acc, balance) => {
               return {
                 ...acc,
                 [Helpers.addLeadingZeroesToType(balance.coinType)]: BigInt(
-                  balance.totalBalance
+                  balance.balance
                 )
               };
             },
@@ -22608,12 +23457,44 @@ var init_aftermathApi = __esm({
        * Constructs a new instance of the `AftermathApi`, binding the given Sui client
        * to the known `addresses`.
        *
-       * @param client - A `SuiJsonRpcClient` for on-chain queries and transactions.
+       * @param client - A `SuiGrpcClient` for on-chain queries and transactions.
        * @param addresses - The config addresses (object IDs, package IDs, etc.) for the Aftermath protocol.
-       */
-      constructor(client, addresses) {
+       * @param jsonRpcClient - **Optional.** A `SuiJsonRpcClient` pointed at the same
+       * fullnode. Only used by the three legacy helpers listed on
+       * {@link AftermathApi.jsonRpcClient}; every other call goes over gRPC via
+       * `client`. Omit it unless you call one of those three — they then throw a
+       * descriptive error instead of failing against a deprecated protocol. See
+       * {@link AftermathApi.requireJsonRpcClient}.
+       */
+      constructor(client, addresses, jsonRpcClient) {
         this.client = client;
         this.addresses = addresses;
+        this.jsonRpcClient = jsonRpcClient;
+        // =========================================================================
+        //  Legacy JSON-RPC Access
+        // =========================================================================
+        /**
+         * Returns the optional {@link AftermathApi.jsonRpcClient}, throwing a
+         * descriptive error when it was not supplied.
+         *
+         * Used by the three helpers that have no `SuiGrpcClient` equivalent. The
+         * throw is deliberate: these helpers cannot degrade to an empty result
+         * without silently lying to their callers, and JSON-RPC is scheduled for
+         * removal from Sui fullnodes in mid-October 2026, so a missing client is a
+         * configuration error worth naming rather than hiding.
+         *
+         * @param methodName - The public helper the caller invoked, e.g.
+         * `"Events().fetchCastEventsWithCursor"`. Named in the error message.
+         * @throws If no `jsonRpcClient` was passed to the constructor.
+         */
+        this.requireJsonRpcClient = (methodName) => {
+          if (!this.jsonRpcClient) {
+            throw new Error(
+              `${methodName} requires a \`SuiJsonRpcClient\`, which was not provided to \`AftermathApi\`. It is one of three helpers with no \`SuiGrpcClient\` equivalent (alongside \`Transactions().fetchTransactionsWithCursor\` and the deprecated \`Sui().fetchSystemState\`); every other call in this SDK goes over gRPC. Either pass a \`SuiJsonRpcClient\` as \`AftermathApi\`'s third constructor argument, or use the Aftermath API's own endpoints \u2014 note that Sui JSON-RPC is deprecated and scheduled for removal from fullnodes in mid-October 2026.`
+            );
+          }
+          return this.jsonRpcClient;
+        };
         // =========================================================================
         //  Class Object Creation
         // =========================================================================
@@ -22789,6 +23670,7 @@ var init_aftermathApi = __esm({
 });
 
 // src/general/providers/aftermath.ts
+import { SuiGrpcClient } from "@mysten/sui/grpc";
 import { SuiJsonRpcClient } from "@mysten/sui/jsonRpc";
 var _Aftermath, Aftermath;
 var init_aftermath = __esm({
@@ -22895,28 +23777,32 @@ var init_aftermath = __esm({
        * returns a ready-to-use instance. Pass `addresses` or `api` to skip
        * the corresponding bootstrap steps.
        */
-      static async create(options = {}) {
+      static async create(options = {}, abortSignal) {
         const af = new _Aftermath(options);
-        await af.bootstrap();
+        await af.bootstrap(abortSignal);
         return af;
       }
       /**
        * Resolves addresses and wires up the internal `AftermathApi`. Called
        * exactly once by the {@link Aftermath.create} factory.
        */
-      async bootstrap() {
+      async bootstrap(abortSignal) {
         if (this.options.api) {
           this.api = this.options.api;
           return;
         }
         const network = this.network;
-        const addresses = this.options.addresses ?? await this.getAddresses();
+        const addresses = this.options.addresses ?? await this.getAddresses(abortSignal);
         const fullnodeUrl = this.options.fullnodeUrl ?? Caller.defaultFullnodeUrl(network);
-        const client = new SuiJsonRpcClient({
+        const client = new SuiGrpcClient({
+          network: network.toLowerCase(),
+          baseUrl: fullnodeUrl
+        });
+        const jsonRpcClient = new SuiJsonRpcClient({
           url: fullnodeUrl,
           network: network.toLowerCase()
         });
-        this.api = new AftermathApi(client, addresses);
+        this.api = new AftermathApi(client, addresses, jsonRpcClient);
       }
       // =========================================================================
       //  Public Accessors
@@ -22938,8 +23824,8 @@ var init_aftermath = __esm({
        * directly from the API. Typically you don't need to call this — the
        * `create` factory handles it. Useful for cache warmers or tooling.
        */
-      getAddresses() {
-        return this.fetchApi("addresses");
+      getAddresses(abortSignal) {
+        return this.fetchApi("addresses", void 0, abortSignal);
       }
       /**
        * Attempts to decode a raw Move abort/error string into a structured
@@ -22986,6 +23872,7 @@ init_index();
 export {
   Aftermath,
   AftermathApi,
+  AftermathTransportError,
   Auth,
   Casting,
   Coin,
@@ -22994,6 +23881,7 @@ export {
   FarmsStakingPool,
   Faucet,
   GasPools,
+  GrpcCasting,
   Helpers,
   NftAmm,
   Perpetuals,
@@ -23001,6 +23889,7 @@ export {
   PerpetualsMarket,
   PerpetualsOrderSide,
   PerpetualsOrderType,
+  PerpetualsStopOrderTriggerPriceType,
   PerpetualsStopOrderType,
   PerpetualsVault,
   Pool,
@@ -23013,6 +23902,7 @@ export {
   SuiFren,
   SuiFrens,
   SuiFrensSortOption,
+  isAftermathTransportError,
   isAllocatedCollateralEvent,
   isCanceledOrderEvent,
   isDeallocatedCollateralEvent,