Struct GenericStore 

pub struct GenericStore<S, R, F>
where
    S: Store + Send + Sync + 'static,
    R: SignalingTransport + Send + Sync + 'static,
    F: PeerLinkFactory + Send + Sync + 'static,
{ /* private fields */ }

Generic mesh store that works with any storage backend and transport implementation.

This is the shared code between production and simulation.

• Production: GenericStore<LmdbStore, NostrSignalingTransport, WebRtcPeerLinkFactory>
• Simulation: GenericStore<MemoryStore, MockSignalingTransport, MockConnectionFactory>

Implementations

impl<S, R, F> GenericStore<S, R, F>

where S: Store + Send + Sync + 'static, R: SignalingTransport + Send + Sync + 'static, F: PeerLinkFactory + Send + Sync + 'static,

pub fn new( local_store: Arc<S>, signaling: Arc<MeshRouter<R, F>>, request_timeout: Duration, debug: bool, ) -> Self

Create a new generic store

pub fn new_with_routing( local_store: Arc<S>, signaling: Arc<MeshRouter<R, F>>, request_timeout: Duration, debug: bool, routing: GenericStoreRoutingConfig, ) -> Self

Create a new generic store with explicit routing configuration.

pub async fn start(&self) -> Result<(), TransportError>

Start the store (begin listening for messages)

pub async fn stop(&self)

Stop the store

pub async fn process_signaling( &self, msg: SignalingMessage, ) -> Result<(), TransportError>

Process incoming signaling message

pub fn signaling(&self) -> &Arc<MeshRouter<R, F>>

Get signaling manager reference

pub async fn peer_count(&self) -> usize

Get peer count

pub async fn needs_peers(&self) -> bool

Check if we need more peers

pub async fn send_hello(&self) -> Result<(), TransportError>

Re-broadcast hello to refresh discovery as topology changes.

pub async fn record_cashu_payment_for_peer( &self, peer_id: &str, amount_sat: u64, )

Apply an out-of-band payment credit to a peer’s routing priority.

pub async fn record_cashu_receipt_from_peer( &self, peer_id: &str, amount_sat: u64, )

Record a post-delivery payment we received from a peer.

pub async fn record_cashu_payment_default_from_peer(&self, peer_id: &str)

Record that a peer failed to pay after we delivered successfully.

pub async fn peer_metadata_snapshot(&self) -> PeerMetadataSnapshot

Export live peer metadata for inspection/debugging.

pub async fn persist_peer_metadata(&self) -> Result<Hash, StoreError>

Snapshot current peer metadata and persist it into local_store.

Uses content-addressed storage for the snapshot body and a reserved mutable pointer slot for the “latest snapshot hash”.

pub async fn load_peer_metadata(&self) -> Result<bool, StoreError>

Load persisted peer metadata from local_store if available.

pub async fn get_with_quote( &self, hash: &Hash, payment_sat: u64, quote_ttl: Duration, ) -> Result<Option<Vec<u8>>, StoreError>

Request data from peers after negotiating a paid quote.

If quote negotiation fails or the quoted peer does not deliver, the store falls back to the normal unpaid retrieval path to preserve liveness.

pub async fn handle_data_message(&self, from_peer: &str, data: &[u8])

Handle incoming data message

Trait Implementations

impl<S, R, F> Store for GenericStore<S, R, F>

where S: Store + Send + Sync + 'static, R: SignalingTransport + Send + Sync + 'static, F: PeerLinkFactory + Send + Sync + 'static,

fn put<'life0, 'async_trait>( &'life0 self, hash: Hash, data: Vec<u8>, ) -> Pin<Box<dyn Future<Output = Result<bool, StoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Store data by its hash Returns true if newly stored, false if already existed

fn get<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 Hash, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<u8>>, StoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Retrieve data by hash Returns data or None if not found

fn has<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 Hash, ) -> Pin<Box<dyn Future<Output = Result<bool, StoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check if hash exists

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 Hash, ) -> Pin<Box<dyn Future<Output = Result<bool, StoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete by hash Returns true if deleted, false if didn’t exist

fn put_many<'life0, 'async_trait>( &'life0 self, items: Vec<([u8; 32], Vec<u8>)>, ) -> Pin<Box<dyn Future<Output = Result<usize, StoreError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Store multiple blobs. Returns the number of newly stored items.

fn set_max_bytes(&self, _max: u64)

Set maximum storage size in bytes. 0 = unlimited.

fn max_bytes(&self) -> Option<u64>

Get maximum storage size. None = unlimited.

fn stats<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = StoreStats> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Get storage statistics

fn evict_if_needed<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64, StoreError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Evict unpinned items if over storage limit. Returns number of bytes freed.

fn pin<'life0, 'life1, 'async_trait>( &'life0 self, _hash: &'life1 [u8; 32], ) -> Pin<Box<dyn Future<Output = Result<(), StoreError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Pin a hash (increment ref count). Pinned items are not evicted.

fn unpin<'life0, 'life1, 'async_trait>( &'life0 self, _hash: &'life1 [u8; 32], ) -> Pin<Box<dyn Future<Output = Result<(), StoreError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Unpin a hash (decrement ref count). Item can be evicted when count reaches 0.

fn pin_count(&self, _hash: &[u8; 32]) -> u32

Get pin count for a hash. 0 = not pinned.

fn is_pinned(&self, hash: &[u8; 32]) -> bool

Check if hash is pinned (pin count > 0)