docs: added more explanation and video examples in README

README.md

@@ -1,11 +1,67 @@
-# ICP Sub-Account Indexer
+<img width="200" src="./docs/icsi.png">
+
+# 🧑‍🚀 ICSI: ICP Sub-Account Indexer
+
+Streamline the management and indexing of principal sub-accounts for ICRC transactions.
+
+[![Build and Test ICP Prototype Backend](https://github.com/garudaidr/icp-subaccount-indexer/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/garudaidr/icp-subaccount-indexer/actions/workflows/build-and-test.yml)
 
 ## Overview
-The ICP sub-account indexer canister provides methods that allow organization to primarily carry several operations:
+ICSI (ICP Sub-Account Indexer) is a robust solution designed to streamline the management and indexing of sub-accounts within the ICP (Internet Computer Protocol) ecosystem. This project aims to enhance the efficiency, security, and scalability of handling multiple sub-accounts under a single principal, making it easier for users and administrators to manage their ICP assets.
+
+The ICSI canister provides methods that allow organization to primarily carry several operations:
 - To generate sub-account-id in the form of hex_string
 - To track incoming ICP-token transfer into created sub-account-ids
 - To manage ICP-tokens that reside in the sub-account-ids
 
+### Video Demo
+
+If you are interested in learning more from the builders of ICSI, you can watch the product pitch and presentation in the attached videos below:
+
+- [Jagad ICSI - Product Pitch](https://youtu.be/dxknHHXws-w)  
+- [Jagad Presentation in ICP Office Hour - Stephen Antoni](https://youtu.be/uwZGl-OaPNI)
+- [Jagad App Short Product Demo](https://youtu.be/mMKuJmFbFAY)  
+
+## Description
+
+### 1. Simplicity
+
+ICSI simplifies the process of managing sub-accounts by providing a clear and intuitive interface for creating, tracking, and managing sub-accounts. Users can easily generate new sub-accounts and view transaction histories without dealing with the underlying complexities.
+
+### 2. Security
+
+Security is paramount in ICSI. By leveraging the ICP's robust security features and integrating additional validation mechanisms, ICSI ensures that all transactions are secure and compliant with best practices. Features like illicit transaction detection and refund capabilities add extra layers of protection for users' assets.
+
+### 3. Scalability
+
+ICSI is built to scale. With efficient indexing and transaction handling, the system can manage tens of thousands of sub-accounts without compromising performance. The design ensures that querying and managing transactions remains fast and reliable, even as the number of users grows.
+
+### 4. Sequence Flow
+
+[![](https://mermaid.ink/img/pako:eNqVk91q4zAQhV9FmL1oIX4BUwKhXZYUug2b_bkxhLE0TkXtkXc0CoTSd1_JWodunELXNzLSmaNPR5qXQjuDRVV4_B2QNN5Z2DP0Nan4DcBitR2ARP3wyAp8Hq8OFtR9-Qu6DuV6Ln4MvHsAS7uVMYzep8J72INRaVZt2FJSdvPKbWh2K61dIPG79e3mVFneOhJ2cUOTGW4aXiZ5Oclrynbjarlczigq9S2d0ou6w8F5K2rCax2PZdlgRp_MzsEq9QUJGQTP3bLJ7CDle0gSmC57zEGSRwKtYobuYM07m58iyNo1WbGJ9DsDedBiHeX8rnS8QtWAfkYyarVZ5yyM9U1gjz1G-uszz3kS21T8KR1S3EfTuGj0ls96pR21lvt44wforPm_YD_3gxwz9U8InfxjHjnHl3iCzN5fXQyJ7f5JlGsveL6xGOmmB9kcc5zD9LAXSgOpBlUPBPuoGJd7x6iwbTE6HLA71lQsih65B2tiD74kiLqQp5h7XVTx1wA_10VNr1EHQdz2SLqohAMuijCYeKV_-3WaRGPF8UPu6bG1X_8AfuRXQg?type=png)](https://mermaid.live/edit#pako:eNqVk91q4zAQhV9FmL1oIX4BUwKhXZYUug2b_bkxhLE0TkXtkXc0CoTSd1_JWodunELXNzLSmaNPR5qXQjuDRVV4_B2QNN5Z2DP0Nan4DcBitR2ARP3wyAp8Hq8OFtR9-Qu6DuV6Ln4MvHsAS7uVMYzep8J72INRaVZt2FJSdvPKbWh2K61dIPG79e3mVFneOhJ2cUOTGW4aXiZ5Oclrynbjarlczigq9S2d0ou6w8F5K2rCax2PZdlgRp_MzsEq9QUJGQTP3bLJ7CDle0gSmC57zEGSRwKtYobuYM07m58iyNo1WbGJ9DsDedBiHeX8rnS8QtWAfkYyarVZ5yyM9U1gjz1G-uszz3kS21T8KR1S3EfTuGj0ls96pR21lvt44wforPm_YD_3gxwz9U8InfxjHjnHl3iCzN5fXQyJ7f5JlGsveL6xGOmmB9kcc5zD9LAXSgOpBlUPBPuoGJd7x6iwbTE6HLA71lQsih65B2tiD74kiLqQp5h7XVTx1wA_10VNr1EHQdz2SLqohAMuijCYeKV_-3WaRGPF8UPu6bG1X_8AfuRXQg)
+
+## How It Works
+
+### 1. Subaccount Derivation
+
+ICSI uses a [sophisticated mechanism to derive sub-accounts](https://jagad.slab.com/posts/subaccount-derivation-mechanism-ebwjd334) from a single principal ID. Each sub-account is generated using a combination of the principal ID and a subaccount number, ensuring privacy and uniqueness. This allows for an infinite number of sub-accounts under one principal.
+
+### 2. Transaction Management
+
+Transactions are tracked and managed efficiently. ICSI can list, clear, and refund transactions across sub-accounts, ensuring that all financial activities are transparent and manageable.
+
+### 3. Sweeping Mechanism
+
+ICSI incorporates a [sweeping mechanism](https://jagad.slab.com/posts/sweeping-subaccounts-to-user-vaults-main-principal-m2pjvc1t) to centralize funds from sub-accounts to a main principal account. This process involves validating transactions and ensuring that only legitimate deposits are swept to the main account.
+
+## Technical Specifications
+
+ICSI is built with a focus on modularity and extensibility. The core components include:
+
+- **Subaccount Management**: Efficient handling of subaccount creation and indexing.
+- **Transaction Handling**: Robust mechanisms for listing, clearing, and refunding transactions.
+- **Security Features**: Integration with third-party services for transaction validation and illicit activity detection.
+
 ## Canister Methods
 The canister provides several methods to assist with ICP-token deposit management. The complete methods can be observed inside
 [Candid File](https://github.com/garudaidr/icp-subaccount-indexer/blob/main/src/icp_prototype_backend/icp_prototype_backend.did)
@@ -28,6 +84,10 @@ This method forwards ICP-token that was transacted within a single tx_hash provi
 ## Usage
 The complete step-by-step guide to deploy the Canister are outline on this [Deployment Guide](https://github.com/garudaidr/icp-subaccount-indexer/blob/main/canister-deployment-guideline.md)
 
+## Conclusion
+
+ICSI represents a significant advancement in the management of ICP sub-accounts, offering simplicity, security, and scalability. By leveraging advanced indexing and transaction handling techniques, ICSI provides a reliable and user-friendly solution for managing ICP assets.
+
 ## Research Documents
 The following are some of the research documents during specification design: