SyncingSubscription

subscribe(“syncing”)

Subscribe to syncing events. This will return true when the node is syncing and when it’s finished syncing will return false, for the changed event.

@example

(await web3.eth.subscribe("syncing")).on("changed", console.log);
> `true` // when syncing

(await web3.eth.subscribe("syncing")).on("data", console.log);
> {
     startingBlock: 0,
     currentBlock: 0,
     highestBlock: 0,
     pulledStates: 0,
     knownStates: 0
  }

Hierarchy

• Web3Subscription<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }>
  • SyncingSubscription

Index

Constructors

• constructor

Properties

• args

Accessors

• id
• lastBlock

Methods

• emit
• eventNames
• getMaxListeners
• listenerCount
• listeners
• off
• on
• once
• removeAllListeners
• resubscribe
• setMaxListenerWarningThreshold
• subscribe
• unsubscribe

Constructors

constructor

• new SyncingSubscription(args: any, options: { requestManager: Web3RequestManager<EthExecutionAPI>; returnFormat?: DataFormat }): SyncingSubscription

• Inherited from Web3Subscription.constructor

  Parameters

  • args: any

  • options: { requestManager: Web3RequestManager<EthExecutionAPI>; returnFormat?: DataFormat }

  Returns SyncingSubscription

Properties

readonlyargs

args: any

Inherited from Web3Subscription.args

Accessors

id

• get id(): undefined | string

• Inherited from Web3Subscription.id

  Returns undefined | string

lastBlock

• get lastBlock(): undefined | BlockOutput

• Inherited from Web3Subscription.lastBlock

  Returns undefined | BlockOutput

Methods

emit

• emit<K>(eventName: K, params: CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]): void

• Inherited from Web3Subscription.emit

  Type parameters

  • K: Web3EventKey<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }>

  Parameters

  • eventName: K

  • params: CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]

  Returns void

eventNames

• eventNames(): (string | symbol)[]

• Inherited from Web3Subscription.eventNames

  Returns (string | symbol)[]

getMaxListeners

• getMaxListeners(): number

• Inherited from Web3Subscription.getMaxListeners

  Returns number

listenerCount

• listenerCount<K>(eventName: K): number

• Inherited from Web3Subscription.listenerCount

  Type parameters

  • K: Web3EventKey<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }>

  Parameters

  • eventName: K

  Returns number

listeners

• listeners<K>(eventName: K): Function[]

• Inherited from Web3Subscription.listeners

  Type parameters

  • K: Web3EventKey<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }>

  Parameters

  • eventName: K

  Returns Function[]

off

• off<K>(eventName: K, fn: Web3EventCallback<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]>): void

• Inherited from Web3Subscription.off

  Type parameters

  • K: Web3EventKey<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }>

  Parameters

  • eventName: K

  • fn: Web3EventCallback<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]>

  Returns void

on

• on<K>(eventName: K, fn: Web3EventCallback<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]>): void

• Inherited from Web3Subscription.on

  Type parameters

  • K: Web3EventKey<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }>

  Parameters

  • eventName: K

  • fn: Web3EventCallback<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]>

  Returns void

once

• once<K>(eventName: K, fn: Web3EventCallback<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]>): void

• Inherited from Web3Subscription.once

  Type parameters

  • K: Web3EventKey<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }>

  Parameters

  • eventName: K

  • fn: Web3EventCallback<CommonSubscriptionEvents & { changed: boolean; data: SyncOutput }[K]>

  Returns void

removeAllListeners

• removeAllListeners(): EventEmitter

• Inherited from Web3Subscription.removeAllListeners

  Returns EventEmitter

resubscribe

• resubscribe(): Promise<void>

• Inherited from Web3Subscription.resubscribe

  Returns Promise<void>

setMaxListenerWarningThreshold

• setMaxListenerWarningThreshold(maxListenersWarningThreshold: number): void

• Inherited from Web3Subscription.setMaxListenerWarningThreshold

  Parameters

  • maxListenersWarningThreshold: number

  Returns void

subscribe

• subscribe(): Promise<void>

• Inherited from Web3Subscription.subscribe

  Returns Promise<void>

unsubscribe

• unsubscribe(): Promise<void>

• Inherited from Web3Subscription.unsubscribe

  Returns Promise<void>