Struct ShardingApi 

pub struct ShardingApi;

ShardingApi

Public API façade for shard placement and inspection.

Responsibilities:

• Expose read-only sharding queries
• Expose sharding workflows (assignment / planning)
• Normalize internal Error into PublicError

Does not:

• Contain business logic
• Interpret policies
• Access storage directly

Implementations

impl ShardingApi

pub fn lookup_tenant(pool: &str, tenant: &str) -> Option<Principal>

Lookup the shard assigned to a tenant in a pool, if any.

pub fn require_tenant_shard( pool: &str, tenant: impl AsRef<str>, ) -> Result<Principal, PublicError>

Return the shard for a tenant, or a PublicError if unassigned.

pub fn registry_view() -> ShardingRegistryView

Return a view of the full sharding registry.

pub fn tenants_view(pool: &str, shard: Principal) -> ShardingTenantsView

Return all tenants currently assigned to a shard.

pub async fn assign_to_pool( pool: &str, tenant: impl AsRef<str>, ) -> Result<Principal, PublicError>

Assign a tenant to a shard in the given pool.

This performs validation, selection, and persistence.

pub fn plan_assign_to_pool( pool: &str, tenant: impl AsRef<str>, ) -> Result<ShardingPlanStateView, PublicError>

Perform a dry-run shard assignment and return the resulting plan.