@evefrontier/dapp-kit 0.1.2 → 0.1.5

package/README.md

@@ -44,6 +44,19 @@ function MyDapp() {
 
 Configure assembly via env (`VITE_OBJECT_ID`, as Sui Object ID) or URL (`?itemId=...&tenant=...`, derived).
 
+Install the package once; then import only what you need via subpaths.
+
+| Subpath | Use when you need |
+|--------|--------------------|
+| `@evefrontier/dapp-kit` | Default: providers, hooks, types, utils |
+| `@evefrontier/dapp-kit/graphql` | GraphQL client, queries, and response types |
+| `@evefrontier/dapp-kit/types` | Type definitions only |
+| `@evefrontier/dapp-kit/utils` | Utilities (parsing, transforms, config) |
+| `@evefrontier/dapp-kit/hooks` | Hooks only |
+| `@evefrontier/dapp-kit/providers` | Providers only |
+| `@evefrontier/dapp-kit/config` | Config / dApp kit setup |
+  
+
 ## More
 
 Hooks, types, GraphQL helpers, utilities, and wallet APIs are documented at **[http://sui-docs.evefrontier.com/](http://sui-docs.evefrontier.com/)**.

package/graphql/client.ts

@@ -1,5 +1,6 @@
 import {
   getCharacterOwnerCapType,
+  getCharacterPlayerProfileType,
   getSuiGraphqlEndpoint,
 } from "../utils/constants";
 import type {
@@ -13,12 +14,15 @@ import type {
   GetObjectsByTypeResponse,
   GetObjectResponse,
   GetObjectWithJsonResponse,
-  RawCharacterData,
   CharacterInfo,
   GetObjectAndCharacterOwnerResponse,
   DynamicFieldNode,
   RawSuiObjectData,
+  GetSingletonConfigObjectByTypeResponse,
+  GetWalletCharactersResponse,
+  GetCharacterAndOwnedObjectsResponse,
 } from "./types";
+import { parseCharacterFromJson } from "../utils/character";
 import {
   GET_OBJECT_BY_ADDRESS,
   GET_OBJECT_WITH_DYNAMIC_FIELDS,
@@ -27,9 +31,12 @@ import {
   GET_OBJECT_OWNER_AND_OWNED_OBJECTS_WITH_JSON,
   GET_OWNED_OBJECTS_BY_TYPE,
   GET_OWNED_OBJECTS_BY_PACKAGE,
+  GET_WALLET_CHARACTERS,
+  GET_CHARACTER_AND_OWNED_OBJECTS,
   GET_SINGLETON_OBJECT_BY_TYPE,
   GET_OBJECTS_BY_TYPE,
   GET_OBJECT_WITH_JSON,
+  GET_SINGLETON_CONFIG_OBJECT_BY_TYPE,
 } from "./queries";
 
 /**
@@ -301,6 +308,38 @@ export async function getOwnedObjectsByPackage(
   );
 }
 
+/**
+ * Get all characters owned by a wallet
+ * Returns the most recent character owned by the wallet
+ *
+ * @category GraphQL
+ */
+export async function getWalletCharacters(wallet: string) {
+  return executeGraphQLQuery<GetWalletCharactersResponse>(
+    GET_WALLET_CHARACTERS,
+    {
+      owner: wallet,
+      characterPlayerProfileType: getCharacterPlayerProfileType(),
+    },
+  );
+}
+
+/**
+ * Get all characters owned by a wallet
+ * Returns the characters owned by the wallet
+ *
+ * @category GraphQL
+ */
+export async function getCharacterAndOwnedObjects(wallet: string) {
+  return executeGraphQLQuery<GetCharacterAndOwnedObjectsResponse>(
+    GET_CHARACTER_AND_OWNED_OBJECTS,
+    {
+      owner: wallet,
+      characterPlayerProfileType: getCharacterPlayerProfileType(),
+    },
+  );
+}
+
 /**
  * Get a singleton object by its Move type.
  *
@@ -326,6 +365,37 @@ export async function getSingletonObjectByType(objectType: string) {
   );
 }
 
+/**
+ * Get a singleton config object by its Move type and table name, with dynamic fields.
+ *
+ * Used for on-chain config singletons (e.g. EnergyConfig, FuelConfig) that expose
+ * a table of key/value entries via dynamic fields. Returns the first object's full
+ * response including contents.extract...addressAt.dynamicFields.nodes.
+ *
+ * @category GraphQL
+ * @param objectType - The full Move type string (e.g. from getEnergyConfigType())
+ * @param tableName - The table path for extract (e.g. "assembly_energy", "fuel_efficiency")
+ * @returns Promise resolving to the GraphQL response with objects.nodes[0] and dynamicFields.nodes
+ *
+ * @example
+ * ```typescript
+ * const result = await getSingletonConfigObjectByType(getEnergyConfigType(), "assembly_energy");
+ * const nodes = result.data?.objects?.nodes[0]?.asMoveObject?.contents?.extract?.extract?.asAddress?.addressAt?.dynamicFields?.nodes;
+ * ```
+ */
+export async function getSingletonConfigObjectByType(
+  objectType: string,
+  tableName: string,
+) {
+  return executeGraphQLQuery<GetSingletonConfigObjectByTypeResponse>(
+    GET_SINGLETON_CONFIG_OBJECT_BY_TYPE,
+    {
+      object_type: objectType,
+      table_name: tableName,
+    },
+  );
+}
+
 /**
  * Get all objects of a specific type with pagination.
  *
@@ -413,15 +483,21 @@ export async function getAssemblyWithOwner(assemblyId: string): Promise<{
       nodes: DynamicFieldNode[];
     };
   } | null;
-  character: CharacterInfo | null;
+  assemblyOwner: CharacterInfo | null;
   energySource: RawSuiObjectData | null;
+  destinationGate: RawSuiObjectData | null;
 }> {
   try {
     const result = await getObjectAndCharacterOwner(assemblyId);
 
     if (!result.data?.object?.asMoveObject) {
       console.warn("[DappKit] getAssemblyWithOwner: Assembly not found");
-      return { moveObject: null, character: null, energySource: null };
+      return {
+        moveObject: null,
+        assemblyOwner: null,
+        energySource: null,
+        destinationGate: null,
+      };
     }
 
     const moveObject = result.data.object.asMoveObject;
@@ -440,30 +516,15 @@ export async function getAssemblyWithOwner(assemblyId: string): Promise<{
       console.warn("[DappKit] getAssemblyWithOwner: Character not found");
       return {
         moveObject: result.data?.object?.asMoveObject,
-        character: null,
+        assemblyOwner: null,
         energySource: null,
+        destinationGate: null,
       };
     }
 
     const characterJson = characterMoveObject?.contents.json;
-
-    if (characterJson) {
-      const rawCharacter = characterJson as RawCharacterData;
-      characterInfo = {
-        id: rawCharacter.id || "",
-        address: characterJson.character_address || "",
-        name: rawCharacter.metadata.name || "",
-        tribeId:
-          typeof rawCharacter.tribe_id === "string"
-            ? parseInt(rawCharacter.tribe_id, 10)
-            : (rawCharacter.tribe_id as number) || 0,
-        characterId:
-          typeof rawCharacter.key.item_id === "string"
-            ? parseInt(rawCharacter.key.item_id, 10)
-            : (rawCharacter.key.item_id as number) || 0,
-        _raw: rawCharacter,
-      };
-    } else {
+    characterInfo = parseCharacterFromJson(characterJson);
+    if (!characterInfo) {
       console.warn(
         "[DappKit] getAssemblyWithOwner: Could not extract character JSON from owner chain",
       );
@@ -476,8 +537,13 @@ export async function getAssemblyWithOwner(assemblyId: string): Promise<{
       console.warn("[DappKit] getAssemblyWithOwner: Energy source not found");
     }
 
+    const destinationGateMoveObject =
+      moveObject.contents.destinationGate?.asAddress?.asObject?.asMoveObject;
+
     const energySourceJson = energySourceMoveObject?.contents
       ?.json as unknown as RawSuiObjectData | null;
+    const destinationGateJson = destinationGateMoveObject?.contents
+      ?.json as unknown as RawSuiObjectData | null;
 
     if (!energySourceJson) {
       console.warn(
@@ -493,11 +559,17 @@ export async function getAssemblyWithOwner(assemblyId: string): Promise<{
         },
         dynamicFields: dynamicFields || undefined,
       },
-      character: characterInfo,
+      assemblyOwner: characterInfo,
       energySource: energySourceJson ?? null,
+      destinationGate: destinationGateJson ?? null,
     };
   } catch (error) {
     console.error("[DappKit] getAssemblyWithOwner error:", error);
-    return { moveObject: null, character: null, energySource: null };
+    return {
+      moveObject: null,
+      assemblyOwner: null,
+      energySource: null,
+      destinationGate: null,
+    };
   }
 }

package/graphql/index.ts

@@ -12,7 +12,9 @@ export {
   getSingletonObjectByType,
   getObjectsByType,
   // Character/owner resolution
+  getWalletCharacters,
   getAssemblyWithOwner,
+  getCharacterAndOwnedObjects,
 } from "./client";
 
 // Query Strings
@@ -26,48 +28,12 @@ export {
   GET_OBJECT_OWNER_AND_OWNED_OBJECTS_WITH_JSON,
   GET_OWNED_OBJECTS_BY_TYPE,
   GET_OWNED_OBJECTS_BY_PACKAGE,
+  GET_WALLET_CHARACTERS,
   // Singleton & type-based queries
   GET_SINGLETON_OBJECT_BY_TYPE,
+  GET_SINGLETON_CONFIG_OBJECT_BY_TYPE,
   GET_OBJECTS_BY_TYPE,
 } from "./queries";
 
 // Types
-export type {
-  // Base types
-  GraphQLResponse,
-  PageInfo,
-  // Move object types
-  MoveObjectContents,
-  DynamicFieldNode,
-  MoveObjectData,
-  // Object response types
-  SuiObjectResponse,
-  GetObjectResponse,
-  // GetObjectByAddress types
-  GetObjectByAddressResponse,
-  // GetObjectWithJson types
-  GetObjectWithJsonResponse,
-  // Owner & owned objects types
-  OwnedObjectNode,
-  AddressOwner,
-  GetObjectOwnerAndOwnedObjectsResponse,
-  // Owner & owned objects with JSON types
-  OwnedObjectNodeWithJson,
-  AddressOwnerWithJson,
-  GetObjectOwnerAndOwnedObjectsWithJsonResponse,
-  // GetOwnedObjectsByType types
-  OwnedObjectAddressNode,
-  GetOwnedObjectsByTypeResponse,
-  // GetOwnedObjectsByPackage types
-  OwnedObjectFullNode,
-  GetOwnedObjectsByPackageResponse,
-  // Singleton & type-based types
-  GetSingletonObjectByTypeResponse,
-  ObjectWithContentsNode,
-  GetObjectsByTypeResponse,
-  // EVE Frontier specific types
-  RawSuiObjectData,
-  OwnerCapData,
-  RawCharacterData,
-  CharacterInfo,
-} from "./types";
+export * from "./types";

package/graphql/queries.ts

@@ -73,7 +73,7 @@ export const GET_OBJECT_WITH_DYNAMIC_FIELDS = `
  * @category GraphQL
  */
 export const GET_OBJECT_DYNAMICFIELD_CHARACTER_WITH_JSON = `
-query GetObjectOwnerCharacterOwnerAndInventory0(
+query GetObjectOwnerCharacterOwnerAndInventory(
   $objectId: SuiAddress!
   $characterOwnerType: String!
 ) {
@@ -122,6 +122,15 @@ query GetObjectOwnerCharacterOwnerAndInventory0(
             }
           }
         }
+        destinationGate: extract(path: "linked_gate_id") {
+          asAddress {
+            asObject {
+              asMoveObject {
+                contents { bcs json }
+              }
+            }
+          }
+        }
       }
       dynamicFields {
           nodes {
@@ -319,6 +328,110 @@ export const GET_OWNED_OBJECTS_BY_PACKAGE = `
   }
 `;
 
+// ============================================================================
+// Character Queries
+// ============================================================================
+
+/**
+ * Query to get all characters owned by a wallet
+ * Returns the characters owned by the wallet
+ *
+ * @category GraphQL
+ */
+export const GET_WALLET_CHARACTERS = `
+  query GetWalletCharacters($owner: SuiAddress!, $characterPlayerProfileType: String!) {
+    address(
+        address: $owner
+    ) {
+        objects(
+            last: 1
+            filter: {
+                type: $characterPlayerProfileType
+            }
+        ) {
+            nodes {
+                contents {
+                    extract(path: "character_id") {
+                        asAddress {
+                            asObject {
+                                asMoveObject {
+                                    contents {
+                                        type {
+                                            repr
+                                        }
+                                        json
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+`;
+
+/**
+ * Query to get character owned by a wallet and objects owned by the character
+ * Returns the character and objects owned by the character
+ *
+ * @category GraphQL
+ */
+export const GET_CHARACTER_AND_OWNED_OBJECTS = `
+query GetCharacterAndOwnedObjects($owner: SuiAddress!, $characterPlayerProfileType: String!) {
+    address(
+        address: $owner
+    ) {
+        objects(
+            last: 1
+            filter: {
+                type: $characterPlayerProfileType
+            }
+        ) {
+            nodes {
+                contents {
+                    extract(path: "character_id") {
+                        asAddress {
+                            asObject {
+                                asMoveObject {
+                                    contents {
+                                        type {
+                                            repr
+                                        }
+                                        json
+                                    }
+                                }
+                            }
+                            objects {
+                                nodes {
+                                    contents {
+                                        extract(path: "authorized_object_id") {
+                                            asAddress {
+                                                asObject {
+                                                    asMoveObject {
+                                                        contents {
+                                                            type {
+                                                                repr
+                                                            }
+                                                            json
+                                                        }
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+`;
+
 // ============================================================================
 // Singleton & Type-based Queries
 // ============================================================================
@@ -344,6 +457,49 @@ export const GET_SINGLETON_OBJECT_BY_TYPE = `
   }
 `;
 
+/**
+ * Query to get a singleton config object by its type
+ *
+ * @category GraphQL
+ */
+export const GET_SINGLETON_CONFIG_OBJECT_BY_TYPE = `
+  query GetSingletonConfigObjectByType($object_type: String!, $table_name: String!) {
+    objects(filter: { type: $object_type }, first: 1) {
+        nodes {
+            address
+            asMoveObject {
+                contents {
+                    extract(path: $table_name) {
+                        extract(path: "id") {
+                            asAddress {
+                                addressAt {
+                                    dynamicFields {
+                                        pageInfo {
+                                            hasNextPage
+                                            endCursor
+                                        }
+                                        nodes {
+                                            key: name {
+                                                json
+                                            }
+                                            value: value {
+                                                ... on MoveValue {
+                                                    json
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+`;
+
 /**
  * Query to get all objects of a specific type (global search)
  * Use with caution - may return many results