From d77b7744041c08ba6aa11fc61aa55f5dfe154682 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Mon, 4 Nov 2024 06:06:36 +0530
Subject: [PATCH 01/16] feat(swush): init application

---
 applications/swush-dex-aggregator.md | 282 +++++++++++++++++++++++++++
 1 file changed, 282 insertions(+)
 create mode 100644 applications/swush-dex-aggregator.md

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
new file mode 100644
index 00000000000..8b98ca9b208
--- /dev/null
+++ b/applications/swush-dex-aggregator.md
@@ -0,0 +1,282 @@
+# Swush Dex Aggregator
+
+- **Team Name:** Swush Labs
+- **Payment Details:**
+    - **DOT:** [Polkadot address] 124C7vfXbvBausfviN3ydZjj4voxPyEwmnJDuNJ9y4kU3ETN
+    - **Payment (USDC/USDT):** [Polkadot AssetHub address - USDC] 124C7vfXbvBausfviN3ydZjj4voxPyEwmnJDuNJ9y4kU3ETN
+- **[Level](https://github.com/w3f/Grants-Program/tree/master#level_slider-levels):** 2
+
+
+## Project Overview :page_facing_up:
+
+If this application is in response to an RFP, please indicate this on the first line of this section.
+
+If this is an application for a follow-up grant (the continuation of an earlier, successful W3F grant), please provide the name and/or pull request of said grant on the first line of this section.
+
+### Overview
+
+#### **Swush: A Unified DEX Aggregator for Polkadot’s Cross-Chain Ecosystem**
+
+**The Case for a DEX Aggregator**
+
+As the cross-chain asset and network grows, users increasingly need efficient, cross-chain asset trading. Yet, within Polkadot’s ecosystem, users face several significant challenges:
+
+- **Fragmented Liquidity:** Assets and liquidity are spread across Polkadot’s parachains like Hydration, Moonbeam and Asset Hub, making it difficult for users to find optimal trading routes and rates.
+- **Complex Cross-Chain Transfers:** Users must navigate multiple interfaces and steps to perform cross-chain transactions, which discourages adoption and limits liquidity flow.
+- **Underutilized Potential of Asset Hub:** Positioned as a central liquidity hub, the Asset Hub is ideally suited for cross-chain aggregation, but current solutions don’t fully capitalize on this potential.
+
+A **DEX aggregator** directly addresses these issues by connecting to multiple decentralized exchanges (DEXs) and liquidity sources, allowing users to access the best swap rates, lowest fees, and minimal slippage for their trades. Within Polkadot, an aggregator can unify these scattered resources into a single, user-friendly interface, making DeFi more accessible and enhancing overall ecosystem liquidity.
+
+**Swush: A Solution Aligned with Polkadot’s Vision**
+
+Swush is a DEX aggregator built on Polkadot Asset Hub, specifically to meet the needs of Polkadot’s cross-chain DeFi users. By leveraging cross-chain messaging (XCM), and aggregating assets from multiple parachains, Swush allows users to swap assets seamlessly across the ecosystem with minimal friction.
+
+Key features include:
+
+- **Optimized Route Selection:** Real-time analysis of liquidity and fees ensures users receive the most cost-effective swap routes.
+- **User-Friendly Cross-Chain Swaps:** A simplified interface abstracts complex cross-chain steps, making transfers straightforward.
+- **Centralized Liquidity Access:** By aggregating from Polkadot’s Asset Hub and other parachains, [s](http://swush.me/)wush maximizes the utility of existing liquidity pools.
+
+
+### Ecosystem Fit
+
+We published a initial research on current state of DEX aggregation and cross-chain transfers in ecosystem [here](https://www.notion.so/DEX-Aggregator-for-Asset-Hub-10ca0d44e13d8040ae48d2ec6f5f9a9a?pvs=21) .
+
+**Why a DEX Aggregator matters to the Polkadot Ecosystem**
+
+Our DEX aggregation thesis aligns closely with Rob's vision for the [evolution of AssetHub "Plaza"](https://www.rob.tech/blog/plaza/), where he emphasizes its current ability to scale to thousands of TPS, with even greater potential in the future. With [smart contract support](https://forum.polkadot.network/t/contracts-on-assethub-roadmap/9513) anticipated on Polkadot AssetHub by the end of December, we expect a surge in DApps and users. This growth will naturally create a demand for liquidity on AssetHub as these users and applications scale.
+
+A similar success story can be seen with the Jupiter DEX aggregator on Solana, which has greatly improved trading efficiency by aggregating liquidity across multiple DEXs, offering users the best prices with minimal slippage. I’ve shared some [key statistics](https://www.notion.so/Jupiter-on-Solana-A-Success-Story-10da0d44e13d80aea29dc771f76b67a6?pvs=21) that demonstrate Jupiter's impact on Solana.
+
+On a related note, cross-chain DEX solutions are gaining momentum. we recently came across a research paper by [LiquiSpell](https://www.frontiersin.org/journals/blockchain/articles/10.3389/fbloc.2024.1413840/full), a novel protocol unifying liquidity across multiple parachains within the Polkadot ecosystem. Other cross-chain DEX solutions like [Chainflip](https://chainflip.io/) and [Squid router](https://www.squidrouter.com/) on the Axelar Network and upcoming [Hyperbridge](https://hyperbridge.network/) are also seeing traction.
+
+Teams like Velocity Labs are advancing AssetHub integration beyond the Polkadot ecosystem, focusing on areas such as CEXs, onramps, and oracles. Their recent announcement regarding [AssetHub integration for custodians](https://medium.com/velocity-labs/improving-user-experience-for-polkadot-assets-the-ultimate-guide-for-custodians-706800a540b6) is an encouraging development.
+
+ **1. Where and How swush Fits into the Polkadot Ecosystem**
+
+Swush fits as a DEX aggregator within the Polkadot ecosystem, addressing the need for efficient, cross-chain asset swaps. By aggregating liquidity from various parachains and optimizing routes, swush  helps users access the most cost-effective and time-efficient paths for asset exchanges. This supports Polkadot’s vision of a unified, interoperable blockchain ecosystem by simplifying cross-chain DeFi activities.
+
+ **2. Target Audience**
+
+- **Primary Users:** General users in the Polkadot ecosystem looking for efficient asset swaps.
+- **Developers & DApp Builders:** Parachain developers and dApp builders seeking cross-chain liquidity solutions for their own applications.
+- **DeFi Traders:** DeFi users within the Polkadot and Kusama networks who rely on optimized routing for swaps to reduce costs and increase transaction efficiency.
+
+ **3. Problem(s) Addressed**
+
+As outlined in the **The Case for a DEX Aggregator,** Polkadot’s ecosystem faces challenges mentioned below. **Swush** tackles these issues with a clear, user-centric approach:
+
+- **Liquidity Aggregation Across Parachains:** By unifying liquidity from Polkadot’s parachains like Hydration, Moonbeam, and Asset Hub, swush provides users with optimized, cross-chain trading routes and cost-effective swap rates.
+- **Streamlined Cross-Chain Transactions:** swush simplifies complex multi-step transactions into a single, user-friendly interface, reducing friction and making cross-chain interactions accessible to all users.
+- **Enhanced Utility for Asset Hub:** With its aggregation model, swush fully leverages the Asset Hub’s capacity, positioning it as a key liquidity hub and aligning with Polkadot’s vision of a unified, interoperable DeFi ecosystem.
+
+ **4. Existing Similar Projects in Polkadot/Kusama**
+
+- While other DEXs exist in Polkadot, such as **Hydration** or **StellaSwap**, they focus more on liquidity pools and swaps within their ecosystems rather than a cross-chain aggregation solution.
+- Swush aggregates liquidity across parachains, automates route optimization, and provides a user-centric platform for efficient cross-chain swaps. This makes it distinct as it addresses liquidity fragmentation across the entire Polkadot ecosystem.
+
+ **5. Similar Projects in Other Ecosystems**
+
+- **Jupiter(Solana)** : We published some key stats [here](https://www.notion.so/Jupiter-on-Solana-A-Success-Story-10da0d44e13d80aea29dc771f76b67a6?pvs=21)
+- **1inch (Ethereum):** A popular DEX aggregator on Ethereum that uses liquidity aggregation and route optimization to lower swap costs.
+- **Thorchain (Cross-Chain):** Focuses on native cross-chain asset swaps. Swush takes a similar approach but uses Polkadot’s cross-consensus messaging (XCM)
+
+**The Case for Growth**
+
+The success of our DEX aggregator is closely tied to the adoption and growth of the **Plaza** within the Polkadot ecosystem. For a DEX on Plaza to reach its full potential, it will require strong traction and active participation from various ecosystem players.
+
+Several development teams have already expressed interest in building on Plaza, pending the launch of smart contract support, which will be essential for Plaza’s functionality. However, the immediate demand for a DEX aggregator will depend on Plaza’s initial adoption rate and traction among parachains and users.
+
+**Future Expansion** 
+
+As Plaza matures, the DEX aggregator can expand its features and integrate with new smart contracts, enabling a broader range of DeFi applications and cross-chain asset interactions. With robust adoption, the aggregator could become a key infrastructure component, supporting advanced features such as yield farming, liquidity mining, and multi-asset swaps, further enhancing Plaza’s utility and attracting even more projects and users to the ecosystem.
+
+### Project Details
+
+ **1. UI Mockups/Designs**
+
+- UI features include
+    - **Swap Interface:** Allows users to initiate and confirm cross-chain swaps with input fields for asset selection, swap amount, slippage tolerance, and fee breakdown.
+    - **Wallet Connection:** Seamless integration with popular wallets like Polkadot.js and Talisman.
+    - **Transaction History:** View of past transactions, including swap details, fees, and timestamps.
+    - **Notification System:** Real-time alerts on transaction statuses (success, pending, or failure).
+- **Mockups and UI Designs:** Our initial UI is hosted [here](https://swush-labs.github.io/swush-me-app/) , but we are working on evolving the UI/UX, checkout our ongoing work at figma [here](https://www.figma.com/design/kWunXnESHS2wN4xBESBikE/Untitled?node-id=0-1&t=axXKrqgd5AFmmKkX-1). We are still in process of finalizing the design as we intend to evolve it more and make as UX friendly as possible.
+
+ **2. API Specifications**
+
+- **Wallet APIs** : Fetches user and asset balance in real time and transaction interactions such as connecting wallet, signing a transaction etc.
+- **Rate & Fee API:** Fetches real-time swap rates and fee estimates from various DEXs on connected parachains.
+- **Route Optimization API:** Calculates the most cost-effective routes based on liquidity, fees, and network conditions.
+- **Transaction History API:** Records and retrieves completed transactions for user reference.
+
+ **3. Technology Stack**
+
+- **Frontend:** Next.js and React
+- **Backend:** Node.js with TypeScript to handle core logic, API integrations, and cross-chain messaging.
+- **Database:** MongoDB or PostgreSQL to store user transaction history and application metadata.
+- **Blockchain Integration:** Polkadot.js API to enable wallet connections, XCM transactions, and interaction with DEXs across Polkadot’s parachains.
+- **DevOps:**  CI/CD with GitHub Actions for efficient development workflows.
+
+ **4. Core Components & Architecture**
+
+- **Cross-Chain (XCM) APIs and DEX Swap Integration:**
+    - Integration of cross-chain messaging (XCM) APIs to transfer assets from asset hub to parachain(Hydration)
+- **Slippage Control and Protection:**
+    - Implementation of slippage control, allowing users to set a maximum slippage tolerance for their swaps. This ensures that users are protected against drastic price changes during the transaction execution process.
+- **Real-time Rate and Fee Updates:**
+    - Implementation of real-time updates for swap rates, liquidity, and transaction fees. This will involve pulling live data from liquidity pools or simulating real-time data based on the mock environment.
+- **Optimized Routing**
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by
+        - comparing fees,
+        - liquidity,
+        - slippage across parachains and DEXs.
+
+## insert architecture diagrams
+
+
+## Team :busts_in_silhouette:
+
+### **Team members**
+
+**Name of team leader:**
+
+- Anwesh Nayak (@muddlebee)
+
+**Names of team members:**
+
+- Arnav Nayak
+
+### **Contact**
+
+- **Contact Name:** Anwesh Nayak
+- **Contact Email:** [anweshknayak@gmail.com](mailto:anweshknayak@gmail.com)
+
+### **Legal Structure**
+
+- **Registered Address:** NA
+- **Registered Legal Entity:** NA
+
+### **Team's experience**
+
+I have around 5 years of experience in full stack development. Previously worked as a tech lead at B2B fintech firm. Also, previously was a polkadot ambassador and the community manager/moderator of the official polkadot/kusama discord. I have been contributing to the ecosystem since 2 years. Also participated in Thousand Contributors Programme by w3f and have been adding suggestions/improvements across the w3f github projects(polkodot-wiki).
+
+Also wrote a comprehensive tutorial to get started with Polkadot using the polkadot-js API (https://polkadotjs-developer-hub.gitbook.io/)
+
+**Arnav**, our lead designer has 3.5 years of experience in product, UI/UX design and management.
+
+### **Team Code Repos**
+
+https://github.com/swush-labs/
+
+### **Team Profiles (if available)**
+
+- https://github.com/muddlebee
+- https://www.linkedin.com/in/arnav-nayak-321595141/
+
+## Development Roadmap :nut_and_bolt:
+
+### Overview[](https://grants.web3.foundation/applications/typink#overview-1)
+
+- **Total Estimated Duration:** 3-4 months
+- **Full-Time Equivalent (FTE):** 1.5
+- **Total Costs:** 25,000 USD
+- **DOT %:** 50%
+
+### **Milestone 1: Foundational Development & Simulation Environment**
+
+- **Time: 1.5 - 2 months**
+- **FTE:**  1,5
+- **Costs:** 9000 USD
+
+### **Initial Proof of Concept (POC):**
+
+- **UI/UX Design**
+    - Enhance the current design mockups
+    - Establish a design system for the entire app
+- **Basic Functional UI (Responsive Design):**
+    - Creation of a responsive user interface (UI) that will serve as the primary interaction layer. The UI will include swap functionality, wallet connection, and real-time asset balances of user.
+- **Wallet Integration:**
+    - Integration of Web3 wallets (e.g., Polkadot.js, Talisman) for seamless user authentication, transaction signing, and balance viewing.
+- **Simulated Testing Environment:**
+    - Setup of a simulated testing environment to replicate real-world conditions. This will include mock wallets for swap visualizations, allowing developers to test various swap scenarios and edge cases (e.g., low liquidity, high fees).
+        - Mock multiple networks  (Polkadot Asset Hub and parachains)
+        - Liquidity pools for asset swaps.
+        - Cross-chain asset swapping
+        - Route optimization to find the best route based on fees, slippage, and liquidity.
+        - Final Aggregation and Testing Simulation
+- **Basic Notification System:**
+    - Development of a notification system to provide users with real-time feedback on transaction status.
+- **User Authentication & Profiles:**
+    - Implement user profiles to store settings (e.g.. preferred slippage tolerance).
+
+| Number | Deliverable | Specification |
+| --- | --- | --- |
+| **0a.** | License | GPLv3  |
+| **0b.** | Documentation | We will provide both **inline documentation** of the code and a basic **tutorial** |
+| **0c.** | Testing and Testing Guide | Tutorial that explains how to test all deliverables of this milestone. Core functions for this milestone will be tested with **Simulated Testing Environment** as mentioned above. |
+| **0d.** | Docker | We will provide a Dockerfile(s) that can be used to test all the functionality delivered with this milestone. |
+| 0e. | Article | We will publish an ****article for the work done. |
+| 1. | **UI/UX Design**  | (as mentioned above) |
+| 2. | **Basic Functional UI (Responsive Design)** | (as mentioned above) |
+| 3. | **Wallet Integration** | (as mentioned above) |
+| 4. | **Simulated Testing Environment** | (as mentioned above) |
+| 5. | **Basic Notification System** | (as mentioned above) |
+| 6. | **User Authentication & Profiles** | (as mentioned above) |
+
+---
+
+### **Milestone 2: Advanced Features & Full Testing**
+- **Time: 1.5 - 2 months**
+- **FTE:**  1,5
+- **Costs:** 16000 USD
+
+- **Cross-Chain (XCM) APIs and DEX Swap Integration:**
+    - Integration of cross-chain messaging (XCM) APIs to transfer assets from asset hub to parachains and vice versa
+- **Slippage Control and Protection:**
+    - Implementation of slippage control, allowing users to set a maximum slippage tolerance for their swaps. This ensures that users are protected against drastic price changes during the transaction execution process.
+- **Real-time Fee Updates:**
+    - Implementation of real-time updates for swap rates, liquidity, and transaction fees. This will involve pulling live data from liquidity pools in Asset Hub and parachain DEXes
+- **Multi Asset Pair Swap**
+    - Support swaps between asset pairs not present in liquidity pools (e.g., MYTH/USDC when only DOT/USDC and DOT/MYTH are available).
+- **Optimized Routing**
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by
+        - comparing fees,
+        - liquidity,
+        - slippage across parachain DEXs.
+- **Advanced Simulated Testing Environment:**
+    - Comprehensive testing of the entire DEX aggregator, including functionality, security, and performance. This will involve simulating various attack vectors, testing transaction reliability across multiple chains, and ensuring the stability of the platform under different scenarios (e.g., high transaction volume, fluctuating liquidity).
+- **User Transaction History:**
+    - Implementation of user transaction history, enabling users to view their past swaps.
+
+Note: for parachain DEX integration we will do for Hydration only as of now. 
+ 
+
+| Number | Deliverable | Specification |
+| --- | --- | --- |
+| **0a.** | License | GPLv3  |
+| **0b.** | Documentation | We will provide both **inline documentation** of the code and a basic **tutorial** |
+| **0c.** | Testing and Testing Guide | Tutorial that explains how to test all deliverables of this milestone. |
+| **0d.** | Docker | We will provide a Dockerfile(s) that can be used to test all the functionality delivered with this milestone. |
+| 0e. | Article | We will publish an ****article for the work done. |
+| 1. | **Cross-Chain (XCM) APIs and DEX Swap Integration** | (as mentioned above) |
+| 2. | **Slippage Control and Protection** | (as mentioned above) |
+| 3. | **Real-time Fee Updates** | (as mentioned above) |
+| 4. | **Multi Asset Pair Swap** | (as mentioned above) |
+| 5. | **Optimized Routing** | (as mentioned above) |
+| 6. | **Advanced Simulated Testing Environment** | (as mentioned above) |
+| 7 | **User Transaction History** | (as mentioned above) |
+
+## Future Plans
+
+- **Long-term Maintenance and Development Funding:**
+    - With our estimated budget, we plan for the platform to be self-sustainable for maintenance and further development until it achieves product-market fit (PMF).
+    - Should we see significant user traction after Plaza’s full launch, especially with smart contract support, we will seek additional funding.
+- **Short-term Strategy:**
+    - Our initial focus is on a beautiful UX and strong branding to build user confidence in our platform. We recognize that trust-building will take time, as users may be cautious initially. To attract new users, we plan to launch NFTs and incentive programs that encourage engagement and usage.
+- **Long-term Vision:**
+    - Establish Swush as a trusted platform and cross-chain transaction hub for Polkadot.
+    - Achieve self-sustainability through revenue streams such as trading fees, liquidity provider (LP) fees, or yield farming.
+
+## Additional Information :heavy_plus_sign:
+
+**How did you hear about the Grants Program?** Web3 Foundation Website 

From ea8b6e1850f0550f31796dd5da03b34ac7c27fe1 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 03:46:21 +0530
Subject: [PATCH 02/16] Update swush-dex-aggregator.md

add graphic illustrations and minor edits
---
 applications/swush-dex-aggregator.md | 34 ++++++++++++++++------------
 1 file changed, 19 insertions(+), 15 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 8b98ca9b208..3a7f27a0a75 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -9,13 +9,9 @@
 
 ## Project Overview :page_facing_up:
 
-If this application is in response to an RFP, please indicate this on the first line of this section.
-
-If this is an application for a follow-up grant (the continuation of an earlier, successful W3F grant), please provide the name and/or pull request of said grant on the first line of this section.
-
 ### Overview
 
-#### **Swush: A Unified DEX Aggregator for Polkadot’s Cross-Chain Ecosystem**
+### **Swush: A Unified DEX Aggregator for Polkadot’s Cross-Chain Ecosystem**
 
 **The Case for a DEX Aggregator**
 
@@ -27,7 +23,9 @@ As the cross-chain asset and network grows, users increasingly need efficient, c
 
 A **DEX aggregator** directly addresses these issues by connecting to multiple decentralized exchanges (DEXs) and liquidity sources, allowing users to access the best swap rates, lowest fees, and minimal slippage for their trades. Within Polkadot, an aggregator can unify these scattered resources into a single, user-friendly interface, making DeFi more accessible and enhancing overall ecosystem liquidity.
 
-**Swush: A Solution Aligned with Polkadot’s Vision**
+### **Swush: A Solution Aligned with Polkadot’s Vision**
+
+![cover](https://github.com/user-attachments/assets/84090aea-7633-413f-a512-fe610388d50a)
 
 Swush is a DEX aggregator built on Polkadot Asset Hub, specifically to meet the needs of Polkadot’s cross-chain DeFi users. By leveraging cross-chain messaging (XCM), and aggregating assets from multiple parachains, Swush allows users to swap assets seamlessly across the ecosystem with minimal friction.
 
@@ -35,7 +33,7 @@ Key features include:
 
 - **Optimized Route Selection:** Real-time analysis of liquidity and fees ensures users receive the most cost-effective swap routes.
 - **User-Friendly Cross-Chain Swaps:** A simplified interface abstracts complex cross-chain steps, making transfers straightforward.
-- **Centralized Liquidity Access:** By aggregating from Polkadot’s Asset Hub and other parachains, [s](http://swush.me/)wush maximizes the utility of existing liquidity pools.
+- **Centralized Liquidity Access:** By aggregating from Polkadot’s Asset Hub and other parachains, swush maximizes the utility of existing liquidity pools.
 
 
 ### Ecosystem Fit
@@ -72,8 +70,7 @@ As outlined in the **The Case for a DEX Aggregator,** Polkadot’s ecosystem fac
 
  **4. Existing Similar Projects in Polkadot/Kusama**
 
-- While other DEXs exist in Polkadot, such as **Hydration** or **StellaSwap**, they focus more on liquidity pools and swaps within their ecosystems rather than a cross-chain aggregation solution.
-- Swush aggregates liquidity across parachains, automates route optimization, and provides a user-centric platform for efficient cross-chain swaps. This makes it distinct as it addresses liquidity fragmentation across the entire Polkadot ecosystem.
+A cross-chain DEX Aggregator doesn't exist yet in the ecosystem as per our research. While other DEXs exist in Polkadot, such as **Hydration** or **StellaSwap**, they focus more on liquidity pools and swaps within their ecosystems rather than a cross-chain aggregation solution.
 
  **5. Similar Projects in Other Ecosystems**
 
@@ -87,12 +84,12 @@ The success of our DEX aggregator is closely tied to the adoption and growth of
 
 Several development teams have already expressed interest in building on Plaza, pending the launch of smart contract support, which will be essential for Plaza’s functionality. However, the immediate demand for a DEX aggregator will depend on Plaza’s initial adoption rate and traction among parachains and users.
 
-**Future Expansion** 
-
-As Plaza matures, the DEX aggregator can expand its features and integrate with new smart contracts, enabling a broader range of DeFi applications and cross-chain asset interactions. With robust adoption, the aggregator could become a key infrastructure component, supporting advanced features such as yield farming, liquidity mining, and multi-asset swaps, further enhancing Plaza’s utility and attracting even more projects and users to the ecosystem.
 
 ### Project Details
 
+![Screenshot 2024-11-05 034439](https://github.com/user-attachments/assets/c7997621-c916-441b-98d9-b43b3618f837)
+
+
  **1. UI Mockups/Designs**
 
 - UI features include
@@ -131,7 +128,7 @@ As Plaza matures, the DEX aggregator can expand its features and integrate with
         - liquidity,
         - slippage across parachains and DEXs.
 
-## insert architecture diagrams
+![Untitled-2023-12-14-2209](https://github.com/user-attachments/assets/3d549de6-3f80-4fce-afce-556a9e66cf43)
 
 
 ## Team :busts_in_silhouette:
@@ -177,7 +174,7 @@ https://github.com/swush-labs/
 
 ### Overview[](https://grants.web3.foundation/applications/typink#overview-1)
 
-- **Total Estimated Duration:** 3-4 months
+- **Total Estimated Duration:** 4 months
 - **Full-Time Equivalent (FTE):** 1.5
 - **Total Costs:** 25,000 USD
 - **DOT %:** 50%
@@ -208,6 +205,7 @@ https://github.com/swush-labs/
     - Development of a notification system to provide users with real-time feedback on transaction status.
 - **User Authentication & Profiles:**
     - Implement user profiles to store settings (e.g.. preferred slippage tolerance).
+      
 
 | Number | Deliverable | Specification |
 | --- | --- | --- |
@@ -223,13 +221,17 @@ https://github.com/swush-labs/
 | 5. | **Basic Notification System** | (as mentioned above) |
 | 6. | **User Authentication & Profiles** | (as mentioned above) |
 
+
 ---
 
+
 ### **Milestone 2: Advanced Features & Full Testing**
 - **Time: 1.5 - 2 months**
-- **FTE:**  1,5
+- **FTE:**  1.5
 - **Costs:** 16000 USD
 
+### **Features:**
+
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
     - Integration of cross-chain messaging (XCM) APIs to transfer assets from asset hub to parachains and vice versa
 - **Slippage Control and Protection:**
@@ -249,6 +251,7 @@ https://github.com/swush-labs/
     - Implementation of user transaction history, enabling users to view their past swaps.
 
 Note: for parachain DEX integration we will do for Hydration only as of now. 
+
  
 
 | Number | Deliverable | Specification |
@@ -266,6 +269,7 @@ Note: for parachain DEX integration we will do for Hydration only as of now.
 | 6. | **Advanced Simulated Testing Environment** | (as mentioned above) |
 | 7 | **User Transaction History** | (as mentioned above) |
 
+
 ## Future Plans
 
 - **Long-term Maintenance and Development Funding:**

From fbeca804fd30cd406b305c1f781c840cb311a802 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 04:17:04 +0530
Subject: [PATCH 03/16] Update swush-dex-aggregator.md

---
 applications/swush-dex-aggregator.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 3a7f27a0a75..85e5a821374 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -213,7 +213,7 @@ https://github.com/swush-labs/
 | **0b.** | Documentation | We will provide both **inline documentation** of the code and a basic **tutorial** |
 | **0c.** | Testing and Testing Guide | Tutorial that explains how to test all deliverables of this milestone. Core functions for this milestone will be tested with **Simulated Testing Environment** as mentioned above. |
 | **0d.** | Docker | We will provide a Dockerfile(s) that can be used to test all the functionality delivered with this milestone. |
-| 0e. | Article | We will publish an ****article for the work done. |
+| 0e. | Article | We will publish an article for the work done. |
 | 1. | **UI/UX Design**  | (as mentioned above) |
 | 2. | **Basic Functional UI (Responsive Design)** | (as mentioned above) |
 | 3. | **Wallet Integration** | (as mentioned above) |
@@ -226,7 +226,7 @@ https://github.com/swush-labs/
 
 
 ### **Milestone 2: Advanced Features & Full Testing**
-- **Time: 1.5 - 2 months**
+- **Time: 2-2.5 months**
 - **FTE:**  1.5
 - **Costs:** 16000 USD
 
@@ -260,7 +260,7 @@ Note: for parachain DEX integration we will do for Hydration only as of now.
 | **0b.** | Documentation | We will provide both **inline documentation** of the code and a basic **tutorial** |
 | **0c.** | Testing and Testing Guide | Tutorial that explains how to test all deliverables of this milestone. |
 | **0d.** | Docker | We will provide a Dockerfile(s) that can be used to test all the functionality delivered with this milestone. |
-| 0e. | Article | We will publish an ****article for the work done. |
+| 0e. | Article | We will publish an article for the work done. |
 | 1. | **Cross-Chain (XCM) APIs and DEX Swap Integration** | (as mentioned above) |
 | 2. | **Slippage Control and Protection** | (as mentioned above) |
 | 3. | **Real-time Fee Updates** | (as mentioned above) |

From 4689913de01a544da02a792e96abf93b9e31132f Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 06:16:32 +0530
Subject: [PATCH 04/16] Update swush-dex-aggregator.md and resize image

---
 applications/swush-dex-aggregator.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 85e5a821374..6b24df3cbc3 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -25,7 +25,7 @@ A **DEX aggregator** directly addresses these issues by connecting to multiple d
 
 ### **Swush: A Solution Aligned with Polkadot’s Vision**
 
-![cover](https://github.com/user-attachments/assets/84090aea-7633-413f-a512-fe610388d50a)
+<img src="https://github.com/user-attachments/assets/84090aea-7633-413f-a512-fe610388d50a" alt="Image description" width="960" height="580">
 
 Swush is a DEX aggregator built on Polkadot Asset Hub, specifically to meet the needs of Polkadot’s cross-chain DeFi users. By leveraging cross-chain messaging (XCM), and aggregating assets from multiple parachains, Swush allows users to swap assets seamlessly across the ecosystem with minimal friction.
 

From 37f3b41b0cdcbc5b0f70a591bc915f459adedf87 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 06:44:11 +0530
Subject: [PATCH 05/16] Update swush-dex-aggregator.md

---
 applications/swush-dex-aggregator.md | 55 ++++++++++++++--------------
 1 file changed, 28 insertions(+), 27 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 6b24df3cbc3..b3359ef0872 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -25,9 +25,9 @@ A **DEX aggregator** directly addresses these issues by connecting to multiple d
 
 ### **Swush: A Solution Aligned with Polkadot’s Vision**
 
-<img src="https://github.com/user-attachments/assets/84090aea-7633-413f-a512-fe610388d50a" alt="Image description" width="960" height="580">
+<img src="https://github.com/user-attachments/assets/84090aea-7633-413f-a512-fe610388d50a" alt="Image description" width="960" height="580"> \
 
-Swush is a DEX aggregator built on Polkadot Asset Hub, specifically to meet the needs of Polkadot’s cross-chain DeFi users. By leveraging cross-chain messaging (XCM), and aggregating assets from multiple parachains, Swush allows users to swap assets seamlessly across the ecosystem with minimal friction.
+**Swush** is a **DEX aggregator** built on Polkadot Asset Hub, specifically to meet the needs of Polkadot’s cross-chain DeFi users. By leveraging cross-chain messaging (XCM), and aggregating assets from multiple parachains, Swush allows users to swap assets seamlessly across the ecosystem with minimal friction.
 
 Key features include:
 
@@ -50,17 +50,17 @@ On a related note, cross-chain DEX solutions are gaining momentum. we recently c
 
 Teams like Velocity Labs are advancing AssetHub integration beyond the Polkadot ecosystem, focusing on areas such as CEXs, onramps, and oracles. Their recent announcement regarding [AssetHub integration for custodians](https://medium.com/velocity-labs/improving-user-experience-for-polkadot-assets-the-ultimate-guide-for-custodians-706800a540b6) is an encouraging development.
 
- **1. Where and How swush Fits into the Polkadot Ecosystem**
+*Where and How swush Fits into the Polkadot Ecosystem**
 
 Swush fits as a DEX aggregator within the Polkadot ecosystem, addressing the need for efficient, cross-chain asset swaps. By aggregating liquidity from various parachains and optimizing routes, swush  helps users access the most cost-effective and time-efficient paths for asset exchanges. This supports Polkadot’s vision of a unified, interoperable blockchain ecosystem by simplifying cross-chain DeFi activities.
 
- **2. Target Audience**
+ **Target Audience**
 
 - **Primary Users:** General users in the Polkadot ecosystem looking for efficient asset swaps.
 - **Developers & DApp Builders:** Parachain developers and dApp builders seeking cross-chain liquidity solutions for their own applications.
 - **DeFi Traders:** DeFi users within the Polkadot and Kusama networks who rely on optimized routing for swaps to reduce costs and increase transaction efficiency.
 
- **3. Problem(s) Addressed**
+ **Problem(s) Addressed**
 
 As outlined in the **The Case for a DEX Aggregator,** Polkadot’s ecosystem faces challenges mentioned below. **Swush** tackles these issues with a clear, user-centric approach:
 
@@ -68,19 +68,19 @@ As outlined in the **The Case for a DEX Aggregator,** Polkadot’s ecosystem fac
 - **Streamlined Cross-Chain Transactions:** swush simplifies complex multi-step transactions into a single, user-friendly interface, reducing friction and making cross-chain interactions accessible to all users.
 - **Enhanced Utility for Asset Hub:** With its aggregation model, swush fully leverages the Asset Hub’s capacity, positioning it as a key liquidity hub and aligning with Polkadot’s vision of a unified, interoperable DeFi ecosystem.
 
- **4. Existing Similar Projects in Polkadot/Kusama**
+ **Existing Similar Projects in Polkadot/Kusama**
 
 A cross-chain DEX Aggregator doesn't exist yet in the ecosystem as per our research. While other DEXs exist in Polkadot, such as **Hydration** or **StellaSwap**, they focus more on liquidity pools and swaps within their ecosystems rather than a cross-chain aggregation solution.
 
- **5. Similar Projects in Other Ecosystems**
+ **Similar Projects in Other Ecosystems**
 
-- **Jupiter(Solana)** : We published some key stats [here](https://www.notion.so/Jupiter-on-Solana-A-Success-Story-10da0d44e13d80aea29dc771f76b67a6?pvs=21)
+- **Jupiter(Solana)** : We published some key stats [here](https://www.notion.so/Jupiter-on-Solana-A-Success-Story-10da0d44e13d80aea29dc771f76b67a6?pvs=21).
 - **1inch (Ethereum):** A popular DEX aggregator on Ethereum that uses liquidity aggregation and route optimization to lower swap costs.
-- **Thorchain (Cross-Chain):** Focuses on native cross-chain asset swaps. Swush takes a similar approach but uses Polkadot’s cross-consensus messaging (XCM)
+- **Thorchain (Cross-Chain):** Focuses on native cross-chain asset swaps. Swush takes a similar approach but uses Polkadot’s cross-consensus messaging (XCM).
 
 **The Case for Growth**
 
-The success of our DEX aggregator is closely tied to the adoption and growth of the **Plaza** within the Polkadot ecosystem. For a DEX on Plaza to reach its full potential, it will require strong traction and active participation from various ecosystem players.
+The success of our DEX aggregator is closely tied to the adoption and growth of the **Plaza** within the Polkadot ecosystem. For a DEX aggregator on Plaza to reach its full potential, it will require strong traction and active participation from various ecosystem players.
 
 Several development teams have already expressed interest in building on Plaza, pending the launch of smart contract support, which will be essential for Plaza’s functionality. However, the immediate demand for a DEX aggregator will depend on Plaza’s initial adoption rate and traction among parachains and users.
 
@@ -90,7 +90,7 @@ Several development teams have already expressed interest in building on Plaza,
 ![Screenshot 2024-11-05 034439](https://github.com/user-attachments/assets/c7997621-c916-441b-98d9-b43b3618f837)
 
 
- **1. UI Mockups/Designs**
+ **UI Mockups/Designs**
 
 - UI features include
     - **Swap Interface:** Allows users to initiate and confirm cross-chain swaps with input fields for asset selection, swap amount, slippage tolerance, and fee breakdown.
@@ -99,14 +99,15 @@ Several development teams have already expressed interest in building on Plaza,
     - **Notification System:** Real-time alerts on transaction statuses (success, pending, or failure).
 - **Mockups and UI Designs:** Our initial UI is hosted [here](https://swush-labs.github.io/swush-me-app/) , but we are working on evolving the UI/UX, checkout our ongoing work at figma [here](https://www.figma.com/design/kWunXnESHS2wN4xBESBikE/Untitled?node-id=0-1&t=axXKrqgd5AFmmKkX-1). We are still in process of finalizing the design as we intend to evolve it more and make as UX friendly as possible.
 
- **2. API Specifications**
+ **API Specifications**
 
 - **Wallet APIs** : Fetches user and asset balance in real time and transaction interactions such as connecting wallet, signing a transaction etc.
 - **Rate & Fee API:** Fetches real-time swap rates and fee estimates from various DEXs on connected parachains.
 - **Route Optimization API:** Calculates the most cost-effective routes based on liquidity, fees, and network conditions.
 - **Transaction History API:** Records and retrieves completed transactions for user reference.
+- **XCM APIs:** Cross chain transfer of assets
 
- **3. Technology Stack**
+ **Technology Stack**
 
 - **Frontend:** Next.js and React
 - **Backend:** Node.js with TypeScript to handle core logic, API integrations, and cross-chain messaging.
@@ -114,7 +115,7 @@ Several development teams have already expressed interest in building on Plaza,
 - **Blockchain Integration:** Polkadot.js API to enable wallet connections, XCM transactions, and interaction with DEXs across Polkadot’s parachains.
 - **DevOps:**  CI/CD with GitHub Actions for efficient development workflows.
 
- **4. Core Components & Architecture**
+ **Core Components & Architecture**
 
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
     - Integration of cross-chain messaging (XCM) APIs to transfer assets from asset hub to parachain(Hydration)
@@ -123,10 +124,10 @@ Several development teams have already expressed interest in building on Plaza,
 - **Real-time Rate and Fee Updates:**
     - Implementation of real-time updates for swap rates, liquidity, and transaction fees. This will involve pulling live data from liquidity pools or simulating real-time data based on the mock environment.
 - **Optimized Routing**
-    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by
-        - comparing fees,
-        - liquidity,
-        - slippage across parachains and DEXs.
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing
+        - fees
+        - liquidity
+        - slippage across parachains and DEXs
 
 ![Untitled-2023-12-14-2209](https://github.com/user-attachments/assets/3d549de6-3f80-4fce-afce-556a9e66cf43)
 
@@ -203,7 +204,7 @@ https://github.com/swush-labs/
         - Final Aggregation and Testing Simulation
 - **Basic Notification System:**
     - Development of a notification system to provide users with real-time feedback on transaction status.
-- **User Authentication & Profiles:**
+- **User Profiles:**
     - Implement user profiles to store settings (e.g.. preferred slippage tolerance).
       
 
@@ -219,7 +220,7 @@ https://github.com/swush-labs/
 | 3. | **Wallet Integration** | (as mentioned above) |
 | 4. | **Simulated Testing Environment** | (as mentioned above) |
 | 5. | **Basic Notification System** | (as mentioned above) |
-| 6. | **User Authentication & Profiles** | (as mentioned above) |
+| 6. | **User Profiles** | (as mentioned above) |
 
 
 ---
@@ -233,18 +234,18 @@ https://github.com/swush-labs/
 ### **Features:**
 
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
-    - Integration of cross-chain messaging (XCM) APIs to transfer assets from asset hub to parachains and vice versa
+    - Integration of cross-chain messaging (XCM) APIs to transfer assets from parachains to Asset Hub after succesfull swap in parachain DEX and store as foreign asset in Polkadot Asset Hub.
 - **Slippage Control and Protection:**
-    - Implementation of slippage control, allowing users to set a maximum slippage tolerance for their swaps. This ensures that users are protected against drastic price changes during the transaction execution process.
+    - Implementation of slippage control, allowing users to swap assets below maximum slippage tolerance set in User Profiles(Milestone 1). This ensures that users are protected against drastic price changes during the transaction execution process.
 - **Real-time Fee Updates:**
-    - Implementation of real-time updates for swap rates, liquidity, and transaction fees. This will involve pulling live data from liquidity pools in Asset Hub and parachain DEXes
+    - Implementation of real-time updates for swap rates, liquidity, and transaction fees. This will involve pulling live data from liquidity pools in Asset Hub and parachain DEX.
 - **Multi Asset Pair Swap**
     - Support swaps between asset pairs not present in liquidity pools (e.g., MYTH/USDC when only DOT/USDC and DOT/MYTH are available).
 - **Optimized Routing**
-    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by
-        - comparing fees,
-        - liquidity,
-        - slippage across parachain DEXs.
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing
+        - fees
+        - liquidity
+        - slippage across parachain DEX.
 - **Advanced Simulated Testing Environment:**
     - Comprehensive testing of the entire DEX aggregator, including functionality, security, and performance. This will involve simulating various attack vectors, testing transaction reliability across multiple chains, and ensuring the stability of the platform under different scenarios (e.g., high transaction volume, fluctuating liquidity).
 - **User Transaction History:**

From 8a6bea9c1149336d48e01035dacfe68a4da5c293 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 08:28:27 +0530
Subject: [PATCH 06/16] project details and tech specs update

---
 applications/swush-dex-aggregator.md | 29 ++++++++--------------------
 1 file changed, 8 insertions(+), 21 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index b3359ef0872..2fb3ea63897 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -99,13 +99,6 @@ Several development teams have already expressed interest in building on Plaza,
     - **Notification System:** Real-time alerts on transaction statuses (success, pending, or failure).
 - **Mockups and UI Designs:** Our initial UI is hosted [here](https://swush-labs.github.io/swush-me-app/) , but we are working on evolving the UI/UX, checkout our ongoing work at figma [here](https://www.figma.com/design/kWunXnESHS2wN4xBESBikE/Untitled?node-id=0-1&t=axXKrqgd5AFmmKkX-1). We are still in process of finalizing the design as we intend to evolve it more and make as UX friendly as possible.
 
- **API Specifications**
-
-- **Wallet APIs** : Fetches user and asset balance in real time and transaction interactions such as connecting wallet, signing a transaction etc.
-- **Rate & Fee API:** Fetches real-time swap rates and fee estimates from various DEXs on connected parachains.
-- **Route Optimization API:** Calculates the most cost-effective routes based on liquidity, fees, and network conditions.
-- **Transaction History API:** Records and retrieves completed transactions for user reference.
-- **XCM APIs:** Cross chain transfer of assets
 
  **Technology Stack**
 
@@ -122,12 +115,9 @@ Several development teams have already expressed interest in building on Plaza,
 - **Slippage Control and Protection:**
     - Implementation of slippage control, allowing users to set a maximum slippage tolerance for their swaps. This ensures that users are protected against drastic price changes during the transaction execution process.
 - **Real-time Rate and Fee Updates:**
-    - Implementation of real-time updates for swap rates, liquidity, and transaction fees. This will involve pulling live data from liquidity pools or simulating real-time data based on the mock environment.
+    - Implementation of real-time updates for swap rates and transaction fees.
 - **Optimized Routing**
-    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing
-        - fees
-        - liquidity
-        - slippage across parachains and DEXs
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing fees, quote price and slippage.
 
 ![Untitled-2023-12-14-2209](https://github.com/user-attachments/assets/3d549de6-3f80-4fce-afce-556a9e66cf43)
 
@@ -197,10 +187,10 @@ https://github.com/swush-labs/
     - Integration of Web3 wallets (e.g., Polkadot.js, Talisman) for seamless user authentication, transaction signing, and balance viewing.
 - **Simulated Testing Environment:**
     - Setup of a simulated testing environment to replicate real-world conditions. This will include mock wallets for swap visualizations, allowing developers to test various swap scenarios and edge cases (e.g., low liquidity, high fees).
-        - Mock multiple networks  (Polkadot Asset Hub and parachains)
-        - Liquidity pools for asset swaps.
+        - Mock multiple networks  (Polkadot Asset Hub and parachain)
+        - Liquidity pools for asset swaps
         - Cross-chain asset swapping
-        - Route optimization to find the best route based on fees, slippage, and liquidity.
+        - Route optimization to find the most cost-efficient swap
         - Final Aggregation and Testing Simulation
 - **Basic Notification System:**
     - Development of a notification system to provide users with real-time feedback on transaction status.
@@ -238,16 +228,13 @@ https://github.com/swush-labs/
 - **Slippage Control and Protection:**
     - Implementation of slippage control, allowing users to swap assets below maximum slippage tolerance set in User Profiles(Milestone 1). This ensures that users are protected against drastic price changes during the transaction execution process.
 - **Real-time Fee Updates:**
-    - Implementation of real-time updates for swap rates, liquidity, and transaction fees. This will involve pulling live data from liquidity pools in Asset Hub and parachain DEX.
+    - Implementation of real-time updates for swap rates and transaction fees. This will involve pulling live data from Asset Hub and parachain DEX.
 - **Multi Asset Pair Swap**
     - Support swaps between asset pairs not present in liquidity pools (e.g., MYTH/USDC when only DOT/USDC and DOT/MYTH are available).
 - **Optimized Routing**
-    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing
-        - fees
-        - liquidity
-        - slippage across parachain DEX.
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap.
 - **Advanced Simulated Testing Environment:**
-    - Comprehensive testing of the entire DEX aggregator, including functionality, security, and performance. This will involve simulating various attack vectors, testing transaction reliability across multiple chains, and ensuring the stability of the platform under different scenarios (e.g., high transaction volume, fluctuating liquidity).
+    - Comprehensive testing of the entire DEX aggregator, including functionality and performance. This will involve simulating testing transaction reliability across multiple chains, and ensuring the stability of the platform under different scenarios (e.g., high transaction volume, fluctuating slippage).
 - **User Transaction History:**
     - Implementation of user transaction history, enabling users to view their past swaps.
 

From cdcbe2d2d43e9de3839c1111ff609f8058c338fe Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 09:03:03 +0530
Subject: [PATCH 07/16] Update swush-dex-aggregator.md

---
 applications/swush-dex-aggregator.md | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 2fb3ea63897..3ef7cc2ecb5 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -127,20 +127,16 @@ Several development teams have already expressed interest in building on Plaza,
 ### **Team members**
 
 **Name of team leader:**
-
 - Anwesh Nayak (@muddlebee)
 
 **Names of team members:**
-
 - Arnav Nayak
 
 ### **Contact**
-
 - **Contact Name:** Anwesh Nayak
 - **Contact Email:** [anweshknayak@gmail.com](mailto:anweshknayak@gmail.com)
 
 ### **Legal Structure**
-
 - **Registered Address:** NA
 - **Registered Legal Entity:** NA
 
@@ -213,10 +209,7 @@ https://github.com/swush-labs/
 | 6. | **User Profiles** | (as mentioned above) |
 
 
----
-
-
-### **Milestone 2: Advanced Features & Full Testing**
+### **Milestone 2: Advanced Features**
 - **Time: 2-2.5 months**
 - **FTE:**  1.5
 - **Costs:** 16000 USD

From 35b14a0eed7c27ccdba4f6735fa025ffc1c11ec5 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 10:48:32 +0530
Subject: [PATCH 08/16] =?UTF-8?q?add=20Development=20Status=20=F0=9F=93=96?=
 =?UTF-8?q?=20section?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 applications/swush-dex-aggregator.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 3ef7cc2ecb5..4bf29c392ac 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -97,8 +97,7 @@ Several development teams have already expressed interest in building on Plaza,
     - **Wallet Connection:** Seamless integration with popular wallets like Polkadot.js and Talisman.
     - **Transaction History:** View of past transactions, including swap details, fees, and timestamps.
     - **Notification System:** Real-time alerts on transaction statuses (success, pending, or failure).
-- **Mockups and UI Designs:** Our initial UI is hosted [here](https://swush-labs.github.io/swush-me-app/) , but we are working on evolving the UI/UX, checkout our ongoing work at figma [here](https://www.figma.com/design/kWunXnESHS2wN4xBESBikE/Untitled?node-id=0-1&t=axXKrqgd5AFmmKkX-1). We are still in process of finalizing the design as we intend to evolve it more and make as UX friendly as possible.
-
+- **Mockups and UI Designs:** Our ongoing work at figma [here](https://www.figma.com/design/kWunXnESHS2wN4xBESBikE/Untitled?node-id=0-1&t=axXKrqgd5AFmmKkX-1). We are still in process of finalizing the design as we intend to evolve it more and make as UX friendly as possible. 
 
  **Technology Stack**
 
@@ -157,6 +156,10 @@ https://github.com/swush-labs/
 - https://github.com/muddlebee
 - https://www.linkedin.com/in/arnav-nayak-321595141/
 
+## Development Status :open_book:
+We have added all our research work at [Ecosystem Fit section](#ecosystem-fit). \
+Our initial UI which we created is hosted [here](https://swush-labs.github.io/swush-me-app/) which we have iterated as per the designs shared at [Project Details](#project-details).
+
 ## Development Roadmap :nut_and_bolt:
 
 ### Overview[](https://grants.web3.foundation/applications/typink#overview-1)

From 50e7a4e2b08e3de96f6353ad5b43189ae74dca74 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Tue, 5 Nov 2024 11:13:05 +0530
Subject: [PATCH 09/16] Update swush-dex-aggregator.md

---
 applications/swush-dex-aggregator.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 4bf29c392ac..a6408e2d07d 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -158,7 +158,7 @@ https://github.com/swush-labs/
 
 ## Development Status :open_book:
 We have added all our research work at [Ecosystem Fit section](#ecosystem-fit). \
-Our initial UI which we created is hosted [here](https://swush-labs.github.io/swush-me-app/) which we have iterated as per the designs shared at [Project Details](#project-details).
+Our initial UI which we created is hosted [here](https://swush-labs.github.io/swush-me-app/), but we plan to iterate as per the designs shared at [Project Details](#project-details).
 
 ## Development Roadmap :nut_and_bolt:
 
@@ -172,7 +172,7 @@ Our initial UI which we created is hosted [here](https://swush-labs.github.io/sw
 ### **Milestone 1: Foundational Development & Simulation Environment**
 
 - **Time: 1.5 - 2 months**
-- **FTE:**  1,5
+- **FTE:**  1.5
 - **Costs:** 9000 USD
 
 ### **Initial Proof of Concept (POC):**

From 47c29316b20caf7bc979bab8b0013aa9002d7538 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Wed, 6 Nov 2024 05:42:07 +0530
Subject: [PATCH 10/16] minor nits

---
 applications/swush-dex-aggregator.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index a6408e2d07d..da709e0664c 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -50,9 +50,9 @@ On a related note, cross-chain DEX solutions are gaining momentum. we recently c
 
 Teams like Velocity Labs are advancing AssetHub integration beyond the Polkadot ecosystem, focusing on areas such as CEXs, onramps, and oracles. Their recent announcement regarding [AssetHub integration for custodians](https://medium.com/velocity-labs/improving-user-experience-for-polkadot-assets-the-ultimate-guide-for-custodians-706800a540b6) is an encouraging development.
 
-*Where and How swush Fits into the Polkadot Ecosystem**
+**Where and How swush Fits into the Polkadot Ecosystem**
 
-Swush fits as a DEX aggregator within the Polkadot ecosystem, addressing the need for efficient, cross-chain asset swaps. By aggregating liquidity from various parachains and optimizing routes, swush  helps users access the most cost-effective and time-efficient paths for asset exchanges. This supports Polkadot’s vision of a unified, interoperable blockchain ecosystem by simplifying cross-chain DeFi activities.
+Swush fits as a DEX aggregator on Polkadot Asset Hub, addressing the need for efficient, cross-chain asset swaps. By aggregating liquidity from various parachains and optimizing routes, swush  helps users access the most cost-effective and time-efficient paths for asset exchanges. This supports Polkadot’s vision of a unified, interoperable blockchain ecosystem by simplifying cross-chain DeFi activities.
 
  **Target Audience**
 

From cd8297d8a01d2a9050eb212d0f25e163f64deb2b Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Thu, 7 Nov 2024 04:22:28 +0530
Subject: [PATCH 11/16] asset types of Polkadot AH

---
 applications/swush-dex-aggregator.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index da709e0664c..b34287644cf 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -120,6 +120,12 @@ Several development teams have already expressed interest in building on Plaza,
 
 ![Untitled-2023-12-14-2209](https://github.com/user-attachments/assets/3d549de6-3f80-4fce-afce-556a9e66cf43)
 
+- **Asset Storage on Polkadot Asset Hub**
+We plan to store all assets, including parachain tokens such as HDX(Hydration) and GLMR(Moonbeam), as foreign assets on the Polkadot Asset Hub. The Asset Hub provides a unified repository where native tokens, parachain assets, and bridged tokens can be securely registered, managed, and operated.
+    - More info on Assets at Asset Hub https://wiki.polkadot.network/docs/build-integrate-assets
+
+![{C3C3F61D-8A45-4065-BA66-8EBAC8B96993}](https://github.com/user-attachments/assets/e5c1abf0-effd-480d-b1bb-f7810220530b)
+
 
 ## Team :busts_in_silhouette:
 

From 6b2a926d8ede1da6b63dd7b8e8ad51ad3cf8800c Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Thu, 7 Nov 2024 04:32:15 +0530
Subject: [PATCH 12/16] Update swush-dex-aggregator.md

---
 applications/swush-dex-aggregator.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index b34287644cf..5fde0b2f64c 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -110,7 +110,11 @@ Several development teams have already expressed interest in building on Plaza,
  **Core Components & Architecture**
 
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
-    - Integration of cross-chain messaging (XCM) APIs to transfer assets from asset hub to parachain(Hydration)
+    - Integrates cross-chain messaging (XCM) to transfer assets from the Asset Hub to a parachain (e.g., Hydration) for swapping. After the swap on the parachain, assets are returned to the Asset Hub, allowing users to access parachain liquidity while keeping assets on the Asset Hub.
+
+![{CE2E77C1-01B8-40A8-BF80-AA6F11ED57BE}](https://github.com/user-attachments/assets/3e06c9b2-b0e1-4fc9-9b11-377e55630469)
+
+
 - **Slippage Control and Protection:**
     - Implementation of slippage control, allowing users to set a maximum slippage tolerance for their swaps. This ensures that users are protected against drastic price changes during the transaction execution process.
 - **Real-time Rate and Fee Updates:**
@@ -226,7 +230,7 @@ Our initial UI which we created is hosted [here](https://swush-labs.github.io/sw
 ### **Features:**
 
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
-    - Integration of cross-chain messaging (XCM) APIs to transfer assets from parachains to Asset Hub after succesfull swap in parachain DEX and store as foreign asset in Polkadot Asset Hub.
+    -  Integrates cross-chain messaging (XCM) to transfer assets from the Asset Hub to a parachain (e.g., Hydration) for swapping. After the swap on the parachain, assets are returned to the Asset Hub, allowing users to access parachain liquidity while keeping assets on the Asset Hub.
 - **Slippage Control and Protection:**
     - Implementation of slippage control, allowing users to swap assets below maximum slippage tolerance set in User Profiles(Milestone 1). This ensures that users are protected against drastic price changes during the transaction execution process.
 - **Real-time Fee Updates:**

From 30ae4a03014886d7f052b4944eee311dc33bd965 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Thu, 7 Nov 2024 04:38:08 +0530
Subject: [PATCH 13/16] Update milestones and XCM clarification

---
 applications/swush-dex-aggregator.md | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 5fde0b2f64c..c0d89faa23f 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -187,9 +187,6 @@ Our initial UI which we created is hosted [here](https://swush-labs.github.io/sw
 
 ### **Initial Proof of Concept (POC):**
 
-- **UI/UX Design**
-    - Enhance the current design mockups
-    - Establish a design system for the entire app
 - **Basic Functional UI (Responsive Design):**
     - Creation of a responsive user interface (UI) that will serve as the primary interaction layer. The UI will include swap functionality, wallet connection, and real-time asset balances of user.
 - **Wallet Integration:**
@@ -214,12 +211,11 @@ Our initial UI which we created is hosted [here](https://swush-labs.github.io/sw
 | **0c.** | Testing and Testing Guide | Tutorial that explains how to test all deliverables of this milestone. Core functions for this milestone will be tested with **Simulated Testing Environment** as mentioned above. |
 | **0d.** | Docker | We will provide a Dockerfile(s) that can be used to test all the functionality delivered with this milestone. |
 | 0e. | Article | We will publish an article for the work done. |
-| 1. | **UI/UX Design**  | (as mentioned above) |
-| 2. | **Basic Functional UI (Responsive Design)** | (as mentioned above) |
-| 3. | **Wallet Integration** | (as mentioned above) |
-| 4. | **Simulated Testing Environment** | (as mentioned above) |
-| 5. | **Basic Notification System** | (as mentioned above) |
-| 6. | **User Profiles** | (as mentioned above) |
+| 1. | **Basic Functional UI (Responsive Design)** | (as mentioned above) |
+| 2. | **Wallet Integration** | (as mentioned above) |
+| 3. | **Simulated Testing Environment** | (as mentioned above) |
+| 4. | **Basic Notification System** | (as mentioned above) |
+| 5. | **User Profiles** | (as mentioned above) |
 
 
 ### **Milestone 2: Advanced Features**

From eed889519d80cfa57d0e6eed76e00ea1840b4912 Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Thu, 7 Nov 2024 05:45:47 +0530
Subject: [PATCH 14/16] Re-order Core Components

---
 applications/swush-dex-aggregator.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index c0d89faa23f..0aab4281a12 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -109,6 +109,13 @@ Several development teams have already expressed interest in building on Plaza,
 
  **Core Components & Architecture**
 
+
+- **Asset Storage on Polkadot Asset Hub**
+We plan to store all assets, including parachain tokens such as HDX(Hydration) and GLMR(Moonbeam), as foreign assets on the Polkadot Asset Hub. The Asset Hub provides a unified repository where native tokens, parachain assets, and bridged tokens can be securely registered, managed, and operated.
+    - More info on Assets at Asset Hub https://wiki.polkadot.network/docs/build-integrate-assets
+
+![{C3C3F61D-8A45-4065-BA66-8EBAC8B96993}](https://github.com/user-attachments/assets/e5c1abf0-effd-480d-b1bb-f7810220530b)
+
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
     - Integrates cross-chain messaging (XCM) to transfer assets from the Asset Hub to a parachain (e.g., Hydration) for swapping. After the swap on the parachain, assets are returned to the Asset Hub, allowing users to access parachain liquidity while keeping assets on the Asset Hub.
 
@@ -124,11 +131,6 @@ Several development teams have already expressed interest in building on Plaza,
 
 ![Untitled-2023-12-14-2209](https://github.com/user-attachments/assets/3d549de6-3f80-4fce-afce-556a9e66cf43)
 
-- **Asset Storage on Polkadot Asset Hub**
-We plan to store all assets, including parachain tokens such as HDX(Hydration) and GLMR(Moonbeam), as foreign assets on the Polkadot Asset Hub. The Asset Hub provides a unified repository where native tokens, parachain assets, and bridged tokens can be securely registered, managed, and operated.
-    - More info on Assets at Asset Hub https://wiki.polkadot.network/docs/build-integrate-assets
-
-![{C3C3F61D-8A45-4065-BA66-8EBAC8B96993}](https://github.com/user-attachments/assets/e5c1abf0-effd-480d-b1bb-f7810220530b)
 
 
 ## Team :busts_in_silhouette:

From d2c054e15d5a05cd26ef06885d9a468b88feb99a Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Fri, 8 Nov 2024 03:30:38 +0530
Subject: [PATCH 15/16] Clarify Cross-Chain (XCM) APIs and DEX Swap Integration

---
 applications/swush-dex-aggregator.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index 0aab4281a12..d64632ca306 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -118,8 +118,9 @@ We plan to store all assets, including parachain tokens such as HDX(Hydration) a
 
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
     - Integrates cross-chain messaging (XCM) to transfer assets from the Asset Hub to a parachain (e.g., Hydration) for swapping. After the swap on the parachain, assets are returned to the Asset Hub, allowing users to access parachain liquidity while keeping assets on the Asset Hub.
+    - Polkadot Asset Hub’s Asset APIs to enable real-time asset balances, rates, and integration of Asset Hub assets in cross-chain swaps.
+![{97A26176-B7E8-4A29-B683-156575BE2518}](https://github.com/user-attachments/assets/a885b892-f231-46ea-aca9-cf126e4f2d64)
 
-![{CE2E77C1-01B8-40A8-BF80-AA6F11ED57BE}](https://github.com/user-attachments/assets/3e06c9b2-b0e1-4fc9-9b11-377e55630469)
 
 
 - **Slippage Control and Protection:**
@@ -127,7 +128,7 @@ We plan to store all assets, including parachain tokens such as HDX(Hydration) a
 - **Real-time Rate and Fee Updates:**
     - Implementation of real-time updates for swap rates and transaction fees.
 - **Optimized Routing**
-    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing fees, quote price and slippage.
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing fees, quote price and slippage across various DEXes(e.g. Polkadot Asset Hub DEX and Hydration DEX)
 
 ![Untitled-2023-12-14-2209](https://github.com/user-attachments/assets/3d549de6-3f80-4fce-afce-556a9e66cf43)
 
@@ -229,6 +230,8 @@ Our initial UI which we created is hosted [here](https://swush-labs.github.io/sw
 
 - **Cross-Chain (XCM) APIs and DEX Swap Integration:**
     -  Integrates cross-chain messaging (XCM) to transfer assets from the Asset Hub to a parachain (e.g., Hydration) for swapping. After the swap on the parachain, assets are returned to the Asset Hub, allowing users to access parachain liquidity while keeping assets on the Asset Hub.
+    - Polkadot Asset Hub’s Asset APIs to enable real-time asset balances, rates, and integration of Asset Hub assets in cross-chain swaps.
+
 - **Slippage Control and Protection:**
     - Implementation of slippage control, allowing users to swap assets below maximum slippage tolerance set in User Profiles(Milestone 1). This ensures that users are protected against drastic price changes during the transaction execution process.
 - **Real-time Fee Updates:**
@@ -236,7 +239,7 @@ Our initial UI which we created is hosted [here](https://swush-labs.github.io/sw
 - **Multi Asset Pair Swap**
     - Support swaps between asset pairs not present in liquidity pools (e.g., MYTH/USDC when only DOT/USDC and DOT/MYTH are available).
 - **Optimized Routing**
-    - Automated route optimization to ensure that users are always getting the most cost-efficient swap.
+    - Automated route optimization to ensure that users are always getting the most cost-efficient swap by comparing fees, quote price and slippage across various DEXes(e.g. Polkadot Asset Hub DEX and Hydration DEX)
 - **Advanced Simulated Testing Environment:**
     - Comprehensive testing of the entire DEX aggregator, including functionality and performance. This will involve simulating testing transaction reliability across multiple chains, and ensuring the stability of the platform under different scenarios (e.g., high transaction volume, fluctuating slippage).
 - **User Transaction History:**

From 8c9a0cc66b52da01bd91b1b8e2c06555482ef01e Mon Sep 17 00:00:00 2001
From: muddlebee <anweshknayak@gmail.com>
Date: Fri, 15 Nov 2024 11:03:02 +0530
Subject: [PATCH 16/16] Clarify Chainflip and Squid router

---
 applications/swush-dex-aggregator.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/applications/swush-dex-aggregator.md b/applications/swush-dex-aggregator.md
index d64632ca306..6b773938c02 100644
--- a/applications/swush-dex-aggregator.md
+++ b/applications/swush-dex-aggregator.md
@@ -46,7 +46,7 @@ Our DEX aggregation thesis aligns closely with Rob's vision for the [evolution
 
 A similar success story can be seen with the Jupiter DEX aggregator on Solana, which has greatly improved trading efficiency by aggregating liquidity across multiple DEXs, offering users the best prices with minimal slippage. I’ve shared some [key statistics](https://www.notion.so/Jupiter-on-Solana-A-Success-Story-10da0d44e13d80aea29dc771f76b67a6?pvs=21) that demonstrate Jupiter's impact on Solana.
 
-On a related note, cross-chain DEX solutions are gaining momentum. we recently came across a research paper by [LiquiSpell](https://www.frontiersin.org/journals/blockchain/articles/10.3389/fbloc.2024.1413840/full), a novel protocol unifying liquidity across multiple parachains within the Polkadot ecosystem. Other cross-chain DEX solutions like [Chainflip](https://chainflip.io/) and [Squid router](https://www.squidrouter.com/) on the Axelar Network and upcoming [Hyperbridge](https://hyperbridge.network/) are also seeing traction.
+On a related note, cross-chain DEX solutions are gaining momentum. we recently came across a research paper by [LiquiSpell](https://www.frontiersin.org/journals/blockchain/articles/10.3389/fbloc.2024.1413840/full), a novel protocol unifying liquidity across multiple parachains within the Polkadot ecosystem. Other cross-chain DEX solutions like [Chainflip](https://chainflip.io/) and [Squid router](https://www.squidrouter.com/) on the Axelar Network are designed to connect major blockchain networks like Ethereum, Layer 2s, Solana, and others. [Hyperbridge](https://hyperbridge.network/) is also seeing traction and indicate a growing interest in seamless cross-chain liquidity.
 
 Teams like Velocity Labs are advancing AssetHub integration beyond the Polkadot ecosystem, focusing on areas such as CEXs, onramps, and oracles. Their recent announcement regarding [AssetHub integration for custodians](https://medium.com/velocity-labs/improving-user-experience-for-polkadot-assets-the-ultimate-guide-for-custodians-706800a540b6) is an encouraging development.