Updated overview

Author: ihordiachenko

CHANGELOG.md

@@ -21,8 +21,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Products/WorldCoin State Replication:
   - Updated the relayer version in the replication guide;
-- Used `@docusaurus/plugin-ideal-image` for image optimization
-- Used `react-medium-image-zoom` to zoom images
+- Used `@docusaurus/plugin-ideal-image` for image optimization;
+- Used `react-medium-image-zoom` to zoom images;
+- Updated "Overview" doc;
 
 ### Removed
 

docs/overview.mdx

@@ -1,50 +1,69 @@
 ---
-description: Rarimo is a digital identity aggregator that uses zero-knowledge proofs for private blockchain identity verification.
+description: Rarimo is a privacy-first social protocol that seamlessly combines various identity standards and forms a private but verifiable social graph.
 ---
 import OutLink from "@site/src/components/OutLink";
 import IdealImage from '@site/src/components/IdealImage';
 
 
 # Overview
 
-## What is Rarimo?
+##  What is Rarimo
 
-Rarimo is the aggregator network for identity access and verification and utilizes zero-knowledge proofs for seamless user interactions without sacrificing privacy. It unlocks seamless portability by connecting DApps across multiple chains to a range of issuers and standards.
+Rarimo is a privacy-first social protocol that seamlessly combines various identity standards on-chain and off-chain and allows the formation of a private yet verifiable history of their use and relations.
 
-<IdealImage img={require('/img/rarimo-design-principles.png')} alt="Rarimo Design Principles" />
+<!-- TODO: a diagram? -->
 
-## Design principles
+At the core of the Rarimo Social Protocol are three design pillars:
 
-### Compatibility
+1. **Control**. Users should have exclusive authority over managing their identity and all connected attributes. Optionally, specific processes (e.g., identity recovery) can involve trusted parties for additional protection, but only at the user's request.
+1. **Privacy**. Sensitive data must remain inaccessible to third parties. The user should decide what information to share, when, and with whom. While some protocols may require verifying the user's uniqueness, this should not compromise the privacy of personal information.
+1. **Compatibility**. The digital identity solution should support various industry standards, such as W3C DID credentials, soulbound tokens (SBTs), ENS records, etc. Each of these identity formats offers unique advantages; therefore, the social protocol must allow interoperability among them. Additionally, it should support both off-chain and on-chain verification methods.
 
-Rarimo aims to harmonize the de facto industry standards, such as W3C DID credentials, soulbound tokens(SBTs), and existing identity providers. All these identity formats have unique benefits, so the protocol provides tools for interoperability between them. You can use your credentials or tokens on any chain supported by Rarirmo.
+The most significant aspect of identity is its relationships with other identities, including bidirectional attestations, shared communion, and participation. However, these should be private by default and disclosed only upon request.
 
-### Privacy
+## Why Rarimo?
 
-The self-sovereign paradigm brings ownership over identities back to the users. No third party has access to the sensitive data. Only you decide what to share and when.
+Rarimo believes that social protocols are the next frontier for Web3. A robust digital identity system is a prerequisite for building a social graph is a robust digital identity system. The current landscape of digital identity management faces significant challenges in maintaining ownership privacy and ensuring untraceability for its users. Soulbond tokens and similar on-chain solutions, while useful in representing ownership and attributes, need to provide comprehensive control and privacy guarantees. Self-sovereign identity solutions offer means to create accounts and associate attributes privately, yet they lack the inter-account relationship mapping crucial for building social graphs.
 
-Rarimo implements <OutLink href="https://docs.iden3.io/">Iden3 Zero-Knowledge protocol</OutLink> to enable privacy-preserving identity verification both on-chain and off-chain. You can prove specific facts about yourself to DApps without leaking sensitive data. For example, confirming that you're of legal age without disclosing your date of birth or the type of document used to prove it.
+Let's examine the building blocks of digital identity in web3 space:
 
-The Iden3 Profiles feature adds an extra layer of anonymity and security by allowing you to create and use separate sub-identities that can't be traced back to you.
+- Account addresses, which denote asset ownership and balance.
+- NFT and SBT tokens signifying memberships and attributes
+- Verifiable Credentials representing statements
+- Web services that bridge web3 applications with the traditional web
+- Document-derived artifacts representing legal documents to be integrated and utilized within web3.
 
-### Standardized verification
+From these separately evolving building blocks, three primary challenges emerge:
+- **Identity fragmentation and a lack of interoperability**: It is difficult for DApps to verify users accurately from different ecosystems, which obstructs the unification of identity components across different chains.
+- **Privacy concerns**: Maintaining a reasonable level of anonymity or managing sensitive data on-chain proves difficult. Currently, only protocols incorporating zero-knowledge proofs effectively address these privacy issues.
+- **Complex identity verification algorithms**: The challenge of building a universal identity query that covers all potential scenarios complicates identity verification. Although verification methods are robust, a standardized API is essential for developing applications that can navigate this complexity.
 
-Rarimo facilitates a solid framework for issuing credentials and using them to create on-chain Zero-Knowledge proofs of identity:
+Rarimo aims to solve these challenges by providing a robust baselayer and diverse ZK-enabled identity tools.
 
-- As an identity provider, you get tools and a structured process for issuing and managing credentials;
-- As a DApp developer, you can tap into the pool of existing identity providers and credential schemas to verify your users;
-- As a user, you can keep all your credentials in RariMe MetaMask snap;
+## Rarimo architecture
 
-### Cost efficiency
+### Rarimo Core
 
-Cross-chain tech can get expensive for both DApp builders and end users, so the protocol was designed with gas cost optimization in mind.
+The Rarimo Core is a decentralized blockchain-based system designed for timestamping, storing, and updating identity states and social relations that other networks and protocols can use. It is maintained by a set of validators that achieve consensus using the BFT-based delegated Proof-of-Stake mechanism. The chain has instant finality and supports EVM-compatible smart contracts. Additionally, Rarimo Core allows the efficient on-demand propagation of identity states over connected networks using decentralized oracles.
 
-Rarimo employs TSS (Threshold Signature Scheme) to minimize the cost of cross-chain transactions. The overhead is as low as checking a single ECDSA signature.
+<IdealImage img={require('/img/rarimo-core.png')} alt="Rarimo Design Principles" />
 
-The on-demand approach to syncing the necessary on-chain data ensures scaling to multiple networks is economically feasible. The identity metadata is lazily propagated to the destination chains only when needed, meaning the expenses depend only on usage, not the number of supported chains.
+### Social Protocol
 
-The gas fees can be paid by either the DApp developer or the end user. As a developer, you have the freedom to balance the user experience and the operational costs.
+The social protocol consists of two key sub-protocols:
+Zero-knowledge identity protocol based on Iden3 standard
+Biometric passport-derived profiles
 
-### Monetization for issuers
+The Iden3 protocol is suitable for receiving identity statements in a Verifiable Credential format. Rarimo allows identity providers to publish only state hashes into the Rarimo blockchain. After propagating to connected networks, DApps can use the mentioned states to verify various zero-knowledge identity statements. This flow presumes the identity provider issues Verifiable Credentials and pushes their state in the Rarimo Core or connected blockchains. Periodically or upon request, identity states are broadcast across connected networks, making them accessible to end-users directly on the requested chains.
 
-Legacy identity providers have trouble monetizing their services in Web3. Rarimo intends to offer tools for collecting usage-based fees, such as minting soulbond tokens with a limited lifespan.
+Passport-derived profiles enable users to set up an identity solely with their government-issued documents without needing a third-party issuer. Using this functionality, users can verify the authenticity of their documents without disclosing their personal information, thereby creating a profile linked to the specified data. Once the identity profile is established, users can demonstrate the validity of certain information within their documents and ensure the uniqueness of the identity for the application in use. From the cryptographic perspective, passport-derived profiles are compatible with the Iden3 protocol. Users can create passport-derived profiles and connect additional verifiable credentials or attributes. Additionally, identity providers can track passport revocation events and automatically revoke/reissue Verifiable Credentials.
+
+### Applications
+
+Rarimo provides a set of applications that leverage the Rarimo Core and Social Protocol to offer a seamless user experience. These applications include:
+
+- **RariMe**: Identity wallet that allows users to manage their digital identity and social relations, generate zero-knowledge proofs, and much more. Available as a mobile app and a MetaMask snap.
+- **Freedom Tool**: A ZK-enabled tool for transparent and privacy-preserving online voting.
+- **Proof of Humanity**: Aggregates the most popular proof of humanity solutions into a single interface available on and off-chain.
+- **Polygon ID State Replication**: Scales use of Polygon ID credentials to any EVM-compatible chain on demand.
+- **World ID State Replication**: Scales use of WolrdID proofs to any EVM-compatible chain on demand.