NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4984 most downloaded on npm
A complete and compact Ethereum library, for dapps, wallets and any other tools.
Latest stable
6.17.0
Last release 5 months ago
18 Jun 2026
Release timing varies
gaps range from 8 days to 7 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
334 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Bumped TypeScript to 4.2.2. (#1288; b2ecffb)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-2l3Oe5AgG/8sQaff0Z5degPMoDwvJ0zkbLaAqtvXxLrw+EW9qOVrLOE3nr1rb9TT"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.32.umd.min.js">
</script>
Prevent unhandled rejections when passing nullish into Contract constructor. (#1234; d937668)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-29tvLBQD8LM0tCcAnma/38UfFSN719h8tcOtD2tY8doQ8uqkNI0vup4PJ75aW04h"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.31.umd.min.js">
</script>
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Bump elliptic version for CVE-2020-28498. (#1284; 796954f)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-ySkqrZJqbKv4yirpTmNOqR/DBK37td1nBEWmrE99X3MDItqpfMPB49m6eCI1JGBW"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.30.umd.min.js">
</script>
Fixed typos in JSON ABI formatting. (#1275; 73b31b3)
Added load balancer support to PocketProvider. (#1052; 27a981c)
Added support for networks with slightly incorrect EIP-658 implementations. (#952, #1251; e727efc)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-6lxCGvVAgmqPqj2aVmq5RZuV7URSGbQcQjg7xYrGMiBN+jNbvTk6kklsBxWqy4kK"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.27.umd.min.js">
</script>
Fixed abundant UnhandledRejectErrors in provider polling. (#1084, #1208, #1221, #1235; 74470de, 20f6e16)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-lx/bREQsHxBzGKC8y4tUIt1LZ/FkCnr/zRfrgW7H+1kJsJmMIFUtxi3FuTwDSQOf"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.26.umd.min.js">
</script>
Safety check on digest length for signing.
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-OX1i+8u9+OeCQi+teohOKipUsePOtMdPgYMBGr8TPkcZJW7z/QeGLa0CTnRhDdkT"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.25.umd.min.js">
</script>
Fixed EIP-712 getPayload dropping EIP712Domain from types for JSON-RPC calls. (#687; d3b1ac0)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-VT2mW1/PG0ZIoeiylULC8gZ+HiMCZMGy13gjNzB51Fd6r3xjUHJQh3GvF1xvCdJ9"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.24.umd.min.js">
</script>
Fix BigNumber when passed something with a length property. (#1172; 45a2902)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-ljKi1eeE5Wpay5gyls2IG/jsGj8PpPTrcIxJibKSOSo2zJk47wsI7ltJ17bSctfF"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.23.umd.min.js">
</script>
Added directory to repo field for each package.
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-8Ya8T4YC9jn20QdRkPGhC2KCvXOFbaq9Moufg1rGngPVUoEyioC3OzBsZGlVtXFZ"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.22.umd.min.js">
</script>
Force address to use bignumber package with base36 private functions. (#1163; c9e5480)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-hOvM/zdPUf0Lst4Eb6WWWkajImS1G0hH0vwOt3Ezx48XdPjW7ASBh9FFIea8Zwkv"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.21.umd.min.js"></script>
Fix browser ws alias for WebSockets.
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-0WOdB5lu8ty1qI0CxYwHc5kc0KD/AezRzPz2E1UM92gRWtlkRNvbG8idr/v2NbDn"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.20.umd.min.js"></script>
Allow 0x as a numeric value for 0 in Provider formatter. (#1104; fe17a29)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-P7kncOVtpRwAc0fW/frkj2Aks3nkSbOQuAd6IWWU3RmjzdfharSfuvKQb2n+9r71"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.19.umd.min.js"></script>
Fix signTypedData call for JsonRpcSigner. (#687; 15a90af)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-Kkkjep9ZYDYViY+W5P53epLjZP7NFSutSXbTe6SPxBqSQueUoZSBuL+RLTNlOaGc"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.18.umd.min.js"></script>
Better error message for parseUnits of non-strings. (#981; 5abc2f3)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-23rrMuY7LwJJcO5grDH9OKOeU4HfHSNeHhW0Pu+nG68UpmdXSzPjmzCfp1S7uSux"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.17.umd.min.js"></script>
ABI encoding performance additions. (#1012; f3e5b0d)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-4R8VWae82dB0T36g027CX6VsgpVZ2mpbVQomHOK+PeNo/1OLxkouBc7OwIMXv9QI"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.16.umd.min.js"></script>
Add more accurate intrinsic gas cost to ABI calls with specified gas property. (#1058; f0a5869)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-0tDIMcQ2DATdcRx86SiV0xZtD8l/oYm9HWPY/sp3rDDNM3jIGyMZSdgTXrcHX7xF"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.15.umd.min.js"></script>
More robust blockchain error detection (#1047; 49f7157)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-hUukOGqsKiA8e7qYShN5fq0K+wWkHX3aLwXfvpNx1knrNc5v2mUyyqVPd5esX5Qf"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.14.umd.min.js"></script>
Force content-length in web fetching.
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-PsAhBAX6BAj/Fg7I441FM6mZH0RNx1yDClwxqrAwVfP9dMmf+/cy8yXWZWcbukJf"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.13.umd.min.js"></script>
Allow events to use compact bytes ABI coded data for Solidity 0.4 external events. (#891, #992; 4e394fc)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-z2tWKIOqj8EVDjDCKzz3csA0efsaDjKVKv259jjWavCDx/5kEgjE20kxTZET+J14"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.12.umd.min.js"></script>
Synced unorm in shims to most recent version.
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-7tDYOlQP/pccDxDPsQ5PCBE3eEVdGTMkpN2FJkbXD9UehYpEUftwHF9ZA7ZWjn6j"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.11.umd.min.js"></script>
Added retry logic to provider tests. (0558bba, 35b64b9, 681f2a5)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-Dc+HsBUC1YthvYln2sx1VuqsAi2Rfvs0yHARBIrvNwEKyIOOHkG/tWfSrGE6ter3"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.10.umd.min.js"></script>
Updated docs for all packages on npm pages. (#1013; cb8f4a3)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-sPwL2x5suqJ3sLS7z6g+BuIJfhNLEmZkcBJAGY6zHPYG6NCrvFJX11Pk0nsqH0LN"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.9.umd.min.js"></script>
Abstract fetchJson for data. (e2d6f28, 2c49a52, e1bbb06)
Fix Logger setLogLevel with enum case mismatch. (#947; 5443363, af10705)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-9oXd0HZjnMdJ/zrFTPfyjNNG21WPZPes7LTgVp5V2XNWvJiEljIWsqCsWfPtOKiL"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.7.umd.min.js"></script>
Removed unnecessary dependency from BigNumber. (#951; 78b350b)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-bGyQrmMRrzXQ9eGLai4Ih/i9vKaln27v6Yskj4Hq4aYDvS7uBJrMMEGydeAZiMK6"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.6.umd.min.js"></script>
Fixed splitSignature when recoveryParam is encoded directly. (#893, #933; bf65ddb)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-NdM0ElaWRs5r57X33JWZZs7yaE3KTyD2IXHjKEvTqo6Wxg0i5eS8zmGJBnx12mAk"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.5.umd.min.js"></script>
Prevent negative exponents in BigNumber. (#925; 84e253f)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-1o/lwl1lI8yVy5nugfaDOtv1OZy4qjx5HTTzDueTxpBJa/k/c9LPkjH+UC59vsdC"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.4.umd.min.js"></script>
Removed deprecated errors package.
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-hvpa3qxW0yDav4AdLsb7Knfmqu8NWTvjNrpTJYrL7Yv+vPLwpZD03I5RKb7nV3GU"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.3.umd.min.js"></script>
Allow provider.ready to stall until the network is available. (#882; bbb4f40)
Embedding UMD with SRI:
<script type="text/javascript"
integrity="sha384-XR63rSjgEtGAUiPqyr3lc6BAyN9JgrFKLrbnivkRp+xv3fE5XexgjsVM0x11x+9o"
crossorigin="anonymous"
src="https://cdn-cors.ethers.io/lib/ethers-5.0.2.umd.min.js"></script>
Fixed embedded package version strings.
Embedding UMD with [SRI](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity): `html `
Allow undefined properties in transaction object and fix stray this. (#860; 98bb589, d2406c4)
Simplify typing for properties module.
Make filter blockHash property name match EIP-234. (b03c4ed, ed29fac)
Add sub-error to gas estimate error for Ganache users. (#829; 647fbd8)
Fix JsonRpcProvider out-of-order super call. (#822; 963197d)
More robust FallbackProvider on clean exits.
Removed old EIP-1193 experimental provider; it can now be supported by Web3Provider as EIP-1193 is now backwards compatible.
Fixed inconsistent log format in WebSocketProvider. (#795; 8e7751f)
Added support for Contract event parsing error recovery.
Temporarily remove CloudflareProvider tests; it is down and breaking the tests.
Correctly return the Provider in NonceManager.
Fixed ENS CLI lookup for Website.
Fixed Event args keyword access. (2692e78, 092ce9b)
Abstracted JSON-RPC parameter generation for others to use.
Checking in initial Eip1193Bridge (experimental).
Fix address-less filter listening in Provider. (#741; 64dccb2)
Reduced default Provider quorum for testnets.
Added experimental EipWrappedProvider.
Safer transaction serialization, matching signature.v with chainId. (#708; edb7c5d)
Better solc support in CLI; it will search the local pacakge for an existing solc version.
Better, easier and more provider testing.
Refactor some enum names and add UTF-8 error support to the umbrella package.
Much more resiliant FallbackProvider which can ignore properties that are only approximate and supports per-provider priorities. (#635, #588; f4bcf24)
Fixed testcases for provider changes.
Relaxed joinSignature API to allow SignauteLike.
One column per quarter.