@hashgraph/sdk
    Preparing search index...

    Class WebClient

    Represents a client for interacting with the Hedera network over the web. The WebClient class extends the base Client class and provides methods for configuring and managing connections to the Hedera network, including setting the network type (mainnet, testnet, previewnet) and handling transactions and queries.

    Hierarchy

    • default
      • WebClient
    Index

    Constructors

    constructor

    Properties

    _logger _maxAttempts _realm _shard _timer

    Accessors

    defaultMaxQueryPayment defaultMaxTransactionFee defaultRegenerateTransactionId isClientShutDown ledgerId logger maxAttempts maxBackoff maxNodeAttempts maxNodesPerTransaction maxQueryPayment maxTransactionFee minBackoff mirrorNetwork network networkName networkUpdatePeriod nodeMaxBackoff nodeMaxReadmitPeriod nodeMinBackoff nodeMinReadmitPeriod nodeWaitTime operatorAccountId operatorPublicKey realm requestTimeout shard signOnDemand

    Methods

    _createMirrorNetworkChannel _createNetworkChannel close getOperator isAutoValidateChecksumsEnabled isTransportSecurity ping pingAll setAutoValidateChecksums setDefaultMaxQueryPayment setDefaultMaxTransactionFee setDefaultRegenerateTransactionId setLedgerId setLogger setMaxAttempts setMaxBackoff setMaxNodeAttempts setMaxNodesPerTransaction setMaxQueryPayment setMaxTransactionFee setMinBackoff setMirrorNetwork setNetwork setNetworkFromAddressBook setNetworkName setNetworkUpdatePeriod setNodeMaxBackoff setNodeMaxReadmitPeriod setNodeMinBackoff setNodeMinReadmitPeriod setNodeWaitTime setOperator setOperatorWith setRequestTimeout setSignOnDemand setTransportSecurity updateNetwork _extractShardRealm _validateNetworkConsistency forMainnet forName forNetwork forPreviewnet forTestnet fromConfig

    Constructors

    Properties

    _logger

    _logger: null | Logger

    Logger

    _maxAttempts

    _maxAttempts: null | number

    _realm

    _realm: number

    _shard

    _shard: number

    _timer

    _timer: Timeout

    Accessors

    • get defaultRegenerateTransactionId(): boolean

      Returns boolean

    • get maxNodesPerTransaction(): number

      Returns number

    • get maxTransactionFee(): null | Hbar

      Returns null | Hbar

      • Use defaultMaxTransactionFee instead
    • get networkName(): null | string

      Returns null | string

    • get networkUpdatePeriod(): number

      Returns number

    • get nodeMaxReadmitPeriod(): number

      Returns number

    • get nodeMinReadmitPeriod(): number

      Returns number

    • get requestTimeout(): null | number

      Returns null | number

    Methods

    _createMirrorNetworkChannel

    • _createMirrorNetworkChannel(): (address: string) => any

      Returns (address: string) => any

    _createNetworkChannel

    • _createNetworkChannel(): (address: string) => WebChannel

      Returns (address: string) => WebChannel

    • Returns null | ClientOperator

    • Returns boolean

    • Returns boolean

    • Set the maximum payment allowable for queries.

      Parameters

      • defaultMaxQueryPayment: Hbar

      Returns Client<WebChannel, any>

    • Set the defaultimum fee to be paid for transactions executed by this client.

      Parameters

      • defaultMaxTransactionFee: Hbar

      Returns WebClient

    • Set if a new transaction ID should be generated when a TRANSACTION_EXPIRED status is returned.

      Parameters

      • defaultRegenerateTransactionId: boolean

      Returns WebClient

    • Parameters

      • maxQueryPayment: Hbar

      Returns Client<WebChannel, any>

      in a favor of setDefaultMaxQueryPayment() Set the maximum payment allowable for queries.

    • Parameters

      • maxTransactionFee: Hbar

      Returns WebClient

      • Use setDefaultMaxTransactionFee() instead Set the maximum fee to be paid for transactions executed by this client.

    • Set the account that will, by default, pay for transactions and queries built with this client. NOTE: When using string for private key, the string needs to contain DER headers

      Parameters

      Returns WebClient

    • Sets the account that will, by default, pay for transactions and queries built with this client.

      Parameters

      • accountId: string | AccountId
      • publicKey: string | PublicKey
      • transactionSigner: (message: Uint8Array) => Promise<Uint8Array<ArrayBufferLike>>

      Returns WebClient

    • Parameters

      • signOnDemand: boolean

      Returns void

    Static_extractShardRealm

    • _extractShardRealm(
          network: { [key: string]: string | AccountId },
      ): { realm: number; shard: number }

      Extracts shard and realm values from a network configuration. Note: This method assumes the network is consistent (all nodes in same shard/realm). Use validateNetworkConsistency() first to ensure this.

      Parameters

      • network: { [key: string]: string | AccountId }

      Returns { realm: number; shard: number }

    Static_validateNetworkConsistency

    • _validateNetworkConsistency(
          network: { [key: string]: string | AccountId },
      ): void

      Validates that all nodes in a network are in the same shard and realm.

      Parameters

      • network: { [key: string]: string | AccountId }

      Returns void

    • Construct a client for a specific network.

      It is the responsibility of the caller to ensure that all nodes in the map are part of the same Hedera network. Failure to do so will result in undefined behavior.

      The client will load balance all requests to Hedera using a simple round-robin scheme to chose nodes to send transactions to. For one transaction, at most 1/3 of the nodes will be tried.

      Parameters

      • network: string | { [key: string]: string | AccountId }

      Returns WebClient

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods