Matching engine

computematching-engine

Deterministic single-threaded order-book matcher.

Category: Compute
Properties: 6
Components: 3
Rules: 2

Properties · 6 defined by this kind

A node of this kind resolves each property from its own props, then the component's defaults, then the default below.

property	type	values	required	default
algorithm	enum	price-time \| pro-rata	no	price-time
deterministic	boolean	—	no	true
failover	enum	none \| manual \| automatic	no	none
managed	boolean	—	no	false
role	enum	primary \| standby	no	primary
singleThreaded	boolean	—	no	true

Rules for this kind · 2

Stateful engine pinned to a single zoneerror

stateful-engine-pinned-to-single-zone

A matching engine, coordination service or event store living in exactly one availability zone, with no failover and no replication, is lost with that zone. Everything that depends on it stops with it.

— all of these hold:
— the node sits inside exactly 1 availability-zone group
— any of these hold:
— the node's `failover` is "none"
— the node's `replicated` is false
— the node's `replication` is "none"

Stateful node without zone redundancyerror

stateful-node-without-zone-redundancy

A stateful compute node pinned to exactly one availability zone disappears with that zone, and its state goes with it. Nodes inside a cell are exempt, because there the cell is deliberately single-zone and redundancy comes from the other cells.

— all of these hold:
— the node's `stateless` is false
— the node sits inside exactly 1 availability-zone group
— this does not hold:
— the node sits inside at least one cell group

Components · 3

vendor-neutral

Generic matching enginematching-enginegenericthe kind itself

aws

Amazon GameLift FlexMatchaws-gamelift-flexmatch3 defaults

default

Order-book matcherorder-book-matcher5 defaults

Source

1# yaml-language-server: $schema=../schema/kind.schema.json
2# Abstract kind: Deterministic, single-threaded order-book matcher fed by a sequenced event stream (exchanges, marketplaces).
3schemaVersion: "1"
4type: "kind"
5id: "matching-engine"
6category: "compute"
7properties:
8  singleThreaded:
9    type: "boolean"
10    default: true
11  deterministic:
12    type: "boolean"
13    default: true
14  algorithm:
15    type: "enum"
16    values: ["price-time", "pro-rata"]
17    default: "price-time"
18  role:
19    type: "enum"
20    values: ["primary", "standby"]
21    default: "primary"
22  failover:
23    type: "enum"
24    values: ["none", "manual", "automatic"]
25    default: "none"
26  managed:
27    type: "boolean"
28    default: false

The same page as markdown, for an agent: /catalogue/kinds/matching-engine.md