Merge pull request #13 from okto-hq/zaje-patch

add: introduction section content

content/docs/index.mdx

@@ -4,7 +4,9 @@ full: false
 icon: Star
 ---
 
-Welcome to **Okto's developer documentation**! Whether you're building decentralized applications, managing multi-chain interactions, or exploring wallet abstraction, Okto's tools and resources are here to guide you every step of the way.
+# Welcome to the Future of Web3 Development with Okto!
+
+Build powerful decentralized applications with the ease of Web2 and the power of chain abstraction. Okto empowers you to create seamless, multi-chain experiences for your users, without the blockchain complexity.
 
 
 import TechnologyCard from "app/components/mdx/TechnologyCard";
@@ -26,68 +28,66 @@ Get started with Okto SDK in just three steps:
 
   <TechnologyCard 
       icon={<LuLayoutDashboard size={"1.5rem"}/>}
-      title="Okto Dashboard" 
+      title="1. Get Your App Secret from Okto Dashboard" 
       subtitle="Sign up and retrieve your Okto App Secret" 
       link="https://dashboard.okto.tech/"
   />
 
   <TechnologyCard 
       icon={<LuToggleLeft size={"1.5rem"}/>}
-      title="Enable Chains and Tokens" 
-      subtitle="Configure Supported Chains and Tokens for your application" 
+      title="2. Configure Chains & Tokens in Dashboard" 
+      subtitle="Easily select and configure the blockchains and tokens your application will support" 
       link="https://docs.okto.tech/docs/developer-admin-dashboard/wallet-control"
   />
 
   <TechnologyCard 
       icon={<LuCode size={"1.5rem"}/>}
-      title="Choose your SDK" 
-      subtitle="Select the best SDK for your project and start building!" 
+      title="3. Choose Your SDK & Start Building!" 
+      subtitle="Select the Okto SDK that best fits your project's platform and begin integrating Web3 features effortlessly." 
       link="/docs/sdk-overview"
   />
 
 </div>
 
 ---
 
-## What is Okto SDK?
-
-Okto SDK empowers developers with tools to integrate Web3 functionality into their applications. It provides interoperable embedded wallets that offer a **Web2-like user experience**, simplifying blockchain adoption for developers and users.
-
-With Okto SDK, you can:
-- Transition Web2 apps into Web3 platforms seamlessly.
-- Simplify cross-chain interactions.
-- Accelerate Web3 adoption with user-friendly features.
-
-<TechnologyCard 
-    icon={<LuCode size={"1.5rem"}/>}
-    title="Explore SDK Documentation"
-    subtitle="Discover how Okto SDK works and integrate it into your app"
-    link="/docs/okto-sdk/supported-sdk-platforms"
-/>
-
----
+## Explore Okto: Dive Deeper & Learn More
 
-## Learn More 
+Ready to understand the power of Okto in detail? Explore these key resources:
 
 <div className="grid grid-cols-1 md:grid-cols-2 gap-3 md:gap-6 lg:gap-8">
-  <TechnologyCard 
-      icon={<IoDocumentOutline size={"1.5rem"}/>}
-      title="Introduction to Okto"
-      subtitle="Understand the basics of Okto"
-      link="/docs/introduction-to-okto/okto-universe"
+  <TechnologyCard
+      icon={<LuBookOpen size={"1.5rem"}/>}
+      title="Introduction to Okto Universe"
+      subtitle="Discover the core concepts, architecture, and benefits of the Okto Layer and its components."
+      link="/docs/okto-ecosystem"
   />
 
-  <TechnologyCard 
+  <TechnologyCard
+      icon={<MousePointer2 size={"1.5rem"}/>}
+      title="Discover Okto SDK"
+      subtitle="Learn more about the Okto SDK and how it works."
+      link="/docs/okto-sdk/sdk-introduction"
+  />
+
+  <TechnologyCard
       icon={<LuLayoutDashboard size={"1.5rem"}/>}
-      title="Using dashboard" 
-      subtitle="Customize your onboarding UI" 
+      title="Master the Developer Dashboard"
+      subtitle="Learn how to leverage the Okto Admin Dashboard to configure your application, manage sponsorship, and customize onboarding flows."
       link="docs/developer-admin-dashboard/overview"
   />
 
-   <TechnologyCard 
-      icon={<MessageSquareText size={"1.5rem"}/>}
-      title="Join community" 
-      subtitle="Connect with developers on Discord" 
+  <TechnologyCard
+      icon={<MousePointer2 size={"1.5rem"}/>}
+      title="Real World Use Cases & Examples"
+      subtitle="Explore practical use cases and code examples demonstrating how to build various Web3 applications with Okto SDK."
+      link="/docs/okto-sdk/use-cases"
+  />
+
+   <TechnologyCard
+      icon={<FaDiscord size={"1.5rem"}/>}
+      title="Join the Okto Community"
+      subtitle="Connect with the Okto team and fellow developers on Discord for support, feedback, and collaboration."
       link="https://discord.com/invite/okto-916349620383252511"
   />
 

content/docs/okto-abstraction-approach.mdx

@@ -10,6 +10,8 @@ Blockchain adoption faces significant challenges due to fragmented ecosystems, c
 
 Okto achieves this by combining cutting-edge solutions like **chain abstraction**, **transaction abstraction**, **wallet abstraction**, and **liquidity abstraction** into a unified architecture. This ensures that developers and end-users can interact with blockchain ecosystems as intuitively as they would with Web2 applications.
 
+![Chain Abstraction](/images/chain-abstraction.png)
+
 ---
 
 ## The Six Dimensions of Okto's Abstraction

content/docs/okto-ecosystem.mdx

@@ -7,29 +7,33 @@ full: false
 ## What is Okto?
 
 Okto is a comprehensive orchestration layer designed to simplify the complex world of blockchain technology. Our goal is to make Web3 more accessible by addressing common challenges such as:
-- Chain abstraction
-- Account management
-- Transaction handling
-- Fee management
+- **Chain Abstraction** (accessing multiple blockchains seamlessly),
+- **Account Management** (secure self-custody without complex private key handling),
+- **Transaction Handling** (orchestration and automation of multi-step, cross-chain tasks),
+- **Fee Management** (abstracting away different gas tokens and payment flows).
 
-By tackling these issues, Okto helps both users and developers navigate the Web3 space more easily.
+Our goal is to help both developers and end-users navigate Web3 effortlessly, enabling a new era of decentralized applications with **Web2-like** simplicity.
+
+![Okto](/images/index-image.png)
 
 ## Background & Motivation
 
-Web3 promises decentralization, transparency, and user empowerment. However, mainstream adoption stalls when everyday users struggle with:
+While Web3 promises decentralization, transparency, and user empowerment, mainstream adoption has been hindered by challenges like:
 
-- Complex wallet management (private keys, multiple seed phrases)
-- Gas fees in different native tokens
-- Bridging liquidity from chain to chain
-- Fragmented developer experiences across multiple networks
+- **Complex Wallet Management:** Users often need to juggle multiple wallets, manage private keys, and remember numerous seed phrases.
+- **Diverse Gas Fee Requirements:** Navigating varying native tokens for gas across different networks complicates transactions.
+- **Fragmented Liquidity and Bridging:** Moving assets between chains involves multiple protocols and bridging steps.
+- **Inconsistent Developer Experiences:** Building on diverse blockchain networks often requires dealing with low-level details and bespoke integrations.
 
-Okto was formed to bridge this gap—combining powerful crypto primitives with a developer-friendly “abstraction layer” that seamlessly supports multiple blockchains. Ultimately, Okto aims to make blockchain interactions as easy as “click and done,” so that dApps can onboard users without friction.
+Okto was created to bridge these gaps by combining robust crypto primitives with a developer-friendly abstraction layer. Our goal is to make blockchain interactions as simple as “click and done,” allowing dApps to onboard users without friction and empowering developers to build innovative applications without deep blockchain expertise.
 
 ## Okto's Suite of Products
 
-### Okto Wallet
+The Okto Ecosystem is built on a modular architecture that includes both user-facing applications and underlying infrastructural components. Each product plays a specific role in ensuring secure, efficient, and scalable blockchain operations.
+
+### 1. Okto Wallet
 
-Okto Wallet is our powerful, self-custody Web3 trading wallet available on Android and iOS. Here's what makes it special:
+**Okto Wallet** is a fully featured DeFi application available on the Play Store and App Store. It provides:
 - **Effortless Trading**: Make trades easily for maximum returns.
 - **Airdrop Opportunities**: Stay updated on potential airdrops.
 - **Multi-Chain Support**: Manage assets across 30+ chains, including EVM, Solana, Aptos, and Cosmos.
@@ -38,7 +42,14 @@ Okto Wallet is our powerful, self-custody Web3 trading wallet available on Andro
 
 With over 1.5 million users and growing transaction volumes, Okto Wallet is quickly becoming a favorite in the crypto community. Learn more about Okto Wallet [here](https://www.okto.tech/).
 
-### Okto SDK
+### 2. Okto SDK
+
+<Callout title="Note">
+Okto Wallet and Okto SDK are independent offerings:
+
+- **Okto Wallet**: A standalone DeFi app on iOS/Android that helps users take advantage of Defi and trading opportunities in a Web2 like interface.
+- **Okto SDK**: A developer tool to help build for Web3 while abstracting out the complexities.
+</Callout>
 
 Okto SDK is our solution for developers looking to integrate Web3 features into their applications quickly and easily. Here's what Okto SDK offers:
 - **Interoperable Embedded Wallets** for developers to onboard users to Web3 with a familiar Web2-like experience.
@@ -48,18 +59,36 @@ Okto SDK is our solution for developers looking to integrate Web3 features into
 
 Okto SDK is the bridge that connects traditional web applications with the exciting world of Web3, without requiring extensive blockchain knowledge. Learn more about Okto SDK and how to use it [here](https://www.okto.tech/SDK-sdk).
 
-<Callout title="Note">
-Okto SDK and Okto App are independent of each other. Okto Wallet helps users take advantage of Defi opportunities in a Web2 like interface while Okto SDK help developers build for Web3 while abstracting out the complexities.
-</Callout>
+### 3. Okto Chain
+**Okto Chain** is a specialized, **ZK-based Layer 2** built on Polygon CDK that serves as the immutable coordination layer for the entire ecosystem. It provides:
+- **Immutable Recordkeeping:** Securely storing user intents, payload commitments, and execution logs in a tamper-proof manner.
+- **Policy Enforcement:** Validating and enforcing rules for interactions between components.
+- **Event-Driven Orchestration:** Emitting on-chain events (e.g., job creation, assignment, and termination) for automatic coordination with other Okto services.
+
+Think of Okto Chain as the **“command center”** for verifying, storing, and finalizing all cross-chain operations in a trust-minimized environment.
+
+### 4. Decentralized Wallet Network (DWN)
+The **Decentralized Wallet Network (DWN)** is the backbone for wallet management in the Okto ecosystem. Key features include:
+- **Unified Wallet Experience:** Provision and manage cross-chain smart wallets that eliminate the need for multiple, separate wallets.
+- **MPC-Based Security:** Uses Multi-Party Computation (MPC) and Trusted Execution Environments (TEEs) to securely sign transactions without exposing private keys.
+- **Seamless Integration:** Works behind the scenes to enable user authentication and transaction signing.
+
+With DWN, users don’t have to memorize seed phrases or manage multiple wallets; everything is handled through secure, decentralized signers.
 
-## Why Build on Okto SDK?
+### 5. Decentralized Transaction Network (DTN)
+The **Decentralized Transaction Network (DTN)** is the orchestration engine that processes and executes complex cross-chain transactions. Its capabilities include:
+- **Intent Decomposition:** Breaking down high-level user intents into atomic sub-transactions that can be executed independently across different chains.
+- **Secure Coordination:** Interacting with DWN for MPC-based transaction signing and with ULL for optimal liquidity routing.
+- **Asynchronous Management:** Managing parallel execution with defined ordering through on-chain events, ensuring reliable “soft finality” for each sub-transaction.
+- **Error Handling & Recovery:** Automatic monitoring and retry mechanisms to handle network volatility and transaction failures.
 
-If you're a developer considering Okto SDK for your project, here are some key benefits compared to building from scratch:
-- No RPC Configurations: Say goodbye to complex Remote Procedure Call setups.
-- Automatic Wallet Creation: User wallets are created and managed seamlessly.
-- Chain-Agnostic Development: Write your code once, deploy everywhere.
-- Web2-like Building Experience: Develop blockchain-enabled apps using familiar web development paradigms.
+By handling asynchronous multi-chain complexity, the DTN reduces the risk of user errors and failed transactions.
 
-By choosing Okto SDK, you can focus on creating great user experiences and innovative features, while we handle the blockchain complexities behind the scenes.
+### 6. Unified Liquidity Layer (ULL)
+The **Unified Liquidity Layer (ULL)** aggregates cross-chain liquidity, acting as an “aggregator of aggregators” to optimize asset transfers. Its primary functions are:
+- **Liquidity Aggregation:** Consolidating liquidity from various sources such as native bridges, DEX protocols, and third-party providers.
+- **Optimal Routing:** Select the best available route based on real-time data regarding fees, speed, and available liquidity.
+- **Standardized Execution:** Implementing cross-chain trade execution via smart contracts compliant with standards like ERC-7683.
+- **Settlement Coordination:** Working with solvers and settlers to ensure that cross-chain operations are executed securely and efficiently.
 
-Whether you're a user looking for a powerful Web3 wallet or a developer aiming to build the next big blockchain-enabled application, Okto has the tools and infrastructure to support your journey in the exciting world of Web3.
+This ensures users get optimal swap and bridging routes without manually navigating multiple portals.

content/docs/okto-layer/architecture.mdx

@@ -8,6 +8,8 @@ full: false
 
 The Okto Layer is a specialized middleware designed to simplify how developers and users interact with blockchain technology. It abstracts away the complexities of multi-chain operations—managing wallets, bridging assets, paying gas fees, and handling fragmented liquidity—making blockchain applications more accessible for everyone. 
 
+![Okto Infra](/images/okto-infra.png)
+
 ---
 
 ## Overview of the Okto Layer
@@ -40,7 +42,7 @@ The Decentralized Wallet Network is at the core of Okto’s user experience, off
 - **MPC-Based Security**: Ensures private keys are never fully exposed by leveraging Multi-Party Computation (MPC) and Trusted Execution Environments (TEEs).
 - **User-Friendly Design**: Enables logins via familiar methods like Google or Facebook, removing the need for seed phrases.
 
-[Learn more about DWNs →](#)
+[Learn more about DWNs →](./dwn)
 
 ---
 
@@ -53,7 +55,7 @@ The **ULL** addresses the challenges of fragmented liquidity across chains by ac
 - **Optimized Routes**: Automatically finds the most efficient paths for cross-chain transactions.
 - **ERC-7683 Compatibility**: Ensures seamless interactions across EVM and non-EVM chains.
 
-[Learn more about ULL →](#)
+[Learn more about ULL →](./ull)
 
 ---
 
@@ -66,7 +68,7 @@ The **DTN** automates the orchestration of complex, multi-step blockchain transa
 - **Error Handling**: Retries failed transactions automatically.
 - **Transparency**: Logs all steps on the Okto Chain for verification.
 
-[Learn more about DTNs →](#)
+[Learn more about DTNs →](./dtn)
 
 ---
 
@@ -79,7 +81,7 @@ The **Okto Chain** serves as the coordination layer for the entire Okto ecosyste
 - **Policy Management**: Tracks wallet permissions and approved bridging/transaction solutions.
 - **Scalable Rollups**: Optimized for high-volume, low-cost operations.
 
-[Learn more about the Okto Chain →](#)
+[Learn more about the Okto Chain →](./okto-chain)
 
 ---
 

content/docs/okto-layer/blocs.mdx

@@ -1,5 +1,7 @@
 ---
 title: Blocs (Coming Soon)
-description: Okto is a platform that allows you to integrate web3 functionality into your app without building things from scratch.
+description: Discover Blocs – the intuitive way to express your blockchain intents without the technical hassle.
 full: false
 ---
+
+Stay tuned as we reveal more about Blocs and how they will revolutionize the way you build and interact with decentralized applications.

content/docs/okto-layer/dtn.mdx

@@ -1,5 +1,35 @@
 ---
-title: Decentralized Transaction Network
+title: Decentralized Transaction Network (DTN)
 description: Okto is a platform that allows you to integrate web3 functionality into your app without building things from scratch.
 full: false
 ---
+
+## Decentralized Transaction Network: Introduction
+
+The Decentralized Transaction Network (DTN) is responsible for orchestrating multi-chain transactions and asynchronous workflows in the Okto ecosystem. It reads user jobs from the Okto Chain and decomposes them into sub-transactions, coordinating their execution across multiple blockchain networks. DTN ensures that transactions are executed in a secure, efficient, and verifiable manner by interfacing with both the DWN and ULL, while recording critical checkpoints on the Okto Chain.
+
+![DTN](/images/DTN-infra.png)
+
+## Core Functionality
+
+The DTN's primary function is to interpret and execute user intents that may or may not span multiple blockchains. It breaks down complex requests into manageable sub-transactions, coordinates with other Okto components (DWN, ULL), and ensures the successful and verifiable execution of cross-chain operations.
+
+Key functionalities include:
+
+- **Intent-Driven Execution:**  Breaks down a complex user intent (e.g., a multi-chain token swap) into sub-transactions that can be executed independently on target chains.
+
+- **Asynchronous Transaction Management:**  Manages sub-transactions asynchronously, optimizing for speed and efficiency across chains with varying confirmation times.
+
+- **Unified Liquidity Layer (ULL) Interaction:**  Leverages the ULL to identify and utilize optimal optimal liquidity route for each sub-transaction, ensuring cost-effectiveness and efficiency.
+
+- **Decentralized Wallet Network (DWN) Coordination:**  Collaborates with the DWN to securely obtain transaction signatures.
+
+- **On-Chain Verification and Transparency:**  Commits transaction payloads and execution status to the Okto Chain, providing an immutable and auditable record of all DTN operations.
+
+- **Error Handling and Retries:** Implements error handling and automated retry mechanisms to ensure transaction completion and resilience to network issues.
+
+## Architecture and Technology
+
+- **Decentralized Node Network:** Operates as a network of specialized nodes responsible for bidding on and executing jobs. Nodes are selected via a competitive bidding process based on performance, cost efficiency, and reputation.
+
+- **Asynchronous Transaction Management:**  Employs an asynchronous model to manage sub-transactions across different chains, accommodating varying confirmation times and network latencies.