@evefrontier/dapp-kit 0.1.3 → 0.1.6

package/hooks/useSponsoredTransaction.ts

@@ -17,7 +17,7 @@ import {
   type SponsoredTransactionOutput,
   SponsoredTransactionArgs,
 } from "../wallet";
-import { QueryParams, SponsoredTransactionActions } from "../types";
+import { Assemblies, QueryParams, SponsoredTransactionActions } from "../types";
 
 /** Wallet-like shape from dApp Kit (UiWallet or connection store). */
 type ResolvableWallet = {
@@ -133,7 +133,7 @@ function resolveAssemblyId(
 /**
  * Error union type for {@link useSponsoredTransaction} mutation failures.
  *
- * @category Hooks
+ * @category Hooks - Sponsored Transaction
  */
 export type UseSponsoredTransactionError =
   | WalletSponsoredTransactionNotSupportedError
@@ -146,14 +146,14 @@ export type UseSponsoredTransactionError =
  * Arguments passed to {@link useSponsoredTransaction} mutate/mutateAsync.
  * With assembly object (id and type derived).
  *
- * @category Hooks
+ * @category Hooks - Sponsored Transaction
  */
 export type UseSponsoredTransactionArgs = SponsoredTransactionArgs;
 
 /**
  * React Query mutation options for {@link useSponsoredTransaction}.
  *
- * @category Hooks
+ * @category Hooks - Sponsored Transaction
  */
 export type UseSponsoredTransactionMutationOptions = Omit<
   UseMutationOptions<
@@ -191,7 +191,7 @@ export type UseSponsoredTransactionMutationOptions = Omit<
  * - `effects` (optional) – Transaction effects, BCS encoded.
  * - `rawEffects` (optional) – Raw effects bytes.
  *
- * @category Hooks
+ * @category Hooks - Sponsored Transaction
  * @param options - React Query mutation options (optional)
  * @returns React Query mutation result with:
  *   - `mutate(args, options?)` - Trigger transaction (fire-and-forget)
@@ -375,15 +375,22 @@ export function useSponsoredTransaction({
 
       const assemblyId = resolveAssemblyId(args.assembly.item_id, queryItemId);
 
+      // If the txAction is UPDATE_METADATA, it goes through the standard assembly type
+      const assemblyType = getAssemblyTypeApiString(
+        args.txAction === SponsoredTransactionActions.UPDATE_METADATA
+          ? Assemblies.Assembly
+          : args.assembly.type,
+      );
+
       const payload: SponsoredTransactionInput = {
         txAction: args.txAction,
         assembly: assemblyId,
-        assemblyType: getAssemblyTypeApiString(args.assembly.type),
-        chain: args.chain,
+        assemblyType: assemblyType,
+        metadata: args.metadata,
         tenant,
       };
 
-      console.log("payload", payload);
+      console.log("Sponsored Transaction Payload:", payload);
 
       return await signSponsoredTransaction(payload);
     },

package/package.json

@@ -1,11 +1,21 @@
 {
   "name": "@evefrontier/dapp-kit",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "React SDK for EVE Frontier dApps on Sui",
   "main": "index.ts",
   "author": "",
   "license": "MIT",
   "type": "module",
+  "files": [
+    "index.ts",
+    "config",
+    "graphql",
+    "hooks",
+    "providers",
+    "types",
+    "utils",
+    "wallet"
+  ],
   "exports": {
     ".": "./index.ts",
     "./types": "./types/index.ts",

package/providers/SmartObjectProvider.tsx

@@ -14,7 +14,7 @@ import {
   DetailedSmartCharacterResponse,
 } from "../types";
 
-import { POLLING_INTERVAL } from "../utils/constants";
+import { DEFAULT_TENANT, POLLING_INTERVAL } from "../utils/constants";
 import { getAssemblyWithOwner, MoveObjectData } from "../graphql";
 import {
   getObjectId,
@@ -25,9 +25,6 @@ import { getDatahubGameInfo } from "../utils/datahub";
 import { useConnection } from "../hooks/useConnection";
 import { SmartObjectContextType } from "../types";
 
-/** Tenant when not provided via URL ?tenant= (e.g. dev/default chain). */
-const DEFAULT_TENANT = "testevenet";
-
 /** Input for fetching object data: either itemId + tenant (derive object ID) or a Sui object ID directly.
  * @category Types
  */
@@ -37,6 +34,7 @@ export type FetchObjectDataInput =
 
 /** @category Providers */
 export const SmartObjectContext = createContext<SmartObjectContextType>({
+  tenant: DEFAULT_TENANT,
   assembly: null,
   assemblyOwner: null,
   loading: true,
@@ -269,6 +267,7 @@ const SmartObjectProvider = ({ children }: { children: ReactNode }) => {
   return (
     <SmartObjectContext.Provider
       value={{
+        tenant: selectedTenant,
         assembly,
         assemblyOwner,
         loading,

package/types/contexts.ts

@@ -7,8 +7,9 @@ import {
 } from "./types";
 
 /**
- * Vault Context Type
- * @category Types */
+ * Vault context: account, connection state, and connect/disconnect handlers.
+ * @category Types
+ */
 export interface VaultContextType {
   currentAccount: WalletAccount | null;
   walletAddress: string | undefined;
@@ -24,9 +25,11 @@ export enum SupportedWallets {
 }
 
 /**
- * Smart Object Context Type
- * @category Types */
+ * Smart object context: assembly, owner, loading, error, and refetch.
+ * @category Types
+ */
 export interface SmartObjectContextType {
+  tenant: string;
   assembly: AssemblyType<Assemblies> | null;
   assemblyOwner: DetailedSmartCharacterResponse | null;
   loading: boolean;

package/types/sponsoredTransaction.ts

@@ -12,7 +12,9 @@ import { Assemblies } from "./types";
 export enum SponsoredTransactionActions {
   BRING_ONLINE = "online",
   BRING_OFFLINE = "offline",
+  /** @deprecated Use UPDATE_METADATA instead */
   EDIT_UNIT = "edit-unit",
+  UPDATE_METADATA = "update-metadata",
   LINK_SMART_GATE = "link-smart-gate",
   UNLINK_SMART_GATE = "unlink-smart-gate",
 }
@@ -60,3 +62,9 @@ export const ASSEMBLY_TYPE_API_STRING: Record<Assemblies, string> = {
 /** API slug for assembly type in sponsored transaction payloads (e.g. "storage-units"). */
 export type SponsoredTransactionAssemblyType =
   (typeof ASSEMBLY_TYPE_API_STRING)[Assemblies];
+
+export interface SponsoredTransactionMetadata {
+  name?: string;
+  description?: string;
+  url?: string;
+}

package/types/types.ts

@@ -1,3 +1,4 @@
+import { SUI_GRAPHQL_NETWORKS } from "../utils";
 import {
   DetailedAssemblyResponse,
   StorageModule,
@@ -18,6 +19,9 @@ export enum QueryParams {
   TENANT = "tenant",
 }
 
+/** @category Types */
+export type SuiGraphqlNetwork = (typeof SUI_GRAPHQL_NETWORKS)[number];
+
 // =========================================
 // Assembly State and Actions
 // =========================================

package/utils/__tests__/datahub.test.ts

@@ -0,0 +1,48 @@
+import { describe, expect, it } from "vitest";
+import { resolveTenantFromSearch, resolveDatahubHost } from "../datahub";
+import { DATAHUB_BY_TENANT, DEFAULT_TENANT } from "../constants";
+import { QueryParams } from "../../types";
+
+const DEFAULT_HOST = DATAHUB_BY_TENANT[DEFAULT_TENANT];
+
+describe("resolveTenantFromSearch (tenant resolution)", () => {
+  it("returns DEFAULT_TENANT when search is empty", () => {
+    expect(resolveTenantFromSearch("")).toBe(DEFAULT_TENANT);
+  });
+
+  it("returns DEFAULT_TENANT when tenant param is missing", () => {
+    expect(resolveTenantFromSearch("?itemId=123")).toBe(DEFAULT_TENANT);
+  });
+
+  it("returns DEFAULT_TENANT when tenant param is blank (?tenant=)", () => {
+    expect(resolveTenantFromSearch("?tenant=")).toBe(DEFAULT_TENANT);
+  });
+
+  it("trims tenant value (surrounding spaces)", () => {
+    expect(resolveTenantFromSearch("?tenant=  stillness  ")).toBe("stillness");
+    expect(resolveTenantFromSearch("?tenant=nebula  ")).toBe("nebula");
+  });
+
+  it("returns trimmed known tenant from param", () => {
+    expect(resolveTenantFromSearch(`?${QueryParams.TENANT}=nebula`)).toBe(
+      "nebula",
+    );
+    expect(resolveTenantFromSearch(`?${QueryParams.TENANT}=utopia`)).toBe(
+      "utopia",
+    );
+  });
+});
+
+describe("resolveDatahubHost (host fallback)", () => {
+  it("returns DEFAULT_TENANT host for unknown tenant", () => {
+    expect(resolveDatahubHost("unknown-tenant")).toBe(DEFAULT_HOST);
+    expect(resolveDatahubHost("")).toBe(DEFAULT_HOST);
+  });
+
+  it("returns known host for valid tenant keys", () => {
+    expect(resolveDatahubHost("stillness")).toBe(DATAHUB_BY_TENANT.stillness);
+    expect(resolveDatahubHost("nebula")).toBe(DATAHUB_BY_TENANT.nebula);
+    expect(resolveDatahubHost("utopia")).toBe(DATAHUB_BY_TENANT.utopia);
+    expect(resolveDatahubHost("testevenet")).toBe(DATAHUB_BY_TENANT.testevenet);
+  });
+});

package/utils/__tests__/mapping.test.ts

@@ -8,7 +8,6 @@ import { getObjectRegistryType } from "../constants";
 // Mock env vars for testing
 const TEST_EVE_WORLD_PACKAGE_ID =
   "0x2ff3e06b96eb830bdcffbc6cae9b8fe43f005c3b94cef05d9ec23057df16f107";
-const TEST_SUI_GRAPHQL_ENDPOINT = "https://graphql.testnet.sui.io/graphql";
 
 // Mock the GraphQL client (only for getObjectId/getRegistryAddress tests)
 vi.mock("../../graphql/client", () => ({
@@ -22,7 +21,6 @@ describe("mapping utilities", () => {
     vi.clearAllMocks();
     // Stub environment variables for tests
     vi.stubEnv("VITE_EVE_WORLD_PACKAGE_ID", TEST_EVE_WORLD_PACKAGE_ID);
-    vi.stubEnv("VITE_SUI_GRAPHQL_ENDPOINT", TEST_SUI_GRAPHQL_ENDPOINT);
   });
 
   afterEach(() => {

package/utils/burnRate.ts

@@ -18,7 +18,7 @@ export interface AdjustedBurnRate {
  * @param rawBurnTimeMs - Milliseconds to burn one unit at 100% efficiency. If non-finite or negative, treated as 0 so both returned fields are finite and consistent.
  * @param efficiencyPercent - Efficiency as percentage on a 0–100 scale (e.g. 90 for 90%). Values outside [0, 100] are treated as invalid; when null/undefined, not finite, ≤0, or >100, raw is used as-is for burn time.
  * @returns { burnTimePerUnitMs, unitsPerHour }
- * @category Utilities
+ * @category Utilities - Formatting
  */
 export function getAdjustedBurnRate(
   rawBurnTimeMs: number,

package/utils/config.ts

@@ -52,7 +52,7 @@ function parseConfig(
  * caches the result, and returns the map of type_id -> energy usage.
  * Subsequent calls return the cached map.
  *
- * @category Utilities
+ * @category Utilities - Config
  */
 export async function getEnergyConfig(): Promise<Record<number, number>> {
   if (energyConfigCache) {
@@ -88,7 +88,7 @@ export async function getEnergyConfig(): Promise<Record<number, number>> {
  * caches the result, and returns the map of type_id -> fuel efficiency.
  * Subsequent calls return the cached map.
  *
- * @category Utilities
+ * @category Utilities - Config
  */
 export async function getFuelEfficiencyConfig(): Promise<
   Record<number, number>
@@ -127,7 +127,7 @@ export async function getFuelEfficiencyConfig(): Promise<
  *
  * @param typeId - In-game type ID (e.g. from rawData.type_id)
  * @returns Energy usage (e.g. energy_constant), or 0 if not found or not yet loaded
- * @category Utilities
+ * @category Utilities - Config
  */
 export async function getEnergyUsageForType(typeId: number): Promise<number> {
   const config = await getEnergyConfig();
@@ -141,7 +141,7 @@ export async function getEnergyUsageForType(typeId: number): Promise<number> {
  *
  * @param typeId - In-game type ID (e.g. from rawData.type_id)
  * @returns Fuel efficiency (e.g. fuel_efficiency), or 0 if not found or not yet loaded
- * @category Utilities
+ * @category Utilities - Config
  */
 export async function getFuelEfficiencyForType(
   typeId: number,

package/utils/constants.ts

@@ -2,6 +2,8 @@
 // Environment Variable Helpers
 // ============================================================================
 
+import { SuiGraphqlNetwork } from "../types";
+
 /**
  * Get a required environment variable, throwing if not set.
  * @param name - The environment variable name (e.g., "VITE_SUI_GRAPHQL_ENDPOINT")
@@ -22,68 +24,85 @@ function getEnvVar(name: string): string {
 // Environment-Based Configuration
 // ============================================================================
 
+function isSuiGraphqlNetwork(value: string): value is SuiGraphqlNetwork {
+  return SUI_GRAPHQL_NETWORKS.includes(value as SuiGraphqlNetwork);
+}
+
 /**
- * Get the Sui GraphQL endpoint URL from environment.
+ * Get the Sui GraphQL endpoint URL for the given network.
+ * Unknown values fall back to testnet to avoid returning undefined.
+ * @param env - Network identifier (testnet, devnet, mainnet). Defaults to testnet.
  * @returns The GraphQL endpoint URL
- * @throws {Error} If VITE_SUI_GRAPHQL_ENDPOINT is not set
- * @category Utilities
+ * @category Utilities - Config
  */
-export const getSuiGraphqlEndpoint = (): string =>
-  getEnvVar("VITE_SUI_GRAPHQL_ENDPOINT");
+export function getSuiGraphqlEndpoint(
+  env: string = DEFAULT_GRAPHQL_NETWORK,
+): string {
+  const network = isSuiGraphqlNetwork(env) ? env : DEFAULT_GRAPHQL_NETWORK;
+  return GRAPHQL_ENDPOINTS[network];
+}
 
 /**
  * Get the EVE World package ID from environment.
  * @returns The package ID (0x-prefixed address)
  * @throws {Error} If VITE_EVE_WORLD_PACKAGE_ID is not set
- * @category Utilities
+ * @category Utilities - Config
  */
 export const getEveWorldPackageId = (): string =>
   getEnvVar("VITE_EVE_WORLD_PACKAGE_ID");
 
-/**
- * Get the Character OwnerCap type string (derived from package ID).
- * @returns The fully qualified type string for Character OwnerCap
- * @category Utilities
- */
+/** Type string for Character OwnerCap from the EVE World package. @category Utilities - Config */
 export const getCharacterOwnerCapType = (): string => {
   const pkg = getEveWorldPackageId();
   return `${pkg}::access::OwnerCap<${pkg}::character::Character>`;
 };
 
-/**
- * Get the Character PlayerProfile type string (derived from package ID).
- * @returns The fully qualified type string for Character PlayerProfile
- * @category Utilities
- */
+/** Type string for Character PlayerProfile from the EVE World package. @category Utilities - Config */
 export const getCharacterPlayerProfileType = (): string => {
   const pkg = getEveWorldPackageId();
   return `${pkg}::character::PlayerProfile`;
 };
 
-/**
- * Get the ObjectRegistry type string (derived from package ID).
- * @returns The fully qualified type string for ObjectRegistry
- * @category Utilities
- */
+/** Type string for ObjectRegistry from the EVE World package. @category Utilities - Config */
 export const getObjectRegistryType = (): string =>
   `${getEveWorldPackageId()}::object_registry::ObjectRegistry`;
 
-/**
- * Get the EnergyConfig type string (derived from package ID).
- * @returns The fully qualified type string for Energy Config
- * @category Utilities
- */
+/** Type string for EnergyConfig from the EVE World package. @category Utilities - Config */
 export const getEnergyConfigType = (): string =>
   `${getEveWorldPackageId()}::energy::EnergyConfig`;
 
-/**
- * Get the Fuel Efficiency Config type string (derived from package ID).
- * @returns The fully qualified type string for Fuel Efficiency Config
- * @category Utilities
- */
+/** Type string for FuelConfig from the EVE World package. @category Utilities - Config */
 export const getFuelEfficiencyConfigType = (): string =>
   `${getEveWorldPackageId()}::fuel::FuelConfig`;
 
+// ============================================================================
+// Constants
+// ============================================================================
+
+/** Default Sui network for GraphQL endpoint selection.
+ *  @category Constants
+ */
+export const DEFAULT_GRAPHQL_NETWORK: SuiGraphqlNetwork = "testnet";
+
+/** Tenant when not provided via URL ?tenant= (e.g. dev/default chain).
+ *  @category Constants
+ */
+export const DEFAULT_TENANT = "stillness";
+
+/** Allowed Sui network identifiers for GraphQL endpoint selection.
+ *  @category Constants
+ */
+export const SUI_GRAPHQL_NETWORKS = ["testnet", "devnet", "mainnet"] as const;
+
+/** GraphQL endpoint URLs for each Sui network.
+ *  @category Constants
+ */
+export const GRAPHQL_ENDPOINTS: Record<SuiGraphqlNetwork, string> = {
+  testnet: "https://graphql.testnet.sui.io/graphql",
+  devnet: "https://graphql.devnet.sui.io/graphql",
+  mainnet: "https://graphql.mainnet.sui.io/graphql",
+};
+
 /** Polling interval in milliseconds (10 seconds).
  *  @category Constants
  */
@@ -128,3 +147,79 @@ export const EXCLUDED_TYPEIDS = [
  *  @category Constants
  */
 export const ONE_M3 = 1000000000000000000;
+
+export type TenantId = "utopia" | "stillness" | "testevenet" | "nebula";
+
+/** Per-tenant config: EVE token package ID (Sui) and Datahub API host. v0.0.18
+ * @category Constants
+ */
+export interface TenantConfig {
+  packageId: string;
+  datahubHost: string;
+}
+
+/** Single source of truth for the four tenants (package ID + datahub host).
+ * @category Constants
+ */
+export const TENANT_CONFIG: Record<TenantId, TenantConfig> = {
+  nebula: {
+    packageId:
+      "0x353988e063b4683580e3603dbe9e91fefd8f6a06263a646d43fd3a2f3ef6b8c1",
+    datahubHost: "world-api-nebula.test.evefrontier.tech",
+  },
+  testevenet: {
+    packageId:
+      "0x353988e063b4683580e3603dbe9e91fefd8f6a06263a646d43fd3a2f3ef6b8c1",
+    datahubHost: "world-api-testevenet.test.evefrontier.tech",
+  },
+  utopia: {
+    packageId:
+      "0xd12a70c74c1e759445d6f209b01d43d860e97fcf2ef72ccbbd00afd828043f75",
+    datahubHost: "world-api-utopia.uat.pub.evefrontier.com",
+  },
+  stillness: {
+    packageId:
+      "0x28b497559d65ab320d9da4613bf2498d5946b2c0ae3597ccfda3072ce127448c",
+    datahubHost: "world-api-stillness.live.tech.evefrontier.com",
+  },
+};
+
+/** EVE token package ID per tenant (derived from TENANT_CONFIG).
+ * @category Constants
+ */
+export const EVE_PACKAGE_ID_BY_TENANT = Object.fromEntries(
+  (Object.entries(TENANT_CONFIG) as [TenantId, TenantConfig][]).map(
+    ([id, config]) => [id, config.packageId],
+  ),
+) as Record<TenantId, string>;
+
+/** Datahub API host per tenant (derived from TENANT_CONFIG).
+ * @category Constants
+ */
+export const DATAHUB_BY_TENANT = Object.fromEntries(
+  (Object.entries(TENANT_CONFIG) as [TenantId, TenantConfig][]).map(
+    ([id, config]) => [id, config.datahubHost],
+  ),
+) as Record<TenantId, string>;
+
+/** @category Constants */
+const EVE_COIN_TYPE_SUFFIX = "::EVE::EVE";
+
+/**
+ * Returns the EVE token coin type for the given tenant.
+ * Format: `{packageId}::EVE::EVE` (Sui Move type used by RPC/GraphQL).
+ * @param tenantId - The tenant identifier (e.g., "utopia", "stillness")
+ * @returns The fully qualified EVE coin type string
+ *
+ * @category Utilities - Config
+ */
+export function getEveCoinType(tenantId: TenantId): string {
+  return `${EVE_PACKAGE_ID_BY_TENANT[tenantId]}${EVE_COIN_TYPE_SUFFIX}`;
+}
+
+/** Known EVE coin types (one per tenant) for strict matching.
+ *  @category Constants
+ */
+export const KNOWN_EVE_COIN_TYPES = new Set(
+  (Object.keys(EVE_PACKAGE_ID_BY_TENANT) as TenantId[]).map(getEveCoinType),
+);

package/utils/datahub.ts

@@ -1,4 +1,28 @@
-import { DatahubGameInfo } from "../types";
+import { DATAHUB_BY_TENANT, DEFAULT_TENANT } from "./constants";
+import { DatahubGameInfo, QueryParams } from "../types";
+
+/**
+ * Resolves tenant from a URL search string (e.g. window.location.search).
+ * Trims the param value and falls back to DEFAULT_TENANT when missing or blank.
+ * @internal
+ */
+export function resolveTenantFromSearch(search: string): string {
+  const tenant =
+    new URLSearchParams(search).get(QueryParams.TENANT)?.trim() ||
+    DEFAULT_TENANT;
+  return tenant;
+}
+
+/**
+ * Resolves the datahub host for a tenant key. Falls back to DEFAULT_TENANT host for unknown tenants.
+ * @internal
+ */
+export function resolveDatahubHost(tenant: string): string {
+  return (
+    DATAHUB_BY_TENANT[tenant as keyof typeof DATAHUB_BY_TENANT] ??
+    DATAHUB_BY_TENANT[DEFAULT_TENANT]
+  );
+}
 
 /**
  * Fetch game type information from the EVE Frontier Datahub API.
@@ -7,7 +31,9 @@ import { DatahubGameInfo } from "../types";
  * description, icon URL, and physical properties. This data is used to
  * enrich on-chain objects with human-readable information.
  *
- * @category Utilities
+ * Resolves tenant from the window.location.search param.
+ *
+ * @category Utilities - Config
  * @param typeId - The numeric type ID (from on-chain type_id field)
  * @returns Promise resolving to the type's game info
  *
@@ -29,9 +55,10 @@ import { DatahubGameInfo } from "../types";
 export async function getDatahubGameInfo(
   typeId: number,
 ): Promise<DatahubGameInfo> {
-  const response = await fetch(
-    `https://world-api-stillness.live.tech.evefrontier.com/v2/types/${typeId}`,
-  );
+  const tenant = resolveTenantFromSearch(window.location.search);
+  const host = resolveDatahubHost(tenant);
+
+  const response = await fetch(`https://${host}/v2/types/${typeId}`);
   const data = await response.json();
 
   return data;

package/utils/errors.ts

@@ -6,7 +6,7 @@ export type ErrorType = {
   message: string;
 };
 
-/** @category Utilities */
+/** @category Utilities - Error helpers */
 export const ERRORS: Record<number | string, ErrorType> = {
   1001: {
     code: 1001,
@@ -144,7 +144,7 @@ export const ERROR_MESSAGES: Record<number, string> = Object.fromEntries(
     .map(([key, value]) => [Number(key), value.message]),
 );
 
-/** @category Utilities */
+/** @category Utilities - Error helpers */
 export const parseErrorFromMessage = (
   errorMessage: string,
 ): {

package/utils/mapping.ts

@@ -7,7 +7,7 @@ import { getSingletonObjectByType } from "../graphql/client";
 /**
  * Convert raw status variant string to State enum
  *
- * @category Utilities
+ * @category Utilities - Mapping
  */
 export function parseStatus(statusVariant: string | undefined): State {
   if (!statusVariant) return State.NULL;
@@ -33,7 +33,7 @@ export function parseStatus(statusVariant: string | undefined): State {
  * @param typeRepr - The Move object type tag
  * @returns The assembly type as an enum
  *
- * @category Utilities
+ * @category Utilities - Mapping
  */
 export function getAssemblyType(typeRepr: string): Assemblies {
   if (typeRepr.includes("::storage_unit::StorageUnit")) {
@@ -68,7 +68,7 @@ let objectRegistryAddress: string | null = null;
  * Fetches the AssemblyRegistry singleton address from the chain
  * Caches the result to avoid repeated queries
  *
- * @category Utilities
+ * @category Utilities - Mapping
  */
 export async function getRegistryAddress(): Promise<string> {
   if (objectRegistryAddress) {
@@ -92,7 +92,7 @@ export async function getRegistryAddress(): Promise<string> {
  * @param itemId - The in-game item ID
  * @returns The derived Sui object ID
  *
- * @category Utilities
+ * @category Utilities - Mapping
  */
 export async function getObjectId(
   itemId: string,

package/utils/transforms.ts

@@ -21,7 +21,7 @@ import { getObjectWithJson } from "../graphql";
 /**
  * Transform CharacterInfo to DetailedSmartCharacterResponse
  *
- * @category Utilities
+ * @category Utilities - Transforms
  */
 export function transformToCharacter(
   characterInfo: CharacterInfo,
@@ -57,7 +57,7 @@ export interface TransformOptions {
  * @param moveObject - The Move object data from GraphQL
  * @param options - Optional transform options including character info
  *
- * @category Utilities
+ * @category Utilities - Transforms
  */
 export async function transformToAssembly(
   objectId: string,