Struct ShardedAccess 

pub struct ShardedAccess<'a, const SHARDS: usize> { /* private fields */ }

A sharded collection that distributes entries across multiple accounts.

Each shard is an account containing a FixedVec<T>. The shard index is determined by a key hash.

This enables collections that exceed single-account size limits.

Implementations

impl<'a, const SHARDS: usize> ShardedAccess<'a, SHARDS>

pub fn new( accounts: &'a [AccountView], shard_indices: &[u8], ) -> Result<Self, ProgramError>

Create a sharded access from account indices.

pub fn shard_for_key(&self, key: &[u8]) -> usize

Determine which shard a key maps to (simple modular hashing).

pub fn shard_account( &self, shard: usize, ) -> Result<&'a AccountView, ProgramError>

Get the account for a given shard index.

pub fn data_for_key(&self, key: &[u8]) -> Result<Ref<'a, [u8]>, ProgramError>

Get the account data for the shard that owns a given key.

pub fn shard_count(&self) -> usize

Number of shards.