ethers.js/docs.wrm/api/experimental.wrm

66 lines
2.6 KiB
Plaintext
Raw Normal View History

2020-04-17 05:25:05 +03:00
_section: Experimental
The **Experimental** package is used for features that are not ready
to be included in the base library. The API should not be considered
stable and does not follow [[link-semver]] versioning, so applications
requiring it should specify the //exact version// needed.
2020-05-08 10:24:40 +03:00
_subsection: BrainWallet @<experimental-brainwallet> @INHERIT<[[Wallet]]>
2020-04-17 05:25:05 +03:00
Ethers removed support for BrainWallets in v4, since they are unsafe and
many can be easily guessed, allowing attackers to steal the funds. This
class is offered to ensure older systems which used brain wallets can
still recover their funds and assets.
_property: BrainWallet.generate(username, password [ , progressCallback ]) => [[experimental-brainwallet]]
Generates a brain wallet, with a slightly improved experience, in which
the generated wallet has a mnemonic.
_property: BrainWallet.generateLegacy(username, password [ , progressCallback ]) => [[experimental-brainwallet]]
2020-10-03 19:30:15 +03:00
Generate a brain wallet which is compatible with the ethers v3 and earlier.
2020-04-17 05:25:05 +03:00
_subsection: EIP1193Bridge @<experimental-eip1193bridge> @INHERIT<[[link-npm-events]]>
2020-05-08 10:24:40 +03:00
The **EIP1193Bridge** allows a normal Ethers [[Signer]] and [[Provider]] to be
2020-04-17 05:25:05 +03:00
exposed in as a standard [EIP-1193 Provider](link-eip-1193), which may be useful
when interacting with other libraries.
2020-05-08 10:24:40 +03:00
_subsection: NonceManager @<experimental-noncemanager> @INHERIT<[[Signer]]>
2020-04-17 05:25:05 +03:00
The **NonceManager** is designed to manage the nonce for a Signer,
automatically increasing it as it sends transactions.
Currently the NonceManager does not handle re-broadcast. If you attempt
to send a lot of transactions to the network on a node that does not
control that account, the transaction pool may drop your transactions.
In the future, it'd be nice if the **NonceManager** remembered transactions
and watched for them on the network, rebroadcasting transactions that
appear to have been dropped.
Another future feature will be some sort of failure mode. For example, often
a transaction is dependent on another transaction being mined first.
_property: new NonceManager(signer)
Create a new NonceManager.
2020-05-08 10:24:40 +03:00
_property: nonceManager.signer => [[Signer]]
2020-04-17 05:25:05 +03:00
The signer whose nonce is being managed.
2020-05-08 10:24:40 +03:00
_property: nonceManager.provider => [[Provider]]
2020-04-17 05:25:05 +03:00
The provider associated with the signer.
_property: nonceManager.setTransactionCount(count) => void
Set the current transaction count (nonce) for the signer.
2020-11-23 07:03:50 +03:00
This may be useful in interacting with the signer outside of using
2020-04-17 05:25:05 +03:00
this class.
_property: nonceManager.increaseTransactionCount( [ count = 1 ]) => void
Bump the current transaction count (nonce) by //count//.
2020-11-23 07:03:50 +03:00
This may be useful in interacting with the signer outside of using
2020-04-17 05:25:05 +03:00
this class.