v1.8.0

Changed

• Updated sha3 and sha3Raw type definition to accept Buffer (#5357)
• Removing legacy field in lerna.json (#5403)
• Correct eth_sendSignedTransaction code example (#5402)

Fixed

• Browser builds support polyfills (#5031) (#5053) (#4659) (#4767)
• Update node version on actions to fix breaking mosaic test (#5354)
• Start incrementing jsonrpc.id from random number (#5327)
• web3-eth-contract's call and send methods no longer mutate options argument (#5394)
• Improvement using provided gas options in web3-eth-accounts for eip-1559 transactions (#5012)

Added

• Add missing function type "receive" in AbiType (#5165)
• Support of safe and finalized block tags added (#5410)

v1.8.0-rc.0

Changed

• Updated sha3 and sha3Raw type definition to accept Buffer (#5357)
• Removing legacy field in lerna.json (#5403)
• Correct eth_sendSignedTransaction code example (#5402)

Fixed

• Browser builds support polyfills (#5031) (#5053) (#4659) (#4767)
• Update node version on actions to fix breaking mosaic test (#5354)
• Start incrementing jsonrpc.id from random number (#5327)
• web3-eth-contract's call and send methods no longer mutate options argument (#5394)
• Improvement using provided gas options in web3-eth-accounts for eip-1559 transactions (#5012)

Added

• Add missing function type "receive" in AbiType (#5165)
• Support of safe and finalized block tags added (#5410)

v4.0.1-alpha.0

Fixed

• Dependency tree cannot be resolved by Yarn due to old deprecated packages picked by yarn - fixed (#5382)

v4.0.0-alpha.0

Note: Yarn is resolving to some old deprecated package versions for 4.0.0-alpha.0 instead of latest alpha versions. A patch bump is posted so yarn users should use 4.0.1-alpha.0 for testing.

Summary

Web3.js 4.0.0-alpha.0 is a complete overhaul. This alpha version is written in TypeScript and has many exciting features. Features such as:

• Full types support ( including Dynamic Contracts Typing )
• ETH functions optional data formatters
• ETH RPC method wrappers for advance users
• Validation functionality using schema
• Configurable behavior of the sendTransaction
• Easy extensibility and high readability
• Clear specs of base wallet, base providers and much more

Check out our 4.x API documentation (https://docs.web3js.org/) for the full details. The release contains mostly 1.x parity functionality with some documented breaking changes. Most of the packages in this release have been unit tested and only selected packages are E2E tested (web3, web3-eth, web3-contracts, web3-eth-personal, web3-providers-http and web3-providers-ws).

Checkout our 1.x to 4.x migration guide (https://docs.web3js.org/docs/guides/web3_migration_guide) for testing the 4.0.0-alpha.0 release and share your feedback with us.

Added

web3-errors

• web3-errors new package is created, it has Web3 Error codes and classes

web3-types

• web3-types new package is created, it provides the common data structures and interfaces for web3 modules

web3-validator

• web3-validator new package is created, it has JSON-Schema compatible validator functionality for Web3

Removed

web3-bzz

• This Package is deprecated

web3-shh

• This Package is deprecated

web3-core-helpers

• This Package is removed, errors are moved to web3-errors package and formatters are moved in web3-core package

web3-core-method

• This Package is removed, and web3-core-method functionality is moved to web3-eth package

web3-core-promieevent

• This Package is removed, and core promi events functionality is moved to web3-core package

web3-core-requestmanager

• This Package is removed, batch requests and request manager functionality is moved to web3-core package

web3-core-subscription

• This Package is removed, and core subscription functionality is moved to web3-core package

Changed

web3

• Passing callbacks to functions is no longer supported, except for event listeners.
• Method extend is deprecated

web3-core

• The function outputBigNumberFormatter in web3-core-helper renamed to outputBigIntFormatter under web3-core
• Removed this.defaultBlock context from inputDefaultBlockNumberFormatter in web3-core-helper and converted to additional parameter
• Removed this.defaultBlock context from inputTransactionFormatter in web3-core-helper and converted to additional parameter

web3-utils

• The following functions soliditySha3 soliditySha3Raw encodePacked now includes type validation and requires type specification, instead of guessing the value type
• The functions soliditySha3, soliditySha3Raw and encodePacked did not support BN; But, now supports BigInt
• The functions flattenTypes and jsonInterfaceMethodToString moved to the web3-eth-abi package
• The function isAddress now includes an optional parameter checkChecksum type boolean
• isBoolean now accept 1, and 0 as valid values to test. Ref: web3-validator

web3-eth-accounts

• create function does not take in the optional parameter entropy
• Wallet.create function doesn't accept entropy param

web3-validator

• isBoolean now accept 1, and 0 as valid values to test.

web3-eth-contract

• Event logs do not support types for indexed properties, but named properties are supported.
• Types for overloaded ABI functions are not yet supported.
• signTransaction will not fill any default values, and it will only sign and return result. For filling default values, use web3-eth package
• recover function's last param is boolean hashed, it is used to indicate if data provided is already hashed or not. By default, this function will assume data is not hashed.
• The Wallet no longer supports address/number indexing. Have to use wallet.get instead.
• Wallet.create function doesn't accept entropy param
• contract.method.send() will resolve to transaction receipt instead of transactionHash. User can use receipt.transactionHash instead.

web3-net

• Package will not support web3.bzz.net and web3.shh.net

web3-eth-iban

• IBAN constructor now has validation checks for indirect/direct iban.
• isDirect, isValid, isIndirect are now also included as static methods.

web3-eth-ens

• setMultihash is not supported in web3-eth-ens 4.x as it's deprecated in ENS public resolver (https://github.com/ensdomains/resolvers/blob/master/contracts/PublicResolver.sol)
• setContent is not supported in web3-eth-ens 4.x as it's deprecated in ENS public resolver (https://github.com/ensdomains/resolvers/blob/master/contracts/PublicResolver.sol)
• getContent is not supported in web3-eth-ens 4.x as it's deprecated in ENS public resolver.
• getMultihash is not supported in web3-eth-ens 4.x as it's deprecated in ENS public resolver.

web3-eth-abi

• internalType was renamed to baseType in all abi types

web3-eth

• givenProvider default value is undefined
• defaultHardfork default value is 'london'
• defaultAccount default value is undefined
• defaultNetworkId default value is undefined
• When sending a transaction, if Ethereum Node does not respond within transactionSendTimeout, throw an Error.

web3-eth-subscribe

• clearSubscriptions Instead of returning true , clearSubscriptions now returns array of subscription's ids

web3-eth-personal

• givenProvider default value is undefined
• currentProvider default value is undefined

v1.7.5

1.7.5

Changed

• Replace xhr2-cookies deps to cross-fetch for web3-providers-http (#5085)

Added

• Documentation details about maxFeePerGas and maxPriorityFeePerGas (#5121)
• Added createAccessList types in web3.eth (#5146)

Fixed

• Improving AbstractProvider interface (#5150)
• Fix typos in web3-eth-accounts.rst & TESTING.md (#5047)
• Fix remove wallet using an index when an account address and address lowercase are equal (#5049)
• Improve README.md & Fix typos (#4848)
• Add optional hex formatting parameter for getTransactionrReceipt (#5153)
• Fix transactionRoot -> transactionsRoot in BlockHeader (#5083)
• Fix Promise in Accounts.signTransaction() throwing errors that cannot be caught (#4724)
• Fixed unit tests & removed dead code for web3-providers-http (#5228)

Security

• Updated got lib version and fixed other libs using npm audit fix (#5178) (#5254)

v1.7.5-rc.1

Fixed

• Fixed unit tests & removed dead code for web3-providers-http (#5228) It fixed (#5235) and (#5236) Issues.

1.7.5-rc.0

1.7.5-rc.0

Changed

• Replace xhr2-cookies deps to cross-fetch for web3-providers-http (#5085)

Added

• Documentation details about maxFeePerGas and maxPriorityFeePerGas (#5121)
• Added createAccessList types in web3.eth (#5146)

Fixed

• Improving AbstractProvider interface (#5150)
• Fix typos in web3-eth-accounts.rst & TESTING.md (#5047)
• Fix remove wallet using an index when an account address and address lowercase are equal (#5049)
• Improve README.md & Fix typos (#4848)
• Add optional hex formatting parameter for getTransactionrReceipt (#5153)
• Fix transactionRoot -> transactionsRoot in BlockHeader (#5083)
• Fix Promise in Accounts.signTransaction() throwing errors that cannot be caught (#4724)

Security

• Updated got lib version and fixed other libs using npm audit fix (#5178) (#5254)

New Contributors

• @cyborgRen made their first contribution in #5145
• @sangwon0001 made their first contribution in #5142
• @superMDguy made their first contribution in #5116
• @Neurone made their first contribution in #5121
• @mujeebullahkalwar made their first contribution in #5115

v1.7.4

Fixed

• Fix dead link in web3-eth.rst (#4916)
• Fix web3-core-method throws on f.call = this.call when intrinsic is frozen (#4918) (#4938)
• Fix static tuple encoding (#4673) (#4884)
• Fix bug in handleRevert logic for eth_sendRawTransaction (#4902)
• Fix resolve type of getBlock function (#4911)
• Web3-utils BN fix (#5132)

Changed

• Replace deprecated String.prototype.substr() (#4855)
• Exporting AbiCoder as coder (#4937)
• Github build workflow updated min build for node.js 12 and tests for 12, 14 and 16 (#5014)
• Updated libraries using BN and the BN library (#5072)

Added

• Exposing web3.eth.Contract.setProvider() as per public documentation (#4822) (#5001)
• Improve npm script commands for development purposes (#4848)

Security

• npm audit fix to address vulnerabilities and update libraries (#5014)

v1.7.4-rc.2

• Web3-utils BN fix (#5132)

v1.7.4-rc.1

Changed

• Updated libraries using BN and the BN library (#5072)