# @ethersproject/experimental

> Experimental libraries for ethers. These should not be considered stable.

Latest version **5.8.0** (published 2025-02-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install @ethersproject/experimental
pnpm add @ethersproject/experimental
yarn add @ethersproject/experimental
bun add @ethersproject/experimental
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 5.8.0 |
| Published | 2025-02-26 |
| First published | 2019-03-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 92.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8713 |
| Author | Richard Moore |
| Maintainers | ricmoo |
| Keywords | Ethereum, ethers |

## Links

- npm: https://www.npmjs.com/package/@ethersproject/experimental
- Repository: https://github.com/ethers-io/ethers.js
- Homepage: https://github.com/ethers-io/ethers.js#readme
- Issues: https://github.com/ethers-io/ethers.js/issues
- Funding: https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2
- npm.io page: https://npm.io/package/@ethersproject/experimental

## Dependencies (3)

- [ethers](https://npm.io/package/ethers.md) ^5.8.0
- [scrypt-js](https://npm.io/package/scrypt-js.md) 3.0.1
- [@ethersproject/web](https://npm.io/package/@ethersproject/web.md) ^5.8.0

## Recent versions

- 5.8.0 (latest) — 2025-02-26
- 5.7.0 — 2022-08-19
- 5.6.3 — 2022-06-18
- 5.6.2 — 2022-05-24
- 5.6.1 — 2022-05-14
- 5.6.0 — 2022-03-10
- 5.5.0 — 2021-10-20
- 5.4.0 — 2021-06-26
- 5.3.0 — 2021-06-01
- 5.2.0 — 2021-05-20
- 5.1.2 — 2021-04-20
- 5.1.1 — 2021-04-18
- 5.1.0 — 2021-03-30
- 5.0.10 — 2021-03-08
- 5.0.9 — 2021-02-01
- … 35 more at https://npm.io/package/@ethersproject/experimental/versions

## README

Experimental Playground
=======================

This package is a collection of quick little ideas, which may be half-baked.

If you find a particular feature piques your interest, please feel free to open
an issue on GitHub to discuss it.

Also, if you have any system that requires an object from this package, make sure
you specify the **exact npm version** in your package.json, as backwards compatibility
is **NOT** guaranteed for this package; APIs may change and classes may disappear.


Items
-----

**BrainWallet**

In general, a Brain Wallet is not recommended, but it is a feature we offered in v3
and below. It allows a wallet to be described and recovered using a username and a
password. However, anyone who can guess a username and password can steal the funds,
and the password cannot be changed. But for backwards compatibility and for simple
testing, we provide it here.

```javascript
import { BrainWallet } from "@ethersproject/experimental/brain-wallet";

// This is optional, but since a Brain Wallet can take 5-10s to generate,
// helps keep your users informed
function showProgress(percent) {
    if (percent === 1) {
        console.log("Done.");
    } else {
        console.log("Completed: " + Math.trunc(100 * percent) + "%");
    }
}

// Generate a legacy-compatible Brain Wallet
BrainWallet.generateLegacy(username, password, showProgress).then((wallet) => {
    console.log(wallet);
});

// Generate a new-style Brain Wallet, which contains a Mnemonic Phrase too
BrainWallet.generate(username, password, showProgess).then((wallet) => {
    console.log(wallet);
});
```

**NonceManager**

```javascript
import { NonceManager } from "@ethersproject/experimental/nonce-manager";

let signer = "... any way you get a signer ...";

// The NonceManager Signer will automatically manage the nonce for you
// so you may blast the network with as many transactions as you would
// like. Transactions which have not been mined within XXX timeout and
// will be rebroadcast; keep in mind that unmined transactions remain
// in memory.
const managedSigner = new NonceManager(signer);
```

**Eip1193Bridge**

```javascript
import { Eip1193Bridge } from "@ethersproject/experimental/retry-provider";

const signer = "... any way you get an ethers Signer...";
const provider = "... any way you get an ethers Provider...";

const eip1193Provider = new Eip1193Provider(signer, provider);

```


License
-------

MIT License.

---
_Source: https://npm.io/package/@ethersproject/experimental · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._