cryptointerface 0.1.0__py3-none-any.whl

cryptointerface/periphery/dex_contracts.json

@@ -0,0 +1,301 @@
+{
+    "uniswap_v2": {
+        "1": {
+            "factory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
+            "router": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
+        },
+        "10": {
+            "factory": "0x0c3c1c532F1e39EdF36BE9Fe0bE1410313E074Bf",
+            "router": "0x4a7b5da61326a6379179b40d00f57e5bbdc962c2"
+        },
+        "56": {
+            "factory": "0x8909Dc15e40173Ff4699343b6eB8132c65e18eC6",
+            "router": "0x4752ba5dbc23f44d87826276bf6fd6b1c372ad24"
+        },
+        "137": {
+            "factory": "0x9e5A52f57b3038F1B8EeE45F28b3C1967e22799C",
+            "router": "0xedf6066a2b290c185783862c7f4776a2c8077ad1"
+        },
+        "8453": {
+            "factory": "0x8909dc15e40173ff4699343b6eb8132c65e18ec6",
+            "router": "0x4752ba5dbc23f44d87826276bf6fd6b1c372ad24"
+        },
+        "42161": {
+            "factory": "0xf1D7CC64Fb4452F05c498126312eBE29f30Fbcf9",
+            "router": "0x4752ba5dbc23f44d87826276bf6fd6b1c372ad24"
+        },
+        "42220": {
+            "factory": "0x79a530c8e2fA8748B7B40dd3629C0520c2cCf03f",
+            "router": null
+        },
+        "43114": {
+            "factory": "0x9e5A52f57b3038F1B8EeE45F28b3C1967e22799C",
+            "router": "0x4752ba5dbc23f44d87826276bf6fd6b1c372ad24"
+        },
+        "81457": {
+            "factory": "0x5C346464d33F90bABaf70dB6388507CC889C1070",
+            "router": "0xBB66Eb1c5e875933D44DAe661dbD80e5D9B03035"
+        },
+        "11155111": {
+            "factory": "0xF62c03E08ada871A0bEb309762E260a7a6a880E6",
+            "router": "0xeE567Fe1712Faf6149d80dA1E6934E354124CfE3"
+        }
+    },
+    "uniswap_v3": {
+        "1": {
+            "factory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+            "router": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
+            "quoter": "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+            "position_manager": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+            "migrator": "0xA5644E29708357803b5A882D272c41cC0dF92B34"
+        },
+        "10": {
+            "factory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+            "router": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
+            "quoter": "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+            "position_manager": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+            "migrator": "0xA5644E29708357803b5A882D272c41cC0dF92B34"
+        },
+        "30": {
+            "factory": "0xaF37EC98A00FD63689CF3060BF3B6784E00caD82",
+            "router": "0xFB7eF66a7e61224DD6FcD0D7d9C3be5C8B049b9f",
+            "quoter": "0xb5227F20f7c33A3f53E72E22f28bE7FAa01b7E6C",
+            "position_manager": "0x9d9386c042F194B460Ec424a1e57ACDE25f5C4b1",
+            "migrator": null
+        },
+        "56": {
+            "factory": "0xdB1d10011AD0Ff90774D0C6Bb92e5C5c8b4461F7",
+            "router": "0xB971eF87ede563556b2ED4b1C0b0019111Dd85d2",
+            "quoter": "0x78D78E420Da98ad378D7799bE8f4AF69033EB077",
+            "position_manager": "0x7b8A01B39D58278b5DE7e48c8449c9f4F5170613",
+            "migrator": "0x32681814957e0C13117ddc0c2aba232b5c9e760f"
+        },
+        "137": {
+            "factory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+            "router": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
+            "quoter": "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+            "position_manager": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+            "migrator": "0xA5644E29708357803b5A882D272c41cC0dF92B34"
+        },
+        "8453": {
+            "factory": "0x33128a8fC17869897dcE68Ed026d694621f6FDfD",
+            "router": "0x2626664c2603336E57B271c5C0b26F421741e481",
+            "quoter": "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a",
+            "position_manager": "0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1",
+            "migrator": "0x23cF10b1ee3AdfCA73B0eF17C07F7577e7ACd2d7"
+        },
+        "42161": {
+            "factory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+            "router": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
+            "quoter": "0xb27308f9F90D607463bb33eA1BeBb41C27CE5AB6",
+            "position_manager": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+            "migrator": "0xA5644E29708357803b5A882D272c41cC0dF92B34"
+        },
+        "43114": {
+            "factory": "0x740b1c1de25031C31FF4fC9A62f554A55cdC1baD",
+            "router": "0xbb00FF08d01D300023C629E8fFfFcb65A5a578cE",
+            "quoter": "0xbe0F5544EC67e9B3b2D979aaA43f18Fd87E6257F",
+            "position_manager": "0x655C406EBFa14EE2006250925e54ec43AD184f8B",
+            "migrator": "0x44f5f1f5E452ea8d29C890E8F6e893fC0f1f0f97"
+        },
+        "81457": {
+            "factory": "0x792edAdE80af5fC680d96a2eD80A44247D2Cf6Fd",
+            "router": "0x549FEB8c9bd4c12Ad2AB27022dA12492aC452B66",
+            "quoter": "0x6Cdcd65e03c1CEc3730AeeCd45bc140D57A25C77",
+            "position_manager": "0xB218e4f7cF0533d4696fDfC419A0023D33345F28",
+            "migrator": "0x15CA7043CD84C5D21Ae76Ba0A1A967d42c40ecE0"
+        },
+        "7777777": {
+            "factory": "0x7145F8aeef1f6510E92164038E1B6F8cB2c42Cbb",
+            "router": "0x7De04c96BE5159c3b5CeffC82aa176dc81281557",
+            "quoter": "0x11867e1b3348F3ce4FcC170BC5af3d23E07E64Df",
+            "position_manager": "0xbC91e8DfA3fF18De43853372A3d7dfe585137D78",
+            "migrator": null
+        },
+        "11155111": {
+            "factory": "0x0227628f3F023bb0B980b67D528571c95c6DaC1c",
+            "router": "0x3bFA4769FB09eefC5a80d6E87c3B9C650f7Ae48E",
+            "quoter": "0xEd1f6473345F45b75833fd55D191EaA8F5C33CD4",
+            "position_manager": "0x1238536071E1c677A632429e3655c799b22cDA52",
+            "migrator": null
+        }
+    },
+    "sushiswap_v2": {
+        "1": {
+            "factory": "0xC0AEe478e3658e2610c5F7A4A2E1777cE9e4f2Ac",
+            "router": "0xd9e1cE17f2641f24aE83637ab66a2cca9C378B9F"
+        },
+        "10": {
+            "factory": "0xFbc12984689e5f15626Bad03Ad60160Fe98B303C",
+            "router": "0xa132DAB612dB5cB9fC9Ac426A0Cc215A3423F9c9"
+        },
+        "56": {
+            "factory": "0xc35DADB65012eC5796536bD9864eD8773aBc74C4",
+            "router": "0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506"
+        },
+        "137": {
+            "factory": "0xc35DADB65012eC5796536bD9864eD8773aBc74C4",
+            "router": "0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506"
+        },
+        "8453": {
+            "factory": "0x71524B4f93c58fcbF659783284E38825f0622859",
+            "router": "0x6BDED42c6DA8FBf0d2bA55B2fa120C5e0c8D7891"
+        },
+        "42161": {
+            "factory": "0xc35DADB65012eC5796536bD9864eD8773aBc74C4",
+            "router": "0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506"
+        },
+        "43114": {
+            "factory": "0xc35DADB65012eC5796536bD9864eD8773aBc74C4",
+            "router": "0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506"
+        },
+        "11155111": {
+            "factory": "0x734583f62Bb6ACe3c9bA9bd5A53143CA2Ce8C55A",
+            "router": "0xeaBcE3E74EF41FB40024a21Cc2ee2F5dDc615791"
+        }
+    },
+    "sushiswap_v3": {
+        "1": {
+            "factory": "0xbACEB8eC6b9355Dfc0269C18bac9d6E2Bdc29C4F",
+            "router": "0x2c9a4Dc517f4Cb3E8dd1f4A78d0C6Fb793BC001",
+            "quoter": "0x64e8802FE490fa7cc61d3463958199161Bb608A7",
+            "position_manager": "0x2214A42d8e2A1d20635c2cb0664422c528B6A432"
+        },
+        "10": {
+            "factory": "0x9c6522117e2ed1fE5bdb72bb0eD5E3f2bdE7DBe0",
+            "router": "0xYourRouter",
+            "quoter": "0xYourQuoter",
+            "position_manager": "0x1af415a1EbA07a4986a52B6f2e7dE7003D82231e"
+        },
+        "56": {
+            "factory": "0x126555aa41B33402279070107F2393494E74110",
+            "router": "0x0a6e511Fe663827b9cA7e2D2542b20B37fC217A6",
+            "quoter": "0xb1E835Dc2785b52265711e17fCCb0fd018226a6e",
+            "position_manager": "0xF70c086618dcf2b1A461311275e00D6B722ef914"
+        },
+        "137": {
+            "factory": "0x917933899c6a5F8E37F31E19f92CdBFF7e8FF0e2",
+            "router": "0x0a6e511Fe663827b9cA7e2D2542b20B37fC217A6",
+            "quoter": "0xb1E835Dc2785b52265711e17fCCb0fd018226a6e",
+            "position_manager": "0xb7402ee99F0A008e461098AC3A27F4957Df89a40"
+        },
+        "8453": {
+            "factory": "0xc35DADB65012eC5796536bD9864eD8773aBc74C4",
+            "router": "0x0a6e511Fe663827b9cA7e2D2542b20B37fC217A6",
+            "quoter": "0xb1E835Dc2785b52265711e17fCCb0fd018226a6e",
+            "position_manager": "0x80C7DD17B01855a6D2347444a0FCC36136a314de"
+        },
+        "42161": {
+            "factory": "0x1af415a1EbA07a4986a52B6f2e7dE7003D82231e",
+            "router": "0x0a6e511Fe663827b9cA7e2D2542b20B37fC217A6",
+            "quoter": "0xb1E835Dc2785b52265711e17fCCb0fd018226a6e",
+            "position_manager": "0x717b7948AA264DeCf4D780aa6914482e5F46Da3e"
+        },
+        "43114": {
+            "factory": "0x3e603C14aF37EBdaD31709C4f848Fc6aD5BEc715",
+            "router": "0x0a6e511Fe663827b9cA7e2D2542b20B37fC217A6",
+            "quoter": "0xb1E835Dc2785b52265711e17fCCb0fd018226a6e",
+            "position_manager": "0x18350b048AB366ed601f5AF36a0E4a4F63EFbBEd"
+        },
+        "11155111": {
+            "factory": "0x1f2FCf1d036b375b384012e61D3AA33F8C256bbE",
+            "router": "0x93c31c9C729A249b2877F7699e178F4720407733",
+            "quoter": "0x039e87AB90205F9d87c5b40d4B28e2Be45dA4a20",
+            "position_manager": "0x6CE4e3489aA4Ae7B7CcE1719De0Ef7F1c94eDC02"
+        }
+    },
+    "pancakeswap_v2": {
+        "1": {
+            "factory": "0x1097053Fd2ea711dad45caCcc45EfF7548fCB362",
+            "router": "0xEfF92A263d31888d860bD50809A8D171709b7b1c"
+        },
+        "56": {
+            "factory": "0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73",
+            "router": "0x10ED43C718714eb63d5aA57B78B54704E256024E"
+        },
+        "8453": {
+            "factory": "0x02a84c1b3BBD7401a5f7a18a8bE6a2A4bFC99cce",
+            "router": "0x8cFe327CEc66d1C090Dd72bd0FF11d690C33a2Eb"
+        },
+        "42161": {
+            "factory": "0x02a84c1b3BBD7401a5f7a18a8bE6a2A4bFC99cce",
+            "router": "0x8cFe327CEc66d1C090Dd72bd0FF11d690C33a2Eb"
+        }
+    },
+    "pancakeswap_v3": {
+        "1": {
+            "factory": "0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865",
+            "router": "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4",
+            "quoter": "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997",
+            "position_manager": "0x46A15B0b27311cedF172AB29E4f4766fbE7F4364"
+        },
+        "56": {
+            "factory": "0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865",
+            "router": "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4",
+            "quoter": "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997",
+            "position_manager": "0x46A15B0b27311cedF172AB29E4f4766fbE7F4364"
+        },
+        "8453": {
+            "factory": "0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865",
+            "router": "0x678Aa4bF4E210cf2166753e054d5b7c31cc7fa86",
+            "quoter": "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997",
+            "position_manager": "0x46A15B0b27311cedF172AB29E4f4766fbE7F4364"
+        },
+        "42161": {
+            "factory": "0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865",
+            "router": "0x32226588378236Fd0c7c4053999F88aC0e5cAC77",
+            "quoter": "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997",
+            "position_manager": "0x46A15B0b27311cedF172AB29E4f4766fbE7F4364"
+        }
+    },
+    "quickswap_v2": {
+        "137": {
+            "factory": "0x5757371414417b8C6CAad45bAeF941aBc7d3Ab32",
+            "router": "0xa5E0829CaCEd8fFDD4De3c43696c57F7D7A678ff"
+        }
+    },
+    "quickswap_v3": {
+        "137": {
+            "factory": "0x411b0fAcC3489691f28ad58c47006AF5E3Ab3A28",
+            "router": "0xf5b509bB0909a69B1c207E495f687a596C168E12",
+            "quoter": "0xa15F0D7377B2A0C0c10db057f641beD21028FC89",
+            "position_manager": "0x8eF88E4c7CfbbaC1C163f7eddd4B578792201de6"
+        }
+    },
+    "camelot_v2": {
+        "42161": {
+            "factory": "0x6EcCab422D763aC031210895C81787E87B43A652",
+            "router": "0xc873fEcbd354f5A56E00E710B90EF4201db2448d"
+        }
+    },
+    "camelot_v3": {
+        "42161": {
+            "factory": "0x1a3c9B1d2F0529D97f2afC5136Cc23e58f1FD35d",
+            "router": "0x1F721E2E82F6676FCE4eA07A5958cF098D339e18",
+            "quoter": "0x0Fc73040b26E9bC8514fA028D998E73EB6D47088",
+            "position_manager": "0x00c7f3082833e796A5b3e4Bd59f6642FF44DCD15"
+        }
+    },
+    "traderjoe_v1": {
+        "43114": {
+            "factory": "0x9Ad6C38BE94206cA50bb0d90783181662f0Cfa10",
+            "router": "0x60aE616a2155Ee3d9A68541Ba4544862310933d4"
+        },
+        "42161": {
+            "factory": "0xaE4EC9901c3076D0DdBe76A520F9E90a6227aCB7",
+            "router": "0xbeE5c10Cf6E4F68f831E11C1D9E59B43560B3642"
+        }
+    },
+    "aerodrome": {
+        "8453": {
+            "factory": "0x420DD381b31aEf6683db6B902084cB0FFECe40Da",
+            "router": "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43"
+        }
+    },
+    "velodrome": {
+        "10": {
+            "factory": "0x25CbdDb98b35ab1FF77413456B31EC81A6B6B746",
+            "router": "0xa062aE8A9c5e11aaA026fc2670B0D65cCc8B2858"
+        }
+    }
+}

cryptointerface/periphery/dex_contracts.py

@@ -0,0 +1,56 @@
+import json
+from pathlib import Path
+
+_JSON_PATH = Path(__file__).parent / "dex_contracts.json"
+_ARCH_PATH = Path(__file__).parent / "dex_architecture.json"
+
+
+def _load() -> dict:
+    with open(_JSON_PATH, "r") as f:
+        return json.load(f)
+
+
+def _load_architecture() -> dict:
+    with open(_ARCH_PATH, "r") as f:
+        return json.load(f)
+
+
+def get_dex_architecture(dex_name: str) -> dict | None:
+    return _load_architecture().get(dex_name)
+
+
+def _save(data: dict) -> None:
+    with open(_JSON_PATH, "w") as f:
+        json.dump(data, f, indent=4)
+
+
+def get_dex_contracts(dex: str, chain_id: int) -> dict[str, str] | None:
+    """Return the contract addresses for a given DEX and chain ID, or None if unsupported."""
+    return _load().get(dex, {}).get(str(chain_id))
+
+
+def get_supported_dexes() -> list[str]:
+    return list(_load().keys())
+
+
+def get_supported_chains(dex: str) -> list[int]:
+    return [int(k) for k in _load().get(dex, {}).keys()]
+
+
+def add_dex_entry(dex: str, chain_id: int, contracts: dict[str, str | None]) -> None:
+    """
+    Add or update a chain entry for a DEX. Changes are written to dex_contracts.json.
+
+    Example:
+        add_dex_entry("sushiswap_v3", 1, {
+            "factory":          "0xbACEB8eC6b9355Dfc0269C18bac9d6E2Bdc29C4F",
+            "router":           "0x...",
+            "quoter":           "0x...",
+            "position_manager": "0x...",
+        })
+    """
+    data = _load()
+    if dex not in data:
+        data[dex] = {}
+    data[dex][str(chain_id)] = contracts
+    _save(data)

cryptointerface/periphery/enums.py

@@ -0,0 +1,31 @@
+from enum import Enum
+
+
+class Network(Enum):
+    ETHEREUM  = "1"
+    OPTIMISM  = "10"
+    BSC       = "56"
+    POLYGON   = "137"
+    BASE      = "8453"
+    ARBITRUM  = "42161"
+    CELO      = "42220"
+    AVALANCHE = "43114"
+    BLAST     = "81457"
+    ZORA      = "7777777"
+    SEPOLIA   = "11155111"
+
+
+class Platform(Enum):
+    UNISWAP_V2     = "uniswap_v2"
+    UNISWAP_V3     = "uniswap_v3"
+    SUSHISWAP_V2   = "sushiswap_v2"
+    SUSHISWAP_V3   = "sushiswap_v3"
+    PANCAKESWAP_V2 = "pancakeswap_v2"
+    PANCAKESWAP_V3 = "pancakeswap_v3"
+    QUICKSWAP_V2   = "quickswap_v2"
+    QUICKSWAP_V3   = "quickswap_v3"
+    CAMELOT_V2     = "camelot_v2"
+    CAMELOT_V3     = "camelot_v3"
+    TRADERJOE_V1   = "traderjoe_v1"
+    AERODROME      = "aerodrome"
+    VELODROME      = "velodrome"

cryptointerface/periphery/mapping.py

@@ -0,0 +1,118 @@
+# Maps CoinGecko platform/network slugs to EVM chain IDs.
+# Non-EVM chains (Cosmos, Aptos, NEAR, Tron, etc.) are mapped to None.
+COINGECKO_CHAIN_IDS: dict[str, int | None] = {
+    "ethereum": 1,
+    "arbitrum-one": 42161,
+    "arbitrum-nova": 42170,
+    "avalanche": 43114,
+    "binance-smart-chain": 56,
+    "polygon-pos": 137,
+    "polygon-zkevm": 1101,
+    "optimistic-ethereum": 10,
+    "base": 8453,
+    "blast": 81457,
+    "linea": 59144,
+    "mantle": 5000,
+    "zksync": 324,
+    "scroll": 534352,
+    "taiko": 167000,
+    "mode": 34443,
+    "zora-network": 7777777,
+    "metis-andromeda": 1088,
+    "fantom": 250,
+    "celo": 42220,
+    "moonbeam": 1284,
+    "moonriver": 1285,
+    "aurora": 1313161554,
+    "xdai": 100,  # Gnosis Chain
+    "fuse": 122,
+    "cronos": 25,
+    "kava": 2222,
+    "conflux": 1030,  # Conflux eSpace
+    "core": 1116,
+    "astar": 592,
+    "filecoin": 314,
+    "flare-network": 14,
+    "rootstock": 30,
+    "elastos": 20,
+    "telos": 40,
+    "meter": 82,
+    "tomochain": 88,
+    "kucoin-community-chain": 321,
+    "klay-token": 8217,
+    "theta": 361,
+    "velas": 106,
+    "energi": 39797,
+    "hedera-hashgraph": 295,
+    "xdc-network": 50,
+    "pulsechain": 369,
+    "ronin": 2020,
+    "x-layer": 196,
+    "manta-pacific": 169,
+    "lisk": 1135,
+    "mint": 185,
+    "sonic": 146,
+    "berachain": 80094,
+    "unichain": 130,
+    "soneium": 1868,
+    "swellchain": 1923,
+    "ink": 57073,
+    "abstract": 2741,
+    "world-chain": 480,
+    "zircuit": 48900,
+    "bob-network": 60808,
+    "morph-l2": 2818,
+    "hemi": 43111,
+    "funki": 33979,
+    "etherlink": 42793,
+    "sei-v2": 1329,
+    "apechain": 33139,
+    "degen": 666666666,
+    "iota-evm": 8822,
+    "peaq": 3338,
+    "flow-evm": 747,
+    "gravity-alpha": 1625,
+    "story": 1516,
+    "botanix": 3636,
+    "superseed": 5330,
+    "zero-network": 543210,
+    "milkomeda-cardano": 2001,
+    "pundi-aifx-omnilayer": 530,
+    "kardiachain": 24,
+    "cube": 1818,
+    "graphlinq-chain": 614,
+    "plume-network": 98866,
+    "nibiru": 6900,
+    "goat": 2345,
+    "plasma": 9745,
+    "0g": 16600,
+    "Superposition": 55244,
+    "monad": 143,
+    "megaeth": 6342,
+    "somnia": 50312,
+    "sepolia": 11155111,
+    # Non-EVM chains — no chain ID
+    "cosmos": None,
+    "aptos": None,
+    "near-protocol": None,
+    "tron": None,
+    "terra-2": None,
+    "massa": None,
+    "sora": None,
+    "solana": "solana:mainnet",
+    "glue": None,
+}
+
+
+def get_chain_id_by_name(network_name: str) -> int | None:
+    try:
+        return COINGECKO_CHAIN_IDS[network_name]
+    except KeyError:
+        return None
+
+
+def get_network_name_by_chain_id(chain_id: int) -> str | None:
+    for name, cid in COINGECKO_CHAIN_IDS.items():
+        if cid == chain_id:
+            return name
+    return None

cryptointerface/periphery/utils.py

@@ -0,0 +1,6 @@
+def to_wei(amount_in: float, decimals: int = 18) -> int:
+    return int(amount_in * 10**decimals)
+
+
+def from_wei(amount_in_wei: int, decimals: int = 18) -> float:
+    return amount_in_wei / 10**decimals

cryptointerface/providers/endpoints.json

@@ -0,0 +1,25 @@
+{
+    "infura": {
+        "1": "https://mainnet.infura.io/v3/",
+        "10": "https://optimism-mainnet.infura.io/v3/",
+        "56": "https://bsc-mainnet.infura.io/v3/",
+        "130": "https://unichain-mainnet.infura.io/v3/",
+        "137": "https://polygon-mainnet.infura.io/v3/",
+        "143": "https://monad-mainnet.infura.io/v3/",
+        "204": "https://opbnb-mainnet.infura.io/v3/",
+        "324": "https://zksync-mainnet.infura.io/v3/",
+        "1329": "https://sei-mainnet.infura.io/v3/",
+        "1923": "https://swellchain-mainnet.infura.io/v3/",
+        "5000": "https://mantle-mainnet.infura.io/v3/",
+        "6342": "https://megaeth-mainnet.infura.io/v3/",
+        "8453": "https://base-mainnet.infura.io/v3/",
+        "42161": "https://arbitrum-mainnet.infura.io/v3/",
+        "42220": "https://celo-mainnet.infura.io/v3/",
+        "43111": "https://hemi-testnet.infura.io/v3/",
+        "43114": "https://avalanche-mainnet.infura.io/v3/",
+        "59144": "https://linea-mainnet.infura.io/v3/",
+        "81457": "https://blast-mainnet.infura.io/v3/",
+        "534352": "https://scroll-mainnet.infura.io/v3/",
+        "11155111": "https://sepolia.infura.io/v3/"
+    }
+}

cryptointerface/providers/infura.py

@@ -0,0 +1,36 @@
+import json
+from pathlib import Path
+
+PARENT = Path(__file__).parent
+ENDPOINTS = PARENT / Path("endpoints.json")
+
+
+class Infura:
+    def __init__(self, api_key: str):
+        self.api_key = api_key
+
+    def get_url(self, chain_id: str) -> str:
+        return self._build_url(chain_id)
+
+    def _load_endpoints(self) -> dict:
+        with open(ENDPOINTS, "r") as file:
+            data = json.load(file)
+        return data
+
+    def add_endpoint(self, chain_id: int | str, endpoint: str) -> None:
+        data = self._load_endpoints()
+        data["infura"][str(chain_id)] = endpoint
+        with open(ENDPOINTS, "w") as file:
+            json.dump(data, file, indent=4)
+
+    def view_endpoints(self) -> list:
+        data = self._load_endpoints()
+        return data["infura"]
+
+    def _build_url(self, chain_id: str):
+        chain_id = str(chain_id)
+        data = self._load_endpoints()
+        try:
+            return data["infura"][chain_id] + self.api_key
+        except KeyError:
+            return None

cryptointerface/routes.py

@@ -0,0 +1,90 @@
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from .dex import Dex
+from .periphery.dex_contracts import get_dex_architecture
+
+
+def _get_swap_fee_bps(dex_name: str, pool_fee_tier: int | None) -> int:
+    """
+    Return the swap fee in basis points for a given DEX.
+    For V3 DEXes the fee is per-pool (stored in pools_v3.fee), so pool_fee_tier is used.
+    For V2 DEXes the fee is fixed and comes from dex_architecture.json.
+    Returns 0 if unknown.
+    """
+    arch = get_dex_architecture(dex_name)
+    if arch is None:
+        return 0
+    if pool_fee_tier is not None:
+        # V3-style: fee tier is already in basis points (e.g. 500 = 0.05%, 3000 = 0.3%)
+        return pool_fee_tier // 100
+    return arch.get("swap_fee_bps") or 0
+
+
+def get_prices(
+    dex_mapping: dict[str, Dex], token_0_address: str, token_1_address: str
+) -> dict[str, dict]:
+    """
+    Fetch prices and pool addresses for a token pair across all DEXes in parallel.
+    Returns {dex_name: {"price": float | None, "pool": str | None, "fee_bps": int}}.
+    """
+    def _fetch(dex_name: str, dex: Dex) -> tuple[str, dict]:
+        pool  = dex.pool_address(token_0_address, token_1_address)
+        price = dex.get_price(token_0_address, token_1_address) if pool else None
+
+        # Retrieve cached fee tier for V3 pools (stored as 0 for algebra, actual tier for uniswap_v3)
+        fee_tier = None
+        if pool and dex.interface:
+            from .dex import _sort_tokens
+            t0, t1 = _sort_tokens(token_0_address, token_1_address)
+            cached = dex.interface.read_pool_v3(dex.name, dex.chain_id, t0, t1)
+            if not cached.is_empty():
+                fee_tier = int(cached["fee"][0])
+
+        fee_bps = _get_swap_fee_bps(dex_name, fee_tier)
+        return dex_name, {"price": price, "pool": pool, "fee_bps": fee_bps}
+
+    results = {}
+    with ThreadPoolExecutor() as executor:
+        futures = {
+            executor.submit(_fetch, name, dex): name
+            for name, dex in dex_mapping.items()
+        }
+        for future in as_completed(futures):
+            dex_name, data = future.result()
+            results[dex_name] = data
+
+    return results
+
+
+def arbitrage_route(
+    dex_mapping: dict[str, Dex], token_0_address: str, token_1_address: str
+):
+    results = get_prices(dex_mapping, token_0_address, token_1_address)
+    available = {k: v for k, v in results.items() if v["price"] is not None}
+
+    if len(available) < 2:
+        return None
+
+    buy_dex  = min(available, key=lambda k: available[k]["price"])
+    sell_dex = max(available, key=lambda k: available[k]["price"])
+
+    buy_price  = available[buy_dex]["price"]
+    sell_price = available[sell_dex]["price"]
+
+    spread_abs = sell_price - buy_price
+    spread_pct = (spread_abs / buy_price) * 100
+
+    # Cost to buy on buy_dex then sell on sell_dex (both legs as % of trade)
+    total_fee_pct = (available[buy_dex]["fee_bps"] + available[sell_dex]["fee_bps"]) / 100
+    net_spread_pct = spread_pct - total_fee_pct
+    is_profitable = net_spread_pct > 0
+
+    return {
+        "buy":             {"dex": buy_dex,  "price": buy_price,  "pool": available[buy_dex]["pool"],  "fee_bps": available[buy_dex]["fee_bps"]},
+        "sell":            {"dex": sell_dex, "price": sell_price, "pool": available[sell_dex]["pool"], "fee_bps": available[sell_dex]["fee_bps"]},
+        "spread_abs":      round(spread_abs, 6),
+        "spread_pct":      round(spread_pct, 4),
+        "total_fee_pct":   round(total_fee_pct, 4),
+        "net_spread_pct":  round(net_spread_pct, 4),
+        "profitable":      is_profitable,
+        "all_prices":      results,
+    }