@0xobelisk/graphql-client 1.2.0-pre.124 → 1.2.0-pre.125

package/dist/types.d.ts

@@ -118,6 +118,48 @@ export interface DubheUserStorageRow {
     lastUpdateDigest: string;
     lastEventSeq: string;
 }
+export interface SceneStorageRow {
+    sceneId: string;
+    dappKey: string;
+    sceneType: string;
+    sceneTypeRaw: string;
+    authorizationKind?: string | null;
+    authorizationKindRaw?: string | null;
+    authorizedPermitId?: string | null;
+    isDestroyed: boolean;
+    createdAtCheckpoint: string;
+    destroyedAtCheckpoint?: string | null;
+    updatedAtCheckpoint: string;
+    lastUpdateDigest: string;
+    lastEventSeq: string;
+}
+export interface SceneStorageFieldRow {
+    sceneId: string;
+    fieldNameRaw: string;
+    dappKey: string;
+    sceneType: string;
+    sceneTypeRaw: string;
+    fieldName: string;
+    fieldValueRaw?: string | null;
+    isDeleted: boolean;
+    deletedAtCheckpoint?: string | null;
+    updatedAtCheckpoint: string;
+    lastUpdateDigest: string;
+    lastEventSeq: string;
+}
+export interface ObjectStorageRow {
+    objectId: string;
+    dappKey: string;
+    objectType: string;
+    objectTypeRaw: string;
+    entityIdRaw: string;
+    isDestroyed: boolean;
+    createdAtCheckpoint: string;
+    destroyedAtCheckpoint?: string | null;
+    updatedAtCheckpoint: string;
+    lastUpdateDigest: string;
+    lastEventSeq: string;
+}
 export interface DubheDappRuntimeStateRow {
     dappKey: string;
     admin?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xobelisk/graphql-client",
-  "version": "1.2.0-pre.124",
+  "version": "1.2.0-pre.125",
   "description": "Tookit for interacting with dubhe graphql client",
   "keywords": [
     "sui",

package/src/client.ts

@@ -122,7 +122,10 @@ import {
   MarketplaceListingRow,
   DubheSessionRow,
   DubheUserStorageRow,
-  DubheDappRuntimeStateRow
+  DubheDappRuntimeStateRow,
+  SceneStorageRow,
+  SceneStorageFieldRow,
+  ObjectStorageRow
 } from './types';
 
 // Convert cache policy type
@@ -1208,6 +1211,228 @@ export class DubheGraphqlClient {
     );
   }
 
+  /**
+   * Query SceneStorage system rows indexed by the Dubhe indexer
+   * (scene_storages table, exposed as dubheSceneStorages in GraphQL).
+   * Field values live in the companion scene_storage_fields table —
+   * see getSceneStorageFields.
+   */
+  async getSceneStorages(options?: {
+    dappKey?: string;
+    sceneType?: string;
+    sceneId?: string;
+    isDestroyed?: boolean;
+    first?: number;
+    after?: string;
+  }): Promise<Connection<SceneStorageRow>> {
+    const filter: Record<string, any> = {};
+    if (options?.dappKey) filter.dappKey = { equalTo: options.dappKey };
+    if (options?.sceneType) filter.sceneType = { equalTo: options.sceneType };
+    if (options?.sceneId) filter.sceneId = { equalTo: options.sceneId };
+    if (options?.isDestroyed !== undefined) filter.isDestroyed = { equalTo: options.isDestroyed };
+
+    const query = gql`
+      query GetSceneStorages(
+        $first: Int
+        $after: Cursor
+        $filter: StoreDubheSceneStorageFilter
+        $orderBy: [StoreDubheSceneStoragesOrderBy!]
+      ) {
+        dubheSceneStorages(first: $first, after: $after, filter: $filter, orderBy: $orderBy) {
+          totalCount
+          pageInfo {
+            hasNextPage
+            hasPreviousPage
+            startCursor
+            endCursor
+          }
+          edges {
+            cursor
+            node {
+              sceneId
+              dappKey
+              sceneType
+              authorizationKind
+              authorizedPermitId
+              isDestroyed
+              createdAtCheckpoint
+              updatedAtCheckpoint
+              lastUpdateDigest
+              lastEventSeq
+            }
+          }
+        }
+      }
+    `;
+
+    const result = await this.apolloClient.query({
+      query,
+      variables: {
+        first: options?.first ?? 100,
+        after: options?.after,
+        filter: Object.keys(filter).length > 0 ? filter : undefined,
+        orderBy: ['UPDATED_AT_CHECKPOINT_DESC']
+      },
+      fetchPolicy: 'network-only'
+    });
+
+    if (result.error) throw result.error;
+    return (
+      (result.data as any)?.dubheSceneStorages ?? {
+        edges: [],
+        pageInfo: { hasNextPage: false, hasPreviousPage: false },
+        totalCount: 0
+      }
+    );
+  }
+
+  /**
+   * Query raw field rows of SceneStorages (scene_storage_fields table,
+   * exposed as dubheSceneStorageFields in GraphQL). Values are hex-encoded
+   * BCS — decode with the decoders exported from this package.
+   */
+  async getSceneStorageFields(options?: {
+    dappKey?: string;
+    sceneIds?: string[];
+    sceneId?: string;
+    fieldName?: string;
+    isDeleted?: boolean;
+    first?: number;
+    after?: string;
+  }): Promise<Connection<SceneStorageFieldRow>> {
+    const filter: Record<string, any> = {};
+    if (options?.dappKey) filter.dappKey = { equalTo: options.dappKey };
+    if (options?.sceneIds && options.sceneIds.length > 0) filter.sceneId = { in: options.sceneIds };
+    if (options?.sceneId) filter.sceneId = { equalTo: options.sceneId };
+    if (options?.fieldName) filter.fieldName = { equalTo: options.fieldName };
+    if (options?.isDeleted !== undefined) filter.isDeleted = { equalTo: options.isDeleted };
+
+    const query = gql`
+      query GetSceneStorageFields(
+        $first: Int
+        $after: Cursor
+        $filter: StoreDubheSceneStorageFieldFilter
+        $orderBy: [StoreDubheSceneStorageFieldsOrderBy!]
+      ) {
+        dubheSceneStorageFields(first: $first, after: $after, filter: $filter, orderBy: $orderBy) {
+          totalCount
+          pageInfo {
+            hasNextPage
+            hasPreviousPage
+            startCursor
+            endCursor
+          }
+          edges {
+            cursor
+            node {
+              sceneId
+              dappKey
+              sceneType
+              fieldName
+              fieldValueRaw
+              isDeleted
+              updatedAtCheckpoint
+              lastUpdateDigest
+              lastEventSeq
+            }
+          }
+        }
+      }
+    `;
+
+    const result = await this.apolloClient.query({
+      query,
+      variables: {
+        first: options?.first ?? 1000,
+        after: options?.after,
+        filter: Object.keys(filter).length > 0 ? filter : undefined,
+        orderBy: ['UPDATED_AT_CHECKPOINT_DESC']
+      },
+      fetchPolicy: 'network-only'
+    });
+
+    if (result.error) throw result.error;
+    return (
+      (result.data as any)?.dubheSceneStorageFields ?? {
+        edges: [],
+        pageInfo: { hasNextPage: false, hasPreviousPage: false },
+        totalCount: 0
+      }
+    );
+  }
+
+  /**
+   * Query ObjectStorage system rows indexed by the Dubhe indexer
+   * (object_storages table, exposed as dubheObjectStorages in GraphQL).
+   */
+  async getObjectStorages(options?: {
+    dappKey?: string;
+    objectType?: string;
+    objectId?: string;
+    isDestroyed?: boolean;
+    first?: number;
+    after?: string;
+  }): Promise<Connection<ObjectStorageRow>> {
+    const filter: Record<string, any> = {};
+    if (options?.dappKey) filter.dappKey = { equalTo: options.dappKey };
+    if (options?.objectType) filter.objectType = { equalTo: options.objectType };
+    if (options?.objectId) filter.objectId = { equalTo: options.objectId };
+    if (options?.isDestroyed !== undefined) filter.isDestroyed = { equalTo: options.isDestroyed };
+
+    const query = gql`
+      query GetObjectStorages(
+        $first: Int
+        $after: Cursor
+        $filter: StoreDubheObjectStorageFilter
+        $orderBy: [StoreDubheObjectStoragesOrderBy!]
+      ) {
+        dubheObjectStorages(first: $first, after: $after, filter: $filter, orderBy: $orderBy) {
+          totalCount
+          pageInfo {
+            hasNextPage
+            hasPreviousPage
+            startCursor
+            endCursor
+          }
+          edges {
+            cursor
+            node {
+              objectId
+              dappKey
+              objectType
+              entityIdRaw
+              isDestroyed
+              createdAtCheckpoint
+              updatedAtCheckpoint
+              lastUpdateDigest
+              lastEventSeq
+            }
+          }
+        }
+      }
+    `;
+
+    const result = await this.apolloClient.query({
+      query,
+      variables: {
+        first: options?.first ?? 100,
+        after: options?.after,
+        filter: Object.keys(filter).length > 0 ? filter : undefined,
+        orderBy: ['UPDATED_AT_CHECKPOINT_DESC']
+      },
+      fetchPolicy: 'network-only'
+    });
+
+    if (result.error) throw result.error;
+    return (
+      (result.data as any)?.dubheObjectStorages ?? {
+        edges: [],
+        pageInfo: { hasNextPage: false, hasPreviousPage: false },
+        totalCount: 0
+      }
+    );
+  }
+
   /**
    * Query DApp runtime state (credit pool, admin, package version, etc.).
    * Exposed as dubheDappRuntimeStates in GraphQL.

package/src/decoders.ts

@@ -0,0 +1,100 @@
+/**
+ * Minimal BCS decoders for indexer raw values.
+ *
+ * The Dubhe indexer stores scene/object field values and marketplace record
+ * data as hex-encoded BCS bytes (e.g. "0x0c00000000000000" for u64 12).
+ * These helpers decode the primitive types commonly stored in system tables.
+ */
+
+export const ZERO_ADDRESS = '0x' + '0'.repeat(64);
+
+export function hexToBytes(hex: string): Uint8Array {
+  const clean = hex.replace(/^0x/i, '');
+  const pairs = clean.match(/../g) ?? [];
+  return Uint8Array.from(pairs.map((b) => parseInt(b, 16)));
+}
+
+function readUIntLE(bytes: Uint8Array, offset: number, width: number): bigint {
+  let n = 0n;
+  for (let i = width - 1; i >= 0; i--) {
+    n = (n << 8n) | BigInt(bytes[offset + i] ?? 0);
+  }
+  return n;
+}
+
+/** Read a ULEB128-encoded length prefix. Returns [value, bytesConsumed]. */
+function readUleb(bytes: Uint8Array, offset: number): [number, number] {
+  let value = 0;
+  let shift = 0;
+  let consumed = 0;
+  for (;;) {
+    const byte = bytes[offset + consumed] ?? 0;
+    value |= (byte & 0x7f) << shift;
+    consumed++;
+    if ((byte & 0x80) === 0) break;
+    shift += 7;
+  }
+  return [value, consumed];
+}
+
+export function decodeU8(hex: string): number {
+  return Number(readUIntLE(hexToBytes(hex), 0, 1));
+}
+
+export function decodeU16(hex: string): number {
+  return Number(readUIntLE(hexToBytes(hex), 0, 2));
+}
+
+export function decodeU32(hex: string): number {
+  return Number(readUIntLE(hexToBytes(hex), 0, 4));
+}
+
+export function decodeU64(hex: string): bigint {
+  return readUIntLE(hexToBytes(hex), 0, 8);
+}
+
+export function decodeU128(hex: string): bigint {
+  return readUIntLE(hexToBytes(hex), 0, 16);
+}
+
+export function decodeBool(hex: string): boolean {
+  return (hexToBytes(hex)[0] ?? 0) !== 0;
+}
+
+export function decodeAddress(hex: string): string {
+  const bytes = hexToBytes(hex);
+  return '0x' + Array.from(bytes.slice(0, 32), (b) => b.toString(16).padStart(2, '0')).join('');
+}
+
+export function decodeVectorAddress(hex: string): string[] {
+  const bytes = hexToBytes(hex);
+  const [len, consumed] = readUleb(bytes, 0);
+  const out: string[] = [];
+  for (let i = 0; i < len; i++) {
+    const start = consumed + i * 32;
+    out.push(
+      '0x' +
+        Array.from(bytes.slice(start, start + 32), (b) => b.toString(16).padStart(2, '0')).join('')
+    );
+  }
+  return out;
+}
+
+/** Decode a BCS ascii/utf8 String (ULEB length prefix + bytes). */
+export function decodeString(hex: string): string {
+  const bytes = hexToBytes(hex);
+  const [len, consumed] = readUleb(bytes, 0);
+  return new TextDecoder().decode(bytes.slice(consumed, consumed + len));
+}
+
+/**
+ * Marketplace recordDataRaw is a JSON array of per-field hex strings
+ * (non-key fields, in schema order).
+ */
+export function parseRecordData(recordDataRaw: string): string[] {
+  try {
+    return JSON.parse(recordDataRaw) as string[];
+  } catch {
+    return [recordDataRaw];
+  }
+}

package/src/index.ts

@@ -1,3 +1,4 @@
 export { DubheGraphqlClient, createDubheGraphqlClient, QueryBuilders } from './client';
 export * from './types';
 export type * from './types';
+export * from './decoders';

package/src/types.ts

@@ -154,6 +154,51 @@ export interface DubheUserStorageRow {
   lastEventSeq: string;
 }
 
+export interface SceneStorageRow {
+  sceneId: string;
+  dappKey: string;
+  sceneType: string;
+  sceneTypeRaw: string;
+  authorizationKind?: string | null;
+  authorizationKindRaw?: string | null;
+  authorizedPermitId?: string | null;
+  isDestroyed: boolean;
+  createdAtCheckpoint: string;
+  destroyedAtCheckpoint?: string | null;
+  updatedAtCheckpoint: string;
+  lastUpdateDigest: string;
+  lastEventSeq: string;
+}
+
+export interface SceneStorageFieldRow {
+  sceneId: string;
+  fieldNameRaw: string;
+  dappKey: string;
+  sceneType: string;
+  sceneTypeRaw: string;
+  fieldName: string;
+  fieldValueRaw?: string | null;
+  isDeleted: boolean;
+  deletedAtCheckpoint?: string | null;
+  updatedAtCheckpoint: string;
+  lastUpdateDigest: string;
+  lastEventSeq: string;
+}
+
+export interface ObjectStorageRow {
+  objectId: string;
+  dappKey: string;
+  objectType: string;
+  objectTypeRaw: string;
+  entityIdRaw: string;
+  isDestroyed: boolean;
+  createdAtCheckpoint: string;
+  destroyedAtCheckpoint?: string | null;
+  updatedAtCheckpoint: string;
+  lastUpdateDigest: string;
+  lastEventSeq: string;
+}
+
 export interface DubheDappRuntimeStateRow {
   dappKey: string;
   admin?: string | null;