feat(swift-sdk)!: use SPV-synced quorums for Platform proof verification

book/src/sdk/builder-pattern.md

@@ -39,7 +39,7 @@ pub struct SdkBuilder {
     core_password: Zeroizing<String>,
     proofs: bool,
     version: &'static PlatformVersion,
-    context_provider: Option<Box<dyn ContextProvider>>,
+    context_provider: Option<Arc<dyn ContextProvider>>,
     metadata_height_tolerance: Option<u64>,
     metadata_time_tolerance_ms: Option<u64>,
     cancel_token: CancellationToken,
@@ -107,7 +107,7 @@ impl SdkBuilder {
         mut self,
         context_provider: C,
     ) -> Self {
-        self.context_provider = Some(Box::new(context_provider));
+        self.context_provider = Some(Arc::new(context_provider));
         self
     }
 
@@ -185,7 +185,7 @@ pub struct Sdk {
     inner: SdkInstance,
     proofs: bool,
     internal_cache: Arc<InternalSdkCache>,
-    context_provider: ArcSwapOption<Box<dyn ContextProvider>>,
+    context_provider: Arc<dyn ContextProvider>,
     metadata_last_seen_height: Arc<atomic::AtomicU64>,
     metadata_height_tolerance: Option<u64>,
     metadata_time_tolerance_ms: Option<u64>,
@@ -219,9 +219,11 @@ does not know (or care) whether it is talking to a real network or a mock.
 
 ### Thread Safety
 
-`Sdk` is `Clone` and thread-safe. It uses `Arc` for shared state and `ArcSwapOption`
-for the context provider (which allows lock-free reads). The mock mode uses `tokio::Mutex`
-for the mock client since mock state is modified in async contexts.
+`Sdk` is `Clone` and thread-safe. It uses `Arc` for shared state, the context
+provider included: the provider is fixed when `build()` runs, which refuses one
+for another network or one that requires proofs while they are off, and clones
+share it. The mock mode uses `tokio::Mutex` for the mock client since mock state
+is modified in async contexts.
 
 ### Nonce Management
 

packages/dash-platform-balance-checker/src/main_trusted.rs

@@ -49,11 +49,9 @@ async fn main() -> Result<()> {
     // Build SDK with mock core (context provider will handle everything)
     let sdk = SdkBuilder::new(AddressList::from_iter(addresses))
         .with_core("127.0.0.1", 1, "mock", "mock") // Mock values, won't be used
+        .with_context_provider(context_provider)
         .build()?;
 
-    // Set our trusted context provider
-    sdk.set_context_provider(context_provider)?;
-
     // Fetch the identity
     println!("Fetching identity with proof verification...");
     match Identity::fetch(&sdk, identity_id).await {

packages/rs-context-provider/Cargo.toml

@@ -4,9 +4,10 @@ version.workspace = true
 edition = "2021"
 authors = ["sam@dash.org"]
 license = "MIT"
-description = "Context provider traits for Dash Platform SDK"
+description = "Context provider traits and quorum-source routing for Dash Platform SDK"
 
 [dependencies]
+arc-swap = "1.7.1"
 dash-async = { path = "../rs-dash-async" }
 dpp = { path = "../rs-dpp", default-features = false }
 drive = { path = "../rs-drive", default-features = false, features = [
@@ -16,5 +17,8 @@ thiserror = "1.0"
 hex = { version = "0.4", optional = true }
 serde_json = { version = "1.0", optional = true }
 
+[dev-dependencies]
+tokio = { version = "1", features = ["macros", "rt"] }
+
 [features]
 mocks = ["hex", "serde_json", "dpp/serde-conversion"]

packages/rs-context-provider/src/lib.rs

@@ -1,13 +1,18 @@
-//! Context provider traits for Dash Platform SDK
+//! Context providers for Dash Platform SDK
 //!
 //! This crate provides the core traits for context providers that are used
-//! to fetch network state, data contracts, and quorum public keys.
+//! to fetch network state, data contracts, and quorum public keys, and the
+//! [`routing`] providers that choose between an SPV client and a trusted
+//! provider for quorum keys.
 
 pub mod error;
 pub mod provider;
+pub mod routing;
 
 pub use error::ContextProviderError;
-pub use provider::{ContextProvider, DataContractProvider, QuorumKeyFuture};
+pub use provider::{
+    platform_activation_height, ContextProvider, DataContractProvider, QuorumKeyFuture,
+};
 
 #[cfg(feature = "mocks")]
 pub use provider::MockContextProvider;

packages/rs-context-provider/src/provider.rs

@@ -20,6 +20,16 @@ use {
 pub type QuorumKeyFuture =
     Pin<Box<dyn Future<Output = Result<Option<[u8; 48]>, ContextProviderError>> + Send + 'static>>;
 
+/// The Core height at which Platform activated (its L1 locked height) on
+/// `network`.
+pub fn platform_activation_height(network: Network) -> CoreBlockHeight {
+    match network {
+        Network::Mainnet => 2_132_092,
+        Network::Testnet => 1_090_319,
+        Network::Devnet | Network::Regtest => 1,
+    }
+}
+
 /// Interface between the Sdk and state of the application.
 ///
 /// ContextProvider is called by the [FromProof](crate::FromProof) trait (and similar) to get information about