{"id":22861604,"url":"https://github.com/maneesha-raj/amm","last_synced_at":"2026-05-09T14:37:46.637Z","repository":{"id":266639197,"uuid":"897834088","full_name":"Maneesha-Raj/AMM","owner":"Maneesha-Raj","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-19T10:04:56.000Z","size":503,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-06T13:17:58.896Z","etag":null,"topics":["automated-market-makers","blockchain","ethereum","liquidity-pool","smart-contracts","solidity"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Maneesha-Raj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-03T10:17:55.000Z","updated_at":"2024-12-19T10:04:59.000Z","dependencies_parsed_at":"2024-12-05T10:26:40.470Z","dependency_job_id":"ffb9352d-8e1f-4ce0-a1a5-ddf7901c8a97","html_url":"https://github.com/Maneesha-Raj/AMM","commit_stats":null,"previous_names":["maneesha-raj/amm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maneesha-Raj%2FAMM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maneesha-Raj%2FAMM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maneesha-Raj%2FAMM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maneesha-Raj%2FAMM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maneesha-Raj","download_url":"https://codeload.github.com/Maneesha-Raj/AMM/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246443492,"owners_count":20778247,"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":["automated-market-makers","blockchain","ethereum","liquidity-pool","smart-contracts","solidity"],"created_at":"2024-12-13T10:09:38.816Z","updated_at":"2026-05-09T14:37:46.590Z","avatar_url":"https://github.com/Maneesha-Raj.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 🌟 Supply/Demand AMM (Project ongoing)\n\nSupply/Demand AMM is a decentralized Automated Market Maker built on Ethereum. It enables seamless token swapping and liquidity provision with dynamic pricing based on supply and demand curves. This AMM allows users to swap tokens, add liquidity, and benefit from a decentralized trading mechanism.\n\n## 📄 Project Overview\nSupply/Demand AMM is designed to provide an efficient and user-friendly decentralized trading experience. The platform supports liquidity providers and token traders with an adaptive pricing model driven by supply and demand.\n\n---\n\n## 🔑 Features\n\n### 👤 User Features\n- **Swap Tokens:** Trade between two tokens with dynamic pricing.\n- **Add Liquidity:** Provide liquidity to earn a share of transaction fees.\n- **View Pool Stats:** See real-time token reserves, pool fees, and your liquidity share.\n\n### 🛠️ Admin Features\n- **Manage Liquidity Pools:** Add or update token pairs.\n- **Monitor Stats:** Access insights like trading volume, total liquidity, and fees collected.\n\n---\n\n## ⚙️ Technologies Used\n\n### **Frontend**\n- React.js\n- Tailwind CSS\n- Ethers.js\n\n### **Smart Contracts**\n- Solidity\n- Hardhat\n- OpenZeppelin Libraries\n\n### **Backend (Optional)**\n- Node.js\n- Express.js\n- MongoDB (for analytics and optional off-chain data storage)\n\n---\n\n\u003c!-- ## 🛠️ Other Tools\n- **Chainlink Oracles:** For external price feeds and market data.\n- **The Graph:** To index and query on-chain data efficiently. --\u003e\n\u003c!-- - **Docker:** Simplifies deployment and ensures consistent environments. --\u003e\n\u003c!-- - **JWT Authentication:** For secure admin access. --\u003e\n\n---\n\n## 👥 User Roles and Permissions\n| Role            | Permissions                                                                 |\n|-----------------|-----------------------------------------------------------------------------|\n| Liquidity Provider | Add liquidity, view pool stats, and withdraw liquidity.                   |\n| Trader          | Swap tokens, view dynamic prices, and access pool details.                  |\n| Admin           | Add token pairs, manage liquidity pools, and monitor platform-wide stats.   |\n\n---\n\u003c!-- \n## 📌 Future Enhancements\n\n- **Advanced Token Analytics:** Visualize trading history and performance charts.\n- **Multi-Pool Support:** Introduce support for multiple token pairs with individual pools.\n- **Fee Customization:** Allow dynamic adjustment of fees for specific pools.\n- **Governance:** Implement a governance model using a native token for protocol decisions. --\u003e\n\n---\n\n## 🚀 Getting Started\n\n### Prerequisites\n\u003c!-- - Install Docker and Node.js on your system. --\u003e\n- MetaMask or a similar Ethereum wallet.\n\n### Setup Steps\n\n\u003c!-- #### 1. Clone the Repository:\n```bash\ngit clone https://github.com/\u003cYour-GitHub-Username\u003e/Supply-Demand-AMM.git\ncd Supply-Demand-AMM\n``` --\u003e\n\n#### 2. Install Dependencies:\n```bash\nnpm install\n```\n\n#### 3. Compile and Deploy Smart Contracts:\n- Update `.env` with your Infura or Alchemy API keys and wallet private key.\n- Run the following commands:\n```bash\nnpx hardhat compile\nnpx hardhat run scripts/deploy.js --network goerli\n```\n\n#### 4. Run the Application:\n- Start the frontend:\n```bash\nnpm start\n```\n- Start backend services (if applicable):\n```bash\nnode server.js\n```\n\n#### 5. Run with Docker:\n```bash\ndocker-compose up --build\n```\n\nAccess the application in your browser at: `http://localhost:3000`\n\n---\n\n## 📂 Directory Structure\n```\nSupply-Demand-AMM/\n├── contracts/           # Smart contracts written in Solidity\n├── scripts/             # Deployment and helper scripts\n├── frontend/            # React.js application for user interaction\n├── backend/             # (Optional) Node.js APIs for analytics\n├── docker-compose.yml   # Docker configuration\n└── README.md            # Project documentation\n```\n\n---\n\n## 📜 License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🤝 Contributing\nContributions are welcome! Feel free to open issues or submit pull requests to enhance the platform.\n\n---\n\n## ✨ Acknowledgments\n- Ethereum Community for their extensive resources.\n- OpenZeppelin for secure smart contract libraries.\n- Chainlink for reliable oracle services.\n- The Graph for seamless on-chain data querying.\n\n\n\n\n\n\n\n\n\u003c!-- # Sample Hardhat Project\n\nThis project demonstrates a basic Hardhat use case. It comes with a sample contract, a test for that contract, and a Hardhat Ignition module that deploys that contract.\n\nTry running some of the following tasks:\n\n```shell\nnpx hardhat help\nnpx hardhat test\nREPORT_GAS=true npx hardhat test\nnpx hardhat node\nnpx hardhat ignition deploy ./ignition/modules/Lock.js\n``` --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaneesha-raj%2Famm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaneesha-raj%2Famm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaneesha-raj%2Famm/lists"}