@hashgraph/sdk
    Preparing search index...

    Class Client

    Hierarchy

    • default
      • Client
    Index

    Constructors

    constructor

    Properties

    _isUpdatingNetwork _logger _maxAttempts _realm _shard _timer

    Accessors

    defaultMaxQueryPayment defaultMaxTransactionFee defaultRegenerateTransactionId isClientShutDown ledgerId logger maxAttempts maxBackoff maxNodeAttempts maxNodesPerTransaction maxQueryPayment maxTransactionFee minBackoff mirrorNetwork mirrorRestApiBaseUrl 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 forMainnetAsync forMirrorNetwork forName forNameAsync forNetwork forPreviewnet forPreviewnetAsync forTestnet forTestnetAsync fromConfig fromConfigFile

    Constructors

    Properties

    _isUpdatingNetwork

    _isUpdatingNetwork: boolean

    _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

      Gets the maximum number of nodes that a transaction or query will attempt to execute against.

      Returns number

      The current maximum nodes per transaction setting. Returns -1 if no limit is set (uses network defaults).

    • get maxTransactionFee(): null | Hbar

      Returns null | Hbar

      • Use defaultMaxTransactionFee instead
    • get mirrorRestApiBaseUrl(): string

      Returns string

      When no mirror network is configured or available

    • 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

    • Sets the maximum number of nodes that a transaction or query will execute against.

      • Before freezing: Limits automatic node selection when no explicit nodes are set
      • After freezing: Trims frozen transactions to the first N nodes while preserving signatures
      • Special values: 0 disables limiting, values > available nodes cause no trimming

      Parameters

      • maxNodesPerTransaction: number

        Maximum nodes per transaction. Set to 0 to disable.

      Returns Client

      The client instance for method chaining

    • 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

    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

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

      Parameters

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

      Returns Promise<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 with optional network update. Updates network only if the network is not "local-node".

      Parameters

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

      Returns Promise<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 Previewnet access with network update.

      Parameters

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

      Returns Promise<Client>

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

      Parameters

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

      Returns Client

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

      Parameters

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

      Returns Promise<Client>

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods
    _createMirrorNetworkChannel_createNetworkChannelclosegetOperatorisAutoValidateChecksumsEnabledisTransportSecuritypingpingAllsetAutoValidateChecksumssetDefaultMaxQueryPaymentsetDefaultMaxTransactionFeesetDefaultRegenerateTransactionIdsetLedgerIdsetLoggersetMaxAttemptssetMaxBackoffsetMaxExecutionTimesetMaxNodeAttemptssetMaxNodesPerTransactionsetMaxQueryPaymentsetMaxTransactionFeesetMinBackoffsetMirrorNetworksetNetworksetNetworkFromAddressBooksetNetworkNamesetNetworkUpdatePeriodsetNodeMaxBackoffsetNodeMaxReadmitPeriodsetNodeMinBackoffsetNodeMinReadmitPeriodsetNodeWaitTimesetOperatorsetOperatorWithsetRequestTimeoutsetSignOnDemandsetTransportSecurityupdateNetwork_extractShardRealm_validateNetworkConsistencyforLocalNodeforMainnetforMainnetAsyncforMirrorNetworkforNameforNameAsyncforNetworkforPreviewnetforPreviewnetAsyncforTestnetforTestnetAsyncfromConfigfromConfigFile