Wallet Service Aeron

Detailed reference for endpoints, authentication, channels, messages, environment endpoints, and data models in this integration area.

AsyncAPI referencev0.2.2Wallets

Omen Wallet Service — Aeron Transport

Low-latency binary messaging interface for the Omen Wallet Service over Aeron UDP. The Gateway communicates with the Wallet Service using SBE (Simple Binary Encoding) messages over Aeron channels. This is the primary transport for latency-sensitive signing and HMAC operations. **Monetary values** are encoded as `u128` at 1e18 fixed-point scale.

Environment endpoints

walletServiceaeron-udp://0.0.0.0:40100Wallet Service listener. Configurable via `LISTEN_ENDPOINT` env var. Uses Aeron UDP transport with SBE binary encoding.

gatewayaeron-udp://localhost:40101Gateway endpoint for response delivery. Configurable via `GATEWAY_ENDPOINT` env var.

Channels and messages

walletRequest

aeron:udp?endpoint={walletService}

1 messages

Gateway → Wallet Service request channel. Stream ID: **3000**

walletRequest

walletResponse

aeron:udp?endpoint={gateway}

1 messages

Wallet Service → Gateway response channel. Stream ID: **3001**

walletResponse

Data models

WalletRequestTypeVenueWalletResponseStatusWalletRequestPayloadWalletResponsePayload