ethers.js/docs/v5/api/providers/jsonrpc-provider
2021-02-08 15:26:10 -05:00
..
index.html docs: commit built docs 2021-02-08 15:26:10 -05:00
README.md docs: commit built docs 2021-02-08 15:26:10 -05:00

Documentation: html

JsonRpcProvider

**new **ethers . providers . JsonRpcProvider( [ urlOrConnectionInfo [ , networkish ] ] )

Connect to a JSON-RPC HTTP API using the URL or ConnectionInfo urlOrConnectionInfo connected to the networkish network.

If urlOrConnectionInfo is not specified, the default (i.e. http://localhost:8545) is used and if no network is specified, it will be determined automatically by querying the node using eth_chaindId and falling back on eth_networkId.

Note: Connecting to a Local Node

Each node implementation is slightly different and may require specific command-line flags, configuration or settings in their UI to enable JSON-RPC, unlock accounts or expose specific APIs. Please consult their documentation.

jsonRpcProvider . getSigner( [ addressOrIndex ] ) => JsonRpcSigner

Returns a JsonRpcSigner which is managed by this Ethereum node, at addressOrIndex. If no addressOrIndex is provided, the first account (account #0) is used.

jsonRpcProvider . getUncheckedSigner( [ addressOrIndex ] ) => JsonRpcUncheckedSigner

jsonRpcProvider . listAccounts( ) => Array< string >

Returns a list of all account addresses managed by this provider.

jsonRpcProvider . send( method , params ) => Promise< any >

Allows sending raw messages to the provider.

This can be used for backend-specific calls, such as for debugging or specific account management.

JsonRpcSigner

signer . provider => JsonRpcProvider

The provider this signer was established from.

signer . connectUnchecked( ) => JsonRpcUncheckedSigner

Returns a new Signer object which does not perform additional checks when sending a transaction. See getUncheckedSigner for more details.

signer . sendUncheckedTransaction( transaction ) => Promise< string< DataHexString< 32 > > >

Sends the transaction and returns a Promise which resolves to the opaque transaction hash.

signer . unlock( password ) => Promise< boolean >

Request the node unlock the account (if locked) using password.

JsonRpcUncheckedSigner

Node-Specific Methods