{"id":21171794,"url":"https://github.com/TacitusXI/LIQUID-DEX","last_synced_at":"2025-10-02T05:30:29.729Z","repository":{"id":218941190,"uuid":"747662576","full_name":"ILESKOV/LIQUID-DEX","owner":"ILESKOV","description":"LIQUID Decentralized Exchange: A pioneering platform for seamless STX/LIQ trading, featuring the LIQUID (LIQ) SIP010 token. Connect, trade, and manage liquidity with advanced wallet integration and robust trading functionalities.","archived":false,"fork":false,"pushed_at":"2024-01-25T17:35:23.000Z","size":310,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-20T16:11:48.174Z","etag":null,"topics":["clarinet","clarity","defi","dex","liquidity-pool","smart-contracts","stacks","stx","swap"],"latest_commit_sha":null,"homepage":"https://stacks-dex.vercel.app","language":"TypeScript","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/ILESKOV.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,"governance":null,"roadmap":null,"authors":null}},"created_at":"2024-01-24T11:49:11.000Z","updated_at":"2024-03-16T13:21:57.000Z","dependencies_parsed_at":"2024-01-25T19:04:40.857Z","dependency_job_id":null,"html_url":"https://github.com/ILESKOV/LIQUID-DEX","commit_stats":null,"previous_names":["ileskov/stacks-dex","ileskov/liquid-dex"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ILESKOV%2FLIQUID-DEX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ILESKOV%2FLIQUID-DEX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ILESKOV%2FLIQUID-DEX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ILESKOV%2FLIQUID-DEX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ILESKOV","download_url":"https://codeload.github.com/ILESKOV/LIQUID-DEX/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234938509,"owners_count":18910259,"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":["clarinet","clarity","defi","dex","liquidity-pool","smart-contracts","stacks","stx","swap"],"created_at":"2024-11-20T16:12:05.638Z","updated_at":"2025-10-02T05:30:29.724Z","avatar_url":"https://github.com/ILESKOV.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 'LIQUID' Decentralized Exchange\n\n\u003e 'LIQUID' Exchange with 'LIQUID' 'LIQ' SIP010 standard token\n\n\u003e [LIQUID-DEX](https://stacks-dex.vercel.app/) vercel app\n\n## 📁 Table of Contents\n\n- [General Info](#-general-information)\n- [Features](#-features)\n- [Screenshots](#-screenshots)\n- [Setup](#-setup)\n\n## 🚩 General Information\n\n- The 'LIQUID' is an exchange for trading STX/LIQ\n- Connect with your wallet, mint, provide liquidity and trade\n- User can provide liquidity, swap , earn revenue from trading and remove liquidity\n\n## 🌟 Features\n\nList the ready features here:\n\n- Owner can mint 'LIQ' from admin panel\n- Owner can set minter from admin panel\n- User can connect to exchange via 'Leather' or 'Xverse' wallet\n- User can provide initial liqiudity\n- User can provide additional liqiudity (in that case constant formula will be applied)\n- User can remove liquidity\n- User can set slippage and swap STX/LIQ and LIQ/STX using AMM\n\n## 🎦 Screenshots\n\n![Example screenshot](./helpers/Screenshot.png)\n\n## 👀 Setup\n\n### 📦 Clone/Download the Repository\n\n## 📟 Smart Contract Deployment Setup\n\n### 2. 🗺️ Nawigate to stacks-DEX:\n\n```\n$ cd stacks-DEX\n```\n\n### 3. 💾 Install clarinet:\n\nYou can find installation instructions for Clarinet in their Github readme: https://github.com/hirosystems/clarinet#installation\n\n### 4. 📑 Import mnemonic:\n\nWe can deploy to Devnet, Testnet or Mainnet. The network chosen for deployment dictates the mnemonic to be used.\n\nFor Devnet deployments, the mnemonic is already included in the configurations, so there's no need for additional imports\n\nFor deployments to Testnet or Mainnet navigate to 'settings/Testnet.toml' or 'settings/Mainnet.toml' respectively. Update the file with the appropriate mnemonic as shown below:\n\n```\n[accounts.deployer]\nmnemonic = \"\u003cYOUR PRIVATE TESTNET MNEMONIC HERE\u003e\"\n\n```\n\n### 5. 📈 Prepare deployment plan:\n\nIt is not related to devnet.\n\nFor deployments to Testnet or Mainnet we should create deployment plan. We can do that with clarinet respectively.\n\n```\n$ clarinet deployments generate --testnet --low-cost\n\n```\n\nor\n\n```\n$ clarinet deployments generate --mainnet --low-cost\n\n```\n\n### 6. 🔥 deploy:\n\nFor devnet you should have docker and run: It will deploy devnet with your contracts.\n\n```\n$ clarity devnet start\n\n```\n\nFor deployments to Testnet or Mainnet run this respectively.\n\n```\n$ clarinet deployments apply -p deployments/default.testnet-plan.yaml\n\n```\n\nor\n\n```\n$ clarinet deployments apply -p deployments/default.mainnet-plan.yaml\n\n```\n\n### 7. ⬆️ Update frontend with deployer address:\n\nChange contract owner address in 'frontend/lib/constants.ts\n\n```\nexport const contractOwnerAddress = \u003cPut your deployer wallet address here\u003e\n\n```\n\nExample:\n\n```\nexport const contractOwnerAddress = 'ST1DAGPRT8MG9VYNV3QQSVYQBRCRHV2Z1KSVC9T2H'\n\n```\n\n## 💻 Frontend Setup\n\n### 1. 🗺️ Nawigate to frontend:\n\n```\n$ cd frontend\n```\n\n### 2. 💾 Install Dependencies:\n\n```\n$ npm install\n```\n\n### 3. 🔥 Run NextJs app:\n\n```\n$ npm run dev\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTacitusXI%2FLIQUID-DEX","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTacitusXI%2FLIQUID-DEX","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTacitusXI%2FLIQUID-DEX/lists"}