Multipeer, initial notes

Author: RichardSmedley

modules/android/nav-android.adoc

@@ -38,7 +38,8 @@ include::partial$_set_page_context_for_android.adoc[]
   * Data Sync
   ** xref:android:dbreplica.adoc[Intra-device Sync]
   ** xref:android:replication.adoc[Remote Sync Gateway]
-  ** xref:android:p2psync-websocket.adoc[Peer-to-Peer]
+  ** xref:android:p2psync-multipeer.adoc[Multipeer Replicator]
+  ** xref:android:p2psync-websocket.adoc[Active-Passive Peer-to-Peer]
   *** xref:android:p2psync-websocket-using-passive.adoc[Passive Peer]
   *** xref:android:p2psync-websocket-using-active.adoc[Active Peer]
   *** xref:android:p2psync-custom.adoc[Integrate Custom Listener]

modules/android/pages/gs-prereqs.adoc

@@ -1,14 +1,11 @@
-
 = Preparing for Couchbase Lite on Android
 :page-aliases: start/java-android-gs-prereqs.adoc
 :page-role:
 :description: Prerequisites for the installation of Couchbase Lite
 :keywords: edge nosql api android java
 
-
 :source-language: Java
 
-
 :source-language: Kotlin
 
 
@@ -48,8 +45,8 @@ We do not test against, nor guarantee support for, uncertified Android versions
 |22
 |===
 
-[#supported-versions-for-vector-search-3-2-0]
-== Supported Versions for Vector Search 3.2.0
+[#supported-versions-for-vector-search-3-3-0]
+== Supported Versions for Vector Search 3.3.0
 
 [IMPORTANT]
 --
@@ -73,6 +70,23 @@ To verify whether your device supports the AVX2 instructions set, https://www.in
 |===
 
 
+== Supported Versions for Multipeer Replicator
+
+
+[%autowidth.stretch]
+|===
+|Platform |Runtime architectures |Minimum API Level
+
+|Android
+|arm64-v8a
+|35
+
+|Android
+|x86_64
+|35
+|===
+
+
 [#related-content]
 == Related Content
 ++++

modules/android/pages/p2psync-multipeer.adoc

@@ -0,0 +1,87 @@
+= Multipeer Replicator
+ifdef::show_edition[:page-edition: Enterprise Edition]
+:description: MultipeerReplicator is a peer-to-peer replicator that can advertise its presence, discover other peers, establish connections, and replicate data with those peers.
+
+:source-language: Java
+
+:source-language: Kotlin
+
+[abstract]
+{description}
+
+
+TIP: Multipeer Replication is currently available for use over IP networks.
+If you are working with a bluetooth network, you will need to use Couchbase Lite's xref::p2psync-websocket.adoc[Active-Passive peer-to-peer].
+
+[#introduction]
+== Introduction
+// tag::introduction-full[]
+// tag::introduction[]
+Couchbase Lite's Peer-to-Peer synchronization solution offers secure storage and bidirectional data synchronization between edge devices without needing a centralized cloud-based control point.
+Multipeer Replicator 
+// end::introduction[]
+
+
+
+== Prerequisites
+
+=== Transport and Peer Discovery Protocol
+
+MultipeerReplicator supports Wi-Fi transport, using DNS-SD (also known as Bonjour) for peer discovery.
+ Peers must be connected to the same Wi-Fi network to discover and establish connections with one another.
+
+=== Supported Platforms
+
+For Android, the minimum API level is API 35, based on the availability of required DNS-SD features for peer discovery and mesh network construction—such as support for subtypes, and the ability to publish and subscribe to service information.
+
+
+== Overview
+
+The MultipeerReplicator automatically advertises its presence, discovers other peers,
+and establishes connections for data replication with peers that share the same group identifier defined by the application.
+
+To maintain optimal connectivity, efficient data transport, and balanced workloads, the MultipeerReplicator forms a dynamic mesh network among peers in the same group.
+It avoids redundant direct connections, evenly distributes connections across peers, and optimizes communication paths.
+The mesh network continuously adapts as peers join or leave.
+
+
+
+
+== Configuration
+
+.Configuration for creating a MultipeerReplicator
+[source,java]
+----
+public struct MultipeerReplicatorConfiguration {
+    /// Identifier for discovering and connecting peers.
+    public let peerGroupID: String
+    
+    /// Peer identity.
+    /// @Note The identity’s certificate must be both server and client certificate.
+    public let identity: TLSIdentity
+
+
+    /// Peer authenticator.
+    public let authenticator: MultipeerAuthenticator
+
+
+    /// Collections to replicate.
+    public let collections: [MultipeerCollectionConfiguration]
+
+
+    /// Initialize the configuration with a peer group identifier, identity, 
+    /// authenticator and collections.
+    public init(peerGroupID: String, 
+                identity: TLSIdentity,
+                authenticator: MultipeerCertificateAuthenticator,                  
+                collections: [MultipeerCollectionConfiguration])
+}
+----
+
+
+
+
+
+TIP: In version 3.3.0, the recommended maximum number of peers in a mesh network is approximately 15.
+
+