dollarsmore-wire 0.4.0

Broker-neutral order-intent wire schema for a producer/consumer Redis-Streams transport

wire

A tiny, broker-neutral order-intent wire schema for a producer/consumer transport (Redis Streams or anything else). A strategy process produces OrderIntents; an executor process consumes them and reports back with ResultEvents. wire is the vendor-free contract both sides agree on: pure stdlib dataclasses with explicit JSON (de)serialisation, no broker, transport, or networking imports.

Install

pip install dollarsmore-wire
# or
uv add dollarsmore-wire

from wire import OrderIntent, ResultEvent, IntentAction, OrderType

The distribution is dollarsmore-wire; the import package is wire.

What's in it

• OrderIntent — an order command: OPEN / CLOSE / CANCEL, 1-4 IntentLegs, order type, price (positive-magnitude Decimal) with an explicit PriceEffect (DEBIT / CREDIT), time-in-force, correlation id, strategy tag.
• OpenBracketIntent — an entry plus a pre-staged take-profit as one OTO bracket.
• ResultEvent — the executor's reply: ACCEPTED / REJECTED / FILLED / CANCELLED / ERROR, broker order id, fill price, detail.
• Enums: IntentAction, LegAction, OptionType, OrderType, PriceEffect, ResultStatus.

Every type round-trips through .to_wire() / .from_wire() plain dicts, so the transport only ever moves JSON.

Redis-Streams transport (wire.transport)

wire.transport is the shared Redis-Streams envelope both producer and consumer agree on — stream names (orders:intents / :results / :deadletter), the consumer group, and pure encode_* / decode_* helpers that wrap a wire object in a {kind, payload} dict. It has no redis import (stdlib + wire only); the caller drives its own redis client (client.xadd(INTENTS_STREAM, encode_bracket(intent))). Keeping it here stops producer and consumer drifting on the wire format.

Versioning

WIRE_VERSION is stamped into every serialised payload (the v field). Bump it on any breaking change to the wire shape so producer and consumer can detect a mismatch.

Design rules

• Stdlib only — no third-party dependencies, ever.
• Money is a positive-magnitude Decimal plus an explicit PriceEffect; never a signed float.
• Times are ISO 8601 strings on the wire; enums travel by value.

Develop

uv sync
uv run pytest -q
uv run ruff check .