evmchains 0.0.8__py3-none-any.whl → 0.0.10__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.8'
-__version_tuple__ = version_tuple = (0, 0, 8)
+__version__ = version = '0.0.10'
+__version_tuple__ = version_tuple = (0, 0, 10)

evmchains/chains.py

@@ -1,5 +1,5 @@
 # This file is auto-generated by scripts/update.py
-# 2024-05-17 16:06:29.822636
+# 2024-06-14 15:00:06.554669
 # 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,
@@ -452,6 +453,49 @@ PUBLIC_CHAIN_META: Dict[str, Dict[str, Dict[str, Any]]] = {
             "shortName": "gor",
             "slip44": 1,
         },
+        "holesky": {
+            "chain": "ETH",
+            "chainId": 17000,
+            "ens": None,
+            "explorers": [
+                {
+                    "icon": "ethereum",
+                    "name": "Holesky Explorer",
+                    "standard": "EIP3091",
+                    "url": "https://holesky.beaconcha.in",
+                },
+                {
+                    "icon": "ethereum",
+                    "name": "otterscan-holesky",
+                    "standard": "EIP3091",
+                    "url": "https://holesky.otterscan.io",
+                },
+                {
+                    "icon": "ethereum",
+                    "name": "Holesky Etherscan",
+                    "standard": "EIP3091",
+                    "url": "https://holesky.etherscan.io",
+                },
+            ],
+            "faucets": [
+                "https://faucet.holesky.ethpandaops.io",
+                "https://holesky-faucet.pk910.de",
+            ],
+            "features": None,
+            "icon": "ethereum",
+            "infoURL": "https://holesky.ethpandaops.io",
+            "name": "Holesky",
+            "nativeCurrency": {"decimals": 18, "name": "Testnet ETH", "symbol": "ETH"},
+            "networkId": 17000,
+            "rpc": [
+                "https://rpc.holesky.ethpandaops.io",
+                "https://ethereum-holesky-rpc.publicnode.com",
+                "https://holesky.drpc.org",
+                "https://rpc-holesky.rockx.com",
+            ],
+            "shortName": "holesky",
+            "slip44": 1,
+        },
         "sepolia": {
             "chain": "ETH",
             "chainId": 11155111,
@@ -609,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",
@@ -869,78 +985,6 @@ PUBLIC_CHAIN_META: Dict[str, Dict[str, Dict[str, Any]]] = {
             "slip44": 1,
         },
     },
-    "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,
-        },
-    },
     "rootstock": {
         "mainnet": {
             "chain": "Rootstock",
@@ -1004,4 +1048,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.8.dist-info → evmchains-0.0.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: evmchains
-Version: 0.0.8
+Version: 0.0.10
 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.10.dist-info/RECORD

@@ -0,0 +1,10 @@
+evmchains/__init__.py,sha256=xoRq5QxDP8bhHXPae0HVSH9pK0uPZu6go4Tr2Kc3G_M,1510
+evmchains/_meta.py,sha256=IBUgg21Ew0JtWj9Z6eN1r4zXlrNseQQNV4zo-nYzlEY,413
+evmchains/chains.py,sha256=O7pqKEb5D-6Wss35c12d19_QmOv4KO41UuKS6Lgac0M,38365
+evmchains/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+evmchains/types.py,sha256=oJV6vvbQpckiKP2TTUG-RQRe66i3cGT2M-ZkaMu1Om4,474
+evmchains-0.0.10.dist-info/LICENSE,sha256=wKVouzimXmZeaCj3f48Vua0vk91U4vjrrt2Ax0u3qBs,11342
+evmchains-0.0.10.dist-info/METADATA,sha256=P_WaI8H5KHYkoOsLSBIJz8yEO9pLM3yU5VGeoozBmNQ,15816
+evmchains-0.0.10.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+evmchains-0.0.10.dist-info/top_level.txt,sha256=qwbaOucZ5qXfj0eTHrIujLTezgtcInyR_U-Ef2P4oic,10
+evmchains-0.0.10.dist-info/RECORD,,

evmchains-0.0.8.dist-info/RECORD

@@ -1,10 +0,0 @@
-evmchains/__init__.py,sha256=JeDA-PJx5d2C2GLR4kuDdtrE_jag9AlM6EvKBwI3mxI,743
-evmchains/_meta.py,sha256=qP2QJpgwFu26Ia9si7LC7nYHaW0_mvxka84OVyOuIKg,411
-evmchains/chains.py,sha256=nLn-j3LmGhnAswl5YGXHAHLaEI67VUs6uz4M_uD9BuQ,35091
-evmchains/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-evmchains/types.py,sha256=oJV6vvbQpckiKP2TTUG-RQRe66i3cGT2M-ZkaMu1Om4,474
-evmchains-0.0.8.dist-info/LICENSE,sha256=wKVouzimXmZeaCj3f48Vua0vk91U4vjrrt2Ax0u3qBs,11342
-evmchains-0.0.8.dist-info/METADATA,sha256=PHF7ilhNLR5132gQZmHQPOYvOcnkwjcOCt3V4_eyLfY,15761
-evmchains-0.0.8.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-evmchains-0.0.8.dist-info/top_level.txt,sha256=qwbaOucZ5qXfj0eTHrIujLTezgtcInyR_U-Ef2P4oic,10
-evmchains-0.0.8.dist-info/RECORD,,