Fixed

web3

• Fixed bug #6236 by adding personal type in web3.eth (#6245)

web3-rpc-methods

• Rpc method getPastLogs accept blockHash as a parameter https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getlogs (#6181)

web3-types

• type Filter includes blockHash (#6206)

web3-utils

• BigInts pass validation within the method numberToHex (#6206)

Changed

web3-core

• Dependencies updated

web3-errors

• Dependencies updated

web3-eth

• Dependencies updated

web3-eth-abi

• Dependencies updated

web3-eth-accounts

• Dependencies updated

web3-eth-contract

• Dependencies updated

web3-eth-ens

• Dependencies updated

web3-eth-iban

• Dependencies updated

web3-eth-personal

• Dependencies updated

web3-net

• Dependencies updated

web3-providers-http

• Dependencies updated

web3-providers-ipc

• Dependencies updated

web3-providers-ws

• Dependencies updated

web3-validator

• Dependencies updated

Fixed

web3

• Fixed bug #6185, now web3.js compiles on typescript v5 (#6195)
• Fixed #6162 @types/ws issue (#6205)

web3-core

• Fixed Batch requests erroring out on one request (#6164)
• Fixed the issue: Subscribing to multiple blockchain events causes every listener to be fired for every registered event (#6210)
• Fixed the issue: Unsubscribe at a Web3Subscription class will still have the id of the subscription at the Web3SubscriptionManager (#6210)
• Fixed the issue: A call to the provider is made for every subscription object (#6210)

web3-eth-abi

• Support for "decoding" indexed string event arguments (returns the keccak256 hash of the string value instead of the actual string value) (#6167)

web3-eth-accounts

• Fixed "The r and s returned by signTransaction to does not always consist of 64 characters #6207" (#6216)

web3-eth-contract

• Event filtering using non-indexed and indexed string event arguments (#6167)

web3-eth-ens

• Fixed bug #6185, now web3.js compiles on typescript v5 (#6195)

web3-providers-ws

• Fixed #6162 @types/ws issue (#6205)

web3-types

• Fixed bug #6185, now web3.js compiles on typescript v5 (#6195)

Added

web3

• Exported Web3Context, Web3PluginBase, Web3EthPluginBase from 'web3-core', and Web3Validator from 'web3-validator' (#6165)

web3-core

• Web3Subscription constructor accept a Subscription Manager (as an alternative to accepting Request Manager that is now marked marked as deprecated) (#6210)

web3-types

• Added the SimpleProvider interface which has only request(args) method that is compatible with EIP-1193 (#6210)
• Added the Eip1193EventName type that contains the possible events names according to EIP-1193 (#6210)

Changed

web3-core

• Web3Subscription constructor overloading that accept a Request Manager is marked as deprecated (#6210)

web3-errors

• Dependencies updated

web3-eth

• Dependencies updated

web3-eth-iban

• Dependencies updated

web3-eth-personal

• Dependencies updated

web3-net

• Dependencies updated

web3-providers-http

• Dependencies updated

web3-providers-ipc

• Dependencies updated

web3-rpc-methods

• Dependencies updated

web3-types

• The EIP1193Provider class has now all the events (for on and removeListener) according to EIP-1193 (#6210)

web3-utils

• Dependencies updated

web3-validator

• Dependencies updated

Web3.js 4.0.1 is written in TypeScript and has many exciting features such as:

• Easy extensibility ( with web3 Plugins feature. example: Chainlink Plugin )
• In compliance with ETH EL Specification
• Dynamic Contract Typing
• Native typescript
• ESM CJS native builds
• 85%+ test coverage
• Custom data formatting feature
• Reduced package size
• New packages ( web3-types, web3-errors, web3-validator, web3-rpc-methods )
• Validation functionality using schema

Documentation:

• Web3.js documentation
• Web3 API
• Migration Guide from 1.x
• Web3 Plugin Developers Guide
• Web3 Plugin Users Guide

Detailed List of changes are mentioned under:

• 4.0.0-alpha.0
• 4.0.1-alpha.1
• 4.0.1-alpha.2
• 4.0.1-alpha.3
• 4.0.1-alpha.4
• 4.0.1-alpha.5
• 4.0.1-rc.0
• 4.0.1-rc.1
• 4.0.1-rc.2

If there are any bugs, improvements, optimizations or any new feature proposal feel free to create github issue, or post a pull request for contributions.

Added

web3-errors

• InvalidPropertiesForTransactionTypeError with error code 429 (#6102)

web3-eth-contract

• Added support for getPastEvents method to filter allEvents and specific event (#6010)
• Added maxPriorityFeePerGas and maxFeePerGas in ContractOptions type and updated function using it in utils (#6118)
• Added method's type autodetection by ABI param (#6137)

web3-types

• Added filters param to the Filter type (#6010)
• Added types JsonRpcSubscriptionResultOld, Web3ProviderMessageEventCallback. Added .on('data') type support for old providers (#6082)
• Export for HardforksOrdered enum (#6102)
• Export for Web3ValidationErrorObject type (#6102)

web3-utils

• Optional hexstrict parameter added to numberToHex (#6004)

Fixed

web3-eth

• Fixed ignoreGasPricing bug with wallet in context (#6071)

web3-eth-accounts

• Fixed ESM import bugs reported in (#6032) and (#6034)
• ESM projects will not need to run --experimental-specifier-resolution=node (#6127)

Changed

web3-core

• Replaced Buffer for Uint8Array (#6004)

web3-errors

• Nested Smart Contract error data is extracted at Eip838ExecutionError constructor and the nested error is set at innerError (#6045)

web3-eth

• formatTransaction no longer throws a TransactionDataAndInputError if it's passed a transaction object with both data and input properties set (as long as they are the same value) (#6064)
• Refactored documentation for rpc_method_wrappers to point to the previously duplicated documentation found under the Web3Eth class documentation (#6054)
• Replaced Buffer for Uint8Array (#6004)
• Refactored defaultTransactionTypeParser to return correct EIP-2718 types, prior implementation was prioritizing transaction.hardfork and ignoring the use of transaction.gasLimit. defaultTransactionTypeParser will now throw InvalidPropertiesForTransactionTypeErrors for properties are used that are incompatible with transaction.type (#6102)
• prepareTransactionForSigning and defaultTransactionBuilder now accepts optional fillGasPrice flag and by default will not fill gas(#6071)

web3-eth-abi

• Nested Smart Contract error data hex string is decoded when the error contains the data as object (when the data hex string is inside data.originalError.data or data.data) (#6045)

web3-eth-accounts

• Replaced Buffer for Uint8Array (#6004)
• The methods recover, encrypt, privateKeyToAddress does not support type Buffer but supports type Uint8Array (#6004)
• The method parseAndValidatePrivateKey returns a type Uint8Array instead of type Buffer (#6004)

web3-providers-ipc

• Replaced Buffer for Uint8Array (#6004)

web3-types

• Removed chainId, to, data & input properties from NonPayableCallOptions
• Replaced Buffer for Uint8Array (#6004)
• types FMT_BYTES.BUFFER, Bytes and FormatType and encryption option types for salt and iv has replaced support for Buffer for Uint8Array (#6004)
• Added internalType property to the AbiParameter type.

web3-utils

• Replaced Buffer for Uint8Array (#6004)
• The methods hexToBytes, randomBytes does not return type Buffer but type Uint8Array (#6004)
• The methods sha3 and keccak256Wrapper does not accept type Buffer but type Uint8Array (#6004)
• The method bytesToBuffer has been removed for the usage of bytesToUint8Array (#6004)

web3-validator

• Replaced Buffer for Uint8Array (#6004)

Removed

web3-eth-ens

• Removed non read-only methods (#6084)

web3-validator

• Web3ValidationErrorObject type is now exported from web3-types package (#6102)

Fixed

• Improved the error propagation in web3-providers-http package to effectively propagate useful error infomation about failed HTTP connections (#5955)
• Fixed "Uncaught TypeError" calling a contract function that revert using MetaMask (#4454) and related "n.data.substring is not a function", that is raised when there is a revert and web.eth.handleRevert = true (#6000)

Changed

• transaction.type is now formatted to a hex string before being send to provider (#5979)
• When sending a transaction, if transaction.type === '0x1' && transaction.accessList === undefined, then transaction.accessList is set to [] (#5979)
• Removed an unnecessary chainId parameter from toChecksumAddress() function types (#5888)

Added

• Added support for getPastEvents method to filter allEvents and specific event (#6015)

Security

• Updated dependencies (#6044)

Fixed

• Improved the error propagation in web3-providers-http package to effectively propagate useful error infomation about failed HTTP connections (#5955)
• Fixed "Uncaught TypeError" calling a contract function that revert using MetaMask (#4454) and related "n.data.substring is not a function", that is raised when there is a revert and web.eth.handleRevert = true (#6000)

Changed

• transaction.type is now formatted to a hex string before being send to provider (#5979)
• When sending a transaction, if transaction.type === '0x1' && transaction.accessList === undefined, then transaction.accessList is set to [] (#5979)
• Removed an unnecessary chainId parameter from toChecksumAddress() function types (#5888)

Added

• Added support for getPastEvents method to filter allEvents and specific event (#6015)

Security

• Updated dependencies (#6044)

Changed

web3

• No need for polyfilling nodejs net and fs modules (#5978)
• Removed IPC provider dependency, IPC path is no longer viable provider. If you wanna use IPC, please install web3-providers-ipc and instantiate provider yourself (#5978)

web3-core

• If a transaction object with a data property is passed to txInputOptionsFormatter, it will now be replaced with input (#5915)
• The types TransactionTypeParser and TransactionBuilder are now utilizing the type Transaction for the transaction object. (#5993)
• No need for polyfilling nodejs net and fs modules (#5978)
• Removed IPC provider dependency, IPC path is no longer viable provider. If you wanna use IPC, please install web3-providers-ipc and instantiate provider yourself (#5978)

web3-errors

• gasLimit is no longer accepted as a parameter for MissingGasError and `TransactionGasMismatchError, and is also no longer included in error message (#5915)

web3-eth

• signTransaction will now return gas instead of gasLimit for returned transaction object regardless of what property name the provider uses (#5915)
• formatTransaction will now replace data transaction property with input (#5915)
• isTransactionCall will now check if value.input isHexStrict if provided (#5915)
• The functions defaultTransactionBuilder and transactionBuilder are now utilizing the type Transaction for the transaction object. (#5993)

web3-eth-accounts

• Moved @ethereumjs/tx, @ethereumjs/common code to our source code (#5963)
• The method signTransaction returned by privateKeyToAccount is now accepting the type Transaction for its argument. (#5993)

web3-eth-contract

• getSendTxParams will now return input instead of data in returned transaction parameters object (#5915)
• Contract constructor will now thrown new ContractTransactionDataAndInputError if both data and input are passed in ContractInitOptions for Contract constructor (#5915)
• The types ContractInitOptions, NonPayableCallOptions and PayableCallOptions are moved to web3-types. (#5993)

web3-types

• data property in TransactionOutput was renamed to input (#5915)
• The method signTransaction inside Web3BaseWalletAccount is now utilizing the type Transaction for its argument. (#5993)
• The types FMT_NUMBER, NumberTypes, FMT_BYTES, ByteTypes, DataFormat, DEFAULT_RETURN_FORMAT, ETH_DATA_FORMAT and FormatType moved from web3-utils. (#5993)
• The types ContractInitOptions, NonPayableCallOptions and PayableCallOptions are moved from web3-eth-contract. (#5993)

web3-utils

• The types FMT_NUMBER, NumberTypes, FMT_BYTES, ByteTypes, DataFormat, DEFAULT_RETURN_FORMAT, ETH_DATA_FORMAT and FormatType moved to web3-types. (#5993)

Added

web3

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-core

• Added hybrid build (ESM and CJS) of library (#5904)
• Added source files (#5956)

web3-errors

• Added hybrid build (ESM and CJS) of library (#5904)
• Added source files (#5956)

web3-eth

• Added source files (#5956)

web3-eth-abi

• Added hybrid build (ESM and CJS) of library (#5904)
• Added source files (#5956)

web3-eth-accounts

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-eth-contract

• input is now an acceptable property for ContractInitOptions in place of data (either can be used, but input is used withing the Contract class) (#5915)
• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-eth-ens

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-eth-iban

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-eth-personal

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-net

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-providers-http

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-providers-ipc

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-providers-ws

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-rpc-methods

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-types

• Added hybrid build (ESM and CJS) of library (#5904)
• Added source files (#5956)

web3-utils

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)

web3-validator

• Added source files (#5956)
• Added hybrid build (ESM and CJS) of library (#5904)
• Added functions isHexString, isHexPrefixed, validateNoLeadingZeroes (#5963)

Removed

web3-core

• getConfig method from Web3Config class, config is now public and accessible using Web3Config.config (#5950)

web3-eth

• Removed dependencies @ethereumjs/tx, @ethereumjs/common (#5963)

web3-eth-abi

• Removed formatDecodedObject function (#5934)

web3-eth-contract

• data was removed as a property of ContractOptions type (#5915)

web3-utils

• Removed dependencies @ethereumjs/tx, @ethereumjs/common (#5963)

Fixed

web3-eth-ens

• Bug fix of checkNetwork in ENS (#5988)

Fixed

• Fixed skipped ws-ganache tests (#5759)
• Fixed "provider started to reconnect error" in web3-provider-ws (#5820)
• Fixed Error: Number can only safely store up to 53 bits (#5845)
• Fixed types for packages which have default exports but not declared default export in .d.ts (#5866)
• Fixed Transaction type by adding missing properties (#5856)

Changed

• Add optional hexFormat param to getTransaction and getBlock that accepts the value 'hex' (#5845)
• utils.toNumber and utils.hexToNumber can now return the large unsafe numbers as BigInt, if true was passed to a new optional parameter called bigIntOnOverflow (#5845)
• Updated @types/bn.js dependency to 5.1.1 in web3, web3-core and web3-eth-contract as reason mentioned in #5640 (#5885)
• Add description to error for failed connection on websocket (#5884)

Security

• Updated dependencies (#5885)

Added

web3

• registeredSubscriptions was added by default in web3 constructor (#5792)
• Add named exports for all objects which are the default-exported-object in their packages (#5771)
• Export all packages' objects organized by namespaces (#5771)
• Add Additional flat exports for all types and constants from web3-types, web3-errors and web3. (#5771)
• Fix few issues with new Web3().eth.contract (#5824)

web3-core

• Added rpc exception codes following eip-1474 as an experimental feature (if useRpcCallSpecification at enableExperimentalFeatures is true) (#5525)
• Added support of safe and finalized block tags (#5823)

web3-errors

• Added error class InvalidMethodParamsError and error code ERR_INVALID_METHOD_PARAMS = 207 (#5824)
• request property to ResponseError (#5854)
• data property to TransactionRevertInstructionError (#5854)
• TransactionRevertWithCustomError was added to handle custom solidity errors (#5854)

web3-eth

• Added createAccessList functionality ( #5780 )
• Added support of safe and finalized block tags (#5823)
• contractAbi option to SendTransactionOptions and SendSignedTransactionOptions to added the ability to parse custom solidity errors (#5854)

web3-eth-abi

• decodeErrorData from web3-eth-contract is now exported from this package and was renamed to decodeContractErrorData (#5844)

web3-eth-contract

• Added functionality of createAccessList for contracts ( #5780 )
• An instance of Contract will subscribeToContextEvents upon instantiation if syncWithContext is set to true and the constructor is passed an instance of Web3Context (#5833)
• Added support of safe and finalized block tags (#5823)

web3-providers-http

• Added named export for HttpProvider (#5771)

web3-providers-ipc

• Added named export for IpcProvider (#5771)
• Pass _socketOptions from IpcProvider constructor to the underlying Socket (#5891)
• The getter of SocketConnection in IpcProvider (inherited from SocketProvider) returns net.Socket (#5891)

web3-providers-ws

• Added named export for WebSocketProvider (#5771)
• The getter of SocketConnection in WebSocketProvider (inherited from SocketProvider) returns isomorphic WebSocket (#5891)

web3-rpc-methods

• Added createAccessList functionality ( #5780 )
• Added support of safe and finalized block tags (#5823)

web3-types

• Added types from web3-eth-abi and TypedArray from (#5771)
• Added TypedArray from web3-utils and web3-validator (it was defined twice) (#5771)
• Added safe and finalized block tags in BlockTags and BlockTag types (#5823)

web3-utils

• Added support of safe and finalized block tags (#5823)

web3-validator

• Added support of safe and finalized block tags in isBlockTag method (#5823)

Changed

web3

• require('web3') will now return all web3 exported-objects organized in namespaces . (#5771)

web3-errors

• The abstract class Web3Error is renamed to BaseWeb3Error (#5771)
• Renamed TransactionRevertError to TransactionRevertInstructionError to remain consistent with 1.x
• Using MaxAttemptsReachedOnReconnectingError with the same message for 1.x but also adding the maxAttempts (#5894)

web3-eth

• Update imports statements for objects that was moved between web3 packages (#5771)
• sendTransaction and sendSignedTransaction now errors with (and error event emits) the following possible errors: TransactionRevertedWithoutReasonError, TransactionRevertInstructionError, TransactionRevertWithCustomError, InvalidResponseError, or ContractExecutionError (#5854)

web3-eth-accounts

• Updated dependencies (#5912)

web3-eth-contract

• Update imports statements for objects that was moved between web3 packages (#5771)

web3-eth-ens

• Updated dependencies (#5912)

web3-eth-iban

• Updated dependencies (#5912)

web3-eth-personal

• Updated dependencies (#5912)

web3-net

• Updated dependencies (#5912)

web3-utils

• compareBlockNumbers function now only supports comparison of both blocktags params ( except earliest vs number) or both block number params (#5842)
• SocketProvider abstract class now resolves JSON RPC response errors instead of rejecting them (#5844)
• Exposes the getter of SocketConnection in SocketProvider (#5891)

Removed

web3

• Private static _contracts:Contract[] and static setProvider function was removed (#5792)

web3-eth

• getRevertReason is no longer exported (#5844)

web3-eth-abi

• Moved all types and interfaces to web3-types (#5771)

web3-eth-contract

• decodeErrorData is no longer exported (method was moved to web3-eth-abi and renamed decodeContractErrorData) (#5844)

web3-utils

• Moved TypedArray to web3-types (was also duplicated at web3-validator) (#5771)
• Removed support of genesis tag in compareBlockNumbers function (#5823)

web3-validator

• Moved TypedArray to web3-types (was also duplicated at web3-utils) (#5771)

Fixed

web3-eth-contract

• Fix contract defaults (#5756)
• Fixed getPastEventsError (#5819)

Fixed

• Fixed skipped ws-ganache tests (#5759)
• Fixed "provider started to reconnect error" in web3-provider-ws (#5820)
• Fixed Error: Number can only safely store up to 53 bits (#5845)
• Fixed types for packages which have default exports but not declared default export in .d.ts (#5866)
• Fixed Transaction type by adding missing properties (#5856)

Changed

• Add optional hexFormat param to getTransaction and getBlock that accepts the value 'hex' (#5845)
• utils.toNumber and utils.hexToNumber can now return the large unsafe numbers as BigInt, if true was passed to a new optional parameter called bigIntOnOverflow (#5845)
• Updated @types/bn.js dependency to 5.1.1 in web3, web3-core and web3-eth-contract as reason mentioned in #5640 (#5885)
• Add description to error for failed connection on websocket (#5884)

Security

• Updated dependencies (#5885)