| Aspect | Description | |--------|-------------| | | Run a trust‑less, order‑book based matching engine that settles trades off‑chain while anchoring finality on a host blockchain (Ethereum, Polygon, Avalanche, etc.). | | Design goals | - Sub‑millisecond latency via in‑memory data structures. - Horizontal scalability through sharding & stateless front‑ends. - Pluggable architecture for market‑making bots, compliance checks, and custom fee models. | | Key components | 1. ravenxd daemon (matching engine + state store). 2. ravenx‑api (REST / WebSocket gateway). 3. ravenx‑cli (admin & debugging tool). 4. ravenx‑sdk (client libraries for Rust, TypeScript, Go, Python). | | Supported assets | Any ERC‑20 / EVM‑compatible token, plus native assets on supported L2s. | | License | Apache‑2.0 (commercial‑friendly, permissive). | | Community | GitHub org: github.com/ravenx-io . Discord, weekly community calls, and an active developer forum. |
| Category | Feature | Benefit | |----------|---------|---------| | | Limit, market, stop‑limit, iceberg orders | Full‑featured order types. | | | Batch matching & atomic settlement | Guarantees that a batch of trades either all settle or none do. | | Performance | In‑memory order‑book + lock‑free queues | Sub‑ms order entry latency. | | | Multi‑core sharding (by trading pair) | Linear scaling with CPU cores. | | Security | Deterministic state hashing (Merkle root) | Enables on‑chain anchoring & fraud proofs. | | | TLS‑mutual authentication for API clients | Prevents unauthorized market access. | | Reliability | Crash‑only design, periodic snapshots, WAL | Zero‑downtime recovery. | | | Hot‑swap plug‑ins (no daemon restart) | Continuous improvement. | | Extensibility | Rust‑native plug‑in SDK + C‑ABI fallback | Write extensions in any language. | | | WebSocket feed with per‑pair subscription filters | Real‑time market data for traders. | | Compliance | Built‑in AML/KYC plug‑in framework | Easy integration with on‑chain identity services. | | Observability | Prometheus metrics, OpenTelemetry tracing, logs in JSON | Full visibility for ops. | | Dev Tools | ravenx‑cli (order injection, state dump) | Rapid debugging and test‑net experimentation. | ravenxd
| Command | Example | Description | |---------|---------|-------------| | | ravenx-cli order place --pair BTC/USDT --side buy --price 23_500 --size 0.12 --type limit | Submits a limit order. | | Cancel an order | ravenx-cli order cancel --order-id 0xabc123… | Cancels a pending order. | | Show order‑book | ravenx-cli book depth --pair ETH/USDT --levels 10 | Prints top‑10 bids/asks. | | Snapshot state | ravenx-cli admin snapshot --path /tmp/ravenx_snapshot.bin | Forces a manual LMDB snapshot. | | Load a plug‑in | ravenx-cli admin plugin load ./plugins/arb_bot.so | Dynamically loads a plug‑in. | | Metrics dump | curl http://localhost:9090/metrics | Prometheus‑compatible metrics. | | Aspect | Description | |--------|-------------| | |