@0xobelisk/sui-client 1.0.6 → 1.0.8

package/src/libs/http/ws-adapter.ts

@@ -0,0 +1,36 @@
+export type WebSocketInstance = WebSocket;
+
+export interface WebSocketConstructor {
+  new (url: string): WebSocket;
+}
+
+export function createWebSocketClient(url: string): WebSocketInstance {
+  if (typeof window !== 'undefined') {
+    // Browser Environment
+    return new WebSocket(url);
+  } else {
+    // Node.js Environment
+    try {
+      require.resolve('ws');
+      const WebSocket = require('ws');
+      return new WebSocket(url);
+    } catch (e) {
+      console.error('Failed to load WebSocket implementation:', e);
+      throw new Error(
+        'WebSocket implementation not available. Please install the "ws" package.'
+      );
+    }
+  }
+}
+
+export function isWebSocketSupported(): boolean {
+  if (typeof window !== 'undefined') {
+    return typeof WebSocket !== 'undefined';
+  }
+  try {
+    require.resolve('ws');
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/libs/suiIndexerClient/index.ts

@@ -0,0 +1,232 @@
+import { Http } from '../http';
+
+export interface OrderDirection {
+  ASC: 'ASC';
+  DESC: 'DESC';
+}
+
+export interface OrderBy {
+  field: string;
+  direction: OrderDirection['ASC'] | OrderDirection['DESC'];
+}
+
+export interface PageInfo {
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+  startCursor?: string;
+  endCursor?: string;
+}
+
+export interface Transaction {
+  id: number;
+  checkpoint: number;
+  digest: string;
+  created_at: string;
+}
+
+export interface Schema {
+  id: number;
+  name: string;
+  key1?: string;
+  key2?: string;
+  value: string;
+  last_update_checkpoint: string;
+  last_update_digest: string;
+  is_removed: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface Event {
+  id: number;
+  checkpoint: string;
+  digest: string;
+  name: string;
+  value: string;
+  created_at: string;
+}
+
+export interface ConnectionResponse<T> {
+  edges: Array<{
+    cursor: string;
+    node: T;
+  }>;
+  pageInfo: PageInfo;
+}
+
+export class SuiIndexerClient {
+  private http: Http;
+
+  constructor(http: Http) {
+    this.http = http;
+  }
+
+  private async fetchGraphql<T>(query: string, variables?: any): Promise<T> {
+    return this.http.fetchGraphql({ query, variables });
+  }
+
+  async getTransactions(params?: {
+    first?: number;
+    after?: string;
+    last?: number;
+    before?: string;
+    checkpoint?: number;
+    orderBy?: OrderBy;
+    distinct?: boolean;
+  }) {
+    const query = `
+      query GetTransactions($first: Int, $after: String, $last: Int, $before: String, $checkpoint: Int, $orderBy: TransactionOrderBy, $distinct: Boolean) {
+        transactions(first: $first, after: $after, last: $last, before: $before, checkpoint: $checkpoint, orderBy: $orderBy, distinct: $distinct) {
+          edges {
+            cursor
+            node {
+              id
+              checkpoint
+              digest
+              created_at
+            }
+          }
+          pageInfo {
+            hasNextPage
+            hasPreviousPage
+            startCursor
+            endCursor
+          }
+        }
+      }
+    `;
+
+    const response = await this.fetchGraphql<{
+      transactions: ConnectionResponse<Transaction>;
+    }>(query, params);
+    return response.transactions;
+  }
+
+  async getSchemas(params?: {
+    first?: number;
+    after?: string;
+    last?: number;
+    before?: string;
+    name?: string;
+    key1?: string;
+    key2?: string;
+    orderBy?: OrderBy;
+    distinct?: boolean;
+  }): Promise<ConnectionResponse<Schema>> {
+    const query = `
+      query GetSchemas($first: Int, $after: String, $last: Int, $before: String, $name: String, $key1: String, $key2: String, $orderBy: SchemaOrderBy, $distinct: Boolean) {
+        schemas(first: $first, after: $after, last: $last, before: $before, name: $name, key1: $key1, key2: $key2, orderBy: $orderBy, distinct: $distinct) {
+          edges {
+            cursor
+            node {
+              id
+              name
+              key1
+              key2
+              value
+              last_update_checkpoint
+              last_update_digest
+              is_removed
+              created_at
+              updated_at
+            }
+          }
+          pageInfo {
+            hasNextPage
+            hasPreviousPage
+            startCursor
+            endCursor
+          }
+        }
+      }
+    `;
+
+    const response = await this.fetchGraphql<{
+      schemas: ConnectionResponse<Schema>;
+    }>(query, params);
+    return response.schemas;
+  }
+
+  async getEvents(params?: {
+    first?: number;
+    after?: string;
+    last?: number;
+    before?: string;
+    name?: string;
+    checkpoint?: string;
+    orderBy?: OrderBy;
+    distinct?: boolean;
+  }) {
+    const query = `
+      query GetEvents($first: Int, $after: String, $last: Int, $before: String, $name: String, $checkpoint: String, $orderBy: EventOrderBy, $distinct: Boolean) {
+        events(first: $first, after: $after, last: $last, before: $before, name: $name, checkpoint: $checkpoint, orderBy: $orderBy, distinct: $distinct) {
+          edges {
+            cursor
+            node {
+              id
+              checkpoint
+              digest
+              name
+              value
+              created_at
+            }
+          }
+          pageInfo {
+            hasNextPage
+            hasPreviousPage
+            startCursor
+            endCursor
+          }
+        }
+      }
+    `;
+
+    const response = await this.fetchGraphql<{
+      events: ConnectionResponse<Event>;
+    }>(query, params);
+    return response.events;
+  }
+
+  async getStorage({
+    name,
+    key1,
+    key2,
+    first,
+    after,
+    last,
+    before,
+    orderBy,
+    distinct,
+  }: {
+    name: string;
+    key1?: string;
+    key2?: string;
+    first?: number;
+    after?: string;
+    last?: number;
+    before?: string;
+    orderBy?: OrderBy;
+    distinct?: boolean;
+  }): Promise<ConnectionResponse<Schema>> {
+    const schemas = await this.getSchemas({
+      name,
+      key1,
+      key2,
+      first,
+      after,
+      last,
+      before,
+      orderBy,
+      distinct,
+    });
+
+    return schemas;
+  }
+
+  async subscribe(
+    names: string[],
+    handleData: (data: any) => void
+  ): Promise<WebSocket> {
+    return this.http.subscribe(names, handleData);
+  }
+}

package/src/libs/suiInteractor/defaultConfig.ts

@@ -7,6 +7,7 @@ export interface NetworkConfig {
   txExplorer: string;
   accountExplorer: string;
   explorer: string;
+  indexerUrl: string;
 }
 
 export const getDefaultURL = (
@@ -23,6 +24,7 @@ export const getDefaultURL = (
         accountExplorer:
           'https://explorer.polymedia.app/address/:address?network=local',
         explorer: 'https://explorer.polymedia.app?network=local',
+        indexerUrl: 'http://127.0.0.1:3001',
       };
     case 'devnet':
       return {
@@ -31,6 +33,7 @@ export const getDefaultURL = (
         txExplorer: 'https://suiscan.xyz/devnet/tx/:txHash',
         accountExplorer: 'https://suiscan.xyz/devnet/address/:address',
         explorer: 'https://suiscan.xyz/devnet',
+        indexerUrl: 'http://127.0.0.1:3001',
       };
     case 'testnet':
       return {
@@ -40,6 +43,7 @@ export const getDefaultURL = (
         txExplorer: 'https://suiscan.xyz/testnet/tx/:txHash',
         accountExplorer: 'https://suiscan.xyz/testnet/address/:address',
         explorer: 'https://suiscan.xyz/testnet',
+        indexerUrl: 'http://127.0.0.1:3001',
       };
     case 'mainnet':
       return {
@@ -49,6 +53,7 @@ export const getDefaultURL = (
         txExplorer: 'https://suiscan.xyz/mainnet/tx/:txHash',
         accountExplorer: 'https://suiscan.xyz/mainnet/address/:address',
         explorer: 'https://suiscan.xyz/mainnet',
+        indexerUrl: 'http://127.0.0.1:3001',
       };
     default:
       return {
@@ -58,6 +63,7 @@ export const getDefaultURL = (
         txExplorer: 'https://suiscan.xyz/testnet/tx/:txHash',
         accountExplorer: 'https://suiscan.xyz/testnet/address/:address',
         explorer: 'https://suiscan.xyz/testnet',
+        indexerUrl: 'http://127.0.0.1:3001',
       };
   }
 };

package/src/types/index.ts

@@ -23,6 +23,7 @@ import type {
 import { SuiTx } from '../libs/suiTxBuilder';
 
 import { SuiMoveMoudleFuncType } from '../libs/suiContractFactory/types';
+import { FetchOptions } from '../libs/http';
 
 export const ObjectContentFields = record(string(), any());
 export type ObjectContentFields = Infer<typeof ObjectContentFields>;
@@ -50,6 +51,10 @@ export type DubheParams = {
   networkType?: NetworkType;
   packageId?: string;
   metadata?: SuiMoveNormalizedModules;
+  customFetch?: typeof fetch;
+  defaultOptions?: FetchOptions;
+  indexerUrl?: string;
+  indexerWsUrl?: string;
 };
 
 export type SchemaFieldType = {

package/src/utils/index.ts

@@ -28,3 +28,12 @@ export function normalizePackageId(input: string): string {
   const normalized = withoutPrefix.replace(/^0+/, '');
   return '0x' + normalized;
 }
+
+export function convertHttpToWebSocket(url: string): string {
+  if (url.startsWith('https://')) {
+    return url.replace('https://', 'wss://');
+  } else if (url.startsWith('http://')) {
+    return url.replace('http://', 'ws://');
+  }
+  return url;
+}