1 Overview

Overview

corpus-ipc is the spike and neuromodulator wire protocol and IPC transports for Limen-Neural SNN runtimes (crate description, README and src/lib.rs docs as of 08d2f28). It ships wire models (IpcMessage and batches), fail-closed validation and wire-version envelopes, IpcBackend / RustBackend, optional ZeroMQ binary SUB readout and structured IpcMessage PUB/SUB (zmq, #55), and an optional Axum 0.8 REST binary (server) under the v0.2 contract.

Version 0.2.1 (#69; published on crates.io, 0.2.0 is yanked) · tip b12059f · MSRV 1.85 · edition 2024.

Sources: README.md, src/lib.rs, Cargo.toml

What is in this wiki

Section	Focus
1.1 Getting Started	Install, features, env, verify.sh
1.2 Architecture Overview	Mermaid request paths (REST + structured ZMQ)
1.3 Crate Exports and Module Map	Modules and re-exports
2–3	Traits and backends (incl. structured ZMQ #55)
4–5	Protocol, validation, canonical wire-v1
6	v0.2 REST
7	Features, tests, CI
8–9	History, license, glossary

Notable APIs since prior wiki tips

• 08d2f28 / #55: ZmqMessagePublisher, ZmqMessageSubscriber, ZmqTransportConfig, ZmqHybridFlowBackend, ZmqMessageError, FramingFault, STRUCTURED_MAX_FRAME_BYTES, BackendError::Protocol / ProtocolError
• Earlier (fcad212 era and before): encode_canonical_ipc_message, zmq_readout::parse_readout_packet, ZmqIpcBackend latest-value drain + reconnect, corpus_ipc::server::router / AppState, test-vectors/wire-v1/, test-vectors/zmq/, scripts/verify.sh