@0xobelisk/client 0.2.8 → 0.3.0

package/src/libs/suiInteractor/suiInteractor.ts

@@ -10,11 +10,21 @@ import {
   getObjectVersion,
   getSharedObjectInitialVersion,
   DynamicFieldName,
-  SuiAddress
+  SuiAddress,
 } from '@mysten/sui.js';
 import { requestSuiFromFaucetV0, getFaucetHost } from '@mysten/sui.js/faucet';
-import { SuiClient, getFullnodeUrl, GetBalanceParams } from '@mysten/sui.js/client';
-import { FaucetNetworkType, NetworkType, ObjectData } from 'src/types';
+import {
+  SuiClient,
+  getFullnodeUrl,
+  GetBalanceParams,
+} from '@mysten/sui.js/client';
+import {
+  FaucetNetworkType,
+  NetworkType,
+  ObjectData,
+  ObjectFieldType,
+  EntityData,
+} from 'src/types';
 import { SuiOwnedObject, SuiSharedObject } from '../suiModel';
 import { delay } from './util';
 
@@ -78,6 +88,7 @@ export class SuiInteractor {
     }
     throw new Error('Failed to send transaction with all fullnodes');
   }
+
   async getObjects(ids: string[]) {
     const options = {
       showContent: true,
@@ -129,11 +140,50 @@ export class SuiInteractor {
     return objects[0];
   }
 
+  async getEntitiesObjects(ids: string[]) {
+    const options = {
+      showContent: true,
+      showType: true,
+    };
+
+    // const currentProviderIdx = this.providers.indexOf(this.currentProvider);
+    // const providers = [
+    //   ...this.providers.slice(currentProviderIdx, this.providers.length),
+    //   ...this.providers.slice(0, currentProviderIdx),
+    // ]
+
+    for (const provider of this.providers) {
+      try {
+        const objects = await provider.multiGetObjects({ ids, options });
+        const parsedObjects = objects.map((object) => {
+          const objectId = getObjectId(object);
+          const objectFields = getObjectFields(object) as ObjectFieldType;
+          const index = objectFields.name;
+          const key = objectFields.value;
+          return {
+            objectId,
+            index,
+            key,
+          };
+        });
+        return parsedObjects as EntityData[];
+      } catch (err) {
+        await delay(2000);
+        console.warn(
+          `Failed to get objects with fullnode ${provider.connection.fullnode}: ${err}`
+        );
+      }
+    }
+    throw new Error('Failed to get objects with all fullnodes');
+  }
 
-  async getDynamicFieldObject(parentId: string, name: string | DynamicFieldName) {
+  async getDynamicFieldObject(
+    parentId: string,
+    name: string | DynamicFieldName
+  ) {
     for (const provider of this.providers) {
       try {
-        return provider.getDynamicFieldObject({ parentId, name })
+        return provider.getDynamicFieldObject({ parentId, name });
       } catch (err) {
         await delay(2000);
         console.warn(
@@ -147,7 +197,7 @@ export class SuiInteractor {
   async getDynamicFields(parentId: string, cursor?: string, limit?: number) {
     for (const provider of this.providers) {
       try {
-        return provider.getDynamicFields({ parentId, cursor, limit })
+        return provider.getDynamicFields({ parentId, cursor, limit });
       } catch (err) {
         await delay(2000);
         console.warn(
@@ -172,12 +222,12 @@ export class SuiInteractor {
     throw new Error('Failed to get objects with all fullnodes');
   }
 
-
   async getNormalizedMoveModulesByPackage(packageId: string) {
     for (const provider of this.providers) {
       try {
-        return provider.getNormalizedMoveModulesByPackage({package: packageId});
-
+        return provider.getNormalizedMoveModulesByPackage({
+          package: packageId,
+        });
       } catch (err) {
         await delay(2000);
         console.warn(

package/src/obelisk.ts

@@ -30,9 +30,16 @@ import {
   MapMoudleFuncQuery,
   MapMoudleFuncTx,
   FaucetNetworkType,
+  SuiReturnValues,
+  DynamicFieldContentType,
 } from './types';
-import { capitalizeFirstLetter } from './utils';
+import {
+  capitalizeFirstLetter,
+  normalizeHexAddress,
+  numberToAddressHex,
+} from './utils';
 import keccak256 from 'keccak256';
+import { BCS, getSuiMoveConfig, fromHEX, fromB64, fromB58 } from '@mysten/bcs';
 
 export function isUndefined(value?: unknown): value is undefined {
   return value === undefined;
@@ -467,11 +474,137 @@ export class Obelisk {
     const name = {
       type: 'address',
       value: componentIdValue,
-      // value: [250,208,186,160,39,171,62,206,98,224,138,41,11,217,63,100,248,104,207,64,78,126,43,109,129,68,64,127,236,113,152,132]
     } as DynamicFieldName;
     return await this.suiInteractor.getDynamicFieldObject(parentId, name);
   }
 
+  async getComponentTable(worldId: string, componentName: string) {
+    let componentMoudleName = `${componentName}_comp`;
+    const tx = new TransactionBlock();
+    let params = [tx.pure(worldId)] as SuiTxArgument[];
+
+    const tableResult = (await this.query[componentMoudleName].data(
+      tx,
+      params
+    )) as DevInspectResults;
+    const tableId = tableResult.results as SuiReturnValues;
+    const bcs = new BCS(getSuiMoveConfig());
+
+    let value = Uint8Array.from(tableId[0].returnValues[0][0]);
+    let data = bcs.de('address', value);
+    return '0x' + data;
+  }
+
+  async getEntities(
+    worldId: string,
+    componentName: string,
+    cursor?: string,
+    limit?: number
+  ) {
+    let componentMoudleName = `${componentName}_comp`;
+
+    const tx = new TransactionBlock();
+    let params = [tx.pure(worldId)] as SuiTxArgument[];
+
+    const tableResult = (await this.query[componentMoudleName].entities(
+      tx,
+      params
+    )) as DevInspectResults;
+    const entities = tableResult.results as SuiReturnValues;
+    const bcs = new BCS(getSuiMoveConfig());
+
+    let value = Uint8Array.from(entities[0].returnValues[0][0]);
+    let tableId = '0x' + bcs.de('address', value);
+    let dynamicFields = await this.suiInteractor.getDynamicFields(
+      tableId,
+      cursor,
+      limit
+    );
+    let objectIds = dynamicFields.data.map((field) => field.objectId);
+    let objectDatas = await this.suiInteractor.getEntitiesObjects(objectIds);
+    return {
+      data: objectDatas,
+      nextCursor: dynamicFields.nextCursor,
+      hasNextPage: dynamicFields.hasNextPage,
+    };
+  }
+
+  async getEntity(worldId: string, componentName: string, entityId: string) {
+    let checkWorldId = normalizeHexAddress(worldId);
+    if (checkWorldId) {
+      worldId = checkWorldId;
+    } else {
+      return undefined;
+    }
+
+    let checkEntityId = normalizeHexAddress(entityId);
+    if (checkEntityId) {
+      entityId = checkEntityId;
+    } else {
+      return undefined;
+    }
+
+    const parentId = await this.getComponentTable(worldId, componentName);
+    const name = {
+      type: 'address',
+      value: entityId,
+    } as DynamicFieldName;
+
+    let dynamicFieldObject = await this.suiInteractor.getDynamicFieldObject(
+      parentId,
+      name
+    );
+    return dynamicFieldObject;
+  }
+
+  // async getEntityData(
+  //   worldId: string,
+  //   componentName: string,
+  //   entityId: string
+  // ) {
+  //   const parentId = await this.getComponentTable(worldId, componentName);
+  //   const name = {
+  //     type: 'address',
+  //     value: entityId,
+  //   } as DynamicFieldName;
+
+  //   let dynamicFieldObject = await this.suiInteractor.getDynamicFieldObject(
+  //     parentId,
+  //     name
+  //   );
+  //   let componentMoudleName = `${componentName}_comp`;
+
+  //   const tx = new TransactionBlock();
+  //   let params = [] as SuiTxArgument[];
+
+  //   const typeResult = (await this.query[componentMoudleName].types(
+  //     tx,
+  //     params
+  //   )) as DevInspectResults;
+  //   let typeReturn = typeResult.results as SuiReturnValues;
+  //   console.log(typeReturn[0].returnValues[0][0]);
+
+  //   const typeBCS = new BCS(getSuiMoveConfig());
+  //   let typeValue = Uint8Array.from(typeReturn[0].returnValues[0][0]);
+
+  //   let typeData = typeBCS.de('vector<vector<u8>>', typeValue);
+  //   console.log(typeData);
+  //   const entityType = String.fromCharCode(...typeData[0]);
+
+  //   let dynamicFieldContent = dynamicFieldObject.data!
+  //     .content as DynamicFieldContentType;
+
+  //   let entityValue = dynamicFieldContent.fields['value'];
+  //   const bcs = new BCS(getSuiMoveConfig());
+  //   let value = Uint8Array.from(entityValue);
+  //   console.log(entityType);
+  //   console.log(value);
+
+  //   let data = bcs.de(entityType, value);
+  //   console.log(data);
+  //   return data;
+  // }
+
   async getOwnedObjects(owner: SuiAddress, cursor?: string, limit?: number) {
     const ownedObjects = await this.suiInteractor.getOwnedObjects(
       owner,
@@ -493,4 +626,33 @@ export class Obelisk {
 
     return ownedObjectsRes;
   }
+
+  async entity_key_from_object(objectId: string) {
+    let checkObjectId = normalizeHexAddress(objectId);
+    if (checkObjectId !== null) {
+      objectId = checkObjectId;
+      return objectId;
+    } else {
+      return undefined;
+    }
+  }
+
+  async entity_key_from_bytes(bytes: Uint8Array | Buffer | string) {
+    let hashBytes = keccak256(bytes);
+    const hashU8Array: number[] = Array.from(hashBytes);
+    const bcs = new BCS(getSuiMoveConfig());
+    let value = Uint8Array.from(hashU8Array);
+    let data = bcs.de('address', value);
+    return '0x' + data;
+  }
+
+  async entity_key_from_u256(x: number) {
+    return numberToAddressHex(x);
+  }
+
+  async formatData(type: string, value: Buffer | number[] | Uint8Array) {
+    const bcs = new BCS(getSuiMoveConfig());
+    let u8Value = Uint8Array.from(value);
+    return bcs.de(type, u8Value);
+  }
 }

package/src/types/index.ts

@@ -9,12 +9,13 @@ import {
   TransactionBlock,
   SuiTransactionBlockResponse,
   DevInspectResults,
-  SuiMoveNormalizedModules
+  SuiMoveNormalizedModules,
 } from '@mysten/sui.js';
 
-
-import { SuiMoveMoudleValueType, SuiMoveMoudleFuncType } from '../libs/suiContractFactory/types';
-
+import {
+  SuiMoveMoudleValueType,
+  SuiMoveMoudleFuncType,
+} from '../libs/suiContractFactory/types';
 
 export type ObeliskObjectData = {
   objectId: string;
@@ -24,73 +25,79 @@ export type ObeliskObjectData = {
   objectFields: ObjectContentFields;
 };
 
-
 export type ObeliskParams = {
   mnemonics?: string;
   secretKey?: string;
   fullnodeUrls?: string[];
   faucetUrl?: string;
   networkType?: NetworkType;
-  packageId?: string,
-  metadata?: SuiMoveNormalizedModules,
+  packageId?: string;
+  metadata?: SuiMoveNormalizedModules;
 };
 
 export type ComponentFieldType = {
-    components: {
-        type: string;
-        fields: {
-            id: {
-                id: string;
-            },
-            size: string;
-        }
-    }
-}
+  components: {
+    type: string;
+    fields: {
+      id: {
+        id: string;
+      };
+      size: string;
+    };
+  };
+};
 
 export type ComponentValueType = {
-    id: {
-        id: string;
+  id: {
+    id: string;
+  };
+  name: string;
+  value: {
+    type: string;
+    fields: ComponentFieldType;
+  };
+};
+
+export type SuiTxArgument =
+  | {
+      kind: 'Input';
+      index: number;
+      type?: 'object' | 'pure' | undefined;
+      value?: any;
     }
-    name: string;
-    value: {
-        type: string;
-        fields: ComponentFieldType;
+  | {
+      kind: 'GasCoin';
     }
-
-}
-
-export type SuiTxArgument = {
-    kind: "Input";
-    index: number;
-    type?: "object" | "pure" | undefined;
-    value?: any;
-  } | {
-    kind: "GasCoin";
-  } | {
-    kind: "Result";
-    index: number;
-  } | {
-    kind: "NestedResult";
-    index: number;
-    resultIndex: number;
-  }
+  | {
+      kind: 'Result';
+      index: number;
+    }
+  | {
+      kind: 'NestedResult';
+      index: number;
+      resultIndex: number;
+    };
 export type ComponentContentType = {
-    type: string;
-    fields: ComponentValueType;
-    hasPublicTransfer: boolean;
-    dataType: "moveObject";
-}
+  type: string;
+  fields: ComponentValueType;
+  hasPublicTransfer: boolean;
+  dataType: 'moveObject';
+};
 
 export interface MessageMeta {
   readonly meta: SuiMoveMoudleFuncType;
 }
 
 export interface ContractQuery extends MessageMeta {
-  (tx: TransactionBlock, params: SuiTxArgument[], isRaw?: boolean): Promise<DevInspectResults | TransactionBlock>;
+  (tx: TransactionBlock, params: SuiTxArgument[], isRaw?: boolean): Promise<
+    DevInspectResults | TransactionBlock
+  >;
 }
 
 export interface ContractTx extends MessageMeta {
-  (tx: TransactionBlock, params: SuiTxArgument[], isRaw?: boolean): SuiTransactionBlockResponse | TransactionBlock;
+  (tx: TransactionBlock, params: SuiTxArgument[], isRaw?: boolean):
+    | SuiTransactionBlockResponse
+    | TransactionBlock;
 }
 
 export type MapMessageTx = Record<string, ContractTx>;
@@ -102,8 +109,6 @@ export type MapMoudleFuncQuery = Record<string, MapMessageQuery>;
 export type MapMoudleFuncTest = Record<string, Record<string, string>>;
 export type MapMoudleFuncQueryTest = Record<string, Record<string, string>>;
 
-
-
 export type AccountMangerParams = {
   mnemonics?: string;
   secretKey?: string;
@@ -116,7 +121,7 @@ export type DerivePathParams = {
 };
 
 export type NetworkType = 'testnet' | 'mainnet' | 'devnet' | 'localnet';
-export type FaucetNetworkType = 'testnet' | 'devnet' | 'localnet'
+export type FaucetNetworkType = 'testnet' | 'devnet' | 'localnet';
 
 export type SuiKitParams = {
   mnemonics?: string;
@@ -136,7 +141,19 @@ export type ObjectData = {
   objectFields: ObjectContentFields;
 };
 
+export type ObjectFieldType = {
+  id: {
+    id: string;
+  };
+  name: string;
+  value: string;
+};
 
+export type EntityData = {
+  objectId: string;
+  index: string;
+  key: string;
+};
 
 export type SuiTxArg =
   | Infer<typeof TransactionArgument>
@@ -171,3 +188,14 @@ export type SuiBasicTypes =
   | 'u256';
 
 export type SuiInputTypes = 'object' | SuiBasicTypes;
+
+export type SuiReturnValues = {
+  returnValues: [number[], string][];
+}[];
+
+export type DynamicFieldContentType = {
+  type: string;
+  fields: Record<string, any>;
+  hasPublicTransfer: boolean;
+  dataType: string;
+};

package/src/utils/index.ts

@@ -1,3 +1,23 @@
 export function capitalizeFirstLetter(input: string): string {
-    return input.charAt(0).toUpperCase() + input.slice(1);
+  return input.charAt(0).toUpperCase() + input.slice(1);
+}
+
+export function normalizeHexAddress(input: string): string | null {
+  const hexRegex = /^(0x)?[0-9a-fA-F]{64}$/;
+
+  if (hexRegex.test(input)) {
+    if (input.startsWith('0x')) {
+      return input;
+    } else {
+      return '0x' + input;
+    }
+  } else {
+    return null;
+  }
+}
+
+export function numberToAddressHex(num: number): string {
+  const hex = num.toString(16);
+  const paddedHex = '0x' + hex.padStart(64, '0');
+  return paddedHex;
 }

package/dist/framework/bcs.d.ts

@@ -1,3 +0,0 @@
-import { BCS } from '@mysten/bcs';
-export declare const bcsSource: BCS;
-export declare const bcsOnchain: BCS;

package/dist/framework/loader.d.ts

@@ -1,11 +0,0 @@
-import { FieldsWithTypes, Type } from './util';
-export type PrimitiveValue = string | number | boolean | bigint;
-export declare class StructClassLoader {
-    #private;
-    private map;
-    register(...classes: any): void;
-    fromFields(type: Type, value: Record<string, any> | PrimitiveValue): any;
-    fromFieldsWithTypes(type: Type, value: FieldsWithTypes | PrimitiveValue): any;
-}
-export declare const structClassLoaderSource: StructClassLoader;
-export declare const structClassLoaderOnchain: StructClassLoader;

package/dist/framework/util.d.ts

@@ -1,90 +0,0 @@
-import { ObjectCallArg, ObjectId, TransactionArgument, TransactionBlock } from '@mysten/sui.js';
-/** A Move type, e.g., `address`, `bool`, `u64`, `vector<u64>`, `0x2::sui::SUI`... */
-export type Type = string;
-export interface FieldsWithTypes {
-    fields: Record<string, any>;
-    type: string;
-}
-export type ObjectArg = ObjectId | ObjectCallArg | TransactionArgument;
-export type PureArg = bigint | string | number | boolean | null | TransactionArgument | Array<PureArg>;
-export type GenericArg = ObjectArg | PureArg | Array<ObjectArg> | Array<PureArg> | Array<GenericArg>;
-export declare function parseTypeName(name: Type): {
-    typeName: string;
-    typeArgs: Type[];
-};
-export declare function obj(txb: TransactionBlock, arg: ObjectArg): {
-    kind: "Input";
-    index: number;
-    type?: "object" | "pure" | undefined;
-    value?: any;
-} | {
-    kind: "GasCoin";
-} | {
-    kind: "Result";
-    index: number;
-} | {
-    kind: "NestedResult";
-    index: number;
-    resultIndex: number;
-};
-export declare function pure(txb: TransactionBlock, arg: PureArg, type: Type): {
-    kind: "Input";
-    index: number;
-    type?: "object" | "pure" | undefined;
-    value?: any;
-} | {
-    kind: "GasCoin";
-} | {
-    kind: "Result";
-    index: number;
-} | {
-    kind: "NestedResult";
-    index: number;
-    resultIndex: number;
-};
-export declare function option(txb: TransactionBlock, type: Type, arg: GenericArg | null): {
-    kind: "Input";
-    index: number;
-    type?: "object" | "pure" | undefined;
-    value?: any;
-} | {
-    kind: "GasCoin";
-} | {
-    kind: "Result";
-    index: number;
-} | {
-    kind: "NestedResult";
-    index: number;
-    resultIndex: number;
-};
-export declare function generic(txb: TransactionBlock, type: Type, arg: GenericArg): {
-    kind: "Input";
-    index: number;
-    type?: "object" | "pure" | undefined;
-    value?: any;
-} | {
-    kind: "GasCoin";
-} | {
-    kind: "Result";
-    index: number;
-} | {
-    kind: "NestedResult";
-    index: number;
-    resultIndex: number;
-};
-export declare function vector(txb: TransactionBlock, itemType: Type, items: Array<GenericArg> | TransactionArgument): {
-    kind: "Input";
-    index: number;
-    type?: "object" | "pure" | undefined;
-    value?: any;
-} | {
-    kind: "GasCoin";
-} | {
-    kind: "Result";
-    index: number;
-} | {
-    kind: "NestedResult";
-    index: number;
-    resultIndex: number;
-};
-export declare function typeArgIsPure(type: Type): boolean;

package/dist/index.d.ts

@@ -1,9 +0,0 @@
-export * from '@mysten/sui.js';
-export { Ed25519Keypair } from '@mysten/sui.js/keypairs/ed25519';
-export * from '@mysten/bcs';
-export { Obelisk } from './obelisk';
-export { SuiAccountManager } from './libs/suiAccountManager';
-export { SuiTxBlock } from './libs/suiTxBuilder';
-export { SuiContractFactory } from './libs/suiContractFactory';
-export { getMetadata } from './metadata';
-export type * from './types';

package/dist/libs/suiAccountManager/crypto.d.ts

@@ -1 +0,0 @@
-export declare const generateMnemonic: (numberOfWords?: 12 | 24) => string;

package/dist/libs/suiAccountManager/index.d.ts

@@ -1,35 +0,0 @@
-import { Ed25519Keypair } from '@mysten/sui.js';
-import type { AccountMangerParams, DerivePathParams } from 'src/types';
-export declare class SuiAccountManager {
-    private mnemonics;
-    private secretKey;
-    currentKeyPair: Ed25519Keypair;
-    currentAddress: string;
-    /**
-     * Support the following ways to init the SuiToolkit:
-     * 1. mnemonics
-     * 2. secretKey (base64 or hex)
-     * If none of them is provided, will generate a random mnemonics with 24 words.
-     *
-     * @param mnemonics, 12 or 24 mnemonics words, separated by space
-     * @param secretKey, base64 or hex string, when mnemonics is provided, secretKey will be ignored
-     */
-    constructor({ mnemonics, secretKey }?: AccountMangerParams);
-    /**
-     * if derivePathParams is not provided or mnemonics is empty, it will return the currentKeyPair.
-     * else:
-     * it will generate keyPair from the mnemonic with the given derivePathParams.
-     */
-    getKeyPair(derivePathParams?: DerivePathParams): Ed25519Keypair;
-    /**
-     * if derivePathParams is not provided or mnemonics is empty, it will return the currentAddress.
-     * else:
-     * it will generate address from the mnemonic with the given derivePathParams.
-     */
-    getAddress(derivePathParams?: DerivePathParams): string;
-    /**
-     * Switch the current account with the given derivePathParams.
-     * This is only useful when the mnemonics is provided. For secretKey mode, it will always use the same account.
-     */
-    switchAccount(derivePathParams: DerivePathParams): void;
-}

package/dist/libs/suiAccountManager/keypair.d.ts

@@ -1,21 +0,0 @@
-import { Ed25519Keypair } from '@mysten/sui.js';
-import type { DerivePathParams } from 'src/types';
-/**
- * @description Get ed25519 derive path for SUI
- * @param derivePathParams
- */
-export declare const getDerivePathForSUI: (derivePathParams?: DerivePathParams) => string;
-/**
- * the format is m/44'/784'/accountIndex'/${isExternal ? 1 : 0}'/addressIndex'
- *
- * accountIndex is the index of the account, default is 0.
- *
- * isExternal is the type of the address, default is false. Usually, the external address is used to receive coins. The internal address is used to change coins.
- *
- * addressIndex is the index of the address, default is 0. It's used to generate multiple addresses for one account.
- *
- * @description Get keypair from mnemonics and derive path
- * @param mnemonics
- * @param derivePathParams
- */
-export declare const getKeyPair: (mnemonics: string, derivePathParams?: DerivePathParams) => Ed25519Keypair;