WIP Safenet docs first iteration

pages/safenet/_meta.json

@@ -10,6 +10,7 @@
   "safenet-account": "Safenet Account",
   "safenet-transaction": "Safenet Transaction",
   "optimistic-validity-proof": "Optimistic Validity Proof",
+  "roadmap": "Roadmap",
   "-- details": {
     "type": "separator",
     "title": "Details"

pages/safenet/architecture.mdx

@@ -20,5 +20,5 @@ Safenet introduces several key roles for off-chain transaction processing:
     * **[Liquidity Providers](./core-components/liquidity-provider.mdx)**: Supply liquidity on-chain to facilitate seamless transactions across different blockchains.
 
 ### External Bridges
-External bridges are only used for dispute resolution when a validator challenges a Safenet transaction.
-
+External bridges are only used by the processor for dispute resolution when a validator challenges a Safenet transaction. 
+Users never need to interact with external bridges.

pages/safenet/chains.mdx

@@ -26,7 +26,7 @@ For example, the configurable set of safety guarantees for a user's [Safenet acc
 
 ## Chains vary per transaction
 
-For example, when a user wants to execute a transaction to spend funds on Optimism, while the funds are on Gnosis Chain, the spend chain will be Optimism, and the debit chain will be Gnosis Chain for this particular transaction.
+For example, when a user wants to execute a transaction to spend funds on Optimism, while the funds are on Arbitrum, the spend chain will be Optimism, and the debit chain will be Arbitrum for this particular transaction.
 
 When a user wants to execute a transaction on the same chain where the funds are, the spend chain and debit chain are the same.
 

pages/safenet/introduction.mdx

@@ -1,8 +1,6 @@
 ## Why Safenet?
 
-Blockchains have the potential to become society's global settlement layer, enabling seamless coordination, transactions, and a more interconnected world. Achieving this vision means moving the world's entire GDP on-chain.
-
-However, several significant challenges need to be addressed:
+Safenet's vision is to move the world's GDP on-chain. To achieve this, Safenet addresses several significant challenges the blockchain ecosystem faces:
 
 * **Fragmentation**: Different Layer 1 and Layer 2 solutions form isolated ecosystems, and blockchains are not yet fully integrated with traditional financial networks.
 * **Latency**: Cross-chain transactions face delays due to bridging mechanisms and varying block times.
@@ -11,19 +9,29 @@ However, several significant challenges need to be addressed:
 
 ## What is Safenet?
 
-Safenet is not a blockchain or layer 2 nor a bridge. 
-It's an optimistic, validity-proof transaction processing network anchored on the Ethereum mainnet. 
-It works on top of any existing or future chains and even connects on-chain and off-chain networks like Visa or centralized exchanges.
+Notably, Safenet is not a blockchain or layer 2 nor a bridge.
+
+Safenet is a **transaction processing network** similar to Visa or SWIFT.
+
+This means:
+
+* **Transaction**: A Safenet transaction is a user-initiated action that moves assets across blockchains. A Safenet transaction will usually involve multiple traditional blockchain transactions.
+At the very core of Safenet is the Safenet transaction. A Safenet transaction is a user-initiated action that moves funds. 
+* **Processing**: A Safenet transaction is different to a traditional blockchain transaction because it is processed. It is processed, which means it can include safety guarantees, additional security checks or can be settled over multiple blockchains.
+* **Network**: Safenet is not one centralized entity, but a network of decentralized operators. These operators guarantee the security of the network by keeping each other in check.
+
+It's an *optimistic, validity-proof transaction processing network* anchored on the Ethereum mainnet (these concepts will be explained in the introduction). 
+It's designed to work on top of any existing or future chains and even connects on-chain and off-chain networks like Visa or centralized exchanges.
 It separates transaction fulfillment from settlement, allowing users to interact with any supported blockchain protocol.
 It uses [optimistic validity proofs](./optimistic-validity-proof.mdx) to ensure every transaction adheres to a set of security [guarantees](./concepts/guarantee.mdx).
 
 By offloading security and cross-chain bridging responsibilities to a network of processors, validators, and liquidity providers, Safenet eliminates the complexity of cross-chain interactions. Users gain the ability to transact across blockchains with unprecedented speed and security—without needing to worry about the underlying infrastructure.
 
 ## What does Safenet enable?
 
-Safenet enables users to spend their funds on any supported blockchain without a delay and without traditional bridging.
+Safenet enables users to spend their funds on any supported blockchain without additional delays and without traditional bridging.
 It ensures that users fully control their assets and the level of transaction protection they desire.
 
 Behind the scenes, Safenet handles the settlement by coordinating funds from the various blockchains where the user holds assets.
 
-For the user, all they experience is a seamless, lightning-fast transaction.
+For the user, all they experience is a seamless transaction as fast as the blockchain mines blocks.

pages/safenet/overview.mdx

@@ -1,21 +1,25 @@
 ![Safenet-introduction](../../assets/safenet-introduction.png)
 
-# Safenet Overview
+# Safenet Docs Overview
 
-Safe announced Safenet on December 3rd, 2024. These docs describe the current state of technical vision. The current state of implementation can be found in the roadmap. 
+These docs provide an explanation of Safenet. They consist of four sections. 
 
-The docs consist of the following sections:
+**User and investors** are recommended to focus on the first section to get a high-level understanding in quickly. **Developers and builders** should start with the first section and then dive into the other parts to get a deeper understanding of the system.
 
-**[Introduction](./introduction.mdx)**: Provides a brief overview of Safenet, its high-level architecture, and the flow of a Safenet transaction. Reading this part will explain why Safe builds Safenet. It is recommended to start reading these docs with the Introduction in the given order. This page is part of the Introduction.
+The sections can be found on the left side of this page (on desktop), or the mobile navigation (on mobile).
 
-## Details
+Safenet is under active development and is prone to design changes. The current state of implementation and future plans can be found in the [roadmap](./roadmap.mdx). 
 
-**[Core Components](./core-components/processor.mdx)**: Provides details of the different components of Safenet. Reading this part will provide an understanding of what Safenet is composed of.
+## Sections
 
-**[Concepts](./concepts/settlement.mdx)**: Describes the different concepts and procedures of Safenet. Reading this part will provide an understanding of how Safenet works.
+**[Introduction](./introduction.mdx)**: Provides a basic understanding of what Safenet is and why it is build. This page is the entry point of the Introduction.
 
-**[Protocol](./protocol/overview.mdx)**: Describes the smart contracts and their role in the Safenet protocol. Reading this part will provide an understanding of Safenet's technical details.
+**[Core Components](./core-components/processor.mdx)**: Describes every part of Safenet that is not a smart contract, including the new operator roles that Safenet introduces.
+
+**[Concepts](./concepts/settlement.mdx)**: Describes Actions and Objects of Safenet, that are used by the core components and the smart contracts.
+
+**[Protocol](./protocol/overview.mdx)**: Describes the smart contracts deployed on the different chains.
 
 ## Next steps
 
-It is recommended to use the arrow buttons at the bottom of this page to read the introduction section in the given order.
+It is recommended to use the arrow buttons at the bottom of this page to read the introduction section page by page. For the first-reading, readers should not follow the links, but read the introduction in the given order.

pages/safenet/roadmap.mdx

@@ -0,0 +1,13 @@
+# Roadmap
+
+![Safenet-roadma](../../assets/safenet-roadmap.png)
+
+A first **alpha version** of Safenet is scheduled to be released in **Q1 2025**. which includes the basic ability to generate cross-chain [accounts](./safenet-account.mdx). 
+Safenet will initially be limited to certain assets and transfer limit as the liquidity network is bootstrapped.
+
+Future development and implementation of Safenet will be subject to [SafeDAO's](./protocol/safe-dao.mdx) ratification, with the envisioned approach outlined as follows:
+
+In **Q2 2025**, Safenet will be made compatible with apps that have integrated the [Safe Apps SDK](../sdk/overview.mdx). 
+
+In the **second half of 2025** the focus will shift to **scaling the liquidity network and introducing third-party processors** that will unlock the real power of Safenet.
+Making Safenet compatible with ERC-7579 will further increase its reach and composability.

pages/safenet/safenet-account.mdx

@@ -3,6 +3,6 @@
 A Safenet account is a network of [Safe Smart Accounts](../home/what-is-safe.mdx) deployed on multiple [chains](./chains.mdx).
 A Safe Smart Account is connected to a Safenet account by adding the Safenet [Guard](./protocol/guard.mdx) as a co-signer.
 
-Initially, one Safe Smart Account can be added per chain. In later phases of the roadmap, multiple Safe Smart Accounts can be added per chain.
+Initially, one Safe Smart Account can be added per chain. In later phases of the [roadmap](./roadmap.mdx), multiple Safe Smart Accounts can be added per chain.
 
 ![Safenet-account](../../assets/safenet-account.png)