@aptos-labs/ts-sdk 1.19.0 → 1.21.0

package/dist/esm/types/index.d.mts

@@ -1,6 +1,6 @@
 import { Network } from '../utils/apiEndpoints.mjs';
 import { TokenStandard, OrderBy } from './indexer.mjs';
-export { GetANSNameResponse, GetAccountCoinsDataResponse, GetAccountCollectionsWithOwnedTokenResponse, GetAccountOwnedObjectsResponse, GetAccountOwnedTokensFromCollectionResponse, GetAccountOwnedTokensQueryResponse, GetChainTopUserTransactionsResponse, GetCollectionDataResponse, GetCurrentFungibleAssetBalancesResponse, GetCurrentTokenOwnershipResponse, GetDelegatedStakingActivitiesResponse, GetEventsResponse, GetFungibleAssetActivitiesResponse, GetFungibleAssetMetadataResponse, GetNumberOfDelegatorsResponse, GetOwnedTokensResponse, GetProcessorStatusResponse, GetTableItemsDataResponse, GetTableItemsMetadataResponse, GetTokenActivityResponse, GetTokenDataResponse, GraphqlQuery, OrderByValue } from './indexer.mjs';
+export { GetANSNameResponse, GetAccountCoinsDataResponse, GetAccountCollectionsWithOwnedTokenResponse, GetAccountOwnedTokensFromCollectionResponse, GetAccountOwnedTokensQueryResponse, GetChainTopUserTransactionsResponse, GetCollectionDataResponse, GetCurrentFungibleAssetBalancesResponse, GetCurrentTokenOwnershipResponse, GetDelegatedStakingActivitiesResponse, GetEventsResponse, GetFungibleAssetActivitiesResponse, GetFungibleAssetMetadataResponse, GetNumberOfDelegatorsResponse, GetObjectDataQueryResponse, GetOwnedTokensResponse, GetProcessorStatusResponse, GetTableItemsDataResponse, GetTableItemsMetadataResponse, GetTokenActivityResponse, GetTokenDataResponse, GraphqlQuery, OrderByValue } from './indexer.mjs';
 import './generated/operations.mjs';
 import './generated/types.mjs';
 

package/dist/esm/types/indexer.d.mts

@@ -1,4 +1,4 @@
-import { GetAccountOwnedObjectsQuery, GetAccountOwnedTokensQuery, GetAccountOwnedTokensFromCollectionQuery, GetAccountCollectionsWithOwnedTokensQuery, GetAccountCoinsDataQuery, GetChainTopUserTransactionsQuery, GetEventsQuery, GetNumberOfDelegatorsQuery, GetDelegatedStakingActivitiesQuery, GetCollectionDataQuery, GetTokenDataQuery, GetProcessorStatusQuery, GetFungibleAssetMetadataQuery, GetFungibleAssetActivitiesQuery, GetCurrentFungibleAssetBalancesQuery, GetTokenActivityQuery, GetCurrentTokenOwnershipQuery, GetTableItemsDataQuery, GetTableItemsMetadataQuery, GetNamesQuery } from './generated/operations.mjs';
+import { GetObjectDataQuery, GetAccountOwnedTokensQuery, GetAccountOwnedTokensFromCollectionQuery, GetAccountCollectionsWithOwnedTokensQuery, GetAccountCoinsDataQuery, GetChainTopUserTransactionsQuery, GetEventsQuery, GetNumberOfDelegatorsQuery, GetDelegatedStakingActivitiesQuery, GetCollectionDataQuery, GetTokenDataQuery, GetProcessorStatusQuery, GetFungibleAssetMetadataQuery, GetFungibleAssetActivitiesQuery, GetCurrentFungibleAssetBalancesQuery, GetTokenActivityQuery, GetCurrentTokenOwnershipQuery, GetTableItemsDataQuery, GetTableItemsMetadataQuery, GetNamesQuery } from './generated/operations.mjs';
 import './generated/types.mjs';
 
 /**
@@ -21,7 +21,7 @@ import './generated/types.mjs';
  * These types are used as the return type when calling a sdk api function
  * that calls the function that queries the server (usually under the /api/ folder)
  */
-type GetAccountOwnedObjectsResponse = GetAccountOwnedObjectsQuery["current_objects"];
+type GetObjectDataQueryResponse = GetObjectDataQuery["current_objects"];
 type GetAccountOwnedTokensQueryResponse = GetAccountOwnedTokensQuery["current_token_ownerships_v2"];
 type GetAccountOwnedTokensFromCollectionResponse = GetAccountOwnedTokensFromCollectionQuery["current_token_ownerships_v2"];
 type GetAccountCollectionsWithOwnedTokenResponse = GetAccountCollectionsWithOwnedTokensQuery["current_collection_ownership_v2_view"];
@@ -62,4 +62,4 @@ type GraphqlQuery = {
     variables?: {};
 };
 
-export type { GetANSNameResponse, GetAccountCoinsDataResponse, GetAccountCollectionsWithOwnedTokenResponse, GetAccountOwnedObjectsResponse, GetAccountOwnedTokensFromCollectionResponse, GetAccountOwnedTokensQueryResponse, GetChainTopUserTransactionsResponse, GetCollectionDataResponse, GetCurrentFungibleAssetBalancesResponse, GetCurrentTokenOwnershipResponse, GetDelegatedStakingActivitiesResponse, GetEventsResponse, GetFungibleAssetActivitiesResponse, GetFungibleAssetMetadataResponse, GetNumberOfDelegatorsResponse, GetOwnedTokensResponse, GetProcessorStatusResponse, GetTableItemsDataResponse, GetTableItemsMetadataResponse, GetTokenActivityResponse, GetTokenDataResponse, GraphqlQuery, OrderBy, OrderByValue, TokenStandard };
+export type { GetANSNameResponse, GetAccountCoinsDataResponse, GetAccountCollectionsWithOwnedTokenResponse, GetAccountOwnedTokensFromCollectionResponse, GetAccountOwnedTokensQueryResponse, GetChainTopUserTransactionsResponse, GetCollectionDataResponse, GetCurrentFungibleAssetBalancesResponse, GetCurrentTokenOwnershipResponse, GetDelegatedStakingActivitiesResponse, GetEventsResponse, GetFungibleAssetActivitiesResponse, GetFungibleAssetMetadataResponse, GetNumberOfDelegatorsResponse, GetObjectDataQueryResponse, GetOwnedTokensResponse, GetProcessorStatusResponse, GetTableItemsDataResponse, GetTableItemsMetadataResponse, GetTokenActivityResponse, GetTokenDataResponse, GraphqlQuery, OrderBy, OrderByValue, TokenStandard };

package/dist/esm/utils/const.d.mts

@@ -52,7 +52,8 @@ declare enum ProcessorType {
     FUNGIBLE_ASSET_PROCESSOR = "fungible_asset_processor",
     STAKE_PROCESSOR = "stake_processor",
     TOKEN_V2_PROCESSOR = "token_v2_processor",
-    USER_TRANSACTION_PROCESSOR = "user_transaction_processor"
+    USER_TRANSACTION_PROCESSOR = "user_transaction_processor",
+    OBJECT_PROCESSOR = "objects_processor"
 }
 
 export { APTOS_COIN, AptosApiType, DEFAULT_MAX_GAS_AMOUNT, DEFAULT_TXN_EXP_SEC_FROM_NOW, DEFAULT_TXN_TIMEOUT_SEC, ProcessorType, RAW_TRANSACTION_SALT, RAW_TRANSACTION_WITH_DATA_SALT };

package/dist/esm/utils/const.mjs

@@ -1,2 +1,2 @@
-import{a,b,c,d,e,f,g,h}from"../chunk-YE5B2S5L.mjs";import"../chunk-FVA2OPG4.mjs";export{e as APTOS_COIN,a as AptosApiType,b as DEFAULT_MAX_GAS_AMOUNT,c as DEFAULT_TXN_EXP_SEC_FROM_NOW,d as DEFAULT_TXN_TIMEOUT_SEC,h as ProcessorType,f as RAW_TRANSACTION_SALT,g as RAW_TRANSACTION_WITH_DATA_SALT};
+import{a,b,c,d,e,f,g,h}from"../chunk-L36ZHC7J.mjs";import"../chunk-FVA2OPG4.mjs";export{e as APTOS_COIN,a as AptosApiType,b as DEFAULT_MAX_GAS_AMOUNT,c as DEFAULT_TXN_EXP_SEC_FROM_NOW,d as DEFAULT_TXN_TIMEOUT_SEC,h as ProcessorType,f as RAW_TRANSACTION_SALT,g as RAW_TRANSACTION_WITH_DATA_SALT};
 //# sourceMappingURL=const.mjs.map

package/dist/esm/utils/index.mjs

@@ -1,2 +1,2 @@
-import"../chunk-GED6IT3S.mjs";import{a as q}from"../chunk-WV5AD4IE.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-P5V7OZNN.mjs";import"../chunk-H6YNXJNF.mjs";import"../chunk-KMJ6TF6Y.mjs";import"../chunk-YPHH6CAO.mjs";import"../chunk-Q6LFIZ3L.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-A63SMUOU.mjs";import"../chunk-BCUSI3N6.mjs";import"../chunk-LG7RJQ57.mjs";import"../chunk-DZXM2MQY.mjs";import"../chunk-56CNRT2K.mjs";import{a,b,c,d,e,f,g,h}from"../chunk-SCHZ67F3.mjs";import{a as i,b as j,c as k,d as l,e as m,f as n,g as o,h as p}from"../chunk-YE5B2S5L.mjs";import"../chunk-FVA2OPG4.mjs";export{m as APTOS_COIN,i as AptosApiType,j as DEFAULT_MAX_GAS_AMOUNT,k as DEFAULT_TXN_EXP_SEC_FROM_NOW,l as DEFAULT_TXN_TIMEOUT_SEC,f as Network,g as NetworkToChainId,c as NetworkToFaucetAPI,a as NetworkToIndexerAPI,h as NetworkToNetworkName,b as NetworkToNodeAPI,d as NetworkToPepperAPI,e as NetworkToProverAPI,p as ProcessorType,n as RAW_TRANSACTION_SALT,o as RAW_TRANSACTION_WITH_DATA_SALT,q as normalizeBundle};
+import"../chunk-GED6IT3S.mjs";import{a as q}from"../chunk-WV5AD4IE.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-P5V7OZNN.mjs";import"../chunk-H6YNXJNF.mjs";import"../chunk-KMJ6TF6Y.mjs";import"../chunk-YPHH6CAO.mjs";import"../chunk-DZXM2MQY.mjs";import"../chunk-Q6LFIZ3L.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-A63SMUOU.mjs";import"../chunk-BCUSI3N6.mjs";import"../chunk-LG7RJQ57.mjs";import"../chunk-56CNRT2K.mjs";import{a as i,b as j,c as k,d as l,e as m,f as n,g as o,h as p}from"../chunk-L36ZHC7J.mjs";import{a,b,c,d,e,f,g,h}from"../chunk-SCHZ67F3.mjs";import"../chunk-FVA2OPG4.mjs";export{m as APTOS_COIN,i as AptosApiType,j as DEFAULT_MAX_GAS_AMOUNT,k as DEFAULT_TXN_EXP_SEC_FROM_NOW,l as DEFAULT_TXN_TIMEOUT_SEC,f as Network,g as NetworkToChainId,c as NetworkToFaucetAPI,a as NetworkToIndexerAPI,h as NetworkToNetworkName,b as NetworkToNodeAPI,d as NetworkToPepperAPI,e as NetworkToProverAPI,p as ProcessorType,n as RAW_TRANSACTION_SALT,o as RAW_TRANSACTION_WITH_DATA_SALT,q as normalizeBundle};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/utils/normalizeBundle.mjs

@@ -1,2 +1,2 @@
-import{a}from"../chunk-WV5AD4IE.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-P5V7OZNN.mjs";import"../chunk-H6YNXJNF.mjs";import"../chunk-KMJ6TF6Y.mjs";import"../chunk-YPHH6CAO.mjs";import"../chunk-Q6LFIZ3L.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-A63SMUOU.mjs";import"../chunk-BCUSI3N6.mjs";import"../chunk-LG7RJQ57.mjs";import"../chunk-DZXM2MQY.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-FVA2OPG4.mjs";export{a as normalizeBundle};
+import{a}from"../chunk-WV5AD4IE.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-P5V7OZNN.mjs";import"../chunk-H6YNXJNF.mjs";import"../chunk-KMJ6TF6Y.mjs";import"../chunk-YPHH6CAO.mjs";import"../chunk-DZXM2MQY.mjs";import"../chunk-Q6LFIZ3L.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-A63SMUOU.mjs";import"../chunk-BCUSI3N6.mjs";import"../chunk-LG7RJQ57.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-FVA2OPG4.mjs";export{a as normalizeBundle};
 //# sourceMappingURL=normalizeBundle.mjs.map

package/dist/esm/version.d.mts

@@ -3,6 +3,6 @@
  *
  * hardcoded for now, we would want to have it injected dynamically
  */
-declare const VERSION = "1.19.0";
+declare const VERSION = "1.20.0";
 
 export { VERSION };

package/dist/esm/version.mjs

@@ -1,2 +1,2 @@
-import{a}from"./chunk-EAXCOIOP.mjs";import"./chunk-FVA2OPG4.mjs";export{a as VERSION};
+import{a}from"./chunk-4KYQ7N3N.mjs";import"./chunk-FVA2OPG4.mjs";export{a as VERSION};
 //# sourceMappingURL=version.mjs.map

package/package.json

@@ -91,5 +91,5 @@
     "typedoc": "^0.25.4",
     "typescript": "^5.3.3"
   },
-  "version": "1.19.0"
+  "version": "1.21.0"
 }

package/src/api/account.ts

@@ -8,9 +8,9 @@ import {
   AnyNumber,
   GetAccountCoinsDataResponse,
   GetAccountCollectionsWithOwnedTokenResponse,
-  GetAccountOwnedObjectsResponse,
   GetAccountOwnedTokensFromCollectionResponse,
   GetAccountOwnedTokensQueryResponse,
+  GetObjectDataQueryResponse,
   LedgerVersionArg,
   MoveModuleBytecode,
   MoveResource,
@@ -471,8 +471,8 @@ export class Account {
   async getAccountOwnedObjects(args: {
     accountAddress: AccountAddressInput;
     minimumLedgerVersion?: AnyNumber;
-    options?: PaginationArgs & OrderByArg<GetAccountOwnedObjectsResponse[0]>;
-  }): Promise<GetAccountOwnedObjectsResponse> {
+    options?: PaginationArgs & OrderByArg<GetObjectDataQueryResponse[0]>;
+  }): Promise<GetObjectDataQueryResponse> {
     await waitForIndexerOnVersion({
       config: this.config,
       minimumLedgerVersion: args.minimumLedgerVersion,

package/src/api/aptos.ts

@@ -14,6 +14,7 @@ import { Staking } from "./staking";
 import { Transaction } from "./transaction";
 import { Table } from "./table";
 import { Keyless } from "./keyless";
+import { AptosObject } from "./object";
 
 /**
  * This class is the main entry point into Aptos's
@@ -53,6 +54,8 @@ export class Aptos {
 
   readonly keyless: Keyless;
 
+  readonly object: AptosObject;
+
   constructor(settings?: AptosConfig) {
     this.config = new AptosConfig(settings);
     this.account = new Account(this.config);
@@ -67,6 +70,7 @@ export class Aptos {
     this.transaction = new Transaction(this.config);
     this.table = new Table(this.config);
     this.keyless = new Keyless(this.config);
+    this.object = new AptosObject(this.config);
   }
 }
 
@@ -84,6 +88,7 @@ export interface Aptos
     Keyless,
     Staking,
     Table,
+    AptosObject,
     Omit<Transaction, "build" | "simulate" | "submit" | "batch"> {}
 
 /**
@@ -119,3 +124,4 @@ applyMixin(Aptos, Staking, "staking");
 applyMixin(Aptos, Transaction, "transaction");
 applyMixin(Aptos, Table, "table");
 applyMixin(Aptos, Keyless, "keyless");
+applyMixin(Aptos, AptosObject, "object");

package/src/api/digitalAsset.ts

@@ -25,6 +25,8 @@ import {
   freezeDigitalAssetTransferTransaction,
   getCollectionData,
   getCollectionDataByCollectionId,
+  getCollectionDataByCreatorAddress,
+  getCollectionDataByCreatorAddressAndCollectionName,
   getCollectionId,
   getCurrentDigitalAssetOwnership,
   getDigitalAssetActivity,
@@ -55,6 +57,9 @@ export class DigitalAsset {
   constructor(readonly config: AptosConfig) {}
 
   /**
+   * @deprecated use getCollectionDataByCreatorAddressAndCollectionName - this function
+   * will be removed in the next major release
+   *
    * Queries data of a specific collection by the collection creator address and the collection name.
    *
    * If, for some reason, a creator account has 2 collections with the same name in v1 and v2,
@@ -80,7 +85,81 @@ export class DigitalAsset {
       minimumLedgerVersion: args.minimumLedgerVersion,
       processorType: ProcessorType.TOKEN_V2_PROCESSOR,
     });
-    return getCollectionData({ aptosConfig: this.config, ...args });
+
+    const { creatorAddress, collectionName, options } = args;
+    const address = AccountAddress.from(creatorAddress);
+
+    const whereCondition: any = {
+      collection_name: { _eq: collectionName },
+      creator_address: { _eq: address.toStringLong() },
+    };
+    if (options?.tokenStandard) {
+      whereCondition.token_standard = { _eq: options?.tokenStandard ?? "v2" };
+    }
+
+    return getCollectionData({ aptosConfig: this.config, options: { where: whereCondition } });
+  }
+
+  /**
+   * Queries data of a specific collection by the collection creator address and the collection name.
+   *
+   * If, for some reason, a creator account has 2 collections with the same name in v1 and v2,
+   * can pass an optional `tokenStandard` parameter to query a specific standard
+   *
+   * @example
+   * const collection = await aptos.getCollectionDataByCreatorAddressAndCollectionName({
+   *   creatorAddress:"0x123",
+   *   collectionName:"myCollection"
+   * })
+   *
+   * @param args.creatorAddress the address of the collection's creator
+   * @param args.collectionName the name of the collection
+   * @param args.minimumLedgerVersion Optional ledger version to sync up to, before querying
+   * @param args.options.tokenStandard the token standard to query
+   * @returns GetCollectionDataResponse response type
+   */
+  async getCollectionDataByCreatorAddressAndCollectionName(args: {
+    creatorAddress: AccountAddressInput;
+    collectionName: string;
+    minimumLedgerVersion?: AnyNumber;
+    options?: TokenStandardArg & PaginationArgs;
+  }): Promise<GetCollectionDataResponse> {
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.TOKEN_V2_PROCESSOR,
+    });
+
+    return getCollectionDataByCreatorAddressAndCollectionName({ aptosConfig: this.config, ...args });
+  }
+
+  /**
+   * Queries data of a specific collection by the collection creator address and the collection name.
+   *
+   * If, for some reason, a creator account has 2 collections with the same name in v1 and v2,
+   * can pass an optional `tokenStandard` parameter to query a specific standard
+   *
+   * @example
+   * const collection = await aptos.getCollectionDataByCreatorAddressAnd({creatorAddress:"0x123"})
+   *
+   * @param args.creatorAddress the address of the collection's creator
+   * @param args.collectionName the name of the collection
+   * @param args.minimumLedgerVersion Optional ledger version to sync up to, before querying
+   * @param args.options.tokenStandard the token standard to query
+   * @returns GetCollectionDataResponse response type
+   */
+  async getCollectionDataByCreatorAddress(args: {
+    creatorAddress: AccountAddressInput;
+    minimumLedgerVersion?: AnyNumber;
+    options?: TokenStandardArg & PaginationArgs;
+  }): Promise<GetCollectionDataResponse> {
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.TOKEN_V2_PROCESSOR,
+    });
+
+    return getCollectionDataByCreatorAddress({ aptosConfig: this.config, ...args });
   }
 
   /**
@@ -96,6 +175,7 @@ export class DigitalAsset {
   async getCollectionDataByCollectionId(args: {
     collectionId: AccountAddressInput;
     minimumLedgerVersion?: AnyNumber;
+    options?: TokenStandardArg & PaginationArgs;
   }): Promise<GetCollectionDataResponse> {
     await waitForIndexerOnVersion({
       config: this.config,

package/src/api/general.ts

@@ -10,7 +10,7 @@ import {
   queryIndexer,
 } from "../internal/general";
 import { getBlockByHeight, getBlockByVersion } from "../internal/transaction";
-import { view } from "../internal/view";
+import { view, viewJson } from "../internal/view";
 import {
   AnyNumber,
   Block,
@@ -22,7 +22,7 @@ import {
   MoveValue,
 } from "../types";
 import { ProcessorType } from "../utils/const";
-import { InputViewFunctionData } from "../transactions";
+import { InputViewFunctionData, InputViewFunctionJsonData } from "../transactions";
 
 /**
  * A class to query all `General` Aptos related queries
@@ -132,6 +132,29 @@ export class General {
     return view<T>({ aptosConfig: this.config, ...args });
   }
 
+  /**
+   * Queries for a Move view function with JSON, this provides compatability with the old `aptos` package
+   * @param args.payload Payload for the view function
+   * @param args.options.ledgerVersion The ledger version to query, if not provided it will get the latest version
+   *
+   * @example
+   * const data = await aptos.view({
+   *  payload: {
+   *   function: "0x1::coin::balance",
+   *   typeArguments: ["0x1::aptos_coin::AptosCoin"],
+   *   functionArguments: [accountAddress.toString()],
+   *  }
+   * })
+   *
+   * @returns an array of Move values
+   */
+  async viewJson<T extends Array<MoveValue>>(args: {
+    payload: InputViewFunctionJsonData;
+    options?: LedgerVersionArg;
+  }): Promise<T> {
+    return viewJson<T>({ aptosConfig: this.config, ...args });
+  }
+
   /**
    * Queries top user transactions
    *

package/src/api/object.ts

@@ -0,0 +1,43 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+
+import { AnyNumber, GetObjectDataQueryResponse, OrderByArg, PaginationArgs } from "../types";
+import { AccountAddressInput } from "../core";
+import { AptosConfig } from "./aptosConfig";
+import { ProcessorType } from "../utils";
+import { waitForIndexerOnVersion } from "./utils";
+import { getObjectDataByObjectAddress } from "../internal/object";
+
+/**
+ * A class to query all `Object` related queries on Aptos.
+ */
+export class AptosObject {
+  constructor(readonly config: AptosConfig) {}
+
+  /**
+   * Fetch the object data based on the oabject address
+   *
+   * @example
+   * const object = await aptos.getObjectDataByObjectAddress({objectAddress:"0x123"})
+   *
+   * @param args.objectAddress The object address
+   * @param args.options Configuration options for waitForTransaction
+   *
+   * @returns The object data
+   */
+  async getObjectDataByObjectAddress(args: {
+    objectAddress: AccountAddressInput;
+    minimumLedgerVersion?: AnyNumber;
+    options?: PaginationArgs & OrderByArg<GetObjectDataQueryResponse[0]>;
+  }): Promise<GetObjectDataQueryResponse[0]> {
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.OBJECT_PROCESSOR,
+    });
+    return getObjectDataByObjectAddress({
+      aptosConfig: this.config,
+      ...args,
+    });
+  }
+}

package/src/cli/move.ts

@@ -9,13 +9,13 @@ export class Move {
    * Function to initialize current directory for Aptos
    *
    * Configuration will be pushed into .aptos/config.yaml
-   * @param args.network optional Netowrk type argument to use for default settings, default is local
+   * @param args.network optional Network type argument to use for default settings, default is local
    * @param args.profile optional Profile to use from the config file, default is 'default'
    * This will be used to override associated settings such as the REST URL, the Faucet URL, and the private key arguments.
    *
-   * @returns
+   * @returns stdout
    */
-  async init(args: { network?: Network; profile?: string }): Promise<boolean> {
+  async init(args: { network?: Network; profile?: string }): Promise<{ output: string }> {
     const { network, profile } = args;
     const cliArgs = ["aptos", "init", `--network=${network ?? "local"}`, `--profile=${profile ?? "default"}`];
 
@@ -32,12 +32,12 @@ export class Move {
    *  alice:0x1234, bob:0x5678
    * }
    *
-   * @returns
+   * @returns stdout
    */
   async compile(args: {
     packageDirectoryPath: string;
     namedAddresses: Record<string, AccountAddress>;
-  }): Promise<boolean> {
+  }): Promise<{ output: string }> {
     const { packageDirectoryPath, namedAddresses } = args;
     const cliArgs = ["aptos", "move", "compile", "--package-dir", packageDirectoryPath];
 
@@ -58,9 +58,12 @@ export class Move {
    *  alice:0x1234, bob:0x5678
    * }
    *
-   * @returns
+   * @returns stdout
    */
-  async test(args: { packageDirectoryPath: string; namedAddresses: Record<string, AccountAddress> }): Promise<boolean> {
+  async test(args: {
+    packageDirectoryPath: string;
+    namedAddresses: Record<string, AccountAddress>;
+  }): Promise<{ output: string }> {
     const { packageDirectoryPath, namedAddresses } = args;
     const cliArgs = ["aptos", "move", "test", "--package-dir", packageDirectoryPath];
 
@@ -72,7 +75,7 @@ export class Move {
   }
 
   /**
-   * Function to publishe the modules in a Move package to the Aptos blockchain
+   * Function to publish the modules to the publisher account on the Aptos blockchain
    *
    * @param args.packageDirectoryPath Path to a move package (the folder with a Move.toml file)
    * @param args.namedAddresses  Named addresses for the move binary
@@ -82,13 +85,13 @@ export class Move {
    * }
    * @param args.profile optional Profile to use from the config file.
    *
-   * @returns
+   * @returns stdout
    */
   async publish(args: {
     packageDirectoryPath: string;
     namedAddresses: Record<string, AccountAddress>;
     profile?: string;
-  }): Promise<boolean> {
+  }): Promise<{ output: string }> {
     const { packageDirectoryPath, namedAddresses, profile } = args;
     const cliArgs = [
       "aptos",
@@ -106,17 +109,134 @@ export class Move {
     return this.runCommand(cliArgs);
   }
 
+  /**
+   * Function to create a new object and publish the Move package to it on the Aptos blockchain
+   *
+   * @param args.packageDirectoryPath Path to a move package (the folder with a Move.toml file)
+   * @param args.addressName Address name for the Move package
+   * @example
+   * MoonCoin, please find the actual address name in Move.toml
+   * @param args.namedAddresses  Named addresses for the move binary
+   * @example
+   * {
+   *  alice:0x1234, bob:0x5678
+   * }
+   * @param args.profile optional Profile to use from the config file.
+   *
+   * A complete example in cli
+   * aptos move create-object-and-publish-package \
+   * --package-dir path_to_directory_that_has_move.toml \
+   * --address-name launchpad_addr \
+   * --named-addresses "launchpad_addr=0x123,initial_creator_addr=0x456"\
+   * --profile my_profile \
+   * --assume-yes
+   * @returns object address
+   */
+  async createObjectAndPublishPackage(args: {
+    packageDirectoryPath: string;
+    addressName: string;
+    namedAddresses: Record<string, AccountAddress>;
+    profile?: string;
+  }): Promise<{ objectAddress: string }> {
+    const { packageDirectoryPath, addressName, namedAddresses, profile } = args;
+    const cliArgs = [
+      "aptos",
+      "move",
+      "create-object-and-publish-package",
+      "--package-dir",
+      packageDirectoryPath,
+      "--address-name",
+      addressName,
+      `--profile=${profile ?? "default"}`,
+    ];
+
+    const addressesMap = this.parseNamedAddresses(namedAddresses);
+
+    cliArgs.push(...this.prepareNamedAddresses(addressesMap));
+
+    const result = await this.runCommand(cliArgs);
+    return { objectAddress: this.extractAddressFromOutput(result.output) };
+  }
+
+  /**
+   * Function to upgrade a Move package previously published to an object on the Aptos blockchain
+   * Caller must be the object owner to call this function
+   *
+   * @param args.packageDirectoryPath Path to a move package (the folder with a Move.toml file)
+   * @param args.objectAddress Address of the object that the Move package published to
+   * @example
+   * 0x1000
+   * @param args.namedAddresses  Named addresses for the move binary
+   * @example
+   * {
+   *  alice:0x1234, bob:0x5678
+   * }
+   * @param args.profile optional Profile to use from the config file.
+   *
+   * @returns stdout
+   */
+  async upgradeObjectPackage(args: {
+    packageDirectoryPath: string;
+    objectAddress: string;
+    namedAddresses: Record<string, AccountAddress>;
+    profile?: string;
+  }): Promise<{ output: string }> {
+    const { packageDirectoryPath, objectAddress, namedAddresses, profile } = args;
+    const cliArgs = [
+      "aptos",
+      "move",
+      "upgrade-object-package",
+      "--package-dir",
+      packageDirectoryPath,
+      "--object-address",
+      objectAddress,
+      `--profile=${profile ?? "default"}`,
+    ];
+
+    const addressesMap = this.parseNamedAddresses(namedAddresses);
+
+    cliArgs.push(...this.prepareNamedAddresses(addressesMap));
+
+    return this.runCommand(cliArgs);
+  }
+
+  /**
+   * Function to run a Move script, please run compile before running this
+   *
+   * @param args.compiledScriptPath Path to a compiled Move script bytecode file
+   * @param args.namedAddresses  Named addresses for the move binary
+   * @example
+   * build/my_package/bytecode_scripts/my_move_script.mv
+   * @param args.profile optional Profile to use from the config file.
+   *
+   * @returns stdout
+   */
+  async runScript(args: { compiledScriptPath: string; profile?: string }): Promise<{ output: string }> {
+    const { compiledScriptPath, profile } = args;
+    const cliArgs = [
+      "aptos",
+      "move",
+      "run-script",
+      "--compiled-script-path",
+      compiledScriptPath,
+      `--profile=${profile ?? "default"}`,
+    ];
+
+    return this.runCommand(cliArgs);
+  }
+
   /**
    * Run a move command
    *
    * @param args
-   * @returns
+   * @returns stdout
    */
   // eslint-disable-next-line class-methods-use-this
-  private async runCommand(args: Array<string>): Promise<boolean> {
+  private async runCommand(args: Array<string>): Promise<{ output: string }> {
     return new Promise((resolve, reject) => {
       const currentPlatform = platform();
       let childProcess;
+      let stdout = "";
 
       // Check if current OS is windows
       if (currentPlatform === "win32") {
@@ -125,13 +245,17 @@ export class Move {
         childProcess = spawn("npx", args);
       }
 
+      childProcess.stdout.on("data", (data) => {
+        stdout += data.toString();
+      });
+
       childProcess.stdout.pipe(process.stdout);
       childProcess.stderr.pipe(process.stderr);
       process.stdin.pipe(childProcess.stdin);
 
       childProcess.on("close", (code) => {
         if (code === 0) {
-          resolve(true); // Resolve with true if the child process exits successfully
+          resolve({ output: stdout }); // Resolve with stdout if the child process exits successfully
         } else {
           reject(new Error(`Child process exited with code ${code}`)); // Reject with an error if the child process exits with an error code
         }
@@ -186,4 +310,19 @@ export class Move {
 
     return addressesMap;
   }
+
+  /**
+   * Extract object address from the output
+   *
+   * @param output
+   * @returns object address
+   */
+  // eslint-disable-next-line class-methods-use-this
+  private extractAddressFromOutput(output: string): string {
+    const match = output.match("Code was successfully deployed to object address (0x[0-9a-fA-F]+)\\.");
+    if (match) {
+      return match[1];
+    }
+    throw new Error("Failed to extract object address from output");
+  }
 }

package/src/core/index.ts

@@ -1,6 +1,7 @@
 // Copyright © Aptos Foundation
 // SPDX-License-Identifier: Apache-2.0
 
+export * from "./account";
 export * from "./accountAddress";
 export * from "./authenticationKey";
 export * from "./common";