ferroid-tonic-core

Crates.ioferroid-tonic-core
lib.rsferroid-tonic-core
version0.6.5
created_at2025-06-13 22:24:59.512892+00
updated_at2025-08-08 09:22:25.968762+00
descriptionShared types for the core gRPC protocol and shared types
homepage
repositoryhttps://github.com/s0l0ist/ferroid/blob/main/crates/ferroid-tonic-core
max_upload_size
id1711928
size37,600
Nick Angelou (s0l0ist)

documentation

https://docs.rs/ferroid

README

Shared Types and Protobuf Bindings

This crate provides the shared interface and protocol definitions for the ferroid streaming ID generation ecosystem. It is consumed by both the gRPC server and external clients that interact with it programmatically.

Contents

  • Canonical Snowflake ID types and encoding constants
  • Shared [Error] and [Result] types used across the system
  • Auto-generated protobuf bindings for the gRPC interface (ferroid.proto)

Protobuf Interface

The [proto] module contains types generated via [tonic::include_proto!]. It also exposes a precompiled FILE_DESCRIPTOR_SET for gRPC reflection support.

Example client usage:

use ferroid_tonic_core::proto::id_generator_client::IdGeneratorClient;

gRPC clients should deserialize IdChunk.packed_ids using the agreed-upon fixed-width layout (e.g. u64 or u128, in little-endian order).

Commit count: 59

cargo fmt