diff --git a/src/core/constants.rs b/src/core/constants.rs
index dd8cc08..6e2a117 100644
--- a/src/core/constants.rs
+++ b/src/core/constants.rs
@@ -106,6 +106,7 @@ pub const UNENCRYPTED_KINDS: &[u16] = &[
     PROMPTS_LIST_KIND,
 ];
 
+/// Return the latest MCP protocol version string
 #[cfg(feature = "rmcp")]
 pub fn mcp_protocol_version() -> &'static str {
     use std::sync::OnceLock;
@@ -115,6 +116,7 @@ pub fn mcp_protocol_version() -> &'static str {
         .as_str()
 }
 
+/// Return the latest MCP protocol version string
 #[cfg(not(feature = "rmcp"))]
 pub const fn mcp_protocol_version() -> &'static str {
     "2025-11-25"
diff --git a/src/core/types.rs b/src/core/types.rs
index 1860369..12cd69b 100644
--- a/src/core/types.rs
+++ b/src/core/types.rs
@@ -24,11 +24,10 @@ pub enum EncryptionMode {
     Disabled,
 }
 
-// Gift-wrap mode (CEP-19)
-
-// Gift-wrap policy for encrypted transport communication (CEP-19).
-// Controls whether encrypted messages use persistent gift wraps (kind `1059`),
-// ephemeral gift wraps (kind `21059`), or adapt based on peer support.
+/// Gift-wrap policy for encrypted transport communication (CEP-19)
+///
+/// Controls whether encrypted messages use persistent gift wraps (kind `1059`),
+/// ephemeral gift wraps (kind `21059`), or adapt based on peer support.
 #[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Serialize, Deserialize)]
 #[serde(rename_all = "lowercase")]
 pub enum GiftWrapMode {
diff --git a/src/encryption/mod.rs b/src/encryption/mod.rs
index 6a6d4bc..913031d 100644
--- a/src/encryption/mod.rs
+++ b/src/encryption/mod.rs
@@ -37,8 +37,7 @@ where
         .map_err(|e| Error::Decryption(e.to_string()))
 }
 
-// Decrypt a single-layer NIP-44 gift wrap (kind 1059).
-
+/// Decrypt a single-layer NIP-44 gift wrap (kind 1059)
 pub async fn decrypt_gift_wrap_single_layer<T>(signer: &T, event: &Event) -> Result<String>
 where
     T: NostrSigner,
@@ -47,8 +46,7 @@ where
     decrypt_nip44(signer, &sender_pubkey, &event.content).await
 }
 
-// Create a single-layer NIP-44 gift wrap (kind 1059).
-
+/// Create a single-layer NIP-44 gift wrap (kind 1059)
 pub async fn gift_wrap_single_layer<T>(
     _signer: &T,
     recipient: &PublicKey,
diff --git a/src/lib.rs b/src/lib.rs
index 29d5672..493a901 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,3 +1,4 @@
+#![warn(missing_docs)]
 //! # ContextVM SDK for Rust
 //!
 //! A complete Rust implementation of the [ContextVM protocol](https://contextvm.org),
@@ -36,36 +37,56 @@
 //! use contextvm_sdk::signer;
 //! ```
 
+/// Core types, constants, serializers, and validation
 pub mod core;
+/// Server and capability discovery on the Nostr network
 pub mod discovery;
+/// NIP-44 encryption and NIP-59 gift wrapping
 pub mod encryption;
+/// Gateway bridging a local MCP server to Nostr
 pub mod gateway;
+/// Proxy connecting to a remote MCP server via Nostr
 pub mod proxy;
+/// Nostr relay pool management
 pub mod relay;
+/// Nostr signer utilities and key management
 pub mod signer;
+/// Client and server MCP-over-Nostr transports
 pub mod transport;
 
+/// rmcp Worker integration for ContextVM transports
 #[cfg(feature = "rmcp")]
 pub mod rmcp_transport;
-// Re-export commonly used types
+// ── Core types and error handling ────────────────────────────────────
 pub use core::error::{Error, Result};
 pub use core::types::{
     CapabilityExclusion, ClientSession, EncryptionMode, GiftWrapMode, JsonRpcError,
     JsonRpcErrorResponse, JsonRpcMessage, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse,
     ServerInfo,
 };
+
+// ── Discovery ────────────────────────────────────────────────────────
 pub use discovery::ServerAnnouncement;
+
+// ── Relay pool ───────────────────────────────────────────────────────
 #[cfg(any(test, feature = "test-utils"))]
 pub use relay::mock::MockRelayPool;
 pub use relay::{RelayPool, RelayPoolTrait};
+
+// ── Transport (client) ──────────────────────────────────────────────
 pub use transport::client::{
     ClientCorrelationStore, NostrClientTransport, NostrClientTransportConfig,
 };
+
+// ── Transport (discovery tags) ──────────────────────────────────────
 pub use transport::discovery_tags::{DiscoveredPeerCapabilities, PeerCapabilities};
+
+// ── Transport (server) ──────────────────────────────────────────────
 pub use transport::server::{
     IncomingRequest, NostrServerTransport, NostrServerTransportConfig, RouteEntry,
     ServerEventRouteStore, SessionSnapshot, SessionStore,
 };
 
+// ── rmcp re-export ──────────────────────────────────────────────────
 #[cfg(feature = "rmcp")]
 pub use rmcp;
diff --git a/src/transport/client/correlation_store.rs b/src/transport/client/correlation_store.rs
index 0fbcd9f..a0678b6 100644
--- a/src/transport/client/correlation_store.rs
+++ b/src/transport/client/correlation_store.rs
@@ -36,6 +36,7 @@ impl Default for ClientCorrelationStore {
 }
 
 impl ClientCorrelationStore {
+    /// Create a new store with the default capacity
     pub fn new() -> Self {
         Self::with_max_pending(DEFAULT_LRU_SIZE)
     }
@@ -76,6 +77,7 @@ impl ClientCorrelationStore {
             .is_some_and(|r| r.is_initialize)
     }
 
+    /// Check whether a pending request exists for the given event ID
     pub async fn contains(&self, event_id: &str) -> bool {
         self.pending_requests.read().await.contains(event_id)
     }
@@ -118,6 +120,7 @@ impl ClientCorrelationStore {
         count
     }
 
+    /// Remove all pending requests from the store
     pub async fn clear(&self) {
         self.pending_requests.write().await.clear();
     }
diff --git a/src/transport/server/correlation_store.rs b/src/transport/server/correlation_store.rs
index c25404e..3a68ddb 100644
--- a/src/transport/server/correlation_store.rs
+++ b/src/transport/server/correlation_store.rs
@@ -84,6 +84,7 @@ impl Default for ServerEventRouteStore {
 }
 
 impl ServerEventRouteStore {
+    /// Create a new store with the default capacity
     pub fn new() -> Self {
         Self {
             inner: Arc::new(RwLock::new(Inner::new(DEFAULT_LRU_SIZE))),
@@ -246,6 +247,7 @@ impl ServerEventRouteStore {
         expired_keys
     }
 
+    /// Remove all route entries and secondary indexes
     pub async fn clear(&self) {
         let mut inner = self.inner.write().await;
         inner.routes.clear();
diff --git a/src/transport/server/session_store.rs b/src/transport/server/session_store.rs
index a37d53a..a208789 100644
--- a/src/transport/server/session_store.rs
+++ b/src/transport/server/session_store.rs
@@ -227,9 +227,13 @@ impl SessionStore {
 /// through the async API boundary).
 #[derive(Debug, Clone, PartialEq, Eq)]
 pub struct SessionSnapshot {
+    /// Whether the MCP `initialize` handshake has completed
     pub is_initialized: bool,
+    /// Whether the session is using NIP-44 encrypted transport
     pub is_encrypted: bool,
+    /// Whether common discovery tags have been sent for this session
     pub has_sent_common_tags: bool,
+    /// Whether the peer advertised support for ephemeral gift wraps (CEP-19)
     pub supports_ephemeral_gift_wrap: bool,
 }