Class General

constructor

• new General(config): General

• Initializes a new instance of the Aptos client with the specified configuration. This allows users to interact with the Aptos blockchain using the provided settings.

  Parameters

  • config: AptosConfig

    The configuration settings for the Aptos client.

  Returns General

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  async function runExample() {
      // Create a configuration for the Aptos client
      const config = new AptosConfig({
          network: Network.TESTNET, // specify the network
          nodeUrl: "https://testnet.aptos.dev" // specify the node URL
      });
  
      // Initialize the Aptos client with the configuration
      const aptos = new Aptos(config);
  
      console.log("Aptos client initialized:", aptos);
  }
  runExample().catch(console.error);
  Copy

getBlockByHeight

• getBlockByHeight(args): Promise<Block>

• Retrieve a block by its height, allowing for the inclusion of transactions if specified.

  Parameters

  • args: {
        blockHeight: AnyNumber;
        options?: {
            withTransactions?: boolean;
        };
    }

    The parameters for the block retrieval.

    • blockHeight: AnyNumber

      The block height to look up, starting at 0.

    • Optionaloptions?: {
          withTransactions?: boolean;
      }

      Optional settings for the retrieval.

      • OptionalwithTransactions?: boolean

  Returns Promise<Block>

  The block with optional transactions included.

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Retrieve the block at height 5, including transactions
    const block = await aptos.getBlockByHeight({ blockHeight: 5, options: { withTransactions: true } });
    console.log(block);
  }
  runExample().catch(console.error);
  Copy

getBlockByVersion

• getBlockByVersion(args): Promise<Block>

• Retrieves block information by the specified ledger version.

  Parameters

  • args: {
        ledgerVersion: AnyNumber;
        options?: {
            withTransactions?: boolean;
        };
    }

    The arguments for retrieving the block.

    • ledgerVersion: AnyNumber

      The ledger version to lookup block information for.

    • Optionaloptions?: {
          withTransactions?: boolean;
      }

      Optional parameters for the request.

      • OptionalwithTransactions?: boolean

  Returns Promise<Block>

  Block information with optional transactions.

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Retrieve block information for a specific ledger version
    const block = await aptos.getBlockByVersion({ ledgerVersion: 5 });
    console.log(block);
  }
  runExample().catch(console.error);
  Copy

getChainId

• getChainId(): Promise<number>

• Retrieves the chain ID of the Aptos blockchain.

  Returns Promise<number>

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Fetching the chain ID
    const chainId = await aptos.getChainId();
    console.log("Chain ID:", chainId);
  }
  runExample().catch(console.error);
  
  @returns The chain ID of the Aptos blockchain.
  Copy

getChainTopUserTransactions

• getChainTopUserTransactions(args): Promise<{
      version: any;
  }[]>

• Queries the top user transactions based on the specified limit.

  Parameters

  • args: {
        limit: number;
    }

    The arguments for querying top user transactions.

    • limit: number

      The number of transactions to return.

  Returns Promise<{
      version: any;
  }[]>

  GetChainTopUserTransactionsResponse

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Fetch the top user transactions with a limit of 5
    const topUserTransactions = await aptos.getChainTopUserTransactions({ limit: 5 });
  
    console.log(topUserTransactions);
  }
  runExample().catch(console.error);
  Copy

getIndexerLastSuccessVersion

• getIndexerLastSuccessVersion(): Promise<bigint>

• Queries for the last successful indexer version, providing insight into the ledger version the indexer is updated to, which may lag behind the full nodes.

  Returns Promise<bigint>

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Get the last successful indexer version
    const version = await aptos.getIndexerLastSuccessVersion();
    console.log(`Last successful indexer version: ${version}`);
  }
  runExample().catch(console.error);
  Copy

getLedgerInfo

• getLedgerInfo(): Promise<LedgerInfo>

• Queries for the Aptos ledger information.

  Returns Promise<LedgerInfo>

  The Aptos Ledger Info, which includes details such as chain ID, epoch, and ledger version.

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Fetching the ledger information
    const ledgerInfo = await aptos.getLedgerInfo();
  
    console.log(ledgerInfo);
  }
  runExample().catch(console.error);
  Copy

getProcessorStatus

• getProcessorStatus(processorType): Promise<{
      last_success_version: any;
      last_updated: any;
      processor: string;
  }>

• Query the processor status for a specific processor type.

  Parameters

  • processorType: ProcessorType

    The processor type to query.

  Returns Promise<{
      last_success_version: any;
      last_updated: any;
      processor: string;
  }>

  The status of the specified processor type.

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Get the processor status for the account transactions processor
    const status = await aptos.getProcessorStatus("account_transactions_processor");
    console.log(status);
  }
  runExample().catch(console.error);
  Copy

queryIndexer

• queryIndexer<T>(args): Promise<T>

• Retrieves data from the Aptos Indexer using a GraphQL query. This function allows you to execute complex queries to fetch specific data from the Aptos blockchain.

  Type Parameters

  • T extends {}

  Parameters

  • args: {
        query: GraphqlQuery;
    }

    • query: GraphqlQuery

  Returns Promise<T>

  The provided T type.

  Example

  import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
  
  const config = new AptosConfig({ network: Network.TESTNET });
  const aptos = new Aptos(config);
  
  async function runExample() {
    // Querying the Aptos Indexer for ledger information
    const topUserTransactions = await aptos.queryIndexer({
      query: `query MyQuery {
        ledger_infos {
          chain_id
        }
      }`
    });
  
    console.log(topUserTransactions);
  }
  runExample().catch(console.error);
  Copy

view

• view<T>(args): Promise<T>

• Queries for a Move view function

  Type Parameters

  • T extends MoveValue[]

  Parameters

  • args: {
        options?: LedgerVersionArg;
        payload: InputViewFunctionData;
    }

    • Optionaloptions?: LedgerVersionArg

    • payload: InputViewFunctionData

      Payload for the view function

  Returns Promise<T>

  an array of Move values

  Example

  const data = await aptos.view({
   payload: {
    function: "0x1::coin::balance",
    typeArguments: ["0x1::aptos_coin::AptosCoin"],
    functionArguments: [accountAddress],
   }
  })
  Copy

viewJson

• viewJson<T>(args): Promise<T>

• Queries for a Move view function with JSON, this provides compatability with the old aptos package

  Type Parameters

  • T extends MoveValue[]

  Parameters

  • args: {
        options?: LedgerVersionArg;
        payload: InputViewFunctionJsonData;
    }

    • Optionaloptions?: LedgerVersionArg

    • payload: InputViewFunctionJsonData

      Payload for the view function

  Returns Promise<T>

  an array of Move values

  Example

  const data = await aptos.view({
   payload: {
    function: "0x1::coin::balance",
    typeArguments: ["0x1::aptos_coin::AptosCoin"],
    functionArguments: [accountAddress.toString()],
   }
  })
  Copy

Readonlyconfig