API Reference
CoordiNode exposes services via gRPC on port 7080 and REST/JSON on port 7081 (HTTP/JSON transcoding via embedded structured-proxy). Bolt protocol (7082) and WebSocket subscriptions (7083) are planned for a future release.
Services
| Service | Description | Proto |
|---|---|---|
| CypherService | OpenCypher-compatible query execution service. | — |
| VectorService | Vector search operations. | — |
| TextService | Full-text search operations backed by tantivy (BM25 scoring, 30+ languages). | — |
| GraphService | Core graph CRUD operations. | — |
| SchemaService | Schema management operations. | — |
| BlobService | BlobStore service: content-addressed chunk storage for large values. Values >= 4KB are split into 256KB chunks identified by SHA-256 hash. Content-addressing provides automatic deduplication. | — |
| HealthService | Health checking service (grpc.health.v1 compatible semantics). | — |
| ClusterService | Cluster management operations. | — |
| ChangeStreamService | CE Change Data Capture: tail oplog segments via gRPC server-side streaming. Single-consumer per shard. Client reconnects with a ResumeToken to continue from last acked position. At-least-once delivery. EE extensions (NATS/Kafka sinks, CEL pattern matching, cross-shard merge-sort, exactly-once delivery, multiple concurrent consumers) are in R400. | — |
| RaftService | Raft consensus inter-node protocol (gRPC-only, no REST — internal). Uses opaque bytes for openraft type serialization (msgpack). This decouples the proto schema from openraft's internal generic types, making the protocol stable across openraft version upgrades. | — |
Common Types
Messages and enums shared across services: Common Types
Ports
| Port | Protocol | Status | Purpose |
|---|---|---|---|
| 7080 | gRPC (HTTP/2) | Active | Native gRPC API, inter-node communication |
| 7081 | HTTP/1.1 + JSON | Active | REST/JSON transcoding via structured-proxy |
| 7082 | Bolt | Planned | Neo4j wire protocol compatibility |
| 7083 | WebSocket | Planned | Subscriptions, live queries |
| 7084 | HTTP | Active | Prometheus /metrics, /health, /ready |