feat(contract): update Multicall to Multicall3 (#1584)

* chore: update multicall_contract binding

* feat: update multicall_contract.rs to Multicall3

* fix multicall_contract.rs exports

* update test Multicall.sol contract

* feat: update Multicall to Multicall3

* update exports

* update tests

* perf: use aggregate3 when no value is being sent

* feat: handle revert data

* test: add multicall v2 and v3 tests

* fix: clippy

* docs: add documentation, improve comments

* docs: add more documentation

* fix: solidity minimum version for Multicall.sol

* fix: multicall_contract.rs imports

* docs: add explanation for previous commit

* docs

* docs

* fix: remove unused re-export, feature gate Multicall

* fix: address review

* chore: improve error handling

* chore: export MulticallError

* docs

ethers-contract/src/lib.rs

@@ -25,8 +25,15 @@ pub use log::{decode_logs, EthLogDecode, LogMeta};
 
 pub mod stream;
 
+#[cfg(any(test, feature = "abigen"))]
+#[cfg_attr(docsrs, doc(cfg(feature = "abigen")))]
 mod multicall;
-pub use multicall::Multicall;
+#[cfg(any(test, feature = "abigen"))]
+#[cfg_attr(docsrs, doc(cfg(feature = "abigen")))]
+pub use multicall::{
+    Multicall, MulticallContract, MulticallError, MulticallVersion, MULTICALL_ADDRESS,
+    MULTICALL_SUPPORTED_CHAIN_IDS,
+};
 
 /// This module exposes low lever builder structures which are only consumed by the
 /// type-safe ABI bindings generators.