Architecture

SolVec SDK (TypeScript / Python)
.upsert()  .query()  .delete()  .verify()
      |           |           |
      v           v           v
 Rust HNSW    Shadow Drive   Solana
 (in memory)  (encrypted     (32-byte
 sub-5ms p99   vectors)       Merkle root)
 Speed Layer  Storage Layer   Trust Layer

// Core HNSW parameters from hnsw.rs:42-50
pub struct HNSWIndex {
    m: usize,              // max connections per node (default: 16)
    m_max_0: usize,        // max at layer 0 (default: 32)
    ef_construction: usize, // build beam width (default: 200)
    ef_search: usize,       // query beam width (default: 50)
    ml: f64,               // level multiplier
    // ...
}

pub fn encrypt_vectors(vectors: &[Vec<f32>], key: &[u8; 32]) -> Result<Vec<u8>, SolVecError> {
    let cipher = Aes256Gcm::new(Key::<Aes256Gcm>::from_slice(key));
    let nonce = Aes256Gcm::generate_nonce(&mut OsRng);
    
    // Serialize: num_vectors (8 bytes) + dimension (8 bytes) + vector data
    let mut plaintext = Vec::new();
    plaintext.extend_from_slice(&num_vectors.to_le_bytes());
    plaintext.extend_from_slice(&dim.to_le_bytes());
    for v in vectors {
        for &f in v {
            plaintext.extend_from_slice(&f.to_le_bytes());
        }
    }
    
    let ciphertext = cipher.encrypt(&nonce, plaintext.as_ref())?;
    // Return: nonce (12 bytes) + ciphertext
}