Add proxy implementation address to Contract Metadata

Author: falvaradorodriguez

safe_eth/eth/clients/contract_metadata.py

@@ -7,3 +7,4 @@ class ContractMetadata:
     name: Optional[str]
     abi: List[Dict[str, Any]]
     partial_match: bool
+    implementation: Optional[str] = None

safe_eth/eth/clients/etherscan_client.py

@@ -359,8 +359,16 @@ def _process_contract_metadata(
     ) -> Optional[ContractMetadata]:
         contract_name = contract_data["ContractName"]
         contract_abi = contract_data["ABI"]
+        contract_proxy_implementation_address = (
+            contract_data.get("Implementation") or None
+        )
         if contract_abi:
-            return ContractMetadata(contract_name, contract_abi, False)
+            return ContractMetadata(
+                contract_name,
+                contract_abi,
+                False,
+                contract_proxy_implementation_address,
+            )
         return None
 
     def get_contract_metadata(

safe_eth/eth/tests/clients/test_etherscan_client_v2.py

@@ -36,13 +36,29 @@ def test_etherscan_get_abi(self):
             )
             self.assertEqual(contract_metadata.name, "GnosisSafe")
             self.assertEqual(contract_metadata.abi, safe_master_copy_abi)
+            self.assertIsNone(contract_metadata.implementation)
 
             random_address = "0xaE32496491b53841efb51829d6f886387708F99a"
             self.assertIsNone(etherscan_api.get_contract_abi(random_address))
             self.assertIsNone(etherscan_api.get_contract_metadata(random_address))
         except EtherscanRateLimitError:
             self.skipTest("Etherscan rate limit reached")
 
+    def test_etherscan_get_contract_metadata(self):
+        try:
+            etherscan_api = self.get_etherscan_api(EthereumNetwork.MAINNET)
+            proxy_address = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
+
+            contract_metadata = etherscan_api.get_contract_metadata(proxy_address)
+            self.assertEqual(contract_metadata.name, "FiatTokenProxy")
+            self.assertEqual(
+                contract_metadata.implementation,
+                "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
+            )
+
+        except EtherscanRateLimitError:
+            self.skipTest("Etherscan rate limit reached")
+
     def test_is_supported_network(self):
         try:
             self.assertTrue(