{"id":21361128,"url":"https://github.com/kaymen99/dex-aggregator","last_synced_at":"2025-07-13T02:32:01.780Z","repository":{"id":49719077,"uuid":"484588805","full_name":"kaymen99/Dex-aggregator","owner":"kaymen99","description":"Dapp that enable user to compare prices a cross different exchanges and swap at the best rate","archived":false,"fork":false,"pushed_at":"2022-11-20T22:28:01.000Z","size":717,"stargazers_count":5,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-03-17T23:22:20.112Z","etag":null,"topics":["1inch","aggregator","decentralized-applications","defi","exchanges","paraswap","solidity","uniswap-exchange"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kaymen99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-22T22:31:47.000Z","updated_at":"2023-02-15T08:53:02.000Z","dependencies_parsed_at":"2022-07-26T18:02:28.910Z","dependency_job_id":null,"html_url":"https://github.com/kaymen99/Dex-aggregator","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaymen99%2FDex-aggregator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaymen99%2FDex-aggregator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaymen99%2FDex-aggregator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaymen99%2FDex-aggregator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaymen99","download_url":"https://codeload.github.com/kaymen99/Dex-aggregator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225850261,"owners_count":17534067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["1inch","aggregator","decentralized-applications","defi","exchanges","paraswap","solidity","uniswap-exchange"],"created_at":"2024-11-22T06:08:41.241Z","updated_at":"2024-11-22T06:08:41.602Z","avatar_url":"https://github.com/kaymen99.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## Dex-aggregator\n\nWith the ever growing DEFI world and the appearance of multiple decentralized exchanges on the different blockchains, the WEB3 ecosystem needs a way to compare the pros \u0026 cons of swapping on each DEX. \n\nThis excatly what Paraswap \u0026 1inch protocol are trying to do, they aggregate the prices of tokens from multiple exchanges in each Blockchain (for example: uniswap, sushiswap, shibaswap in the Ethereum Mainnet), then they compare those prices and the swapping fee and offer to their user the best exchange rate possible.\n\nIn this Dapp, i built a simplified version of Paraswap it works on 4 blockchains: Ethereum, Polygon, Binance Smart Chain and the kovan testnet.For the moment it supports some well known tokens (ETH, Matic, Dai, USDC,...).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Dark\" src=\"https://user-images.githubusercontent.com/83681204/182487367-977ccc2f-2ba3-414c-9a5f-1b4b855af4a6.png\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n### Built With\n\n* [Solidity](https://docs.soliditylang.org/)\n* [Brownie](https://eth-brownie.readthedocs.io)\n* [React.js](https://reactjs.org/)\n* [ethers.js](https://docs.ethers.io/v5/)\n* [web3modal](https://github.com/Web3Modal/web3modal)\n* [material ui](https://mui.com/getting-started/installation/)\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\n### Prerequisites\n\nPlease install or have installed the following:\n* [nodejs and npm](https://nodejs.org/en/download/) \n* [python](https://www.python.org/downloads/)\n* [MetaMask](https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn) Chrome extension installed in your browser\n\n### Installation\n\n1. Installing Brownie: Brownie is a python framework for smart contracts development,testing and deployments. It's quit like [HardHat](https://hardhat.org) but it uses python for writing test and deployements scripts instead of javascript.\n   Here is a simple way to install brownie.\n   ```\n    pip install --user pipx\n    pipx ensurepath\n    # restart your terminal\n    pipx install eth-brownie\n   ```\n   Or if you can't get pipx to work, via pip (it's recommended to use pipx)\n    ```sh\n    pip install eth-brownie\n    ```\n   Install [ganache-cli](https://www.npmjs.com/package/ganache-cli): \n   ```sh\n    npm install -g ganache-cli\n    ```\n2. Clone the repo:\n   ```sh\n   git clone https://github.com/kaymen99/Dex-aggregator.git\n   cd Dex-aggregator\n   ```\n   \n3. Set your environment variables\n   To be able to deploy to real testnets you need to add your PRIVATE_KEY (You can find your PRIVATE_KEY from your ethereum wallet like metamask) and the infura project Id (just create an infura account it's free) to the .env file:\n   ```\n   PRIVATE_KEY=\u003cPRIVATE_KEY\u003e\n   WEB3_INFURA_PROJECT_ID=\u003c\u003c YOUR INFURA PROJECT ID \u003e\u003e\n   ```\n   You can choose to use ethereum testnets like rinkeby, Kovan or any other evm compatible testnet.\n   You'll also need some eth in the testnet. You can get it into your wallet by using a public faucet. \n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## How to Use\n   After going throught the installation part you can start the app by running:\n   ```sh\n   cd front-end\n   yarn\n   yarn start\n   ```\n   The front-end is built using the following libraries:\n      \u003cul\u003e\n        \u003cli\u003e\u003cb\u003eEthers.js:\u003c/b\u003e used as interface between the UI and the deployed smart contract\u003c/li\u003e\n        \u003cli\u003e\u003cb\u003eWeb3modal:\u003c/b\u003e for conecting to Metamask\u003c/li\u003e\n        \u003cli\u003e\u003cb\u003e@reduxjs/toolkit \u0026 redux-persist:\u003c/b\u003e for managing the app states (account, balance, blockchain) \u003c/li\u003e\n        \u003cli\u003e\u003cb\u003eMaterial UI:\u003c/b\u003e used for react components and styles \u003c/li\u003e    \n      \u003c/ul\u003e\n   There are 2 main components:\n      \u003cul\u003e\n        \u003cli\u003e\u003cb\u003eSwap component:\u003c/b\u003e It finds the best price possible for the user tokens from the supported exchanges and allow user to approve \u0026 excute the swap transaction \u003c/li\u003e\n        \u003cli\u003e\u003cb\u003eExchanges component:\u003c/b\u003e For getting the token prices on the different exchanges\u003c/li\u003e  \n      \u003c/ul\u003e   \n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- Contact --\u003e\n## Contact\n\nIf you have any question or problem running this project just contact me: aymenMir1001@gmail.com\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the MIT License. See `LICENSE.txt` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaymen99%2Fdex-aggregator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaymen99%2Fdex-aggregator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaymen99%2Fdex-aggregator/lists"}