The JsonRpcApiProvider is an abstract class and MUST be sub-classed. It provides the base for all JSON-RPC-based Provider interaction. Sub-classing Notes:
  • A sub-class MUST override _send
  • A sub-class MUST call the _start() method once connected

​
Extends

​
Extended by

​
Type parameters

Type parameterValue
CFetchRequest

​
Constructors

​
new JsonRpcApiProvider()

new JsonRpcApiProvider<C>(network?, options?): JsonRpcApiProvider<C>
Creates a new JsonRpcApiProvider instance.

​
Parameters

ParameterTypeDescription
network?NetworkishThe network to connect to.
options?JsonRpcApiProviderOptionsThe options for the provider.

​
Returns

JsonRpcApiProvider<C>

​
Overrides

AbstractProvider.constructor

​
Source

providers/provider-jsonrpc.ts:784

​
Accessors

​
connect

get connect(): FetchRequest[]
Get the list of connected FetchRequests.

​
Returns

FetchRequest[] The list of connected FetchRequests.

​
Source

providers/abstract-provider.ts:1026

​
destroyed

get destroyed(): boolean
If this provider has been destroyed using the destroy method. Once destroyed, all resources are reclaimed, internal event loops and timers are cleaned up and no further requests may be sent to the provider.

​
Returns

boolean

​
Source

providers/abstract-provider.ts:2545

​
paused

get paused(): boolean
Whether the provider is currently paused. A paused provider will not emit any events, and generally should not make any requests to the network, but that is up to sub-classes to manage. Setting paused = true is identical to calling .pause(false), which will buffer any events that occur while paused until the provider is unpaused.

​
Returns

boolean Whether the provider is paused.

​
Source

providers/abstract-provider.ts:2577

​
pollingInterval

get pollingInterval(): number
Get the polling interval.

​
Returns

number The polling interval.

​
Source

providers/abstract-provider.ts:1183

​
provider

get provider(): this
Returns this, to allow an AbstractProvider to implement the Contract Runner interface.

​
Returns

this The provider instance.

​
Source

providers/abstract-provider.ts:1193

​
ready

get ready(): boolean
Returns true only if the JsonRpcApiProvider._start | _start has been called.

​
Returns

boolean True if the provider is ready.

​
Source

providers/provider-jsonrpc.ts:1117

​
Methods

​
_clearTimeout()

_clearTimeout(timerId): void
Clear a timer created using the AbstractProvider._setTimeout | _setTimeout method.

​
Parameters

ParameterTypeDescription
timerIdnumberThe ID of the timer to clear.

​
Returns

void

​
Inherited from

AbstractProvider._clearTimeout

​
Source

providers/abstract-provider.ts:2221

​
destroy()

destroy(): void
Destroys the provider, stopping all processing and canceling all pending requests.

​
Returns

void

​
Overrides

AbstractProvider.destroy

​
Source

providers/provider-jsonrpc.ts:1587

​
getActiveRegions()

getActiveRegions(): Promise<Shard[]>
Get the active region shards based on the protocol expansion number.

​
Returns

Promise<Shard[]> A promise that resolves to the active shards.

​
Inherited from

AbstractProvider.getActiveRegions

​
Source

providers/abstract-provider.ts:1110

​
getActiveZones()

getActiveZones(): Promise<Zone[]>
Get the active zones for a shard based on the protocol expansion number.

​
Returns

Promise<Zone[]> A promise that resolves to the active zones.

​
Inherited from

AbstractProvider.getActiveZones

​
Source

providers/abstract-provider.ts:1127

​
getLatestQiToQuaiRate()

getLatestQiToQuaiRate(zone, amt?): Promise<bigint>
Get the latest Qi rate for a zone.

​
Parameters

ParameterTypeDescription
zoneZoneThe zone to get the rate for.
amt?bigintThe amount to get the rate for. Default is 1

​
Returns

Promise<bigint> A promise that resolves to the latest Qi rate.

​
Inherited from

AbstractProvider.getLatestQiToQuaiRate

​
Source

providers/abstract-provider.ts:1149

​
getLatestQuaiToQiRate()

getLatestQuaiToQiRate(zone, amt?): Promise<bigint>
Get the latest Quai rate for a zone.

​
Parameters

ParameterTypeDescription
zoneZoneThe zone to get the rate for.
amt?bigintThe amount in quais to get the rate for. Default is 1

​
Returns

Promise<bigint> A promise that resolves to the latest Quai -> Qi rate for the given amount.

​
Inherited from

AbstractProvider.getLatestQuaiToQiRate

​
Source

providers/abstract-provider.ts:1068

​
getProtocolExpansionNumber()

getProtocolExpansionNumber(): Promise<number>
Get the protocol expansion number.

​
Returns

Promise<number> A promise that resolves to the protocol expansion number.

​
Inherited from

AbstractProvider.getProtocolExpansionNumber

​
Source

providers/abstract-provider.ts:1101

​
getQiToQuaiRateAtBlock()

getQiToQuaiRateAtBlock(
   zone, 
   blockTag, 
amt?): Promise<bigint>
Get the Qi rate at a specific block.

​
Parameters

ParameterTypeDescription
zoneZoneThe zone to get the rate for.
blockTagBlockTagThe block tag to get the rate at.
amt?bigintThe amount to get the rate for. Default is 1

​
Returns

Promise<bigint> A promise that resolves to the Qi rate at the specified block.

​
Inherited from

AbstractProvider.getQiToQuaiRateAtBlock

​
Source

providers/abstract-provider.ts:1162

​
getQuaiToQiRateAtBlock()

getQuaiToQiRateAtBlock(
   zone, 
   blockTag, 
amt?): Promise<bigint>
Get the Quai rate at a specific block.

​
Parameters

ParameterTypeDescription
zoneZoneThe zone to get the rate for.
blockTagBlockTagThe block tag to get the rate at.
amt?bigintThe amount to get the rate for. Default is 1

​
Returns

Promise<bigint> A promise that resolves to the Quai rate at the specified block.

​
Inherited from

AbstractProvider.getQuaiToQiRateAtBlock

​
Source

providers/abstract-provider.ts:1081

​
getSigner()

getSigner(address?): Promise<JsonRpcSigner>
Returns a JsonRpcSigner for the given address.

​
Parameters

ParameterTypeDescription
address?string | numberThe address or index of the account.

​
Returns

Promise<JsonRpcSigner> A promise that resolves to the JsonRpcSigner.

​
Throws

If the account is invalid.

​
Source

providers/provider-jsonrpc.ts:1542

​
initialize()

initialize<U>(urls): Promise<void>
Initialize the URL map with the provided URLs.

​
Type parameters

Type parameterValue
Ustring[] | FetchRequest

​
Parameters

ParameterTypeDescription
urlsUThe URLs to initialize the map with.

​
Returns

Promise<void> A promise that resolves when the map is initialized.

​
Inherited from

AbstractProvider.initialize

​
Source

providers/abstract-provider.ts:874

​
listAccounts()

listAccounts(): Promise<JsonRpcSigner[]>
Returns a list of JsonRpcSigners for all accounts.

​
Returns

Promise<JsonRpcSigner[]> A promise that resolves to an array of JsonRpcSigners.

​
Source

providers/provider-jsonrpc.ts:1579

​
pause()

pause(dropWhilePaused?): void
Pause the provider. If dropWhilePaused, any events that occur while paused are dropped, otherwise all events will be emitted once the provider is unpaused.

​
Parameters

ParameterTypeDescription
dropWhilePaused?booleanWhether to drop events while paused.

​
Returns

void

​
Inherited from

AbstractProvider.pause

​
Source

providers/abstract-provider.ts:2598

​
resume()

resume(): void
Resume the provider.

​
Returns

void

​
Inherited from

AbstractProvider.resume

​
Source

providers/abstract-provider.ts:2627

​
send()

send(
   method, 
   params, 
   shard?, 
now?): Promise<any>
Requests the method with params via the JSON-RPC protocol over the underlying channel. This can be used to call methods on the backend that do not have a high-level API within the Provider API. This method queues requests according to the batch constraints in the options, assigns the request a unique ID. Do NOT override this method in sub-classes; instead override JsonRpcApiProvider._send | _send or force the options values in the call to the constructor to modify this method’s behavior.

​
Parameters

ParameterTypeDescription
methodstringThe method to call.
paramsany[] | Record<string, any>The parameters to pass to the method.
shard?ShardThe shard to send the request to.
now?booleanIf true, the request will be sent immediately.

​
Returns

Promise<any> A promise that resolves to the result of the method call.

​
Source

providers/provider-jsonrpc.ts:1500

​
shardFromHash()

shardFromHash(hash): Shard
Get the shard from a hash.

​
Parameters

ParameterTypeDescription
hashstringThe hash to get the shard from.

​
Returns

Shard The shard.

​
Inherited from

AbstractProvider.shardFromHash

​
Source

providers/abstract-provider.ts:1047

​
zoneFromAddress()

zoneFromAddress(_address): Promise<Zone>
Get the zone from an address.

​
Parameters

ParameterTypeDescription
_addressAddressLikeThe address to get the zone from.

​
Returns

Promise<Zone> A promise that resolves to the zone.

​
Inherited from

AbstractProvider.zoneFromAddress

​
Source

providers/abstract-provider.ts:1036

​
zoneFromHash()

zoneFromHash(hash): Zone
Get the zone from a hash.

​
Parameters

ParameterTypeDescription
hashstringThe hash to get the zone from.

​
Returns

Zone The zone.

​
Inherited from

AbstractProvider.zoneFromHash

​
Source

providers/abstract-provider.ts:1057