{"id":27381076,"url":"https://github.com/bubble-finance/bubble-v1-protocol","last_synced_at":"2026-02-23T23:06:31.323Z","repository":{"id":286164179,"uuid":"786399275","full_name":"Bubble-Finance/bubble-v1-protocol","owner":"Bubble-Finance","description":"Smart contracts for Bubble v1 protocol 📜","archived":false,"fork":false,"pushed_at":"2025-04-11T21:35:51.000Z","size":8305,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T22:34:32.386Z","etag":null,"topics":["dex","farms","forge","foundry","launchpad","monad","openzeppelin","raffle","smart-contracts","solidity","solmate","tokens","web3"],"latest_commit_sha":null,"homepage":"","language":"Solidity","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/Bubble-Finance.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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-04-14T10:47:58.000Z","updated_at":"2025-04-11T19:10:12.000Z","dependencies_parsed_at":"2025-04-04T18:39:02.090Z","dependency_job_id":null,"html_url":"https://github.com/Bubble-Finance/bubble-v1-protocol","commit_stats":null,"previous_names":["bubble-finance/bubble-v1-protocol"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bubble-Finance%2Fbubble-v1-protocol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bubble-Finance%2Fbubble-v1-protocol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bubble-Finance%2Fbubble-v1-protocol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bubble-Finance%2Fbubble-v1-protocol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bubble-Finance","download_url":"https://codeload.github.com/Bubble-Finance/bubble-v1-protocol/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248732043,"owners_count":21152838,"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":["dex","farms","forge","foundry","launchpad","monad","openzeppelin","raffle","smart-contracts","solidity","solmate","tokens","web3"],"created_at":"2025-04-13T14:44:14.043Z","updated_at":"2026-02-23T23:06:31.244Z","avatar_url":"https://github.com/Bubble-Finance.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- PROJECT SHIELDS --\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- \u003ca href=\"https://github.com/Bubble-Finance/bubble-v1-protocol\"\u003e\n    \u003cimg src=\"assets/icon.svg\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e --\u003e\n\n  \u003ch3 align=\"center\"\u003eBubble V1 Protocol\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Bubble is the #1 gamified and ecosystem-focused native DEX built on Monad\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/Bubble-Finance/bubble-v1-protocol/issues/new?labels=bug\u0026template=bug-report---.md\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/Bubble-Finance/bubble-v1-protocol/issues/new?labels=enhancement\u0026template=feature-request---.md\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n![bubblefi](./images/bubblefi.png)\n\nWelcome to Bubble, the #1 gamified and ecosystem-focused native DEX built on Monad. Bubble is the ultimate liquidity hub catering to the interests of both degens and mature traders alike with features such as MEV shield, gas sponsored swaps, raffle, launchpads, farms and more.\n\nThis repository houses the core and auxiliary smart contracts for Bubble v1. For those seeking non-technical, in-depth documentation, we have prepared a comprehensive guide available on [GitBook](https://bubblefi.gitbook.io/bubblefi). This resource is tailored to provide a thorough understanding of Bubble, its features, and how to get started, making it an invaluable asset for both newcomers and experienced users alike.\n\nJoin us in shaping the future of decentralized finance on Monad by contributing to Bubble. Whether you're a developer looking to build on our platform, a degen trader seeking a new exchange, or simply curious about the project, we welcome you to explore and engage with our community.\n\n### Built With\n\n- Solidity\n- Foundry\n- Pnpm\n\n\u003c!-- GETTING STARTED --\u003e\n\n## Getting Started\n\n### Prerequisites\n\nMake sure you have git, rust, foundry, node.js, and pnpm installed and configured on your system.\n\n### Installation\n\nClone the repo,\n\n```shell\ngit clone https://github.com/Bubble-Finance/bubble-v1-protocol.git\n```\n\ncd into the repo, and install the necessary dependencies\n\n```shell\ncd bubble-v1-protocol\npnpm i\nforge build\n```\n\nRun tests by executing\n\n```shell\nforge test\n```\n\nThat's it, you are good to go now!\n\n\u003c!-- ROADMAP --\u003e\n\n## Roadmap\n\n-   [x] Smart contract development\n-   [x] Unit tests\n-   [x] Write a good README.md\n\nSee the [open issues](https://github.com/Bubble-Finance/bubble-v1-protocol/issues) for a full list of proposed features (and known issues).\n\n\u003c!-- CONTRIBUTING --\u003e\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003c!-- LICENSE --\u003e\n\n## License\n\nDistributed under the MIT License. See `LICENSE.txt` for more information.\n\n\u003c!-- CONTACT --\u003e\n\n## Reach Out\n\n[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\u0026logo=discord\u0026logoColor=white)][discord-url]\n[![X](https://img.shields.io/badge/X-%23000000.svg?style=for-the-badge\u0026logo=X\u0026logoColor=white)][x-url]\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/Bubble-Finance/bubble-v1-protocol.svg?style=for-the-badge\n[contributors-url]: https://github.com/Bubble-Finance/bubble-v1-protocol/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/Bubble-Finance/bubble-v1-protocol.svg?style=for-the-badge\n[forks-url]: https://github.com/Bubble-Finance/bubble-v1-protocol/network/members\n[stars-shield]: https://img.shields.io/github/stars/Bubble-Finance/bubble-v1-protocol.svg?style=for-the-badge\n[stars-url]: https://github.com/Bubble-Finance/bubble-v1-protocol/stargazers\n[issues-shield]: https://img.shields.io/github/issues/Bubble-Finance/bubble-v1-protocol.svg?style=for-the-badge\n[issues-url]: https://github.com/Bubble-Finance/bubble-v1-protocol/issues\n[license-shield]: https://img.shields.io/github/license/Bubble-Finance/bubble-v1-protocol.svg?style=for-the-badge\n[license-url]: https://github.com/Bubble-Finance/bubble-v1-protocol/blob/master/LICENSE.txt\n[discord-url]: https://discord.gg/gUG5fhF69D\n[x-url]: https://x.com/Bubblefi_xyz\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbubble-finance%2Fbubble-v1-protocol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbubble-finance%2Fbubble-v1-protocol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbubble-finance%2Fbubble-v1-protocol/lists"}