Struct FlashMap 

pub struct FlashMap<K: PodBound, V: PodBound> { /* private fields */ }

GPU-native concurrent hash map with bulk-only operations.

Generic over fixed-size key K and value V types that implement bytemuck::Pod (plain old data — Copy, fixed layout, any bit pattern valid).

Common type combinations:

• FlashMap<[u8; 32], [u8; 128]> — blockchain state (pubkey → account)
• FlashMap<u64, u64> — numeric keys and values
• FlashMap<[u8; 32], [u8; 32]> — hash → hash mappings

Implementations

impl<K: PodBound + Send + Sync, V: PodBound + Send + Sync> FlashMap<K, V>

pub fn with_capacity(capacity: usize) -> Result<Self, FlashMapError>

Create a FlashMap with the given capacity using default settings.

Tries GPU first (if cuda feature enabled), falls back to CPU. Capacity is rounded up to the next power of 2.

pub fn builder(capacity: usize) -> FlashMapBuilder

Create a builder for fine-grained configuration.

pub fn bulk_get(&self, keys: &[K]) -> Result<Vec<Option<V>>, FlashMapError>

Look up multiple keys in parallel. Returns None for missing keys.

pub fn bulk_insert(&mut self, pairs: &[(K, V)]) -> Result<usize, FlashMapError>

Insert multiple key-value pairs in parallel.

Returns the number of new insertions (updates don’t count). If a key already exists, its value is updated in place.

Invariant

No duplicate keys within a single batch. If the same key appears multiple times, behavior is undefined (one will win, but which one is non-deterministic on GPU).

pub fn bulk_remove(&mut self, keys: &[K]) -> Result<usize, FlashMapError>

Remove multiple keys in parallel (tombstone-based).

Returns the number of keys actually removed.

pub fn len(&self) -> usize

Number of occupied entries.

pub fn is_empty(&self) -> bool

Whether the map is empty.

pub fn capacity(&self) -> usize

Total slot capacity (always a power of 2).

pub fn load_factor(&self) -> f64

Current load factor (0.0 to 1.0). Max allowed is 0.5.

pub fn clear(&mut self) -> Result<(), FlashMapError>

Remove all entries, resetting to empty.

Trait Implementations

impl<K: PodBound + Send + Sync, V: PodBound + Send + Sync> Debug for FlashMap<K, V>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.