Web Utilities

ethers . utils . fetchJson ( urlOrConnectionInfo [ , json [ , processFunc ] ] ) Promise< any >

Fetch and parse the JSON content from urlOrConnectionInfo, with the optiona body json and optionally processing the result with processFun before returning it.

ethers . utils . poll ( pollFunc [ , options ] ) Promise< any >

Repeatedly call pollFunc using the Poll Options until it returns a value other than undefined.

Connection Info

connection . url string

The URL to connect to.

connection . user string

The username to use for Basic Authentication. The default is null (i.e. do not use basic authentication)

connection . password string

The password to use for Basic Authentication. The default is null (i.e. do not use basic authentication)

connection . allowInsecureAuthentication boolean

Allow Basic Authentication over non-secure HTTP. The default is false.

connection . timeout number

How long to wait before rejecting with a timeout error.

connection . headers {[key:string]:string}

Additional headers to include in the connection.

Poll Options

options . timeout number

The amount of time allowed to ellapse before triggering a timeout error.

options . floor number

The minimum time limit to allow for Exponential Backoff.

The default is 0s.

options . ceiling number

The maximum time limit to allow for Exponential Backoff.

The default is 10s.

options . interval number

The interval used during Exponential Backoff calculation.

The default is 250ms.

options . retryLimit number

The number of times to retry in the event of an error or undefined is returned.

options . onceBlock Provider

If this is specified, the polling will wait on new blocks from provider before attempting the pollFunc again.