@hashgraph/sdk
    Preparing search index...

    Class Client

    Hierarchy

    • default
      • Client
    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 setMaxExecutionTime setMaxNodeAttempts setMaxNodesPerTransaction setMaxQueryPayment setMaxTransactionFee setMinBackoff setMirrorNetwork setNetwork setNetworkFromAddressBook setNetworkName setNetworkUpdatePeriod setNodeMaxBackoff setNodeMaxReadmitPeriod setNodeMinBackoff setNodeMinReadmitPeriod setNodeWaitTime setOperator setOperatorWith setRequestTimeout setSignOnDemand setTransportSecurity updateNetwork _extractShardRealm _validateNetworkConsistency forLocalNode forMainnet forMirrorNetwork forName forNetwork forPreviewnet forTestnet fromConfig fromConfigFile

    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) => NodeMirrorChannel

      Returns (address: string) => NodeMirrorChannel

    _createNetworkChannel

    • _createNetworkChannel(): (address: string, cert?: string) => NodeChannel

      Returns (address: string, cert?: string) => NodeChannel

    • Returns null | ClientOperator

    • Returns boolean

    • Returns boolean

    • Set the maximum payment allowable for queries.

      Parameters

      • defaultMaxQueryPayment: Hbar

      Returns Client<NodeChannel, NodeMirrorChannel>

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

      Parameters

      • defaultMaxTransactionFee: Hbar

      Returns Client

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

      Parameters

      • defaultRegenerateTransactionId: boolean

      Returns Client

    • Parameters

      • maxNodesPerTransaction: number

      Returns Client

    • Parameters

      • maxQueryPayment: Hbar

      Returns Client<NodeChannel, NodeMirrorChannel>

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

    • Parameters

      • maxTransactionFee: Hbar

      Returns Client

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

    • Parameters

      • networkUpdatePeriod: number

      Returns Client

    • Parameters

      • nodeMaxReadmitPeriod: number

      Returns Client

    • Parameters

      • nodeMinReadmitPeriod: number

      Returns 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 Client

    • 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 Client

    • Parameters

      • requestTimeout: number

        Number of milliseconds

      Returns Client

    • Parameters

      • signOnDemand: boolean

      Returns void

    • Parameters

      • transportSecurity: boolean

      Returns Client

    • Update the network address book.

      Returns Promise<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 Hedera client pre-configured for local-node access.

      Parameters

      • Optionalprops: { scheduleNetworkUpdate?: boolean } = ...

      Returns Client

    • Construct a Hedera client pre-configured for Mainnet access.

      Parameters

      • Optionalprops: { scheduleNetworkUpdate?: boolean } = {}

      Returns Client

    • Parameters

      • mirrorNetwork: string | string[]
      • Optionalshard: number
      • Optionalrealm: number

      Returns Promise<Client>

    • Parameters

      • network: string
      • Optionalprops: { scheduleNetworkUpdate?: boolean } = {}

      Returns Client

    • 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: { [key: string]: string | AccountId }
      • Optionalprops: ClientConfiguration

      Returns Client

    • Construct a Hedera client pre-configured for Previewnet access.

      Parameters

      • Optionalprops: { scheduleNetworkUpdate?: boolean } = {}

      Returns Client

    • Construct a Hedera client pre-configured for Testnet access.

      Parameters

      • Optionalprops: { scheduleNetworkUpdate?: boolean } = {}

      Returns Client

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods
    _createMirrorNetworkChannel_createNetworkChannelclosegetOperatorisAutoValidateChecksumsEnabledisTransportSecuritypingpingAllsetAutoValidateChecksumssetDefaultMaxQueryPaymentsetDefaultMaxTransactionFeesetDefaultRegenerateTransactionIdsetLedgerIdsetLoggersetMaxAttemptssetMaxBackoffsetMaxExecutionTimesetMaxNodeAttemptssetMaxNodesPerTransactionsetMaxQueryPaymentsetMaxTransactionFeesetMinBackoffsetMirrorNetworksetNetworksetNetworkFromAddressBooksetNetworkNamesetNetworkUpdatePeriodsetNodeMaxBackoffsetNodeMaxReadmitPeriodsetNodeMinBackoffsetNodeMinReadmitPeriodsetNodeWaitTimesetOperatorsetOperatorWithsetRequestTimeoutsetSignOnDemandsetTransportSecurityupdateNetwork_extractShardRealm_validateNetworkConsistencyforLocalNodeforMainnetforMirrorNetworkforNameforNetworkforPreviewnetforTestnetfromConfigfromConfigFile