evmchains 0.0.9__py3-none-any.whl → 0.0.11__py3-none-any.whl

evmchains/__init__.py

@@ -1,8 +1,13 @@
+import os
 import random
+import re
+from typing import List
 
 from evmchains.chains import PUBLIC_CHAIN_META
 from evmchains.types import Chain
 
+ENV_VAR_REGEX = re.compile(r"\$\{([A-Za-z0-9_]+)\}")
+
 
 def get_chain_meta(ecosystem: str, network: str) -> Chain:
     """Return a Chain instance with metadata for an EVM chain"""
@@ -15,10 +20,31 @@ def get_chain_meta(ecosystem: str, network: str) -> Chain:
     return Chain(**PUBLIC_CHAIN_META[ecosystem][network])
 
 
+def get_rpcs(ecosystem: str, network: str) -> List[str]:
+    """Get a list of valid RPC endpoints for an ecosystem:network pair"""
+    rpcs = []
+
+    chain = get_chain_meta(ecosystem, network)
+
+    for rpc in chain.rpc:
+        # Look for env var replacements in the endpoint URL
+        match = ENV_VAR_REGEX.search(rpc)
+        if match:
+            to_replace = match.group(0)
+            env_var = match.group(1)
+            # Include them only if the env var is available
+            if env_var in os.environ:
+                rpcs.append(rpc.replace(to_replace, os.environ[env_var]))
+        else:
+            rpcs.append(rpc)
+
+    return rpcs
+
+
 def get_random_rpc(ecosystem: str, network: str) -> str:
     """Return a random RPC endpoint for an ecosystem:network pair"""
-    chain = get_chain_meta(ecosystem, network)
-    return random.choice(chain.rpc)
+    rpcs = get_rpcs(ecosystem, network)
+    return random.choice(rpcs)
 
 
-__all__ = ["PUBLIC_CHAIN_META", "Chain", "get_chain_meta"]
+__all__ = ["PUBLIC_CHAIN_META", "Chain", "get_chain_meta", "get_random_rpc", "get_rpcs"]

evmchains/_meta.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.0.9'
-__version_tuple__ = version_tuple = (0, 0, 9)
+__version__ = version = '0.0.11'
+__version_tuple__ = version_tuple = (0, 0, 11)

evmchains/chains.py

@@ -1,5 +1,5 @@
 # This file is auto-generated by scripts/update.py
-# 2024-05-30 20:30:00.884580
+# 2024-07-03 20:26:21.491217
 # Do not edit this file directly.
 from typing import Any, Dict
 
@@ -253,6 +253,7 @@ PUBLIC_CHAIN_META: Dict[str, Dict[str, Dict[str, Any]]] = {
                 "https://blast.din.dev/rpc",
                 "https://blastl2-mainnet.public.blastapi.io",
                 "https://blast.blockpi.network/v1/rpc/public",
+                "https://blast-rpc.publicnode.com",
             ],
             "shortName": "blastmainnet",
             "slip44": None,
@@ -652,6 +653,78 @@ PUBLIC_CHAIN_META: Dict[str, Dict[str, Dict[str, Any]]] = {
             "slip44": 700,
         },
     },
+    "linea": {
+        "mainnet": {
+            "chain": "ETH",
+            "chainId": 59144,
+            "ens": None,
+            "explorers": [
+                {
+                    "icon": "linea",
+                    "name": "Etherscan",
+                    "standard": "EIP3091",
+                    "url": "https://lineascan.build",
+                },
+                {
+                    "icon": "linea",
+                    "name": "Blockscout",
+                    "standard": "EIP3091",
+                    "url": "https://explorer.linea.build",
+                },
+                {
+                    "icon": "linea",
+                    "name": "L2scan",
+                    "standard": "EIP3091",
+                    "url": "https://linea.l2scan.co",
+                },
+            ],
+            "faucets": [],
+            "features": None,
+            "icon": "linea",
+            "infoURL": "https://linea.build",
+            "name": "Linea",
+            "nativeCurrency": {"decimals": 18, "name": "Linea Ether", "symbol": "ETH"},
+            "networkId": 59144,
+            "rpc": [
+                "https://rpc.linea.build",
+                "https://linea-mainnet.infura.io/v3/${INFURA_API_KEY}",
+            ],
+            "shortName": "linea",
+            "slip44": None,
+        },
+        "sepolia": {
+            "chain": "ETH",
+            "chainId": 59141,
+            "ens": None,
+            "explorers": [
+                {
+                    "icon": "linea",
+                    "name": "Etherscan",
+                    "standard": "EIP3091",
+                    "url": "https://sepolia.lineascan.build",
+                },
+                {
+                    "icon": "linea",
+                    "name": "Blockscout",
+                    "standard": "EIP3091",
+                    "url": "https://explorer.sepolia.linea.build",
+                },
+            ],
+            "faucets": [],
+            "features": None,
+            "icon": "linea",
+            "infoURL": "https://linea.build",
+            "name": "Linea Sepolia",
+            "nativeCurrency": {"decimals": 18, "name": "Linea Ether", "symbol": "ETH"},
+            "networkId": 59141,
+            "rpc": [
+                "https://rpc.sepolia.linea.build",
+                "https://linea-sepolia.infura.io/v3/${INFURA_API_KEY}",
+            ],
+            "shortName": "linea-sepolia",
+            "slip44": 1,
+        },
+    },
     "optimism": {
         "mainnet": {
             "chain": "ETH",
@@ -861,6 +934,31 @@ PUBLIC_CHAIN_META: Dict[str, Dict[str, Dict[str, Any]]] = {
             "shortName": "maticmum",
             "slip44": 1,
         },
+        "amoy": {
+            "chain": "Polygon",
+            "chainId": 80002,
+            "ens": None,
+            "explorers": [
+                {
+                    "name": "polygonamoy",
+                    "standard": "EIP3091",
+                    "url": "https://www.oklink.com/amoy",
+                }
+            ],
+            "faucets": ["https://faucet.polygon.technology/"],
+            "features": None,
+            "icon": "polygon",
+            "infoURL": "https://polygon.technology/",
+            "name": "Amoy",
+            "nativeCurrency": {"decimals": 18, "name": "MATIC", "symbol": "MATIC"},
+            "networkId": 80002,
+            "rpc": [
+                "https://rpc-amoy.polygon.technology",
+                "https://polygon-amoy-bor-rpc.publicnode.com",
+            ],
+            "shortName": "polygonamoy",
+            "slip44": 1,
+        },
     },
     "polygon-zkevm": {
         "mainnet": {
@@ -911,78 +1009,28 @@ PUBLIC_CHAIN_META: Dict[str, Dict[str, Dict[str, Any]]] = {
             "shortName": "testnet-zkEVM-mango",
             "slip44": 1,
         },
-    },
-    "linea": {
-        "mainnet": {
-            "chain": "ETH",
-            "chainId": 59144,
+        "cardona": {
+            "chain": "Polygon",
+            "chainId": 2442,
             "ens": None,
             "explorers": [
                 {
-                    "icon": "linea",
-                    "name": "Etherscan",
-                    "standard": "EIP3091",
-                    "url": "https://lineascan.build",
-                },
-                {
-                    "icon": "linea",
-                    "name": "Blockscout",
-                    "standard": "EIP3091",
-                    "url": "https://explorer.linea.build",
-                },
-                {
-                    "icon": "linea",
-                    "name": "L2scan",
+                    "name": "polygonscan",
                     "standard": "EIP3091",
-                    "url": "https://linea.l2scan.co",
-                },
+                    "url": "https://cardona-zkevm.polygonscan.com",
+                }
             ],
             "faucets": [],
             "features": None,
-            "icon": "linea",
-            "infoURL": "https://linea.build",
-            "name": "Linea",
-            "nativeCurrency": {"decimals": 18, "name": "Linea Ether", "symbol": "ETH"},
-            "networkId": 59144,
-            "rpc": [
-                "https://rpc.linea.build",
-                "https://linea-mainnet.infura.io/v3/${INFURA_API_KEY}",
-            ],
-            "shortName": "linea",
+            "icon": "zkevm",
+            "infoURL": "https://polygon.technology/polygon-zkevm",
+            "name": "Polygon zkEVM Cardona Testnet",
+            "nativeCurrency": {"decimals": 18, "name": "Ether", "symbol": "ETH"},
+            "networkId": 2442,
+            "rpc": ["https://rpc.cardona.zkevm-rpc.com"],
+            "shortName": "zkevm-testnet-cardona",
             "slip44": None,
         },
-        "sepolia": {
-            "chain": "ETH",
-            "chainId": 59141,
-            "ens": None,
-            "explorers": [
-                {
-                    "icon": "linea",
-                    "name": "Etherscan",
-                    "standard": "EIP3091",
-                    "url": "https://sepolia.lineascan.build",
-                },
-                {
-                    "icon": "linea",
-                    "name": "Blockscout",
-                    "standard": "EIP3091",
-                    "url": "https://explorer.sepolia.linea.build",
-                },
-            ],
-            "faucets": [],
-            "features": None,
-            "icon": "linea",
-            "infoURL": "https://linea.build",
-            "name": "Linea Sepolia",
-            "nativeCurrency": {"decimals": 18, "name": "Linea Ether", "symbol": "ETH"},
-            "networkId": 59141,
-            "rpc": [
-                "https://rpc.sepolia.linea.build",
-                "https://linea-sepolia.infura.io/v3/${INFURA_API_KEY}",
-            ],
-            "shortName": "linea-sepolia",
-            "slip44": 1,
-        },
     },
     "rootstock": {
         "mainnet": {
@@ -1047,4 +1095,54 @@ PUBLIC_CHAIN_META: Dict[str, Dict[str, Dict[str, Any]]] = {
             "slip44": 1,
         },
     },
+    "shibarium": {
+        "mainnet": {
+            "chain": "Shibarium",
+            "chainId": 109,
+            "ens": None,
+            "explorers": [
+                {
+                    "name": "shibariumscan",
+                    "standard": "none",
+                    "url": "https://www.shibariumscan.io",
+                }
+            ],
+            "faucets": [],
+            "features": None,
+            "icon": "shibarium",
+            "infoURL": "https://shibariumecosystem.com",
+            "name": "Shibarium",
+            "nativeCurrency": {
+                "decimals": 18,
+                "name": "BONE Shibarium",
+                "symbol": "BONE",
+            },
+            "networkId": 109,
+            "rpc": ["https://www.shibrpc.com"],
+            "shortName": "shibariumecosystem",
+            "slip44": None,
+        },
+        "puppynet": {
+            "chain": "Puppynet Shibarium",
+            "chainId": 157,
+            "ens": None,
+            "explorers": [
+                {
+                    "name": "puppyscan",
+                    "standard": "none",
+                    "url": "https://puppyscan.shib.io",
+                }
+            ],
+            "faucets": ["https://beta.shibariumtech.com/faucet"],
+            "features": None,
+            "icon": "shibarium",
+            "infoURL": "https://shibariumecosystem.com",
+            "name": "Puppynet Shibarium",
+            "nativeCurrency": {"decimals": 18, "name": "BONE", "symbol": "BONE"},
+            "networkId": 157,
+            "rpc": ["https://puppynet.shibrpc.com"],
+            "shortName": "puppynet",
+            "slip44": None,
+        },
+    },
 }

{evmchains-0.0.9.dist-info → evmchains-0.0.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: evmchains
-Version: 0.0.9
+Version: 0.0.11
 Summary: Packaged metadata on Ethereum Virtual Machine (EVM) chains
 License: Apache License
                                    Version 2.0, January 2004
@@ -213,6 +213,7 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
@@ -238,13 +239,13 @@ Requires-Dist: types-requests >=2.31.0.20240106 ; extra == 'dev'
 
 Provides general metadata on EVM-compatible chains organized by Ape-style ecosystem and network.
 
-Original soure data: https://github.com/ethereum-lists/chains
+Original source data: https://github.com/ethereum-lists/chains
 
 ## Quick Start
 
 ## Dependencies
 
-- [python3](https://www.python.org/downloads) version 3.8 up to 3.11.
+- [python3](https://www.python.org/downloads) version 3.8 up to 3.12.
 
 ## Installation
 

evmchains-0.0.11.dist-info/RECORD

@@ -0,0 +1,10 @@
+evmchains/__init__.py,sha256=xoRq5QxDP8bhHXPae0HVSH9pK0uPZu6go4Tr2Kc3G_M,1510
+evmchains/_meta.py,sha256=Ht_kK4WoZp7blBjGQJ5CR8Vli99GsMsH_I96HrAX0WE,413
+evmchains/chains.py,sha256=WyQA34ByOlZqJM6swGS6KuXq9ZlU9PMevLP2bkvwixU,40049
+evmchains/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+evmchains/types.py,sha256=oJV6vvbQpckiKP2TTUG-RQRe66i3cGT2M-ZkaMu1Om4,474
+evmchains-0.0.11.dist-info/LICENSE,sha256=wKVouzimXmZeaCj3f48Vua0vk91U4vjrrt2Ax0u3qBs,11342
+evmchains-0.0.11.dist-info/METADATA,sha256=jJirQoTi523u3farIDawKPTLfCgsaO6pwV6r73-GulM,15816
+evmchains-0.0.11.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
+evmchains-0.0.11.dist-info/top_level.txt,sha256=qwbaOucZ5qXfj0eTHrIujLTezgtcInyR_U-Ef2P4oic,10
+evmchains-0.0.11.dist-info/RECORD,,

{evmchains-0.0.9.dist-info → evmchains-0.0.11.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (70.2.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

evmchains-0.0.9.dist-info/RECORD

@@ -1,10 +0,0 @@
-evmchains/__init__.py,sha256=JeDA-PJx5d2C2GLR4kuDdtrE_jag9AlM6EvKBwI3mxI,743
-evmchains/_meta.py,sha256=VUKDhsDLOPKj9zNw_322lJTB3k9JKH6BOu4nkEc42KY,411
-evmchains/chains.py,sha256=1dK-xR83G4tqo-drIAxL3l_e_vPGcEQg1KI3ulfvRW4,36656
-evmchains/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-evmchains/types.py,sha256=oJV6vvbQpckiKP2TTUG-RQRe66i3cGT2M-ZkaMu1Om4,474
-evmchains-0.0.9.dist-info/LICENSE,sha256=wKVouzimXmZeaCj3f48Vua0vk91U4vjrrt2Ax0u3qBs,11342
-evmchains-0.0.9.dist-info/METADATA,sha256=zPp2WTVDdIL2QW3sajLhkn2_yJlf_JzOIUL2uy6HMfk,15761
-evmchains-0.0.9.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-evmchains-0.0.9.dist-info/top_level.txt,sha256=qwbaOucZ5qXfj0eTHrIujLTezgtcInyR_U-Ef2P4oic,10
-evmchains-0.0.9.dist-info/RECORD,,